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

# Deal Proposals 🌱

### Table Details

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

### 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                                                                                                                     |
| client\_address        | VARCHAR(16777216) | Resolved Filecoin address of the storage client                                                                                                                                       |
| market\_actor          | VARCHAR(16777216) | Address of the Filecoin storage market actor involved in this deal or transaction                                                                                                     |
| method\_num            | NUMBER(38,0)      | Numeric identifier of the actor method called by this message                                                                                                                         |
| params\_base64         | VARCHAR(16777216) | Base64-encoded raw bytes of the message parameters before decoding                                                                                                                    |
| gas\_used              | VARCHAR(16777216) | Actual number of gas units consumed by this transaction or trace.                                                                                                                     |
| deal\_index            | NUMBER(38,0)      | Position of this deal within the block's deal array                                                                                                                                   |
| params\_decoded        | VARIANT           | JSON-decoded message parameters for supported actor methods                                                                                                                           |
| \_error                | VARCHAR(16777216) | Internal error or exception recorded during data processing for this row. Null for successful rows. Used for debugging data pipeline issues.                                          |
| 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.                                                                                                                         |
