Prerequisites
- A wallet funded with testnet USDC and source-chain gas
- A recipient address for Gateway on Polygon Amoy
- Node.js 22.18 or later and
viemfor the example
Create and read a deposit address
The create and lookup paths below were verified on 2026-09-16. A read-only lookup on 2026-09-30 (UTC) also returned the expected404 for an unknown address; address creation was not repeated in that check. They do not require an API key. No requests-per-second quota is published; use bounded retries and honor Retry-After when present.
Set ECO_TESTNET_DEPOSITOR and ECO_TESTNET_RECIPIENT to your test wallets. This example creates an address and reads the returned record without funding it.
data.vaultAddress, data.amount, and data.deadline. The lookup supplies the deposit state. Validation failures use 400 with the service’s validationErrors or details envelope. Keep the HTTP status and response body when reporting a test failure.
Fund and confirm delivery
Send the quoted testnet USDC amount to the returned address on the specified source chain before its deadline. Check the source transaction receipt, then read the deposit record using the same testnet host andsourceChainId.
PUBLISHED means the intent was published. Confirm the recipient’s Gateway balance on Polygon Amoy separately; it does not mean that publication itself credited the balance.
Do not substitute mainnet v1 paths into this legacy testnet host. The mainnet gasless request examples are not a reference for testnet endpoint paths.
