How defillama/defillama-adapters works
DefiLlama Adapters is a collection of project-specific JavaScript adapters that calculate protocol TVL from blockchain data. The principal workflow is an adapter’s chain-specific TVL function gathering balances and positions, using shared helpers to query chain data and resolve LP positions, then returning balances for TVL reporting. The repository also has centralized-exchange adapters and shared support for multiple chains, Bitcoin address books, event logs, caching, and HTTP/GraphQL access. Several adapter and helper relationships below rely on the SOURCE INDEX or README; unsampled implementations are not described in detail.
Main entry points: cex.js CEX balances · solana.js Solana balances · unwrapLPs.js LP resolution · index.js Libre Capital TVL
Components 29
TVL adapters
- Protocol adapters
projects - Unifarm TVL
projects/unifarm/index.js - BasedBid TVL
projects/basedbid/index.js - Libre Capital TVL
projects/libre-capital/index.js
Exchange adapters
- Exchange project adapters
projects - CEX registry
cex/index.js - CEX balances
projects/helper/cex.js - Bitcoin address book
projects/helper/bitcoin-book/index.js
Balance accounting
- Token summation
projects/helper/sumTokens.js - LP resolution
projects/helper/unwrapLPs.js - Token mapping
projects/helper/tokenMapping.js - Ported tokens
projects/helper/portedTokens.js
Chain access
- Solana balances
projects/helper/solana.js - Aptos queries
projects/helper/chain/aptos.js - Cosmos queries
projects/helper/chain/cosmos.js - Sui queries
projects/helper/chain/sui.js - Cardano queries
projects/helper/chain/cardano/blockfrost.js - Bitcoin fetchers
projects/helper/bitcoin-book/fetchers.js - Allium queries
projects/helper/allium.js
Shared support
- Shared cache
projects/helper/cache.js - Event log retrieval
projects/helper/cache/getLogs.js - HTTP and GraphQL
projects/helper/http.js - Environment config
projects/helper/env.js - Chain utilities
projects/helper/utils.js - CEX token lookup
projects/helper/utils/cex.js - GraphQL cache utility
projects/helper/utils/graphql.js - Staking helpers
projects/helper/stakingHelper.js - NFT helpers
projects/helper/nft.js
Other components
- TVL runner
Connections 31
- TVL runner → Protocol adapters: runs adapter
README.md - Protocol adapters → Token summation: computes balances
projects/satoshi-protocol/index.js - Unifarm TVL → Token summation: sums tokens
projects/unifarm/index.js - BasedBid TVL → Solana balances: queries Solana
projects/basedbid/index.js - BasedBid TVL → LP resolution: resolves positions
projects/basedbid/index.js - Libre Capital TVL → Aptos queries: queries Aptos
projects/libre-capital/index.js - Libre Capital TVL → Cosmos queries: queries Cosmos
projects/libre-capital/index.js - Libre Capital TVL → Sui queries: queries Sui
projects/libre-capital/index.js - Libre Capital TVL → Cardano queries: queries Cardano
projects/libre-capital/index.js - Protocol adapters → Event log retrieval: reads events
projects/royco-v2/index.js - CEX registry → CEX balances: uses balances
cex/index.js - Exchange project adapters → CEX balances: uses balances
projects/gate-io/index.js - CEX balances → Token summation: sums tokens
projects/helper/cex.js - CEX balances → LP resolution: resolves LPs
projects/helper/cex.js - CEX balances → CEX token lookup: looks up tokens
projects/helper/cex.js - CEX balances → Bitcoin address book: uses address book
projects/helper/cex.js - Bitcoin address book → Bitcoin fetchers: loads fetchers
projects/helper/bitcoin-book/index.js - Event log retrieval → Shared cache: reads and writes
projects/helper/cache/getLogs.js - HTTP and GraphQL → Environment config: reads settings
projects/helper/http.js - Solana balances → Ported tokens: transforms balances
projects/helper/solana.js - Solana balances → Token mapping: normalizes tokens
projects/helper/solana.js - Solana balances → HTTP and GraphQL: makes requests
projects/helper/solana.js - Solana balances → Allium queries: queries history
projects/helper/solana.js - Chain utilities → HTTP and GraphQL: makes requests
projects/helper/utils.js - Chain utilities → Environment config: reads settings
projects/helper/utils.js - Chain utilities → Token summation: supports aggregation
- Shared cache → GraphQL cache utility: uses GraphQL cache
projects/helper/cache.js - Protocol adapters → Staking helpers: uses staking helpers
projects/gate-io/index.js - LP resolution → Ported tokens: transforms tokens
projects/helper/unwrapLPs.js - LP resolution → Token mapping: normalizes tokens
projects/helper/unwrapLPs.js - LP resolution → NFT helpers: uses NFT helpers
projects/helper/unwrapLPs.js