Skip to content

KIRTIRAJ4327/PayEasy-Stellar-Consensus-2025

Repository files navigation

PayEasy - Simplifying Cross-Chain Payments

A web application that demonstrates how Stellar and Polkadot can power fast, low-cost international payments with a Web2-like user experience.

Features

  • Seamless cross-chain payments between Stellar and Polkadot networks
  • Web2-like user experience with simplified wallet interactions
  • Address validation and security checks
  • Real-time transaction monitoring
  • Smart contract-based payment processing

Technologies Used

Why PayEasy?

PayEasy addresses the complex UX challenges in blockchain payments by creating a familiar, web2-like experience while leveraging the benefits of Stellar and Polkadot blockchains. Our solution eliminates complicated wallet management, seed phrases, and confusing addresses to make crypto payments accessible to everyone.

Technical Design Documentation

See TECHNICAL_DESIGN.md for detailed technical information about the system architecture, design decisions, and implementation details.

Deployed Contracts

  • Stellar Testnet Contract: [Contract ID]
  • Polkadot Hub Testnet Contract: [Contract ID]

Live Demo

[Link to deployed front-end]

Post-Hackathon Roadmap

  1. User testing and feedback integration
  2. Mobile app development
  3. Additional blockchain integrations
  4. Partnership with payment providers
  5. Mainnet deployment and security audits

User Onboarding Strategy

  1. Simple email/social login with passkeys
  2. Guided tutorial for first-time users
  3. Progressive disclosure of blockchain elements
  4. Zero gas fees for first transactions (covered by launchtube)

Security Features

Midnight API Integration

PayEasy leverages the Midnight API for enhanced security:

  • Zero-Knowledge Proofs: Verify transaction validity without exposing sensitive data
  • Decentralized Identity: Secure user authentication without centralized databases
  • Scam Protection: Real-time checking against known fraudulent addresses
  • Rate Limiting: Prevent abuse through intelligent transaction monitoring
  • Suspicious Activity Detection: Automated flagging of potentially risky transactions

Additional Security Measures

  • Session-specific encryption using Web Crypto API
  • Real-time transaction validation and monitoring
  • Input sanitization and validation
  • Secure key management
  • Transaction amount limits and validations
  • Memo field content filtering

Technologies Used

  • Stellar JavaScript SDK
  • Midnight API for enhanced security
  • Web Crypto API for encryption
  • HTML/CSS/JavaScript
  • Tailwind CSS for UI
  • Stellar Testnet

Screenshots

[Screenshots - Coming Soon]

How to Use

  1. Clone this repository:

    git clone https://github.com/KIRTIRAJ4327/PayEasy-Stellar-Consensus-2025.git
    cd PayEasy-Stellar-Consensus-2025
  2. Install dependencies:

    npm install
  3. Build the CSS:

    npm run build
  4. Create a Stellar testnet account:

    • Go to Stellar Laboratory
    • Generate a keypair
    • Fund your account using Friendbot
    • Save your secret key and public key
  5. Configure your environment:

    • Create a .env file with your Midnight API credentials
    • Update the source account in config.js
  6. Start the development server:

    npm run serve
  7. Send a test payment:

    • Enter a valid Stellar public key as recipient
    • Enter an amount (e.g., 10 XLM)
    • Optionally add a memo
    • Review the security checks status
    • Confirm the transaction

Security Best Practices

When using PayEasy:

  1. Always verify the recipient's address
  2. Check transaction details before confirming
  3. Never share your secret key
  4. Be cautious of large or unusual transactions
  5. Monitor the security status indicators

Development Setup

  1. Make sure you have a Stellar testnet account:

  2. Set up your security credentials:

    • Obtain Midnight API credentials
    • Configure environment variables
    • Never commit sensitive keys to version control

Roadmap

  • Enhanced privacy features through Midnight API
  • Multi-factor authentication integration
  • Advanced fraud detection algorithms
  • Support for multiple currencies
  • Transaction history with privacy controls
  • Stellar federation for human-readable addresses

About the Hackathon

This project was built for the Stellar Consensus Hackathon 2025, showcasing how Web3 applications can combine user-friendly interfaces with advanced security features for a safer payment experience.

Security Note

This is a demonstration application running on Stellar's testnet. For production use:

  • Never expose secret keys in client-side code
  • Implement proper key management
  • Use secure backend services
  • Enable all security features
  • Regularly update dependencies
  • Monitor for suspicious activities

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors