Skip to content

Prowzi/X402PESA

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 

Repository files navigation

X402PESA - Global Payments via x402 Protocol

๐ŸŒ X402PESA

Global Payments. Fully Onchain. Chain Agnostic.

License: MIT x402 Protocol Twitter Follow PRs Welcome


๐Ÿ’ธ Send money anywhere โ€ข โšก Sub-second finality โ€ข ๐Ÿ”— Any blockchain


๐Ÿš€ Get Early Access ย โ€ขย  ๐Ÿ“– Docs ย โ€ขย  ๐Ÿ’ฌ Discord ย โ€ขย  ๐Ÿฆ Twitter




๐ŸŽฏ What is X402PESA?

X402PESA is a next-generation payment rail that brings the simplicity of mobile money to the power of blockchain. Built on the x402 protocol, it enables instant, near-zero-fee payments that work across any chain, anywhere in the world.

"HTTP has status code 402 - Payment Required. It was reserved for future use in 1997. The future is now."


โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
โ•‘                                                                              โ•‘
โ•‘     ๐Ÿ’ธ TRADITIONAL PAYMENTS              โšก X402PESA                         โ•‘
โ•‘     โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•                 โ•โ•โ•โ•โ•โ•โ•โ•                            โ•‘
โ•‘                                                                              โ•‘
โ•‘     ๐Ÿ“Š 2-5% fees                         ๐Ÿ“Š 0.01% fees                       โ•‘
โ•‘     โณ 1-3 days                          โšก < 1 second                        โ•‘
โ•‘     ๐ŸŒ Regional only                     ๐ŸŒ Worldwide                        โ•‘
โ•‘     ๐Ÿฆ Centralized                       ๐Ÿ”— Fully onchain                    โ•‘
โ•‘     ๐Ÿ“ฑ Single platform                   โ›“๏ธ  Chain agnostic                   โ•‘
โ•‘     ๐Ÿ‘ค Humans only                       ๐Ÿค– Agent-ready                      โ•‘
โ•‘                                                                              โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

โœจ Features

โšก Lightning Fast

Transactions settle in under 1 second.

No waiting. No pending states. No uncertainty. Just instant confirmation.

๐Ÿ’ฐ Near-Zero Fees

Pay just 0.01% per transaction.

That's $0.05 on a $500 transfer. Keep more of your money where it belongs.

๐ŸŒ Chain Agnostic

Works across any blockchain.

Ethereum, Solana, Base, Arbitrum, Polygon โ€” one interface for all chains.

๐Ÿ” Fully Onchain

Every transaction is cryptographically signed and permanently verifiable.

No trust required. Ever.

๐Ÿค– Agent-Ready

Built for the x402 protocol.

AI agents and machines can pay just like humans โ€” enabling the agentic economy.

๐Ÿ“ฑ Simple UX

Feels like M-PESA or Venmo.

No seed phrases. No gas management. No crypto complexity.


๐Ÿ“Š Fee Comparison Calculator

See how much you save with X402PESA:

Amount Sent Traditional Mobile Money Bank Wire Credit Card X402PESA You Save
$10 $0.50 (5%) $25+ $0.60 $0.001 ๐ŸŸข 99%+
$100 $3.00 (3%) $25+ $3.50 $0.01 ๐ŸŸข 99%+
$1,000 $15.00 (1.5%) $35+ $35.00 $0.10 ๐ŸŸข 99%+
$10,000 $100.00 (1%) $50+ $350.00 $1.00 ๐ŸŸข 98%+
$100,000 $500.00 $75+ $3,500.00 $10.00 ๐ŸŸข 98%+

