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

# Morpho Vault Events Beta

### Table Details

| Property     | Value                                     |
| ------------ | ----------------------------------------- |
| Table Name   | `stable.lending.morpho_vault_events_beta` |
| Table Status | Production-Ready                          |
| Unique Key   | `transaction_hash`, `unique_id`           |

### Table Columns

| Column Name                | Data Type         | Description                                                                                                                                                                                                                                              |
| -------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| disclaimer                 | VARCHAR(87)       | Beta disclaimer noting that column names and coverage may change in the future.                                                                                                                                                                          |
| project                    | VARCHAR(16777216) | Business name of the protocol being used (e.g. `uniswap`, `aave`, `lido`, `paraswap`). Consistent across verticals — every table with a `project` column uses this field to identify the top-level protocol brand.                                       |
| protocol                   | VARCHAR(16777216) | Specific version or variant of the protocol (e.g. `uniswap_v3`, `aave_v2`, `stargate_v2`). Qualifies the `project` field with version information.                                                                                                       |
| lending\_event             | VARCHAR(16777216) | Category of lending event. One of: `deposits`, `withdrawals`, `borrows`, `repayments`, `liquidations`.                                                                                                                                                   |
| event\_name                | VARCHAR(16777216) | Name of the smart contract event that triggered this bridge record (e.g. `Deposit`, `Send`, `TransferInitiated`).                                                                                                                                        |
| vault\_name                | VARCHAR(16777216) | Name of the Morpho vault                                                                                                                                                                                                                                 |
| vault\_contract            | VARCHAR(16777216) | Address of the Morpho vault contract (meta\_morpho address).                                                                                                                                                                                             |
| market\_name               | VARCHAR(16777216) | Human-readable name of the market, pool, or venue (e.g. `ETH/USDC 0.3%` for a DEX pool, `USDC` for a lending market). Resolved from onchain registry data.                                                                                               |
| market\_id                 | VARCHAR(16777216) | Internal Allium identifier for a market. Consistent across chains and protocol versions for the same logical market.                                                                                                                                     |
| token\_address             | VARCHAR(16777216) | Contract address of the token. For EVM chains, native currency (e.g. ETH, MATIC) is represented as the zero address (0x0000000000000000000000000000000000000000). For Solana, this is the mint address.                                                  |
| token\_name                | VARCHAR(16777216) | Full name of the token (e.g. "USD Coin", "Wrapped Ether").                                                                                                                                                                                               |
| token\_symbol              | VARCHAR(16777216) | Ticker symbol of the token (e.g. "USDC", "WETH").                                                                                                                                                                                                        |
| amount                     | FLOAT             | Token amount normalized by the token's decimal precision (amount\_raw / 10^decimals). This is the human-readable value (e.g. 1.5 USDC rather than 1500000).                                                                                              |
| usd\_amount                | FLOAT             | USD value of the token amount at the time of the event, computed using the hourly USD exchange rate.                                                                                                                                                     |
| vault\_details             | VARIANT           | JSON object containing vault metadata (name, symbol, etc.).                                                                                                                                                                                              |
| market\_details            | OBJECT            | JSON object containing market metadata (id, loan\_token, collateral\_token, lltv, oracle, irm).                                                                                                                                                          |
| extra\_fields              | VARIANT           | JSON object containing additional fields from the onchain event that are not part of the standard schema (e.g. nonce, fee metadata, protocol-specific parameters).                                                                                       |
| transaction\_hash          | VARCHAR(16777216) | Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain.                                                                                                                                              |
| transaction\_index         | NUMBER(38,0)      | Zero-based position of the transaction within its block. The first transaction in a block has index 0.                                                                                                                                                   |
| transaction\_from\_address | VARCHAR(16777216) | Address of the externally-owned account (EOA) that signed and submitted the transaction. This is the wallet that paid gas, which may differ from the `from_address` of an individual token transfer if a contract is routing tokens on behalf of a user. |
| transaction\_to\_address   | VARCHAR(16777216) | Address the transaction was sent to (the top-level `to` field of the transaction). May be a router, aggregator, or bridge contract rather than the direct recipient of assets.                                                                           |
| log\_index                 | NUMBER(38,0)      | Zero-based position of this event log within its transaction. The first log emitted by a transaction has index 0.                                                                                                                                        |
| block\_number              | NUMBER(38,0)      | Sequential number of the block that contains this record. Starts at 0 (genesis block) and increments by 1 for each new block.                                                                                                                            |
| block\_timestamp           | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record.                                                                                                                                                                                                  |
| block\_hash                | VARCHAR(16777216) | Cryptographic hash of the block header that contains this record. Uniquely identifies a block.                                                                                                                                                           |
| 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.                                                                                                                                                                                            |

### Related Docs

* [EVM Lending Morpho Vault Events Beta](/historical-data/supported-blockchains/evm/core-schemas/lending/morpho-vault-events-beta)
