{"id":50816987,"url":"https://github.com/zpaynow/ZeroPay","last_synced_at":"2026-06-30T18:00:44.748Z","repository":{"id":315724209,"uuid":"1059966363","full_name":"zpaynow/ZeroPay","owner":"zpaynow","description":"The Open Payment Gateway for Humans and AI Agents.","archived":false,"fork":false,"pushed_at":"2025-10-23T11:09:58.000Z","size":102,"stargazers_count":28,"open_issues_count":3,"forks_count":9,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-23T12:28:58.095Z","etag":null,"topics":["a2a","crypto","eip8004","payment","x402"],"latest_commit_sha":null,"homepage":"https://zeropay.dev","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zpaynow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-19T07:42:01.000Z","updated_at":"2025-10-23T11:10:01.000Z","dependencies_parsed_at":"2025-09-20T10:25:13.391Z","dependency_job_id":"52b5d737-665b-4294-976c-5bc38bc2d227","html_url":"https://github.com/zpaynow/ZeroPay","commit_stats":null,"previous_names":["zeropaydev/zeropay","zpaynow/zeropay"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zpaynow/ZeroPay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zpaynow%2FZeroPay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zpaynow%2FZeroPay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zpaynow%2FZeroPay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zpaynow%2FZeroPay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zpaynow","download_url":"https://codeload.github.com/zpaynow/ZeroPay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zpaynow%2FZeroPay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34977672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a2a","crypto","eip8004","payment","x402"],"created_at":"2026-06-13T10:05:23.184Z","updated_at":"2026-06-30T18:00:44.736Z","avatar_url":"https://github.com/zpaynow.png","language":"Rust","funding_links":[],"categories":["Full-Stack Payment Gateways"],"sub_categories":["ZeroPay"],"readme":"# ZeroPay\n\n\u003cdiv align=\"center\"\u003e\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=flat\u0026logo=docker\u0026logoColor=white)](https://hub.docker.com/r/zeropaydev/zeropay)\n[![Rust](https://img.shields.io/badge/rust-%23000000.svg?style=flat\u0026logo=rust\u0026logoColor=white)](https://www.rust-lang.org)\n\nAn open-source, self-hosted x402 payment facilitator for AI agents and autonomous systems.\n\n[Features](#features) • [Quick Start](#quick-start) • [Documentation](#documentation) • [Platform](#managed-platform) • [Contributing](#contributing)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nZeroPay is a lightweight, self-hosted x402 payment facilitator built with Rust. It enables AI agents and autonomous systems to programmatically discover, authorize, and settle stablecoin payments using EIP-3009 gasless transfers — with no manual wallet management or blockchain infrastructure required.\n\n### Key Features\n\n- **x402 Protocol**: Full Agent-to-Agent (A2A) payment protocol for autonomous AI integrations\n- **Gasless Payments**: EIP-3009 `transferWithAuthorization` — payer signs off-chain, payee covers gas\n- **Instant Settlement**: No waiting for blockchain confirmation; payment settles in one transaction\n- **Secure**: EIP-712 typed signatures with time-bound authorization windows\n- **Discoverable**: Agents can browse available services via `/x402/discovery`\n- **Multi-Chain**: Ethereum, Polygon, Base, and other EVM-compatible networks\n- **Stablecoin Focused**: USDC, USDT, and other EIP-3009 compatible tokens\n- **EIP-8004 Support**: Optional agent reputation and identity registry integration\n- **Self-Hosted**: Full control over your payment infrastructure\n- **Docker Ready**: One-command deployment\n\n## Quick Start\n\n### Using Docker Compose (Recommended)\n\n1. **Configure your settings** in `docker-compose.yml`:\n   ```yaml\n   environment:\n     - MNEMONICS=your twelve or twenty four word mnemonic phrase\n     - WALLET=0xYourWalletAddress\n     - APIKEY=your-secure-api-key\n   ```\n\n2. **Configure blockchain** in `config.toml`:\n   ```toml\n   [[chains]]\n   chain_type = \"evm\"\n   chain_name = \"base-sepolia\"\n   latency = 1\n   estimation = 12\n   commission = 5\n   commission_min = 50\n   commission_max = 200\n   admin = \"0xYourAdminPrivateKey\"\n   rpc = \"https://base-sepolia.g.alchemy.com/v2/YOUR-API-KEY\"\n   tokens = [\"USDC:0xYourUSDCAddress:2\"]\n   ```\n   The `:2` suffix marks a token as x402-compatible (EIP-3009).\n\n3. **Start all services:**\n   ```bash\n   docker-compose up -d\n   ```\n\n4. **Verify x402 support:**\n   ```bash\n   curl \"http://localhost:9000/x402/support?apikey=your-api-key\"\n   ```\n\nSee [DEPLOYMENT.md](./DEPLOYMENT.md) for detailed setup instructions.\n\n## Documentation\n\n- **[Deployment Guide](./DEPLOYMENT.md)** - Complete setup for Docker and source builds\n- **[API Reference](./API.md)** - x402 REST API endpoints and usage examples\n- **[x402 Protocol Guide](./x402.md)** - Protocol overview and integration details\n- **[AI Integration Guide](./docs/AI_INTEGRATION_GUIDE.md)** - Complete guide for AI agents integrating with ZeroPay\n\n## How x402 Works\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   AI Agent                          │\n│                                                     │\n│  1. GET /x402/requirements  →  discover payee addr  │\n│  2. Sign EIP-712 authorization off-chain            │\n│  3. POST /x402/payments     →  settle on-chain      │\n│  4. Receive tx hash + confirmation                  │\n└─────────────────────────────────────────────────────┘\n                        │\n                        ▼\n┌─────────────────────────────────────────────────────┐\n│                 ZeroPay API                         │\n│                                                     │\n│  /x402/requirements   — payment requirements        │\n│  /x402/payments       — verify + settle             │\n│  /x402/support        — supported schemes           │\n│  /x402/discovery      — browse available services   │\n└───────────────────────┬─────────────────────────────┘\n                        │ transferWithAuthorization\n                        ▼\n┌─────────────────────────────────────────────────────┐\n│              Blockchain (EVM)                       │\n│       EIP-3009 gasless token transfer               │\n└─────────────────────────────────────────────────────┘\n```\n\n**Payment flow:**\n1. Agent calls `GET /x402/requirements` with `customer` + `amount` → gets a payee address and accepted payment schemes\n2. Agent creates an EIP-712 signature authorizing the transfer (off-chain, gasless for payer)\n3. Agent calls `POST /x402/payments` with the signed authorization\n4. ZeroPay verifies the signature and executes `transferWithAuthorization` on-chain\n5. Returns transaction hash to the agent\n\n## Architecture\n\n```\nzeropay/\n├── api/              # REST API server (Axum)\n├── scanner/          # Chain scanner + x402 asset initialization\n├── x402/             # x402 protocol types, facilitator, client SDK\n├── config.toml       # Chain and token configuration\n├── Dockerfile\n└── docker-compose.yml\n```\n\n## Development\n\n### Prerequisites\n\n- Rust 1.75+\n- PostgreSQL 12+\n- Redis 6+\n\n### Build from Source\n\n```bash\ngit clone https://github.com/zpaynow/zeropay.git\ncd zeropay\ncargo build --release\n./target/release/api\n```\n\n## Managed Platform\n\nFor a hassle-free experience, use our managed platform at [zpaynow.com](https://zpaynow.com):\n\n- No infrastructure management required\n- Automatic updates and security patches\n- Multiple chain support out of the box\n- Enterprise-grade reliability\n\n**Setup:** Register at [zpaynow.com](https://zpaynow.com) and use `https://api.zpaynow.com` as your API endpoint.\n\n## Contributing\n\nWe welcome contributions!\n\n### Reporting Vulnerabilities\n\nEmail hi@zpaynow.com instead of using the issue tracker.\n\n### Best Practices\n\n- Never commit `.env` files or private keys\n- Use strong, randomly generated API keys\n- Keep dependencies updated\n- Use secure RPC endpoints\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n\u003e **Usage Notice:** This software is intended for **merchant self-hosting only** — to run your own payment gateway for your own store or service. It may **not** be used to build or operate a payment business, payment platform, or SaaS product that serves other merchants. If you need a managed solution, use [zpaynow.com](https://zpaynow.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzpaynow%2FZeroPay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzpaynow%2FZeroPay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzpaynow%2FZeroPay/lists"}