Approve EVM token
Generates an unsigned ERC20 approve() transaction that enables gasless
offramps on EVM chains. When enabled for your organization, EVM offramp
transactions no longer require the user to hold native gas tokens (e.g. ETH on
Base) — Etherfuse covers the bridging cost and bundles it into the offramp fee.
This approval must be completed before creating an offramp order via
POST /ramp/order for EVM wallets with this feature enabled; otherwise the
offramp transaction fails on-chain.
Prerequisites:
- The feature must be enabled for your organization (contact Etherfuse).
- The user must have a registered EVM wallet on a supported chain.
Flow:
- Call this endpoint to get the approval transaction.
- Have the user sign and submit it in their wallet.
- Once confirmed, create the offramp order via
POST /ramp/order.
Approval amount: omit amount (recommended) to approve an unlimited amount
once per token per chain; or pass amount in base units to approve a specific
amount (consumed after each offramp). If a sufficient allowance already exists,
the response has "transaction": null.
Authorizations
API key sent in the Authorization header.
Body
Request body for generating an EVM token-approval transaction.
Documentation schema for [evm_approve_proxy]. The handler forwards the body
to the bridge service verbatim; this type only describes the expected shape.
The token contract address to approve (0x-prefixed, 40 hex chars).
The EVM chain to approve on (currently base).
The user's EVM wallet address (0x-prefixed, 40 hex chars).
Amount to approve in base units (token's smallest denomination). For a
6-decimal token, 10000000 = 10 tokens. Omit to approve the maximum
(recommended — a one-time approval covers all future offramps).
Response
Approval transaction, or transaction: null if already approved