> ## 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_ethereum

> Tables in tt-contracts.circle_v2_ethereum

## 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   | 10000      | 500        | 340        | 0x           | 21876192      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 0x75275aff2d01699d922f045b69ed291311209738 | 2025-02-18T22:18:23.000Z | 0x00000000000000000000000075275aff2d01699d922f045b69ed291311209738 | 0x087a2ffa45c8b44e9ae37dca7f5650a05c4e826ef3630499f3834f0aaad956f3 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 1                     | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 25020000   | 1          | 126        | 0x           | 22207276      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 0x67c86de709016d19aa2736fdfd8af23a6f2f8ff6 | 2025-04-06T03:45:59.000Z | 0x00000000000000000000000067c86de709016d19aa2736fdfd8af23a6f2f8ff6 | 0x6c2e77eea4b9a92a128cc1952c65de7e8939c2e10c92c223f39a0b0584350be1 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 11                    | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 958638444  | 958638443  | 223        | 0x           | 22210812      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 0x4b6ab9dcdcbb2326a3e0d4e08240ee832c132dd6 | 2025-04-06T15:37:59.000Z | 0x0000000000000000000000005614dc52d2b46cfdd33cdca239504d2ecf9094b8 | 0x8c9683862d6c070cdf15f0bd9853cc33b341de66e8d3913a003575a5a2e25fe5 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 6                     | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
</Accordion>

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

  ```sql theme={null}
  SELECT *
  FROM `tt-contracts.circle_v2_ethereum.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   | 53114108032 | 592        | 23379395      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 2025-09-17T01:04:23.000Z | 0                | 0x00000000000858efe9cbe894e3578e92e7955dad | 0x24ea9bdd31ae374cb81c2a39d5bb87f506fadcb4e0fc51b2cb3af541981fc820 |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 14685912314 | 582        | 23380008      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 2025-09-17T03:07:23.000Z | 0                | 0x00000000000858efe9cbe894e3578e92e7955dad | 0x086badc35b35a6116258fd6fa489aad868db0083d2c5ec53b7502f66e79ad81b |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 8174164118  | 256        | 23380294      | 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 | 2025-09-17T04:04:59.000Z | 0                | 0x00000000000858efe9cbe894e3578e92e7955dad | 0xa460d21122b7e328bf459c91082dad01fc38d81d90114056ebc3556cad1d388f |
</Accordion>

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

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

***