CLI for the Mento Protocol — onchain FX infrastructure
A command-line interface that wraps @mento-protocol/mento-sdk v3, bringing the full power of Mento's onchain FX protocol to your terminal. Inspect tokens, discover routes, get quotes, and execute swaps — all without leaving the command line.
mento-cli is a structured, ergonomic CLI built on Commander.js. It connects directly to the Celo blockchain (or any supported chain) via the Mento SDK, giving you real-time access to:
- Protocol tokens and their on-chain supply
- Trading routes between token pairs
- Liquidity pool details and configuration
- Live swap quotes with multi-route comparison
- On-chain token swaps with slippage controls
- Trading status and circuit-breaker limits
- Protocol metadata and contract addresses
# Install globally
npm install -g mento-cli
# Or run directly without installing
npx mento-cliRequires Node.js >= 18.
# Show all Mento stable tokens
mento tokens
# Discover available trading routes
mento routes
# Get a quote for swapping 100 USDm to CELO
mento quote USDm CELO 100
# Show protocol overview
mento infoList tokens known to the Mento Protocol.
mento tokens # List stable tokens (default)
mento tokens --collateral # List collateral assets
mento tokens --all # List both stable and collateral tokens
mento tokens --json # Output as JSON| Flag | Description |
|---|---|
--collateral |
Show collateral assets instead of stable tokens |
--all |
Show all tokens (stable + collateral) |
Discover trading routes between token pairs.
mento routes # List all available routes
mento routes --from USDm --to CELO # Filter routes by token pair
mento routes --direct # Show only direct (single-hop) routes
mento routes --fresh # Bypass cache, fetch live from chain
mento routes --graph # Show route graph visualization| Flag | Description |
|---|---|
--direct |
Show only direct routes (no multi-hop) |
--from <token> |
Filter by source token symbol |
--to <token> |
Filter by destination token symbol |
--fresh |
Skip cache and fetch routes from chain |
--graph |
Display an ASCII route graph |
Inspect liquidity pools and their configuration.
mento pools # List all pools
mento pools --type VirtualPool # Filter by pool type
mento pools --details <address> # Show detailed info for a specific pool
mento pools --json # Output as JSON| Flag | Description |
|---|---|
--type <type> |
Filter pools by type (e.g., VirtualPool) |
--details <address> |
Show detailed configuration for a pool |
Get swap quotes for a token pair and amount.
mento quote USDm CELO 100 # Quote 100 USDm → CELO
mento quote CELO USDm 50 # Quote 50 CELO → USDm
mento quote USDm CELO 100 --all-routes # Compare quotes across all routes
mento quote USDm CELO 100 --json # Output as JSONPositional arguments: <from> <to> <amount>
| Flag | Description |
|---|---|
--all-routes |
Show quotes from all available routes for comparison |
Execute a token swap on-chain.
mento swap USDm CELO 100 --private-key 0x... # Swap with inline key
mento swap USDm CELO 100 --keyfile ./key.txt # Swap with keyfile
mento swap USDm CELO 100 --dry-run # Preview without sending tx
mento swap USDm CELO 100 --slippage 1 --yes # 1% slippage, skip promptPositional arguments: <from> <to> <amount>
| Flag | Description | Default |
|---|---|---|
--private-key <key> |
Private key for transaction signing | — |
--keyfile <path> |
Path to file containing private key | — |
--slippage <percent> |
Maximum slippage tolerance (%) | 0.5 |
--deadline <minutes> |
Transaction deadline in minutes | 5 |
--dry-run |
Output CallParams as JSON without sending | — |
-y, --yes |
Skip the confirmation prompt | — |
Check trading status and limits.
mento trading status # Check trading status for all routes
mento trading status USDm CELO # Check if a specific pair is tradable
mento trading limits # Show trading limits for all pools
mento trading limits --json # Output limits as JSONSubcommands: status, limits
Show protocol overview and contract addresses.
mento info # Protocol overview (pools, routes, tokens)
mento info --contracts # List all known contract addresses
mento info --chain celo-sepolia # Show info for testnet
mento info --json # Output as JSON| Flag | Description |
|---|---|
--contracts |
List all known Mento contract addresses |
Refresh cached protocol data from the blockchain.
mento cache routes # Refresh the routes cache
mento cache tokens # Refresh the tokens cacheSubcommands: routes, tokens
These flags can be used with any command:
| Option | Description | Default |
|---|---|---|
-c, --chain <name-or-id> |
Chain name (celo, celo-sepolia) or numeric chain ID |
celo |
--rpc <url> |
Custom RPC endpoint URL | Chain default |
--json |
Output as JSON instead of formatted tables | false |
-V, --version |
Print version | — |
-h, --help |
Show help for a command | — |
mento-cli supports multiple chains via the --chain flag. Pass a chain name or numeric chain ID:
# Celo mainnet (default)
mento tokens
# Celo Sepolia testnet
mento tokens --chain celo-sepolia
# By chain ID
mento tokens --chain 44787
# With a custom RPC endpoint
mento info --chain celo --rpc https://my-rpc.example.comThe chain registry maps chain names to their chain IDs and default RPC endpoints. The SDK handles chain-specific contract addresses automatically.
# Full workflow: inspect → quote → swap
mento tokens --all
mento routes --from USDm --to CELO
mento quote USDm CELO 100
mento swap USDm CELO 100 --private-key 0x... --slippage 0.5
# Pipe JSON output to jq for scripting
mento tokens --json | jq '.[] | .symbol'
mento quote USDm CELO 100 --json | jq '.amountOut'
# Check if trading is active before swapping
mento trading status USDm CELO
# Refresh cached data if results seem stale
mento cache routes
mento cache tokens- SDK: github.com/mento-protocol/mento-sdk
- Protocol: mento.org
- PRD: docs/PRD.md
MIT