Architecture
SodaPop is a non-custodial crypto payment infrastructure with two product layers backed by deployed smart contracts.
Product Layers
- Client Product (Frontend Dashboard)
- Wallet-based Web3 login and short-lived challenge verification.
- Session token model (
Authorization: Bearer <accessToken>). - User-managed invoices and gasless on-chain settings.
- Integration Product (Server-to-Server)
- Signed request model (
x-depay-signature,x-depay-timestamp). - External services create, query, list, and cancel invoices for owner wallets.
- External services submit signed fee/payout meta-transactions.
Core Components
- Smart Contracts: payment and settings execution on supported EVM chains.
- API Service: validation, auth/signature checks, invoice lifecycle management, and integration endpoints.
- Dashboard UI: operator interface for Web3 login, invoice operations, and on-chain settings.
- Background Monitor: periodic payment checks and withdrawal queue processing.
Trust and Custody Model
- Non-custodial design: funds belong to the owner wallet.
- API service orchestrates checks and transaction relays; it does not replace ownership.
- Security model is split by product layer and must not be mixed.
Supported Chains
- Ethereum (1)
- Optimism (10)
- BSC (56)
- Polygon (137)
- Base (8453)
- Arbitrum (42161)
- Avalanche (43114)