Split bills and receive payments across chains

FissionPay is a cross-chain payment application that enables merchants to split bills and receive payments from any blockchain network. Built with Next.js and the Interchain ecosystem, it supports payments from Cosmos and EVM chains using Skip Protocol for seamless cross-chain transfers.

• Cross-Chain Payments: Accept payments from Cosmos and EVM chains (like Optimism, Ethereum, etc.)
• Bill Splitting: Create bills with customizable amounts
• Multiple Wallet Support:
  • Cosmos wallets (Keplr, Leap)
  • EVM wallets (Metamask)
• QR Code Generation: Share payment links easily via QR codes
• Real-Time Updates: Track bill status and remaining amounts in real-time
• Skip Protocol Integration: Leverages Skip Protocol for seamless cross-chain swaps

• Node.js 18+
• pnpm 9.7.0+ (recommended) or npm/yarn
• A web3 wallet installed:
  • Keplr for Cosmos chains
  • Metamask for EVM chains

1. Clone the repository

   git clone <repository-url>
   cd FissionPay

2. Install dependencies

   pnpm install

   or

   npm install

3. Set up environment variables

   Create a .env.local file in the root directory:

   NEXT_PUBLIC_SKIP_API_URL=https://api.skip.money
   NEXT_PUBLIC_SKIP_API_KEY=your_skip_api_key_here

   Note: Get your Skip API key from Skip Protocol

4. Run the development server

   pnpm dev

   or

   npm run dev

5. Open your browser

   Navigate to http://localhost:3000

1. Access the Merchant Dashboard

   • Click "Merchant Dashboard" on the homepage
   • Or navigate to /merchant

2. Connect Your Wallet

   • Connect your Keplr wallet (required for receiving payments on Noble chain)
   • The app will auto-connect if you've connected before

3. Create a Bill

   • Enter the total amount in USDC
   • Click "Create Bill"
   • A QR code and payment link will be generated

4. Share the Payment Link

   • Share the QR code or payment link with customers
   • Track payment status in real-time

1. Open the Payment Link

   • Scan the QR code or open the payment link
   • You'll see the bill details and remaining amount

2. Connect Your Wallet

   • Choose your preferred wallet:
     • Keplr: For Cosmos chains (Osmosis, Celestia, etc.)
     • Metamask: For EVM chains (Optimism, Ethereum, etc.)

3. Select Source Chain & Token (for Cosmos wallets)

   • Choose which Cosmos chain and token you want to pay with
   • The app will automatically enable the chain in Keplr

4. Choose Payment Amount

   • Select a percentage (25%, 50%, 75%, 100%) or enter a custom amount
   • Click "Calculate Route" to see the cross-chain route

5. Execute Payment

   • Review the route details
   • Click "Pay Now" to execute the cross-chain payment
   • Confirm the transaction in your wallet

6. Payment Confirmation

   • Wait for the transaction to complete
   • The bill will automatically update with your payment

FissionPay/
├── components/          # React components
│   ├── common/         # Shared components (Header, Footer, Layout)
│   └── wallet/         # Wallet-related components
├── config/             # Configuration files
├── pages/              # Next.js pages
│   ├── api/            # API routes
│   │   └── bills/      # Bill management endpoints
│   ├── merchant.tsx    # Merchant dashboard
│   └── pay/            # Payment pages
├── public/             # Static assets
├── styles/             # Global styles
├── utils/              # Utility functions
│   ├── skipGo.ts       # Skip Protocol integration
│   └── wallet.ts       # Wallet utilities
└── types/              # TypeScript type definitions

• Framework: Next.js 13
• Language: TypeScript
• UI Library: Interchain UI
• Wallet Integration:
  • Interchain Kit - Cosmos wallets
  • Wagmi - EVM wallets
• Cross-Chain: Skip Protocol
• Chain Registry: @chain-registry/v2
• State Management: React Hooks, TanStack Query

• pnpm dev - Start development server
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm lint - Run ESLint

• Noble (default destination for USDC)
• Osmosis
• Celestia
• Cosmos Hub
• And other Cosmos chains via Chain Registry

• Optimism (default source for USDC)
• Ethereum
• Polygon
• And other EVM chains supported by Wagmi

• Development Mode: The current implementation uses in-memory storage for bills. For production, use a proper database.
• API Keys: Never commit your Skip API key to version control. Use environment variables.
• Wallet Security: Always verify transaction details before signing.

• Keplr not connecting: Ensure Keplr extension is installed and unlocked
• Metamask not connecting: Ensure Metamask extension is installed and unlocked
• Chain not found: Make sure the chain is enabled in your wallet

• Route calculation fails: Verify your Skip API key is valid
• Transaction fails: Check you have sufficient balance for gas fees
• Cross-chain swap fails: Ensure both source and destination chains are supported

• Type errors: Run pnpm install to ensure all dependencies are installed
• Missing dependencies: Check that @chain-registry/v2-types is installed

• Bills are stored in-memory and will be lost on server restart (use a database in production)
• The app uses Skip Protocol for cross-chain routing and swaps
• Merchant receives payments on Noble chain in USDC
• Payments can be made from any supported Cosmos or EVM chain

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

This project is provided "AS IS" without warranties of any kind. See the LICENSE file for details.

Built with the Interchain JavaScript Stack:

• Interchain Kit - Wallet connections
• Interchain UI - UI components
• Chain Registry - Chain information
• Skip Protocol - Cross-chain infrastructure

AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.

No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.