Initiate a gasless deposit with EIP-2612
curl --request POST \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612 \
--header 'Content-Type: application/json' \
--data '
{
"chainId": 8453,
"target": {
"depositAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954"
},
"permit": {
"owner": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"spender": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"value": "1000000",
"nonce": "0",
"deadline": 1789526504
},
"signature": "0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b"
}
'import requests
url = "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612"
payload = {
"chainId": 8453,
"target": { "depositAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954" },
"permit": {
"owner": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"spender": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"value": "1000000",
"nonce": "0",
"deadline": 1789526504
},
"signature": "0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
chainId: 8453,
target: {depositAddress: '0x379BAB257e7Eb159538F01165B766A1BEaf2D954'},
permit: {
owner: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
spender: '0x379BAB257e7Eb159538F01165B766A1BEaf2D954',
value: '1000000',
nonce: '0',
deadline: 1789526504
},
signature: '0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b'
})
};
fetch('https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chainId' => 8453,
'target' => [
'depositAddress' => '0x379BAB257e7Eb159538F01165B766A1BEaf2D954'
],
'permit' => [
'owner' => '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
'spender' => '0x379BAB257e7Eb159538F01165B766A1BEaf2D954',
'value' => '1000000',
'nonce' => '0',
'deadline' => 1789526504
],
'signature' => '0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612"
payload := strings.NewReader("{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612")
.header("Content-Type", "application/json")
.body("{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}"
response = http.request(request)
puts response.read_body{
"id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
"status": "published",
"signatureHash": "0x94245dddfb2339e6e06fe251c90de895bf2995ff3c5a5fb185390f1850ed6726",
"subStatuses": [
{
"chainId": 8453,
"quoteIds": [
"quote:8a7cbdcd-2aed-40b0-ab08-c4c10af15f23"
],
"txHash": "0x3ef97346fd076aadb54c851f33ba9234feb34d27442b9bb0abc7a0d75827af13",
"intentHashes": [
"0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749"
],
"state": "published"
}
],
"createdAt": 1789522604,
"updatedAt": 1789522654
}{
"id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
"status": "processing",
"signatureHash": "0x94245dddfb2339e6e06fe251c90de895bf2995ff3c5a5fb185390f1850ed6726",
"subStatuses": [
{
"chainId": 8453,
"quoteIds": [
"quote:8a7cbdcd-2aed-40b0-ab08-c4c10af15f23"
],
"txHash": null,
"intentHashes": [],
"state": "pending"
}
],
"createdAt": 1789522604,
"updatedAt": 1789522614
}{
"type": "https://api.eco.com/v1/errors/invalid-request",
"title": "Request failed validation",
"status": 400,
"code": "invalid-request",
"detail": "chainId: Invalid input: expected number, received undefined; target: Invalid input: expected object, received undefined; permit: Invalid input: expected object, received undefined; signature: Invalid input: expected string, received undefined",
"errors": [
{
"field": "chainId",
"detail": "Invalid input: expected number, received undefined"
},
{
"field": "target",
"detail": "Invalid input: expected object, received undefined"
},
{
"field": "permit",
"detail": "Invalid input: expected object, received undefined"
},
{
"field": "signature",
"detail": "Invalid input: expected string, received undefined"
}
],
"requestId": "f371e43e6fd4406b10e19487b3170edf"
}{
"type": "https://api.eco.com/v1/errors/invalid-api-key",
"title": "API key is missing, unknown, or revoked",
"status": 401,
"code": "invalid-api-key",
"requestId": "98e4c42f-9c70-4539-843e-8d31803001e6"
}{
"type": "https://api.eco.com/v1/errors/permission-denied",
"title": "The caller may not perform this operation",
"status": 403,
"code": "permission-denied",
"requestId": "a9a151aa45c9dbf44c78513905f6606a"
}{
"type": "https://api.eco.com/v1/errors/signature-already-bound",
"title": "This signature is already pinned to a different target",
"status": 409,
"code": "signature-already-bound",
"requestId": "3ff33e83251b3cdb7d3daf15d186b89b"
}{
"type": "https://api.eco.com/v1/errors/quote-expired",
"title": "The quote is unknown or expired at submit time",
"status": 410,
"code": "quote-expired",
"requestId": "19ff8aa0914e6fbe2fcb7fbe930bf0ea"
}{
"type": "https://api.eco.com/v1/errors/chain-not-supported",
"title": "Chain is not supported",
"status": 422,
"code": "chain-not-supported",
"requestId": "252dbcdeebe5465fdc089843e8643b37"
}{
"type": "https://api.eco.com/v1/errors/rate-limit-exceeded",
"title": "Rate limit exceeded",
"status": 429,
"code": "rate-limit-exceeded",
"requestId": "1eac3d6cc2aafa524b0c47a039576f8c"
}{
"type": "https://api.eco.com/v1/errors/internal-error",
"title": "Internal error",
"status": 500,
"code": "internal-error",
"requestId": "02dabcf0f4e3def9a6091526d3d21022"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"instance": "<string>",
"legacyCode": "<string>",
"solverErrors": [
{
"solver": "<string>",
"message": "<string>",
"solverName": "<string>",
"code": "<string>"
}
],
"errors": [
{
"field": "<string>",
"detail": "<string>"
}
],
"requestId": "<string>"
}Circle Gateway fast deposits
Initiate a gasless deposit with EIP-2612
Funds a deposit address gaslessly with a signed EIP-2612 permit.
POST
/
v1
/
circle-gateway
/
deposit-addresses
/
submit
/
erc-2612
Initiate a gasless deposit with EIP-2612
curl --request POST \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612 \
--header 'Content-Type: application/json' \
--data '
{
"chainId": 8453,
"target": {
"depositAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954"
},
"permit": {
"owner": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"spender": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"value": "1000000",
"nonce": "0",
"deadline": 1789526504
},
"signature": "0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b"
}
'import requests
url = "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612"
payload = {
"chainId": 8453,
"target": { "depositAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954" },
"permit": {
"owner": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"spender": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"value": "1000000",
"nonce": "0",
"deadline": 1789526504
},
"signature": "0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
chainId: 8453,
target: {depositAddress: '0x379BAB257e7Eb159538F01165B766A1BEaf2D954'},
permit: {
owner: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
spender: '0x379BAB257e7Eb159538F01165B766A1BEaf2D954',
value: '1000000',
nonce: '0',
deadline: 1789526504
},
signature: '0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b'
})
};
fetch('https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chainId' => 8453,
'target' => [
'depositAddress' => '0x379BAB257e7Eb159538F01165B766A1BEaf2D954'
],
'permit' => [
'owner' => '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
'spender' => '0x379BAB257e7Eb159538F01165B766A1BEaf2D954',
'value' => '1000000',
'nonce' => '0',
'deadline' => 1789526504
],
'signature' => '0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612"
payload := strings.NewReader("{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612")
.header("Content-Type", "application/json")
.body("{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eco.com/v1/circle-gateway/deposit-addresses/submit/erc-2612")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"chainId\": 8453,\n \"target\": {\n \"depositAddress\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\"\n },\n \"permit\": {\n \"owner\": \"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266\",\n \"spender\": \"0x379BAB257e7Eb159538F01165B766A1BEaf2D954\",\n \"value\": \"1000000\",\n \"nonce\": \"0\",\n \"deadline\": 1789526504\n },\n \"signature\": \"0xedc90fdd27654dd49ac1087901450c9c5fdf444943f61faa8d787bee86304d821f06a5db4a67eddf5cf286014d6ec8bd33c64f9e072045a9f3c5e50cc28960fc1b\"\n}"
response = http.request(request)
puts response.read_body{
"id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
"status": "published",
"signatureHash": "0x94245dddfb2339e6e06fe251c90de895bf2995ff3c5a5fb185390f1850ed6726",
"subStatuses": [
{
"chainId": 8453,
"quoteIds": [
"quote:8a7cbdcd-2aed-40b0-ab08-c4c10af15f23"
],
"txHash": "0x3ef97346fd076aadb54c851f33ba9234feb34d27442b9bb0abc7a0d75827af13",
"intentHashes": [
"0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749"
],
"state": "published"
}
],
"createdAt": 1789522604,
"updatedAt": 1789522654
}{
"id": "gasless:0f450218-1b2c-4d3e-8f9a-0b1c2d3e4f5a",
"status": "processing",
"signatureHash": "0x94245dddfb2339e6e06fe251c90de895bf2995ff3c5a5fb185390f1850ed6726",
"subStatuses": [
{
"chainId": 8453,
"quoteIds": [
"quote:8a7cbdcd-2aed-40b0-ab08-c4c10af15f23"
],
"txHash": null,
"intentHashes": [],
"state": "pending"
}
],
"createdAt": 1789522604,
"updatedAt": 1789522614
}{
"type": "https://api.eco.com/v1/errors/invalid-request",
"title": "Request failed validation",
"status": 400,
"code": "invalid-request",
"detail": "chainId: Invalid input: expected number, received undefined; target: Invalid input: expected object, received undefined; permit: Invalid input: expected object, received undefined; signature: Invalid input: expected string, received undefined",
"errors": [
{
"field": "chainId",
"detail": "Invalid input: expected number, received undefined"
},
{
"field": "target",
"detail": "Invalid input: expected object, received undefined"
},
{
"field": "permit",
"detail": "Invalid input: expected object, received undefined"
},
{
"field": "signature",
"detail": "Invalid input: expected string, received undefined"
}
],
"requestId": "f371e43e6fd4406b10e19487b3170edf"
}{
"type": "https://api.eco.com/v1/errors/invalid-api-key",
"title": "API key is missing, unknown, or revoked",
"status": 401,
"code": "invalid-api-key",
"requestId": "98e4c42f-9c70-4539-843e-8d31803001e6"
}{
"type": "https://api.eco.com/v1/errors/permission-denied",
"title": "The caller may not perform this operation",
"status": 403,
"code": "permission-denied",
"requestId": "a9a151aa45c9dbf44c78513905f6606a"
}{
"type": "https://api.eco.com/v1/errors/signature-already-bound",
"title": "This signature is already pinned to a different target",
"status": 409,
"code": "signature-already-bound",
"requestId": "3ff33e83251b3cdb7d3daf15d186b89b"
}{
"type": "https://api.eco.com/v1/errors/quote-expired",
"title": "The quote is unknown or expired at submit time",
"status": 410,
"code": "quote-expired",
"requestId": "19ff8aa0914e6fbe2fcb7fbe930bf0ea"
}{
"type": "https://api.eco.com/v1/errors/chain-not-supported",
"title": "Chain is not supported",
"status": 422,
"code": "chain-not-supported",
"requestId": "252dbcdeebe5465fdc089843e8643b37"
}{
"type": "https://api.eco.com/v1/errors/rate-limit-exceeded",
"title": "Rate limit exceeded",
"status": 429,
"code": "rate-limit-exceeded",
"requestId": "1eac3d6cc2aafa524b0c47a039576f8c"
}{
"type": "https://api.eco.com/v1/errors/internal-error",
"title": "Internal error",
"status": 500,
"code": "internal-error",
"requestId": "02dabcf0f4e3def9a6091526d3d21022"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"instance": "<string>",
"legacyCode": "<string>",
"solverErrors": [
{
"solver": "<string>",
"message": "<string>",
"solverName": "<string>",
"code": "<string>"
}
],
"errors": [
{
"field": "<string>",
"detail": "<string>"
}
],
"requestId": "<string>"
}Funds a deposit address gaslessly with a signed EIP-2612 permit.
target.depositAddress must equal permit.spender. The first submission answers 202 with a gasless job; resending the same signature returns the existing job with 200.
No API key is required: Circle Gateway operations are open so that any wallet or relay can create and fund a deposit address. A supplied key that is unknown, revoked, or not enabled for v1 is still rejected with 401 invalid-api-key, so send no key rather than a wrong one. No requests-per-second quota is published. Handle 429 and honor Retry-After when present. See Errors and retries for common errors and retry handling.
Examples use mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs. They are illustrative and must not be used to transfer funds.Headers
Optional. A key that is unknown, revoked, or not enabled for v1 is rejected with 401.
Body
application/json
Response
Existing job for the same signature and target.