# Eco Docs

> Eco is the programmable infrastructure layer for real-time stablecoin movement across blockchain chains. It provides intent-based cross-chain bridging and swapping (Routes), multi-chain token permissions (Permit3), programmable deposit addresses, and crowd-sourced liquidity — enabling developers to build multi-chain stablecoin applications with simple API or SDK calls. Eco supports USDC, USDT, and other major stablecoins across Ethereum, Base, Optimism, Arbitrum, Polygon, Solana, and more.

Key constraints: API quote endpoints require no authentication. Solver registration requires request signature headers. All smart contract interactions use EVM-compatible wallets. Cross-chain intents are fulfilled by competing solvers who front capital on destination chains. Typical fulfillment time is under 5 seconds.

## Getting Started

- [What is Eco?](https://eco.com/docs/getting-started/introduction/what-is-eco.md): Overview of the Eco protocol covering Routes, Permit3, Accounts, and Crowd Liquidity
- [How to use the Eco Routes CLI](https://eco.com/docs/getting-started/routes/quickstart.md): Step-by-step quickstart to install the CLI and execute your first cross-chain stablecoin transfer
- [How to use the Eco Routes API](https://eco.com/docs/api-quickstart.md): Create and execute cross-chain intents using direct smart contract interactions with TypeScript code examples
- [How to integrate Permit3](https://eco.com/docs/getting-started/permit3/quickstart.md): Quick integration guide for Permit3 cross-chain token permissions
- [Get Started with Programmable Addresses](https://eco.com/docs/getting-started/programmable-addresses/quickstart.md): Create programmable deposit addresses for cross-chain deposits to Solana

## Guides

- [How to integrate as a solver](https://eco.com/docs/getting-started/solvers/overview.md): Complete guide to registering as a solver, providing quotes, and fulfilling cross-chain intents
- [Permit3 guides](https://eco.com/docs/getting-started/permit3/guides.md): In-depth guides for advanced Permit3 integration scenarios including multi-chain approvals
- [Permit3 examples](https://eco.com/docs/getting-started/permit3/examples.md): Code examples and implementation patterns for Permit3

## Technical Reference

- [What is Eco Routes?](https://eco.com/docs/getting-started/routes/overview.md): Intent-based architecture for cross-chain stablecoin transfers with Portal, Vault, and Executor contracts
- [How the portal contract works](https://eco.com/docs/getting-started/routes/portal.md): Main entry point contract for intent publishing, fulfillment, and reward claiming
- [How the vault contract works](https://eco.com/docs/getting-started/routes/vault.md): Escrow contract that holds intent rewards until claimed or refunded
- [How the executor contract works](https://eco.com/docs/getting-started/routes/executor.md): Isolated contract that executes intent calls on the destination chain
- [How ERC-7683 works in Eco Routes](https://eco.com/docs/getting-started/routes/erc-7863.md): How Eco Routes implements the ERC-7683 standard for cross-chain order execution
- [Supported chains and tokens](https://eco.com/docs/getting-started/routes/chain-support.md): Full list of supported chains (Ethereum, Base, Optimism, Arbitrum, Polygon, Solana, and more) and tokens (USDC, USDT, WETH)
- [What is Permit3?](https://eco.com/docs/getting-started/permit3/overview.md): Multi-chain token permissions protocol extending Permit2 with cross-chain approvals via a single signature
- [Permit3 concepts](https://eco.com/docs/getting-started/permit3/concepts.md): Core concepts and architecture of Permit3 including Unbalanced Merkle Trees and cross-chain state
- [What are Programmable Addresses?](https://eco.com/docs/getting-started/programmable-addresses/overview.md): Persistent addresses with programmable routing and settlement logic for cross-chain transfers
- [How the Address Factory Works](https://eco.com/docs/getting-started/programmable-addresses/factory-contract.md): Factory contract that generates deterministic programmable addresses using CREATE2
- [How the Deposit Contract Works](https://eco.com/docs/getting-started/programmable-addresses/deposit-contract.md): Programmable address contract that receives tokens and executes cross-chain intent actions
- [Gateway Deposit Addresses API](https://eco.com/docs/getting-started/programmable-addresses/gateway-api.md): REST API for generating Gateway deposit addresses, funding them gaslessly, and tracking job/intent status
- [Solana Deposit Addresses API](https://eco.com/docs/getting-started/programmable-addresses/solana-api.md): REST API for generating Solana deposit addresses and querying intents
- [What are Eco accounts?](https://eco.com/docs/getting-started/accounts/accounts.md): Smart contract accounts that unify stablecoin balances across multiple chains
- [What is Eco crowd liquidity?](https://eco.com/docs/getting-started/crowd-liquidity/crowd-liquidity.md): Permissionless just-in-time liquidity aggregation for cross-chain solver transactions

## Provers

- [How the Hyperlane prover works](https://eco.com/docs/getting-started/routes/provers/hyperlane.md): Cross-chain verification using Hyperlane's modular interoperability stack
- [How the LayerZero prover works](https://eco.com/docs/getting-started/routes/provers/layerzero.md): Cross-chain verification using LayerZero's omnichain messaging protocol
- [How the Metalayer prover works](https://eco.com/docs/getting-started/routes/provers/metalayer.md): Cross-chain verification using Caldera Metalayer's messaging infrastructure
- [How the Polymer Prover Works](https://eco.com/docs/getting-started/routes/provers/polymer.md): Cross-chain verification using Polymer's IBC-based messaging protocol
- [How the CCTP Prover Works](https://eco.com/docs/getting-started/routes/provers/cctp.md): Attestation-based settlement using Circle's Cross-Chain Transfer Protocol
- [How the local prover works](https://eco.com/docs/getting-started/routes/provers/local.md): Same-chain intent fulfillment without cross-chain messaging overhead

## API Reference

- [Get Single Quote](https://eco.com/docs/api-reference/quotes-v3/get-single-quote.md): Retrieve the best quote for a cross-chain token swap with pricing, fees, and estimated fulfillment time
- [Get Exact In Quotes](https://eco.com/docs/api-reference/quotes-v3/get-exact-in-quotes.md): Specify what you want to offer and get quotes for what will be received across chains
- [Get Exact Out Quotes](https://eco.com/docs/api-reference/quotes-v3/get-exact-out-quotes.md): Specify the exact output amount and get quotes for the required input across chains
- [Initiate Gasless Intent](https://eco.com/docs/api-reference/quotes-v3/initiate-gasless-intent.md): Submit a gasless intent transaction using a previously obtained quote for solver execution
- [Get Intent Status](https://eco.com/docs/api-reference/quotes-v3/get-intent-status.md): Query the current status of a cross-chain intent by intentHash, intentCreatedHash, or fulfillmentHash
- [Get Intent Status Array](https://eco.com/docs/api-reference/quotes-v3/get-intent-status-array.md): Query the status of multiple intents created in the same transaction, limited to 100 results
- [Register Solver](https://eco.com/docs/api-reference/solver-registration/register-solver.md): Register a new solver to provide quotes and execute intents (requires request signature authentication)
- [Update Solver](https://eco.com/docs/api-reference/solver-registration/update-solver.md): Update solver configuration including endpoints, supported routes, and execution types
- [Post Solver Quote](https://eco.com/docs/api-reference/quotev2/post-apiv2quote.md): Solver-facing endpoint to submit a quote for an intent (v2 solver interface)
- [Post Solver Reverse Quote](https://eco.com/docs/api-reference/quotev2/post-apiv2quotereverse.md): Solver-facing endpoint to submit a reverse quote for an intent (v2 solver interface)
- [Initiate Gasless Intent (Solver)](https://eco.com/docs/api-reference/intentinitiationv2/initiate-gasless-intent.md): Solver-facing endpoint to initiate gasless intent execution (v2 solver interface)

## SDKs and Tools

- [How to Use the Eco SDK](https://eco.com/docs/sdk-reference/overview.md): TypeScript SDK overview for intent-based cross-chain stablecoin transfers
- [How to Install the Eco SDK](https://eco.com/docs/sdk-reference/install.md): Installation instructions and setup for the Eco TypeScript SDK
- [Eco SDK API Reference](https://eco.com/docs/sdk-reference/api-reference.md): Complete RoutesService API reference with method signatures and parameters
- [Eco SDK Advanced Features](https://eco.com/docs/sdk-reference/advanced-features.md): Custom configurations, timeout handling, and advanced SDK usage patterns
- [Contract Addresses](https://eco.com/docs/resources/contract-addresses.md): Deployed contract addresses for Eco Routes on all supported chains (Arbitrum, Base, Optimism, Polygon, and more)
- [Key Concepts](https://eco.com/docs/resources/key-concepts.md): Glossary of essential blockchain concepts including intents, account abstraction, message bridges, and storage proofs

## OpenAPI Specs

- [Routes API Specification](https://eco.com/docs/openapi.json): OpenAPI spec for quote endpoints, intent status, and gasless intent initiation
- [Solver Registry API Specification](https://eco.com/docs/openapi_1.json): OpenAPI spec for solver registration and configuration management
- [Solver Interface API Specification](https://eco.com/docs/solver_openapi.json): OpenAPI spec for the solver-facing quote and intent initiation endpoints

## Optional

- [Move stablecoins across chains in real-time](https://eco.com/docs/getting-started/use-cases/money-movement.md): Use case overview for instant cross-chain transfers powered by Eco Routes
- [Program perfect execution](https://eco.com/docs/getting-started/use-cases/programmable-execution.md): Use case overview for conditional transfers powered by Eco Routes
- [Simplify onchain UX](https://eco.com/docs/getting-started/use-cases/stablecoin-abstraction.md): Use case overview for chain-agnostic payments powered by Eco Routes and Permit3
- [Ship multi-chain apps without the complexity](https://eco.com/docs/getting-started/solutions/apps.md): Solution guide for app developers building with stablecoins
- [Expand to every chain without fragmenting liquidity](https://eco.com/docs/getting-started/solutions/issuers.md): Solution guide for stablecoin issuers expanding cross-chain reach
- [Automate cross-chain yield strategies](https://eco.com/docs/getting-started/solutions/yield-managers.md): Solution guide for yield managers with automated cross-chain rebalancing
- [Route users directly to any chain and protocol](https://eco.com/docs/getting-started/solutions/onramps.md): Solution guide for onramps and payment providers
- [Accept deposits from any chain in one click](https://eco.com/docs/getting-started/solutions/protocols.md): Solution guide for DeFi protocols accepting cross-chain deposits
- [Fulfill large intents without locking up capital](https://eco.com/docs/getting-started/solutions/solvers.md): Solution guide for solvers using Crowd Liquidity for capital-efficient execution
- [Bridge with Eco Portal](https://eco.com/docs/external-link-2.md): Web interface for bridging stablecoins across chains at portal.eco.com
- [Integration Inquiry](https://eco.com/docs/external-link-1.md): Contact Eco for integration support via email
- [Audit Reports & Bounties](https://eco.com/docs/external-link-3.md): Security audit reports and bug bounty program on Cantina
- [Eco Discord](https://eco.com/docs/external-link-4.md): Community Discord server for developer support and discussion