> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway Fast Deposits API

> REST surface for creating quoted Circle Gateway deposit vaults, queueing gasless funding via ERC-3009, and polling vault and job status.

REST surface for [Gateway Fast Deposits](/addresses/gateway-fast-deposits). Create a quoted vault for a specific `(sourceChainId, amount, recipient, depositor)`; fund it gaslessly via ERC-3009 or EIP-2612 Permit, or with a direct transfer; USDC settles into the user's Circle Gateway balance on Polygon.

## Base URL

`https://api.eco.com`

All responses are wrapped as `{ "data": ... }` unless otherwise noted.

## Validation rules

* EVM addresses: must pass `isEthereumAddress` (EIP-55 / lowercase hex)
* `sourceChainId` / `chainId`: integer ≥ 1
* `amount` / `value` / `validAfter` / `validBefore`: non-negative integer strings
* `nonce`: 0x-prefixed 32-byte hex (64 hex chars)
* `signature`: 0x-prefixed 65-byte hex (130 hex chars)

## Endpoints

Use the sidebar to navigate to each endpoint. Two categories:

**Circle Gateway**, create a quoted deposit vault, poll its state. Vault state transitions: `PENDING` → `FUNDING_DETECTED` → `PUBLISHED`, with `EXPIRED_UNFUNDED`, `FAILED`, `REFUNDED_BY_USER`, and `RECOVERY_PUBLISHED` as the non-happy-path outcomes.

**Gasless funding**, submit a signed ERC-3009 authorization or EIP-2612 Permit; poll the resulting relayer job via `GET /circle-gateway/v1/gasless/jobs/{id}`. Job status transitions: `PENDING` → (`PERMIT_SENT` for Permit only) → `COMPLETED` | `FAILED`.