> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Decoded Events

The following events are decoded in the GoldRush Streaming API [Wallet Activity Stream](/api-reference/streaming-api/subscriptions/wallet-activity-stream):

* [Approve](#approve)
* [Bridge](#bridge)
* [Deposit](#deposit)
* [Hypercore Delegation Event](#hypercore-delegation-event)
* [Hypercore Deposit Event](#hypercore-deposit-event)
* [Hypercore Fill](#hypercore-fill)
* [Hypercore Funding Event](#hypercore-funding-event)
* [Hypercore Ledger Event](#hypercore-ledger-event)
* [Hypercore Withdrawal Event](#hypercore-withdrawal-event)
* [Swap](#swap)
* [Transfer](#transfer)
* [Withdraw](#withdraw)
* [Transaction Logs](#transaction-logs)
* [Error](#error)

## Approve

Decoded details for a token spending approval

<Tip>See [ApproveTransaction](/api-reference/streaming-api/types/approve-transaction) for full field details including nested objects.</Tip>

| Field               | Type                    | Description                              |
| ------------------- | ----------------------- | ---------------------------------------- |
| `amount`            | `string`                | Amount of tokens approved for spending   |
| `quote_usd`         | `float`                 | Total USD value of the approved amount   |
| `quote_rate_usd`    | `float`                 | USD price per token at time of approval  |
| `spender`           | `string`                | Address of the approved spender          |
| `contract_metadata` | `TokenContractMetadata` | Metadata for the approved token contract |

## Bridge

Decoded details for a cross-chain bridge transfer

<Tip>See [BridgeTransaction](/api-reference/streaming-api/types/bridge-transaction) for full field details including nested objects.</Tip>

| Field               | Type                    | Description                             |
| ------------------- | ----------------------- | --------------------------------------- |
| `amount`            | `string`                | Amount of tokens bridged                |
| `quote_usd`         | `float`                 | Total USD value of the bridged amount   |
| `quote_rate_usd`    | `float`                 | USD price per token at time of bridge   |
| `contract_metadata` | `TokenContractMetadata` | Metadata for the bridged token contract |
| `from`              | `string`                | Sender wallet address                   |
| `to`                | `string`                | Recipient wallet address                |

## Deposit

Decoded details for a token deposit or liquidity addition

<Tip>See [DepositTransaction](/api-reference/streaming-api/types/deposit-transaction) for full field details including nested objects.</Tip>

| Field               | Type                    | Description                               |
| ------------------- | ----------------------- | ----------------------------------------- |
| `amount`            | `string`                | Amount of tokens deposited                |
| `quote_usd`         | `float`                 | Total USD value of the deposited amount   |
| `quote_rate_usd`    | `float`                 | USD price per token at time of deposit    |
| `contract_metadata` | `TokenContractMetadata` | Metadata for the deposited token contract |
| `from`              | `string`                | Sender wallet address                     |
| `to`                | `string`                | Recipient or pool address                 |

## Hypercore Delegation Event

Decoded details for a Hypercore staking delegation or undelegation event

<Tip>See [HypercoreDelegationEvent](/api-reference/streaming-api/types/hypercore-delegation-event) for full field details including nested objects.</Tip>

| Field           | Type      | Description                                                  |
| --------------- | --------- | ------------------------------------------------------------ |
| `hash`          | `string`  | Transaction/event hash from the Hypercore L1                 |
| `time`          | `string`  | ISO-8601 timestamp of the delegation event                   |
| `is_undelegate` | `boolean` | Whether this is an undelegation (true) or delegation (false) |
| `amount`        | `string`  | Delegation amount                                            |
| `validator`     | `string`  | Validator address that received or lost the delegation       |

## Hypercore Deposit Event

Decoded details for a Hypercore cross-chain deposit from an external chain

<Tip>See [HypercoreDepositEvent](/api-reference/streaming-api/types/hypercore-deposit-event) for full field details including nested objects.</Tip>

| Field    | Type     | Description                                  |
| -------- | -------- | -------------------------------------------- |
| `hash`   | `string` | Transaction/event hash from the Hypercore L1 |
| `time`   | `string` | ISO-8601 timestamp of the deposit event      |
| `amount` | `string` | Deposit amount in USDC                       |

## Hypercore Fill

Decoded details for a Hypercore perpetuals trade fill

<Tip>See [HypercoreFillTransaction](/api-reference/streaming-api/types/hypercore-fill-transaction) for full field details including nested objects.</Tip>

| Field            | Type                   | Description                                                                  |
| ---------------- | ---------------------- | ---------------------------------------------------------------------------- |
| `liquidation`    | `HypercoreLiquidation` | Liquidation details, present only when this fill resulted from a liquidation |
| `twap_id`        | `string`               | TWAP order ID when this fill was part of a TWAP execution                    |
| `builder_fee`    | `string`               | Fee paid to the builder, if a builder was involved                           |
| `side`           | `string`               | Fill side: BUY, SELL, or UNSPECIFIED                                         |
| `cloid`          | `string`               | Client-supplied order ID for programmatic order tracking                     |
| `closed_pnl`     | `string`               | Realized PnL from the closed portion of the position                         |
| `fee`            | `string`               | Fee charged for this fill                                                    |
| `fee_token`      | `string`               | Token in which the fee was denominated                                       |
| `oid`            | `string`               | Order ID that originated this fill                                           |
| `dir`            | `string`               | Direction indicator for the position change                                  |
| `start_position` | `string`               | Position size before this fill executed                                      |
| `tid`            | `string`               | Unique trade ID assigned by the exchange                                     |
| `size`           | `string`               | Filled quantity                                                              |
| `price`          | `string`               | Execution price per unit                                                     |
| `builder`        | `string`               | Address of the builder that constructed this order                           |
| `time`           | `string`               | ISO-8601 timestamp of the fill                                               |
| `crossed`        | `boolean`              | Whether the order crossed the spread (true = taker, false = maker)           |
| `hash`           | `string`               | On-chain transaction hash                                                    |
| `coin`           | `string`               | Market/coin symbol (e.g. ETH, BTC)                                           |

## Hypercore Funding Event

Decoded details for a Hypercore funding rate payment between long and short holders

<Tip>See [HypercoreFundingEvent](/api-reference/streaming-api/types/hypercore-funding-event) for full field details including nested objects.</Tip>

| Field            | Type     | Description                                    |
| ---------------- | -------- | ---------------------------------------------- |
| `hash`           | `string` | Transaction/event hash from the Hypercore L1   |
| `time`           | `string` | ISO-8601 timestamp of the funding event        |
| `szi`            | `string` | Position size indicator at the time of funding |
| `funding_amount` | `string` | Funding payment amount in USDC                 |
| `coin`           | `string` | Market/coin symbol (e.g. ETH, BTC)             |
| `funding_rate`   | `string` | Funding rate applied for this settlement       |

## Hypercore Ledger Event

Decoded details for a Hypercore ledger update (withdraw, deposit, transfer, liquidation, etc.)

<Tip>See [HypercoreLedgerEvent](/api-reference/streaming-api/types/hypercore-ledger-event) for full field details including nested objects.</Tip>

| Field         | Type          | Description                                                                 |
| ------------- | ------------- | --------------------------------------------------------------------------- |
| `delta`       | `LedgerDelta` | Subtype-specific ledger delta payload                                       |
| `hash`        | `string`      | Transaction/event hash from the Hypercore L1                                |
| `ledger_type` | `string`      | Ledger subtype discriminator (e.g. withdraw, deposit, spot\_transfer, send) |
| `time`        | `string`      | ISO-8601 timestamp of the ledger event                                      |

## Hypercore Withdrawal Event

Decoded details for a finalized Hypercore cross-chain withdrawal

<Tip>See [HypercoreWithdrawalEvent](/api-reference/streaming-api/types/hypercore-withdrawal-event) for full field details including nested objects.</Tip>

| Field    | Type     | Description                                  |
| -------- | -------- | -------------------------------------------- |
| `hash`   | `string` | Transaction/event hash from the Hypercore L1 |
| `time`   | `string` | ISO-8601 timestamp of the withdrawal event   |
| `amount` | `string` | Withdrawal amount in USDC                    |

## Swap

Decoded details for a token swap on a decentralized exchange

<Tip>See [SwapTransaction](/api-reference/streaming-api/types/swap-transaction) for full field details including nested objects.</Tip>

| Field        | Type                    | Description                   |
| ------------ | ----------------------- | ----------------------------- |
| `amount_out` | `string`                | Amount of tokens received     |
| `amount_in`  | `string`                | Amount of tokens sold         |
| `token_out`  | `TokenContractMetadata` | Metadata for the token bought |
| `token_in`   | `TokenContractMetadata` | Metadata for the token sold   |

## Transfer

Decoded details for a token transfer between addresses

<Tip>See [TransferTransaction](/api-reference/streaming-api/types/transfer-transaction) for full field details including nested objects.</Tip>

| Field               | Type                    | Description                                 |
| ------------------- | ----------------------- | ------------------------------------------- |
| `amount`            | `string`                | Amount of tokens transferred                |
| `quote_usd`         | `float`                 | Total USD value of the transferred amount   |
| `quote_rate_usd`    | `float`                 | USD price per token at time of transfer     |
| `contract_metadata` | `TokenContractMetadata` | Metadata for the transferred token contract |
| `from`              | `string`                | Sender wallet address                       |
| `to`                | `string`                | Recipient wallet address                    |

## Withdraw

Decoded details for a token withdrawal or liquidity removal

<Tip>See [WithdrawTransaction](/api-reference/streaming-api/types/withdraw-transaction) for full field details including nested objects.</Tip>

| Field               | Type                    | Description                               |
| ------------------- | ----------------------- | ----------------------------------------- |
| `amount`            | `string`                | Amount of tokens withdrawn                |
| `quote_usd`         | `float`                 | Total USD value of the withdrawn amount   |
| `quote_rate_usd`    | `float`                 | USD price per token at time of withdrawal |
| `contract_metadata` | `TokenContractMetadata` | Metadata for the withdrawn token contract |
| `from`              | `string`                | Source pool or contract address           |
| `to`                | `string`                | Recipient wallet address                  |

## Transaction Logs

Event log emitted during a transaction

<Tip>See [TransactionLog](/api-reference/streaming-api/types/transaction-log) for full field details.</Tip>

| Field             | Type            | Description                                                      |
| ----------------- | --------------- | ---------------------------------------------------------------- |
| `data`            | `string`        | ABI-encoded log data                                             |
| `emitter_address` | `string`        | Address of the contract that emitted the log                     |
| `log_offset`      | `int`           | Position of the log within the transaction                       |
| `topics`          | `array<string>` | Indexed event parameters (topic\[0] is the event signature hash) |

## Error

Decoded details for an unrecognized or failed transaction

<Tip>See [ErrorDetails](/api-reference/streaming-api/types/error-details) for full field details.</Tip>

| Field     | Type     | Description                                  |
| --------- | -------- | -------------------------------------------- |
| `message` | `string` | Error or status message describing the issue |