latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-193774225.7 KB

c9aa3f252e4f

Processing

Submit a signed permit deposit

Experimental. Accepts the owner-signed ERC-3009, ERC-2612, or Permit2 payload prepared by POST /deposits/permit/prepare and immediately starts settlement: the pull from the owner wallet rides inside the bridging intent as a preclaim op, so funds move atomically with the claim. The server reconstructs the typed data from primitive fields and verifies the signature, domain, deadline window, and on-chain replay state before accepting. Returns a synthetic tracking hash usable everywhere a deposit tx hash is until the real source transaction replaces it.

post/deposits/permit

Headers

x-api-keystring

API key for authentication (omit when sending Authorization)

Example:your-api-key

API key for authentication (omit when sending Authorization)

authorizationstring

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Example:Bearer eyJhbGciOi...

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Request body

OR
OR

Example request

{
  "account": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "sourceChain": "eip155:8453",
  "token": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "amount": "1000000000000000000",
  "owner": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "signature": "0x1234abcd",
  "nonce": "0x000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f",
  "validAfter": "1000000000000000000",
  "validBefore": "1000000000000000000"
}

Response

Deposit accepted and processing started

depositIdstring required
txHashstring required

Hex-encoded string (0x followed by hex characters)

status'processing' required

Example response

{
  "txHash": "0x1234abcd"
}