ColossusNet Documentation
The stablecoin-native credit card network settling on Ethereum
Overview
Technical
System Architecture
Four-layer stack, L2 parameters, ERC-4337, and timing budget
Card Architecture
JavaCard applets, dual issuance, cryptographic design, and registration
Transaction Flow
Contact, contactless, and issuer-mediated transaction paths
Smart Contracts
EMVValidator, EMVSettlement, AcquirerConfig, and fee structure
Settlement
Single message system, fee distribution, and wire liquidation
Cross-Chain
LayerZero OFT V2 bridging and source chain modules
ISO 8583 Middleware
Message parsing, UserOperation construction, and gas sponsorship
Security
Threat model, trust assumptions, OFAC compliance, and key hierarchy
Deployment
Terminal configuration, CAPK entries, and network parameters
Guides
For Merchants
Fee savings, settlement, registration, and wire liquidation
For Issuers
Collateral model, signing API, interchange revenue, and credit policy
For Acquirers
ISO 8583 integration, fee structure, merchant management
For Cardholders
Wallet setup, card registration, funding, and payments
Reference
FAQ
Common questions about cards, fees, regulation, and compatibility
API Reference
ISO 8583 middleware endpoints and schemas
Repositories
Source code is available at github.com/colossus-credit:
| Repository | Language | Description |
|---|---|---|
| emv-validator | Solidity | ERC-7579 Validator and Executor for ERC-4337 |
| emv-card-sim | Java | ColossusNet JavaCard applet simulator |
| emvpt | Rust | Minimum Viable Payment Terminal |
| kernel | Solidity | ZeroDev Kernel (ERC-4337 smart account) |
| devnet | JavaScript | ColossusNet local development network |
| rollup-boost | Rust | Sidecar to enable rollup extensions |
| builder-playground | Go | End-to-end block building environment |