updated docs with stellar official docs

This commit is contained in:
Mike Stepanovic 2025-03-18 13:53:20 -06:00
parent c93fce674c
commit 4ac72f0b37
18 changed files with 74 additions and 9 deletions

View File

@ -0,0 +1,7 @@
{% docs core__dim_assets %}
Table reports which assets are used during the batch interval, which can help identify periods of time of large activity for an asset. The table does not have a primary key and assets are duplicated in the table as they are used during different periods of time. To get a distinct count of assets on the network, please refer to the history_assets table. Table not widely used.
Learn more about Stellar assets: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/assets
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__ez_operations %}
An aggregated convenience table that joins `core.fact_operations`, `core.fact_transactions`, and `core.fact_ledgers`.
Learn more about Stellar data structures: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__fact_accounts %}
The accounts table stores detailed information for a given account, including current account status, preconditions for transaction authorization, security settings and account balance. The balance reported in the accounts table reflects the accounts XLM balance only. All other asset balances are reported in the 'trust_lines' table. Any changes to the account, whether it is an account settings change, balance increase/decrease or sponsorship change will result in an increase to the account sequence_number and last_modified_ledger. The sequence_number is incremented with each operation applied to an account so that order is preserved during account mutation.
Learn more about Stellar accounts: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/accounts
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__fact_contract_events %}
This table contains all contract events, diagnostic events, and system events. Events cover a wide variety of information including token value movement, core metrics, and logging/debugging information.
Learn more about Stellar smart contracts: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/contracts
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__fact_ledgers %}
Each ledger stores the state of the network at a given point in time and contains all changes applied to the network - transactions, operations, etc. This table summarizes the actions taken within a single ledger and is relevant in determining high level network conditions.
Learn more about Stellar ledgers: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/ledgers
{% enddocs %}

View File

@ -0,0 +1,8 @@
{% docs defi__fact_liquidity_pools %}
Stellar rolled out Automated Market Makers to its network in Nov 2021, which improves liquidity between asset pairs while incentivizing users to stake money in pools. Liquidity pools provide a simple, non-interactive way to trade large amounts of capital and enable high volumes of trading. Liquidity pools can be created between asset pairs and algorithmically controls the supply of the assets to give the best exchange rate while not requiring an orderbook in order to execute the trade. For each trade executed through a liquidity pool, the users with staked liquidity in the pool earn fees, which are distributed automatically to their accounts. Users can deposit and withdraw money in the pools; trades only execute via path payment operation.
Learn more about Stellar data concepts: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__fact_operations %}
This table contains the lowest granularity of data avaiable to the network. It contains all details regarding operations that were executed as part of a transaction set. Be careful - the table contains both failed and successful operations. The details record will return varying information about an operation according to the operation type.
Learn more about Stellar operations: https://developers.stellar.org/docs/learn/fundamentals/transactions/operations-and-transactions
{% enddocs %}

View File

@ -0,0 +1,8 @@
{% docs defi__fact_trades %}
This table reports trading activity that occurs in both the decentralized exchange and automated money markets. Trades fulfill one of four operations: manage buy offers, manage sell offers and path payments (strict send and receive). Trades can be executed either against the orderbook or a liquidity pool that contains both bid and ask asset pair. Trades can be either path payments or offers that are fully or partially fulfilled, which means that the trade can be split into segments. A full trade is compromised of all "order" numbers for a given history_operation_id.
Learn more about Stellar data concepts: https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures
{% enddocs %}

View File

@ -0,0 +1,7 @@
{% docs core__fact_transactions %}
Transactions are commands that modify the ledger state and consist of one or more operations. In terms of taxonomy, a ledger contains a transaction set of multiple transactions, and a transaction contains an operation set of one to many operations. Transactions that are sent to the Stellar Network either succeed completely or fail completely. There is no partial transaction execution. The table is an event log of all transactions submitted and committed to a transaction set within a ledger.
Learn more about Stellar transactions: https://developers.stellar.org/docs/learn/fundamentals/transactions/operations-and-transactions
{% enddocs %}

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__dim_assets
description: Dimension table containing information about assets on the network.
description: "{{ doc('core__dim_assets') }}"
tests:
- dbt_utils.unique_combination_of_columns:
combination_of_columns:

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__fact_accounts
description: Core fact table containing all Stellar account information and their current states
description: "{{ doc('core__fact_accounts') }}"
tests:
- dbt_utils.unique_combination_of_columns:
combination_of_columns:

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__fact_contract_events
description: Fact table containing contract event details from the Stellar network.
description: "{{ doc('core__fact_contract_events') }}"
columns:
- name: TRANSACTION_HASH

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__fact_ledgers
description: Fact table containing information about ledgers on the Stellar network.
description: "{{ doc('core__fact_ledgers') }}"
columns:
- name: SEQUENCE
description: '{{ doc("sequence") }}'

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__fact_operations
description: A comprehensive view of all operations executed on the Stellar network, including transaction details, operation types, and their outcomes.
description: "{{ doc('core__fact_operations') }}"
tests:
- dbt_utils.unique_combination_of_columns:
combination_of_columns:

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__fact_transactions
description: Fact table containing transaction details from the Stellar network.
description: "{{ doc('core__fact_transactions') }}"
columns:
- name: ID

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: defi__fact_liquidity_pools
description: Fact table containing liquidity pool data including pool details, asset pairs, and metrics.
description: "{{ doc('defi__fact_liquidity_pools') }}"
columns:

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: defi__fact_trades
description: A fact table containing trade execution details from both the decentralized exchange and liquidity pools.
description: "{{ doc('defi__fact_trades') }}"
columns:
- name: history_operation_id
description: '{{ doc("history_operation_id") }}'

View File

@ -2,7 +2,7 @@ version: 2
models:
- name: core__ez_operations
description: A comprehensive view combining operations with their associated transaction and ledger data.
description: "{{ doc('core__ez_operations') }}"
columns:
- name: OP_ID