Skip to main content
The Eco Routes CLI is the fastest path to move money with Eco — direct access to the stablecoin settlement layer with no integration code to write. Query routes, simulate transfers, and execute cross-chain transactions from the command line. It launches an interactive wizard that handles quote fetching, vault derivation, funding, and publishing. Use the CLI for:
  • First-time exploration
  • Manual operations and scripting
  • Multi-VM source/destination pairs (EVM, SVM)
For programmatic, server-side integration, use the REST API.

​
0. Prerequisites

  • Node 18+
  • Funded wallet on the source chain
  • Source-chain RPC endpoint (optional — sane defaults are used otherwise)

​
1. Install globally

npm i -g eco-routes-cli

​
2. Publish your first EVM intent

eco-routes-cli publish --private-key 0xYOUR_PRIVATE_KEY
Follow the prompts to select source chain (e.g. Base), destination chain (e.g. Optimism), token, and amounts. Done.
Pass --source and --destination to skip the chain selection prompts.
Prefer not to pass keys inline? Copy .env.example to .env and set EVM_PRIVATE_KEY (or SVM_PRIVATE_KEY for Solana) — the CLI will pick it up automatically.
Never commit .env. Always add it to .gitignore. Never hardcode private keys in source.

​
3. Track fulfillment

The intent hash returned in step 2 can be used to monitor the destination Portal’s IntentFulfilled event, or polled via the intent-status API endpoint.

Routes API

Same flow, programmatic.

Recipes

Full integration patterns.

Architecture overview

What the CLI is calling under the hood.