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

> Tables in tt-contracts.circle_v2_optimism

## 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   | 34518178   | 3452       | 157        | 0x00         | 141310104     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 0xd156ffb54871f4562744d6be5d6321b5bffca3b6 | 2025-09-18T18:09:45.000Z | 0x00000000000000000000000000003fcac5ecedca580ce31f57e92822d9f74747 | 0x82f7f3a9486f5347d68bd3498307bb266a7ff5839c5fcc44cfd1806e7ddaea87 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 3                     | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 99690000   | 9969       | 81         | 0x00         | 141293684     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 0xd156ffb54871f4562744d6be5d6321b5bffca3b6 | 2025-09-18T09:02:25.000Z | 0x000000000000000000000000006b59230a23e7cfc4e4b073bea2aaaa0270af9c | 0x12127c68b5e87e3b854dfff0a145f6654b70b8e570ea0b3501a7a33fe2dd2416 | 0x0000000000000000000000000000000000000000000000000000000000000000 | 1                     | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 99963160   | 9997       | 28         | 0x00         | 141305839     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 0xd156ffb54871f4562744d6be5d6321b5bffca3b6 | 2025-09-18T15:47:35.000Z | 0x00000000000000000000000000af6a7551e3db47b559528a593ee6ca657d846b | 0xca835cd54d70176408c3a4bd9a52c83fa8aaf08dfbe6f61f3241c248d41adb1c | 0x0000000000000000000000000000000000000000000000000000000000000000 | 7                     | 1000                     | 0x00000000000000000000000028b5a0e9c621a5badaa536219b3a228c8168cf5d |
</Accordion>

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

  ```sql theme={null}
  SELECT *
  FROM `tt-contracts.circle_v2_optimism.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   | 103330      | 2          | 138466490     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 2025-07-14T22:22:37.000Z | 0                | 0x73dedd2eef068137067027fa311ad09dc87963b8 | 0x1d6a6316990afc7cac2f6a3f11409aa5c11f69846d56de402c22ef04df41a0b9 |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 30000000000 | 47         | 138440183     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 2025-07-14T07:45:43.000Z | 0                | 0x9bc34ded927e0f336c5c81e15a900461a0608863 | 0xeb11239a89f8be026187c013dddbdf0e7262eb217c61d6ebd9f74c10b8bfdf0e |
  | 0x28b5a0e9c621a5badaa536219b3a228c8168cf5d | false   | 100397      | 19         | 138466450     | 0x0b2c639c533813f4aa9d7837caf62653d097ff85 | 2025-07-14T22:21:17.000Z | 0                | 0x46175e415b9709b588b6e6b0b5d6e8f770622d06 | 0x21b092d2032e2d150549363be8fafa5c815d0d91ade1d3c3d4741f09bba55a67 |
</Accordion>

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

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

***