On/Off Ramp Module
The On/Off Ramp Module serves as the critical bridge between traditional fiat economies and the City Protocol neofinance ecosystem. By integrating with leading global payment gateways, this module ensures that user onboarding and offboarding are frictionless, compliant, and universally accessible.
This module is designed to eliminate the friction typically associated with entering the Web3 space.
Instead of requiring users to navigate complex centralized exchanges before interacting with on-chain assets, the On/Off Ramp Module allows direct fiat-to-crypto and crypto-to-fiat conversions directly within the founder's application interface.
The On/Off Ramp Module is built on top of MCE's regulated settlement layer, and provides programmatic access to fiat deposit instructions, crypto wallet funding, OTC conversion pricing, and third-party fiat withdrawals. The MceRampClient exported from @cityprotocol/core wraps these operations into authenticated asynchronous calls, abstracting away credential management, request signing, and endpoint routing.
This layer exists because vaults alone do not solve the full lifecycle of capital movement. Before a user can subscribe to a vault, their capital needs to arrive on-chain. After a redemption, it often needs to leave. The ramp client closes that gap by giving founders a single SDK surface for moving money in and out of the protocol, whether that money starts in a bank account, a crypto wallet, or needs to land in a third-party beneficiary's account.
The ramp layer is server-side only. API credentials must never be exposed in frontend bundles. All calls are authenticated against MCE's production environment and carry real settlement obligations.
Fiat Gateway Integration
City Protocol aggregates top-tier fiat gateway providers to ensure global coverage, competitive rates, and localized payment methods.
Global Accessibility
Through integrations with Moonpay, Transak, Ramp, Mercuryo, and Alchemy Pay, users can purchase crypto using credit cards, debit cards, bank transfers (SEPA, ACH), and localized payment methods like Apple Pay and Google Pay.
Optimized Routing
The module dynamically routes transactions to the provider offering the highest authorization rates and lowest fees for the user's specific jurisdiction and payment method.
Seamless User Experience
The entire purchasing flow is embedded within the application via the City Protocol SDK, preventing user drop-off by keeping them within the native environment.
Underlying Protocols
Moonpay
Mercuryo
Metacomp
Key Components
Fiat On-Ramp
Bank Deposit Instructions
Returns the receiving bank details (account number, routing number, reference memo) so a user can wire fiat into the protocol from their banking app.
Crypto On-Ramp
Wallet Deposit Address
Generates a network-specific deposit address for a participant, allowing users to fund their account by sending tokens from an external wallet.
OTC Quoting
Conversion Pricing
Fetches live buy/sell quotes for supported trading pairs, letting the frontend preview exchange rates and expected output before committing.
Fiat Off-Ramp
Third-Party Withdrawal
Initiates an outbound wire to an external bank account, covering the full path from protocol-held value to fiat settlement at the beneficiary's bank.
Last updated