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

# circle_v2_base

> Tables in tt-contracts.circle_v2_base

## Tables

### TokenMessenger\_DepositForBurn\_event

Circle Cross-Chain Transfer Protocol (CCTP) token burn event initiated by depositors requesting cross-chain USDC transfers. Records burn amounts, destination chain domains, recipient addresses, and fee parameters for attestation-based minting on target blockchains.

<Accordion title="Columns">
  | Column                         | Type        | Description                                                                                                                                                                                            |
  | ------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `block_timestamp`              | `TIMESTAMP` | Timestamp when the block was produced. UTC timezone, millisecond precision.                                                                                                                            |
  | `block_number`                 | `INT64`     | Sequential identifier for the block in which the event or transaction was recorded. Integer value indicating the block's position in the blockchain.                                                   |
  | `transaction_hash`             | `STRING`    | Unique identifier for the transaction. 66-character hex string including 0x prefix.                                                                                                                    |
  | `log_index`                    | `INT64`     | Position of the event within the block's transaction logs. Zero-indexed integer representing the sequential order of log emission.                                                                     |
  | `address`                      | `STRING`    | Contract address that emitted the event. Hex-encoded, 0x-prefixed, 42-character string.                                                                                                                |
  | `removed`                      | `BOOL`      | Boolean flag indicating whether the event log was removed from the blockchain due to a chain reorganization.                                                                                           |
  | `in_burnToken`                 | `STRING`    | Contract address of the token being burned in the cross-chain transfer operation. Hex-encoded, 0x-prefixed, 42-character string.                                                                       |
  | `in_amount`                    | `STRING`    | Input amount for the swap, transaction, or operation. Numeric string representation of token quantity in smallest denomination.                                                                        |
  | `in_depositor`                 | `STRING`    | Address of the user who initiated the deposit or cross-chain transfer. Hex-encoded, 0x-prefixed, 42-character string.                                                                                  |
  | `in_mintRecipient`             | `STRING`    | Address designated to receive the minted tokens on the destination chain. Hex-encoded string, zero-padded to 66 characters for cross-chain compatibility.                                              |
  | `in_destinationDomain`         | `STRING`    | Numeric identifier for the blockchain where tokens will be minted after the cross-chain transfer. Circle CCTP (Cross-Chain Transfer Protocol) domain identifier represented as a string.               |
  | `in_destinationTokenMessenger` | `STRING`    | Contract address of the TokenMessenger contract on the destination chain that will handle the minting operation. Hex-encoded string, zero-padded to 66 characters for cross-chain compatibility.       |
  | `in_destinationCaller`         | `STRING`    | Address authorized to call the mint function on the destination chain. Hex-encoded string, zero-padded to 66 characters, or zero address if no specific caller is designated.                          |
  | `in_maxFee`                    | `STRING`    | Maximum fee amount allowed for the cross-chain transfer operation. Numeric string representation of fee in smallest token denomination.                                                                |
  | `in_minFinalityThreshold`      | `STRING`    | Minimum number of block confirmations required on the source chain before the cross-chain transfer can be processed on the destination chain. Numeric string representation of the finality threshold. |
  | `in_hookData`                  | `STRING`    | Additional arbitrary data passed to hook contracts for custom logic execution. Hex-encoded byte string with 0x prefix.                                                                                 |
</Accordion>

<Accordion title="Sample Data">
  | address                                    | removed | in\_amount  | in\_maxFee | log\_index | in\_hookData | block\_number | in\_burnToken                              | in\_depositor                              | block\_timestamp         | in\_mintRecipient                                                  | transaction\_hash                                                  | in\_destinationCaller                                              | in\_destinationDomain | in\_minFinalityThreshold | in\_destinationTokenMessenger                                      |
  | ------------------------------------------ | ------- | ----------- | ---------- | ---------- | ------------ | ------------- | ------------------------------------------ | ------------------------------------------ | ------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------ | --------------------- | ------------------------ | ------------------------------------------------------------------ |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 1000000     | 0          | 430        | 0x           | 32303589      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 0x4c2c0f0bb2631b02ac9299c59690914ee7a200b8 | 2025-07-01T19:02:05.000Z | 0x0000000000000000000000004c2c0f0bb2631b02ac9299c59690914ee7a200b8 | 0xe24eb61d0c4051169b05dbc730d292997a3cb6773ec01a95c2c3846319747e24 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 14                    | 2000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 90000000000 | 0          | 411        | 0x           | 32281458      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 0xfe5443d3fe4e7c4086bc757044b38f2d6e1dab19 | 2025-07-01T06:44:23.000Z | 0x000000000000000000000000fe5443d3fe4e7c4086bc757044b38f2d6e1dab19 | 0xa6e35756acc77c4a3cadd0339a6dcdd9acac27ff5d20997c4b8d8fc05e64e222 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 14                    | 2000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 99997530591 | 0          | 434        | 0x           | 32277101      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 0xfe5443d3fe4e7c4086bc757044b38f2d6e1dab19 | 2025-07-01T04:19:09.000Z | 0x000000000000000000000000fe5443d3fe4e7c4086bc757044b38f2d6e1dab19 | 0xe7589ef247b01c3dfb6ac4779c1f12db30c1e94ed2700a905ef7c60e258c3de3 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 14                    | 2000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
