update trust lines
Some checks failed
docs_update / run_dbt_jobs (push) Has been cancelled
dbt_test_weekly / run_dbt_jobs (push) Has been cancelled
dbt_run_dev_refresh / run_dbt_jobs (push) Has been cancelled
dbt_test_monthly / run_dbt_jobs (push) Has been cancelled
dbt_run_observability_full / run_dbt_jobs (push) Has been cancelled

This commit is contained in:
Mike Stepanovic 2025-09-15 09:42:19 -06:00
parent 354de35312
commit 27596d3796

View File

@ -1,7 +1,9 @@
{% docs core__fact_trust_lines %}
Trustlines track authorized and deleted lines of trust between an account and assets. This table can be viewed as a subentry to an account because all trustlines must be associated with a single account. The trust line also tracks the balance of the asset held by the account and any buying or selling liabilities on the orderbook for a given account and asset. You do not have to hold a balance of an asset to trust the asset.
FACT_TRUST_LINES table captures trust relationship events and balance states at time of transaction activity on the Stellar network. Each record represents the trustline state (balance, limits, liabilities) for an account-asset pair as recorded when a transaction affecting that trustline occurred. NOTE: This is NOT a comprehensive daily snapshot of all account balances - it only contains records when trustlines are created, modified, or involved in transactions.
Learn more about Stellar trust lines: https://developers.stellar.org/docs/data/analytics/hubble/data-catalog/data-dictionary/trustlines
To reconstruct the current or historical balance state for analysis, you must identify the most recent record per account-asset pair using techniques like ROW_NUMBER() OVER (PARTITION BY account_id, asset_id ORDER BY ledger_sequence DESC). The table includes balance changes triggered by payments, trades, trustline modifications, and other operations, but accounts with no recent activity will not have recent records.
Key data points include ASSET_CODE, ASSET_ISSUER, BALANCE (at transaction time), TRUST_LINE_LIMIT, BUYING_LIABILITIES, and SELLING_LIABILITIES. The DELETED flag indicates trustline removal. This transactional approach means supply calculations require careful aggregation of the latest state per account to avoid double-counting and to account for inactive accounts not represented in recent data.
{% enddocs %}