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

# Events List

## Bridge events

The following bridge events will be sent to your webhook servers.

The bridge events data structure is the same as the [Bridge Status endpoint](https://docs.rhino.fi/api-reference/history/bridge-status) excluding the `state` field, use the `_tag` for the event type.

* **BRIDGE\_PENDING** - sent when the bridge quote is committed
* **BRIDGE\_ACCEPTED** - sent when the deposit transaction was received and validated
* **BRIDGE\_EXECUTED** - sent when the bridge is completed and received on the destination chain
* **BRIDGE\_REFUNDED** - when a swap is involved, the bridge might get refunded if the token price moved too much since the quote was emitted
* **BRIDGE\_CANCELLED** - sent when a committed bridge is CANCELLED (note that that cancelled bridges can still be actioned if a matching deposit is detected on-chain, subsequent bridge events will be sent)

## Smart Deposit Addresses events

### **DEPOSIT\_ADDRESS\_CREATED**

When a new Smart Deposit Address is generated, the `DEPOSIT_ADDRESS_CREATED` event will be sent.

Event structure:

```
{
  _tag: "DEPOSIT_ADDRESS_CREATED",
  depositChain: string
  depositAddress: string
  destinationChain: string
  destinationAddress: string
  tokenOut?: string
  postBridgeData?: PostBridgeData
  addressNote?: string
}
```

### **BRIDGE\_\***

The same `BRIDGE_PENDING`, `BRIDGE_ACCEPTED` and `BRIDGE_EXECUTED` events as described above will be sent for Smart Deposit Addresses.

### **DEPOSIT\_ADDRESS\_BRIDGE\_REJECTED**

When a Smart Deposit Address bridge is rejected, the `DEPOSIT_ADDRESS_BRIDGE_REJECTED` event will be sent.

Event structure:

```
{
  _tag: "DEPOSIT_ADDRESS_BRIDGE_REJECTED",
  _id: string, // bridge ID
  tokenSymbol: string
  tokenAddress: string
  amount: string
  amountUsd: string
  amountWei: string
  sender: string // depositor address
  txHash: string // deposit transaction hash
  reason: string // reason why it was rejected, e.g "UNDER_MIN"
  createdAt: string
  depositAddress: { // associated deposit address parameters
    depositChain: string
    depositAddress: string
    destinationChain: string
    destinationAddress: string
  }
}
```

### **DEPOSIT\_ADDRESS\_BRIDGE\_DELAYED**

Sometimes some bridges can take a bit longer than usual, in this case the `DEPOSIT_ADDRESS_BRIDGE_DELAYED` event is sent.

Event structure:

```
{
  _tag: "DEPOSIT_ADDRESS_BRIDGE_DELAYED",
  _id: string, // bridge ID
  tokenSymbol: string
  tokenAddress: string
  amount: string
  amountUsd: string
  amountWei: string
  sender: string // depositor address
  txHash: string // deposit transaction hash
  originalErrorTag: string // reason why the bridge is delayed
  depositAddress: { // associated deposit address parameters
    depositChain: string
    depositAddress: string
    destinationChain: string
    destinationAddress: string
  }
}
```