</Accordion>

<Accordion title="Example Query">
  **Query with partition filter**

  ```sql theme={null}
  SELECT *
  FROM `tt-contracts.circle_v2_base.TokenMessenger_DepositForBurn_event`
  WHERE block_timestamp >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
  LIMIT 100
  ```
</Accordion>

***

### TokenMessenger\_MintAndWithdraw\_event

Circle Cross-Chain Transfer Protocol (CCTP) events recording successful token mints with simultaneous withdrawals to recipients. Captures the token address, mint amount, recipient address, and optional fees collected during cross-chain USDC transfers across supported blockchains.

<Accordion title="Columns">
  | Column             | Type        | Description                                                                                                                                               |
  | ------------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `block_timestamp`  | `TIMESTAMP` | Timestamp when the block was produced. UTC timezone, millisecond precision.                                                                               |
  | `block_number`     | `INT64`     | Sequential identifier for the block in which the event or transaction was recorded. Integer value indicating the block's position in the blockchain.      |
  | `transaction_hash` | `STRING`    | Unique identifier for the transaction. 66-character hex string including 0x prefix.                                                                       |
  | `log_index`        | `INT64`     | Position of the event within the block's transaction logs. Zero-indexed integer representing the sequential order of log emission.                        |
  | `address`          | `STRING`    | Contract address that emitted the event. Hex-encoded, 0x-prefixed, 42-character string.                                                                   |
  | `removed`          | `BOOL`      | Boolean flag indicating whether the event log was removed from the blockchain due to a chain reorganization.                                              |
  | `in_mintRecipient` | `STRING`    | Address designated to receive the minted tokens on the destination chain. Hex-encoded string, zero-padded to 66 characters for cross-chain compatibility. |
  | `in_amount`        | `STRING`    | Input amount for the swap, transaction, or operation. Numeric string representation of token quantity in smallest denomination.                           |
  | `in_mintToken`     | `STRING`    | Contract address of the token being minted. Hex-encoded, 0x-prefixed, 42-character string.                                                                |
  | `in_feeCollected`  | `STRING`    | Fee amount collected for the cross-chain token transfer operation. Numeric string representation in smallest token denomination.                          |
</Accordion>

<Accordion title="Sample Data">
  | address                                    | removed | in\_amount  | log\_index | block\_number | in\_mintToken                              | block\_timestamp         | in\_feeCollected | in\_mintRecipient                          | transaction\_hash                                                  |
  | ------------------------------------------ | ------- | ----------- | ---------- | ------------- | ------------------------------------------ | ------------------------ | ---------------- | ------------------------------------------ | ------------------------------------------------------------------ |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 99770000    | 588        | 28412892      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 2025-04-02T17:32:11.000Z | 0                | 0x5348e7df7625a0ca07545aa5ea4c600ad34ea6fc | 0xc9a181863bae96292c3226f9a2201460a812f46e1bd7eea404e731f756a44983 |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 10241167    | 250        | 28385129      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 2025-04-02T02:06:45.000Z | 0                | 0xc1062b7c5dc8e4b1df9f200fe360cdc0ed6e7741 | 0xed43444eb89838ae5608abc07596ae5a153b799fc07b4023d9a96d45041d041f |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 29999770000 | 391        | 28413066      | 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 | 2025-04-02T17:37:59.000Z | 0                | 0x5348e7df7625a0ca07545aa5ea4c600ad34ea6fc | 0xdb427e9bd2530826c5d9ecf442bfd3ba0d3a3e073653a8c600101050a2dc12b6 |
</Accordion>

<Accordion title="Example Query">
  **Query with partition filter**

  ```sql theme={null}
  SELECT *
  FROM `tt-contracts.circle_v2_base.TokenMessenger_MintAndWithdraw_event`
  WHERE block_timestamp >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
  LIMIT 100
  ```
</Accordion>

***
