v18

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

Processing

Recover a failed deposit with an owner signature

Return a failed or rejected deposit's source-chain funds to a user-chosen recipient, authorized by the smart-account owner's EIP-712 signature (not just the API key). The server reconstructs the RecoverDeposit typed data from the stored deposit and verifies it against the account via ERC-1271/ERC-6492, then runs the same claim + transfer path as the refund endpoint. EVM Nexus accounts created by the deposit modal only. Authenticate with an x-api-key (write scope).

post/deposits/recover

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

chainstring required

CAIP-2 chain identifier of the deposit (e.g. "eip155:8453")

txHashstring required

Source transaction hash of the failed/rejected deposit

accountstring required

Deposit smart account that received the funds

tokenstring required

Source token address. Use the zero address for native transfers.

recipientstring required

Address to receive the recovered tokens on the source chain

deadlineinteger required

Unix timestamp (seconds) after which the signature is no longer valid

signaturestring required

Raw 65-byte ECDSA signature by the account owner over the RecoverDeposit typed data

Example request

{
  "chain": "eip155:8453",
  "txHash": "0xabc123...",
  "account": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "token": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91",
  "deadline": 1800000000,
  "signature": "0x1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111"
}

Response

Deposit recovered; funds returned on the source chain

messagestring required

transactionHashstring required

amountstring required