DefiLlama integration

[royalf00l]

DefiLlama Integration

Description

Implement DefiLlama integration for the Templar smart contract protocol to enable TVL (Total Value Locked) and other metrics reporting, as outlined in the DefiLlama project submission guide. Use an endpoint provided by pikespeak indexer for the adapter to fetch necessary data.

Tasks

1. Create an adapter for Templar following DefiLlama’s adapter requirements.
2. Integrate with the pikespeak indexer-provided endpoint to retrieve protocol data (e.g., TVL, balances).
3. Ensure the adapter exposes data in the format expected by DefiLlama (JSON structure with TVL by chain and other metrics).
4. Test the adapter locally to verify data accuracy and endpoint compatibility.
5. Submit the adapter to DefiLlama for review and inclusion.
6. Document the integration process and endpoint usage in the project’s README.

Requirements

• TVL (total deposits (collateral assets + borrow assets) - outstanding loans) calculated for each market and each chain as well as aggregate
• Protocol Description and links to website, github and twitter
• All metrics tracked in this example. In addition to TVL, we want to track Borrowed, Revenue, Fees, all developer metrics.
• Ensure the adapter is lightweight and optimized for indexer data retrieval.
• Handle errors gracefully (e.g., indexer downtime, invalid data).
• Follow DefiLlama’s security and data accuracy guidelines.

Acceptance Criteria

• Adapter successfully fetches and formats data from the indexer endpoint.
• Data is correctly reported to DefiLlama (verified via test submission).
• Integration is documented, and tests pass without errors.

References

• DefiLlama Submission Docs
• Indexer endpoint: https://pikespeak.ai/api/v1/templar/protocol-metrics

[royalf00l]

templar-api.pdf

Pikespeak Indexer API Endpoints:
https://pikespeak.ai/api/v1/templar/protocol-metrics
https://pikespeak.ai/api/v1/templar/tvl
http://pikespeak.ai/api/v1/templar/users/stats?period=monthly
https://pikespeak.ai/api/v1/templar/users/activity

[peer2f00l]

How will this endpoint be updated when we launch markets that are not under the templar-alpha.near account? Will it include those as well, or will it be a different endpoint?

[peer2f00l]

DefiLlama does not accept APIs. All of the data must be computed by the adapter script from data obtained directly from the blockchain. Luckily, we can follow the example of other NEAR-based projects. It might get a little bit hairy when we try to calculate the values of the NEP-245 Intents-based tokens, but it should be doable.

[royalf00l]

How will this endpoint be updated when we launch markets that are not under the templar-alpha.near account? Will it include those as well, or will it be a different endpoint?

It should include those other markets as well. We can work with pikespeak on making that happen

[joshuajbouw]

Related PR for DefiLlama: DefiLlama/DefiLlama-Adapters#15879