๐Ÿ—๏ธ Architecture

                                   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                                   โ”‚     X402PESA Apps      โ”‚
                                   โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
                                   โ”‚  โ”‚ Web  โ”‚  โ”‚ Mobile โ”‚  โ”‚
                                   โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
                                   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                               โ”‚
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚                                                      โ”‚
                    โ”‚              ๐Ÿ”ท x402 Protocol Layer ๐Ÿ”ท               โ”‚
                    โ”‚                                                      โ”‚
                    โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
                    โ”‚  โ”‚ Payment  โ”‚ โ”‚ Identity โ”‚ โ”‚ Routing  โ”‚ โ”‚ Bridge โ”‚  โ”‚
                    โ”‚  โ”‚ Engine   โ”‚ โ”‚ Service  โ”‚ โ”‚ Service  โ”‚ โ”‚Service โ”‚  โ”‚
                    โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
                    โ”‚                                                      โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                               โ”‚
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ”‚                โ”‚                   โ”‚                   โ”‚                โ”‚
          โ–ผ                โ–ผ                   โ–ผ                   โ–ผ                โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚ Ethereum โ”‚    โ”‚  Solana  โ”‚        โ”‚   Base   โ”‚        โ”‚ Arbitrum โ”‚    โ”‚  + More  โ”‚
    โ”‚ Mainnet  โ”‚    โ”‚ Mainnet  โ”‚        โ”‚    L2    โ”‚        โ”‚   One    โ”‚    โ”‚  Chains  โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐ŸŒ The x402 Protocol

X402PESA is built on x402 โ€” an open protocol for programmable payments on the internet.

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                                                                                 โ”‚
โ”‚   ๐Ÿ“ก HTTP 402: Payment Required                                                 โ”‚
โ”‚   โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•                                               โ”‚
โ”‚                                                                                 โ”‚
โ”‚   Reserved in HTTP/1.1 (1997) for "future use"                                  โ”‚
โ”‚   Finally realized with blockchain technology                                   โ”‚
โ”‚                                                                                 โ”‚
โ”‚   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ”‚   1. CLIENT โ”€โ”€โ”€โ”€ Request Resource โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ SERVER          โ”‚   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ”‚   2. SERVER โ”€โ”€โ”€โ”€ 402 Payment Required โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ CLIENT          โ”‚   โ”‚
โ”‚   โ”‚                  (includes payment details)                             โ”‚   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ”‚   3. CLIENT โ”€โ”€โ”€โ”€ Signed Payment โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ CHAIN           โ”‚   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ”‚   4. CHAIN โ”€โ”€โ”€โ”€โ”€ Confirmation (< 1 sec) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ SERVER          โ”‚   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ”‚   5. SERVER โ”€โ”€โ”€โ”€ Resource Delivered โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ CLIENT          โ”‚   โ”‚
โ”‚   โ”‚                                                                         โ”‚   โ”‚
โ”‚   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ”‚
โ”‚                                                                                 โ”‚
โ”‚   Use Cases:                                                                    โ”‚
โ”‚   โ€ข ๐Ÿค– AI agents paying for API calls automatically                            โ”‚
โ”‚   โ€ข ๐Ÿ’ณ Micropayments for content (pay per article, not subscriptions)          โ”‚
โ”‚   โ€ข ๐Ÿ”„ Streaming payments (per byte, per second, per query)                    โ”‚
โ”‚   โ€ข ๐ŸŒ Cross-border instant settlement                                         โ”‚
โ”‚   โ€ข ๐ŸŽฎ In-game economies and digital goods                                     โ”‚
โ”‚                                                                                 โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+
  • pnpm (recommended) or npm
  • PostgreSQL database

Installation

# Clone the repository
git clone https://github.com/Prowzi/X402PESA.git
cd X402PESA/x402pesa-landing

# Install dependencies (we use pnpm for speed)
pnpm install

# Set up environment variables
cp .env.example .env
# Edit .env with your DATABASE_URL

# Initialize database
pnpm prisma generate
pnpm prisma db push

# Start development server
pnpm dev

๐ŸŽ‰ Visit http://localhost:3000 to see the app!


๐Ÿ› ๏ธ Tech Stack

Layer Technologies
Frontend Next.js React TypeScript
Styling Tailwind CSS CSS3
Database PostgreSQL Prisma
Deployment Railway Vercel
Protocol x402

๐Ÿ“ Project Structure

