Skip to Content

Oracle Integration

This guide covers oracle integration for Lombard’s Bitcoin-backed assets, including Proof of Reserve feeds for LBTC and BTC.b.


Key Changes

  • LBTC is yield-bearing (since July 22). Its LBTC/BTC ratio reflects accrued yield
  • BTC.b is a yieldless, risk-free Bitcoin wrapper maintaining 1:1 parity
  • Both tokens use burn-and-mint bridging mechanisms requiring dual Proof of Reserve feeds

API Endpoints

EnvironmentEndpoint
Productionhttps://ledger-mainnet.lombard-fi.com:1317
Testnethttps://ledger-gastald.lombard-fi.com:1317

Step 1: BTC.b Solvency Ratio

Calculate reserves backing the protocol versus BTC represented on the ledger.

BTC.b PoR address list (Base): 0x9d77025Ff283cFd5fDAcA149DF0Db194b32807F1

See BTC.b Proof of Reserve Address List.

LBTC PoR address list (Base): 0xe7Ebc588F4EC9297d9867aD75a9b5D86848c8018

Important:

  • Any ratio value greater than 1.0 should be clipped to 1.0
  • Values below 1.0 require secondary verification and incident response procedures (potential DeFi liquidation impacts)

Step 2: LBTC Ratio

Two approaches:

  1. Calculate supply ratio — query LBTC supply and backing Bitcoin through dedicated API endpoints
  2. Direct ratio endpoint — query the ledger’s ratio endpoint directly

Interpretation:

  • Values above 1.0 mean the current LBTC/BTC rate is above 1
  • Values below 1.0 mean the current LBTC/BTC rate is below 1, and call for additional monitoring and alerts

Step 3: BTC.b Ratio

Calculate from either:

  1. Lombard Ledger and destination chain data
  2. Bitcoin network data combined with ledger information

Block Height Queries

Query specific block heights using the x-cosmos-block-height header:

GET /endpoint x-cosmos-block-height: 12345

Timestamp Resolution

For historical data, resolve timestamps via binary search on the Tendermint RPC:

Production RPC: https://mainnet-rpc.lombard-fi.com

Last updated on