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

# Traces 🌱

### Table Details

| Property            | Value                           |
| ------------------- | ------------------------------- |
| Table Name          | `filecoin.raw.traces`           |
| Table Status        | Beta 🌱                         |
| Unique Key          | `tipset_timestamp`, `unique_id` |
| Clustering Key(s)   | `to_date("tipset_timestamp")`   |
| Search Optimization | `unique_id`                     |

### Table Columns

| Column Name            | Data Type         | Description                                                                                                                                                                                                           |
| ---------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tipset\_height         | NUMBER(38,0)      | Filecoin tipset height (block height). A tipset is a set of blocks at the same height that form the canonical chain.                                                                                                  |
| tipset\_timestamp      | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the Filecoin tipset.                                                                                                                                                                               |
| message\_cid           | VARCHAR(16777216) | The CID of the message containing the transfer.                                                                                                                                                                       |
| message\_tipset\_index | NUMBER(38,0)      | Position of this message within its tipset's ordered message list                                                                                                                                                     |
| trace\_address         | VARCHAR(16777216) | Path of this trace within the call graph, as an array of indices. An empty array means the top-level transaction call. `[0]` means the first sub-call, `[0, 1]` means the second sub-call of the first sub-call, etc. |
| trace\_index           | NUMBER(38,0)      | Sequential index of this trace (internal call) within its parent transaction.                                                                                                                                         |
| from\_address          | VARCHAR(16777216) | Address that initiated or sent from in this event. For token transfers, the account whose balance decreased. For transactions, the transaction sender (msg.sender).                                                   |
| to\_address            | VARCHAR(16777216) | Address that received in this event. For token transfers, the account whose balance increased. For transactions, the destination address (may be a smart contract).                                                   |
| method                 | NUMBER(38,0)      | Human-readable name of the Filecoin actor method called by this message (alias for method\_name)                                                                                                                      |
| params                 | VARCHAR(16777216) | Raw parameters from the event                                                                                                                                                                                         |
| params\_codec          | NUMBER(38,0)      | IPLD codec identifier for the message parameters encoding (e.g., dag-cbor)                                                                                                                                            |
| value                  | VARCHAR(16777216) | Amount of native currency (e.g. ETH, MATIC) transferred with this transaction or trace, in the chain's smallest unit (Wei for EVM chains). Zero for calls that don't move native currency.                            |
| gas\_limit             | VARCHAR(16777216) | Maximum gas units allocated for the block. Transactions in a block cannot collectively exceed this limit.                                                                                                             |
| read\_only             | BOOLEAN           | True if this message was executed in read-only mode without state changes                                                                                                                                             |
| receipt\_exit\_code    | NUMBER(38,0)      | Exit code from the message receipt (0 = success, non-zero = failure with specific error type)                                                                                                                         |
| receipt\_return        | VARCHAR(16777216) | Base64-encoded return value from the message receipt                                                                                                                                                                  |
| receipt\_return\_codec | NUMBER(38,0)      | IPLD codec of the message receipt return value                                                                                                                                                                        |
| gas\_charges           | VARIANT           | Array of individual gas charge events during message execution                                                                                                                                                        |
| invoked\_actor         | VARIANT           | Actor address and code CID of the actor that was called by this Filecoin message                                                                                                                                      |
| ipld\_ops              | VARIANT           | Array of IPLD state tree read and write operations performed during message execution                                                                                                                                 |
| subtrace\_count        | NUMBER(38,0)      | Number of sub-calls (traces) spawned by this Starknet transaction.                                                                                                                                                    |
| unique\_id             | VARCHAR(16777216) | Allium's deterministic unique identifier for this row. Generated from the fields that uniquely identify the record (e.g. transaction hash + log index). Stable across full refreshes.                                 |
| \_created\_at          | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was created in the database.                                                                                                                                                              |
| \_updated\_at          | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was last updated in the database.                                                                                                                                                         |