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.