x402pesa-landing/
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ components/              # React UI components
โ”‚   โ”œโ”€โ”€ Layout.tsx              # Main layout (header, footer, meta)
โ”‚   โ”œโ”€โ”€ FeeSlider.tsx           # Interactive fee comparison slider
โ”‚   โ”œโ”€โ”€ HowItWorksTabs.tsx      # Tabbed explanation section
โ”‚   โ”œโ”€โ”€ ScreenShowcase.tsx      # App screenshots carousel
โ”‚   โ””โ”€โ”€ X402Unlocks.tsx         # Protocol features section
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ lib/                     # Utilities & helpers
โ”‚   โ”œโ”€โ”€ fees.ts                 # Fee calculation logic
โ”‚   โ”œโ”€โ”€ i18n.ts                 # Internationalization (EN/SW)
โ”‚   โ””โ”€โ”€ prisma.ts               # Database client singleton
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ pages/                   # Next.js pages & API routes
โ”‚   โ”œโ”€โ”€ index.tsx               # Landing page
โ”‚   โ”œโ”€โ”€ waitlist.tsx            # Waitlist signup form
โ”‚   โ”œโ”€โ”€ _app.tsx                # App wrapper
โ”‚   โ””โ”€โ”€ api/
โ”‚       โ””โ”€โ”€ waitlist.ts         # POST /api/waitlist endpoint
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ prisma/
โ”‚   โ””โ”€โ”€ schema.prisma           # Database schema
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ styles/
โ”‚   โ””โ”€โ”€ globals.css             # Global styles, animations, Tailwind
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ public/                  # Static assets
โ”‚
โ”œโ”€โ”€ .env.example                # Environment template
โ”œโ”€โ”€ tailwind.config.js          # Tailwind configuration
โ”œโ”€โ”€ tsconfig.json               # TypeScript configuration
โ””โ”€โ”€ package.json                # Dependencies & scripts

๐ŸŽฏ Roadmap

๐Ÿ Q4 2024

Foundation

โœ… Landing page โœ… Waitlist system โœ… Core architecture โœ… Chain agnostic design โœ… x402 protocol integration

๐Ÿ”จ Q1 2025

Alpha

โฌœ Wallet integration โฌœ First chain (Base) โฌœ Developer SDK โฌœ Private beta launch โฌœ Security audit

๐Ÿงช Q2 2025

Beta

โฌœ Multi-chain support โฌœ iOS & Android apps โฌœ Merchant dashboard โฌœ Public beta โฌœ Fiat on/off ramps

๐Ÿš€ Q3 2025

Launch

โฌœ Production release โฌœ Agent marketplace โฌœ Enterprise APIs โฌœ Global expansion โฌœ More chains


๐Ÿค Contributing

We ๐Ÿ’š contributions! Here's how you can help:

Type Description
๐Ÿ› Bug Reports Found a bug? Open an issue
๐Ÿ’ก Feature Ideas Have an idea? Start a discussion
๐Ÿ“– Documentation Help us improve docs
๐Ÿ”ง Code Submit a pull request

Development Setup

# Fork and clone
git clone https://github.com/YOUR_USERNAME/X402PESA.git
cd X402PESA/x402pesa-landing

# Install & run
pnpm install
pnpm dev

# Make changes, then submit a PR!

๐Ÿ“œ License

X402PESA is open source software licensed under the MIT License.


๐Ÿ”— Links & Resources

๐ŸŒ Website ๐Ÿ“– Docs ๐Ÿ”— x402 Protocol
๐Ÿฆ Twitter ๐Ÿ’ฌ Discord ๐Ÿ“ง Email



๐ŸŒ Built for the World

Fully Onchain ย โ€ขย  Chain Agnostic ย โ€ขย  Worldwide


Made with ๐Ÿ’š by the X402PESA team

ยฉ 2024-2025 X402PESA ย โ€ขย  Powered by x402 Protocol


โญ Star this repo if you believe in the future of global payments!

About

X402PESA: Global payments via x402 protocol. Send, spend and stream money anywhere in the world with fees so small they feel like a typo, in under a second, fully onchain and chain agnostic.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors