Wallet Webhooks

Wallet transaction replaced

Triggered when the wallet.transaction.replaced webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookwalletTransactionReplaced

Payload

transaction_hashstring required

The onchain transaction hash of the replaced transaction.

addressstring required

A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).

network'base' | 'ethereum' | 'solana' | 'aptos' | 'arbitrum' | 'arbitrum-sepolia' | 'optimism' | 'polygon' | 'world' | 'world-sepolia' required

The blockchain network for the payment. Supported networks depend on the account type.

replaced_atstring date-time required

When the transaction was replaced (ISO 8601 format).

user_idstring required

The user ID that owns the User Wallet.

delegation_idstring required

The delegation grant ID used to authorize the action.

Example payload

{
  "transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "network": "base",
  "replaced_at": "2025-06-01T10:03:00Z",
  "user_id": "user_12345",
  "delegation_id": "delegation_af2937b0-9846-4fe7-bfe9-ccc22d935114"
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.