Informational webhook events

This page lists every event you can subscribe to on your informational webhook. The sections follow the groups in the Events step of the dashboard: EVM transactions, Solana transactions, Wallet lifecycle, and Wallet actions. Every event shares the same envelope: data holds the event, metadata holds context about where it came from, and type names the event. Use type to route events in your handler.

Group	Dashboard label	`type`
EVM transactions	Wallet transactions	`EIP_155_TX_V1`
Solana transactions	Wallet transactions	`SOLANA_TX_V2`
Solana transactions	Token approvals	`SOLANA_APPROVE_V2`
Solana transactions	Token revocations	`SOLANA_REVOKE_V2`
Solana transactions	Delegated transfers	`SOLANA_DELEGATED_TRANSFER_V2`
Wallet lifecycle	Wallet created	`WALLET_GENERATE_V1`
Wallet lifecycle	Wallet backed up	`WALLET_BACKUP_V1`
Wallet lifecycle	Wallet recovered	`WALLET_RECOVER_V1`
Wallet actions	Wallet ejected	`WALLET_EJECT_V1`

EVM transactions

Wallet transactions (`EIP_155_TX_V1`)

Portal sends this event when an EVM address it watches for you sends or receives tokens, or approves or revokes a token spender. That covers:

Sending and receiving native tokens, such as ETH.
Sending and receiving ERC-20 tokens, such as USDC.
Sending and receiving NFTs.
Approving an ERC-20 spender, and revoking an approval by setting the allowance to 0.

Portal starts watching as soon as you subscribe, and includes every client you create afterwards. Each transaction produces two events for each watched address involved. The first arrives with confirmed: false as soon as the transaction is in a block. The second arrives with confirmed: true once the chain reaches the number of blocks in the table below. If a chain reorganization replaces the block, you can get the confirmed: false event without a confirmed: true one.

Chain	Chain ID	Blocks until confirmed
Ethereum	`eip155:1`	`12`
Ethereum Sepolia	`eip155:11155111`	`18`
Polygon	`eip155:137`	`100`
Polygon Amoy	`eip155:80002`	`100`
Arbitrum	`eip155:42161`	`18`
Arbitrum Sepolia	`eip155:421614`	`600`
Optimism	`eip155:10`	`500`
Optimism Sepolia	`eip155:11155420`	`600`
Base	`eip155:8453`	`100`
Base Sepolia	`eip155:84532`	`100`

data is an array with one item per transfer in the transaction:

Field	Type	Description
`from`	String	The address that sent the tokens, or the owner that approved a spender.
`to`	String	The address that received the tokens, or the approved spender.
`amount`	String	The amount, in token units. `0` when an approval is revoked.
`assetType`	String	`NATIVE_TOKEN`, `NON_NATIVE_TOKEN`, `NFT`, or `ERC20_APPROVAL`.
`chainId`	String	The CAIP-2 chain ID, such as `eip155:1`.
`chainName`	String or `null`	The chain name, such as `sepolia`.
`direction`	String	`OUTBOUND` if the watched address sent the tokens or approved the spender, `INBOUND` if it received them.
`tokenSymbol`	String	The token symbol, such as `ETH` or `USDC`.
`metadata.confirmed`	Boolean	Whether the transaction reached the confirmation depth for its chain.
`metadata.sentAt`	String	When the transaction was included in a block, in ISO 8601.
`metadata.transactionHash`	String or `null`	The transaction hash.
`metadata.userOperationHash`	String or `null`	The user operation hash for account abstraction wallets. `null` for regular transactions.
`metadata.blockNumber`	String or `null`	The block number.
`metadata.triggeredBy`	String or `null`	The watched address this event was sent for.
`metadata.tokenAddress`	String or `null`	The token contract. `null` for native tokens.
`metadata.tokenName`	String	The token name.
`metadata.tokenDecimals`	Number	The token’s decimals.
`metadata.rawAmount`	String	The amount in the token’s smallest unit.
`metadata.fee`	Object	The network fee: `amount`, `rawAmount`, `decimals`, and `tokenSymbol`.
`metadata.actualGasCost`	String or `null`	The gas cost of a user operation, as a hex Wei amount.
`metadata.formattedActualGasCost`	String or `null`	The same gas cost as a base-10 Wei string.
`metadata.approvalSpender`	String	The approved spender. Only present on `ERC20_APPROVAL` items.
`metadata.nftTokenId`	String or `null`	The token ID. Only set on `NFT` items.

The envelope’s metadata includes custodianId, environmentId, chainId, and confirmed. It can also include the raw block, logs, and transactions from Portal’s chain data provider in block, logs, txs, and retries. Don’t rely on their shape. actualGasCost and formattedActualGasCost are only set when the client’s transaction ran as an account abstraction user operation. With a gas policy on the chain, they show the gas you sponsored.

Unconfirmed event (confirmed: false):

{
  "data": [
    {
      "to": "0xab44dca8a4c606298d6be3e1b53115ed4785fe1d", // Your Portal wallet
      "from": "0x76acbd1eb20236f303d6f5fc3d50fe5f88caec3f",
      "amount": "0.01",
      "chainId": "eip155:11155111",
      "assetType": "NATIVE_TOKEN",
      "chainName": "sepolia",
      "direction": "INBOUND",
      "tokenSymbol": "ETH",
      "metadata": {
        "fee": {
          "amount": "0.001933021424187",
          "decimals": 18,
          "rawAmount": "1933021424187000",
          "tokenSymbol": "ETH"
        },
        "sentAt": "2025-02-05T14:44:00.000Z",
        "confirmed": false,
        "actualGasCost": null,
        "formattedActualGasCost": null,
        "rawAmount": "10000000000000000",
        "tokenName": "ETH",
        "nftTokenId": null,
        "blockNumber": "7645517",
        "triggeredBy": "0xab44dca8a4c606298d6be3e1b53115ed4785fe1d",
        "tokenAddress": null,
        "tokenDecimals": 18,
        "approvalSpender": null,
        "transactionHash": "0xd3e43c0c352d6d60e16115416ae9d1406394e149096d449a7c88068f923ada8a",
        "userOperationHash": null
      }
    }
  ],
  "metadata": {
    "custodianId": "custodianId",
    "environmentId": "environmentId"
  },
  "type": "EIP_155_TX_V1"
}