Earn deposit rejected

Fired when a wallet action fails before any onchain effects (e.g. policy rejection, simulation failure). Safe to retry.

postWebhookwallet_action.earn_deposit.rejected

Payload

type'wallet_action.earn_deposit.rejected' required

The type of webhook event.

reference_idstring nullable

Developer-provided reference ID, if one was included in the request.

wallet_action_idstring required

The ID of the wallet action.

wallet_idstring required

The ID of the wallet involved in the action.

action_type'swap' | 'transfer' | 'earn_deposit' | 'earn_withdraw' | 'earn_incentive_claim' | 'earn_fee_collect' | 'payout' required

Type of wallet action

created_atstring required

ISO 8601 timestamp of when the wallet action was created.

caip2string required

CAIP-2 chain identifier.

vault_idstring required

The vault ID.

vault_addressstring required

ERC-4626 vault contract address.

assetstring

Asset identifier (e.g. "usdc", "eth"). Only present when the token is known in the asset registry.

asset_addressstring required

Underlying asset token address.

decimalsinteger

Number of decimals for the underlying asset (e.g. 6 for USDC, 18 for ETH). Only present when the token is known in the asset registry.

amountstring

Human-readable decimal amount of asset deposited (e.g. "1.5"). Only present when the token is known in the asset registry.

raw_amountstring required

Base-unit amount of asset deposited (e.g. "1500000").

status'rejected' required

The status of the wallet action.

rejected_atstring required

ISO 8601 timestamp of when the wallet action was rejected.

Example payload

{
  "steps": [
    {
      "gas_credits_charged": {
        "value": "100.00",
        "currency": "usd"
      }
    }
  ]
}

Response

Return a 200 status to indicate that the webhook was received 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.