Project Name
0G Ramp
Tagline: “The Native Fiat↔Crypto Bridge for 0G Network”
Project Website
Project Brief
What Problem You’re Solving
0G Ramp addresses the critical barrier between traditional finance (fiat) and decentralized finance (crypto). Users currently face challenges with:
-
Complex and fragmented on/off-ramp solutions
-
Lack of transparent, secure, and auditable transaction records
-
Limited options for converting fiat ↔ stablecoins (USDC) on emerging L1 chains like 0G Network
-
No decentralized storage solution for transaction receipts and KYC data
Your Solution and Key Features
A full-stack fiat↔crypto ramp built natively on 0G Network featuring:
-
On-Ramp Service: Convert fiat (USD, EUR, GBP) to USDC via secure payment sessions
-
Off-Ramp Service: Withdraw USDC to fiat through bank transfers or mobile money
-
Smart Contract Infrastructure:
-
RampAdmin - Admin settings, fee management, role-based access control
-
RampVault - Secure token vault for on/off-ramp flows with reentrancy protection
-
ReceiptRegistry - On-chain anchoring of transaction receipts (IPFS CIDs)
-
0G Storage Integration: Receipts and KYC document hashes stored on 0G decentralized storage
-
Multi-Provider Support: Integration-ready for Transak, LI .FI, and custom payment providers
-
Developer API: REST API with API key management for third-party integrations
-
KYC System: Secure KYC submission with documents anchored to 0G storage
Target Users and Market
-
End Users: Individuals seeking easy fiat↔crypto conversion on 0G Network
-
Businesses/Merchants: Accept crypto payments, convert to fiat
-
Developers: Integrate on/off-ramp capabilities via API into their dApps
-
0G Ecosystem: Native ramp solution for the 0G Network ecosystem
-
Emerging Markets: Mobile money integration for underbanked regions
What Makes Your Project Unique
-
0G-Native: First dedicated fiat ramp built specifically for 0G Network (Chain ID: 16661)
-
Decentralized Receipt Storage: Transaction receipts stored on 0G’s decentralized storage, not centralized servers
-
On-Chain Auditability: ReceiptRegistry contract provides transparent transaction anchoring
-
Full-Stack Solution: Complete end-to-end from frontend wallet connection to backend payment processing
-
Multi-Currency Support: USD, EUR, GBP with multiple payout methods (bank, mobile money)
-
Modern Tech Stack: React 19, Vite 7, Wagmi 2, RainbowKit 2, Solidity 0.8.23
How Will You Integrate 0G?
Technical Implementation Details
| Component | 0G Integration |
|---|---|
| Smart Contracts | Deployed on 0G Mainnet (Chain ID: 16661) via RPC: evmrpc.0g.ai |
| Receipt Storage | ogStorageService.js - Uploads transaction receipts to 0G Storage API |
| KYC Documents | Document hashes anchored via 0G Storage for compliance |
| On-Chain Registry | ReceiptRegistry.sol maps transaction hashes to storage CIDs |
| Token Vault | RampVault.sol manages USDC deposits/withdrawals on 0G |
Deployed Contract Addresses (0G Mainnet):
-
RampAdmin: 0x6769a188aD0107448aa728147229305F1bc0d5Fb
-
RampVault: 0x95969bEd2dF41dA0F052B861C2051266462b0D64
-
ReceiptRegistry: 0x3AA0cD329e2321b86D7F5444F8fF0CCb89F3d74c
-
MockUSDC: 0xC42E02399D701aAdd7AE012b54Ac2De088AAb8d6
Which Features Use 0G Services
-
0G EVM Chain: All smart contract operations (deposits, withdrawals, fee management)
-
0G Storage API: Transaction receipt storage (storeReceipt), KYC document hash anchoring (storeKycHash)
-
0G RPC: Backend operator wallet signs transactions via evmrpc.0g.ai
Timeline for Integration
-
Completed: Smart contracts deployed on 0G Mainnet -
Completed: 0G Storage service integration code ready
-
In Progress: Production deployment and testing -
Upcoming: Full 0G Storage API activation with production keys
Expected Benefits from Using 0G
-
High Throughput: Fast transaction finality for seamless user experience
-
Decentralized Storage: Receipts permanently stored without centralized dependency
-
Cost Efficiency: Lower fees compared to Ethereum L1
-
Ecosystem Growth: Adds critical DeFi infrastructure to 0G Network
GitHub Repository
Demo/Prototype
[Link in beginning]
-
Frontend: Deployable via Netlify (netlify.toml included)
-
Backend: Dockerized, ready for Render deployment
-
Local Demo: docker compose up -d for full stack testing
Documentation
-
README.md - Complete project overview and quickstart
-
BACKEND_SETUP.md - Detailed backend deployment guide
-
In-code documentation throughout smart contracts
Social Media
-
Twitter/X: [Your Twitter handle]
-
Discord: alex0228
-
Telegram: [Your Telegram handle]
Technical Architecture Summary
┌─────────────────────────────────────────────────────────────────┐
│ Frontend (React) │
│ • Wagmi/RainbowKit wallet connection │
│ • On-Ramp / Off-Ramp UI flows │
│ • Transaction history dashboard │
└─────────────────────────┬───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Backend API (Express/Prisma) │
│ • Payment session management │
│ • Webhook handlers (HMAC verified) │
│ • On-chain operations via operator key │
│ • KYC submission endpoint │
└──────────┬─────────────────────────────────────┬────────────────┘
│ │
▼ ▼
┌──────────────────────┐ ┌─────────────────────────┐
│ 0G Mainnet EVM │ │ 0G Storage │
│ • RampAdmin │ │ • Receipt uploads │
│ • RampVault │ │ • KYC hash anchoring │
│ • ReceiptRegistry │ │ │
└──────────────────────┘ └─────────────────────────┘
IMPORTANT NOTE FOR REVIEWERS
Due to submission restrictions, we are limited to including only 2 hyperlinks in this application. All other URLs have been provided as plain text. To access these resources, please prepend https:// to the text URLs listed below
Additional Resources (Plain Text URLs)
Prepend https:// to access:
-
0G RPC Endpoint: evmrpc.0g.ai
-
Contract verification on 0G Explorer: chainscan.0g.ai (search by contract addresses above)