# Table of Contents

- [Lombard Makes Bitcoin Move Onchain | Lombard Docs](#lombard-makes-bitcoin-move-onchain-lombard-docs)
- [Learn Overview | Lombard Docs](#learn-overview-lombard-docs)
- [Products Overview | Lombard Docs](#products-overview-lombard-docs)
- [Infrastructure | Lombard Docs](#infrastructure-lombard-docs)
- [Yield | Lombard Docs](#yield-lombard-docs)
- [Assets | Lombard Docs](#assets-lombard-docs)
- [Consortium Members | Lombard Docs](#consortium-members-lombard-docs)
- [Lombard Security Model | Lombard Docs](#lombard-security-model-lombard-docs)
- [Bug Bounty Program | Lombard Docs](#bug-bounty-program-lombard-docs)
- [Protocol Architecture | Lombard Docs](#protocol-architecture-lombard-docs)
- [Transparency | Lombard Docs](#transparency-lombard-docs)
- [Audits | Lombard Docs](#audits-lombard-docs)
- [Risks | Lombard Docs](#risks-lombard-docs)
- [Bridging Architecture | Lombard Docs](#bridging-architecture-lombard-docs)
- [Oracles & Price Feeds | Lombard Docs](#oracles-price-feeds-lombard-docs)
- [Liquid Bitcoin Foundation | Lombard Docs](#liquid-bitcoin-foundation-lombard-docs)
- [Community | Lombard Docs](#community-lombard-docs)
- [Referral Program | Lombard Docs](#referral-program-lombard-docs)
- [Use Bitcoin Earn | Lombard Docs](#use-bitcoin-earn-lombard-docs)
- [Token Economics | Lombard Docs](#token-economics-lombard-docs)
- [Understanding Yield | Lombard Docs](#understanding-yield-lombard-docs)
- [Use LBTC | Lombard Docs](#use-lbtc-lombard-docs)
- [Access DeFi | Lombard Docs](#access-defi-lombard-docs)
- [Smart Contracts | Lombard Docs](#smart-contracts-lombard-docs)
- [Fees | Lombard Docs](#fees-lombard-docs)
- [FAQ | Lombard Docs](#faq-lombard-docs)
- [Kaito Yappers | Lombard Docs](#kaito-yappers-lombard-docs)
- [Use $BARD | Lombard Docs](#use-bard-lombard-docs)
- [Lux Rewards | Lombard Docs](#lux-rewards-lombard-docs)
- [How Integration Works | Lombard Docs](#how-integration-works-lombard-docs)
- [Introduction to Bitcoin Connect | Lombard Docs](#introduction-to-bitcoin-connect-lombard-docs)
- [Quickstart Guide | Lombard Docs](#quickstart-guide-lombard-docs)
- [The SDK Playground | Lombard Docs](#the-sdk-playground-lombard-docs)
- [The Lombard SDK | Lombard Docs](#the-lombard-sdk-lombard-docs)
- [Builder Support | Lombard Docs](#builder-support-lombard-docs)
- [Direct Integrations | Lombard Docs](#direct-integrations-lombard-docs)
- [Use BTC.b | Lombard Docs](#use-btc-b-lombard-docs)
- [$BARD FAQ | Lombard Docs](#-bard-faq-lombard-docs)
- [Troubleshooting | Lombard Docs](#troubleshooting-lombard-docs)
- [General FAQ | Lombard Docs](#general-faq-lombard-docs)
- [Privacy Policy | Lombard Docs](#privacy-policy-lombard-docs)
- [User Guides | Lombard Docs](#user-guides-lombard-docs)
- [LBTC FAQ | Lombard Docs](#lbtc-faq-lombard-docs)
- [LBTC GMP Mint Tracing | Lombard Docs](#lbtc-gmp-mint-tracing-lombard-docs)
- [Brand Assets | Lombard Docs](#brand-assets-lombard-docs)
- [UK Residents | Lombard Docs](#uk-residents-lombard-docs)
- [Non-EVM | Lombard Docs](#non-evm-lombard-docs)
- [BTC.b FAQ | Lombard Docs](#btc-b-faq-lombard-docs)
- [Data API | Lombard Docs](#data-api-lombard-docs)
- [BTC.b to LBTC and LBTC to BTC.b Swaps | Lombard Docs](#btc-b-to-lbtc-and-lbtc-to-btc-b-swaps-lombard-docs)
- [EVM | Lombard Docs](#evm-lombard-docs)
- [Bitcoin | Lombard Docs](#bitcoin-lombard-docs)
- [Testing and Sandbox | Lombard Docs](#testing-and-sandbox-lombard-docs)
- [Bridging | Lombard Docs](#bridging-lombard-docs)
- [Lombard SDK FAQ | Lombard Docs](#lombard-sdk-faq-lombard-docs)
- [How to Find Out Unstake Fee | Lombard Docs](#how-to-find-out-unstake-fee-lombard-docs)
- [Capabilities | Lombard Docs](#capabilities-lombard-docs)
- [GMP Redeem Tracing | Lombard Docs](#gmp-redeem-tracing-lombard-docs)
- [Concepts | Lombard Docs](#concepts-lombard-docs)
- [Oracle | Lombard Docs](#oracle-lombard-docs)
- [Events Reference | Lombard Docs](#events-reference-lombard-docs)
- [Start here | Lombard Docs](#start-here-lombard-docs)
- [Referral System | Lombard Docs](#referral-system-lombard-docs)
- [Fee authorization | Lombard Docs](#fee-authorization-lombard-docs)
- [Error handling | Lombard Docs](#error-handling-lombard-docs)
- [Reference | Lombard Docs](#reference-lombard-docs)
- [Error Codes | Lombard Docs](#error-codes-lombard-docs)
- [API Methods | Lombard Docs](#api-methods-lombard-docs)
- [TypeScript Types | Lombard Docs](#typescript-types-lombard-docs)
- [Terms of Service | Lombard Docs](#terms-of-service-lombard-docs)
- [Configure PartnerID | Lombard Docs](#configure-partnerid-lombard-docs)
- [Event handling | Lombard Docs](#event-handling-lombard-docs)
- [Connect wallets | Lombard Docs](#connect-wallets-lombard-docs)
- [BTC deposit addresses | Lombard Docs](#btc-deposit-addresses-lombard-docs)
- [Action lifecycle | Lombard Docs](#action-lifecycle-lombard-docs)
- [$BARD Token Airdrop Terms and Conditions | Lombard Docs](#-bard-token-airdrop-terms-and-conditions-lombard-docs)

---

# Lombard Makes Bitcoin Move Onchain | Lombard Docs

![Page cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2Fl7wTwC5uXA2Yk5tvZMBg%2Fblobs%2FXSPwcAI4auWf8XPmlw2b%2FTwitter%2520%289%29.png&width=1248&dpr=3&quality=100&sign=7025b048&sv=2)

We build infrastructure that transforms Bitcoin from an idle store of value into productive onchain capital.

### 

[hashtag](https://docs.lombard.finance/#building-bitcoins-onchain-future)

Building Bitcoin's Onchain Future

Lombard provides institutional-grade infrastructure that makes Bitcoin function as capital across the digital economy.

**Our product suite:**

*   **LBTC**: The market leading yield-bearing Bitcoin asset
    
*   **BTC.b**: A permissionless, non-custodial Bitcoin asset built on transparent, verifiable protocol architecture
    
*   **Lombard SDK**: Provides Bitcoin connectivity for major exchanges, custodians and wallets
    

These products deliver the liquid assets, security, bridging infrastructure, and user abstractions that make onchain Bitcoin accessible to holders, protocols, and platforms.

### 

[hashtag](https://docs.lombard.finance/#launched-in-2024-delivering-results-since-day-1)

Launched in 2024, Delivering Results Since Day 1

**Market Traction:**

*   50%+ market share in Bitcoin yield-bearing tokens
    
*   $3B+ in previously idle BTC onboarded to onchain finance
    
*   Fastest-growing yield-bearing token in crypto history: $1B LBTC TVL in 92 days
    

**Ecosystem Adoption:**

*   Lombard SDK integrated by Binance, Bybit, and Ledger Wallet
    
*   Trusted by leading protocols, exchanges, and liquidity providers
    
*   First-choice partner for new chains and leading protocols integrating Bitcoin
    
*   Sparked strategic Bitcoin integrations at Aave, Morpho, Maple, Pendle, EtherFi, and EigenLayer
    

**Product Performance:**

*   75%+ asset utilization: LBTC actively deployed across DeFi
    
*   $750M+ activated through vault strategies across new ecosystems
    
*   Zero security incidents or downtime
    

**Security & Infrastructure:**

*   Security Consortium includes OKX, Galaxy, DCG, Wintermute, Amber Group, Figment, P2P, Kiln, Kraken, Antpool, F2Pool
    
*   Scalable cross-chain infrastructure spanning 15+ blockchains supported by Chainlink CCIP
    
*   Institutional-grade security without institutional gatekeepers
    

**Industry Milestones:**

*   Completed the first live crypto asset acquisition: BTC.b from Ava Labs (October 2025)
    
*   $BARD Community Sale: 1,400% oversubscribed, $6.75M raised from 21,340 participants across 132 countries
    

And, we're just getting started.

### 

[hashtag](https://docs.lombard.finance/#were-on-a-mission-to-bring-bitcoin-to-life-onchain)

We're on a Mission to Bring Bitcoin to Life Onchain

Bitcoin inspired the onchain revolution; DeFi, stablecoins, tokenization. Yet Bitcoin itself has remained largely dormant.

We change this by building the infrastructure that allows Bitcoin to go further, do more, and multiply throughout onchain finance. We create the liquidity flywheels, distribution engines, and onboarding mechanisms that power industry-wide Bitcoin adoption.

Our vision: be the driving force for Bitcoin onchain, just as Circle and Tether were for stablecoins.

Bitcoin represents financial freedom and open, permissionless access. By proliferating Bitcoin as next-generation, non-sovereign, permissionless money, we grow the entire onchain economy.

### 

[hashtag](https://docs.lombard.finance/#built-by-industry-leaders-backed-by-industry-giants)

Built by Industry Leaders, Backed by Industry Giants

Lombard is built by leaders from Polychain, Coinbase, Ripple, Maple, and Argent, bringing expertise across crypto, finance, and engineering.

We're backed by Polychain, Franklin Templeton, YZi Labs (formerly Binance Labs), and leading DeFi protocols, institutions, and exchanges.

### 

[hashtag](https://docs.lombard.finance/#get-started)

Get Started

*   **App**: [https://www.lombard.finance/app/arrow-up-right](https://www.lombard.finance/app/)
    
*   **Website**: [www.lombard.financearrow-up-right](https://www.lombard.finance/)
    
*   **Blog**: [https://www.lombard.finance/blog/arrow-up-right](https://www.lombard.finance/blog/)
    
*   **Discord**: [https://discord.com/invite/2HG7G69twcarrow-up-right](https://discord.com/invite/2HG7G69twc)
    
*   **X (Twitter):** [https://x.com/Lombard\_Financearrow-up-right](https://x.com/Lombard_Finance)
    
*   **LinkedIn**: [https://www.linkedin.com/company/lombardfinance/arrow-up-right](https://www.linkedin.com/company/lombardfinance/)
    
*   **Dune Dashboard**: [https://dune.com/lombard\_protocol/lombardarrow-up-right](https://dune.com/lombard_protocol/lombard)
    

[NextLearn Overviewchevron-right](https://docs.lombard.finance/learn/learn-overview)

Last updated 1 month ago

---

# Learn Overview | Lombard Docs

[](https://docs.lombard.finance/learn/products-overview)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FLz2A4kb61tBgr23VuuLz%252Fvaults.png%3Falt%3Dmedia%26token%3Dafba0866-2923-4fd8-aab2-8a8df24639e0&width=752&dpr=3&quality=100&sign=e6bc8de8&sv=2)

**Products Overview**

LBTC for yield-bearing Bitcoin, BTC.b for simple 1:1 representation, and $BARD for governance. Learn what each does and when to use them.

[](https://docs.lombard.finance/learn/protocol-architecture)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FxzRza4Fv9j1k5J5WLM5x%252Fledger.png%3Falt%3Dmedia%26token%3D65f8152a-41aa-45ff-b26d-4cfffb07ccb7&width=752&dpr=3&quality=100&sign=ac98943f&sv=2)

**Protocol Architecture**

From deposit to mint, how the Security Consortium validates transactions, yield is generated, and our assets move across 15+ chains.

[](https://docs.lombard.finance/learn/lombard-security-model)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FjNUWUUs3BU6zHzg2W4xQ%252Fsecurity.png%3Falt%3Dmedia%26token%3D7cfef60b-b7ea-4333-893c-8ae467357020&width=752&dpr=3&quality=100&sign=74115ab4&sv=2)

**Lombard Security Model**

A 14-member consortium including OKX, Galaxy, and Kraken. Hardware-backed key management. Dual verification for every action.

[](https://docs.lombard.finance/learn/transparency)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FlWv2lnGmA3P2At1Zaqvc%252Ftransparency.png%3Falt%3Dmedia%26token%3Da910f51c-14b2-4af5-b7e1-88af5ceb7d8c&width=752&dpr=3&quality=100&sign=c1d46390&sv=2)

**Transparency**

Every asset is backed by native Bitcoin. Chainlink Proof of Reserve updates every 10 minutes. All transactions are fully traceable.

[](https://docs.lombard.finance/learn/token-economics)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252Fk1xk6m6y2nQtgweZCIo3%252Ftokenomics.png%3Falt%3Dmedia%26token%3D1c424bda-e718-4b8a-84d2-29aaac787466&width=752&dpr=3&quality=100&sign=7494b2fb&sv=2)

**Token Economics**

$BARD fixed supply of 1 billion. Distribution schedule, staking via Symbiotic, governance rights, and the Liquid Bitcoin Foundation.

[](https://docs.lombard.finance/learn/community)

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FG3yU2ozKrCXSsH9bbq62%252Fyield.png%3Falt%3Dmedia%26token%3D1c557aa8-3066-44e8-a4cf-99d9adfe4b9b&width=752&dpr=3&quality=100&sign=c2f2af73&sv=2)

**Community**

Earn Lux by deploying LBTC and BTC.b across DeFi protocols. Refer friends, discuss governance, and connect on Discord.

[PreviousLombard Makes Bitcoin Move Onchainchevron-left](https://docs.lombard.finance/)
[NextProducts Overviewchevron-right](https://docs.lombard.finance/learn/products-overview)

Last updated 12 days ago

---

# Products Overview | Lombard Docs

[hashtag](https://docs.lombard.finance/learn/products-overview#products-overview)

Products Overview


--------------------------------------------------------------------------------------------------------

Lombard provides the infrastructure for Bitcoin Capital Markets onchain. The protocol transforms idle BTC into productive, yield-earning capital that moves freely across blockchains while maintaining institutional-grade security through a consortium of leading digital asset firms.

Lombard's product suite addresses three core needs: representing Bitcoin onchain, earning yield on Bitcoin, and building applications with Bitcoin.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FuFTEM3WUWSq2rOO9vVij%252Fproducts%2520overview.png%3Falt%3Dmedia%26token%3D2089e616-eab7-4b22-80d3-8b7a4354b29f&width=768&dpr=3&quality=100&sign=fd510a85&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview#assets)

Assets

Lombard issues two Bitcoin-backed tokens, each designed for different use cases.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#lbtc-lombard-staked-bitcoin)

LBTC: Lombard Staked Bitcoin

LBTC is Lombard's flagship product: a yield-bearing Bitcoin token backed by BTC staked through the Babylon protocol. When you deposit BTC with Lombard, your Bitcoin is staked to secure Proof-of-Stake networks known as Bitcoin Secured Networks (BSNs). In return, you receive LBTC, a liquid token you can use across DeFi while your underlying BTC earns yield.

Unlike traditional staking where your assets are locked, LBTC gives you full liquidity. You can lend it, provide liquidity, use it as collateral, or bridge it to other chains, all while continuing to earn staking rewards.

LBTC uses a non-rebasing design. Rather than receiving additional tokens, the exchange rate between LBTC and BTC increases over time as yield accrues. Each LBTC becomes redeemable for progressively more BTC, making it straightforward to track your position's value.

→ [Learn more about LBTC](https://docs.lombard.finance/learn/products-overview/assets#how-lbtc-works)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#btc.b-bridged-bitcoin)

BTC.b: Bridged Bitcoin

BTC.b is a non-yield Bitcoin asset designed for users who need strict 1:1 BTC parity. Originally launched by Ava Labs, BTC.b was acquired by Lombard in October 2025 to provide a complementary product for different use cases.

Where LBTC is optimized for earning yield over time, BTC.b is optimized for speed and simplicity. The exchange rate is always exactly 1:1 with BTC, redemptions are faster, and there's no yield mechanism to consider. This makes BTC.b well-suited for trading, short-term collateral needs, and applications where predictable pricing matters more than yield.

Together, LBTC and BTC.b give users flexibility: hold LBTC for long-term yield accumulation, or use BTC.b when you need straightforward Bitcoin representation without the yield component.

→ [Learn more about BTC.b](https://docs.lombard.finance/learn/products-overview/assets#btcb---bitcoin-bridged)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#vault-shares)

Vault Shares

Lombard Vaults provide automated DeFi yield strategies for Bitcoin holders. Rather than manually deploying your Bitcoin across protocols, you deposit into a vault and receive share tokens representing your position. The vault handles strategy execution, rebalancing, and yield optimization.

Bitcoin Earn accepts multiple Bitcoin assets and deploys them across curated DeFi strategies. This allows holders to earn additional yield on top of LBTC's base staking rewards through lending, liquidity provision, and other DeFi opportunities.

→ [Learn more about Vault Shares](https://docs.lombard.finance/learn/products-overview#vault-shares)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview#infrastructure)

Infrastructure

Lombard's infrastructure layer provides the security, bridging, and developer tools that power the ecosystem.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#bitcoin-connect)

Bitcoin Connect

Bitcoin Connect is Lombard's builder platform for integrating Bitcoin functionality into applications. Connect provides the infrastructure for staking flows, redemptions, cross-chain transfers, and portfolio tracking.

The Lombard SDK is a complete, deployment-ready toolkit within Connect for launching onchain Bitcoin products and strategies.

[→ Build with Bitcoin Connect](https://docs.lombard.finance/build/introduction-to-bitcoin-connect)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#security-consortium)

Security Consortium

The Lombard Security Consortium is a network of institutional members operating the Lombard Ledger, a transparent verifiable blockchain. Every critical operation (deposits, mints, redemptions, and cross-chain transfers) requires cryptographic signatures from a supermajority of consortium members. This distributed trust model ensures no single party can compromise the protocol.

→ [Learn more about the Security Model](https://docs.lombard.finance/learn/lombard-security-model)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#cross-chain-infrastructure)

Cross-Chain Infrastructure

LBTC and BTC.b are natively available across multiple blockchains. Lombard uses industry-standard bridging infrastructure, custom built with Chainlink, to enable secure cross-chain transfers. The protocol implements dual verification where both the bridge validators and the Security Consortium must approve all transfers.

→ [Learn more about Bridging Architecture](https://docs.lombard.finance/learn/transparency/bridging-architecture)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview#yield)

Yield

Lombard unlocks yield opportunities for Bitcoin through native staking and DeFi integrations.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#bitcoin-staking)

Bitcoin Staking

Lombard stakes deposited BTC to secure Proof-of-Stake networks without bridging or wrapping. When you hold LBTC, your underlying Bitcoin is actively securing Bitcoin Secured Networks (BSNs). These networks pay for Bitcoin security in their native tokens, which are converted to BTC and reflected in LBTC's increasing exchange rate.

This is native Bitcoin yield, not lending, not liquidity mining, but genuine staking rewards from providing economic security to blockchain networks.

→ [Learn more about how yield works](https://docs.lombard.finance/learn/products-overview/yield)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#defi-integrations)

DeFi Integrations

LBTC is integrated across major DeFi protocols, enabling holders to compound yield through lending, liquidity provision, and restaking. You can supply LBTC to lending markets like Aave and Morpho, provide liquidity on DEXs like Uniswap and Curve, or explore yield strategies through aggregators like Pendle.

Because LBTC is an ERC-20 token available on multiple chains, it works seamlessly with existing DeFi infrastructure. The base staking yield continues to accrue regardless of how you deploy your LBTC.

→ [Explore DeFi opportunities](https://docs.lombard.finance/use/access-defi)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview#lux-rewards)

Lux Rewards

The Lux program rewards users for deploying LBTC and BTC.b across eligible DeFi protocols.

Participants earn Lux points based on their deployment activity, which convert to BARD token allocations at the end of each season.

Season 3 is live with three multiplier tiers: DEX Liquidity at 1x, Lending Collateral at 3x, and Bitcoin Earn/Lombard Strategies at 6x.

Eligible chains include Ethereum, Solana, Avalanche, MegaETH, and Base.

Passive holding of LBTC or BTC.b does not earn Lux.

→ [Learn more about Lux](https://docs.lombard.finance/learn/community/lux-rewards)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview#next-steps)

Next Steps

*   [**Assets**](https://docs.lombard.finance/learn/products-overview/assets)
     — Deep dive into LBTC, BTC.b, and Vault Shares
    
*   [**Infrastructure**](https://docs.lombard.finance/learn/products-overview/infrastructure)
     — Technical details on Bitcoin Connect and APIs
    
*   [**Yield**](https://docs.lombard.finance/learn/products-overview/yield#where-yield-comes-from)
     — Understanding Bitcoin staking and DeFi yield strategies
    
*   [**Protocol Architecture**](https://docs.lombard.finance/learn/protocol-architecture)
     — How Lombard's security model works end-to-end
    

[PreviousLearn Overviewchevron-left](https://docs.lombard.finance/learn/learn-overview)
[NextAssetschevron-right](https://docs.lombard.finance/learn/products-overview/assets)

Last updated 5 days ago

*   [Products Overview](https://docs.lombard.finance/learn/products-overview#products-overview)
    
*   [Assets](https://docs.lombard.finance/learn/products-overview#assets)
    
*   [Infrastructure](https://docs.lombard.finance/learn/products-overview#infrastructure)
    
*   [Yield](https://docs.lombard.finance/learn/products-overview#yield)
    
*   [Next Steps](https://docs.lombard.finance/learn/products-overview#next-steps)

---

# Infrastructure | Lombard Docs

Lombard's infrastructure layer provides the security, bridging, and developer tools that power the protocol. This page introduces each component. For technical deep dives, see the linked pages.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/infrastructure#security-consortium)

Security Consortium

The Security Consortium is a network of 15 institutional members who collectively authorize every critical operation in Lombard, including deposits, mints, redemptions, and cross-chain transfers.

The consortium operates the Lombard Ledger, a Cosmos-based appchain where members independently verify operations and sign authorizations. Every action requires supermajority (two-thirds) agreement. No single party, not even Lombard, can mint LBTC without legitimate Bitcoin deposits verified by the consortium.

Members include OKX, Galaxy, DCG, Kraken, Wintermute, Amber Group, Antpool, F2Pool, Figment, Kiln, P2P.org, Chorus One, Cubist, Informal Systems, and Nansen.

→ [How the Security Consortium works](https://docs.lombard.finance/learn/lombard-security-model)

→ [Protocol Architecture](https://docs.lombard.finance/learn/protocol-architecture)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/infrastructure#cross-chain-bridging)

Cross-Chain Bridging

LBTC and BTC.b are natively available across multiple blockchains including Ethereum, Base, Arbitrum, Optimism, BNB Chain, and others.

Lombard uses industry-standard bridges like Chainlink CCIP, LayerZero, and IBC. It also adds an extra security layer: dual verification. Every cross-chain transfer must be approved by both the bridge validators and the Security Consortium. An attacker would need to compromise both systems simultaneously.

→ [Bridging architecture](https://docs.lombard.finance/learn/transparency/bridging-architecture)

→ [How to bridge LBTC](https://docs.lombard.finance/use/bridging)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/infrastructure#oracles)

Oracles

Lombard provides on-chain data feeds for integrators and DeFi protocols that need reliable information about LBTC and BTC.b.

**Exchange rate feeds:** The current LBTC/BTC exchange rate, updated as yield accrues. Essential for protocols that need to price LBTC correctly.

**Proof of Reserve:** Real-time verification that LBTC and BTC.b are fully backed by Bitcoin. Chainlink Proof of Reserve feeds update every 10 minutes, allowing anyone to verify collateralization on-chain.

These feeds enable DeFi protocols to safely integrate LBTC as collateral, build accurate pricing into lending markets, and provide users with transparent reserve verification.

→ [Oracle feeds and addresses](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/infrastructure#bitcoin-connect)

Bitcoin Connect

Bitcoin Connect is Lombard's developer platform enabling developers to build with Bitcoin on any chain, protocol, or application. It is an evolving suite of developer tools including the Lombard SDK, APIs and Oracles that can be freely accessed to integrate Lombard's assets and infrastructure on any chain, protocol or application.

For more information, see the Build documentation.

→ [Bitcoin Connect](https://docs.lombard.finance/build/introduction-to-bitcoin-connect)

→ [SDK quickstart](https://docs.lombard.finance/build/the-lombard-sdk/quickstart-guide)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/infrastructure#next-steps)

Next Steps

*   [**Protocol Architecture**](https://docs.lombard.finance/learn/protocol-architecture)
     — Technical deep dive into the Lombard Ledger and Security Consortium
    
*   [**Security Model**](https://docs.lombard.finance/learn/lombard-security-model)
     — How Lombard protects user funds
    
*   [**Bridging**](https://docs.lombard.finance/use/bridging)
     — Cross-chain architecture and supported networks
    
*   [**Deployed Contracts**](https://docs.lombard.finance/learn/transparency/smart-contracts)
     — Contract addresses across all chains
    

[PreviousAssetschevron-left](https://docs.lombard.finance/learn/products-overview/assets)
[NextYieldchevron-right](https://docs.lombard.finance/learn/products-overview/yield)

Last updated 1 month ago

*   [Security Consortium](https://docs.lombard.finance/learn/products-overview/infrastructure#security-consortium)
    
*   [Cross-Chain Bridging](https://docs.lombard.finance/learn/products-overview/infrastructure#cross-chain-bridging)
    
*   [Oracles](https://docs.lombard.finance/learn/products-overview/infrastructure#oracles)
    
*   [Bitcoin Connect](https://docs.lombard.finance/learn/products-overview/infrastructure#bitcoin-connect)
    
*   [Next Steps](https://docs.lombard.finance/learn/products-overview/infrastructure#next-steps)

---

# Yield | Lombard Docs

LBTC generates yield by putting your Bitcoin to work securing other blockchains. Bitcoin Earn extends this further, deploying capital across diversified DeFi strategies for automated, Bitcoin-denominated returns. This page explains where yield comes from, how it reaches you, and how Bitcoin Earn puts it all on autopilot.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#where-yield-comes-from)

Where Yield Comes From

LBTC yield comes from Bitcoin staking through the Babylon protocol. When you hold LBTC, your underlying Bitcoin is actively securing Proof-of-Stake networks called Bitcoin Secured Networks (BSNs).

Here's how it works:

**Bitcoin provides security.** BSNs are blockchains that use Bitcoin as their economic security layer. Instead of relying solely on their native token for Proof-of-Stake security, they tap into Bitcoin's massive capital base. This makes them significantly harder to attack.

**BSNs pay for that security.** Networks want Bitcoin security because it's valuable. They pay for it in their native tokens, similar to how Ethereum validators earn ETH for securing Ethereum.

**Rewards flow back to stakers.** Those payments are converted to BTC and distributed to everyone who staked Bitcoin through Babylon. For LBTC holders, this means the value backing your tokens increases over time.

This is native Bitcoin yield, not from lending, not from liquidity mining, but from providing genuine economic security to blockchain networks.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#how-yield-reaches-you)

How Yield Reaches You

LBTC uses a non-rebasing model. Your token balance stays the same, but each token becomes worth more BTC over time.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FnZqYqfVEVHDKBNwUHw57%252Fyield%2520diagram.png%3Falt%3Dmedia%26token%3D0f9d2554-5194-4a30-a83f-8c122965b6a9&width=768&dpr=3&quality=100&sign=e0556187&sv=2)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#the-exchange-rate)

The Exchange Rate

When LBTC launched, the exchange rate was 1:1. One LBTC was redeemable for exactly one BTC. As staking rewards accumulate, that rate gradually increases.

If you minted 10 LBTC when the rate was 1.0, you deposited 10 BTC. A year later, if the rate is 1.01, your 10 LBTC is now redeemable for 10.1 BTC. You earned 0.1 BTC in yield without doing anything.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#why-non-rebasing)

Why Non-Rebasing?

The alternative is rebasing, where you'd receive additional tokens as yield accrues. Non-rebasing has practical advantages:

**Simpler accounting.** Your balance never changes unexpectedly. If you hold 10 LBTC, you always hold 10 LBTC.

**Better DeFi compatibility.** Many DeFi protocols don't handle rebasing tokens well. Non-rebasing LBTC works seamlessly with lending protocols, DEXs, and other applications.

**Automatic compounding.** Yield is continuously reinvested into the exchange rate. No claiming, no restaking, no gas fees.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#yield-distribution)

Yield Distribution

Yield doesn't distribute at fixed intervals. Instead, the exchange rate updates continuously as rewards from BSNs accumulate in the protocol. The rate you see reflects all accumulated yield up to that moment.

→ [Current exchange ratearrow-up-right](https://www.lombard.finance/app/unstake)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#the-yield-stack)

The Yield Stack

Beyond base staking yield, you can earn additional returns by deploying LBTC across DeFi, or let Bitcoin Earn handle it automatically. This creates yield stacking: multiple yield sources compounding together.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#base-layer-babylon-staking)

Base Layer: Babylon Staking

Every LBTC holder earns this automatically. Your underlying BTC is staked through Babylon, securing BSNs and generating yield. No action required. Just hold LBTC.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#defi-layer-additional-yield)

DeFi Layer: Additional Yield

You can deploy your LBTC across DeFi to earn on top of base staking yield:

**Lending:** Supply LBTC to Aave, Morpho, or other lending protocols. Earn interest from borrowers while your LBTC continues appreciating from staking yield.

**Liquidity provision:** Add LBTC to DEX pools on Uniswap, Curve, or others. Earn trading fees plus any liquidity mining rewards. The base staking yield helps offset impermanent loss.

**Vaults:** Deposit into Bitcoin Earn for automated yield strategies across multiple protocols.

**Restaking:** Deposit LBTC into restaking protocols like EigenLayer or Symbiotic to earn additional rewards from securing more networks.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#incentive-layer-points-and-rewards)

Incentive Layer: Points and Rewards

Many protocols offer additional incentives for LBTC deposits:

**Lux rewards:** Lombard's points program rewards holding and deploying LBTC with BARD token allocations.

**Protocol incentives:** DeFi protocols often incentivize LBTC liquidity with their native tokens or points programs.

These incentives can significantly boost total returns, though they vary by protocol and change over time.

→ [Explore DeFi opportunities](https://docs.lombard.finance/use/access-defi)

→ [Lux rewards program](https://docs.lombard.finance/learn/community/lux-rewards)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#bitcoin-earn)

Bitcoin Earn

Bitcoin Earn is Lombard's automated yield product. It deploys Bitcoin across a diversified portfolio of strategies through a single deposit, generating competitive Bitcoin-denominated returns across market conditions.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#the-meta-vault-structure)

The Meta-Vault Structure

Most Bitcoin yield products make a single bet. They pick a strategy, deploy capital into it, and expose users to whatever happens when market conditions shift. When the strategy works, returns look strong. When it stops working, there is no fallback.

Bitcoin Earn is built differently, acting as a structured meta-vault. Instead of routing capital into a single strategy or a single manager spreading their focus across multiple strategies, it distributes exposure across a set of sub-vaults dedicated to independent managers, each operating in a specific niche of the yield market.

Each sub-vault operates in isolation, with its own logic, risk profile, and return drivers. The allocation layer sits above all of this. Capital flows toward managers based on verified performance under current conditions, not static weightings or predetermined splits. When basis trading delivers strong, risk-adjusted returns during a liquidity expansion cycle, it attracts more allocation. When stablecoin cross-lending arbitrage spreads widen, that niche gets prioritized. The vault continuously rebalances across regimes rather than waiting for a single strategy to recover.

This is what generates more consistent returns over time: the ability to stay productive across different market states rather than being locked into one.

The risk management properties follow from the same structure. Smart contract exposure is distributed. Manager-specific failures are contained within their allocation sizes and cannot affect others. The overall portfolio is never fully dependent on the health of any single protocol or the judgment of any single manager.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#how-it-works)

How It Works

Deposit LBTC, BTC.b, or native Bitcoin. You receive BTCe, a receipt token representing your position in the vault.

Once deposited, your assets are deployed into leading lending and liquidity protocols. The vault actively rebalances to optimize risk-adjusted returns, and all yields are continuously converted back to Bitcoin and automatically compounded. No action required on your end.

You can request a withdrawal anytime. You receive your Bitcoin-backed tokens plus accumulated yield, typically within 14 days.

[→ How to use Bitcoin Earn](https://docs.lombard.finance/use/use-bitcoin-earn)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#strategies)

Strategies

Bitcoin Earn allocates deposits across a diversified mix of onchain strategies: single-sided Bitcoin opportunities (lending, staking, and yield-bearing BTC positions across Aave, Spark, Morpho, and other established protocols), market-neutral strategies (using BTC as collateral to capture funding rates and arbitrage opportunities across lending venues), and select incentive programs (carefully vetted public and private campaigns offering additional returns).

Allocations are actively rebalanced based on performance and market conditions, with strict limits on liquidity, duration, and concentration to any single protocol. All yields are continuously converted back to BTC and automatically compounded, ensuring returns stay denominated in Bitcoin.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#transparency)

Transparency

You can track your position, yields, and strategy allocations in real time. Before depositing, a rewards calculator lets you estimate potential returns over any time period in BTC terms. Once deposited, a live dashboard shows your current APY, total position value, and accumulated earnings. You can also see exactly where your Bitcoin is deployed and how the portfolio is diversified across strategies.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#sentora-and-veda)

Sentora and Veda

At launch, Bitcoin Earn pilots with Sentora as the first manager. Sentora is an institutional, non-custodial DeFi platform that manages billions in capital across DeFi markets, providing vault curation and advanced risk management.

The infrastructure is built on Veda's institutional-grade technology. It also powers Kraken's DeFi Earn. It brings yield opportunities to hundreds of thousands of users worldwide.

Over time, Bitcoin Earn will onboard additional risk managers to operate vaults within the meta-vault structure, providing greater diversification and access to unique strategies.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#track-record)

Track Record

Lombard's Vaults, the foundation powering Bitcoin Earn, have been operational since September 2024, attracting over $1 billion in cumulative deposits across various market conditions. This 18-month operational history demonstrates experience navigating both favorable and challenging DeFi environments.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#structure-and-terms)

Structure and Terms

Bitcoin Earn accepts LBTC, BTC.b, or native Bitcoin. You receive BTCe as a receipt token for your vault position. The meta-vault allocates to multiple specialized sub-vaults with dedicated professional managers, the first vault is operated by Sentora, with additional managers onboarding over time. Infrastructure is provided by Veda. Withdrawals process within 14 days. The management fee is 0.5%.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#other-vaults)

Other Vaults

Beyond Bitcoin Earn, Lombard Vaults provide additional automated yield strategies with independent risk profiles and managers. Each vault issues its own share tokens representing your proportional ownership of the vault's assets. As a vault earns yield, the value of each share increases. When you withdraw, you burn your shares and receive your proportional claim on the vault's assets, including accumulated yield.

[→ Explore available vaultsarrow-up-right](https://www.lombard.finance/app/vaults/)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#yield-considerations)

Yield Considerations

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#what-affects-yield)

What Affects Yield

**BSN demand:** More networks wanting Bitcoin security means more rewards for stakers. As the BSN ecosystem grows, yield potential increases.

**Total staked BTC:** Yield is distributed across all staked Bitcoin. More competition means lower yield per BTC, though this is balanced by growing BSN demand.

**Finality Provider performance:** Lombard delegates to institutional Finality Providers (Figment, Galaxy, Kiln, P2P.org) who take an 8% commission on rewards. Their uptime and performance affects your yield.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#yield-vs-risk)

Yield vs Risk

Higher yield opportunities generally come with additional risk. Base staking is the lowest risk within the LBTC ecosystem, subject to slashing risk (0.1%) and smart contract risk, but no additional DeFi exposure. Manually deploying into DeFi adds smart contract risk from each protocol, plus counterparty risk on lending and impermanent loss on liquidity provision. Bitcoin Earn distributes risk across sub-vaults and managers, but you are still exposed to the aggregate smart contract and market risks of every protocol the vault uses.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/yield#next-steps)

Next Steps

*   [Bitcoin Earn](https://docs.lombard.finance/use/use-bitcoin-earn)
     — Automated yield strategies
    
*   [**Lux Rewards**](https://docs.lombard.finance/learn/community/lux-rewards)
     — Earn BARD tokens for holding LBTC
    

[PreviousInfrastructurechevron-left](https://docs.lombard.finance/learn/products-overview/infrastructure)
[NextProtocol Architecturechevron-right](https://docs.lombard.finance/learn/protocol-architecture)

Last updated 1 day ago

*   [Where Yield Comes From](https://docs.lombard.finance/learn/products-overview/yield#where-yield-comes-from)
    
*   [How Yield Reaches You](https://docs.lombard.finance/learn/products-overview/yield#how-yield-reaches-you)
    
*   [The Yield Stack](https://docs.lombard.finance/learn/products-overview/yield#the-yield-stack)
    
*   [Bitcoin Earn](https://docs.lombard.finance/learn/products-overview/yield#bitcoin-earn)
    
*   [Other Vaults](https://docs.lombard.finance/learn/products-overview/yield#other-vaults)
    
*   [Yield Considerations](https://docs.lombard.finance/learn/products-overview/yield#yield-considerations)
    
*   [Next Steps](https://docs.lombard.finance/learn/products-overview/yield#next-steps)

---

# Assets | Lombard Docs

Lombard issues Bitcoin-backed tokens that make BTC usable across DeFi. Each asset serves a different purpose: LBTC for yield-bearing liquidity, BTC.b for simple 1:1 Bitcoin representation, and vaultsShares for automated yield strategies.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#lbtc-lombard-staked-bitcoin)

LBTC - Lombard Staked Bitcoin

LBTC is Lombard's flagship asset: a yield-bearing token backed by Bitcoin staked through the Babylon protocol.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#how-lbtc-works)

How LBTC Works

When you deposit BTC with Lombard, your Bitcoin doesn't sit idle in a wallet. It's staked through Babylon to secure Proof-of-Stake networks called Bitcoin Secured Networks (BSNs). These networks pay for the security Bitcoin provides, and that payment flows back to LBTC holders as yield.

In return for your deposit, you receive LBTC, a liquid token representing your staked position. While your underlying BTC is working to secure networks, your LBTC is free to use however you want: trade it, lend it, provide liquidity, use it as collateral, or bridge it to other chains.

This is the core value proposition of liquid staking. Traditional staking forces you to choose between earning yield and having liquidity. LBTC gives you both.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#how-staking-works)

How Staking Works

Babylon is the first protocol enabling Bitcoin to secure other blockchains without bridging, wrapping, or giving up custody. Your BTC never leaves the Bitcoin network, it's locked in a special Taproot output (a type of Bitcoin transaction) using Babylon's staking script.

This locked Bitcoin has two spending conditions. First, a timelock that allows you to withdraw after a set period. Second, an EOTS (Extractable One-Time Signature) mechanism that enables slashing if validators misbehave. This cryptographic design means your Bitcoin can provide economic security to other networks while remaining on Bitcoin's base layer.

When you stake through Lombard, your BTC is delegated to Finality Providers, specialized validators that sign blocks on Bitcoin Secured Networks. Lombard works with institutional Finality Providers including Figment, Galaxy, Kiln, and P2P.org. These providers earn a commission on staking rewards (currently 8%) and share the remaining yield with delegators like you.

The Security Consortium manages the staking operations. When LBTC supply increases from new deposits, additional BTC is staked. When supply decreases from redemptions, BTC is unstaked. This happens through a daily rebalancing process that maintains the backing ratio.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#the-exchange-rate)

The Exchange Rate

LBTC uses a non-rebasing model. This means you won't see additional LBTC tokens appear in your wallet as yield accrues. Instead, the exchange rate between LBTC and BTC increases over time.

When LBTC launched, the exchange rate was 1:1. One LBTC was redeemable for exactly one BTC. As yield accrues from Babylon staking, that rate gradually increases. If the rate is 1.05, each LBTC is now redeemable for 1.05 BTC.

This design has practical benefits. Your LBTC balance stays constant, making it easier to track positions and use in DeFi protocols. The yield is automatically compounded into the exchange rate rather than distributed as separate tokens you'd need to claim or restake.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#minting-lbtc)

Minting LBTC

You can mint LBTC by depositing native BTC through Lombard's interface. The process works as follows:

1.  You send BTC to a deposit address generated specifically for your wallet
    
2.  After Bitcoin network confirmations, the Security Consortium verifies and notarizes your deposit
    
3.  LBTC mints to your specified address on your chosen destination chain
    

The entire process is trustless from your perspective. The Security Consortium operates as a distributed validator set. No single member can mint LBTC without supermajority agreement. The consortium cannot mint LBTC without corresponding BTC deposits verified on the Bitcoin network.

→ [How to stake BTC and receive LBTC](https://docs.lombard.finance/use/use-lbtc#stake-btc)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#redeeming-lbtc)

Redeeming LBTC

Redemption returns your underlying BTC. When you redeem, your LBTC is burned, the corresponding BTC is unstaked from Babylon, and native BTC is sent to your Bitcoin address.

The unstaking process takes time because the underlying BTC must be unbonded from the Babylon protocol. Expect redemptions to complete within 7-14 days depending on Babylon's unbonding period and network conditions.

You'll receive BTC according to the current exchange rate. If you minted when the rate was 1:1 and redeem when it's 1.05, you receive 5% more BTC than you originally deposited.

→ [How to unstake LBTC](https://docs.lombard.finance/use/use-lbtc#unstake-lbtc)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#where-to-use-lbtc)

Where to Use LBTC

LBTC is an ERC-20 token available on multiple chains, which means it works with existing DeFi infrastructure. Common use cases include:

**Lending:** Supply LBTC to lending protocols like Aave or Morpho to earn additional yield on top of your base staking rewards. Your LBTC continues to appreciate against BTC while you earn lending interest.

**Liquidity Provision:** Pair LBTC with other assets in DEX pools. The base staking yield helps offset impermanent loss compared to providing liquidity with non-yielding assets.

**Collateral:** Use LBTC as collateral to borrow other assets. The yield-bearing nature means your collateral grows in value over time, improving your health factor.

**Restaking:** Deposit LBTC into restaking protocols like EigenLayer or Symbiotic to earn additional rewards by securing additional networks.

→ [Explore DeFi integrations](https://docs.lombard.finance/use/access-defi)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#fees)

Fees

Minting LBTC is free. Lombard charges no protocol fee for staking. On non-Ethereum chains, Lombard covers minting costs entirely. On Ethereum, you authorize a small network fee in LBTC to cover gas.

The main fee is the Finality Provider commission: 8% of staking rewards. This is deducted automatically before yield accrues to the exchange rate, so the APY you see already reflects this fee.

Unstaking carries a fixed Network Security Fee of 0.0001 LBTC per transaction. This covers Bitcoin network fees and provides economic protection against spam attacks. Lombard states they earn no revenue from this fee.

The minimum deposit is 0.0002 BTC. The minimum redemption is 0.00013300 LBTC (including fees).

→ [Full fee breakdown](https://docs.lombard.finance/use/use-lbtc/fees)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#btc.b-bitcoin-bridged)

BTC.b - Bitcoin Bridged

BTC.b is a non-yield Bitcoin wrapper that maintains a strict 1:1 exchange rate with BTC. Originally created by Ava Labs, BTC.b was acquired by Lombard to offer users a complementary product for use cases where yield isn't the priority.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#how-btc.b-works)

How BTC.b Works

BTC.b represents native Bitcoin held in reserve. Nothing more, nothing less. For every BTC.b in circulation, there's exactly one BTC backing it. The Bitcoin isn't staked, lent, or used for anything else. It simply sits in reserve, verifiable through Chainlink Proof of Reserve feeds that update every 10 minutes.

When you mint BTC.b, you send native Bitcoin to a deposit address generated specifically for your wallet. After Bitcoin network confirmations, the Security Consortium validates your deposit and mints BTC.b to your specified EVM address. The process typically takes about 60 minutes (3-6 Bitcoin confirmations).

Redemption works in reverse. You burn BTC.b, and native Bitcoin is sent to your Bitcoin address. Because there's no staking involved, redemptions don't require an unbonding period. They still take 6 hours due to security verification processes.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#how-btc.b-differs-from-lbtc)

How BTC.b Differs from LBTC

The fundamental difference is simplicity. BTC.b has no yield mechanism, no changing exchange rate, and no staking involved. One BTC.b always equals exactly one BTC.

This simplicity comes with tradeoffs:

**Faster redemptions:** Because BTC.b isn't staked, there's no unbonding period. Redemptions complete in 6 hours versus 9+ days for LBTC.

**Predictable pricing:** The 1:1 rate makes BTC.b straightforward for trading, accounting, and applications that need stable Bitcoin representation.

**No yield:** BTC.b doesn't earn staking rewards. If you're holding Bitcoin long-term, LBTC will outperform BTC.b as staking yield accrues.

**Shared security:** Despite the simpler product design, BTC.b now uses the same Security Consortium infrastructure as LBTC. It uses the same 15 institutional members, the same CubeSigner key management, and the same multi-layer verification.

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#when-to-use-btc.b)

When to Use BTC.b

BTC.b makes sense when you need Bitcoin representation but don't need or want the yield component:

**Trading:** If you're actively trading in and out of positions, the stable 1:1 rate and faster redemptions make BTC.b more practical than LBTC.

**Short-term collateral:** For quick borrowing needs where you'll repay soon, BTC.b's faster redemption means you can exit positions more quickly.

**Integration simplicity:** Some applications prefer assets with fixed exchange rates. BTC.b is easier to integrate when you don't want to handle exchange rate calculations.

**Conversion to LBTC:** BTC.b can be converted directly to LBTC through Lombard's contracts if you later decide you want yield exposure.

→ [How to mint and redeem BTC.b](https://docs.lombard.finance/use/use-btc.b)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#fees-1)

Fees

Minting BTC.b is free. You only pay Bitcoin network transaction fees (typically $2-20 depending on network congestion).

Redemption carries a flat 0.0001 BTC fee to cover Bitcoin network fees. There are no spreads, management fees, custody charges, or performance fees. This fee structure is significantly cheaper than alternatives like WBTC, which charges for both minting and redemption.

The minimum minting amount is 0.0002 BTC with no maximum.

→ [Full fee breakdown](https://docs.lombard.finance/use/use-btc.b#fees)

#### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#btc.b-and-lbtc-together)

BTC.b and LBTC Together

Lombard is the only protocol offering both yield-bearing (LBTC) and non-yield (BTC.b) Bitcoin products. This gives you flexibility to choose the right tool for each situation.

A common pattern is using BTC.b for active trading and short-term needs while holding LBTC for longer-term positions where you want yield accumulation. You can convert between them through Lombard's interface.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#contract-addresses)

Contract Addresses

For developers and users who want to verify they're interacting with official Lombard contracts:

→ [Deployed Contracts](https://docs.lombard.finance/learn/transparency/smart-contracts)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/products-overview/assets#next-steps)

Next Steps

*   [**Use LBTC**](https://docs.lombard.finance/use/use-lbtc)
     — Step-by-step guide to staking and unstaking
    
*   [**Use BTC.b**](https://docs.lombard.finance/use/use-btc.b)
     — How to mint and redeem BTC.b
    
*   [**Bitcoin Earn**](https://docs.lombard.finance/use/use-bitcoin-earn)
     — Depositing into Bitcoin Earn
    
*   [**Understanding Yield**](https://docs.lombard.finance/use/use-lbtc/understanding-yield)
     — Deep dive into how LBTC yield works
    

[PreviousProducts Overviewchevron-left](https://docs.lombard.finance/learn/products-overview)
[NextInfrastructurechevron-right](https://docs.lombard.finance/learn/products-overview/infrastructure)

Last updated 1 month ago

*   [LBTC - Lombard Staked Bitcoin](https://docs.lombard.finance/learn/products-overview/assets#lbtc-lombard-staked-bitcoin)
    
*   [BTC.b - Bitcoin Bridged](https://docs.lombard.finance/learn/products-overview/assets#btc.b-bitcoin-bridged)
    
*   [Contract Addresses](https://docs.lombard.finance/learn/products-overview/assets#contract-addresses)
    
*   [Next Steps](https://docs.lombard.finance/learn/products-overview/assets#next-steps)

---

# Consortium Members | Lombard Docs

The Lombard Security Consortium consists of **15 independent digital asset institutions** that validate and authorize every transaction on the protocol. Members operate the Lombard Ledger through a Proof-of-Authority consensus mechanism, ensuring no single party controls protocol operations.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252Fot7wCmZ6zujCGv3kDMGu%252Fimage.png%3Falt%3Dmedia%26token%3D26919f73-9d60-4dbc-94a3-2a68026d1faf&width=768&dpr=3&quality=100&sign=6fa4f821&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/consortium-members#the-inaugural-members)

Current Members

A collective of 15 leading digital asset institutions committed to securing Bitcoin’s role as a productive asset in the digital economy.

**Leading Crypto Institutions**

*   Galaxy – Galaxy is a digital asset leader bridging financial services, blockchain infrastructure, and Web3 innovation.
    
*   OKX – A global cryptocurrency exchange and Web3 platform.
    
*   Kraken - A global cryptocurrency exchange.
    

**Leading Market Makers**

*   Amber – A global digital finance leader offering wealth management, asset management, and liquidity solutions.
    
*   Wintermute – A leading algorithmic trading firm focused on building liquid and efficient markets in digital assets.
    

**Leading Mining Pools**

*   Antpool – AntPool, a leading cryptocurrency mining platform, is dedicated to delivering high-quality multi-currency mining services.
    
*   F2Pool – F2Pool is a global mining pool securing Bitcoin and 40+ PoW networks since 2013.
    

**Leading Institutional Validators**

*   Chorus.one – Chorus One is a leading institutional staking provider for 50+ Proof-of-Stake networks.
    
*   Figment – A leading blockchain infrastructure and staking provider, offering institutional staking and blockchain infrastructure for PoS networks and Web3.
    
*   Kiln – Kiln is a leading enterprise platform for institutional digital asset rewards and white-label earning solutions.
    
*   P2P – P2P offers non-custodial staking infrastructure for Web3 wallets, exchanges, and custodians.
    

**Security & Research Partners**

*   Cubist – A security-first technology company specializing in cryptographic infrastructure.
    
*   Informal Systems – Providing security audits, protocol design, and formal methods for blockchain applications and infrastructure.
    
*   Nansen – Nansen is the leading onchain analytics platform trusted by the top crypto teams and investors.
    

[PreviousLombard Security Modelchevron-left](https://docs.lombard.finance/learn/lombard-security-model)
[NextAuditschevron-right](https://docs.lombard.finance/learn/lombard-security-model/audits)

Last updated 2 months ago

---

# Lombard Security Model | Lombard Docs

Lombard was built with security as the foundation, not an afterthought. When you deposit Bitcoin with Lombard, you're trusting the protocol with real value. We take that responsibility seriously.

This page explains the security measures protecting your funds, from hardware-level key protection to multi-layer verification to ongoing monitoring and audits.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#our-security-philosophy)

Our Security Philosophy

Most bridge hacks and DeFi exploits share a common pattern: a single point of failure. One compromised key, one buggy contract, one malicious insider. Funds are gone.

Lombard's security model is built on the opposite principle: **defense in depth**. Every critical operation must pass through multiple independent security layers. An attacker would need to simultaneously compromise several unrelated systems to steal funds.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FIWOQ5iogofhEsdKuFBFv%252Fsecurity%2520diagram.png%3Falt%3Dmedia%26token%3D7b1df33c-445a-415c-8f31-086f0fe2a1ec&width=768&dpr=3&quality=100&sign=1f46e5ce&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#security-consortium)

Security Consortium

The Security Consortium is the foundation of Lombard's trust model. Rather than relying on a single entity or a small multisig, Lombard distributes trust across 15 independent digital asset institutions like Galaxy Digital, Wintermute and Kraken.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#why-institutions-matter)

Why Institutions Matter

Consortium members aren't anonymous validators. They're established companies with:

*   **Public reputations** they can't afford to damage
    
*   **Legal accountability** in their jurisdictions
    
*   **Professional security teams** managing infrastructure
    
*   **No single point of control** with geographic and organizational diversity
    

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#supermajority-requirement)

Supermajority Requirement

Every critical operation requires signatures from two-thirds of Consortium members (10 of 15). This means:

*   A single compromised member can't authorize anything
    
*   Even 5 compromised members can't authorize anything
    
*   An attacker needs to simultaneously breach 10 independent institutions
    

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#becoming-a-consortium-member)

Becoming a Consortium Member

Membership isn't open, it requires vetting and approval:

**1\. Infrastructure deployment.** The candidate deploys required infrastructure: Lombard Ledger node, CubeSigner integration, Bitcoin full node, and destination chain nodes.

**2\. Review process.** Existing members review the candidate, including independent KYB (Know Your Business) checks. Public keys and organizational details are exchanged.

**3\. Network vote.** Existing Consortium members vote to add the new member to the Proof-of-Authority network.

**4\. Smart contract update.** The Lombard Protocol multisig updates contracts to include the new member's public address for signature verification.

This process ensures every member meets security standards before gaining signing authority.

→ [Current Consortium members](https://docs.lombard.finance/learn/lombard-security-model/consortium-members)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#cubesigner-hardware-level-protection)

CubeSigner: Hardware-Level Protection

CubeSigner, built by Cubist, provides the key management layer that protects all cryptographic operations in Lombard. It addresses the fundamental tradeoff between security and availability that has plagued crypto protocols.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#keys-never-leave-hardware)

Keys Never Leave Hardware

Private keys are generated inside Hardware Security Modules (HSMs) and never leave. Specifically, Lombard uses HSM-sealed Nitro enclaves designed to prevent key extraction.

This means:

*   **No one can see the keys:** not Consortium members, not Lombard, not Cubist.
    
*   **Keys can't be copied or exported:** they exist only in hardware.
    
*   **Software attacks can't extract keys:** even a fully compromised server can't steal them.
    

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#signing-sessions)

Signing Sessions

When Consortium members need to sign operations, they don't access keys directly. Instead, they use CubeSigner signing sessions:

*   **Fine-grained scopes:** each session restricts who can sign, which messages, and with which keys.
    
*   **Short-lived:** sessions expire quickly, limiting the window for misuse.
    
*   **Instantly revocable:** compromised sessions can be killed immediately.
    

Even if an attacker breached a Consortium member's systems, any stolen session would be useless within minutes.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#policy-enforcement)

Policy Enforcement

CubeSigner doesn't just protect keys. It enforces rules about how they can be used. These policies run in hardware, making them impossible to bypass through software:

**Access control.** Defines who can create and use keys, and under what conditions.

**Transaction restrictions.** Keys can only sign specific transaction types. User keys can only sign Babylon transactions, not arbitrary Bitcoin transactions. Even then, the types of Babylon transactions are restricted.

**Usage limits.** Controls how many transactions can be signed and their parameters (value, recipient, type).

**Multi-party authorization.** Certain operations require multiple members and multiple factors (like YubiKeys) to approve. No single party can unilaterally authorize high-risk transactions.

**Timelocks.** Keys and policies have mandatory waiting periods. Even authorized parties can't use them immediately. This prevents rapid exploitation if credentials are compromised.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#anti-slashing-protection)

Anti-Slashing Protection

Babylon staking introduces slashing risk if validators double-sign. CubeSigner includes Babylon-specific anti-slashing policies that make it cryptographically impossible for validators to sign slashable messages. This holds for operational mistakes, bugs, or attacks.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#bascule-drawbridge-independent-verification)

Bascule Drawbridge: Independent Verification

The Bascule Drawbridge, operated by Cubist, provides a completely independent verification layer. It's a separate system that cross-checks every Consortium action before execution.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#the-drawbridge-metaphor)

The Drawbridge Metaphor

Think of it as a literal drawbridge. The bridge is raised by default, minting is blocked. Only when Bascule independently confirms a valid deposit does the bridge lower to allow minting.

This design means that even a fully compromised Consortium can't mint unbacked LBTC. They would also need to compromise Bascule, which is operated by a separate organization with separate infrastructure.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#why-independent-verification-matters)

Why Independent Verification Matters

Even well-designed systems can have bugs. The Consortium's verification logic could have an edge case that allows invalid mints. CubeSigner policies could have a misconfiguration.

Bascule is the safety net. It runs independently, with its own view of the Bitcoin network and its own verification logic. If something passes the Consortium but shouldn't, Bascule catches it.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#how-bascule-works)

How Bascule Works

**For deposits:**

1.  Bascule monitors the Bitcoin network independently
    
2.  When a deposit is detected, Bascule waits for 6 confirmations
    
3.  Bascule writes an attestation to its smart contract
    
4.  LBTC minting requires valid signatures from both the Consortium AND Bascule
    
5.  If either is missing, minting is blocked
    

**For withdrawals (Reverse Bascule):**

1.  Bascule monitors redemption events on supported chains
    
2.  After confirmations, Bascule writes the burn state to CubeSigner
    
3.  Before authorizing a BTC payout, CubeSigner checks for Bascule's attestation
    
4.  If the attestation is missing, the payout is blocked
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#smart-contract-security)

Smart Contract Security

LBTC contracts are deployed on every supported chain. Each contract undergoes rigorous security review.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#audits)

Audits

Lombard's contracts have been audited by multiple independent security firms:

*   **OpenZeppelin:** industry-leading smart contract auditors.
    
*   **Veridise:** formal verification specialists.
    
*   **Halborn:** blockchain security experts.
    
*   **Cantina:** competitive audit platform for security researchers.
    
*   **Sherlock:** decentralized security audit marketplace.
    

Audit reports are publicly available for review.

→ [View audit reports](https://docs.lombard.finance/learn/lombard-security-model/audits)

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#bug-bounty-program)

Bug Bounty Program

Lombard maintains an active bug bounty program through Immunefi with rewards up to **$250,000** for critical vulnerabilities. This incentivizes security researchers worldwide to find and responsibly disclose issues before they can be exploited.

→ [Bug bounty program](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program)

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#runtime-monitoring)

Runtime Monitoring

Beyond audits, Lombard uses **Hexagate** for real-time monitoring of contract behavior. Anomalous patterns trigger alerts, enabling rapid response to potential threats.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#safety-features)

Safety Features

LBTC contracts include built-in safety mechanisms:

**Pausable functions.** Critical operations can be paused instantly if a threat is detected.

**Two-step upgrades.** Contract upgrades require two separate transactions with a timelock between them. This prevents malicious instant upgrades and gives time for community review.

**Rate limiting.** Unusual patterns (like sudden large mints) can trigger additional verification requirements.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#operational-security)

Operational Security

Security isn't just about code. It's about how systems are operated.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#incident-response)

Incident Response

Lombard maintains documented incident response procedures. When issues are detected:

1.  Automated monitoring triggers alerts
    
2.  On-call team assesses severity
    
3.  If needed, pause functions are activated
    
4.  Root cause analysis begins
    
5.  Fix is developed, reviewed, and deployed
    
6.  Post-mortem is conducted and published
    

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#key-ceremonies)

Key Ceremonies

Critical operations like adding new Consortium members or updating policies follow formal key ceremony procedures with multiple witnesses and verification steps.

#### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#ongoing-review)

Ongoing Review

Security isn't a one-time effort. Lombard conducts:

*   Regular security reviews of infrastructure
    
*   Penetration testing
    
*   Code audits for all significant changes
    
*   Monitoring of new attack vectors in the ecosystem
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#transparency)

Transparency

Security through obscurity isn't security. Lombard maintains transparency about its security measures:

**Proof of Reserve.** Chainlink Proof of Reserve feeds verify Bitcoin backing every 10 minutes. Anyone can verify on-chain that LBTC is fully collateralized.

**On-chain verification.** All Consortium authorizations are recorded on the Lombard Ledger, creating a verifiable audit trail.

**Public audits.** All security audit reports are published publicly.

**Open documentation.** This documentation exists so users can understand exactly how their funds are protected.

→ [Proof of Reserve](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)

→ [Audit reports](https://docs.lombard.finance/learn/lombard-security-model/audits)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#known-risks)

Known Risks

No system is perfectly secure. We believe in being transparent about risks:

**Slashing risk (LBTC only, 0.1%).** BTC staked through Babylon is subject to slashing if Finality Providers double-sign. BTC.b is not staked through Babylon. CubeSigner anti-slashing policies mitigate but don't eliminate this risk.

**Smart contract risk.** Despite audits, undiscovered vulnerabilities may exist in Lombard's contracts or integrated protocols.

**Bridge risk.** Cross-chain transfers rely on bridge infrastructure (CCIP, LayerZero) which could have vulnerabilities. Dual verification mitigates but doesn't eliminate this.

**Consortium risk.** While distributed, the Consortium is a permissioned set. A coordinated attack on supermajority of members could compromise the protocol.

**Regulatory risk.** Future regulations could affect protocol operations or Consortium members.

Understanding these risks helps you make informed decisions about using Lombard.

→ [Risk documentation](https://docs.lombard.finance/learn/transparency/risks)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model#next-steps)

Next Steps

*   [**Protocol Architecture**](https://docs.lombard.finance/learn/protocol-architecture)
     — How the components work together
    
*   [**Proof of Reserve**](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)
     — Verify Bitcoin backing
    
*   [**Audit Reports**](https://docs.lombard.finance/learn/lombard-security-model/audits)
     — Review third-party security assessments
    

[PreviousProtocol Architecturechevron-left](https://docs.lombard.finance/learn/protocol-architecture)
[NextConsortium Memberschevron-right](https://docs.lombard.finance/learn/lombard-security-model/consortium-members)

Last updated 1 month ago

*   [Our Security Philosophy](https://docs.lombard.finance/learn/lombard-security-model#our-security-philosophy)
    
*   [Security Consortium](https://docs.lombard.finance/learn/lombard-security-model#security-consortium)
    
*   [CubeSigner: Hardware-Level Protection](https://docs.lombard.finance/learn/lombard-security-model#cubesigner-hardware-level-protection)
    
*   [Bascule Drawbridge: Independent Verification](https://docs.lombard.finance/learn/lombard-security-model#bascule-drawbridge-independent-verification)
    
*   [Smart Contract Security](https://docs.lombard.finance/learn/lombard-security-model#smart-contract-security)
    
*   [Operational Security](https://docs.lombard.finance/learn/lombard-security-model#operational-security)
    
*   [Transparency](https://docs.lombard.finance/learn/lombard-security-model#transparency)
    
*   [Known Risks](https://docs.lombard.finance/learn/lombard-security-model#known-risks)
    
*   [Next Steps](https://docs.lombard.finance/learn/lombard-security-model#next-steps)

---

# Bug Bounty Program | Lombard Docs

Lombard partners with Immunefi to operate an evergreen bug bounty program offering up to $250,000 for critical vulnerability discoveries. The program has been live since September 4, 2024, creating continuous incentive for security researchers to review and test the protocol.

Bug bounties complement formal audits by engaging the broader security community. While audits provide deep, focused reviews at specific points in time, bounty programs maintain ongoing vigilance as the protocol evolves and new attack vectors emerge.

Immunefi is the leading bug bounty platform in Web3, having facilitated over $100 million in payouts to white-hat hackers. Their infrastructure handles vulnerability disclosure, communication between researchers and projects, and secure reward distribution.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#rewards-by-severity)

Rewards by Severity

Rewards scale with the severity and potential impact of discovered vulnerabilities.

Severity

Smart Contract

Web/App

Critical

Up to $250,000

Up to $25,000

High

$10,000 – $25,000

$5,000 – $10,000

Medium

$5,000 – $10,000

$2,500 – $5,000

Low

$1,000 – $5,000

$1,000 – $2,500

Critical smart contract vulnerabilities—those enabling theft of funds, permanent freezing, or protocol insolvency—receive the highest rewards. The exact amount depends on the funds at risk and the sophistication of the exploit.

Payments are made in USDC and processed through Immunefi. KYC verification is required before receiving rewards for critical submissions.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#assets-in-scope)

Assets in Scope

The program covers Lombard's core smart contracts and web applications.

**Smart Contracts (Ethereum Mainnet):**

Contract

Address

LBTC Token

`0x8236a87084f8B84306f72007F36F2618A5634494`

Consortium Governance

`0xed6D647E2F81E5262101aFf72c4A7bcDcfd780e0`

Proxy Upgrade Timelock

`0x055E84e7FE8955E2781010B866f10Ef6E1E77e59`

The full scope including additional contracts is available on the Immunefi program page.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#impacts-in-scope)

Impacts in Scope

The program accepts reports for specific impact categories. Critical impacts include:

*   Direct theft of user funds (at-rest or in-motion)
    
*   Permanent freezing of funds
    
*   Protocol insolvency
    
*   Manipulation of governance voting results
    
*   Execution of arbitrary system commands
    
*   Retrieval of sensitive data from running servers (database passwords, blockchain keys)
    
*   Taking down the application or website
    
*   Unauthorized state-modifying actions on behalf of other users
    
*   Subdomain takeover with wallet interaction
    
*   Malicious interactions with connected wallets (modifying transactions, substituting addresses)
    

High, medium, and low severity impacts follow Immunefi's standard vulnerability classification system.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#out-of-scope)

Out of Scope

Certain categories are excluded from the program:

*   Impacts requiring basic economic attacks (51% attacks)
    
*   Impacts from Sybil attacks
    
*   Lack of liquidity impacts
    
*   Incorrect data from third-party oracles (excluding oracle manipulation attacks)
    
*   Centralization risks
    
*   Vulnerabilities the reporter has already exploited
    
*   Attacks requiring access to leaked credentials or privileged addresses
    
*   Impacts from external stablecoin depegging not caused by code bugs
    
*   Best practice recommendations without security impact
    
*   Feature requests
    
*   Impacts on test files and configuration files
    

Mentions of secrets, API keys, or private keys in GitHub repositories are out of scope without proof they are used in production.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#how-to-submit-a-report)

How to Submit a Report

**1\. Create an Immunefi account** at bugs.immunefi.com if you don't have one.

**2\. Review the program scope** to confirm your finding affects in-scope assets and impacts.

**3\. Prepare your report** with clear documentation of the vulnerability, including:

*   Affected asset and impact category
    
*   Step-by-step reproduction instructions
    
*   Proof of Concept (required for all submissions)
    
*   Potential impact assessment
    

**4\. Submit through Immunefi's dashboard** at bugs.immunefi.com. Select "Lombard Finance" as the program.

**5\. Wait for triage.** Immunefi's team reviews submissions before forwarding to Lombard. Initial response typically occurs within 48 hours.

**6\. Collaborate on remediation.** If valid, Lombard's security team works with you to understand and fix the issue.

**7\. Receive payment** after the vulnerability is confirmed and addressed. KYC required for critical rewards.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#program-requirements)

Program Requirements

**Proof of Concept Required**: All submissions must include a working PoC demonstrating the vulnerability. Reports without PoC are not eligible for rewards.

**Responsible Disclosure**: Do not publicly disclose vulnerabilities before they are fixed. Researchers may publish reports after resolution with Lombard's approval.

**No Exploitation**: Do not exploit vulnerabilities on mainnet or cause damage while researching. Use testnets and local environments for testing.

**One Bug, One Report**: Submit separate reports for distinct vulnerabilities. Do not bundle multiple issues into a single submission.

**First Reporter Wins**: Only the first report of a given vulnerability is eligible for reward. Duplicate reports receive no payout.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#program-policies)

Program Policies

**Primacy of Impact**: Lombard follows this policy for critical smart contract vulnerabilities. If you discover a critical impact on a Lombard-owned asset not explicitly listed in scope, it may still be eligible for reward.

**Known Issues**: Previously discovered vulnerabilities documented in audits or self-reported by Lombard are not eligible. Immunefi maintains a known issues list to prevent duplicate rewards.

**Geographic Restrictions**: The program is not open to residents of OFAC-sanctioned countries or regions restricted by UN Security Council resolutions.

**Arbitration**: Disputes between researchers and Lombard can be escalated to Immunefi for mediation. The program has arbitration enabled for unresolved disagreements.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#why-lombard-invests-in-bug-bounties)

Why Lombard Invests in Bug Bounties

The protocol secures over $1.5 billion in user Bitcoin. A single critical vulnerability could result in catastrophic losses—not just financial, but to the trust that users place in the protocol.

Bug bounties create alignment between the protocol and the security research community. Researchers earn substantial rewards for finding issues before malicious actors do. Lombard benefits from continuous scrutiny that supplements formal audits.

The $250,000 maximum bounty reflects the value Lombard places on security. For critical vulnerabilities affecting substantial funds, paying six figures to a white-hat researcher is far preferable to losing user assets to an exploit.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#additional-security-measures)

Additional Security Measures

The bug bounty program is one layer of Lombard's security framework:

*   **Double audits** by OpenZeppelin, Halborn, Veridise, Cantina, and Sherlock before every major release
    
*   **Runtime monitoring** through Hexagate for 24/7 threat detection
    
*   **Proof of reserves** via Chainlink and Redstone oracles
    
*   **Security Consortium** of 15 institutional validators
    
*   **Hardware-isolated key storage** through Cubist's CubeSigner
    
*   **Full-time security engineer** reviewing all code changes
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#whats-next)

What's Next

*   [**Immunefi Bug Bounty Page**arrow-up-right](https://immunefi.com/bug-bounty/lombard-finance/scope/)
     - Review the full program scope and submit findings at immunefi.com/bug-bounty/lombard-finance
    
*   [**Audits Documentation**](https://docs.lombard.finance/learn/lombard-security-model/audits)
     - Read about Lombard’s completed security audits and review past assessments
    

[PreviousAuditschevron-left](https://docs.lombard.finance/learn/lombard-security-model/audits)
[NextTransparencychevron-right](https://docs.lombard.finance/learn/transparency)

Last updated 2 months ago

*   [Rewards by Severity](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#rewards-by-severity)
    
*   [Assets in Scope](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#assets-in-scope)
    
*   [Impacts in Scope](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#impacts-in-scope)
    
*   [Out of Scope](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#out-of-scope)
    
*   [How to Submit a Report](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#how-to-submit-a-report)
    
*   [Program Requirements](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#program-requirements)
    
*   [Program Policies](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#program-policies)
    
*   [Why Lombard Invests in Bug Bounties](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#why-lombard-invests-in-bug-bounties)
    
*   [Additional Security Measures](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#additional-security-measures)
    
*   [What's Next](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program#whats-next)

---

# Protocol Architecture | Lombard Docs

Lombard's architecture distributes trust across multiple independent parties, ensuring that custody, verification, and authorization all operate through cryptographic coordination rather than single points of control. This page provides an overview of each component and how they work together.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FdmMyDyfNEdNN09oViDx7%252Farchitecture.png%3Falt%3Dmedia%26token%3Deac51a49-259f-48b4-9cfe-cb571dfc37f7&width=768&dpr=3&quality=100&sign=556ac73c&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#components)

Component~s~

Lombard's architecture consists of five core components:

*   **Lombard Ledger**: The BFT appchain where the Security Consortium coordinates and authorizes operations.
    
*   **CubeSigner**: Hardware-backed key management that protects cryptographic keys.
    
*   **Bascule Drawbridge**: Independent verification layer that cross-checks consortium actions.
    
*   **Smart Contracts**: The token contracts deployed on each supported chain.
    
*   **Trustless Relayer**: Infrastructure services that facilitate communication between networks.
    

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FhFTFUcOB3kWH41tO3nZ1%252Farch.png%3Falt%3Dmedia%26token%3Def0faa09-afe4-488f-ab30-8f8ba560679e&width=768&dpr=3&quality=100&sign=de7d8919&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#lombard-ledger)

Lombard Ledger

The Lombard Ledger is the coordination layer at the heart of Lombard. It's a Cosmos-based appchain running CometBFT consensus, operated by the Security Consortium.

The Ledger serves as the single source of truth for all Lombard operations. It tracks every BTC deposit, every LBTC mint, every redemption, and every cross-chain transfer. Before any tokenized asset can be minted onchain, the Ledger must first record and authorize that mint.

The Ledger also acts as the platform for collecting and distributing yield.

#### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#what-the-consortium-does)

What the Consortium Does

The Security Consortium performs five core functions through the Ledger:

**1\. Create deposit addresses.** When you request to stake, the Consortium creates a new Bitcoin address managed by CubeSigner.

**2\. Verify deposits.** Consortium members independently verify that your BTC deposit exists on the Bitcoin network, has 6 confirmations, and matches the expected amount and address.

**3\. Stake and unstake BTC.** The Consortium selects Finality Providers and manages staking/unstaking operations with Babylon.

**4\. Mint and burn tokenized assets.** After verifying deposits, the Consortium authorizes minting (e.g. LBTC). For redemptions, the Consortium authorizes burns and processes payouts.

**5\. Pay out unstaked BTC.** Once BTC is unstaked (if necessary), the Consortium handles sending native BTC back to users.

Every action requires signatures from two-thirds of Consortium members.

→ [Security Consortium members](https://docs.lombard.finance/learn/lombard-security-model/consortium-members)

→ [How the Security Model protects these operations](https://docs.lombard.finance/learn/lombard-security-model)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#cubesigner)

CubeSigner

CubeSigner is the key management platform built by Cubist that protects all cryptographic keys in the Lombard system. Keys are generated and stored in Hardware Security Modules (HSMs), they never leave secure hardware.

This means no one, not Consortium members, not Lombard, not even Cubist, can see or extract private keys. When a signature is needed, the HSM performs the operation internally and returns only the signed result.

Beyond protecting keys, CubeSigner enforces policies that control how keys can be used: who can sign, what types of transactions, under what conditions. These policies run in hardware and can't be bypassed through software attacks.

→ [CubeSigner security details](https://docs.lombard.finance/learn/lombard-security-model#cubesigner-hardware-level-protection)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#bascule-drawbridge)

Bascule Drawbridge

The Bascule Drawbridge is an independent verification layer operated by Cubist. It provides a second check on all consortium operations. If the consortium's verification had a bug or was compromised, Bascule would catch it.

**For deposits (Bascule):** Before any mint, Bascule independently verifies that the BTC deposit exists on the Bitcoin network with 6 confirmations. Minting requires valid signatures from both the Consortium and Bascule.

**For withdrawals (Reverse Bascule):** Bascule monitors redemption events on supported chains. Before CubeSigner authorizes a BTC payout, the Reverse Bascule verifies that the corresponding LBTC was actually burned.

This creates defense in depth, an attacker would need to compromise both the Consortium and Bascule simultaneously.

→ [Bascule security details](https://docs.lombard.finance/learn/lombard-security-model#bascule-drawbridge-independent-verification)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#smart-contracts)

Smart Contracts

LBTC and BTC.b is deployed as a standard token on each supported blockchain; ERC-20 on Ethereum, BEP-20 on BSC, and equivalent standards elsewhere.

The contracts include:

**Minting logic.** Creates new supply after authorization from both the Security Consortium and Bascule. Supports individual and batch minting.

**Redemption logic.** Burns LBTC and records the user's Bitcoin address for payout.

**Bridge integration.** Chainlink CCIP integration for cross-chain transfers, requiring authorization from both the Consortium and Chainlink.

**Consortium verification.** Multi-sig contract that validates all authorizations are signed by two-thirds of members.

**Safety features.** Pausable functions for emergency response, two-step upgrades with timelocks.

→ [Deployed contract addresses](https://docs.lombard.finance/learn/transparency/smart-contracts)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#trustless-relayer)

Trustless Relayer

The Trustless Relayer is a set of infrastructure services that facilitate communication between blockchain networks and automate routine operations.

The Relayer handles:

**Deposit monitoring.** Watches the Bitcoin network and reports Lombard-related deposits to the Ledger.

**Bridge event monitoring.** Monitors supported chains for CCIP bridge events and reports them to the Ledger.

**Auto-mint.** Automatically mints LBTC for depositors after Consortium authorization, so users don't have to submit a separate transaction.

**Address registry.** Records all Lombard deposit addresses on-chain (on Base) for Proof of Reserve validation.

**Staking operations.** Requests stake/unstake operations on the Ledger (temporary until automation is built into the Ledger).

The Relayer has limited privileges (Operator and Claimer roles). It can facilitate operations but cannot authorize mints or move funds without Consortium approval.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#how-it-all-connects)

How It All Connects

When you stake BTC, here's how the components work together:

**1.** You request a deposit address → **Ledger** creates it via **CubeSigner**

**2.** You send BTC → **Relayer** detects and reports to **Ledger**

**3.** Consortium members verify → **Ledger** records notarization

**4.** **Bascule** independently verifies the deposit

**5.** **Ledger** authorizes mint → **Smart Contract** mints tokens

**6.** **Relayer** auto-mints to your wallet (or you claim manually)

For redemptions, the flow reverses: Smart Contract burns → Ledger records → Reverse Bascule verifies → CubeSigner authorizes → BTC sent to your address.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/protocol-architecture#next-steps)

Next Steps

*   [**Security Model**](https://docs.lombard.finance/learn/lombard-security-model)
     — Deep dive into how each component protects user funds
    
*   [**Deployed Contracts**](https://docs.lombard.finance/learn/transparency/smart-contracts)
     — Contract addresses across all chains
    

[PreviousYieldchevron-left](https://docs.lombard.finance/learn/products-overview/yield)
[NextLombard Security Modelchevron-right](https://docs.lombard.finance/learn/lombard-security-model)

Last updated 1 month ago

*   [Components](https://docs.lombard.finance/learn/protocol-architecture#components)
    
*   [Lombard Ledger](https://docs.lombard.finance/learn/protocol-architecture#lombard-ledger)
    
*   [CubeSigner](https://docs.lombard.finance/learn/protocol-architecture#cubesigner)
    
*   [Bascule Drawbridge](https://docs.lombard.finance/learn/protocol-architecture#bascule-drawbridge)
    
*   [Smart Contracts](https://docs.lombard.finance/learn/protocol-architecture#smart-contracts)
    
*   [Trustless Relayer](https://docs.lombard.finance/learn/protocol-architecture#trustless-relayer)
    
*   [How It All Connects](https://docs.lombard.finance/learn/protocol-architecture#how-it-all-connects)
    
*   [Next Steps](https://docs.lombard.finance/learn/protocol-architecture#next-steps)

---

# Transparency | Lombard Docs

Lombard is committed to transparency. You shouldn't have to trust us, you should be able to verify everything yourself.

This section provides the information and tools to independently verify that Lombard is operating correctly: that LBTC and BTC.b are fully backed, where the smart contracts are deployed, how bridging works, and what risks exist.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency#dont-trust-verify)

Don't Trust, Verify

Lombard publishes all the information you need to verify protocol health:

**Proof of Reserve.** Chainlink Proof of Reserve feeds verify that LBTC and BTC.b are fully backed by Bitcoin. These feeds update every 10 minutes, and anyone can check them on-chain.

**On-chain records.** Every Consortium authorization is recorded on the Lombard Ledger. Mints, burns, and cross-chain transfers all leave verifiable audit trails.

**Published contracts.** All smart contract addresses are public. You can verify you're interacting with official Lombard contracts, review the code, and check audit reports.

**Open documentation.** This documentation exists so you understand exactly how the protocol works, no black boxes.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency#what-you-can-verify)

What You Can Verify

#### 

[hashtag](https://docs.lombard.finance/learn/transparency#lbtc-backing)

LBTC Backing

Every LBTC is backed by BTC staked through Babylon. You can verify:

*   Total BTC held in Lombard's Bitcoin addresses
    
*   Total LBTC supply across all chains
    
*   That backing ratio is maintained (BTC ≥ LBTC)
    

→ [Proof of Reserve feeds](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#proof-of-reserve)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency#btc.b-backing)

BTC.b Backing

Every BTC.b is backed 1:1 by native Bitcoin held in reserve. You can verify:

*   Total BTC held in BTC.b reserve addresses
    
*   Total BTC.b supply
    
*   That the 1:1 ratio is maintained
    

→ [Proof of Reserve feeds](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#proof-of-reserve)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency#exchange-rate)

Exchange Rate

The LBTC/BTC exchange rate increases over time as staking yield accrues. You can verify:

*   Current exchange rate on-chain
    
*   Historical rate changes
    
*   That the rate only increases (never decreases)
    

→ [Exchange rate feeds](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#price-feed-oracles)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency#contract-authenticity)

Contract Authenticity

Before interacting with Lombard, you can verify you're using official contracts:

*   Check contract addresses against our published list
    
*   Review verified source code on block explorers
    
*   Confirm contracts match audited versions
    

→ [Smart contract addresses](https://docs.lombard.finance/learn/transparency/smart-contracts)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency#transparency-pages)

Transparency Pages

[**Oracles & Price Feeds**](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)
 How to access Proof of Reserve data, exchange rate feeds, and other on-chain information.

[**Smart Contracts**](https://docs.lombard.finance/learn/transparency/smart-contracts)
 Deployed contract addresses across all supported chains.

[**Bridging Architecture**](https://docs.lombard.finance/learn/transparency/bridging-architecture)
 How cross-chain transfers work, which bridges are used, and security mechanisms.

[**Risks**](https://docs.lombard.finance/learn/transparency/risks)
 Honest documentation of the risks involved in using Lombard.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency#external-resources)

External Resources

**Audit Reports** Third-party security audits from OpenZeppelin, Veridise, and Halborn. → [View audits](https://docs.lombard.finance/learn/lombard-security-model/audits)

**DeFiLlama** Independent TVL tracking and protocol metrics. → [Lombard on DeFiLlamaarrow-up-right](https://defillama.com/protocol/lombard)

**GitHub** Open source code repositories. → [Lombard GitHubarrow-up-right](https://github.com/lombard-finance)

[PreviousBug Bounty Programchevron-left](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program)
[NextOracles & Price Feedschevron-right](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)

Last updated 2 months ago

*   [Don't Trust, Verify](https://docs.lombard.finance/learn/transparency#dont-trust-verify)
    
*   [What You Can Verify](https://docs.lombard.finance/learn/transparency#what-you-can-verify)
    
*   [Transparency Pages](https://docs.lombard.finance/learn/transparency#transparency-pages)
    
*   [External Resources](https://docs.lombard.finance/learn/transparency#external-resources)

---

# Audits | Lombard Docs

Lombard audits all major releases before deployment. Every piece of code that reaches production undergoes review by independent security firms, plus multiple internal reviews by Lombard's full-time contributors. Major releases also go through competitive audit contests where dozens of security researchers battle-test the code simultaneously.

This multi-layered approach reflects the protocol's position as custodian of over $1.5 billion in Bitcoin. When users stake BTC through Lombard, they trust the protocol with significant value. That trust demands rigorous verification at every stage of development.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/audits#audit-partners)

Audit Partners

Lombard maintains long-term auditing relationships with industry-leading security firms. Each brings different methodologies and expertise to the review process.

**OpenZeppelin** is one of the most recognized names in smart contract security. Their team has audited protocols holding tens of billions in value and maintains the widely-used OpenZeppelin Contracts library. OpenZeppelin reviewed Lombard's V2 release including the LBTC token, bridge/OFT implementations, and consortium contracts.

**Halborn** specializes in penetration testing and offensive security. Their engineers approach audits from an attacker's perspective, actively attempting to exploit vulnerabilities rather than just identifying theoretical risks. Halborn has conducted multiple audits for Lombard covering the V1 release, BTC.b PMM integration, and FBTC integration.

**Veridise** focuses on formal verification and mathematical proofs of contract correctness. Their approach goes beyond code review to prove that contracts behave exactly as specified under all possible conditions. Veridise audited Lombard's initial LBTC contracts, cross-chain bridge logic, and the comprehensive V2 release.

**Cantina** brings elite security researchers together for focused assessments. Their auditors have discovered critical vulnerabilities across major DeFi protocols.

**Sherlock** operates an audit marketplace where multiple independent auditors compete to find issues. This competitive structure surfaces vulnerabilities that single-firm audits might miss.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/audits#completed-audits)

Completed Audits

All audit reports are publicly available on GitHub at `github.com/lombard-finance/evm-smart-contracts/tree/main/docs/audit`.

Audit Purpose

Scope

Report

Firm

Date

V1 Release

`consortium`, `LBTC`, `libs`, `bascule`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Halborn_V1.pdf)

[Halbornarrow-up-right](https://www.halborn.com/)

05.08.2024

V1 Release

`consortium`, `LBTC`, `libs`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Veridise_V1.pdf)

[Veridisearrow-up-right](https://veridise.com/)

21.08.2024

BTCB PMM release

`LBTC`, `pmm`, `libs`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Halborn_V1_5.pdf)

[Halbornarrow-up-right](https://www.halborn.com/)

10.10.2024

FBTC integration

`fbtc`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Halborn_V2.pdf)

[Halbornarrow-up-right](https://www.halborn.com/)

09.12.2024

V2 Release

`LBTC`, `bridge/oft`, `consortium`, `libs`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/OpenZeppelin_V2.pdf)

[OpenZeppelinarrow-up-right](https://www.openzeppelin.com/)

13.12.2024

V2 Release

`LBTC`, `BasculeV2`, `bridge`, `consortium`, `factory`, `libs`, `pmm`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Veridise_V2.pdf)

[Veridisearrow-up-right](https://veridise.com/)

17.12.2024

Yield Bearing

`LBTC/NativeLBTC`, `AssetRouter`, `GMP`, `oracle`, `libs` , `bridgev2`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/OZ_YB.pdf)

[OpenZeppelinarrow-up-right](https://www.openzeppelin.com/)

25.07.2025

Yield Bearing

`LBTC/NativeLBTC`, `AssetRouter`, `GMP`, `oracle`, `libs`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/Sherlock_YB.pdf)

[Sherlockarrow-up-right](https://sherlock.xyz/)

25.07.2025

StakeAndBake

`StakeAndBake`, `iDepositor`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/ABDK_SAB_202509.pdf)

[ABDKarrow-up-right](https://abdk.consulting/)

22.09.2025

BTC.b & BridgeV2

`BridgeV2`, `LombardTokenPoolV2`, `BridgeTokenPool`, `BridgeTokenAdapter`

[pdfarrow-up-right](https://raw.githubusercontent.com/lombard-finance/evm-smart-contracts/main/docs/audit/OZ_2025_10.pdf)

[OpenZeppelinarrow-up-right](https://www.openzeppelin.com/)

24.10.2025

Some contracts were modified after their initial audits. The GitHub repository notes which contracts have been updated since their last review. Lombard re-audits any significant changes before deployment.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/audits#what-auditors-review)

What Auditors Review

Security audits cover multiple dimensions of smart contract safety.

**Code correctness** verifies that contracts behave as intended. Auditors trace through every function to confirm logic matches specifications. They check edge cases, boundary conditions, and unexpected input combinations.

**Access control** examines who can call which functions. Auditors verify that privileged operations require appropriate permissions and that permission checks cannot be bypassed.

**Economic attacks** assess whether the protocol can be exploited through market manipulation, flash loans, or other financial mechanisms. This includes analyzing oracle dependencies and liquidation mechanisms.

**Reentrancy and ordering** looks for vulnerabilities where external calls could allow attackers to manipulate contract state. Auditors verify that state changes happen in the correct sequence.

**Upgrade safety** reviews proxy patterns and upgrade mechanisms. For upgradeable contracts like Lombard's, auditors ensure that upgrades cannot corrupt storage or introduce vulnerabilities.

**Integration risks** examine how contracts interact with external protocols. This includes bridges, oracles, and DeFi integrations.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/audits#continuous-security)

Continuous Security

Audits represent point-in-time assessments. Lombard maintains ongoing security through several additional mechanisms.

**Runtime monitoring** through Hexagate provides 24/7 threat detection. The system monitors for anomalies, suspicious transactions, and potential exploits in real-time. Automated pause functions can halt the protocol before an attack causes damage.

**Bug bounty program** on Immunefi offers up to $250,000 for vulnerability discoveries. This creates ongoing incentive for security researchers to review the codebase even after audits conclude.

**Internal security** includes a full-time security engineer who reviews all code changes before deployment. The team follows secure development practices and maintains comprehensive test coverage.

**Proof of reserves** through Chainlink and Redstone oracles provides real-time verification that BTC backing equals LBTC supply. This transparency layer lets anyone verify protocol solvency at any time.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/lombard-security-model/audits#whats-next)

What's Next

*   [**Bug Bounty Program**](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program)
     - Learn how to responsibly report vulnerabilities and earn rewards
    
*   [**Security Consortium Documentation**](https://docs.lombard.finance/learn/lombard-security-model#security-consortium)
     - Explore Lombard’s security architecture and design principles
    

[PreviousConsortium Memberschevron-left](https://docs.lombard.finance/learn/lombard-security-model/consortium-members)
[NextBug Bounty Programchevron-right](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program)

Last updated 2 months ago

*   [Audit Partners](https://docs.lombard.finance/learn/lombard-security-model/audits#audit-partners)
    
*   [Completed Audits](https://docs.lombard.finance/learn/lombard-security-model/audits#completed-audits)
    
*   [What Auditors Review](https://docs.lombard.finance/learn/lombard-security-model/audits#what-auditors-review)
    
*   [Continuous Security](https://docs.lombard.finance/learn/lombard-security-model/audits#continuous-security)
    
*   [What's Next](https://docs.lombard.finance/learn/lombard-security-model/audits#whats-next)

---

# Risks | Lombard Docs

Using Lombard involves risks. We believe you should understand these risks before depositing funds. This page provides honest documentation of what can go wrong.

No protocol is risk-free. Understanding risks helps you make informed decisions about how much to deposit and which products to use.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#slashing-risk)

Slashing Risk

Applies to LBTC only. BTC.b is not staked through Babylon.

**What it is:** BTC staked through Babylon is subject to slashing if Finality Providers misbehave. Specifically, if a Finality Provider signs two conflicting blocks at the same height (double-signing), the protocol slashes 0.1% of delegated stake.

**How Lombard mitigates it:**

*   Delegates only to institutional Finality Providers (Figment, Galaxy, Kiln, P2P.org) with professional operations
    
*   Uses CubeSigner anti-slashing policies that make it cryptographically impossible to sign conflicting messages
    
*   Diversifies across multiple Finality Providers so a single FP's slashing doesn't affect all funds
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#smart-contract-risk)

Smart Contract Risk

**What it is:** LBTC and BTC.b rely on smart contracts deployed across multiple chains. If these contracts contain vulnerabilities, funds could be stolen or frozen.

**How Lombard mitigates it:**

*   Multiple independent audits (OpenZeppelin, Veridise, Halborn)
    
*   $250,000 bug bounty program on Immunefi
    
*   Hexagate runtime monitoring for anomalous behavior
    
*   Pausable functions for emergency response
    
*   Two-step upgrades with timelocks
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#bridge-risk)

Bridge Risk

**What it is:** Cross-chain transfers rely on bridge infrastructure (Chainlink CCIP, LayerZero). Bridge protocols have historically been targets for exploits.

**How Lombard mitigates it:**

*   Uses established, audited bridge protocols (not custom infrastructure)
    
*   Dual verification requires both bridge validators AND Security Consortium approval
    
*   Rate limiting on unusual transfer patterns
    
*   Emergency pause capability
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#depeg-risk)

Depeg Risk

**What it is:** LBTC and BTC.b may trade at prices different from their underlying BTC value on secondary markets.

**For LBTC:** The token may trade at a discount during market stress (when many users want to redeem and are willing to sell at a discount rather than wait 9 days) or at a premium during high demand.

**For BTC.b:** Despite the 1:1 backing, market prices can temporarily diverge during volatility or low liquidity.

**How Lombard mitigates it:**

*   Full backing verified by Proof of Reserve
    
*   Redemption always available at true value (though with time delay)
    
*   Deep liquidity across major DeFi protocols
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#liquidity-risk)

Liquidity Risk

**What it is:** Redeeming LBTC for native BTC takes approximately 9 days (2 days for Lombard processing + 7 days for Babylon unbonding). During this period, you're exposed to BTC price volatility and cannot access your funds.

**For BTC.b:** Redemptions are faster but still not instant.

**How Lombard mitigates it:**

*   Secondary market liquidity allows faster exits (at potential discount)
    
*   Transparent redemption tracking
    
*   Reliable redemption execution
    

**Residual risk:** If you need immediate liquidity during a market crash, you cannot access your BTC quickly. You'd need to sell on secondary markets at whatever price is available.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#consortium-risk)

Consortium Risk

**What it is:** The Security Consortium is a permissioned set of 15 members. While distributed, it's not fully decentralized. A coordinated attack or collusion among 10+ members could compromise the protocol.

**How Lombard mitigates it:**

*   Members are established institutions with public reputations
    
*   Geographic and organizational diversity
    
*   CubeSigner prevents direct key access
    
*   Bascule provides independent verification
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#regulatory-risk)

Regulatory Risk

**What it is:** Future regulations could affect Lombard's operations, Consortium members, or your ability to use the protocol.

**Potential scenarios:**

*   Consortium members in certain jurisdictions forced to stop participating
    
*   Regulations restricting staking services
    
*   Requirements affecting how LBTC is treated in DeFi
    

**How Lombard mitigates it:**

*   Consortium member diversity across jurisdictions
    
*   No single jurisdiction represents a majority
    
*   Ongoing legal monitoring
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#defi-integration-risk)

DeFi Integration Risk

**What it is:** Using LBTC in DeFi protocols (lending, LPing, vaults) exposes you to risks from those protocols in addition to Lombard's risks.

**Examples:**

*   Lending protocol hack could lose your deposited LBTC
    
*   DEX exploit could drain pools containing your LBTC
    
*   Vault strategy failure could result in losses
    

**How Lombard mitigates it:**

*   Partners with established, audited protocols
    
*   Lombard DeFi Vault uses conservative strategies
    
*   Does not control or guarantee third-party protocols
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#oracle-risk)

Oracle Risk

**What it is:** LBTC's exchange rate and Proof of Reserve data are provided by oracles. Oracle failures could affect DeFi integrations.

**Potential issues:**

*   Stale price data causing incorrect liquidations
    
*   Oracle manipulation affecting protocol behavior
    
*   Proof of Reserve delays masking issues
    

**How Lombard mitigates it:**

*   Uses Chainlink, the industry-leading oracle provider
    
*   Multiple data sources and validation
    
*   Fallback mechanisms
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/risks#incident-history)

Incident History

Lombard maintains a public record of any security incidents or near-misses.

_\[As of this writing, no significant security incidents have occurred.\]_

[PreviousBridging Architecturechevron-left](https://docs.lombard.finance/learn/transparency/bridging-architecture)
[NextToken Economicschevron-right](https://docs.lombard.finance/learn/token-economics)

Last updated 2 months ago

*   [Slashing Risk](https://docs.lombard.finance/learn/transparency/risks#slashing-risk)
    
*   [Smart Contract Risk](https://docs.lombard.finance/learn/transparency/risks#smart-contract-risk)
    
*   [Bridge Risk](https://docs.lombard.finance/learn/transparency/risks#bridge-risk)
    
*   [Depeg Risk](https://docs.lombard.finance/learn/transparency/risks#depeg-risk)
    
*   [Liquidity Risk](https://docs.lombard.finance/learn/transparency/risks#liquidity-risk)
    
*   [Consortium Risk](https://docs.lombard.finance/learn/transparency/risks#consortium-risk)
    
*   [Regulatory Risk](https://docs.lombard.finance/learn/transparency/risks#regulatory-risk)
    
*   [DeFi Integration Risk](https://docs.lombard.finance/learn/transparency/risks#defi-integration-risk)
    
*   [Oracle Risk](https://docs.lombard.finance/learn/transparency/risks#oracle-risk)
    
*   [Incident History](https://docs.lombard.finance/learn/transparency/risks#incident-history)

---

# Bridging Architecture | Lombard Docs

LBTC and BTC.b are natively available across multiple blockchains. This page explains how cross-chain transfers work and the security mechanisms protecting them.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#how-bridging-works)

How Bridging Works

When you bridge LBTC from one chain to another, tokens aren't literally "moved." Instead:

1.  LBTC is burned on the source chain
    
2.  The burn is verified by multiple parties
    
3.  LBTC is minted on the destination chain
    

The total supply across all chains remains constant. Bridging just changes where your tokens exist.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#dual-verification)

Dual Verification

What makes Lombard's bridging different is dual verification. Every cross-chain transfer requires approval from two independent systems:

**1\. Bridge validators:** The bridge infrastructure (Chainlink CCIP or LayerZero) verifies the burn on the source chain

**2\. Security Consortium:** Lombard's Consortium independently verifies and authorizes the mint

Both must approve. If either system rejects the transfer, it doesn't go through.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#why-this-matters)

Why This Matters

Most bridge hacks exploit a single point of failure. Compromise the bridge and steal the funds. With dual verification:

*   A compromised bridge alone can't mint unbacked tokens
    
*   A compromised Consortium alone can't bypass bridge security
    
*   An attacker needs to compromise both systems simultaneously
    

This significantly raises the difficulty of a successful attack.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#bridge-infrastructure)

Bridge Infrastructure

Lombard uses established bridge protocols rather than building proprietary infrastructure.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#chainlink-ccip)

Chainlink CCIP

Chainlink Cross-Chain Interoperability Protocol (CCIP) is the primary bridge for major EVM chains.

**How it works:**

*   Chainlink's decentralized oracle network validates cross-chain messages
    
*   Risk Management Network provides additional verification
    
*   Configurable finality requirements per chain
    

**Chains using CCIP:**

*   Ethereum ↔ Base
    
*   Ethereum ↔ BNB Smart Chain
    

→ [CCIP documentationarrow-up-right](https://chain.link/ccip)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#layerzero)

LayerZero

LayerZero extends coverage to additional chains through its Omnichain Fungible Token (OFT) standard.

**How it works:**

*   Decentralized Verifier Networks (DVNs) validate messages
    
*   OFT Adapters handle cross-chain token transfers
    
*   Configurable security parameters
    

**Chains using LayerZero:**

*   Berachain
    
*   Corn
    
*   Etherlink
    
*   Sonic
    
*   Solana
    
*   Swell
    
*   TAC
    

→ [LayerZero documentationarrow-up-right](https://layerzero.network/)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#ibc-inter-blockchain-communication)

IBC (Inter-Blockchain Communication)

IBC connects Lombard to the Cosmos ecosystem.

**How it works:**

*   Native Cosmos interoperability standard
    
*   Light client verification
    
*   Burn and mint style bridging via IBC v2
    

**Chains using IBC:**

*   Cosmos Hub
    
*   Babylon Genesis
    

→ [IBC documentationarrow-up-right](https://ibcprotocol.org/)

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#native-consortium-bridging)

Native Consortium Bridging

Some chains have direct Consortium and Bascule deployments without relying on third-party bridge infrastructure.

**Chains with native Consortium support:**

*   Ethereum
    
*   Base
    
*   BNB Smart Chain
    
*   Katana
    
*   Monad
    
*   Stable
    
*   Starknet
    
*   Sui
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#supported-chains)

Supported Chains

LBTC is currently available on:

Chain

Bridge Method

Ethereum

Native

Base

CCIP

BNB Smart Chain

CCIP

Berachain

LayerZero

Corn

LayerZero

Etherlink

LayerZero

Katana

Native Consortium

Monad

Native Consortium

Sonic

LayerZero

Solana

LayerZero

Stable

Native Consortium

Starknet

Native Consortium

Sui

Native Consortium

Swell

LayerZero

TAC

LayerZero

Babylon

IBC

BTC.b is available on:

Chain

Bridge Method

Monad

Native Consortium

Stable

Native Consortium

Katana

Native Consortium

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#bridge-transfer-flow)

Bridge Transfer Flow

Here's the complete flow when you bridge LBTC:

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-1-initiate-transfer)

Step 1: Initiate Transfer

You select source chain, destination chain, and amount in the Lombard app. The app prepares a bridge transaction.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-2-burn-on-source)

Step 2: Burn on Source

Your LBTC is burned on the source chain. This transaction is confirmed according to the chain's finality requirements.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-3-bridge-verification)

Step 3: Bridge Verification

The bridge protocol (CCIP or LayerZero) detects the burn and validates the message. Validators confirm the transaction is legitimate.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-4-consortium-verification)

Step 4: Consortium Verification

The Security Consortium independently verifies the burn event. Members check that the amount and destination match.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-5-authorization)

Step 5: Authorization

Both the bridge and Consortium provide signatures authorizing the mint on the destination chain.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#step-6-mint-on-destination)

Step 6: Mint on Destination

LBTC mints to your address on the destination chain. You receive the same amount you burned (minus any bridge fees).

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#timing)

Timing

Transfer time depends on source and destination chain finality requirements. LayerZero transfers are typically faster than CCIP transfers. IBC transfers to Cosmos chains may take longer due to relayer processing.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#fees)

Fees

Bridge transfers incur fees from multiple sources:

**Gas fees:** You pay gas on the source chain to initiate the transfer

**Bridge fees:** CCIP/LayerZero charge fees for cross-chain messaging

**Destination gas:** Covered by bridge fees or paid separately depending on configuration

Lombard does not charge additional protocol fees for bridging.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#security-considerations)

Security Considerations

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#finality)

Finality

Bridges wait for source chain finality before processing. This prevents issues with chain reorganizations.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#rate-limiting)

Rate Limiting

Unusual bridge patterns (like sudden large transfers) may trigger additional verification or delays.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#emergency-pause)

Emergency Pause

Bridge operations can be paused if security issues are detected, protecting funds from ongoing exploits.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#monitoring)

Monitoring

Hexagate provides real-time monitoring of bridge activity, alerting to anomalous patterns.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/bridging-architecture#next-steps)

Next Steps

*   [**Bridge LBTC**](https://docs.lombard.finance/use/bridging)
     — Step-by-step bridging guide
    
*   [**Smart Contracts**](https://docs.lombard.finance/learn/transparency/smart-contracts)
     — Bridge contract addresses
    
*   [**Security Model**](https://docs.lombard.finance/learn/lombard-security-model)
     — How dual verification protects your funds
    

[PreviousSmart Contractschevron-left](https://docs.lombard.finance/learn/transparency/smart-contracts)
[NextRiskschevron-right](https://docs.lombard.finance/learn/transparency/risks)

Last updated 1 month ago

*   [How Bridging Works](https://docs.lombard.finance/learn/transparency/bridging-architecture#how-bridging-works)
    
*   [Dual Verification](https://docs.lombard.finance/learn/transparency/bridging-architecture#dual-verification)
    
*   [Bridge Infrastructure](https://docs.lombard.finance/learn/transparency/bridging-architecture#bridge-infrastructure)
    
*   [Supported Chains](https://docs.lombard.finance/learn/transparency/bridging-architecture#supported-chains)
    
*   [Bridge Transfer Flow](https://docs.lombard.finance/learn/transparency/bridging-architecture#bridge-transfer-flow)
    
*   [Fees](https://docs.lombard.finance/learn/transparency/bridging-architecture#fees)
    
*   [Security Considerations](https://docs.lombard.finance/learn/transparency/bridging-architecture#security-considerations)
    
*   [Next Steps](https://docs.lombard.finance/learn/transparency/bridging-architecture#next-steps)

---

# Oracles & Price Feeds | Lombard Docs

Lombard provides on-chain data feeds that allow anyone to verify protocol health and access accurate pricing information. This page documents the available feeds and their addresses.

* * *

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#protocol-proof-of-reserves)

Protocol Proof of Reserves


---------------------------------------------------------------------------------------------------------------------------------------------

Chainlink provides a feed on Ethereum mainnet: [https://data.chain.link/feeds/ethereum/mainnet/lombard-porarrow-up-right](https://data.chain.link/feeds/ethereum/mainnet/lombard-por)

This value is used by the [Lombard PoR pagearrow-up-right](https://www.lombard.finance/por/)
 and [Dune dashboardsarrow-up-right](https://dune.com/lombard_protocol/reserves)
. It is the amount of Bitcoin that backs all of Lombard's products, i.e. both LBTC and BTC.b.

### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#how-it-works)

How it Works

Chainlink's oracle nodes index all of the Bitcoin addresses that are used underneath Lombard (on the published Base Address List), checks the value of Bitcoin in the addresses, and sums all together. If a majority of Chainlink nodes agree, the value is updated on-chain. Note: small value changes are not updated, the value is updated based on the configured deviation threshold and heartbeat.

### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#base-address-list)

Base Address List

Lombard publishes an [open address listarrow-up-right](https://basescan.org/address/0xe7Ebc588F4EC9297d9867aD75a9b5D86848c8018)
 of all Bitcoin addresses backing Lombard on the Base network (for cost efficiency). The values can be obtained via the public read methods to iterate through the dataset.

Each address can be verified by the address derivation data provided, or an optional attached signature. A complementary library `ts-verifier` is [available on Githubarrow-up-right](https://github.com/lombard-finance/ts-verifier)
 to help.

* * *

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#lbtc-fundamental-price)

LBTC Fundamental Price


-------------------------------------------------------------------------------------------------------------------------------------

Lombard and RedStone publish the Bitcoin value of LBTC. As LBTC gains value against BTC over time, it is therefore backed by an increasing amount of BTC. Lombard publishes the protocol defined ratio value, used for minting and redemption by the protocol.

RedStone's fundamental price feed provides a third-party view of LBTC, comparing Lombard's native BTC reserves that are assigned to LBTC, to the amount of LBTC in circulation. RedStone [publishes the methodologyarrow-up-right](https://docs.redstone.finance/docs/data/lombard/)
 in their documentation.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#contract-addresses)

Contract Addresses

Network

Provider

Contract

EVM (Ethereum, Base, etc)

Lombard

[`0x1De9fcfeDF3E51266c188ee422fbA1c7860DA0`arrow-up-right](https://etherscan.io/address/0x1De9fcfeDF3E51266c188ee422fbA1c7860DA0eF)

Ethereum

RedStone

[`0xb415eAA355D8440ac7eCB602D3fb67ccC1f0bc81`arrow-up-right](https://etherscan.io/address/0xb415eAA355D8440ac7eCB602D3fb67ccC1f0bc81)

BNB Smart Chain

RedStone

[`0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f`arrow-up-right](https://bscscan.com/address/0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f)

Base

RedStone

[`0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f`arrow-up-right](https://basescan.org/address/0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f)

Solana

RedStone

[`REDSTBDUecGjwXd6YGPzHSvEUBHQqVRfCcjUVgPiHsr`arrow-up-right](https://solscan.io/account/REDSTBDUecGjwXd6YGPzHSvEUBHQqVRfCcjUVgPiHsr)

* * *

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#price-feed-oracles)

Price Feed Oracles


-----------------------------------------------------------------------------------------------------------------------------

Price feed oracles provide the LBTC/BTC exchange rate on-chain. This rate increases over time as staking yield accrues.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#why-price-feeds-matter)

Why Price Feeds Matter

Unlike BTC.b which is always 1:1 with BTC, LBTC's value relative to BTC changes. DeFi protocols need accurate exchange rate data to:

*   Price LBTC correctly in lending markets
    
*   Calculate proper collateral values
    
*   Enable accurate swaps and liquidations
    

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#price-feed-contract-addresses)

Price Feed Contract Addresses

Network

Provider

Feed

Contract

Ethereum

Chainlink

LBTC/BTC

[`0x5c29868C58b6e15e2b962943278969Ab6a7D3212`arrow-up-right](https://etherscan.io/address/0x5c29868C58b6e15e2b962943278969Ab6a7D3212)

Ethereum

RedStone

LBTC/BTC

[`0xb415eAA355D8440ac7eCB602D3fb67ccC1f0bc81`arrow-up-right](https://etherscan.io/address/0xb415eAA355D8440ac7eCB602D3fb67ccC1f0bc81)

BNB Smart Chain

RedStone

LBTC/BTC

[`0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f`arrow-up-right](https://bscscan.com/address/0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f)

Base

RedStone

LBTC/BTC

[`0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f`arrow-up-right](https://basescan.org/address/0x5C4c8d6f6Bf79B718F3e8399AaBdFEd01cB7e48f)

Solana

RedStone

LBTC/BTC

[`REDSTBDUecGjwXd6YGPzHSvEUBHQqVRfCcjUVgPiHsr`arrow-up-right](https://solscan.io/account/REDSTBDUecGjwXd6YGPzHSvEUBHQqVRfCcjUVgPiHsr)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#for-integrators)

For Integrators

If you're building a protocol that integrates LBTC:

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#pricing-lbtc)

Pricing LBTC

Always use a price feed rather than assuming 1:1 with BTC. LBTC appreciates against BTC over time, using stale or incorrect pricing will cause issues in lending markets and other DeFi applications.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#choosing-a-provider)

Choosing a Provider

Ethereum has both Chainlink and RedStone feeds available. Choose based on your existing oracle infrastructure and integration requirements.

#### 

[hashtag](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#rate-update-frequency)

Rate Update Frequency

The exchange rate changes gradually as yield accrues. There are no sudden jumps. For most applications, the update frequency of standard oracle feeds is sufficient.

→ [RedStone integration docsarrow-up-right](https://docs.redstone.finance/)

→ [Chainlink integration docsarrow-up-right](https://docs.chain.link/)

[PreviousTransparencychevron-left](https://docs.lombard.finance/learn/transparency)
[NextSmart Contractschevron-right](https://docs.lombard.finance/learn/transparency/smart-contracts)

Last updated 25 days ago

*   [Protocol Proof of Reserves](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#protocol-proof-of-reserves)
    
*   [How it Works](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#how-it-works)
    
*   [Base Address List](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#base-address-list)
    
*   [LBTC Fundamental Price](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#lbtc-fundamental-price)
    
*   [Price Feed Oracles](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#price-feed-oracles)
    
*   [For Integrators](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#for-integrators)

---

# Liquid Bitcoin Foundation | Lombard Docs

The Liquid Bitcoin Foundation is an independent steward of the Lombard Protocol, the infrastructure enabling Bitcoin Capital Markets onchain.

Incorporated in the Cayman Islands as an Exempted Limited Guarantee Foundation Company, the Foundation operates as an independent governance entity dedicated to ensuring Lombard's continuous innovation and supporting the long-term growth of its ecosystem and community.

Through governance, grants, and education, the Foundation plays a central role in strengthening Lombard's infrastructure and advancing the adoption of Bitcoin as capital. This structure reflects a commitment to long-term neutrality and independence, while ensuring the Foundation's resources are directed toward the protocol's sustainable success.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#the-role-of-the-foundation)

The Role of the Foundation

The Liquid Bitcoin Foundation's work is focused on three key areas:

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#permissionless-innovation-with-bitcoin)

Permissionless Innovation with Bitcoin

The Foundation supports the people and projects building the future of Bitcoin Capital Markets onchain. This includes research and development of core protocol features, as well as grants, partnerships, and strategic initiatives that expand what is possible with Bitcoin.

By funding innovation at multiple levels — from core infrastructure to experimental applications — the Foundation ensures Lombard remains at the forefront of Bitcoin DeFi development.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#lombard-ecosystem-growth)

Lombard Ecosystem Growth

The Foundation invests in community education, market research, and targeted programs to expand awareness and understanding of Lombard and its products. By doing so, it aims to encourage responsible adoption across users, developers, and institutions.

This includes educational content, developer documentation, integration support, and community events that bring together ecosystem participants.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#protocol-stewardship)

Protocol Stewardship

As a steward of the Lombard Protocol, the Foundation is committed to proposing effective governance frameworks that protect neutrality, ensure resilience, and increase community participation over time.

This involves developing governance processes, facilitating community discussions, and implementing approved proposals in a transparent and accountable manner.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#reporting)

Reporting

Resources are deployed according to community governance, with regular reporting on:

*   Grant distributions and recipient progress
    
*   Partnership developments and strategic initiatives
    
*   Research projects and technical improvements
    
*   Educational programs and community growth metrics
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#operating-principles)

Operating Principles

**Independence:** The Foundation operates independently from any single entity, ensuring decisions reflect community interests rather than individual agendas.

**Transparency:** All major activities, expenditures, and decisions are publicly documented and regularly reported to the community.

**Neutrality:** The Foundation maintains strict neutrality in ecosystem development, supporting all legitimate projects that advance Lombard's mission.

**Long-term Focus:** Decisions prioritize sustainable growth over short-term gains, building infrastructure that will serve Bitcoin DeFi for decades.

[PreviousToken Economicschevron-left](https://docs.lombard.finance/learn/token-economics)
[NextCommunitychevron-right](https://docs.lombard.finance/learn/community)

Last updated 2 months ago

*   [The Role of the Foundation](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#the-role-of-the-foundation)
    
*   [Reporting](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#reporting)
    
*   [Operating Principles](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation#operating-principles)

---

# Community | Lombard Docs

Lombard grows because of its community. The Luminary Program and social initiatives reward the users who believe in Bitcoin's on-chain future and help build it.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community#the-luminary-lux-program)

The Luminary (Lux) Program

Every action in the Lombard ecosystem counts. Deploy LBTC and BTC.b across eligible DeFi protocols and refer friends. Each contribution earns Lux points that convert to BARD in seasonal airdrops.

The program is designed to reward both early believers and newcomers. Whether you participated in previous seasons or just discovered Lombard, there is a path to meaningful rewards. Season 3 is live now.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community#ways-to-participate)

Ways to Participate

#### 

[hashtag](https://docs.lombard.finance/learn/community#lombard-lux)

Lombard Lux

The core rewards program. Earn Lux by deploying LBTC and BTC.b into eligible DeFi protocols.

Three multiplier tiers: DEX Liquidity at 1x, Lending Collateral at 3x, Bitcoin Earn and Lombard Strategies at 6x.

Season 3 is live with rewards across Ethereum, Solana, Avalanche, MegaETH, and Base.

[Lux Rewardschevron-right](https://docs.lombard.finance/learn/community/lux-rewards)

#### 

[hashtag](https://docs.lombard.finance/learn/community#referral-program)

Referral Program

Your network is valuable. Earn 20% of all Lux generated by users you refer, from both new and existing referred users. They get a 10% boost too.

The referral program continues unchanged in Season 3.

[Referral Programchevron-right](https://docs.lombard.finance/learn/community/referral-program)

#### 

[hashtag](https://docs.lombard.finance/learn/community#kaito-yappers)

Kaito Yappers

The Kaito Yappers program rewarded community content creators on X who drove genuine discussion about Lombard.

The program ran from launch through January 2026 and has concluded.

Final reward claims are available at [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)
.

[Kaito Yapperschevron-right](https://docs.lombard.finance/learn/community/kaito-yappers)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community#at-a-glance)

At a Glance

Program

Your Contribution

Your Reward

Lombard Lux

Deploy LBTC and BTC.b in DeFi

Lux → BARD airdrops

Referral

Onboard new users

20% of their Lux

Kaito

Create quality content

Final claims only

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community#join-in)

Join In

*   [**Rewards Page**arrow-up-right](https://www.lombard.finance/app/rewards/)
     Track your Lux and referrals.
    
*   [Kaito Claimsarrow-up-right](https://kaito.ai/airdrops)
     Claim final Yapper rewards.
    
*   [**Discord**arrow-up-right](https://discord.com/invite/2HG7G69twc)
     Connect with the community.
    
*   [**X (Twitter)**arrow-up-right](https://x.com/lombard_finance)
     Follow for updates.
    
*   [**Telegram**arrow-up-right](https://t.me/+yKL57AkmSg84YTgx)
     Join the discussion.
    

[PreviousLiquid Bitcoin Foundationchevron-left](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation)
[NextLux Rewardschevron-right](https://docs.lombard.finance/learn/community/lux-rewards)

Last updated 12 days ago

*   [The Luminary (Lux) Program](https://docs.lombard.finance/learn/community#the-luminary-lux-program)
    
*   [Ways to Participate](https://docs.lombard.finance/learn/community#ways-to-participate)
    
*   [At a Glance](https://docs.lombard.finance/learn/community#at-a-glance)
    
*   [Join In](https://docs.lombard.finance/learn/community#join-in)

---

# Referral Program | Lombard Docs

Your network has value. When you bring someone into the Lombard ecosystem, both of you benefit, you earn a percentage of their Lux, and they get a boost on everything they do.

The referral program continues unchanged into Season 3 of the Luminary Program.

Referrers earn 20% of all Lux generated by their referred users, including users referred in previous seasons who remain active.

Referred users receive a 10% Lux boost on their own accrual.

Both LBTC and BTC.b DeFi deployment by referred users generates referral commissions.

The Lombard Referral Program lets you earn ongoing Lux commissions by bringing new users into the ecosystem. When someone stakes BTC using your referral link, you receive 20% of all Lux they generate, permanently. The person you refer also benefits with a 10% bonus on their own Lux earnings. These rewards are additive, meaning neither party loses anything by participating.

The program has no caps on referrals or maximum earnings. High-value referrals using DeFi multipliers generate proportionally higher commissions, creating compounding value for active referrers.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#the-deal)

The Deal

**You (Referrer)**

20% of all Lux your referees generate

**Them (Referee)**

10% boost on their own Lux

This is additive, not zero-sum. Your referee doesn't lose anything, they actually earn more than they would without your code. And you earn on top of your normal Lux accrual.

For example, when your referee deploys LBTC into a lending market earning the 3x multiplier, you receive 20% of that boosted Lux. If they deploy into Bitcoin Earn at 6x, you receive 20% of those Lux as well.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#get-your-link)

Get Your Link

Your unique referral link is available in the Lombard app.

1.  Go to lombard.finance/app
    
2.  Connect your wallet
    
3.  Open the Strategies tab
    
4.  Copy your referral link
    

The link format is `lombard.finance/app?ref=YOUR_CODE`. This single link works across all supported chains, you do not need separate links for Ethereum, Base, Solana, or other networks.

Share your referral link through any channel: social media, Discord, Telegram, email, or direct messages. When someone opens the link and connects their wallet, a blue banner confirms the referral connection is active.

The referral link expires after 5 days if the recipient does not complete staking. After expiration, they can use a different referral code. Encourage your referrals to stake promptly to lock in the connection.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#how-it-works)

How It Works

Once someone uses your link:

*   They stake BTC and mint LBTC → you earn 20%
    
*   They deposit into the DeFi Vault → you earn 20%
    
*   They use any whitelisted integration → you earn 20%
    

The connection is permanent. As long as they're active in Lombard, you're earning.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#activation-requirements)

Activation Requirements

Referral relationships activate only when the referee stakes BTC and mints LBTC. Users who only use the swap feature (exchanging other tokens for LBTC on secondary markets) do not count as referrals.

The activation process:

1.  Referee opens your referral link
    
2.  Blue banner confirms referral connection
    
3.  Referee navigates to the Stake tab
    
4.  Referee sends BTC and receives LBTC
    
5.  Referral permanently activates
    

Once activated, the referral relationship persists indefinitely. Your referee cannot switch to a different referrer, and you cannot lose the commission stream.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#referrer-badge-season-2-discontinued)

Referrer Badge (Season 2, Discontinued)

During Season 2, referring 5 users who completed staking unlocked the Lombard Referrer badge for a one-time 500 Lux bonus.

This badge is no longer active in Season 3.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#track-your-impact)

Track Your Impact

The [Rewards Pagearrow-up-right](https://www.lombard.finance/app/rewards/)
 shows:

*   Total referees
    
*   Lux earned from referrals
    
*   Individual referee addresses
    
*   Their activity and your cut
    

If someone starts a transaction but doesn't complete it, they appear with 0 BTC until they finish.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#season-1-note)

Season 1 Note

For Season 1 participants: referral Lux is distributed only at the 6-month claim event, not at TGE. This applied to the March 2026 claim window.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#prohibited-activities)

Prohibited Activities

The referral program prohibits:

*   Creating multiple accounts for additional referral commissions
    
*   Using bots or automated scripts to generate referrals
    
*   Self-referrals through separate wallets
    
*   Selling or transferring referral codes
    
*   Wash trading to inflate commission metrics
    

Lombard monitors for suspicious activity. Violations result in disqualification from rewards and potential exclusion from future seasons.

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#geographic-restrictions)

Geographic Restrictions

U.S. persons and residents of sanctioned jurisdictions cannot participate in the referral program. All wallets undergo AML screening via TRM Labs before claiming rewards.

If you refer someone from a restricted jurisdiction, neither party receives rewards for that referral relationship.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/referral-program#start-referring)

Start Referring

Your link is waiting at [lombard.finance/app/rewardsarrow-up-right](https://www.lombard.finance/app/rewards/)
.

The community is growing. Be part of how it happens. Share your referral link and track signups in the Strategies tab. For questions about Lux mechanics and multipliers, see the Lombard Lux documentation. To maximize your own earnings alongside referral commissions, explore the DeFi integrations available for LBTC.

[PreviousLux Rewardschevron-left](https://docs.lombard.finance/learn/community/lux-rewards)
[NextKaito Yapperschevron-right](https://docs.lombard.finance/learn/community/kaito-yappers)

Last updated 11 days ago

*   [The Deal](https://docs.lombard.finance/learn/community/referral-program#the-deal)
    
*   [Get Your Link](https://docs.lombard.finance/learn/community/referral-program#get-your-link)
    
*   [How It Works](https://docs.lombard.finance/learn/community/referral-program#how-it-works)
    
*   [Activation Requirements](https://docs.lombard.finance/learn/community/referral-program#activation-requirements)
    
*   [Referrer Badge (Season 2, Discontinued)](https://docs.lombard.finance/learn/community/referral-program#referrer-badge-season-2-discontinued)
    
*   [Track Your Impact](https://docs.lombard.finance/learn/community/referral-program#track-your-impact)
    
*   [Season 1 Note](https://docs.lombard.finance/learn/community/referral-program#season-1-note)
    
*   [Prohibited Activities](https://docs.lombard.finance/learn/community/referral-program#prohibited-activities)
    
*   [Geographic Restrictions](https://docs.lombard.finance/learn/community/referral-program#geographic-restrictions)
    
*   [Start Referring](https://docs.lombard.finance/learn/community/referral-program#start-referring)

---

# Use Bitcoin Earn | Lombard Docs

Deposit LBTC or other supported Bitcoin assets into Bitcoin Earn, a professionally managed meta-vault that deploys your capital to experienced risk managers across diversified DeFi strategies. You access DeFi yields without managing positions yourself and can track performance and allocations from the Bitcoin Earn dashboard.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#how-bitcoin-earn-works)

How Bitcoin Earn Works

1.  You deposit LBTC, BTC.b, or native Bitcoin.
    
2.  The vault deploys your capital across DeFi protocols (lending, liquidity, market-neutral strategies).
    
3.  You receive BTCe, a receipt token representing your position.
    
4.  Rewards auto-compound. Your BTCe grows in value over time.
    
5.  Request to withdraw at anytime, and receive funds within 14 days.
    

Bitcoin Earn is managed by professional operators, starting with Sentora. It is powered by Veda infrastructure.

→ [Bitcoin Earn overview](https://docs.lombard.finance/learn/products-overview/yield#bitcoin-earn)

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#rewards)

Rewards

Bitcoin Earn participants receive rewards through the Lux program.

Bitcoin Earn and Lombard Strategies currently earn Lux at the 6x multiplier, the highest tier in Season 3.

Season 3 multiplier tiers for context:

*   DEX Liquidity and Others: 1x
    
*   Lending Collateral: 3x
    
*   Bitcoin Earn and Lombard Strategies: 6x
    

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#bard-streaming-coming-soon)

BARD Streaming (Coming Soon)

During Season 3, Bitcoin Earn will transition from Lux accrual to direct BARD streaming.

When BARD streaming goes live, the Lux multiplier for Bitcoin Earn drops to zero and participants begin receiving BARD distributed directly to their wallets on a continuous basis.

No action is required from participants during the transition.

Further details on timing and mechanics will be announced.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#deposit-to-bitcoin-earn)

Deposit to Bitcoin Earn

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#before-you-start)

Before You Start

*   You need LBTC, BTC.b, or native Bitcoin on the vault's network.
    
*   You need native tokens for gas
    

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#steps)

Steps

1.  Go to [lombard.finance/app/earnarrow-up-right](https://www.lombard.finance/app/earn/)
    .
    
2.  Connect your wallet on your chosen network
    
3.  Choose the asset to deposit (LBTC, BTC.b, or native Bitcoin).
    
4.  Enter the amount.
    
5.  Approve the vault contract (first time only).
    
6.  Confirm the deposit transaction.
    
7.  Receive BTCe in your wallet.
    

Your BTCe balance and accrued rewards appear in the dashboard, updated hourly.

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#import-btce-to-your-wallet)

Import BTCe to Your Wallet

If BTCe does not appear automatically:

Network

Token Address

Ethereum

`0x3a4baaBf4DC9910596821615e848f0e6545762F3`

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#withdraw-from-bitcoin-earn)

Withdraw from Bitcoin Earn

BTCe can only be redeemed for LBTC (regardless of what you deposited).

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#steps-1)

Steps

1.  Go to the Bitcoin Earn dashboard.
    
2.  Select Withdraw.
    
3.  Enter the amount of BTCe to redeem.
    
4.  Confirm the transaction.
    
5.  Wait for processing (up to 14 days).
    
6.  LBTC arrives in your wallet.
    

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#important)

Important

*   You cannot start a new withdrawal while one is pending.
    
*   Keep token approvals enabled during the processing period.
    
*   Some wallets auto-revoke approvals, this will cancel your withdrawal.
    

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#why-withdrawals-get-cancelled)

Why Withdrawals Get Cancelled

Withdrawing is a two-step process:

1.  You sign a message authorizing the vault to process your request.
    
2.  The queue contract fulfills the request after the processing period.
    

If your wallet revokes the approval before processing completes, the withdrawal cancels. Check your wallet's security settings if this happens.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#risks)

Risks

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#smart-contract-risk)

Smart Contract Risk

Vaults interact with multiple DeFi protocols. Each protocol carries its own smart contract risk. Audits reduce but do not eliminate this risk.

**Bitcoin Earn Audit:** [github.com/Se7en-Seas/boring-vault/tree/main/auditarrow-up-right](https://github.com/Se7en-Seas/boring-vault/tree/main/audit)
.

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#strategy-risk)

Strategy Risk

Vault returns depend on underlying DeFi protocol performance. Yields can be lower than expected, and in extreme cases, strategies may result in losses.

#### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#liquidity-risk)

Liquidity Risk

During the withdrawal period (up to 14 days for Bitcoin Earn), you cannot access your funds. Market conditions may change during this time.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-bitcoin-earn#next-steps)

Next Steps

*   [Use LBTC](https://docs.lombard.finance/use/use-lbtc)
     — Get LBTC to deposit into vaults
    
*   [Strategiesarrow-up-right](https://www.lombard.finance/app/dashboard/)
     — Explore individual protocol opportunities
    
*   [Lux Rewardsarrow-up-right](https://www.lombard.finance/app/rewards/)
     — Maximize points while earning yield
    

[PreviousUse BTC.bchevron-left](https://docs.lombard.finance/use/use-btc.b)
[NextUse $BARDchevron-right](https://docs.lombard.finance/use/use-usdbard)

Last updated 1 day ago

*   [How Bitcoin Earn Works](https://docs.lombard.finance/use/use-bitcoin-earn#how-bitcoin-earn-works)
    
*   [Rewards](https://docs.lombard.finance/use/use-bitcoin-earn#rewards)
    
*   [Deposit to Bitcoin Earn](https://docs.lombard.finance/use/use-bitcoin-earn#deposit-to-bitcoin-earn)
    
*   [Withdraw from Bitcoin Earn](https://docs.lombard.finance/use/use-bitcoin-earn#withdraw-from-bitcoin-earn)
    
*   [Risks](https://docs.lombard.finance/use/use-bitcoin-earn#risks)
    
*   [Next Steps](https://docs.lombard.finance/use/use-bitcoin-earn#next-steps)

---

# Token Economics | Lombard Docs

$BARD is the native token of the Lombard Protocol. It's a economic coordination mechanism powering growth, governing the protocol, and enabling access to Lombard's products and infrastructure.

Designed with a generational horizon, $BARD accelerates the development and distribution of Bitcoin infrastructure for decades to come.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#token-overview)

Token Overview

Property

Value

Token Name

BARD

Total Supply

1,000,000,000 (fixed)

Circulating at TGE (Sept 2025)

225,000,000 (22.5%)

Network

Ethereum

Contract Address

[`0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754`arrow-up-right](https://etherscan.io/address/0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#utility)

Utility

BARD serves four core purposes:

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FKSRE7CJvSlAYeUM9dZw9%252FBARD.png%3Falt%3Dmedia%26token%3De9f07aa0-dd9b-4aa5-8a79-e347256c745b&width=768&dpr=3&quality=100&sign=c5307122&sv=2)

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#governance)

Governance

BARD empowers the community to steer Lombard's evolution. Holders will be able to vote on:

*   Security Consortium composition
    
*   Fee structures
    
*   Product roadmap
    
*   Ecosystem grant allocation through the Liquid Bitcoin Foundation
    

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#security)

Security

BARD secures Lombard's core infrastructure. Holders stake BARD to safeguard LBTC and BTC.b cross-chain transfers through a cryptoeconomic guarantee layer built on Chainlink CCIP and Symbiotic infrastructure. This creates a decentralized security layer that scales with protocol adoption.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#ecosystem-development)

Ecosystem Development

Through the Liquid Bitcoin Foundation, BARD holders direct resources that accelerate adoption:

*   Fund ecosystem grants
    
*   Forge commercial partnerships
    
*   Support research and development
    

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#protocol-access)

Protocol Access

BARD provides holders with:

*   Priority access to new products
    
*   Preferred terms
    
*   Enhanced functionality across the ecosystem
    

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#token-distribution)

Token Distribution

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F5UYLdqWtr7GuqhfGsT2K%252FDistribution.png%3Falt%3Dmedia%26token%3D27c7d5ce-ec4e-4672-aaa3-3a5c8e212231&width=768&dpr=3&quality=100&sign=50524cd6&sv=2)

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#summary)

Summary

Category

Allocation

Tokens

Vesting

Ecosystem

35%

350,000,000

Mixed

Core Contributors

25%

250,000,000

48 months, cliff 12 months

Liquid Bitcoin Foundation

20%

200,000,000

4.25% TGE, 3-year linear

Early Investors

20%

200,000,000

48 months, cliff 12 months

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#token-emissions)

Token Emissions:

The total token supply is fixed at 1,000,000,000 $BARD at TGE. At launch, 22.5% (225,000,000 BARD) will enter circulation to reward early users and participants, providing liquid incentives that accelerate near-term ecosystem growth. The remaining supply will unlock gradually over a 48-month period post-TGE, designed to align stakeholders and ensure Lombard’s long-term, sustainable development.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F5NySH4dI7zz1YBWXJtDA%252Fimage.png%3Falt%3Dmedia%26token%3Db482d14d-f8fa-405a-aa81-6a5bbee4fc6b&width=768&dpr=3&quality=100&sign=91f74cec&sv=2)

* * *

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#ecosystem-35)

Ecosystem (35%)

Over one-third of supply is dedicated to community growth and development.

Allocation

%

Tokens

Unlock

**Airdrop Season 1**

4%

40,000,000

1.5% TGE, 1.5% at 6 months, 1% at 12 months

**Ecosystem Activation**

11%

110,000,000

Unlocked immediately

**Community Sale**

1.5%

15,000,000

Fully unlocked at TGE

**Ecosystem Development**

18.5%

185,000,000

4.25% TGE, rest linear 24 months

**Airdrop Season 1:** Early users earned allocation based on LBTC activity. Distribution in three phases over 12 months.

**Ecosystem Activation:** Immediate distribution via incentive programs, including:

*   Airdrop Season 2 (1.5%): 6-month post-TGE Lux program
    
*   Kaito Yappers (0.16%): Year-long Kaito Leaderboard campaign
    

**Community Sale:** Hosted by Buidlpad, raised $6.75 million at $450M FDV from 21,340 verified participants across 132 countries. All allocations fully unlocked at TGE.

**Ecosystem Development:** Fuels growth through commercial partnerships. 4.25% unlocked at TGE, remainder linear over 24 months.

* * *

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#liquid-bitcoin-foundation-20)

Liquid Bitcoin Foundation (20%)

The Foundation serves as steward of the Lombard Protocol, funding research, development, and initiatives.

Allocation

%

Tokens

Unlock

**Foundation**

20%

200,000,000

4.25% TGE (42.5M), 15.75% linear over 3 years

The Foundation retains flexibility to direct unlocked tokens toward ecosystem opportunities, ensuring resources create maximum long-term impact.

→ [Learn about the Liquid Bitcoin Foundation](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation)

* * *

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#early-investors-20)

Early Investors (20%)

Leading investors who backed Lombard's vision and enabled development.

Allocation

%

Tokens

Unlock

**Investors**

20%

200,000,000

48-month lock, linear from 12 months post-TGE

**Lead Investor**

*   Polychain Capital
    

**Institutional Investors**

*   Franklin Templeton
    
*   YZi Labs (formerly Binance Labs)
    
*   BabylonChain, Inc.
    
*   dao5
    
*   Foresight Ventures
    
*   HTX Ventures
    
*   Mirana Ventures
    
*   Mantle EcoFund
    
*   Nomad Capital
    
*   OKX Ventures
    
*   Robot Ventures
    

**Strategic Exchange Partners**

*   Binance
    
*   Bybit
    
*   OKX
    
*   HTX
    
*   Bitget
    

**Angel Investors** Founders and executives from Allora, Altlayer, Babylon, BeraChain, Euler, Gearbox, Manta, MegaEth, Pendle, Ritual, Scroll, StakeStone, Seven Seas, and Zircuit.

* * *

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#core-contributors-25)

Core Contributors (25%)

Incentivizes current and future team members building Bitcoin Capital Markets on-chain.

Allocation

%

Tokens

Unlock

**Contributors**

25%

250,000,000

48-month lock, linear from 12 months post-TGE

Service-based vesting ensures long-term alignment.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#staking)

Staking

Staking BARD contributes to protocol security and earns rewards.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#how-it-works)

How It Works

1.  Deposit BARD into the Mellow vault
    
2.  Receive stBARD (vault share token)
    
3.  stBARD appreciates in value as rewards accrue
    
4.  Redeem stBARD for more BARD than deposited
    

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#what-your-stake-secures)

What Your Stake Secures

BARD staking integrates three layers:

**Mellow Vault**: Holds staked BARD. Issues stBARD.

**Symbiotic Network**: Monitors cross-chain transfers. Enforces slash eligibility.

**Chainlink CCIP**: Validates burns before mints across chains.

When LBTC or BTC.b moves cross-chain, Symbiotic monitors both burn (source) and mint (destination). Mismatches trigger alerts and slash eligibility. This creates the first production system where restaked collateral actively secures cross-chain Bitcoin assets.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#rewards)

Rewards

*   Paid in BARD
    
*   Auto-compound (no claiming needed)
    
*   stBARD exchange rate increases over time
    

Example: 1,000 stBARD at rate 1.00 → rate increases to 1.08 → redeem 1,080 BARD

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#unstaking)

Unstaking

*   21-day withdrawal period
    
*   Funds remain slash-eligible until epoch closes
    
*   Multiple concurrent unstake requests allowed
    
*   Continue earning on staked portion during exit window
    

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#staking-contracts)

Staking Contracts

Contract

Address

BARD

[`0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754`arrow-up-right](https://etherscan.io/address/0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754)

stBARD

[`0x4B266366dc8fF4c0007943a679CBa1fDB845f98D`arrow-up-right](https://etherscan.io/address/0x4B266366dc8fF4c0007943a679CBa1fDB845f98D)

→ [Stake BARDarrow-up-right](https://app.lombard.finance/)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#protocol-revenue)

Protocol Revenue

Lombard captures fees across its product suite:

**LBTC Staking Yield:** Share of yield from operating Finality Providers on Babylon.

**Vault Fees:** Management fees from integrated vaults.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#where-to-get-bard)

Where to Get BARD

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#centralized-exchanges)

Centralized Exchanges

Exchange

Trading Pairs

**Binance**

BARD/USDT, BARD/USDC, BARD/BNB, BARD/FDUSD, BARD/TRY

**OKX**

BARD/USDT

**Coinbase**

BARD/USD

**Upbit**

BARD/KRW, BARD/BTC, BARD/USDT

**Bithumb**

BARD/KRW

**Toobit**

BARD/USDT

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#earn-bard)

Earn BARD

**Staking:** Stake existing BARD to earn more BARD through auto-compounding stBARD.

**Lux Program:** Earn Lux points through LBTC and BTC.b DeFi deployment activities. Lux converts to BARD in seasonal airdrops.

→ [Lux rewards program](https://docs.lombard.finance/learn/community/lux-rewards)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#airdrop-claiming)

Airdrop Claiming

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#season-1)

Season 1

Claim at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)

Phase

Allocation

Timing

Phase 1

1.5%

At TGE

Phase 2

1.5% plus all referral Lux rewards

March 18, 2026 at 09:00 ET

Phase 2: 1.5% of supply plus all referral Lux rewards.

Claimable at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
 starting March 18, 2026 at 09:00 ET.

Referral Lux was excluded from Phase 1 and is distributed exclusively in Phase 2.

#### 

[hashtag](https://docs.lombard.finance/learn/token-economics#season-2)

Season 2

Season 2: 1.5% of supply (15,000,000 BARD) allocated based on Lux earned between September 18, 2025 and March 18, 2026 00:00 UTC.

100% of the Season 2 allocation is claimable starting March 30, 2026 at 09:00 ET at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/token-economics#next-steps)

Next Steps

*   [**Stake BARD**arrow-up-right](https://app.lombard.finance/)
     — Earn rewards and secure the protocol
    
*   [**Liquid Bitcoin Foundation**](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation)
     — Learn about governance
    
*   [**Lux Rewards**](https://docs.lombard.finance/learn/community/lux-rewards)
     — Earn BARD through LBTC activities
    
*   [**Claim Airdrop**arrow-up-right](https://claim.lombard.finance/)
     — Check eligibility
    

[PreviousRiskschevron-left](https://docs.lombard.finance/learn/transparency/risks)
[NextLiquid Bitcoin Foundationchevron-right](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation)

Last updated 12 days ago

*   [Token Overview](https://docs.lombard.finance/learn/token-economics#token-overview)
    
*   [Utility](https://docs.lombard.finance/learn/token-economics#utility)
    
*   [Token Distribution](https://docs.lombard.finance/learn/token-economics#token-distribution)
    
*   [Token Emissions:](https://docs.lombard.finance/learn/token-economics#token-emissions)
    
*   [Staking](https://docs.lombard.finance/learn/token-economics#staking)
    
*   [Protocol Revenue](https://docs.lombard.finance/learn/token-economics#protocol-revenue)
    
*   [Where to Get BARD](https://docs.lombard.finance/learn/token-economics#where-to-get-bard)
    
*   [Airdrop Claiming](https://docs.lombard.finance/learn/token-economics#airdrop-claiming)
    
*   [Next Steps](https://docs.lombard.finance/learn/token-economics#next-steps)

---

# Understanding Yield | Lombard Docs

Your LBTC earns Bitcoin yield automatically. There is nothing to claim, the value of your LBTC in BTC terms increases over time.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#how-it-works)

How It Works

LBTC yield comes from Bitcoin staking on Babylon. Here is the flow:

1.  **Lombard stakes your BTC** with Finality Providers on Babylon
    
2.  **Babylon rewards stakers** in BABY tokens for securing the network
    
3.  **Lombard sells BABY for BTC** and adds it to the reserve
    
4.  **The LBTC/BTC exchange rate increases** to reflect the additional BTC
    

You do not need to do anything. Your LBTC automatically represents more BTC as yield accrues.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#exchange-rate)

Exchange Rate

When LBTC launched, 1 LBTC = 1 BTC. As yield accumulates, the exchange rate increases:

Date

Exchange Rate

1 LBTC Worth

Launch

1.0000

1.0000 BTC

+30 days

1.0007

1.0007 BTC

+1 year

1.0081

1.0081 BTC

_Example based on ~0.81% APY. Actual rates vary._

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#what-this-means-for-you)

What This Means for You

**When you stake:** You receive slightly less than 1 LBTC per BTC deposited (because LBTC is already worth more than 1 BTC).

**When you unstake:** You receive the full BTC value of your LBTC at the current exchange rate.

**Example:** If you deposit 1 BTC when the rate is 1.0050, you receive ~0.9950 LBTC. If you unstake when the rate is 1.0100, you receive ~1.0050 BTC (a gain of 0.0050 BTC).

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#current-apy)

Current APY

The yield rate depends on Babylon staking rewards, which fluctuate based on:

*   Total BTC staked across Babylon
    
*   Number of Bitcoin Secured Networks (BSNs) being secured
    
*   BABY token price when sold for BTC
    

Check the current 14-day trailing APY at [lombard.financearrow-up-right](https://www.lombard.finance/)
.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#yield-distribution-timeline)

Yield Distribution Timeline

Date

Event

Before July 22, 2025

Users claimed BABY manually from the Lombard app

July 22, 2025

LBTC became yield-bearing; all yield now auto-compounds

Ongoing

BABY rewards sold for BTC, exchange rate updated periodically

Any BABY you did not claim before July 22, 2025 was redistributed to LBTC holders automatically.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#comparing-yield-sources)

Comparing Yield Sources

Source

How You Earn

Action Required

Babylon staking

Exchange rate increases

None

DeFi protocols

Protocol rewards (varies)

Deposit LBTC into vaults/pools

Lombard Lux

Lux points for rewards

Hold LBTC, complete campaigns

You can stack these, LBTC earns Babylon yield while deposited in DeFi protocols.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#frequently-asked-questions)

Frequently Asked Questions

**Do I need to claim yield?** No. Yield is reflected in the LBTC/BTC exchange rate automatically.

**Is yield paid in LBTC or BTC?** Neither directly. The exchange rate increases, so your existing LBTC becomes redeemable for more BTC.

**Does yield compound?** Yes. As the exchange rate increases, your LBTC is worth more BTC, which continues earning yield.

**What if I buy LBTC on a DEX instead of staking?** You earn the same yield. All LBTC is fungible. It does not matter how you acquired it.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/understanding-yield#next-steps)

Next Steps

*   [Fees](https://docs.lombard.finance/use/use-lbtc/fees)
     — What fees apply to your yield
    
*   [Access DeFi](https://docs.lombard.finance/use/access-defi)
     — Earn additional yield in DeFi protocols
    

[PreviousUse LBTCchevron-left](https://docs.lombard.finance/use/use-lbtc)
[NextFeeschevron-right](https://docs.lombard.finance/use/use-lbtc/fees)

Last updated 1 month ago

*   [How It Works](https://docs.lombard.finance/use/use-lbtc/understanding-yield#how-it-works)
    
*   [Exchange Rate](https://docs.lombard.finance/use/use-lbtc/understanding-yield#exchange-rate)
    
*   [Current APY](https://docs.lombard.finance/use/use-lbtc/understanding-yield#current-apy)
    
*   [Yield Distribution Timeline](https://docs.lombard.finance/use/use-lbtc/understanding-yield#yield-distribution-timeline)
    
*   [Comparing Yield Sources](https://docs.lombard.finance/use/use-lbtc/understanding-yield#comparing-yield-sources)
    
*   [Frequently Asked Questions](https://docs.lombard.finance/use/use-lbtc/understanding-yield#frequently-asked-questions)
    
*   [Next Steps](https://docs.lombard.finance/use/use-lbtc/understanding-yield#next-steps)

---

# Use LBTC | Lombard Docs

Earn yield on your Bitcoin while keeping it liquid for DeFi. LBTC is a yield-bearing token that represents BTC staked through Babylon, you hold LBTC, and its value in BTC grows automatically over time.

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#what-you-get)

What You Get

When you stake BTC with Lombard, you receive LBTC on your chosen blockchain. Your LBTC:

*   Earns Babylon staking yield automatically
    
*   Works across 15+ chains including Ethereum, Base, Arbitrum, Solana, and Sui
    
*   Can be used as collateral, traded, or deposited into DeFi protocols
    
*   Is redeemable for native BTC at any time (9-day withdrawal period)
    

The exchange rate between LBTC and BTC increases as yield accrues. When you unstake, you receive more BTC than you originally deposited.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#stake-btc)

Stake BTC

You can stake from any Bitcoin wallet, including hardware wallets, DeFi wallets, or exchanges that allow BTC withdrawals.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#before-you-start)

Before You Start

*   You need native BTC in a wallet that can send to SegWit addresses
    
*   Choose which chain you want to receive LBTC on (Ethereum, Base, Arbitrum, etc.)
    
*   Have a wallet address ready on your destination chain
    

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#steps)

Steps

1.  Go to [lombard.finance/app/stakearrow-up-right](https://www.lombard.finance/app/stake/)
    
2.  Connect your destination wallet (top right shows the chain and address where you will receive LBTC)
    
3.  Select **Get LBTC on \[chain\]** or connect a Bitcoin wallet directly
    
4.  Lombard generates a unique deposit address tied to your destination
    
5.  Send BTC to that address
    
6.  Wait for 6 Bitcoin confirmations (typically 40–60 minutes)
    
7.  LBTC mints automatically to your destination address
    

> **Note:** If you mint on Ethereum, a small amount of LBTC is deducted to cover gas costs. Other chains have no minting fee. See [Fees](https://docs.lombard.finance/use/use-lbtc/fees#minting-fee)
>  for details.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#if-auto-mint-is-disabled)

If Auto-Mint is Disabled

During high gas periods, auto-mint pauses to protect you from fees. You can always mint manually:

1.  Go to [lombard.finance/app/activityarrow-up-right](https://www.lombard.finance/app/activity/)
    
2.  Find your pending deposit
    
3.  Click **Mint** and confirm the transaction
    

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#minimum-deposit)

Minimum Deposit

Each deposit must meet the minimum threshold displayed in the app. The minimum is approximately `0.0002 BTC`, but check the app for the current threshold. Deposits below this amount are not processed.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#unstake-lbtc)

Unstake LBTC

You can withdraw your BTC at any time. The process takes 9 days due to Babylon's 7-day unbonding period plus Lombard's daily rebalancing cycle.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#before-you-start-1)

Before You Start

*   You need LBTC on any supported chain
    
*   Have a Bitcoin address ready (Native SegWit or Taproot only)
    

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#supported-bitcoin-addresses)

Supported Bitcoin Addresses

Prefix

Type

Supported

`bc1q`

Native SegWit (P2WPKH, P2WSH)

Yes

`bc1p`

Taproot (P2TR)

Yes

`1...`

Legacy (P2PKH)

No

`3...`

Nested SegWit (P2SH)

No

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#steps-1)

Steps

1.  Go to [lombard.finance/app/unstakearrow-up-right](https://www.lombard.finance/app/unstake/)
    
2.  Verify the correct network is selected (top right)
    
3.  Enter the amount of LBTC to unstake
    
4.  Enter your Bitcoin withdrawal address
    
5.  Confirm the transaction
    
6.  Wait 9 days for BTC to arrive
    

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#minimum-unstake)

Minimum Unstake

The minimum unstake amount is **0.00013300 LBTC** (includes the 0.0001 LBTC network security fee).

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#can-i-speed-this-up)

Can I Speed This Up?

No. The 9-day period is a security requirement from Babylon's staking protocol. Your staked BTC secures the network during this time.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#risks)

Risks

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#slashing-risk)

Slashing Risk

This risk applies to LBTC only. BTC.b is not staked through Babylon.

If validators misbehave, a portion of staked BTC can be slashed. Lombard works only with reputable Finality Providers who implement anti-slashing measures. Current slashing risk exposure is 0.1%.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#depeg-risk)

Depeg Risk

LBTC trades on secondary markets where prices can deviate from the redemption value. During the 9-day unstaking period, you cannot exit instantly. However, you can always redeem at the protocol rate through the Lombard app.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#technical-risk)

Technical Risk

Smart contract bugs or network attacks could affect funds. Lombard has been audited by OpenZeppelin, Veridise, and others. Real-time threat monitoring is active.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc#next-steps)

Next Steps

*   [Understanding Yield](https://docs.lombard.finance/use/use-lbtc/understanding-yield)
     — How LBTC yield works
    
*   [Fees](https://docs.lombard.finance/use/use-lbtc/fees)
     — Complete fee breakdown
    
*   [Access DeFi](https://docs.lombard.finance/use/access-defi)
     — Use your LBTC across protocols
    

[PreviousKaito Yapperschevron-left](https://docs.lombard.finance/learn/community/kaito-yappers)
[NextUnderstanding Yieldchevron-right](https://docs.lombard.finance/use/use-lbtc/understanding-yield)

Last updated 4 days ago

*   [What You Get](https://docs.lombard.finance/use/use-lbtc#what-you-get)
    
*   [Stake BTC](https://docs.lombard.finance/use/use-lbtc#stake-btc)
    
*   [Unstake LBTC](https://docs.lombard.finance/use/use-lbtc#unstake-lbtc)
    
*   [Risks](https://docs.lombard.finance/use/use-lbtc#risks)
    
*   [Next Steps](https://docs.lombard.finance/use/use-lbtc#next-steps)

---

# Access DeFi | Lombard Docs

Lombard maintains a Strategies section for DeFi opportunities where you can deploy your Lombard Assets. When you use LBTC or BTC.b in participating protocols, you earn Lux points that convert to $BARD.

* * *

### 

[hashtag](https://docs.lombard.finance/use/access-defi#strategies)

Strategies

Browse opportunities at [lombard.finance/apparrow-up-right](https://www.lombard.finance/app/)
 under Strategies.

The Strategies section shows:

*   Available protocols and chains
    
*   Current APY (reported by each protocol)
    
*   TVL and other relevant data
    

Each protocol in the Strategies section displays its current Lux multiplier.

Filter by chain, category, or protocol to find what you are looking for.

* * *

### 

[hashtag](https://docs.lombard.finance/use/access-defi#earn-usdbard)

Earn $BARD

When you deploy LBTC or BTC.b into whitelisted DeFi protocols, you earn Lux points. Lux converts to $BARD in seasonal airdrops.

In Season 3, passive holding of LBTC or BTC.b does not earn Lux. Only active DeFi deployment qualifies.

#### 

[hashtag](https://docs.lombard.finance/use/access-defi#season-3-multiplier-tiers)

Season 3 Multiplier Tiers

Category

Multiplier

Protocols

DEX Liquidity and Others (e.g. restaking)

1x

Uniswap, Curve, Fluid, Aerodrome, Meteora, Etherfi

Lending Collateral

3x

Aave v3/4, Morpho, Spark, Fluid, Euler, Juplend, Kamino

Bitcoin Earn and Lombard Strategies

6x

Bitcoin Earn, Lombard vaults

Eligible chains: Ethereum, Solana, Avalanche, MegaETH, Base.

Multipliers are adjusted actively during the season. The Strategies section at [lombard.finance/apparrow-up-right](https://www.lombard.finance/app)
 displays live multiplier rates for each opportunity. Additional protocols and chains are expected during the season.

Both LBTC and BTC.b deployments qualify across all tiers. Lux accrues automatically. No registration required.

Bitcoin Earn and Lombard Strategies currently earn Lux at 6x. During Season 3, these products will transition to direct BARD streaming, where BARD is distributed to vault participants continuously. When BARD streaming goes live, the Lux multiplier for these vaults drops to zero.

→ [Lux Program details](https://docs.lombard.finance/learn/community/lux-rewards)

* * *

### 

[hashtag](https://docs.lombard.finance/use/access-defi#important)

Important

Lombard does not endorse, recommend, or guarantee any specific protocol or opportunity listed in the Strategies section.

Each DeFi protocol carries its own risks including smart contract risk, liquidation risk, and economic risk. Do your own research before depositing funds anywhere.

Lombard is not providing financial advice.

* * *

### 

[hashtag](https://docs.lombard.finance/use/access-defi#next-steps)

Next Steps

*   [Bitcoin Earn](https://docs.lombard.finance/use/use-bitcoin-earn)
     — Automated yield strategies
    
*   [Bridging](https://docs.lombard.finance/use/bridging)
     — Move LBTC to other chains
    
*   [Troubleshooting](https://docs.lombard.finance/use/troubleshooting)
     — Get help
    

[PreviousBridgingchevron-left](https://docs.lombard.finance/use/bridging)
[NextFAQchevron-right](https://docs.lombard.finance/use/faq)

Last updated 11 days ago

*   [Strategies](https://docs.lombard.finance/use/access-defi#strategies)
    
*   [Earn $BARD](https://docs.lombard.finance/use/access-defi#earn-usdbard)
    
*   [Important](https://docs.lombard.finance/use/access-defi#important)
    
*   [Next Steps](https://docs.lombard.finance/use/access-defi#next-steps)

---

# Smart Contracts | Lombard Docs

This page lists all official Lombard smart contract addresses across supported chains. Always verify you're interacting with these addresses, do not trust links from unofficial sources.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#how-to-verify)

How to Verify

Before interacting with any contract:

1.  **Check this page** for the official address
    
2.  **Verify on the block explorer** that the contract is verified and matches the address here
    
3.  **Bookmark the official app** at [app.lombard.financearrow-up-right](https://app.lombard.finance/)
    . Don't use links from search results or messages.
    

If an address doesn't match what's listed here, do not interact with it.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#contract-types)

Contract Types

There are three types of contracts deployed on networks where LBTC is supported:

**LBTC/BTC.b token contracts:** Mint and burn tokens.

**Consortium's governance contract:** Reads and commits state changes related to LBTC, ensuring all actions are transparent and verifiable on-chain.

**Proxy upgrade timelock contract:** Delays proxy upgrades by one hour, providing additional security to detect and cancel malicious upgrades.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#ethereum)

Ethereum

Component

Address

LBTC ERC-20

[`0x8236a87084f8B84306f72007F36F2618A5634494`arrow-up-right](https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494)

LBTCv ERC-20

[`0x5401b8620E5FB570064CA9114fd1e135fd77D57c`arrow-up-right](https://etherscan.io/address/0x5401b8620E5FB570064CA9114fd1e135fd77D57c)

BTC.b ERC-20

[`0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072`arrow-up-right](https://etherscan.io/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072)

BTCe ERC-20

[`0x3a4baaBf4DC9910596821615e848f0e6545762F3`arrow-up-right](https://etherscan.io/address/0x3a4baaBf4DC9910596821615e848f0e6545762F3)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://etherscan.io/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0x055E84e7FE8955E2781010B866f10Ef6E1E77e59`arrow-up-right](https://etherscan.io/address/0x055E84e7FE8955E2781010B866f10Ef6E1E77e59)

Bascule Drawbridge

[`0xc750eCAC7250E0D18ecE2C7a5F130E3A765dc260`arrow-up-right](https://etherscan.io/address/0xc750eCAC7250E0D18ecE2C7a5F130E3A765dc260)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#base)

Base

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://basescan.org/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

LBTCv ERC-20

[`0x5401b8620E5FB570064CA9114fd1e135fd77D57c`arrow-up-right](https://basescan.org/address/0x5401b8620E5FB570064CA9114fd1e135fd77D57c)

BTCe ERC-20

[`0x3a4baaBf4DC9910596821615e848f0e6545762F3`arrow-up-right](https://basescan.org/address/0x3a4baaBf4DC9910596821615e848f0e6545762F3)

Consortium's Governance

[`0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://basescan.org/address/0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xf1fc1bE000Db6fa2193aB75E461a5603400d031F`arrow-up-right](https://basescan.org/address/0xf1fc1bE000Db6fa2193aB75E461a5603400d031F)

Bascule Drawbridge

[`0x937ae3923eF063BE92816F48c9364Dd38AF169dA`arrow-up-right](https://basescan.org/address/0x937ae3923eF063BE92816F48c9364Dd38AF169dA)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#avalanche)

Avalanche

Component

Address

BTC.b ERC-20

[`0x152b9d0fdc40c096757f570a51e494bd4b943e50`arrow-up-right](https://snowtrace.io/address/0x152b9d0fdc40c096757f570a51e494bd4b943e50)

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://snowtrace.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

Consortium's Governance

[`0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://snowtrace.io/address/0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xE4B5166b1D60C2208A934176522461c470A37d56`arrow-up-right](https://snowtrace.io/address/0xE4B5166b1D60C2208A934176522461c470A37d56)

Bascule Drawbridge

[`0x10fa7a47B65D5B631Eed401Ec6780337a13223aD`arrow-up-right](https://snowtrace.io/address/0x10fa7a47B65D5B631Eed401Ec6780337a13223aD)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#bnb-smart-chain)

BNB Smart Chain

Component

Address

LBTC BEP-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://bscscan.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

LBTCv BEP-20

[`0x5401b8620E5FB570064CA9114fd1e135fd77D57c`arrow-up-right](https://bscscan.com/address/0x5401b8620E5FB570064CA9114fd1e135fd77D57c)

BTCe BEP-20

[`0x3a4baaBf4DC9910596821615e848f0e6545762F3`arrow-up-right](https://bscscan.com/address/0x3a4baaBf4DC9910596821615e848f0e6545762F3)

Consortium's Governance

[`0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://bscscan.com/address/0xdad58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0x055E84e7FE8955E2781010B866f10Ef6E1E77e59`arrow-up-right](https://bscscan.com/address/0x055E84e7FE8955E2781010B866f10Ef6E1E77e59)

Bascule Drawbridge

[`0x93D0a45766413517E4F122F0ee73254357DF0Fa1`arrow-up-right](https://bscscan.com/address/0x93D0a45766413517E4F122F0ee73254357DF0Fa1)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#berachain)

Berachain

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://beratrail.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://beratrail.io/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0x74b8900853Ca8Dd03766b1ea5cA338692176Ed8C`arrow-up-right](https://beratrail.io/address/0x74b8900853Ca8Dd03766b1ea5cA338692176Ed8C)

OFT Adapter

[`0x630e12D53D4E041b8C5451aD035Ea841E08391d7`arrow-up-right](https://beratrail.io/address/0x630e12D53D4E041b8C5451aD035Ea841E08391d7)

OFT Adapter (Eth)

[`0x1290A6b480f7eF14925229fdB66f5680aD8F44AD`arrow-up-right](https://etherscan.io/address/0x1290A6b480f7eF14925229fdB66f5680aD8F44AD)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#corn)

Corn

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://cornscan.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

OFT Adapter

[`0xfc7B20D9B59A8A466f4fC3d34aA69a7D98e71d7A`arrow-up-right](https://cornscan.io/address/0xfc7B20D9B59A8A466f4fC3d34aA69a7D98e71d7A)

OFT Adapter (Eth)

[`0x6bc15D7930839Ec18A57F6f7dF72aE1B439D077f`arrow-up-right](https://etherscan.io/address/0x6bc15D7930839Ec18A57F6f7dF72aE1B439D077f)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#etherlink)

Etherlink

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://explorer.etherlink.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://explorer.etherlink.com/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xC409f4a25065e64eA754dDa4fA8c3Ea6544fcF2F`arrow-up-right](https://explorer.etherlink.com/address/0xC409f4a25065e64eA754dDa4fA8c3Ea6544fcF2F)

OFT Adapter

[`0xC832183d4d5fc5831daaC892a93dBBfd798034E3`arrow-up-right](https://explorer.etherlink.com/address/0xC832183d4d5fc5831daaC892a93dBBfd798034E3)

OFT Adapter (Eth)

[`0x3a7647c1323144a16e7D0D71A581E3FE5BD95299`arrow-up-right](https://etherscan.io/address/0x3a7647c1323144a16e7D0D71A581E3FE5BD95299)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#katana)

Katana

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://katanascan.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

BTC.b ERC-20

[`0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072`arrow-up-right](https://katanascan.com/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://katanascan.com/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xA3592338CAF2DaF907044425fe4c78a051f0a6ba`arrow-up-right](https://katanascan.com/address/0xA3592338CAF2DaF907044425fe4c78a051f0a6ba)

Bascule Drawbridge

[`0x723c1c3AE8e062e93d03989CFdaf9Cb1424D2d05`arrow-up-right](https://katanascan.com/address/0x723c1c3AE8e062e93d03989CFdaf9Cb1424D2d05)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#megaeth)

MegaETH

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://mega.etherscan.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

BTC.b ERC-20

[`0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072`arrow-up-right](https://mega.etherscan.io/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://mega.etherscan.io/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0x74b8900853Ca8Dd03766b1ea5cA338692176Ed8C`arrow-up-right](https://mega.etherscan.io/address/0x74b8900853Ca8Dd03766b1ea5cA338692176Ed8C)

Bascule Drawbridge

[`0x8Bbc480999277bCAbF5861C59BCEbFA54956117a`arrow-up-right](https://mega.etherscan.io/address/0x8Bbc480999277bCAbF5861C59BCEbFA54956117a)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#monad)

Monad

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://monad.socialscan.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

Native BTC.b

[`0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072`arrow-up-right](https://monad.socialscan.io/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://monad.socialscan.io/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0x4CBD8802465F690e7637454783955fA8E6D0c4bc`arrow-up-right](https://monad.socialscan.io/address/0x4CBD8802465F690e7637454783955fA8E6D0c4bc)

Bascule Drawbridge

[`0xb54Bd5467b204093b187cF10866d3c482eAe5B24`arrow-up-right](https://monad.socialscan.io/address/0xb54Bd5467b204093b187cF10866d3c482eAe5B24)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#stable)

Stable

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://stablescan.xyz/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

BTC.b ERC-20

[`0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072`arrow-up-right](https://stablescan.xyz/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://stablescan.xyz/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xA33dD02dB71248e383A615C9A11410Cf049aE99B`arrow-up-right](https://stablescan.xyz/address/0xA33dD02dB71248e383A615C9A11410Cf049aE99B)

Bascule Drawbridge

[`0xA27D109aE05e74Ff9900eFfDa983f6046ebe4dB0`arrow-up-right](https://stablescan.xyz/address/0xA27D109aE05e74Ff9900eFfDa983f6046ebe4dB0)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#sonic)

Sonic

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://sonicscan.org/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

OFT Adapter

[`0x630e12D53D4E041b8C5451aD035Ea841E08391d7`arrow-up-right](https://sonicscan.org/address/0x630e12D53D4E041b8C5451aD035Ea841E08391d7)

OFT Adapter (Eth)

[`0xcFEAc622BC6464acC759ACd9741a6D78F8b0d3Cd`arrow-up-right](https://etherscan.io/address/0xcFEAc622BC6464acC759ACd9741a6D78F8b0d3Cd)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://sonicscan.org/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

Proxy Upgrade Timelock

[`0xD2171aebB4c923530d5E04FbA1680d8B782128a4`arrow-up-right](https://sonicscan.org/address/0xD2171aebB4c923530d5E04FbA1680d8B782128a4)

Bascule Drawbridge

[`0x4515755A7E22411AF547815a856ac7f16d85dD5C`arrow-up-right](https://sonicscan.org/address/0x4515755A7E22411AF547815a856ac7f16d85dD5C)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#solana)

Solana

Component

Address

LBTC Token

[`LBTCgU4b3wsFKsPwBn1rRZDx5DoFutM6RPiEt1TPDsY`arrow-up-right](https://solscan.io/token/LBTCgU4b3wsFKsPwBn1rRZDx5DoFutM6RPiEt1TPDsY)

LBTC Token Authority

[`EGhKeCZ1xgaxmkigfeZLRPCARaFsJzBeVWcSKGvQJcXq`arrow-up-right](https://solscan.io/account/EGhKeCZ1xgaxmkigfeZLRPCARaFsJzBeVWcSKGvQJcXq)

LBTC Program

[`LomP48F7bLbKyMRHHsDVt7wuHaUQvQnVVspjcbfuAek`arrow-up-right](https://solscan.io/account/LomP48F7bLbKyMRHHsDVt7wuHaUQvQnVVspjcbfuAek)

LBTC Config

[`5Ls2ezQpvUmthZqqtUftTbfehWaDM7EDqrcTq9esiMr1`arrow-up-right](https://solscan.io/account/5Ls2ezQpvUmthZqqtUftTbfehWaDM7EDqrcTq9esiMr1)

OFT Adapter

[`7QkBVz37mjevzKYJDcVy6xKDG1hUewWgj51Dehgcu5sM`arrow-up-right](https://solscan.io/account/7QkBVz37mjevzKYJDcVy6xKDG1hUewWgj51Dehgcu5sM)

OFT Adapter (Eth)

[`0xacB11Bc20B1945e59976e3307d2a805Faa126C31`arrow-up-right](https://etherscan.io/address/0xacB11Bc20B1945e59976e3307d2a805Faa126C31)

Bascule

[`E1p8P6TTe8QvKmSK7QZ3n7HtQY9hE1p9JrCwLrXnPUfn`arrow-up-right](https://solscan.io/account/E1p8P6TTe8QvKmSK7QZ3n7HtQY9hE1p9JrCwLrXnPUfn)

Admin

[`HzCyQqcAoxAHeqHAWH1RQbfw7GNUzinqSWideGj7ZtEE`arrow-up-right](https://solscan.io/account/HzCyQqcAoxAHeqHAWH1RQbfw7GNUzinqSWideGj7ZtEE)

Treasury

[`4qKkExZ4T5yyVumc4qoTzoa8fwmhpDy2Zg9ZUoNwzSP9`arrow-up-right](https://solscan.io/account/4qKkExZ4T5yyVumc4qoTzoa8fwmhpDy2Zg9ZUoNwzSP9)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#starknet)

Starknet

Component

Address

LBTC ERC-20

[`0x036834a40984312f7f7de8d31e3f6305b325389eaeea5b1c0664b2fb936461a4`arrow-up-right](https://starkscan.co/contract/0x036834a40984312f7f7de8d31e3f6305b325389eaeea5b1c0664b2fb936461a4)

Consortium's Governance

[`0x01a1d1983178fc0a4af35efafa9945e76aa71b5391261cd766a87310f2d19a81`arrow-up-right](https://starkscan.co/contract/0x01a1d1983178fc0a4af35efafa9945e76aa71b5391261cd766a87310f2d19a81)

Bascule Drawbridge

[`0x76b68231c1bddb7c981c5a19d9c6a28c5cb14161b8fcd3a857aa8a396d31f95`arrow-up-right](https://starkscan.co/contract/0x76b68231c1bddb7c981c5a19d9c6a28c5cb14161b8fcd3a857aa8a396d31f95)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#sui)

Sui

Component

Address

LBTC Coin

[`0x3e8e9423d80e1774a7ca128fccd8bf5f1f7753be658c5e645929037f7c819040`arrow-up-right](https://suiscan.xyz/mainnet/object/0x3e8e9423d80e1774a7ca128fccd8bf5f1f7753be658c5e645929037f7c819040)

LBTC Package

[`0x818430a456ff977f7320f78650d19801f90758d200a01dd3c2c679472c521357`arrow-up-right](https://suiscan.xyz/mainnet/object/0x818430a456ff977f7320f78650d19801f90758d200a01dd3c2c679472c521357)

Consortium Package

[`0x2af188f9cc293640ced68e89a4c5773ee84702df3f10bcd080ccb894116398c3`arrow-up-right](https://suiscan.xyz/mainnet/object/0x2af188f9cc293640ced68e89a4c5773ee84702df3f10bcd080ccb894116398c3)

Bascule Package

[`0xff2c46f430582f4ea1842e584e7e6f99719d258c886b704509e65bc95c16e61b`arrow-up-right](https://suiscan.xyz/mainnet/object/0xff2c46f430582f4ea1842e584e7e6f99719d258c886b704509e65bc95c16e61b)

Control Treasury

[`0x1adadbca040f368abd554ac55e7c216ea6df2ff891fc647f037d66669661584a`arrow-up-right](https://suiscan.xyz/mainnet/object/0x1adadbca040f368abd554ac55e7c216ea6df2ff891fc647f037d66669661584a)

Consortium Object

[`0x9f68fe752d0879d615415e39207f0363a6fc8e0b3b335e976f5f18b31f55faf3`arrow-up-right](https://suiscan.xyz/mainnet/object/0x9f68fe752d0879d615415e39207f0363a6fc8e0b3b335e976f5f18b31f55faf3)

Bascule Object

[`0x138938cb496cf0900be970dde1407d86497b8c69182cb5aa22dc4767c92bedcc`arrow-up-right](https://suiscan.xyz/mainnet/object/0x138938cb496cf0900be970dde1407d86497b8c69182cb5aa22dc4767c92bedcc)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#swell)

Swell

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://explorer.swellnetwork.io/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

OFT Adapter

[`0x7B3784AD646C10A8Ddf42b47a4f4bd9aFD351E54`arrow-up-right](https://explorer.swellnetwork.io/address/0x7B3784AD646C10A8Ddf42b47a4f4bd9aFD351E54)

OFT Adapter (Eth)

[`0x37E92d760a15231e652a2C502182a6b44c7510c0`arrow-up-right](https://etherscan.io/address/0x37E92d760a15231e652a2C502182a6b44c7510c0)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#tac)

TAC

Component

Address

LBTC ERC-20

[`0xecAc9C5F704e954931349Da37F60E39f515c11c1`arrow-up-right](https://explorer.tac.build/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1)

Consortium's Governance

[`0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4`arrow-up-right](https://explorer.tac.build/address/0xdAD58DfA5c1a7a34419AFdBE1f0d610efeea95E4)

OFT Adapter

[`0x1298131cDa718bBcA7ACB1f2411e71c05E16f269`arrow-up-right](https://explorer.tac.build/address/0x1298131cDa718bBcA7ACB1f2411e71c05E16f269)

OFT Adapter (Eth)

[`0xA7c4d94F98b6e94C139c4645e4E9a94CD7C0Abf7`arrow-up-right](https://etherscan.io/address/0xA7c4d94F98b6e94C139c4645e4E9a94CD7C0Abf7)

Proxy Upgrade Timelock

[`0xd24658051aa6c8ACf874F686D5dA325a87d2D146`arrow-up-right](https://explorer.tac.build/address/0xd24658051aa6c8ACf874F686D5dA325a87d2D146)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#babylon-ibc)

Babylon (IBC)

LBTC is bridged from Ethereum to Cosmos through IBC v2 and distributed via the Cosmos Hub to Babylon Genesis through IBC.

Component

Identifier

LBTC ICS-20 on Cosmos Hub

`ibc/DBD9E339E1B093A052D76BECFFDE8435EAC114CF2133346B4D691F3F2068C957`

LBTC ICS-20 on Babylon Genesis

`ibc/89EE10FCF78800B572BAAC7080AEFA301B5F3BBC51C5371E907EB129C5B900E7`

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#audits)

Audits

All contracts have been audited by multiple independent security firms:

*   **OpenZeppelin:** Consortium and V2 Release.
    
*   **Halborn:** Smart contracts, Consortium, FBTC integration, and V2 Release.
    
*   **Veridise:** Smart contracts, BTCB PMM, and V2 Release.
    
*   **Cantina:** Security review.
    
*   **Sherlock:** Contest audit.
    

Audit reports are available here: → [View audit reportsarrow-up-right](https://github.com/lombard-finance/evm-smart-contracts/tree/main/docs/audit)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#bug-bounty)

Bug Bounty

Found a vulnerability? Report it through our bug bounty program for rewards up to **$250,000**.

→ [Bug bounty on Immunefiarrow-up-right](https://immunefi.com/bounty/lombard/)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/transparency/smart-contracts#report-scams)

Report Scams

Found a scam contract impersonating Lombard? Report it to our team.

→ [Report scam on Discordarrow-up-right](https://discord.com/invite/2HG7G69twc)

[PreviousOracles & Price Feedschevron-left](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds)
[NextBridging Architecturechevron-right](https://docs.lombard.finance/learn/transparency/bridging-architecture)

Last updated 28 days ago

*   [How to Verify](https://docs.lombard.finance/learn/transparency/smart-contracts#how-to-verify)
    
*   [Contract Types](https://docs.lombard.finance/learn/transparency/smart-contracts#contract-types)
    
*   [Ethereum](https://docs.lombard.finance/learn/transparency/smart-contracts#ethereum)
    
*   [Base](https://docs.lombard.finance/learn/transparency/smart-contracts#base)
    
*   [Avalanche](https://docs.lombard.finance/learn/transparency/smart-contracts#avalanche)
    
*   [BNB Smart Chain](https://docs.lombard.finance/learn/transparency/smart-contracts#bnb-smart-chain)
    
*   [Berachain](https://docs.lombard.finance/learn/transparency/smart-contracts#berachain)
    
*   [Corn](https://docs.lombard.finance/learn/transparency/smart-contracts#corn)
    
*   [Etherlink](https://docs.lombard.finance/learn/transparency/smart-contracts#etherlink)
    
*   [Katana](https://docs.lombard.finance/learn/transparency/smart-contracts#katana)
    
*   [MegaETH](https://docs.lombard.finance/learn/transparency/smart-contracts#megaeth)
    
*   [Monad](https://docs.lombard.finance/learn/transparency/smart-contracts#monad)
    
*   [Stable](https://docs.lombard.finance/learn/transparency/smart-contracts#stable)
    
*   [Sonic](https://docs.lombard.finance/learn/transparency/smart-contracts#sonic)
    
*   [Solana](https://docs.lombard.finance/learn/transparency/smart-contracts#solana)
    
*   [Starknet](https://docs.lombard.finance/learn/transparency/smart-contracts#starknet)
    
*   [Sui](https://docs.lombard.finance/learn/transparency/smart-contracts#sui)
    
*   [Swell](https://docs.lombard.finance/learn/transparency/smart-contracts#swell)
    
*   [TAC](https://docs.lombard.finance/learn/transparency/smart-contracts#tac)
    
*   [Babylon (IBC)](https://docs.lombard.finance/learn/transparency/smart-contracts#babylon-ibc)
    
*   [Audits](https://docs.lombard.finance/learn/transparency/smart-contracts#audits)
    
*   [Bug Bounty](https://docs.lombard.finance/learn/transparency/smart-contracts#bug-bounty)
    
*   [Report Scams](https://docs.lombard.finance/learn/transparency/smart-contracts#report-scams)

---

# Fees | Lombard Docs

All fees associated with staking, unstaking, and holding LBTC.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#fee-summary)

Fee Summary

Fee

Amount

When Applied

Minting fee

0% (~0.0001 LBTC for ETH)

Ethereum mints only

Unstaking fee

0.0001 LBTC

All unstakes

Protocol fee

8% of yield

Deducted from staking rewards

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#minting-fee)

Minting Fee

0% minting fee. On chains where network fess are higher, such as Ethereum, users authorize a small network fee in LBTC. This fee is deducted when Lombard Protocol relays a transaction to mint LBTC, and is a contribution towards the network gas fee paid by Lombard Protocol.

**Other chains:** No minting fee. Lombard covers gas costs on Base, Arbitrum, Solana, Sui, and other supported chains.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#how-it-works)

How It Works

Before your first Ethereum mint, your wallet prompts you to sign an "Authorize Network Fee" message. This authorizes Lombard to deduct the fee from your minted LBTC.

You can see the exact fee amount in the staking UI before confirming your deposit. In the unlikely event where Lombard Protocol does not mint LBTC, the user may do this themselves, paying the associated network gas fee. In this scenario, there are no fees deducted by Lombard Protocol.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#unstaking-fee)

Unstaking Fee

**Amount:** 0.0001 LBTC (fixed) **Applies to:** All unstakes on all chains

This is called the Network Security Fee. It serves two purposes:

1.  Contributes to Bitcoin network fees paid by Lombard when processing withdrawals
    
2.  Makes denial-of-service attacks economically prohibitive
    

Lombard does not profit from this fee.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#minimum-unstake-calculation)

Minimum Unstake Calculation

Component

Amount

Minimum withdrawal

0.00003300 LBTC

Unstaking fee

0.00010000 LBTC

**Total minimum**

**0.00013300 LBTC**

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#protocol-fee)

Protocol Fee

**Amount:** 8% of Babylon staking rewards **Applies to:** All LBTC holders (deducted before yield distribution)

Finality Providers (validators) on Babylon take an 8% commission on all staking rewards. This fee is deducted before rewards are converted to BTC and added to the LBTC exchange rate.

#### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#example)

Example

Step

Amount

Babylon rewards earned

100 BABY

Protocol fee (8%)

\-8 BABY

Net rewards

92 BABY

Converted to BTC

Added to reserve

You never see this fee directly, it is already factored into the APY displayed on the Lombard app.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#frequently-asked-questions)

Frequently Asked Questions

**Why is there a minting fee on Ethereum but not other chains?** Ethereum gas costs are significantly higher. On other chains, the cost is low enough for Lombard to absorb.

**Can I avoid the unstaking fee?** No. The 0.0001 LBTC fee applies to all unstakes regardless of chain or amount.

**Is the protocol fee taken from my LBTC balance?** No. The 8% fee is deducted from Babylon rewards before they reach the LBTC reserve. Your LBTC balance is not affected.

**Do fees change?** Fees may be adjusted by governance. Check the app or this document for current rates.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-lbtc/fees#next-steps)

Next Steps

*   [Use LBTC](https://docs.lombard.finance/use/use-lbtc)
     — Stake and unstake guide
    
*   [Understanding Yield](https://docs.lombard.finance/use/use-lbtc/understanding-yield)
     — How yield works after fees
    

[PreviousUnderstanding Yieldchevron-left](https://docs.lombard.finance/use/use-lbtc/understanding-yield)
[NextUse BTC.bchevron-right](https://docs.lombard.finance/use/use-btc.b)

Last updated 4 days ago

*   [Fee Summary](https://docs.lombard.finance/use/use-lbtc/fees#fee-summary)
    
*   [Minting Fee](https://docs.lombard.finance/use/use-lbtc/fees#minting-fee)
    
*   [Unstaking Fee](https://docs.lombard.finance/use/use-lbtc/fees#unstaking-fee)
    
*   [Protocol Fee](https://docs.lombard.finance/use/use-lbtc/fees#protocol-fee)
    
*   [Frequently Asked Questions](https://docs.lombard.finance/use/use-lbtc/fees#frequently-asked-questions)
    
*   [Next Steps](https://docs.lombard.finance/use/use-lbtc/fees#next-steps)

---

# FAQ | Lombard Docs

Find answers to common questions about Lombard, LBTC, BTC.b, and $BARD.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq#by-topic)

By Topic

Section

What You'll Find

[General FAQ](https://docs.lombard.finance/use/faq/general-faq)

Lombard protocol, security, team, backing

[LBTC FAQ](https://docs.lombard.finance/use/faq/lbtc-faq)

Staking, unstaking, yield, fees

[BTC.b FAQ](https://docs.lombard.finance/use/faq/btc.b-faq)

Minting, redeeming, WBTC comparison

[$BARD FAQ](https://docs.lombard.finance/use/faq/usdbard-faq)

Token, airdrop, staking, governance

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq#quick-answers)

Quick Answers

#### 

[hashtag](https://docs.lombard.finance/use/faq#what-is-the-difference-between-lbtc-and-btc.b)

What is the difference between LBTC and BTC.b?

Feature

LBTC

BTC.b

Yield

Yes (~0.41% APY)

No

BTC backing

1 LBTC = 1+ BTC (grows over time)

1 BTC.b = 1 BTC (always)

Use case

Earn while holding

Simple Bitcoin representation

Unstaking time

9 days

7-9 days

#### 

[hashtag](https://docs.lombard.finance/use/faq#can-i-convert-between-lbtc-and-btc.b)

Can I convert between LBTC and BTC.b?

Not directly. You need to redeem one for native BTC, then mint the other. This incurs redemption fees and waiting times. Some DEXs may offer direct swaps depending on liquidity.

#### 

[hashtag](https://docs.lombard.finance/use/faq#is-kyc-required)

Is KYC required?

No. Both LBTC and BTC.b are permissionless. Anyone can mint and redeem without identity verification.

#### 

[hashtag](https://docs.lombard.finance/use/faq#how-is-my-btc-secured)

How is my BTC secured?

Lombard uses a multi-layered security model:

*   **Security Consortium** — 14 independent institutions validate all operations
    
*   **CubeSigner** — Hardware Security Modules store keys, even during signing
    
*   **Bascule Drawbridge** — Secondary verification layer for all mints
    
*   **Chainlink CCIP** — Secure cross-chain messaging
    
*   **Audits** — OpenZeppelin, Veridise, Halborn
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq#still-have-questions)

Still Have Questions?

*   **Discord** — [discord.com/invite/2HG7G69twcarrow-up-right](https://discord.com/invite/2HG7G69twc)
     (fastest response)
    
*   **Support Widget** — Available at [lombard.financearrow-up-right](https://www.lombard.finance/)
     (bottom right)
    

[PreviousAccess DeFichevron-left](https://docs.lombard.finance/use/access-defi)
[NextGeneral FAQchevron-right](https://docs.lombard.finance/use/faq/general-faq)

Last updated 2 months ago

*   [By Topic](https://docs.lombard.finance/use/faq#by-topic)
    
*   [Quick Answers](https://docs.lombard.finance/use/faq#quick-answers)
    
*   [Still Have Questions?](https://docs.lombard.finance/use/faq#still-have-questions)

---

# Kaito Yappers | Lombard Docs

The Kaito Yappers program rewarded community members who created quality content about Lombard, LBTC, BTC.b, and Bitcoin DeFi on X (formerly Twitter). The program ran from Lombard's early days through January 2026, when changes to X's developer API policies ended Kaito's ability to track and measure engagement. The program has concluded, with final claims available through March 18, 2026.

> **Program status: Concluded.** The Kaito Yappers program is no longer active. Final reward claims are available at [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)
> .

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#program-overview)

Program Overview

Lombard allocated **1,600,000 BARD (0.16% of total supply)** to reward content creators who drove genuine discussion about the protocol on X. The program partnered with Kaito, an AI-powered platform that measures social media influence by evaluating content quality, engagement authenticity, and community impact.

The program operated across two seasons:

**Kaito Season 1** rewarded **450+ community members** who contributed meaningful Lombard content before and during TGE. Allocations were determined by cumulative Yap scores on the Lombard leaderboard. Eligible participants contributed over 0.01% to Lombard's mindshare.

**Kaito Season 2** ran for **four months (September 2025 through January 2026)**, rewarding the **top 100 yappers at the end of each month** based on mindshare rankings. Season 2 was designed to run for six months but ended early after four monthly cycles.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#why-the-program-ended)

Why the Program Ended

On January 14, 2026, X changed its developer API policies to disallow "InfoFi" projects like Kaito from using its API. This disrupted Kaito's ability to track and measure engagement accurately. The program's early termination was not a decision made by Lombard but a consequence of external platform changes that made it impossible to maintain the program's integrity.

As a result, the Season 2 allocation was pro-rated to reflect the shortened campaign:

Detail

Value

Original Season 2 allocation

0.08% of total supply

Pro-rated Season 2 allocation

**0.052% of total supply (520,000 BARD)**

Period covered

September 18, 2025 to January 14, 2026

Remaining BARD

Reallocated to future community growth campaigns

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#reward-distribution)

Reward Distribution

The Kaito allocation followed the same staggered distribution as Season 1 of the Lux program:

Tranche

Allocation

Date

Status

First 50%

50% of each yapper's total (Season 1 + Season 2)

September 18, 2025 (TGE)

Distributed

Remaining 50%

50% of each yapper's total (Season 1 + Season 2)

March 18, 2026 at 09:00 ET

Claimable

For Season 2 specifically, 100% of the pro-rated 0.052% allocation is claimable on March 18, 2026.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#how-to-claim)

How to Claim

All Kaito Yapper rewards are claimed through **Kaito's platform**, not through Lombard's claim portal.

1.  Go to [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)
    .
    
2.  Connect the wallet registered with your Kaito account.
    
3.  View your BARD allocation.
    
4.  Claim available tokens.
    

Kaito Yapper claims are **not available** at claim.lombard.finance. If you are eligible for both Lux rewards and Kaito Yapper rewards, you claim them through separate portals.

Unclaimed tokens from each claim window are returned to the Ecosystem Fund after the claim period closes.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#how-kaito-measured-contributions)

How Kaito Measured Contributions

Kaito's AI evaluated content across three dimensions:

**Proof of Work** measured the volume of relevant content created. Consistent posting about Lombard topics signaled commitment to the ecosystem.

**Proof of Exchange** tracked engagement quality. Interactions from established Crypto Twitter accounts ("Smart Followers") carried more weight than engagement from new or low-reputation accounts. Kaito identified coordinated engagement rings and discounted artificial interactions.

**Proof of Insight** rewarded original thinking. Content that explained concepts clearly, provided unique analysis, or sparked meaningful discussion scored higher than repetitive posts or retweets.

Tweets earned Mindshare for 7 days after posting. Weekly caps limited how many top-performing posts counted, preventing single viral tweets from dominating rewards.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/kaito-yappers#acknowledgment)

Acknowledgment

The Kaito Yappers program was cut short by circumstances outside Lombard's control, but the people it recognized made a measurable difference. The conversations, threads, analyses, and debates that Yappers drove on X played a direct role in Lombard's growth during its formative period. They brought new users in, answered questions, challenged assumptions, and built the kind of credibility that does not come from paid campaigns.

Beyond the Yappers, Lombard's ambassadors have been instrumental in the protocol's growth. From staying active in community channels to producing educational content and onboarding new users, ambassadors have been a consistent force behind the scenes. Lombard will continue to build programs that reward the people who show up for the community every day.

To everyone who participated: those contributions helped establish Lombard as one of the most trusted protocols in Bitcoin DeFi. The Kaito program in its original form has concluded, but the Lombard community continues to grow, with new ways to participate and be recognized through Season 3 and beyond.

[PreviousReferral Programchevron-left](https://docs.lombard.finance/learn/community/referral-program)
[NextUse LBTCchevron-right](https://docs.lombard.finance/use/use-lbtc)

Last updated 5 days ago

*   [Program Overview](https://docs.lombard.finance/learn/community/kaito-yappers#program-overview)
    
*   [Why the Program Ended](https://docs.lombard.finance/learn/community/kaito-yappers#why-the-program-ended)
    
*   [Reward Distribution](https://docs.lombard.finance/learn/community/kaito-yappers#reward-distribution)
    
*   [How to Claim](https://docs.lombard.finance/learn/community/kaito-yappers#how-to-claim)
    
*   [How Kaito Measured Contributions](https://docs.lombard.finance/learn/community/kaito-yappers#how-kaito-measured-contributions)
    
*   [Acknowledgment](https://docs.lombard.finance/learn/community/kaito-yappers#acknowledgment)

---

# Use $BARD | Lombard Docs

Stake $BARD to earn rewards and secure LBTC and BTC.b cross-chain transfers. Your staked BARD backs the Symbiotic monitoring network that validates every LBTC and BTC.b bridge transaction.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#get-usdbard)

Get $BARD

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#centralized-exchanges)

Centralized Exchanges

$BARD is available on:

Exchange

Pair

Binance

BARD/USDT

Bybit

BARD/USDT

OKX

BARD/USDT

Coinbase

BARD/USD

HTX

BARD/USDT

Bitget

BARD/USDT

Upbit

BARD/KRW

Bithumb

BARD/KRW

MEXC

BARD/USDT

KuCoin

BARD/USDT

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#earn-through-lux)

Earn Through Lux

Deploy LBTC or BTC.b into eligible DeFi protocols to earn Lux points. Lux converts to $BARD in seasonal airdrops. Passive holding does not earn Lux in Season 3.

→ [Lux Rewards Program](https://docs.lombard.finance/learn/community/lux-rewards)

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#stake-usdbard)

Stake $BARD

Staking is available on Ethereum mainnet only. You receive stBARD, a vault share that grows in value as rewards accrue.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#before-you-start)

Before You Start

*   You need $BARD in an Ethereum wallet
    
*   You need ETH for gas fees
    
*   Current APY: ~30% (long-term rate after Epoch 4)
    

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#steps)

Steps

1.  Go to [lombard.finance/apparrow-up-right](https://www.lombard.finance/app/)
     and connect your Ethereum wallet
    
2.  Navigate to the $BARD staking section
    
3.  Approve the staking contract to use your $BARD
    
4.  Enter the amount to stake
    
5.  Confirm the transaction
    
6.  Receive stBARD in your wallet
    

Your stBARD balance appears in the dashboard along with live APY and pending exits.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#reward-epochs)

Reward Epochs

The current long-term staking APY is approximately 30%.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#claim-and-stake-bonus-limited-time)

Claim and Stake Bonus (Limited Time)

Users who claim and stake BARD between March 18 and March 30, 2026 receive a 25% boost on top of the 30% APY, for a total of 55% APY.

This boosted rate lasts three months, expiring June 18, 2026. Bonus rewards are distributed on June 18.

To qualify:

*   Stake within the March 18 to March 30 window.
    
*   Maintain the staked position through June 18, 2026.
    

Unstaking before that date forfeits the bonus.

The bonus applies only to newly staked BARD during the window, not to positions staked before March 18.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#additional-rewards)

Additional Rewards

While staked, you also earn:

*   Symbiotic points
    
*   Mellow Finance points
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#unstake-usdbard)

Unstake $BARD

Unstaking requires a 21-day withdrawal period. Your funds remain slash-eligible until the epoch closes.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#steps-1)

Steps

1.  Go to the staking dashboard
    
2.  Select the amount of stBARD to unstake
    
3.  Confirm the transaction
    
4.  Wait up to 21 days (may be shorter depending on epoch timing)
    
5.  Return to claim your $BARD
    

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#what-to-know)

What to Know

*   You can have multiple unstake requests active at once
    
*   The staked portion continues earning while another portion exits
    
*   You receive more $BARD than you deposited (rewards are included)
    

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#example)

Example

Action

stBARD

Exchange Rate

$BARD

Stake

1,000

1.00

1,000 deposited

Unstake (later)

1,000

1.08

1,080 received

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#claim-airdrop)

Claim Airdrop

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#season-1)

Season 1

Claim at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)

Phase

Timing

Notes

Phase 1

TGE

1.5% of supply

Phase 2

TGE + 6 months

1.5% of supply + referral rewards

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#season-2)

Season 2

Season 2: 1.5% of total supply (15,000,000 BARD).

Claimable starting March 30, 2026 at 09:00 ET at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

90-day claim window. Unclaimed BARD returns to the Ecosystem Fund.

#### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#how-to-claim)

How to Claim

1.  Go to [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
    
2.  Connect the wallet you used for LBTC activities
    
3.  View your allocation
    
4.  Accept terms and conditions
    
5.  Sign the transaction to claim
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#contracts)

Contracts

Verify addresses before interacting:

Contract

Address

$BARD

`0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754`

stBARD

`0x4B266366dc8fF4c0007943a679CBa1fDB845f98D`

Always confirm addresses match what the Lombard app displays.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-usdbard#next-steps)

Next Steps

*   [Learn about $BARD](https://docs.lombard.finance/learn/token-economics)
     — Token utility, tokenomics, distribution
    
*   [Lux Rewards](https://docs.lombard.finance/learn/community/lux-rewards)
     — Earn $BARD through LBTC activities
    
*   [Liquid Bitcoin Foundation](https://docs.lombard.finance/learn/token-economics/liquid-bitcoin-foundation)
     — How governance works
    

[PreviousUse Bitcoin Earnchevron-left](https://docs.lombard.finance/use/use-bitcoin-earn)
[NextBridgingchevron-right](https://docs.lombard.finance/use/bridging)

Last updated 4 days ago

*   [Get $BARD](https://docs.lombard.finance/use/use-usdbard#get-usdbard)
    
*   [Stake $BARD](https://docs.lombard.finance/use/use-usdbard#stake-usdbard)
    
*   [Unstake $BARD](https://docs.lombard.finance/use/use-usdbard#unstake-usdbard)
    
*   [Claim Airdrop](https://docs.lombard.finance/use/use-usdbard#claim-airdrop)
    
*   [Contracts](https://docs.lombard.finance/use/use-usdbard#contracts)
    
*   [Next Steps](https://docs.lombard.finance/use/use-usdbard#next-steps)

---

# Lux Rewards | Lombard Docs

Lux is how Lombard measures your contribution to the ecosystem. The name comes from the Latin word for light: the Luminary Program lights a path for those building alongside Lombard.

> **Current Season: Season 3** (began March 18, 2026 at 00:00 UTC). Lux is now earned exclusively through active deployment. Passive holding of LBTC or BTC.b does not generate Lux. See [Season 3](https://docs.lombard.finance/learn/community/lux-rewards#season-3-activity-over-accumulation)
>  for current rules.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#what-are-lux)

What Are Lux?

Lux are participation points, not tokens. They represent your level of engagement with the Lombard ecosystem and serve as the basis for BARD airdrop allocations.

**What Lux are:**

*   A measure of your activity and commitment
    
*   Tracked per wallet by Sentio (blockchain infrastructure platform)
    
*   The basis for calculating your share of seasonal BARD airdrops
    
*   Accumulated automatically every hour based on your DeFi deployment activity
    

**What Lux are not:**

*   Tokens or digital assets
    
*   Transferable or tradeable
    
*   Currency or property with monetary value
    
*   Guaranteed to convert to anything
    

Lux exist only within Lombard's system. You cannot send them to another wallet, sell them on an exchange, or use them as collateral. Their sole purpose is to track your participation within the Lombard ecosystem.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#season-3-rewarding-activity)

Season 3: Rewarding Activity

Season 3 marks a fundamental change to how Lux are earned. In previous seasons, participants earned Lux by holding LBTC in a wallet with no further action required. That model served its purpose during the early growth phase, helping bootstrap adoption and build a broad holder base. Season 3 retires it.

**Lux is now earned exclusively through activity.** Deploy LBTC or BTC.b into eligible DeFi protocols and vault products to earn Lux. Idle assets in a wallet do not earn rewards of any kind.

The data from two seasons made this transition clear: LBTC has consistently maintained a 70%+ utility rate in DeFi. The participants who deploy, who collateralize, and who actively participate in DeFi are the ones who create the most value. Season 3 rewards them accordingly.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#what-changed-from-season-2)

What Changed from Season 2

Feature

Season 2

Season 3

Passive holding rewards

Active (Days Held × LBTC × 1,000)

**Discontinued**

BTC.b Lux eligibility

Not eligible

**Eligible when deployed in DeFi**

Earning model

Hold + optional DeFi

**DeFi deployment required for Lux**

Eligible assets

LBTC only

**LBTC and BTC.b**

Vault rewards

Lux accrual

**Lux at launch, transitioning to direct BARD streaming**

Badges

Active (fixed Lux for milestones)

**Discontinued**

Daily tap-in

Active (7-day streak = 200 Lux)

**Discontinued**

Special events

Active (Flash Events, Sparks, Reflections)

**Discontinued**

The previous base accrual formula (Days Held × Amount of LBTC × 1,000) no longer applies. Lux accrues only through active deployment and referrals.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#how-to-earn-in-season-3)

How to Earn in Season 3

Season 3 rewards active deployment of LBTC and BTC.b across three tiers, each with a different Lux multiplier. Multipliers are adjusted actively over the course of the season. The team focuses on leading venues across eligible chains.

Category

Multiplier

Protocols

DEX Liquidity and Others (e.g. restaking)

1x

Uniswap, Curve, Fluid, Aerodrome, Meteora, Etherfi

Lending Collateral

3x

Aave v3/4, Morpho, Spark, Fluid, Euler, Juplend, Kamino

Bitcoin Earn and Lombard Strategies

6x

Bitcoin Earn, Lombard vaults

**Eligible chains:** Ethereum, Solana, Avalanche, MegaETH, Base. Additional protocols and chains are expected during the season.

The Strategies section at [lombard.finance/apparrow-up-right](https://www.lombard.finance/app)
 displays all current opportunities with live multiplier rates.

Both LBTC and BTC.b deployments qualify across all three tiers. If you hold both assets and deploy both into eligible protocols, you earn Lux on both positions.

**BARD streaming for vaults.** Bitcoin Earn and Lombard Strategies currently earn Lux at the 6x multiplier. During Season 3, these products will transition to **direct BARD streaming**, where BARD is distributed continuously to vault participants rather than accrued as Lux. When BARD streaming goes live, the Lux multiplier for these vaults drops to zero and participants begin receiving BARD directly. Further details on timing and mechanics will be announced as the transition approaches.

**Supplementary: Referrals**

Referrals remain active as a supplementary Lux source. See the Referrals section below for details.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#btc.b-enters-the-lux-ecosystem)

BTC.b Enters the Lux Ecosystem

For the first time, BTC.b holders can earn Lux. This is one of the most significant additions to the Luminary Program since launch.

Since Lombard acquired BTC.b from Ava Labs in October 2025, the asset has grown to serve a distinct role across the ecosystem as a permissionless, non-custodial Bitcoin representation. Season 3 recognizes active BTC.b deployment alongside LBTC.

**Important:** Passive BTC.b holding in a wallet does not generate Lux. Only deployment into whitelisted DeFi protocols and vault products qualifies. Visit the Strategies section at [lombard.finance/apparrow-up-right](https://www.lombard.finance/app)
 to browse eligible BTC.b opportunities.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#referrals)

Referrals

The Lombard Referral Program lets participants earn ongoing Lux commissions by bringing new users into the ecosystem. When someone stakes BTC using a referral link, the referrer receives 20% of all Lux they generate, from both new and existing referred users. Referred users receive a 10% Lux boost on their own accrual.

The referral program continues in Season 3 with the same structure. Referrers earn commissions on all Lux generated by their referred users, including users referred in previous seasons who remain active.

Full referral program details: [Referral Programarrow-up-right](https://docs.lombard.finance/learn/community/referral-program)
.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#how-lux-convert-to-bard)

How Lux Convert to BARD

At the end of each season, Lombard allocates a fixed amount of BARD to participants. Your share is proportional:

**Your BARD = (Your Lux ÷ Total Community Lux) × Season BARD Allocation**

Season

BARD Allocation

% of Supply

Status

Season 1

40,000,000 BARD

4%

Distributed (Phase 1 at TGE; Phase 2 on March 18, 2026)

Season 2

15,000,000 BARD

1.5%

Claimable March 30, 2026

Season 3

10,000,000 BARD

1%

Active (began March 18, 2026)

The more Lux you accumulate relative to other participants, the larger your BARD allocation. There is no fixed "exchange rate." It depends on total community participation.

Season 1 required minimum 5,000 Lux to qualify (equivalent to holding ~0.01 LBTC for 30 days).

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#claiming-bard)

Claiming BARD

After each season ends, eligible participants can claim their BARD allocation at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#active-claim-events)

Active Claim Events

Event

Allocation

Opens

Window

Season 1 Phase 2

1.5% of supply (remaining 50% of S1 + referral rewards)

March 18, 2026 at 09:00 ET

90 days

Season 2

1.5% of supply (15,000,000 BARD)

March 30, 2026 at 09:00 ET

90 days

**Upcoming:** Season 1 Phase 3 (1% of supply) is scheduled for September 2026.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#claim-and-stake-bonus)

Claim and Stake Bonus

Users who claim and stake BARD between **March 18 and March 30, 2026** receive a **25% boost** on top of the standard 30% staking APY, for a total of **55% APY**. This boosted rate lasts three months, expiring June 18, 2026. Bonus rewards are distributed on June 18.

Two conditions must be met: stake within the March 18 to March 30 window, and maintain the staked position through June 18, 2026. Unstaking before that date forfeits the bonus allocation.

Stake directly via the claim app or at [lombard.finance/app/bardarrow-up-right](https://www.lombard.finance/app/bard)
.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#important-claiming-details)

Important Claiming Details

*   Each claim event has a **90-day window**. Unclaimed tokens after 90 days are returned to the Ecosystem Fund and cannot be recovered.
    
*   Referral Lux from Season 1 is distributed exclusively in Phase 2 (March 18, 2026). It was not included in the TGE distribution.
    
*   All eligible wallets undergo AML and sanctions screening via TRM Labs. No KYC is required, but flagged wallets cannot claim.
    
*   U.S. persons and residents of sanctioned jurisdictions are excluded from participation.
    
*   Kaito Yapper rewards are claimed separately at [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)
    , not through claim.lombard.finance.
    

**Token contract:** `0xf0DB65D17e30a966C2ae6A21f6BBA71cea6e9754` (Ethereum, ERC-20)

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#the-rewards-page)

The Rewards Page

Your dashboard for everything Lux-related:

*   **Lux Balance:** Real-time total across all sources.
    
*   **DeFi Positions:** Active deployments earning Lux and their current multipliers.
    
*   **Referral Stats:** Who you have onboarded and what you have earned from them.
    

Everything in one place at [lombard.finance/app/rewardsarrow-up-right](https://www.lombard.finance/app/rewards)
.

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#how-tracking-works)

How Tracking Works

Sentio, a blockchain infrastructure platform, monitors all Lux-eligible activity:

*   LBTC and BTC.b positions in whitelisted DeFi protocols
    
*   Vault product deposits (Bitcoin Earn and Lombard Strategies)
    
*   Referral connections
    

Visit [lombard.finance/app/rewardsarrow-up-right](https://www.lombard.finance/app/rewards)
 to view your current Lux balance, active multipliers, and referral stats. The dashboard updates hourly as new Lux accrues.

The Strategies tab displays your referral link and tracks referred users. The Leaderboard shows top Lux earners across the ecosystem.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#season-history)

Season History

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#season-1-launch-to-september-18-2025)

Season 1 (Launch to September 18, 2025)

Season 1 bootstrapped the LBTC ecosystem. 4% of total BARD supply (40,000,000 BARD) was allocated to participants. Distribution occurred across three phases: 1.5% at TGE (September 18, 2025), 1.5% at the 6-month mark (March 18, 2026), and 1% at the 12-month mark (September 2026).

Lux accrued through LBTC holding, DeFi deployment with multipliers, badges, and early community events. A minimum of 5,000 Lux was required to qualify.

#### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#season-2-september-18-2025-to-march-18-2026)

Season 2 (September 18, 2025 to March 18, 2026)

Season 2 ran for six months and allocated 1.5% of total supply (15,000,000 BARD). The earning model included base accrual from passive LBTC holding (Days Held × LBTC Amount × 1,000) alongside DeFi multipliers, badges, referrals, and daily tap-ins. BTC.b was not eligible for Lux during Season 2.

Season 1 participants could roll over up to 30% of their Season 1 Lux through two badges: Genesis HODLer (unlocked at 50,000 Season 2 Lux, awards 15% of Season 1 Lux) and Growth Maxi (unlocked at an additional 50,000 Season 2 Lux, awards another 15%).

The full Season 2 distribution (100% of the 1.5% allocation) goes live on March 30, 2026 at 09:00 ET.

* * *

### 

[hashtag](https://docs.lombard.finance/learn/community/lux-rewards#start-earning)

Start Earning

1.  **Deploy in DeFi.** Stake BTC, mint LBTC, and deploy into eligible protocols. Or deploy BTC.b into whitelisted opportunities. Lending collateral earns at 3x; DEX liquidity and others at 1x.
    
2.  **Use Bitcoin Earn.** Deposit into Bitcoin Earn or Lombard Strategies for the highest multiplier (6x), with a planned transition to direct BARD streaming later in the season.
    
3.  **Check Rewards.** Track your Lux balance and DeFi positions at [lombard.finance/app/rewardsarrow-up-right](https://www.lombard.finance/app/rewards)
    .
    
4.  **Refer Friends.** Earn 20% of their Lux through the referral program.
    

[PreviousCommunitychevron-left](https://docs.lombard.finance/learn/community)
[NextReferral Programchevron-right](https://docs.lombard.finance/learn/community/referral-program)

Last updated 5 days ago

*   [What Are Lux?](https://docs.lombard.finance/learn/community/lux-rewards#what-are-lux)
    
*   [Season 3: Rewarding Activity](https://docs.lombard.finance/learn/community/lux-rewards#season-3-rewarding-activity)
    
*   [Referrals](https://docs.lombard.finance/learn/community/lux-rewards#referrals)
    
*   [How Lux Convert to BARD](https://docs.lombard.finance/learn/community/lux-rewards#how-lux-convert-to-bard)
    
*   [Claiming BARD](https://docs.lombard.finance/learn/community/lux-rewards#claiming-bard)
    
*   [The Rewards Page](https://docs.lombard.finance/learn/community/lux-rewards#the-rewards-page)
    
*   [How Tracking Works](https://docs.lombard.finance/learn/community/lux-rewards#how-tracking-works)
    
*   [Season History](https://docs.lombard.finance/learn/community/lux-rewards#season-history)
    
*   [Start Earning](https://docs.lombard.finance/learn/community/lux-rewards#start-earning)

---

# How Integration Works | Lombard Docs

This section outlines the typical path teams follow when integrating the Lombard SDK, from initial alignment through production launch. It is intended for founders, product leaders, and technical decision-makers who want to understand the process end to end before diving into implementation details.

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works#integration-at-a-glance)

Integration at a Glance

Step 1: Define the product requirement

Step 2: Test the capabiltiies

Step 3: Use the Playground to configure and validate the integration

Step 4: Integrate and ship product

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works#what-happens-at-each-stage)

What Happens at Each Stage

**Step 1: Define the product requirements**

The integration starts by defining the scope, expecations and product goals.

Teams typically:

*   Outline use cases and product goals
    
*   Review supported assets and chains
    
*   Align on security assumptions and operational boundaries
    
*   Discuss compliance and regulatory requirements
    
*   Receive a Partner ID or configure CAPTCHA requirements
    

This ensures both sides are clear on what's being built before integration work begins.

**Step 2: Test the capabilities**

Once aligned, teams explore the SDK and see how everything works in practice.

This involves:

*   Navigating the Playground
    
*   Testing the specific capabilities planned for launch
    
*   Understanding how different flows behave
    

The goal: validate assumptions and get comfortable with the SDK before committing to implementation.

**Step 3: Configure and validate your integration**

With a clear target in mind, teams use the Playground to configure and test their integration.

At this stage:

*   Set parameters for selected flows
    
*   Validate execution paths
    
*   Simulate asset behavior and cross-chain routing
    
*   Generate example SDK code
    
*   Debug configurations in a non-production environment
    

This replaces trial-and-error in production and reduces launch risk.

**Step 5: Integrate and ship**

The final step: launching your Bitcoin product to users.

At launch:

*   The SDK integrates into application logic
    
*   Users interact with Bitcoin features through the product's UI
    
*   Lombard operates custody, validation, settlement, and monitoring in production
    
*   Results and lifecycle events surface through the SDK
    

[PreviousQuickstart Guidechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/quickstart-guide)
[NextThe SDK Playgroundchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/the-sdk-playground)

Last updated 2 months ago

*   [Integration at a Glance](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works#integration-at-a-glance)
    
*   [What Happens at Each Stage](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works#what-happens-at-each-stage)

---

# Introduction to Bitcoin Connect | Lombard Docs

Bitcoin Connect is Lombard's infrastructure platform that enables developers to build Bitcoin products across any chain, protocol, or application. Rather than forcing teams to deploy on a specific Bitcoin L2 or build infrastructure from scratch, Bitcoin Connect provides production-grade tooling that connects native Bitcoin to the broader onchain ecosystem.

### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#the-infrastructure-gap)

The Infrastructure Gap

Bitcoin represents over $2 trillion in value, yet less than 1% exists onchain in productive use cases.

For years, building with Bitcoin meant building _on_ Bitcoin. Developers faced limited options: deploy on sidechains, build on Bitcoin L2s, or use custodial wrappers. Each approach locked teams into closed ecosystems with fragmented liquidity and limited interoperability. Worse, each required teams to either operate complex Bitcoin infrastructure themselves or accept significant compromises on security and composability.

These architectural constraints made institutional adoption impossible and forced developers to choose between building on Bitcoin or building where their users actually are. Bitcoin Connect eliminates this tradeoff entirely.

### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#what-bitcoin-connect-is)

What Bitcoin Connect Is

Bitcoin Connect is a comprehensive and evolving developer platform that provides production-grade tools for bringing native Bitcoin to any application. Instead of forcing teams to build on a specific Bitcoin L2 or manage their own infrastructure stack, it offers direct access to the same systems Lombard uses to secure over $3 billion in Bitcoin across 15 blockchains.

The platform handles all the operational complexity of Bitcoin so developers can focus on the core roadmap. Teams integrate once and inherit infrastructure that's been production-tested at institutional scale, with zero downtime and no security incidents since launch.

### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#what-it-unlocks)

What It Unlocks

Bitcoin Connect fundamentally changes what's possible with Bitcoin onchain. Developers are no longer constrained by where Bitcoin infrastructure exists as they can build Bitcoin products wherever their users are.

**For Applications**

Applications can integrate native Bitcoin functionality without hiring infrastructure teams or managing operational complexity. A DeFi protocol can add Bitcoin collateral support. A wallet can offer one-click Bitcoin staking. A trading platform can enable Bitcoin-backed derivatives. The platform provides the infrastructure (like custody, routing, security) while teams maintain complete control over their product experience and user interface.

This means applications can offer Bitcoin deposits that work like centralized exchange flows, integrate native yield generation directly into their products, launch staking products, and build features that were previously impractical or impossible without dedicated Bitcoin infrastructure teams.

**For Chains and Protocols**

Chains gain access to native Bitcoin liquidity without building bridges or custody solutions from scratch. Protocols can use Bitcoin as collateral to scale their products without operating validator networks or managing cross-chain complexity. Infrastructure providers can offer Bitcoin services to their users through a single integration rather than building each component separately.

The platform handles cross-chain settlement, custody guarantees, and security validation across all supported blockchains. This lets chains and protocols focus on their core value proposition while accessing the Bitcoin liquidity they need to grow.

**For Institutions and Enterprises**

Institutions can launch whitelabeled Bitcoin products under their own brands with enterprise-grade security built in. They inherit institutional custody controls, audited smart contracts, Proof-of-Reserve verification, and operational guarantees from infrastructure securing billions in assets—without building separate custody arrangements or undergoing lengthy security audits for each deployment.

This enables institutions to move quickly on Bitcoin product opportunities while maintaining the security standards and compliance requirements their users expect.

### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#build-bitcoin-products-everywhere-with-bitcoin-connect)

Build Bitcoin Products Everywhere with Bitcoin Connect

Bitcoin Connect provides sophesticated tools connecting native Bitcoin to every application, enabling teams to launch Bitcoin products wherever their users are.

**What teams can do with Bitcoin Connect:**

*   Onboard Native BTC Deposits directly into the Application (like a CEX)
    
*   Offer native Bitcoin yield, including Vault & staking products
    
*   Launch whitelabeled Bitcoin products under their own brands
    
*   Enable Bitcoin as collateral for lending & Derivatives Products
    
*   Innovate with BTC Products without sacrificing security or distribution
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#who-bitcoin-connect-is-for)

Who Bitcoin Connect Is For

Bitcoin Connect supports teams building across the Bitcoin product spectrum, including:

*   DeFi protocols integrating canonical BTC assets
    
*   Chains launching with native or whitelabeled Bitcoin assets
    
*   Fintech platforms offering Bitcoin yield or investment products
    
*   Institutions, custodians, and staking providers integrating onchain Bitcoin strategies
    

Each team selects the builder tool that best matches its technical and operational requirements.

* * *

#### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#builder-tools-available-within-bitcoin-connect)

Builder Tools Available within Bitcoin Connect

#### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#the-lombard-sdk-available-today)

The Lombard SDK (Available today)

The Lombard SDK is the first builder tool released under Bitcoin Connect.

It provides a complete, deployment-ready toolkit for integrating established Bitcoin assets and infrastructure directly into applications. The SDK exposes the same capabilities Lombard operates internally to issue, secure, and manage Bitcoin at institutional scale.

If Lombard can offer a Bitcoin capability in production, teams integrating the SDK can offer the same capability - without building or operating Bitcoin infrastructure themselves.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FXXYnBxsB71fIA6bf1S5K%252Fsdk.png%3Falt%3Dmedia%26token%3D5cf5cc90-ed4d-4014-8fdd-01a59e472ef8&width=752&dpr=3&quality=100&sign=a1b4df07&sv=2)

**Lombard SDK**

Complete SDK documentation covering installation, configuration, wallet integration, and all available actions. Includes code examples, TypeScript interfaces, and implementation patterns for Bitcoin staking, deposits, and vault deployments.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FTcnyuhXYaiH05GE6wnMT%252Ffaq.png%3Falt%3Dmedia%26token%3Dad5a9d73-c352-4934-ae4b-8ae0e50c0fb9&width=752&dpr=3&quality=100&sign=927b7672&sv=2)

**SDK FAQ**

Quick answers to common integration questions covering setup, Partner IDs, wallets, SDK patterns, testing, security, and support. Reference guide for technical and operational questions.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FRuKhUcldj2G9HgLOMoDT%252Fplayground.png%3Falt%3Dmedia%26token%3D2c04ce20-8513-4cca-adc1-27f895717d20&width=752&dpr=3&quality=100&sign=787d2b63&sv=2)

**The SDK Playground**

Live testing environment to configure flows, simulate operations, and generate SDK code before deploying to mainnet. Test Bitcoin integrations without touching production.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252Fk7hMXcpI3hIVV7aZ05tw%252Fsupport.png%3Falt%3Dmedia%26token%3D43289a63-e147-4103-adcc-d265a23791ce&width=752&dpr=3&quality=100&sign=75fa5ef0&sv=2)

**Builder Support**

Integration assistance and direct access to the Lombard team via Telegram. Get help with architecture review, debugging, and production escalations.

* * *

#### 

[hashtag](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#additional-builder-tools-coming-next)

Additional Builder Tools (Coming Next)

Bitcoin Connect is an evolving developer platform that will expand with additional tools that support different integration patterns, including:

*   APIs for direct, server-to-server integration and custom orchestration
    
*   Widgets
    
*   Additional builder tools designed for new Bitcoin workflows and product abstractions
    

* * *

Start Building → [Use the Playground to test flows and configurationsarrow-up-right](https://www.lombard.finance/playground)
 → [Reach out to the Lombard team to discuss integration options](https://docs.lombard.finance/build/the-lombard-sdk/builder-support)

[PreviousTroubleshootingchevron-left](https://docs.lombard.finance/use/troubleshooting)
[NextThe Lombard SDKchevron-right](https://docs.lombard.finance/build/the-lombard-sdk)

Last updated 2 months ago

*   [The Infrastructure Gap](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#the-infrastructure-gap)
    
*   [What Bitcoin Connect Is](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#what-bitcoin-connect-is)
    
*   [What It Unlocks](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#what-it-unlocks)
    
*   [Build Bitcoin Products Everywhere with Bitcoin Connect](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#build-bitcoin-products-everywhere-with-bitcoin-connect)
    
*   [Who Bitcoin Connect Is For](https://docs.lombard.finance/build/introduction-to-bitcoin-connect#who-bitcoin-connect-is-for)

---

# Quickstart Guide | Lombard Docs

This page provides quick access to key sections of the Lombard SDK documentation. Use these shortcuts to navigate directly to integration workflows, testing environments, implementation guides, and support channels. Start with **How Integration Works** to understand the full journey, test configurations in **The SDK Playground**, then follow **User Guides** for step-by-step implementation patterns. Most teams complete SDK integration in 2-4 weeks.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F148DzJTWiFtnCYqop4rI%252Fbuild.png%3Falt%3Dmedia%26token%3D175d0940-cfee-4027-98ee-51e60efe534a&width=490&dpr=3&quality=100&sign=4bc5237&sv=2)

**How Integration Works**

The 5-step path from initial setup to production launch. Define scope, test capabilities, configure flows, validate in Playground, and ship.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FRuKhUcldj2G9HgLOMoDT%252Fplayground.png%3Falt%3Dmedia%26token%3D2c04ce20-8513-4cca-adc1-27f895717d20&width=490&dpr=3&quality=100&sign=787d2b63&sv=2)

**The SDK Playground**

Live testing environment to configure flows, simulate operations, and generate SDK code before deploying to mainnet. Test Bitcoin integrations without touching production.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FULXUif3wuZ92eMINQlXF%252Fintroduction.png%3Falt%3Dmedia%26token%3D5176e34c-0426-4e56-8c51-7ac14bdad4dd&width=490&dpr=3&quality=100&sign=9c85dced&sv=2)

**User Guides**

Step-by-step implementation guides for Bitcoin flows including staking, deposits, unstaking, redemptions, and vault deployments. Each guide includes complete code examples and configuration patterns.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FTcnyuhXYaiH05GE6wnMT%252Ffaq.png%3Falt%3Dmedia%26token%3Dad5a9d73-c352-4934-ae4b-8ae0e50c0fb9&width=490&dpr=3&quality=100&sign=927b7672&sv=2)

**SDK FAQ**

Quick answers to common integration questions covering setup, Partner IDs, wallets, SDK patterns, testing, security, and support. Reference guide for technical and operational questions.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252Fk7hMXcpI3hIVV7aZ05tw%252Fsupport.png%3Falt%3Dmedia%26token%3D43289a63-e147-4103-adcc-d265a23791ce&width=490&dpr=3&quality=100&sign=75fa5ef0&sv=2)

**Builder Support**

Integration assistance and direct access to the Lombard team via Telegram. Get help with architecture review, debugging, and production escalations.

![Cover](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FXc5URFGtrmtnCLpvP45d%252Flombard.png%3Falt%3Dmedia%26token%3Daf27e68c-5c9f-4686-b43e-821fde2da20f&width=490&dpr=3&quality=100&sign=e16d8e2a&sv=2)

**Enjoy Building!**

Welcome to Lombard! Where Bitcoin meets every chain. Build on Lombard's Bitcoin infrastructure. Join 260,000+ users bringing BTC to DeFi.

[PreviousThe Lombard SDKchevron-left](https://docs.lombard.finance/build/the-lombard-sdk)
[NextHow Integration Workschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works)

Last updated 2 months ago

---

# The SDK Playground | Lombard Docs

The Playground is a live environment for exploring and validating Bitcoin integrations before production. It lets builders understand system behavior, test configurations, and evaluate flows without deploying to mainnet.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FQViusypYzQC1g6QVYToE%252FScreenshot%25202026-01-21%2520at%252020.15.15.png%3Falt%3Dmedia%26token%3D41ac2896-84ac-41ac-8589-3b5fb33f9c77&width=768&dpr=3&quality=100&sign=12c9797&sv=2)

Using the Playground, builders can:

*   Configure Bitcoin flows and parameters
    
*   Validate execution paths ahead of launch
    
*   Simulate asset minting, redemption, and routing behavior
    
*   Generate example SDK code for integration
    
*   Debug configurations in a non-production environment
    

This shifts experimentation out of production, reduces integration risk, and shortens the path from evaluation to launch.

→ [Explore the Playgroundarrow-up-right](https://www.lombard.finance/playground/)

[PreviousHow Integration Workschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/how-integration-works)
[NextUser Guideschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides)

Last updated 2 months ago

---

# The Lombard SDK | Lombard Docs

The Lombard SDK is a complete, deployment-ready toolkit that packages Lombard's proven Bitcoin infrastructure into modular components developers can integrate directly into their applications. It provides everything needed to launch Bitcoin products at scale, from established Bitcoin assets like LBTC & BTC.b to complete integration flows and institutional security controls, all built on infrastructure that powers over $3 billion in assets.

It is the first tool available within Bitcoin Connect, Lombard’s developer platform for building Bitcoin products on any chain, protocol or application.

Rather than building and maintaining Bitcoin infrastructure in-house, teams integrate the SDK to access the same assets, flows, and security model that Lombard operates at institutional scale. The SDK connects applications directly to Lombard's live, production infrastructure.

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#start-building)

Start building!


-------------------------------------------------------------------------------------------------

Get up and running in 5 minutes. Integrate Bitcoin utility directly into your application with our deployment-ready toolkit that powers over $3 billion in assets.

[Quickstart Guide](https://docs.lombard.finance/build/the-lombard-sdk/quickstart-guide)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FDnyw40NVDjnggkYQMxq8%252Funnamed%2520%281%29-modified.png%3Falt%3Dmedia%26token%3Dcf0c5197-010c-4894-9702-eb74eaa04823&width=768&dpr=3&quality=100&sign=cad132d7&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#what-lombard-sdk-is-and-is-not)

What Lombard SDK Is (and Is Not)

**The Lombard SDK is:**

*   A complete Bitcoin infrastructure toolkit delivered through a unified integration surface
    
*   A production-tested system designed for live deployment at scale
    
*   An abstraction over Bitcoin custody, minting, redemption, settlement, security, and monitoring
    
*   A maintained system that evolves as new assets, chains, and capabilities are introduced
    
*   A modular set of SDKs that can be enabled incrementally as product needs evolve
    

**The Lombard SDK is not:**

*   A single-purpose API or isolated service
    
*   A custodial wallet or consumer-facing application
    
*   A toolkit that requires operating validators, bridges, or security systems
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#what-teams-build-with-lombard-sdk)

What Teams Build with Lombard SDK

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FOVKeEFCHMLGGjg6Ps3hj%252FGroup%25202147262599.png%3Falt%3Dmedia%26token%3Dc806ed52-e043-43b1-87da-72a6804cd5cc&width=768&dpr=3&quality=100&sign=95e57d13&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#whats-included-in-the-lombard-sdk)

What's Included in The Lombard SDK

The SDK includes everything developers need to ship great Bitcoin products fast:

*   **Plug-in BTC Infrastructure:** Integrate BTC assets, mints & redemptions, routing, and yield strategies into your product
    
*   **Live Playground:** for testing code in real time and debugging. Includes detailed live codes, and concrete endpoints.
    
*   **Institutional-grade Security Controls:** Leverage the same Security Consortium, and institutional security and audit controls securing the Lombard Protocol
    
*   **Unmatched White-glove Builder Support: T**he most comprehensive docs, user guides, 24/7 support, and ongoing maintenance by Lombard.
    

The SDK is modular: integrate specific capabilities as needed, launch on any supported chain, and scale without rebuilding infrastructure for each deployment.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#who-integrates-lombard-sdk)

Who Integrates Lombard SDK

**Exchanges:** Launch BTC assets, minting, redemption, and yield without operating infrastructure

**Wallets**: Offer Bitcoin earning and strategy execution without embedding custody or routing systems

**Protocols**: Accept Bitcoin-backed assets or enable native minting

**Custodians**: Add onchain Bitcoin functionality while maintaining custody controls

**Financial Institutions**: Integrate Bitcoin flows with explicit validation assumptions

**Staking Providers**: Extend services to Bitcoin without building Bitcoin-specific infrastructure

From exchanges, institutions and wallets to staking providers and custodians, leading global teams already power their Bitcoin products through the Lombard SDK.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F9dRv6ZCrf7Y9nPht2UN3%252FSlide%252016_9-16.png%3Falt%3Dmedia%26token%3D65c9eed8-197e-4ccd-9196-d6220bd78aac&width=768&dpr=3&quality=100&sign=68a3452a&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk#for-developers-how-the-sdk-documentation-is-structured)

For Developers: How The SDK Documentation Is Structured

The SDK documentation is organized to guide developers from evaluation to integration and long-term operation:

**Quickstart:** High-level overview and guidance on where to find key information

**User Guides:** Step-by-step implementations and endpoints for each capability

**Playground:** Live code and example configurations for testing and debugging

**FAQ:** Common integration and operational questions

**Support:** Integration assistance and builder support

[PreviousIntroduction to Bitcoin Connectchevron-left](https://docs.lombard.finance/build/introduction-to-bitcoin-connect)
[NextQuickstart Guidechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/quickstart-guide)

Last updated 2 months ago

*   [Start building!](https://docs.lombard.finance/build/the-lombard-sdk#start-building)
    
*   [What Lombard SDK Is (and Is Not)](https://docs.lombard.finance/build/the-lombard-sdk#what-lombard-sdk-is-and-is-not)
    
*   [What Teams Build with Lombard SDK](https://docs.lombard.finance/build/the-lombard-sdk#what-teams-build-with-lombard-sdk)
    
*   [What's Included in The Lombard SDK](https://docs.lombard.finance/build/the-lombard-sdk#whats-included-in-the-lombard-sdk)
    
*   [Who Integrates Lombard SDK](https://docs.lombard.finance/build/the-lombard-sdk#who-integrates-lombard-sdk)
    
*   [For Developers: How The SDK Documentation Is Structured](https://docs.lombard.finance/build/the-lombard-sdk#for-developers-how-the-sdk-documentation-is-structured)

---

# Builder Support | Lombard Docs

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#new-partners)

New Partners

Interested in integrating the Lombard SDK?

→ **Reach out to our team** via [**Discord**arrow-up-right](https://discord.com/invite/2HG7G69twc)
 or email [**\[email protected\]**envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#a8d8c9dadcc6cddadbc0c1d8dbe8c4c7c5cac9dacc86cec1c6c9c6cbcd)

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#current-partners)

Current Partners

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#dedicated-partner-slack-channel)

Dedicated Partner Slack Channel

Every SDK partner gets a dedicated Slack channel with direct access to the Lombard team. This is your primary support channel for all integration-related questions.

→ To set up your partner channel, contact us on Discord with your email and we'll create a dedicated Slack channel for your team.

→ For any issues (urgent or general queries), please post in your partner Slack channel, and our team will do our best to respond immediately.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#what-to-include-when-asking-for-help)

What to Include When Asking for Help

To help us resolve your issue quickly, please include:

*   **SDK version:** The `@lombard.finance/sdk` version from your `package.json`
    
*   **Environment:** Testnet (Sepolia, Holesky) or Mainnet
    
*   **Asset:** BTC.b, LBTC or Both
    
*   **Chain/Network:** e.g., Ethereum, Base, Solana, Sui, Starknet
    
*   **Action being performed:** e.g., stake, unstake, deposit, claim
    
*   **Full error message:** The complete error, including any error codes
    
*   **Steps to reproduce:** What sequence of actions triggers the issue
    
*   **Wallet type:** e.g., MetaMask, Phantom, Ledger
    
*   **Code snippet:** The relevant portion of your integration code (if applicable)
    
*   **Transaction hash:** If the issue involves a failed or stuck transaction
    

The more context you provide upfront, the faster we can identify and resolve the issue.

[PreviousLombard SDK FAQchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq)
[NextDirect Integrationschevron-right](https://docs.lombard.finance/build/direct-integrations)

Last updated 2 months ago

*   [New Partners](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#new-partners)
    
*   [Current Partners](https://docs.lombard.finance/build/the-lombard-sdk/builder-support#current-partners)

---

# Direct Integrations | Lombard Docs

For advanced users and protocols that need to interact with Lombard's smart contracts without relying on the SDK or web app. Tombard's web app and SDK handle the full deposit-mint-redeem lifecycle automatically. These guides cover the raw contract interactions behind those flows: initiating deposits, tracing mints and redeems across chains, reading oracle data, and querying unstake fees directly from the contracts.

* * *

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations#available-guides)

Available Guides

[BTC.b to LBTC and LBTC to BTC.b Swapschevron-right](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps)

[PreviousBuilder Supportchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/builder-support)
[NextBTC.b to LBTC and LBTC to BTC.b Swapschevron-right](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps)

Last updated 1 day ago

---

# Use BTC.b | Lombard Docs

Bring your Bitcoin on-chain without KYC, custody risks, or yield complexity. BTC.b is a 1:1 Bitcoin representation that works across multiple blockchains, permissionless, decentralized, and always redeemable for native BTC.

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#what-you-get)

What You Get

When you mint BTC.b, you receive a token backed 1:1 by native Bitcoin held through Lombard's security infrastructure:

*   No yield (simpler than LBTC)
    
*   No KYC required
    
*   0% minting fee
    
*   Available on Monad, Stable and Katana
    
*   Redeemable for native BTC at any time (6 hours withdrawal period)
    

BTC.b is ideal if you want straightforward Bitcoin representation without the complexity of yield-bearing tokens.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#btc.b-vs-lbtc)

BTC.b vs LBTC

Feature

BTC.b

LBTC

Yield

No

Yes (~0.81% APY)

Exchange rate

Always 1:1

Increases over time

Use case

Simple BTC representation

Earn while holding

Minting fee

0%

0% (Ethereum has gas fee)

Redemption fee

0.0001 BTC

0.0001 LBTC

Redemption time

6 hours

7-9 days

**Choose BTC.b** for maximum simplicity, lowest fees, and active DeFi participation where you control yield strategies.

**Choose LBTC** for passive yield generation and long-term holding.

Many users hold both.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#mint-btc.b)

Mint BTC.b

You can mint from any Bitcoin wallet, hardware wallets, DeFi wallets, or exchanges that allow BTC withdrawals.

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#before-you-start)

Before You Start

*   You need native BTC in a wallet that can send to SegWit addresses
    
*   Choose which chain you want to receive BTC.b on
    
*   Have a wallet address ready on your destination chain
    

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#steps)

Steps

1.  Go to the Lombard app
    
2.  Select BTC.b minting
    
3.  Connect your destination wallet
    
4.  Connect with your destination chain
    
5.  Lombard generates a unique deposit address tied to your destination
    
6.  Send BTC to that address
    
7.  Wait for 3-6 Bitcoin confirmations
    
8.  BTC.b mints automatically to your destination address
    

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#fees)

Fees

Fee

Amount

Minting fee

0%

Bitcoin network fee

~$2-20 (varies)

Destination chain gas

Varies by chain

Typical gas fees:

*   Avalanche: <$1
    
*   Solana: <$0.01
    
*   Ethereum: $5-50
    

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#minimum-deposit)

Minimum Deposit

0.0002 BTC (subject to change). There is no maximum.

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#can-i-cancel-a-mint)

Can I Cancel a Mint?

No. Once BTC is sent to the deposit address, the mint cannot be cancelled. Always verify addresses before sending.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#redeem-btc.b)

Redeem BTC.b

You can withdraw your native BTC at any time. The process takes 6 hours due to security verification and coordination with the Security Consortium.

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#before-you-start-1)

Before You Start

*   You need BTC.b on any supported chain
    
*   Have a Bitcoin address ready (Native SegWit or Taproot)
    

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#supported-bitcoin-addresses)

Supported Bitcoin Addresses

Prefix

Type

Supported

`bc1q`

Native SegWit (P2WPKH, P2WSH)

Yes

`bc1p`

Taproot (P2TR)

Yes

`1...`

Legacy (P2PKH)

No

`3...`

Nested SegWit (P2SH)

No

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#steps-1)

Steps

1.  Go to the Lombard app
    
2.  Select BTC.b redemption
    
3.  Enter the amount of BTC.b to redeem
    
4.  Enter your Bitcoin withdrawal address
    
5.  Confirm the burn transaction
    
6.  Wait 6 hours for BTC to arrive
    

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#fees-1)

Fees

Fee

Amount

Redemption fee

0.0001 BTC

Gas fee

Varies by chain

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#can-i-cancel-a-redemption)

Can I Cancel a Redemption?

No. Once the burn transaction is confirmed, the redemption cannot be cancelled.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#bridge-btc.b-between-chains)

Bridge BTC.b Between Chains

BTC.b can be moved between supported chains using Chainlink CCIP through the Lombard app.

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#steps-2)

Steps

1.  Go to the Lombard app
    
2.  Select bridge
    
3.  Choose source and destination chains
    
4.  Enter the amount
    
5.  Confirm the transaction
    
6.  Wait 10-30 minutes depending on chains involved
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#earn-lux-with-btc.b)

Earn Lux with BTC.b

Starting in Season 3 of the Luminary Program (March 18, 2026), BTC.b participates in the Lux ecosystem for the first time.

Deploy BTC.b into eligible DeFi protocols and vault products to accrue Lux, which converts to BARD in seasonal airdrops.

Three multiplier tiers apply to BTC.b deployment:

*   **DEX Liquidity and Others (e.g. restaking):** 1x (Uniswap, Curve, Fluid, Aerodrome, Meteora, Etherfi)
    
*   **Lending Collateral:** 3x (Aave v3/4, Morpho, Spark, Fluid, Euler, Juplend, Kamino)
    
*   **Bitcoin Earn and Lombard Strategies:** 6x
    

Eligible chains: Ethereum, Solana, Avalanche, MegaETH, Base. Additional protocols and chains are expected during the season.

Passive BTC.b holding in a wallet does not generate Lux. Only deployment into whitelisted protocols qualifies.

Visit the Strategies section at [lombard.finance/apparrow-up-right](https://www.lombard.finance/app)
 for current opportunities and live multiplier rates.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#security)

Security

BTC.b uses Lombard's full security stack:

Layer

Function

Security Consortium

15 independent institutions validate all operations

CubeSigner (HSM)

Keys stored in hardware, never exposed

Bascule Drawbridge

Secondary verification for all mints

Chainlink Proof of Reserve

Real-time verification of BTC backing

Chainlink CCIP

Secure cross-chain messaging

Members include OKX, Galaxy, DCG, Wintermute, Figment, Kiln, Antpool, F2Pool, and Kraken.

Every mint and redeem requires majority consensus among validators.

#### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#verify-reserves)

Verify Reserves

Check Chainlink's Proof of Reserve feeds, which update every 10 minutes, to verify BTC.b is fully backed: [Proof of Reserve](https://docs.lombard.finance/learn/transparency/oracles-and-price-feeds#proof-of-reserve)
.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#history)

History

BTC.b was created by Ava Labs in 2022 for the Avalanche ecosystem. At acquisition (October 2025), it had approximately $550M in circulation and deep DeFi integrations.

Lombard acquired BTC.b's infrastructure and assets to expand it into a multi-chain Bitcoin standard. All existing integrations and user balances were maintained, token addresses remain unchanged.

* * *

### 

[hashtag](https://docs.lombard.finance/use/use-btc.b#next-steps)

Next Steps

*   [BTC.b FAQ](https://docs.lombard.finance/use/faq/btc.b-faq)
     — Common questions
    
*   [Access DeFi](https://docs.lombard.finance/use/access-defi)
     — Use BTC.b across protocols
    
*   [Lux Rewards](https://docs.lombard.finance/learn/community/lux-rewards)
     — Learn how BTC.b earns Lux in Season 3
    

[PreviousFeeschevron-left](https://docs.lombard.finance/use/use-lbtc/fees)
[NextUse Bitcoin Earnchevron-right](https://docs.lombard.finance/use/use-bitcoin-earn)

Last updated 11 days ago

*   [What You Get](https://docs.lombard.finance/use/use-btc.b#what-you-get)
    
*   [BTC.b vs LBTC](https://docs.lombard.finance/use/use-btc.b#btc.b-vs-lbtc)
    
*   [Mint BTC.b](https://docs.lombard.finance/use/use-btc.b#mint-btc.b)
    
*   [Redeem BTC.b](https://docs.lombard.finance/use/use-btc.b#redeem-btc.b)
    
*   [Bridge BTC.b Between Chains](https://docs.lombard.finance/use/use-btc.b#bridge-btc.b-between-chains)
    
*   [Earn Lux with BTC.b](https://docs.lombard.finance/use/use-btc.b#earn-lux-with-btc.b)
    
*   [Security](https://docs.lombard.finance/use/use-btc.b#security)
    
*   [History](https://docs.lombard.finance/use/use-btc.b#history)
    
*   [Next Steps](https://docs.lombard.finance/use/use-btc.b#next-steps)

---

# $BARD FAQ | Lombard Docs

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#usdbard-faq)

$BARD FAQ


--------------------------------------------------------------------------------------

Questions about the $BARD token, airdrop, staking, and governance.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#basics)

Basics

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-usdbard)

What is $BARD?

$BARD is Lombard's governance and utility token. It enables:

*   **Governance** — Vote on protocol decisions, validator sets, fees, and roadmap
    
*   **Security** — Stake $BARD to help secure LBTC cross-chain transfers
    
*   **Protocol access** — Priority access and preferred terms for Lombard products
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-the-difference-between-usdbard-and-lbtc)

What is the difference between $BARD and LBTC?

Token

Purpose

LBTC

Yield-bearing Bitcoin representation for DeFi

$BARD

Governance, security, and protocol utility

Both are core to Lombard but serve different purposes. LBTC is backed by BTC; $BARD is not.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-the-total-supply)

What is the total supply?

1,000,000,000 $BARD (1 billion). Fixed supply at TGE—no inflation.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-was-the-initial-circulating-supply)

What was the initial circulating supply?

22.5% at launch, with the remainder unlocking over 48 months.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#airdrop)

Airdrop

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#who-was-eligible-for-the-airdrop)

Who was eligible for the airdrop?

Season 1 distributed 4% of total supply to users who:

*   Held LBTC
    
*   Used LBTC in DeFi protocols
    
*   Earned Lux points through the Luminary Program
    

Season 2 allocated 1.5% of total supply (15,000,000 BARD) based on Lux earned during the six-month period from September 18, 2025 to March 18, 2026.

Claims opened March 30, 2026 at 09:00 ET.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#how-was-my-allocation-calculated)

How was my allocation calculated?

Allocations were based on Lux points earned relative to the community total. The rate was the same for all participants.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#i-checked-the-eligibility-page-and-it-shows-0.-why)

I checked the eligibility page and it shows 0. Why?

Ensure you are:

1.  Connected to the correct wallet
    
2.  On the correct network
    
3.  Actually qualified through eligible activities
    

Allocations are based strictly on on-chain activity and Lux points, not Kaito or Buidlpad allocations.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#can-i-transfer-my-allocation-before-claiming)

Can I transfer my allocation before claiming?

No. The checker is read-only. Tokens do not exist in your wallet until you claim them. There is nothing to transfer or sell before claiming.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#when-can-i-claim)

When can I claim?

**Active Claim Events**

**Season 1 Phase 2:**

Opens March 18, 2026 at 09:00 ET at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

Distributes the remaining 50% of Season 1 allocations (1.5% of total supply) plus all referral Lux rewards.

Referral Lux was excluded from the TGE distribution and is available exclusively in Phase 2.

90-day claim window.

**Season 2:**

Opens March 30, 2026 at 09:00 ET at [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

Distributes 100% of the Season 2 allocation (1.5% of total supply, 15,000,000 BARD).

Allocations based on Lux earned between September 18, 2025 and March 18, 2026 00:00 UTC.

90-day claim window.

**Upcoming:**

Season 1 Phase 3 (1% of supply) is scheduled for September 2026.

**Important:**

Unclaimed tokens from any claim window are returned to the Ecosystem Fund after 90 days and cannot be recovered.

Kaito Yapper rewards are claimed separately at [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)
, not through [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#how-do-i-claim)

How do I claim?

1.  Go to [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
    
2.  Connect the wallet you used for Lombard activity
    
3.  Agree to the terms and conditions
    
4.  Sign the claim transaction
    
5.  Tokens are sent to your connected wallet
    

The claim destination cannot be changed after submission.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#i-earned-lux-on-sui.-how-do-i-claim)

I earned Lux on Sui. How do I claim?

Connect both your Sui wallet and an Ethereum wallet. The claim process bridges your Sui allocation to Ethereum, since $BARD only exists on Ethereum mainnet.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-about-kaito-yappers-rewards)

What about Kaito Yappers rewards?

Kaito Yappers rewards are distributed through Kaito directly, not through the Lombard claim portal: [kaito.ai/airdropsarrow-up-right](https://kaito.ai/airdrops)

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#staking)

Staking

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#how-does-usdbard-staking-work)

How does $BARD staking work?

When you stake $BARD:

1.  Tokens are deposited into a Mellow vault
    
2.  You receive stBARD (vault share)
    
3.  stBARD increases in redeemable $BARD over time
    
4.  No claiming needed—rewards auto-compound
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-does-staked-usdbard-secure)

What does staked $BARD secure?

Staked $BARD backs a cryptoeconomic guarantee layer for LBTC cross-chain transfers via Chainlink CCIP. If transfers proceed correctly, stakers earn rewards. If issues occur, staked collateral can be slashed.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-the-apy-for-staking)

What is the APY for staking?

The staking APY followed a four-stage epoch curve: 240% at TGE (Epoch 1), stepping down to 120% (Epoch 2), 60% (Epoch 3), and the current sustained rate of 30% (Epoch 4).

Epochs 1 through 3 have concluded.

The 30% APY is paid in BARD and auto-compounds via stBARD.

Over 25,000 participants have staked BARD, with more than 428,000 BARD distributed in rewards.

The maximum individual stake is 250,000 BARD.

Users who claim and stake BARD between March 18 and March 30, 2026 receive a 25% bonus boost on top of the 30% APY, for a total of 55% APY, lasting three months until June 18, 2026.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#how-do-i-stake-usdbard)

How do I stake $BARD?

1.  Go to [app.lombard.financearrow-up-right](https://app.lombard.finance/)
    
2.  Connect your Ethereum wallet
    
3.  Approve $BARD spending
    
4.  Enter the amount to stake
    
5.  Confirm the transaction
    
6.  Receive stBARD
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#how-long-is-the-unstaking-period)

How long is the unstaking period?

21 days. This aligns with Symbiotic's security model—funds remain slash-eligible until the epoch closes.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#can-i-stake-from-multiple-wallets)

Can I stake from multiple wallets?

Yes, but each wallet must be staked separately. Your stBARD positions are not combined.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#is-there-a-lux-bonus-for-staking)

Is there a Lux bonus for staking?

The $BARD Staker badge applied in Season 2. It is no longer active in Season 3.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-season-3)

What is Season 3?

Season 3 of the Luminary Program began immediately after Season 2 ended on March 18, 2026 at 00:00 UTC.

Season 3 introduces a fundamental change: Lux is now earned exclusively through active DeFi deployment of LBTC or BTC.b into eligible protocols. Passive holding of either asset does not generate Lux. BTC.b enters the Lux ecosystem for the first time.

Season 3 has three multiplier tiers:

*   DEX Liquidity and Others at 1x (Uniswap, Curve, Fluid, Aerodrome, Meteora, Etherfi)
    
*   Lending Collateral at 3x (Aave v3/4, Morpho, Spark, Fluid, Euler, Juplend, Kamino)
    
*   Bitcoin Earn and Lombard Strategies at 6x
    

Eligible chains: Ethereum, Solana, Avalanche, MegaETH, and Base. Additional protocols and chains are expected during the season.

Badges, daily tap-ins, and special events have been discontinued. The referral program continues unchanged at 20%/10%.

Bitcoin Earn and Lombard Strategies currently earn Lux at the 6x multiplier. During Season 3, these products will transition to direct BARD streaming, where BARD is distributed continuously to vault participants. When BARD streaming goes live, the Lux multiplier for these vaults drops to zero and participants begin receiving BARD directly. Details on timing will be announced.

See the [Lux Rewards page](https://docs.lombard.finance/learn/community/lux-rewards)
 for full Season 3 rules.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#technical)

Technical

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#which-chain-is-usdbard-on)

Which chain is $BARD on?

Ethereum mainnet only. The token contract exists exclusively on Ethereum.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-stbard)

What is stBARD?

stBARD is the liquid staking token you receive when staking $BARD. It follows the ERC-4626 vault standard:

*   Represents your share of the staking vault
    
*   Increases in redeemable $BARD as rewards accrue
    
*   Compatible with DeFi protocols that support ERC-4626
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-is-symbiotics-role)

What is Symbiotic's role?

Symbiotic provides the restaking layer. Staked $BARD is used as collateral to back LBTC cross-chain transfers. Symbiotic's design keeps funds slash-eligible over a defined window to align economic incentives with secure interoperability.

#### 

[hashtag](https://docs.lombard.finance/use/faq/usdbard-faq#what-are-the-vault-caps)

What are the vault caps?

*   **BARD vault** — 20M $BARD
    
*   **LINK vault** — $100M LINK
    

These vaults serve as the collateral base for the monitoring network.

[PreviousBTC.b FAQchevron-left](https://docs.lombard.finance/use/faq/btc.b-faq)
[NextTroubleshootingchevron-right](https://docs.lombard.finance/use/troubleshooting)

Last updated 12 days ago

*   [$BARD FAQ](https://docs.lombard.finance/use/faq/usdbard-faq#usdbard-faq)
    
*   [Basics](https://docs.lombard.finance/use/faq/usdbard-faq#basics)
    
*   [Airdrop](https://docs.lombard.finance/use/faq/usdbard-faq#airdrop)
    
*   [Staking](https://docs.lombard.finance/use/faq/usdbard-faq#staking)
    
*   [Technical](https://docs.lombard.finance/use/faq/usdbard-faq#technical)

---

# Troubleshooting | Lombard Docs

Get help when something goes wrong. Lombard offers multiple support channels depending on the urgency and complexity of your issue.

* * *

### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#contact-support)

Contact Support

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#live-chat-fastest)

Live Chat (Fastest)

Available directly on the Lombard website. Click the chat icon in the bottom right corner of any page.

→ [lombard.financearrow-up-right](https://www.lombard.finance/)

**Best for:** Quick questions, real-time guidance, urgent issues

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#discord-tickets-fastest)

Discord Tickets (Fastest)

Open a support ticket in the Lombard Discord server for detailed assistance.

→ [discord.gg/lombardfinancearrow-up-right](https://discord.gg/lombardfinance)

**Best for:** Complex issues, transaction investigations, technical problems

**How to open a ticket:**

1.  Join the Lombard Discord
    
2.  Go to the #support channel
    
3.  Click **Create Ticket**
    
4.  Describe your issue with relevant details (transaction hash, wallet address, screenshots).
    

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#email)

Email

For formal inquiries, partnership requests, or sensitive issues.

→ **[\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
**

**Best for:** Account issues, formal complaints, partnership inquiries

**Response time:** 24–48 hours

* * *

### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#common-issues)

Common Issues

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#staking-and-minting)

Staking & Minting

**My BTC deposit is not showing**

Your deposit needs 6 Bitcoin confirmations before LBTC can be minted. This typically takes 40–60 minutes but can be longer during network congestion.

*   Check your transaction on a Bitcoin block explorer
    
*   Verify you sent to the correct deposit address
    
*   Wait for 6 confirmations
    

**LBTC did not auto-mint**

During high gas periods, auto-mint is disabled to protect you from fees. Mint manually:

1.  Go to [lombard.finance/app/activityarrow-up-right](https://www.lombard.finance/app/activity/)
    .
    
2.  Find your pending deposit.
    
3.  Click **Mint** and confirm the transaction.
    

**I received less LBTC than expected**

On Ethereum, a small amount of LBTC is deducted to cover gas costs for minting. Other chains have no minting fee. See [Fees](https://docs.lombard.finance/use/use-lbtc/fees#minting-fee)
.

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#unstaking)

Unstaking

**My unstake is taking longer than 9 days**

The 9-day period is a minimum. If there are processing delays:

1.  Check your transaction status on the block explorer.
    
2.  Contact support with your transaction hash.
    
3.  The Security Consortium can investigate stuck transactions.
    

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#vault-withdrawals)

Vault Withdrawals

**My vault withdrawal was cancelled**

This usually happens when your wallet auto-revokes approvals. Withdrawals require approval to remain active for the entire 3-day processing period.

**Fix:** Check your wallet security settings and disable automatic approval revocation, then try again.

**I cannot start a new withdrawal**

You can only have one active withdrawal per vault at a time. Wait for your current withdrawal to complete before starting another.

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#bridging)

Bridging

**My bridge transaction is stuck**

Bridge transactions typically complete in 2–15 minutes. If stuck:

1.  Check the transaction on both source and destination chain explorers
    
2.  Verify CCIP status at [ccip.chain.linkarrow-up-right](https://ccip.chain.link/)
    .
    
3.  If burned but not minted, contact support, the Security Consortium can resolve this.
    

**LBTC did not arrive on destination chain**

Wait at least 15 minutes before assuming failure. If still missing:

1.  Confirm the burn transaction succeeded on the source chain
    
2.  Check the destination wallet address is correct
    
3.  Contact support with both transaction hashes
    

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#wallet-issues)

Wallet Issues

**Balance shows zero in the staking UI (OKX Wallet)**

OKX Wallet stores BTC across multiple address types. In OKX Wallet:

1.  Select your BTC asset
    
2.  Switch to the address type with your balance (Native SegWit or Taproot)
    
3.  Refresh the Lombard page
    

**LBTCv not showing in my wallet**

Manually add the token:

Network

LBTCv Address

Ethereum

`0x5401b8620E5FB570064CA9114fd1e135fd77D57c`

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#lux-and-rewards)

Lux & Rewards

**My Lux balance seems wrong**

Lux updates hourly. If you recently made a deposit or DeFi action, wait for the next update cycle.

**Multipliers not applying**

Only whitelisted integrations earn Lux multipliers. Check the [Strategiesarrow-up-right](https://www.lombard.finance/app/)
 section to confirm your protocol is eligible.

#### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#usdbard)

$BARD

**I cannot claim my airdrop**

1.  Verify you are using the correct wallet (the one used for LBTC activities)
    
2.  Go to [claim.lombard.financearrow-up-right](https://claim.lombard.finance/)
    
3.  Connect and check your allocation
    
4.  If showing 0, you may not be eligible or may be checking the wrong wallet
    

**Staking transaction failed**

Ensure you have enough ETH for gas. $BARD staking is only available on Ethereum mainnet.

* * *

### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#before-contacting-support)

Before Contacting Support

To help us resolve your issue faster, please have ready:

1.  **Wallet address** (source and destination if applicable)
    
2.  **Transaction hash(es)**
    
3.  **Chain(s) involved**
    
4.  **Screenshots** of any error messages
    
5.  **Description** of what you expected vs. what happened
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#security-reminders)

Security Reminders

*   Lombard support will **never** ask for your seed phrase or private keys
    
*   Always verify you are on **lombard.finance** (check the URL)
    
*   Official Discord: [Discord Invitearrow-up-right](https://discord.com/invite/2HG7G69twc)
    
*   Official Twitter/X: @lombardfinance
    
*   Be cautious of DMs from "support" accounts, scammers impersonate official channels
    

If someone asks for your private keys, it is a scam. Report and block immediately.

* * *

### 

[hashtag](https://docs.lombard.finance/use/troubleshooting#feedback)

Feedback

Have suggestions for improving Lombard? We want to hear from you:

*   **Discord:** Share feedback in support channel.
    
*   **Email:** [\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
    .
    

Your input helps us build better Bitcoin infrastructure.

[Previous$BARD FAQchevron-left](https://docs.lombard.finance/use/faq/usdbard-faq)
[NextIntroduction to Bitcoin Connectchevron-right](https://docs.lombard.finance/build/introduction-to-bitcoin-connect)

Last updated 11 days ago

*   [Contact Support](https://docs.lombard.finance/use/troubleshooting#contact-support)
    
*   [Common Issues](https://docs.lombard.finance/use/troubleshooting#common-issues)
    
*   [Before Contacting Support](https://docs.lombard.finance/use/troubleshooting#before-contacting-support)
    
*   [Security Reminders](https://docs.lombard.finance/use/troubleshooting#security-reminders)
    
*   [Feedback](https://docs.lombard.finance/use/troubleshooting#feedback)

---

# General FAQ | Lombard Docs

Questions about Lombard, security, and the protocol.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#about-lombard)

About Lombard

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-is-lombard)

What is Lombard?

Lombard builds assets and infrastructure to bring Bitcoin to life onchain. Founded in April 2024, the protocol has onboarded over $3 billion in BTC across 15+ blockchains and 100+ DeFi integrations.

Lombard's core products:

*   **LBTC:** Yield-bearing Bitcoin (liquid staking token).
    
*   **BTC.b:** 1:1 Bitcoin representation (no yield, simpler).
    
*   **$BARD:** Governance and utility token.
    
*   **Bitcoin Connect:** Developer toolkit for integrating Bitcoin staking and cross-chain operations.
    
*   **DeFi Vaults:** Yield-generating protocols for depositing Bitcoin assets across chains.
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-is-lombard-lux)

What is Lombard Lux?

Lombard Lux: Points earned through active DeFi deployment of LBTC and BTC.b across eligible protocols.

In Season 3, Lux is not earned by holding LBTC or BTC.b passively. Users must deploy assets into whitelisted lending markets, liquidity pools, or vault products to accrue Lux.

Three multiplier tiers apply: DEX Liquidity at 1x, Lending Collateral at 3x, and Bitcoin Earn/Lombard Strategies at 6x.

Eligible chains include Ethereum, Solana, Avalanche, MegaETH, and Base.

Lux converts to BARD in seasonal airdrops based on proportional share of total community Lux.

See the [Lux Rewards page](https://docs.lombard.finance/learn/community/lux-rewards)
 for full details.

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#who-is-behind-lombard)

Who is behind Lombard?

The founding team includes DeFi experts from Polychain, Babylon, Argent, Coinbase, and Maple, all with experience starting and scaling companies in the DeFi space.

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#who-backs-lombard)

Who backs Lombard?

Lombard raised $16 million in seed funding (July 2024) led by Polychain Capital, with participation from, Franklin Templeton, dao5, OKX Ventures, HTX Ventures, Foresight Ventures, Mirana Ventures, Mantle EcoFund, Nomad Capital and Robot Ventures. The round invited strategic partnerships with Bitget, Bybit, OKX, HTX, and Binance.

In September 2025, the $BARD Community Sale hosted by Buidlpad raised $6.75 million from 21,340 participants across 132 countries. It was oversubscribed by 1,400%.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#security)

Security

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#why-is-my-btc-safe-with-lombard)

Why is my BTC safe with Lombard?

Lombard uses multiple security layers:

Layer

Purpose

Security Consortium

14 independent institutions validate all operations

CubeSigner (HSM)

Keys stored in hardware, never exposed during signing

Bascule Drawbridge

Secondary verification for all mints

Multi-party approval

Multiple parties must sign every transaction

Timelocks

Delays on sensitive operations

24/7 monitoring

Real-time threat detection and response

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-audits-has-lombard-completed)

What audits has Lombard completed?

Lombard maintains a long-term auditing program with leading security firms:

*   OpenZeppelin
    
*   Veridise
    
*   Halborn
    

All audit reports are published on GitHub and in the documentation.

→ [Audits Documentation](https://docs.lombard.finance/learn/lombard-security-model/audits)

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#is-there-a-bug-bounty-program)

Is there a bug bounty program?

Yes. Lombard partners with Immunefi for bug bounties up to $250,000. White hat hackers can report vulnerabilities and receive rewards for valid findings.

→ [Immunefi Bug Bounty Program](https://docs.lombard.finance/learn/lombard-security-model/bug-bounty-program)

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-is-the-security-consortium)

What is the Security Consortium?

The Security Consortium is a group of 14 independent organizations that validate and sign critical operations:

*   Staking and unstaking BTC into Babylon
    
*   Minting, burning, and bridging LBTC
    
*   Cross-chain transfers
    

Members include OKX, Galaxy, DCG, Wintermute, Amber Group, Figment, P2P, Kiln, Kraken, Antpool, and F2Pool.

No single member can act unilaterally. Operations require signatures from ⅔ of members.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#risks)

Risks

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-risks-should-i-be-aware-of)

What risks should I be aware of?

**Slashing Risk (LBTC only)** If Finality Providers misbehave on Babylon, staked BTC can be slashed. Lombard works only with reputable validators. BTC.b is not staked through Babylon. Current exposure is 0.1%.

**Depeg Risk** LBTC and BTC.b trade on secondary markets where prices can deviate from redemption value. During unstaking periods (7-9 days), you cannot exit instantly. You can always redeem at the protocol rate through the Lombard app.

**Technical Risk** Smart contract bugs or network attacks could affect funds. Lombard continuously audits contracts and maintains real-time threat monitoring.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#babylon)

Babylon

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#what-is-babylon)

What is Babylon?

Babylon is a shared security protocol that uses Bitcoin to secure Proof-of-Stake networks. It enables BTC holders to stake and earn yield without giving up custody.

Babylon allows systems like PoS chains, L2s, data availability layers, and oracles to gain security from Bitcoin, the largest decentralized crypto asset.

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#how-does-lombard-work-with-babylon)

How does Lombard work with Babylon?

1.  **You stake BTC** into your unique deposit address on Lombard
    
2.  **Lombard stakes into Babylon** through Finality Providers
    
3.  **Babylon generates rewards** for securing PoS networks
    
4.  **You receive LBTC** representing your staked position
    

Lombard provides liquidity (LBTC) while Babylon handles the staking mechanics.

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#why-stake-through-lombard-instead-of-directly-with-babylon)

Why stake through Lombard instead of directly with Babylon?

Staking directly with Babylon locks your BTC. You cannot use it elsewhere. LBTC keeps your Bitcoin liquid while earning the same Babylon staking rewards.

With LBTC you can:

*   Earn yield AND use your Bitcoin in DeFi
    
*   Trade or transfer your position anytime
    
*   Access 15+ chains without bridging native BTC
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#protocol-details)

Protocol Details

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#how-can-i-verify-my-deposit-address-belongs-to-lombard)

How can I verify my deposit address belongs to Lombard?

The deposit address is deterministically generated from your destination chain and wallet address. You can verify it:

1.  In-browser via the Lombard SDK or WebApp
    
2.  Using the open-source verifier: [github.com/lombard-finance/ts-verifierarrow-up-right](https://github.com/lombard-finance/ts-verifier)
    

* * *

#### 

[hashtag](https://docs.lombard.finance/use/faq/general-faq#where-can-i-get-support)

Where can I get support?

*   **Discord:** [discord.com/invite/2HG7G69twcarrow-up-right](https://discord.com/invite/2HG7G69twc)
     (fastest)
    
*   **Website widget:** [lombard.financearrow-up-right](https://www.lombard.finance/)
     (bottom right)
    

[PreviousFAQchevron-left](https://docs.lombard.finance/use/faq)
[NextLBTC FAQchevron-right](https://docs.lombard.finance/use/faq/lbtc-faq)

Last updated 12 days ago

*   [About Lombard](https://docs.lombard.finance/use/faq/general-faq#about-lombard)
    
*   [Security](https://docs.lombard.finance/use/faq/general-faq#security)
    
*   [Risks](https://docs.lombard.finance/use/faq/general-faq#risks)
    
*   [Babylon](https://docs.lombard.finance/use/faq/general-faq#babylon)
    
*   [Protocol Details](https://docs.lombard.finance/use/faq/general-faq#protocol-details)

---

# Privacy Policy | Lombard Docs

This Privacy Policy (“Privacy Policy”) explains how Lombard Finance ("we", "us", "our") collects, uses, shares, and protects user ("you", "your") Personal Information when you visit and interact with our website, services, and software (collectively, "Services"). “Personal Information” means information that identifies, relates to, describes, is reasonably capable of being associated with, or could reasonably be linked, directly or indirectly, with a particular consumer or household.

Please read this Privacy Policy carefully. By using our Services, you agree to the processing of your information in accordance with this Privacy Policy.

1.  **Information Collection**
    
    1.  **Types of Personal Information Collected** Depending on how you interact with the Services, we may collect the following information:
        
        *   Personal identifiers such as your name, IP Address, email address, or other similar information you chose to provide.
            
            *   Wallet and transaction information, including any wallet addresses you connect to the Services, and information about the transactions and balances associated with such wallets.
                
            *   Communications between you and us. When you communicate with us we may collect and save a record of your communication and any Personal Information provided during the communication.
                
            *   Usage data and automatically collected technical information such as traffic data, logs, and other communication data and the resources that you access and use on the Service.
                
            *   Information about your computer and internet connection, including, but not limited to, the type of device you use, the IP address of your device, your operating system, the type of Internet browser you use, unique device identifiers and other diagnostic data.
                
            
        
    2.  **Sources of Personal Information** We collect Personal Information from various sources including data directly from you, from third parties, from public sources, and from automated systems.
        
    
2.  **Use of Personal Information** We use the information we collect to:
    
    *   Provide, maintain, promote, and improve our Services.
        
    *   Respond to your comments, questions, and requests.
        
    *   Conduct research and analysis for product development and improvements.
        
    *   Send you technical notices, updates, security alerts, and administrative messages.
        
    
3.  **Disclosure of Personal Information** Personal Information may be shared in the following circumstances:
    
    *   **Service providers** We may disclose Personal Information to third-party service providers who use this information to perform services for us, such as hosting providers, auditors, advisors, consultants, customer service and/or support providers and other similar service providers.
        
    *   **Consortium Members** Your use of the Services may result in certain Personal Information being shared with Protocol operators and participants (e.g., validators, nodes, finality providers, non-custodial key managers, oracles, etc.) for the purpose of providing the Services, including the intended functions of the App.
        
    *   **Advertising, Ecosystem, and Marketing Partners** We may share Personal Information with third parties that provide advertising, campaign measurement, online and/or mobile analytics, and related services, or with third parties who may display your wallet and transaction information in connection with the provision of their own services. These third parties may receive or access browsing and/or other data about your use of the Services, in order to help us better reach individuals with relevant ads and/or measure our ad campaigns, and/or to better understand how individuals interact with our Services overtime and across devices, or to provide their own services.
        
    *   **Law Enforcement** Under certain circumstances, we may be required to disclose your Personal Information if required to do so by law or in response to valid requests by public authorities (e.g. a court or a government agency).
        
    *   **Legal Requirements** We may disclose your Personal Information in the good faith belief that such action is necessary to comply with a legal obligation, to protect and defend our rights and property, prevent or investigate possible wrongdoing in connection with the Service, or to protect against legal liability.
        
    *   **Business Transfers** We may disclose and/or transfer Personal Information as part of any actual or contemplated merger, sale, transfer of assets, acquisition, financing and/or restructuring of all or part of our business, bankruptcy or similar event, including related to due diligence conducted prior to such event where permitted by law.
        
    
4.  **Cookies** Cookies can be used to recognize you when you visit Lombard Finance, remember your preferences, and give you a personalized experience that’s in line with your settings. Cookies also make your interactions with Lombard Finance faster and more secure. We use cookies or similar technologies on our Services for a variety of purposes, including to ensure that the Service functions work, as well as for analytics and advertising.
    
5.  **Security of Data** The security of your data is important to us but remember that no method of transmission over the Internet or method of electronic storage is 100% secure. While we strive to use commercially acceptable means to protect your Personal Information, we cannot guarantee its absolute security. We also have procedures to deal with any suspected Personal Information breach, and we will notify you and any applicable regulator when we are legally required to do so.
    
6.  **Links to Other Sites** Our Service may contain links to other sites that are not operated by us. If you click a third party link, you will be directed to that third party's site. We strongly advise you to review the Privacy Policy of every site you visit. We have no control over and assume no responsibility for the content, privacy policies or practices of any third party sites or services.
    
7.  **Children's Privacy** We do not knowingly collect personally identifiable information from anyone under the age of 18. If you are a parent or guardian and you are aware that your child has provided us with Personal Information, please contact us. If we become aware that we have collected Personal Information from children without verifiable parental consent, we will take steps to remove that information from our servers.
    
8.  **Changes to This Privacy Policy** We may change this Privacy Policy from time to time. If we make changes, we will notify you by revising the date at the top of the policy and, in some cases, we may provide you with additional notice. **Contacting us** If you have any questions about this Privacy Policy, please contact us at: [\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
    

[PreviousTerms of Servicechevron-left](https://docs.lombard.finance/resources/terms-of-service)

Last updated 2 months ago

---

# User Guides | Lombard Docs

User Guides walk through implementing each SDK capability from start to finish. Builders get concrete endpoints, parameter specifications, integration examples, and execution details for flows like asset minting, cross-chain routing, yield configuration, and vault deployment.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides#quick-links)

Quick Links:

[Start herechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here)

Install the SDK, configure your environment, connect wallets, and make your first API calls. Covers integration workflow, partner setup, and testnet configuration.

[Conceptschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts)

Understand how SDK actions work. Learn about status states, event handling, error recovery, deposit address generation, fee authorization, and referral tracking.

[Data APIchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api)

Fetch deposits, unstakes, points, and exchange rates. Query Lombard's backend APIs to retrieve transaction history and account data.

[Capabilitieschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities)

Implement SDK actions for staking, depositing, deploying to vaults, unstaking, and redeeming. Includes parameter specifications and execution flows for each operation.

[Referencechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference)

Technical reference documentation for types, interfaces, and advanced configurations.

[PreviousThe SDK Playgroundchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/the-sdk-playground)
[NextStart herechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here)

Last updated 2 months ago

---

# LBTC FAQ | Lombard Docs

Questions about staking BTC, minting LBTC, yield, and unstaking.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#basics)

Basics

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-is-lbtc)

What is LBTC?

LBTC is a yield-bearing token representing BTC staked on Babylon through Lombard. It allows you to earn staking rewards while keeping your Bitcoin liquid for DeFi.

*   Fully backed by native BTC
    
*   Earns ~0.41% APY (14-day trailing)
    
*   Available on 15+ chains
    
*   Can be used as collateral, traded, or deposited into protocols
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#is-lbtc-different-if-i-buy-it-vs-stake-for-it)

Is LBTC different if I buy it vs stake for it?

No. LBTC is perfectly fungible regardless of how you acquired it. Buying LBTC on a DEX gives you the same yield and functionality as minting it by staking BTC.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-is-the-current-apy)

What is the current APY?

Check the current 14-day trailing APY at [lombard.financearrow-up-right](https://www.lombard.finance/)
. Yield varies based on Babylon staking rewards and network conditions.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#staking)

Staking

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#how-do-i-stake-btc)

How do I stake BTC?

1.  Go to [lombard.finance/app/stakearrow-up-right](https://www.lombard.finance/app/stake/)
    
2.  Connect your destination wallet
    
3.  Send BTC to the generated deposit address
    
4.  Wait for 6 Bitcoin confirmations (~40-60 minutes)
    
5.  LBTC mints automatically to your wallet
    

See Use LBTC for the full guide. See [Use LBTC](https://docs.lombard.finance/use/use-lbtc)
 for the full guide.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-is-the-minimum-deposit)

What is the minimum deposit?

The minimum is approximately 0.0002 BTC, but check the app for the current threshold. There is no maximum deposit size.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#why-did-i-receive-less-lbtc-than-the-btc-i-deposited)

Why did I receive less LBTC than the BTC I deposited?

Two possible reasons:

1.  **Ethereum minting fee** — If you minted on Ethereum, a small amount of LBTC is deducted to cover gas costs. Other chains have no minting fee.
    
2.  **Exchange rate** — LBTC is yield-bearing, so 1 LBTC is worth more than 1 BTC. You receive slightly less LBTC, but it represents the same BTC value.
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#why-is-my-lbtc-taking-so-long-to-mint)

Why is my LBTC taking so long to mint?

After your BTC deposit is detected, the Security Consortium waits for 6 Bitcoin confirmations before minting. This typically takes 40-60 minutes but can be longer during network congestion.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-if-auto-mint-is-disabled)

What if auto-mint is disabled?

During high gas periods, auto-mint pauses to protect you from fees. You can always mint manually:

1.  Go to [lombard.finance/app/activityarrow-up-right](https://www.lombard.finance/app/activity/)
    
2.  Find your pending deposit
    
3.  Click **Mint** and confirm
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-is-the-authorize-network-fee-message)

What is the "Authorize Network Fee" message?

On Ethereum, your wallet prompts you to sign this message to authorize Lombard to deduct a small LBTC fee for minting gas costs. This only appears for Ethereum mints.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#will-i-lose-my-ordinals-or-runes-or-other-inscriptions)

Will I lose my Ordinals or Runes (or other inscriptions)?

When BTC is deposited to Lombard protocol derived addresses, it's important to make sure UTXOs are not spent if they are related to Ordinals (or other non-BTC assets). Any UTXOs spent into the protocol are irrecoverable.

The safest approach is to not select these specific UTXOs in your wallet - i.e. by using a different wallet address for these activities (or manually selecting correct UTXOs in your wallet).

Some wallets may warn you if you are at risk of spending inscribed UTXOs, however many do not.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#will-i-lose-my-ordinals-or-runes-or-other-inscriptions-1)

Will I lose my Ordinals or Runes (or other inscriptions)?

When BTC is deposited to Lombard protocol derived addresses, it is important to make sure UTXOs are not spent if they are related to Ordinals or other non-BTC assets. Any UTXOs spent into the protocol are irrecoverable.

The safest approach is to avoid selecting these specific UTXOs in your wallet. Use a different wallet address for these activities, or manually select the correct UTXOs in your wallet.

Some wallets warn you if you are at risk of spending inscribed UTXOs. Many do not.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#yield)

Yield

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#how-does-lbtc-yield-work)

How does LBTC yield work?

1.  Lombard stakes your BTC with Finality Providers on Babylon
    
2.  Babylon rewards stakers in BABY tokens
    
3.  Lombard sells BABY for BTC
    
4.  The LBTC/BTC exchange rate increases
    

Your LBTC automatically represents more BTC over time. No claiming required.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#do-i-need-to-claim-yield)

Do I need to claim yield?

No. Yield is reflected in the LBTC/BTC exchange rate automatically. Your existing LBTC becomes redeemable for more BTC as yield accrues.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#does-yield-compound)

Does yield compound?

Yes. As the exchange rate increases, your LBTC is worth more BTC, which continues earning yield.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-happened-to-baby-claiming)

What happened to BABY claiming?

Before July 22, 2025, users claimed BABY manually. After this date, LBTC became yield-bearing and all yield auto-compounds. Any unclaimed BABY was redistributed to LBTC holders.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#unstaking)

Unstaking

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#how-do-i-unstake-lbtc)

How do I unstake LBTC?

1.  Go to [lombard.finance/app/unstakearrow-up-right](https://www.lombard.finance/app/unstake/)
    
2.  Enter the amount of LBTC to unstake
    
3.  Provide your Bitcoin withdrawal address
    
4.  Confirm the transaction
    
5.  Wait 9 days for BTC to arrive
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#why-does-unstaking-take-9-days)

Why does unstaking take 9 days?

The 9-day period includes:

*   **7 days** — Babylon's unbonding period
    
*   **2 days** — Lombard's daily rebalancing cycle
    

This is a security requirement. Your staked BTC secures PoS networks during this time.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#can-i-speed-up-unstaking)

Can I speed up unstaking?

No. The 9-day period cannot be shortened. If you need faster liquidity, you can sell LBTC on a DEX (subject to market prices).

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-bitcoin-addresses-are-supported-for-unstaking)

What Bitcoin addresses are supported for unstaking?

Prefix

Type

Supported

`bc1q`

Native SegWit

Yes

`bc1p`

Taproot

Yes

`1...`

Legacy

No

`3...`

Nested SegWit

No

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-is-the-minimum-unstake-amount)

What is the minimum unstake amount?

0.00013300 LBTC (includes the 0.0001 LBTC network security fee).

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#fees)

Fees

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#what-fees-apply-to-lbtc)

What fees apply to LBTC?

Fee

Amount

When

Minting fee

~0.0001 LBTC

Ethereum only

Unstaking fee

0.0001 LBTC

All unstakes

Protocol fee

8% of yield

Deducted from rewards

See Fees for details.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#why-is-there-a-minting-fee-on-ethereum-but-not-other-chains)

Why is there a minting fee on Ethereum but not other chains?

Ethereum gas costs are significantly higher. On other chains, the cost is low enough for Lombard to absorb.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#troubleshooting)

Troubleshooting

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#my-balance-shows-zero-in-the-staking-ui)

My balance shows zero in the staking UI

If you use OKX Wallet, your BTC may be on a different address type:

1.  In OKX Wallet, select your BTC asset
    
2.  Switch to the address type with your balance (Native SegWit or Taproot)
    
3.  Refresh the Lombard page
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#i-sent-btc-but-nothing-happened)

I sent BTC but nothing happened

Your deposit needs 6 Bitcoin confirmations (~40-60 minutes). Check your transaction on a Bitcoin block explorer. If confirmations are complete and LBTC hasn't minted, check the [Activity pagearrow-up-right](https://www.lombard.finance/app/activity/)
 to mint manually.

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#my-lbtc-didnt-auto-mint)

My LBTC didn't auto-mint

Auto-mint may be disabled during high gas periods. Go to [lombard.finance/app/activityarrow-up-right](https://www.lombard.finance/app/activity/)
 and mint manually.

* * *

#### 

[hashtag](https://docs.lombard.finance/use/faq/lbtc-faq#where-can-i-get-support)

Where can I get support?

*   **Discord** — [discord.com/invite/2HG7G69twcarrow-up-right](https://discord.com/invite/2HG7G69twc)
     (fastest)
    
*   **Website widget** — [lombard.financearrow-up-right](https://www.lombard.finance/)
     (bottom right)
    

[PreviousGeneral FAQchevron-left](https://docs.lombard.finance/use/faq/general-faq)
[NextBTC.b FAQchevron-right](https://docs.lombard.finance/use/faq/btc.b-faq)

Last updated 4 days ago

*   [Basics](https://docs.lombard.finance/use/faq/lbtc-faq#basics)
    
*   [Staking](https://docs.lombard.finance/use/faq/lbtc-faq#staking)
    
*   [Yield](https://docs.lombard.finance/use/faq/lbtc-faq#yield)
    
*   [Unstaking](https://docs.lombard.finance/use/faq/lbtc-faq#unstaking)
    
*   [Fees](https://docs.lombard.finance/use/faq/lbtc-faq#fees)
    
*   [Troubleshooting](https://docs.lombard.finance/use/faq/lbtc-faq#troubleshooting)

---

# LBTC GMP Mint Tracing | Lombard Docs

First, you need to get a transaction where LBTC minted or using Etherscan find `MessageDelivered` [event.arrow-up-right](https://etherscan.io/advanced-filter?eladd=0x964677F337d6528d659b1892D0045B8B27183fc0&eltpc=0xb174a65fbe3c90cc24a620623ea3d1702d72ed9960ddf173a437c8f77a62ffac)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FzhtrCZJdYwh7q1BsixeH%252F01-message-delivered-event.png%3Falt%3Dmedia%26token%3De35c34c6-a242-4948-a084-1cc26342c9e0&width=768&dpr=3&quality=100&sign=a1db7ff2&sv=2)

Make sure the caller is the `AssetRouter` address.

Using `nonce` from event find related transaction on Ledger querying:

Find `UTXOSpent` event

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FZ8wt5G2DvqpRswHXbhyl%252FSCR-20260330-kuaj.png%3Falt%3Dmedia%26token%3D67d1ff75-0d99-4c3d-ba68-ab4c079664e9&width=768&dpr=3&quality=100&sign=9afd338f&sv=2)

Decode `value` of `tx_id` from [Base64 to Hex.arrow-up-right](https://base64.guru/converter/decode/hex)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FWFetPLLh3w75OBdhrX67%252F03-base64-to-hex.png%3Falt%3Dmedia%26token%3D651d7500-752a-4bc4-a2ab-b030b08c9eb5&width=768&dpr=3&quality=100&sign=5f4d8462&sv=2)

[Change the ordering of bytes.arrow-up-right](https://blockchain-academy.hs-mittweida.de/litte-big-endian-converter/)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FI9YptGxfNPmGYpd243tw%252F04-byte-ordering.png%3Falt%3Dmedia%26token%3D87d951d6-3e68-4d4a-9682-2d1b2eb78eb3&width=768&dpr=3&quality=100&sign=2edb59f0&sv=2)

The big endian result is `txid`. `Vout` from event is number of output.

[PreviousGMP Redeem Tracingchevron-left](https://docs.lombard.finance/build/direct-integrations/gmp-redeem-tracing)
[NextHow to Find Out Unstake Feechevron-right](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee)

Last updated 21 hours ago

Copy

    https://mainnet-rpc.lombard-fi.com/tx_search?query="ledger.gmp.MessageSent.nonce='\"77\"'"&prove=true

---

# Brand Assets | Lombard Docs

[hashtag](https://docs.lombard.finance/resources/brand-assets#brand-assets)

Brand Assets


---------------------------------------------------------------------------------------------

Official Lombard logos, icons, and brand materials for partners, media, and integrations.

* * *

### 

[hashtag](https://docs.lombard.finance/resources/brand-assets#brand-kit)

Brand Kit

The brand kit includes Lombard logos, LBTC and BTC.b token icons, and $BARD assets in multiple formats (SVG, PNG) optimized for both light and dark backgrounds.

→ Request the Lombard Brand Kit: [\[email protected\]envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#fd8e888d8d928f89bd9192909f9c8f99d39b94939c939e98)

* * *

### 

[hashtag](https://docs.lombard.finance/resources/brand-assets#brand-guidelines)

Brand Guidelines

Our brand guidelines cover logo usage, color palette, typography, and visual standards. Review these before using Lombard assets in your materials.

file-pdf

22MB

[lombard\_brand\_guidelines.pdf](https://1161095600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl7wTwC5uXA2Yk5tvZMBg%2Fuploads%2FUTYde7jeqUobV5WxVtqX%2Flombard_brand_guidelines.pdf?alt=media&token=fd8fbe5c-e781-4f27-9986-512616d96b8d)

PDF

downloadDownload[arrow-up-right-from-squareOpen](https://1161095600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl7wTwC5uXA2Yk5tvZMBg%2Fuploads%2FUTYde7jeqUobV5WxVtqX%2Flombard_brand_guidelines.pdf?alt=media&token=fd8fbe5c-e781-4f27-9986-512616d96b8d)

* * *

### 

[hashtag](https://docs.lombard.finance/resources/brand-assets#usage)

Usage

These assets are provided for partners, media, and protocol integrations. Please use official files without modification and follow the guidelines for proper representation.

[PreviousHow to Find Out Unstake Feechevron-left](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee)
[Next$BARD Token Airdrop Terms and Conditionschevron-right](https://docs.lombard.finance/resources/bard-airdrop-terms)

Last updated 2 months ago

*   [Brand Assets](https://docs.lombard.finance/resources/brand-assets#brand-assets)
    
*   [Brand Kit](https://docs.lombard.finance/resources/brand-assets#brand-kit)
    
*   [Brand Guidelines](https://docs.lombard.finance/resources/brand-assets#brand-guidelines)
    
*   [Usage](https://docs.lombard.finance/resources/brand-assets#usage)

---

# UK Residents | Lombard Docs

Due to the potential for losses, the Financial Conduct Authority (FCA) considers this investment to be high risk.

The UK financial regulator, [the Financial Conduct Authorityarrow-up-right](https://www.fca.org.uk/)
 (‘FCA’), has expanded the scope of the financial promotions regime to enhance protections for UK users investing in cryptoassets. All cryptoasset firms - like Lombard - who market to UK consumers have to comply with the new rules from 8 October 2023.

Lombard Finance Ltd is not authorized or regulated by the Financial Conduct Authority (FCA), and accordingly, the protections provided by the UK regulatory system will not be available to you when using the products and services provided by Lombard Finance Ltd. It is your responsibility to ascertain whether you are permitted to use the products and services provided by Lombard Finance Ltd according to applicable laws or regulations. By accessing this website and the products and services available through it, you acknowledge and confirm that you are a company or partnership with share capital or net assets of at least £5m or a trust with total cash and investments of at least £10m, or that you have professional experience in matters relating to investments and your ordinary activities involve you in dealing in cryptoassets for the purpose of a business carried on by you. You also acknowledge that cryptoassets are high risk investments and that you deal in them at your own risk.

#### 

[hashtag](https://docs.lombard.finance/resources/uk-residents#what-are-the-key-risks)

What are the key risks?

**1\. You could lose all the money you invest**

*   The performance of most cryptoassets can be highly volatile, with their value dropping as quickly as it can rise. You should be prepared to lose all the money you invest in cryptoassets.
    
*   The cryptoasset market is largely unregulated. There is a risk of losing money or any cryptoassets you purchase due to risks such as cyber-attacks, financial crime and firm failure.
    

**2\. You should not expect to be protected if something goes wrong**

*   The Financial Services Compensation Scheme (FSCS) doesn’t protect this type of investment because it’s not a ‘specified investment’ under the UK regulatory regime – in other words, this type of investment isn’t recognised as the sort of investment that the FSCS can protect. Learn more by using the FSCS investment protection checker [herearrow-up-right](https://www.fscs.org.uk/check/investment-protection-checker/)
    .
    
*   Protection from the Financial Ombudsman Service (FOS) does not cover poor investment performance. If you have a complaint against an FCA regulated firm, FOS may be able to consider it. Learn more about FOS protection [herearrow-up-right](https://www.financial-ombudsman.org.uk/consumers)
    .
    

**3\. You may not be able to sell your investment when you want to**

*   There is no guarantee that investments in cryptoassets can be easily sold at any given time. The ability to sell a cryptoasset depends on various factors, including the supply and demand in the market at that time.
    
*   Operational failings such as technology outages, cyber-attacks and comingling of funds could cause unwanted delay and you may be unable to sell your cryptoassets at the time you want.
    

**4\. Cryptoasset investments can be complex**

*   Investments in cryptoassets can be complex, making it difficult to understand the risks associated with the investment.
    
*   You should do your own research before investing. If something sounds too good to be true, it probably is.
    

**5\. Don’t put all your eggs in one basket**

*   Putting all your money into a single type of investment is risky. Spreading your money across different investments makes you less dependent on any one to do well.
    
*   A good rule of thumb is not to invest more than 10% of your money in high-risk investments. Learn more [herearrow-up-right](https://www.fca.org.uk/investsmart/5-questions-ask-you-invest)
    .
    

If you are interested in learning more about how to protect yourself, visit the FCA’s website [herearrow-up-right](https://www.fca.org.uk/investsmart)
.

For further information about cryptoassets, visit the FCA’s website [herearrow-up-right](https://www.fca.org.uk/investsmart/crypto-basics)
.

[Previous$BARD Token Airdrop Terms and Conditionschevron-left](https://docs.lombard.finance/resources/bard-airdrop-terms)
[NextTerms of Servicechevron-right](https://docs.lombard.finance/resources/terms-of-service)

---

# Non-EVM | Lombard Docs

This section addresses integration patterns for major non-EVM blockchain ecosystems, specifically Solana, Sui, and Starknet. It provides chain-specific guidance for unstaking operations and asset management, ensuring developers can build cross-chain applications that extend beyond the Ethereum ecosystem.

[PreviousEVM Withdrawchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/evm/evm-withdraw)
[NextSolana Depositchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/non-evm/solana-deposit)

Last updated 2 months ago

---

# BTC.b FAQ | Lombard Docs

Questions about BTC.b, minting, redeeming, and how it compares to other Bitcoin assets.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#basics)

Basics

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#what-is-btc.b)

What is BTC.b?

BTC.b is a permissionless, decentralized representation of Bitcoin on multiple blockchains. Each BTC.b is backed 1:1 by native Bitcoin held through Lombard's security infrastructure.

*   No yield (unlike LBTC)
    
*   1 BTC.b = 1 BTC always
    
*   No KYC required
    
*   Available on Ethereum, Avalanche, Solana, and more
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#where-did-btc.b-come-from)

Where did BTC.b come from?

BTC.b was originally created by Ava Labs for the Avalanche ecosystem in 2022. In October 2025, Lombard acquired BTC.b's infrastructure and assets to expand it into a multi-chain Bitcoin standard. All existing integrations and user balances were maintained.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#why-use-btc.b-instead-of-lbtc)

Why use BTC.b instead of LBTC?

BTC.b is simpler. It maintains a pure 1:1 peg with Bitcoin, making it easier to:

*   Integrate into protocols
    
*   Calculate positions
    
*   Understand your holdings
    

Choose BTC.b if you want straightforward Bitcoin representation without yield complexity. Choose LBTC if you want to earn while holding.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#btc.b-vs-other-bitcoin-assets)

BTC.b vs Other Bitcoin Assets

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#how-does-btc.b-compare-to-wbtc)

How does BTC.b compare to WBTC?

Feature

BTC.b

WBTC

KYC required

No

Yes (via merchants)

Minting fee

0%

0.25%

Redemption fee

0.0001 BTC

0.25%

Security model

Decentralized consortium

Centralized custody

Direct mint/redeem

Yes

Via approved merchants only

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#how-does-btc.b-compare-to-cbbtc)

How does BTC.b compare to cbBTC?

Feature

BTC.b

cbBTC

Issuer

Lombard (decentralized)

Coinbase (centralized)

KYC required

No

Via Coinbase account

Geographic restrictions

No

Coinbase availability

Security

14-member consortium

Coinbase custody

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#can-i-convert-between-lbtc-and-btc.b)

Can I convert between LBTC and BTC.b?

Not directly. You need to:

1.  Redeem LBTC → native BTC (9 days)
    
2.  Mint BTC → BTC.b
    

Some DEXs may offer direct swaps depending on liquidity.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#minting-and-redeeming)

Minting & Redeeming

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#how-do-i-mint-btc.b)

How do I mint BTC.b?

1.  Go to the Lombard app
    
2.  Select BTC.b minting
    
3.  Choose your destination chain
    
4.  Send BTC to the generated deposit address
    
5.  Wait for confirmations (3-6 Bitcoin blocks)
    
6.  BTC.b mints to your wallet
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#what-is-the-minimum-mint-amount)

What is the minimum mint amount?

0.0002 BTC (subject to change). There is no maximum.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#will-i-lose-my-ordinals-or-runes-or-other-inscriptions)

Will I lose my Ordinals or Runes (or other inscriptions)?

When BTC is deposited to Lombard protocol derived addresses, it is important to make sure UTXOs are not spent if they are related to Ordinals or other non-BTC assets. Any UTXOs spent into the protocol are irrecoverable.

The safest approach is to avoid selecting these specific UTXOs in your wallet. Use a different wallet address for these activities, or manually select the correct UTXOs in your wallet.

Some wallets warn you if you are at risk of spending inscribed UTXOs. Many do not.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#how-do-i-redeem-btc.b-for-native-btc)

How do I redeem BTC.b for native BTC?

1.  Go to the Lombard app
    
2.  Select BTC.b redemption
    
3.  Enter your Bitcoin destination address
    
4.  Confirm the burn transaction
    
5.  Wait 6 hours for BTC to arrive
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#why-does-redemption-take-6-hours)

Why does redemption take 6 hours?

Security delays protect against potential issues. The process includes verification steps and coordination with the Security Consortium.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#can-i-cancel-a-mint-or-redemption)

Can I cancel a mint or redemption?

*   **Minting** — Cannot be cancelled once BTC is sent to the deposit address
    
*   **Redemption** — Cannot be cancelled once the burn transaction is confirmed
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#fees)

Fees

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#what-fees-apply-to-btc.b)

What fees apply to BTC.b?

Action

Fee

Minting

0%

Redemption

0.0001 BTC

Compare this to WBTC's 0.25% minting and redemption fees.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#why-does-btc.b-have-lower-fees-than-wbtc)

Why does BTC.b have lower fees than WBTC?

Lombard operates on a decentralized model without intermediary merchants. This eliminates middleman fees while maintaining security through the consortium.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#security)

Security

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#is-btc.b-safe)

Is BTC.b safe?

BTC.b uses Lombard's full security stack:

*   **15-member Security Consortium** — Including OKX, Galaxy, Kraken, DCG, and more
    
*   **Hardware Security Modules** — Keys never leave secure hardware
    
*   **Chainlink Proof of Reserve** — Independent verification of BTC backing
    
*   **Multiple audits** — OpenZeppelin, Veridise, Halborn
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#how-can-i-verify-btc.b-is-fully-backed)

How can I verify BTC.b is fully backed?

Chainlink Proof of Reserve provides real-time verification that BTC.b supply is fully backed by native Bitcoin. You can check the reserve status on-chain.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#chains-and-wallets)

Chains & Wallets

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#which-chains-support-btc.b)

Which chains support BTC.b?

BTC.b is available on:

*   Ethereum
    
*   Avalanche
    
*   Solana
    
*   Katana
    
*   MegaETH
    
*   More chains coming
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#my-wallet-doesnt-show-btc.b.-how-do-i-add-it)

My wallet doesn't show BTC.b. How do I add it?

Add BTC.b as a custom token using the contract address for your chain. Most wallets auto-detect tokens after receiving them, but manual addition ensures visibility.

Check Smart Contracts for contract addresses. Check [Smart Contracts](https://docs.lombard.finance/learn/transparency/smart-contracts)
 for contract addresses.

* * *

### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#troubleshooting)

Troubleshooting

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#i-sent-btc-but-didnt-receive-btc.b)

I sent BTC but didn't receive BTC.b

Minting requires 3-6 Bitcoin confirmations. Check:

1.  Bitcoin network congestion
    
2.  Confirmation count on a block explorer
    
3.  The Activity page in the Lombard app
    

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#i-sent-to-the-wrong-address)

I sent to the wrong address

If you sent to an incorrect address, funds cannot be recovered. Always verify addresses before sending. The deterministic address system encodes your destination details to help prevent errors.

#### 

[hashtag](https://docs.lombard.finance/use/faq/btc.b-faq#where-can-i-get-support)

Where can I get support?

*   **Discord** — [discord.com/invite/2HG7G69twcarrow-up-right](https://discord.com/invite/2HG7G69twc)
     (fastest)
    
*   **Website widget** — [lombard.financearrow-up-right](https://www.lombard.finance/)
     (bottom right)
    

[PreviousLBTC FAQchevron-left](https://docs.lombard.finance/use/faq/lbtc-faq)
[Next$BARD FAQchevron-right](https://docs.lombard.finance/use/faq/usdbard-faq)

Last updated 4 days ago

*   [Basics](https://docs.lombard.finance/use/faq/btc.b-faq#basics)
    
*   [BTC.b vs Other Bitcoin Assets](https://docs.lombard.finance/use/faq/btc.b-faq#btc.b-vs-other-bitcoin-assets)
    
*   [Minting & Redeeming](https://docs.lombard.finance/use/faq/btc.b-faq#minting-and-redeeming)
    
*   [Fees](https://docs.lombard.finance/use/faq/btc.b-faq#fees)
    
*   [Security](https://docs.lombard.finance/use/faq/btc.b-faq#security)
    
*   [Chains & Wallets](https://docs.lombard.finance/use/faq/btc.b-faq#chains-and-wallets)
    
*   [Troubleshooting](https://docs.lombard.finance/use/faq/btc.b-faq#troubleshooting)

---

# Data API | Lombard Docs

This section documents the SDK's built-in data-fetching methods for querying Lombard's backend services. Developers can retrieve deposit and unstake transaction history for any address, fetch Lux points balances across seasons, access current exchange ratios between BTC and LBTC, and look up existing Bitcoin deposit addresses, enabling rich dashboards and transaction tracking without direct backend integration.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api#quick-links)

Quick Links:

[API Methodschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods)

Query deposits, unstakes, Lux points, exchange ratios, and existing deposit addresses. Complete reference for all data-fetching methods available through `sdk.api.*`.

[PreviousReferral Systemchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system)
[NextAPI Methodschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods)

Last updated 2 months ago

---

# BTC.b to LBTC and LBTC to BTC.b Swaps | Lombard Docs

This guide covers how to convert between BTC.b and LBTC by interacting directly with Lombard's smart contracts through block explorers.

All amounts are denominated in **satoshis** (1 BTC = 100,000,000 satoshis).

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#how-to-swap-btc.b-for-lbtc)

How to Swap BTC.b for LBTC

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-1-initiate-deposit-on-the-asset-router)

Step 1: Initiate Deposit on the Asset Router

Open the Asset Router contract in explorer:

[https://etherscan.io/address/0x9eCe5fB1aB62d9075c4ec814b321e24D8EA021ac#writeProxyContractarrow-up-right](https://etherscan.io/address/0x9eCe5fB1aB62d9075c4ec814b321e24D8EA021ac#writeProxyContract)

Open the **Contract** tab and select **Write as Proxy**.

Click on **Connect to Web3** to connect to the wallet. Make sure that connection established is with the correct address (the one you have BTC.b on).

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F3HA0GnnGVUhcQiMUkPPp%252F02-asset-router-connected.png%3Falt%3Dmedia%26token%3D28ded40b-89ea-42e6-8567-1056098559c5&width=768&dpr=3&quality=100&sign=49f48581&sv=2)

Navigate to the function [**18\. deposit (0x8340f549)**arrow-up-right](https://etherscan.io/address/0x9eCe5fB1aB62d9075c4ec814b321e24D8EA021ac#writeProxyContract#F18)
 and enter:

*   `fromAddress`: your address (where you have BTC.b)
    
*   `toToken`: LBTC contract address [https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494arrow-up-right](https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494)
    
*   `amount`: amount of BTC.b you want to deposit (convert to LBTC)
    

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FjzZsBVI1Uh4bX5CRuUcy%252F03-deposit-function-fields.png%3Falt%3Dmedia%26token%3Ddc25ed28-59db-45cb-b97d-817e92abf67d&width=768&dpr=3&quality=100&sign=7403a7ec&sv=2)

The amount should be in satoshis.

Click on the **Write** button, check transaction details in your wallet app and accept if everything is correct. After transaction submission it would take some time for Lombard (depending on the blockchain) to notarize it and produce data for further minting.

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-2-get-authorization-signatures-to-mint-lbtc)

Step 2: Get Authorization Signatures to Mint LBTC

In order to get proof and payload for your transaction from Step 1, navigate to:

with your address. e.g.

**Example API response:**

The `raw_payload` and `proof` fields in a real response are much longer. Copy them in full.

Use payload and proof for Step 3.

> **Note:** Payload and proof is available only after Lombard notarized your transaction (JSON above should have `"notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED"`).

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-3-mint-lbtc)

Step 3: Mint LBTC

Open the LBTC contract in explorer:

[https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494#writeProxyContractarrow-up-right](https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494#writeProxyContract)

Open the **Contract** tab and select **Write as Proxy**.

Click on **Connect to Web3** to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F1glTwOR8UNvyrOomK5KG%252F05-lbtc-etherscan-connected.png%3Falt%3Dmedia%26token%3Dffaa939e-e85f-4426-8cd5-799ad5923cba&width=768&dpr=3&quality=100&sign=b5942037&sv=2)

Navigate to the function **21\. mint (0x6bc63893)**. Copy and paste payload and proof collected at previous step.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FzRYhhYqSNfUH2QgLhqYX%252F06-mint-lbtc-filled.png%3Falt%3Dmedia%26token%3D8bd68ad0-b4c6-4252-8356-05f91af71fec&width=768&dpr=3&quality=100&sign=30851b40&sv=2)

Click on the **Write** button, check transaction details in your wallet app and accept if everything is correct.

Corresponding amount of LBTC will be minted on the address that initially had deposited BTC.b as soon as the transaction gets mined and added to the blockchain.

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#how-to-redeem-lbtc-for-btc.b)

How to Redeem LBTC for BTC.b

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-1-initiate-redeem-on-the-lbtc-contract)

Step 1: Initiate Redeem on the LBTC Contract

Open the LBTC contract in explorer:

[https://katanascan.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1#writeProxyContractarrow-up-right](https://katanascan.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1#writeProxyContract)

Open the **Contract** tab and select **Write as Proxy**.

Click on **Connect to Web3** to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FykfqSD3F9BY7YjijjwJ2%252F08-lbtc-katana-connected.png%3Falt%3Dmedia%26token%3D01fa1fe7-d84a-425a-b497-97e6aafbe943&width=768&dpr=3&quality=100&sign=5c784ee4&sv=2)

Navigate to the function **25\. redeem (0xdb006a75)** and enter amount of LBTC you want to redeem (convert to BTC.b).

The amount should be in satoshis.

Click on the **Write** button, check transaction details in your wallet app and accept if everything is correct.

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-2-get-authorization-signatures-to-mint-btc.b)

Step 2: Get Authorization Signatures to Mint BTC.b

LBTC must be unstaked from Bitcoin Secured Networks before BTC.b is available. This process takes up to 8 days to complete (availability based on working capital). After this period of time, Lombard's Security Consortium notarizes the request and issues a payload and proof on Lombard Ledger (Lombard's appchain).

In order to get proof and payload for your transaction from Step 1, navigate to:

with your address. e.g.

**Example API response:**

The `payload` and `proof` fields in a real response are much longer. Copy them in full.

Use payload and proof for Step 3.

> **Note:** Payload and proof is available only after Lombard notarized your transaction (JSON above should have `"notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED"`).

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#step-3-mint-btc.b)

Step 3: Mint BTC.b

Open the BTC.b contract in explorer:

[https://katanascan.com/address/0xb0f70c0bd6fd87dbeb7c10dc692a2a6106817072#writeProxyContractarrow-up-right](https://katanascan.com/address/0xb0f70c0bd6fd87dbeb7c10dc692a2a6106817072#writeProxyContract)

Open the **Contract** tab and select **Write as Proxy**.

Click on **Connect to Web3** to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FKEtiuPVxQ1guLtL0b9Va%252F10-btcb-katana-connected.png%3Falt%3Dmedia%26token%3D707defee-fa1a-4a60-b3cd-3d5e40bb0613&width=768&dpr=3&quality=100&sign=677d95f8&sv=2)

Navigate to the function **21\. mintV1 (0x8307f738)**. Copy and paste payload and proof collected at previous step.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FyqOQ1W9zBKODT9TdKwd8%252F11-mintv1-btcb-filled.png%3Falt%3Dmedia%26token%3D94eb5424-1865-43b8-a781-a4dfa7f6f012&width=768&dpr=3&quality=100&sign=38afee86&sv=2)

Click on the **Write** button, check transaction details in your wallet app and accept if everything is correct.

Corresponding amount of BTC.b will be minted on the address that initially had redeemed LBTCs as soon as the transaction gets mined and added to the blockchain.

[PreviousDirect Integrationschevron-left](https://docs.lombard.finance/build/direct-integrations)
[NextOraclechevron-right](https://docs.lombard.finance/build/direct-integrations/oracle)

Last updated 23 hours ago

*   [How to Swap BTC.b for LBTC](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#how-to-swap-btc.b-for-lbtc)
    
*   [How to Redeem LBTC for BTC.b](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps#how-to-redeem-lbtc-for-btc.b)
    

Copy

    https://mainnet.prod.lombard.finance/api/v1/address/native-deposits/{address}

Copy

    https://mainnet.prod.lombard.finance/api/v1/address/native-deposits/0x659579F1460c38C3ce3288b47b074646CEF855fc

Copy

    {
      "tx_hash": "0x8d511e9f7341ab408c13a5ba240e254e0c557b43ecbc4c389989bcd4255d69e1",
      "event_index": 1,
      "from_blockchain": "BLOCKCHAIN_KATANA",
      "to_blockchain": "BLOCKCHAIN_KATANA",
      "from_address": "0x659579f1460c38c3ce3288b47b074646cef855fc",
      "to_address": "0x659579f1460c38c3ce3288b47b074646cef855fc",
      "to_token_address": "0xecac9c5f704e954931349da37f60e39f515c11c1",
      "block_height": "16913834",
      "block_time": "2025-11-20T16:37:25Z",
      "amount": "20000",
      "payload_hash": "0xf6f7c2077a12278c78f763c5a61c061a75c4925d58b8831fe5eebe31544e30b7",
      "raw_payload": "0xe288fb4a022d9999...0000000000000000",
      "proof": "0x00000000000000000...1ba0b2",
      "session_id": "75684",
      "notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED",
      "session_state": "SESSION_STATE_COMPLETED",
      "claim_tx": "0x999d2f78e04c7c2cff3b53cf5b6199b5ea51823f69622a7305485b3b43aa4436"
    }

Copy

    https://mainnet.prod.lombard.finance/api/v1/address/unstakes/{address}?show_redeems=true&to_native=true

Copy

    https://mainnet.prod.lombard.finance/api/v1/address/unstakes/0x659579f1460c38c3ce3288b47b074646cef855fc?show_redeems=true&to_native=true

Copy

    {
      "tx_hash": "0xb2ce453e884d4bc85d23c64f4ceea52de2fda1f00535a1ac2a3b8bc0fbddd2ee",
      "blockchain": "BLOCKCHAIN_KATANA",
      "block_height": "16986686",
      "block_time": "1763729497",
      "from_address": "0x659579f1460c38c3ce3288b47b074646cef855fc",
      "output_script": "",
      "amount": "3300",
      "sanctioned": false,
      "to_address": "0x000000000000000000000000659579f1460c38c3ce3288b47b074646cef855fc",
      "to_chain": "BLOCKCHAIN_KATANA",
      "proof": "0x00000000000000000...851ddc6",
      "payload": "0xe288fb4a022d9999...0000000000000000",
      "notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED",
      "session_state": "SESSION_STATE_COMPLETED",
      "claim_tx": "0x9cd22474ce277f4c39c50f93b24807bf50af83bf98d9e06481608a0d8f9bcf47",
      "from_token_address": "0xecac9c5f704e954931349da37f60e39f515c11c1"
    }

---

# EVM | Lombard Docs

This section covers operations for Ethereum Virtual Machine-compatible blockchains, detailing how to unstake assets, deploy wrapped Bitcoin (LBTC) to EVM chains for DeFi participation, and redeem LBTC back to native Bitcoin, enabling seamless cross-chain asset movement within the Ethereum ecosystem.

[PreviousBTC Deposit and Deploychevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/bitcoin/btc-deposit-and-deploy)
[NextEVM Unstakechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/evm/evm-unstake)

Last updated 2 months ago

---

# Bitcoin | Lombard Docs

This section focuses on Bitcoin-specific operations available through the SDK, including native BTC staking, direct BTC deposits, and advanced cross-chain functionality that enables users to stake or deposit Bitcoin while simultaneously deploying assets to other blockchain networks like Avalanche, maximizing capital efficiency and DeFi opportunities.

[PreviousCapabilitieschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities)
[NextBTC Stakechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/bitcoin/btc-stake)

Last updated 2 months ago

---

# Testing and Sandbox | Lombard Docs

This section explains how to configure and use the SDK's testnet environment. It covers environment setup, testnet-specific parameters, and how to validate integrations before deploying to mainnet.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#environment-selection)

Environment Selection

The SDK supports multiple environments. Use `Env.testnet` for development.

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      partner: {
        partnerId: 'test',  // Bypasses captcha in non-prod environments
      },
      providers: {
        evm: () => window.ethereum,
      },
    });
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#environment-details)

Environment Details

Environment

Network

Chains

Use Case

`Env.prod`

Mainnet

Ethereum, Arbitrum, Base, etc.

Production

`Env.testnet`

Testnet

Sepolia, Holesky

Development and testing

`Env.dev`

Testnet

Sepolia, Holesky

Internal development

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#testnet-faucets)

Testnet Faucets

To test on testnets, you'll need:To test on testnets, the following is required:

1.  **Sepolia ETH** — For gas fees on Ethereum Sepolia
    
2.  **Signet BTC** — For BTC staking tests
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#switching-environments)

Switching Environments

Use environment variables to switch between environments at runtime.

> Note: Use partnerId: 'test' in non-production environments to bypass captcha. See Partners for production setup.

[PreviousConnect walletschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets)
[NextConceptschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts)

Last updated 2 months ago

*   [Environment Selection](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#environment-selection)
    
*   [Environment Details](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#environment-details)
    
*   [Testnet Faucets](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#testnet-faucets)
    
*   [Switching Environments](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox#switching-environments)
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const env = process.env.LOMBARD_ENV === 'production' ? Env.prod : Env.testnet;
    
    const config = createConfig({
      env,
      partner: {
        partnerId: env === Env.prod ? 'YOUR_PARTNER_ID' : 'test',
      },
      providers: {
        evm: () => window.ethereum,
      },
    });

---

# Bridging | Lombard Docs

Move your Bitcoin assets across blockchains. Lombard uses Chainlink CCIP for secure cross-chain transfers, with an additional economic guarantee layer powered by Symbiotic.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#lombard-assets)

Lombard Assets

Lombard operates two Bitcoin assets, each available on multiple chains:

Asset

Type

Yield

Primary Use

LBTC

Yield-bearing BTC

Yes (Babylon staking)

DeFi, long-term holding

BTC.b

Bridged BTC

No

DeFi, trading, flexibility

Both assets are backed 1:1 by native Bitcoin and secured by the same Security Consortium.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#supported-chains)

Supported Chains

#### 

[hashtag](https://docs.lombard.finance/use/bridging#lbtc)

LBTC

LBTC is available on 20+ chains:

**Native with Chainlink CCIP (dual-layer security):**

Chain

Status

Ethereum

Native

Base

Native

Arbitrum

Native

BNB Chain

Native

Sonic

Native

Sui

Native

Monad

Native

MegaETH

Native

Stable

Native

Katana

Native

Ink

Native

**Additional Chains:**

Chain

Bridge Type

Solana

LayerZero

Berachain

Native

Scroll

Lock and Mint

Mantle

Lock and Mint

Linea

Lock and Mint

Mode

Canonical

Corn

Canonical

Avalanche

CCIP

TAC

CCIP + LayerZero

Etherlink

CCIP + LayerZero

Morph

LayerZero

Bob

Native

#### 

[hashtag](https://docs.lombard.finance/use/bridging#btc.b)

BTC.b

BTC.b is available on:

Chain

Status

Ethereum

Native

Avalanche

Native (original chain)

Solana

Native

BTC.b uses the same Security Consortium and Chainlink infrastructure as LBTC.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#how-bridging-works)

How Bridging Works

Both LBTC and BTC.b use burn-and-mint bridging secured by multiple layers:

1.  **Burn:** Tokens are burned on the source chain.
    
2.  **Verify:** Chainlink CCIP validates the burn transaction.
    
3.  **Attest:** Lombard Token Developer Attestation confirms legitimacy.
    
4.  **Monitor:** Symbiotic network independently verifies the transfer.
    
5.  **Mint:** Tokens are minted on the destination chain.
    

This dual-layer verification ensures unauthorized minting is not possible.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#bridge-lbtc)

Bridge LBTC

#### 

[hashtag](https://docs.lombard.finance/use/bridging#using-lombard-app)

Using Lombard App

1.  Go to [lombard.finance/apparrow-up-right](https://lombard.finance/app)
    .
    
2.  Connect your wallet on the source chain.
    
3.  Select **Bridge**.
    
4.  Choose the destination chain.
    
5.  Enter the amount of LBTC to bridge.
    
6.  Confirm the transaction.
    
7.  Wait for confirmation (typically 2-15 minutes).
    
8.  LBTC arrives on the destination chain.
    

#### 

[hashtag](https://docs.lombard.finance/use/bridging#bridge-times)

Bridge Times

Route

Typical Time

Ethereum - Base

2-5 minutes

Ethereum - Arbitrum

2-5 minutes

Ethereum - BNB Chain

5-10 minutes

Ethereum - Sui

5-15 minutes

Ethereum - Solana

5-15 minutes

Ethereum - Monad

5-10 minutes

Times vary based on network congestion.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#bridge-btc.b)

Bridge BTC.b

#### 

[hashtag](https://docs.lombard.finance/use/bridging#using-lombard-app-1)

Using Lombard App

1.  Go to [lombard.finance/apparrow-up-right](https://lombard.finance/app)
    .
    
2.  Connect your wallet.
    
3.  Select **Bridge** and choose BTC.b.
    
4.  Select source and destination chains.
    
5.  Enter amount and confirm.
    

#### 

[hashtag](https://docs.lombard.finance/use/bridging#avalanche-users)

Avalanche Users

BTC.b originated on Avalanche and has deep liquidity there. You can bridge BTC.b:

*   **Avalanche to Ethereum:** Through Lombard bridge.
    
*   **Avalanche to Solana:** Through Lombard bridge.
    
*   **Within Avalanche ecosystem:** Native transfers.
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#bridging-to-non-evm-chains)

Bridging to Non-EVM Chains

#### 

[hashtag](https://docs.lombard.finance/use/bridging#sui)

Sui

LBTC can be bridged from Ethereum to Sui, and vice versa. After bridging via the Sui bridge, accessible from the dApp, you receive wLBTC on your Sui address. This wLBTC on Sui must be claimed for LBTC on Sui. Ensure you have native SUI to cover the gas costs, then:

1.  From the Sui bridge page, after the bridge completes, press **Convert** to convert wLBTC to LBTC.
    

> If you already closed this page, re-access it by entering the URL https://bridge.sui.io/transaction/{your\_transaction\_id}?chain=ETH, where your\_transaction\_id is the transaction ID from Ethereum. Find this using a block explorer like Etherscan or by checking your wallet history.

1.  After selecting **Claim**, approve the transaction in your Sui wallet. This costs some amount of SUI.
    
2.  After approving, your wLBTC converts to LBTC on your Sui address.
    

#### 

[hashtag](https://docs.lombard.finance/use/bridging#solana)

Solana

Solana bridging uses LayerZero:

1.  Connect an EVM wallet and a Solana wallet.
    
2.  Select Solana as the destination.
    
3.  Confirm the bridge transaction.
    
4.  LBTC or BTC.b arrives as an SPL token.
    

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#bridge-fees)

Bridge Fees

Bridge fees depend on the route and cover:

*   Gas on source and destination chains.
    
*   CCIP messaging costs.
    

Fees are displayed before you confirm. Lombard does not charge additional bridge fees beyond network costs.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#bridge-security)

Bridge Security

#### 

[hashtag](https://docs.lombard.finance/use/bridging#chainlink-ccip)

Chainlink CCIP

Cross-Chain Interoperability Protocol provides the transport layer. CCIP validators must approve every transfer before minting occurs.

#### 

[hashtag](https://docs.lombard.finance/use/bridging#symbiotic-guarantee-layer)

Symbiotic Guarantee Layer

Staked BARD and LINK tokens back a monitoring network that verifies LBTC and BTC.b cross-chain transfers. If a mismatch is detected between burn and mint events, staked collateral becomes slash-eligible.

*   BARD vault: 20M BARD cap.
    
*   LINK vault: 100M USD cap.
    

#### 

[hashtag](https://docs.lombard.finance/use/bridging#security-consortium)

Security Consortium

Every bridge transaction requires approval from both CCIP validators and Lombard Security Consortium: 15 institutional members including OKX, Galaxy, Kraken, DCG, Wintermute, Figment, Kiln, and others.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#lbtc-vs-btc.b-which-to-bridge)

LBTC vs BTC.b: Which to Bridge?

Consideration

LBTC

BTC.b

Earn yield while bridged

Yes

No

Lower fees

Similar

Similar

Chain availability

20+ chains

3 chains

Best for

Long-term DeFi use

Trading, flexibility

If you want yield, bridge LBTC. If you need BTC.b specifically for a protocol or chain where only BTC.b is supported, bridge BTC.b.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#converting-between-assets)

Converting Between Assets

You cannot directly bridge LBTC to BTC.b or vice versa. To convert:

**LBTC to BTC.b:**

1.  Unstake LBTC to receive native BTC (9 days).
    
2.  Mint BTC.b with your BTC.
    

**BTC.b to LBTC:**

1.  Redeem BTC.b for native BTC.
    
2.  Stake BTC to mint LBTC.
    

Alternatively, swap on DEXs where both assets have liquidity (may have slippage).

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#frequently-asked-questions)

Frequently Asked Questions

#### 

[hashtag](https://docs.lombard.finance/use/bridging#can-i-bridge-directly-between-non-ethereum-chains)

Can I bridge directly between non-Ethereum chains?

Most routes go through Ethereum as a hub. Check the app for available direct routes.

#### 

[hashtag](https://docs.lombard.finance/use/bridging#what-if-my-bridge-transaction-fails)

What if my bridge transaction fails?

Funds remain on the source chain. If tokens were burned but not minted, contact support. The Security Consortium can resolve stuck transactions.

#### 

[hashtag](https://docs.lombard.finance/use/bridging#is-bridged-lbtc-the-same-as-minted-lbtc)

Is bridged LBTC the same as minted LBTC?

Yes. All LBTC is fungible regardless of chain. You earn the same yield and can use it in any DeFi protocol.

#### 

[hashtag](https://docs.lombard.finance/use/bridging#can-i-unstake-to-btc-from-any-chain)

Can I unstake to BTC from any chain?

Yes. Initiate an unstake from any chain where you hold LBTC. BTC is delivered to your Bitcoin address after 9 days.

#### 

[hashtag](https://docs.lombard.finance/use/bridging#does-btc.b-earn-lux-points)

Does BTC.b earn Lux points?

Starting in Season 3 (March 18, 2026), BTC.b earns Lux when deployed into eligible DeFi protocols.

LBTC also earns Lux exclusively through DeFi deployment.

Passive holding of either asset in a wallet does not generate Lux.

Visit the DeFi marketplace at [lombard.finance/apparrow-up-right](https://lombard.finance/app)
 for eligible protocols, chains, and current multipliers.

* * *

### 

[hashtag](https://docs.lombard.finance/use/bridging#next-steps)

Next Steps

*   [Use LBTC](https://docs.lombard.finance/use/use-lbtc)
     — Stake BTC and mint LBTC
    
*   [Use BTC.b](https://docs.lombard.finance/use/use-btc.b)
     — Mint and use BTC.b
    
*   [Access DeFi](https://docs.lombard.finance/use/access-defi)
     — Deploy assets on destination chains
    
*   [Troubleshooting](https://docs.lombard.finance/use/troubleshooting)
     — Get help with bridge issues
    

[PreviousUse $BARDchevron-left](https://docs.lombard.finance/use/use-usdbard)
[NextAccess DeFichevron-right](https://docs.lombard.finance/use/access-defi)

Last updated 12 days ago

*   [Lombard Assets](https://docs.lombard.finance/use/bridging#lombard-assets)
    
*   [Supported Chains](https://docs.lombard.finance/use/bridging#supported-chains)
    
*   [How Bridging Works](https://docs.lombard.finance/use/bridging#how-bridging-works)
    
*   [Bridge LBTC](https://docs.lombard.finance/use/bridging#bridge-lbtc)
    
*   [Bridge BTC.b](https://docs.lombard.finance/use/bridging#bridge-btc.b)
    
*   [Bridging to Non-EVM Chains](https://docs.lombard.finance/use/bridging#bridging-to-non-evm-chains)
    
*   [Bridge Fees](https://docs.lombard.finance/use/bridging#bridge-fees)
    
*   [Bridge Security](https://docs.lombard.finance/use/bridging#bridge-security)
    
*   [LBTC vs BTC.b: Which to Bridge?](https://docs.lombard.finance/use/bridging#lbtc-vs-btc.b-which-to-bridge)
    
*   [Converting Between Assets](https://docs.lombard.finance/use/bridging#converting-between-assets)
    
*   [Frequently Asked Questions](https://docs.lombard.finance/use/bridging#frequently-asked-questions)
    
*   [Next Steps](https://docs.lombard.finance/use/bridging#next-steps)

---

# Lombard SDK FAQ | Lombard Docs

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#about-the-lombard-sdk)

About the Lombard SDK

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-is-the-lombard-sdk)

What is the Lombard SDK?

Lombard SDK is a JavaScript/TypeScript package that lets you integrate Bitcoin functionality into your platform without operating Bitcoin infrastructure. Install it via npm, configure your environment, and you get access to Bitcoin staking, wrapping, yield strategies, and cross-chain routing—all backed by Lombard's production infrastructure.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#who-is-the-lombard-sdk-for)

Who is the Lombard SDK for?

The Lombard SDK is built for teams that ship great products:

→ DeFi protocols launching canonical BTC assets

→ Chains wanting native or whitelabeled Bitcoin

→ Fintechs offering Bitcoin yield to users

→ Exchanges & wallets adding BTC capabilities

→ Institutions integrating onchain Bitcoin strategies

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#why-should-i-integrate-the-lombard-sdk)

Why should I integrate the Lombard SDK?

You can ship Bitcoin features in weeks instead of months without hiring a team to build and maintain custody, validators, cross-chain routing, and monitoring infrastructure. You get institutional-grade security, Proof-of-Reserve, and 24/7 operations—without the operational overhead.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-get-started)

How do I get started?

Install the SDK from npm, grab some testnet BTC and Sepolia ETH from faucets, connect a wallet provider (OKX for Bitcoin, MetaMask or similar for EVM), and use `partnerId: 'test'` in your config. That's it, you can start generating deposit addresses and testing flows immediately.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-if-i-want-a-more-direct-integration-path)

What if I want a more direct integration path?

If the SDK doesn't fit your architecture or you need deeper customization, contact us to discuss direct API access or custom integration patterns.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-long-does-integration-take)

How long does integration take?

Most teams ship to production in 2-4 weeks. You'll spend a few days testing in the Playground, about a week configuring and validating your flows, then 1-2 weeks on production integration. If you're just adding BTC staking to an existing wallet, it can be faster.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#do-i-need-to-run-my-own-bitcoin-infrastructure)

Do I need to run my own Bitcoin infrastructure?

No. Lombard operates custody, validators, cross-chain routing, and monitoring. You handle the UX and business logic. You never touch Bitcoin private keys or signing operations.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#about-bitcoin-connect)

About Bitcoin Connect

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-is-bitcoin-connect)

What is Bitcoin Connect?

Bitcoin Connect is Lombard's developer platform for building Bitcoin products. It is an evolving suite of developer tools including APIs and Oracles that can be freely accessed to integrate Lombard's assets and infrastructure on any chain, protocol or application.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-does-the-lombard-sdk-fit-into-bitcoin-connect)

How does the Lombard SDK fit into Bitcoin Connect?

The Lombard SDK is the first tool available within Bitcoin Connect. It's a deployment-ready toolkit for integrating Lombard's Bitcoin infrastructure directly into your application. Additional tools like APIs and other builder capabilities will be added to the platform over time.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#should-i-use-bitcoin-connect-or-build-my-own-bitcoin-infrastructure)

Should I use Bitcoin Connect or build my own Bitcoin infrastructure?

Bitcoin Connect lets you ship Bitcoin products in weeks instead of quarters. Building in-house means hiring a team to build and maintain custody, validators, cross-chain routing, and monitoring infrastructure indefinitely. If your core business isn't Bitcoin infrastructure, Connect is the faster and more secure path.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#partner-id)

Partner ID

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-is-a-partner-id-and-why-do-i-need-one)

What is a Partner ID and why do I need one?

A Partner ID lets your users skip CAPTCHA when generating deposit addresses, tracks all deposits to your organization for analytics, and makes you eligible for fee sharing and partner rewards. For testing, use `'test'` as your Partner ID. For production, request one via the Partner Intake Form—usually issued same day.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#can-i-use-the-same-partner-id-across-multiple-products)

Can I use the same Partner ID across multiple products?

You can, but it's better to request separate Partner IDs if you want independent attribution tracking for different products or integrations.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-it-works)

How It Works

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#whats-the-flow-for-staking-btc-to-lbtc)

What's the flow for staking BTC to LBTC?

Create a stake action, prepare it with the amount and recipient address, authorize the signature (either a fee authorization for Ethereum or address confirmation for other chains), then generate a BTC deposit address. Give that address to your user, they send BTC to it, and LBTC gets minted to their destination address after confirmations.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-btc-deposit-addresses-work)

How do BTC deposit addresses work?

Each combination of destination chain, recipient address, and Partner ID gets a unique Bitcoin address. These addresses never expire and can receive multiple deposits—you don't need to generate a new one each time. Each deposit is processed independently.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#whats-the-difference-between-fee-authorization-and-address-confirmation)

What's the difference between fee authorization and address confirmation?

If you're staking to Ethereum mainnet, users sign an EIP-712 message authorizing the network fee. For all other chains, they sign a simpler message confirming the destination chain ID. Both are required before generating the deposit address.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-long-does-it-take-for-btc-to-become-lbtc)

How long does it take for BTC to become LBTC?

After the user sends BTC to the deposit address, it takes several Bitcoin block confirmations before LBTC is minted on the destination chain. The exact timing depends on Bitcoin network conditions and the destination chain's settlement requirements. The SDK provides progress events so you can show confirmation status in your UI.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#capabilities)

Capabilities

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-can-i-build-with-the-lombard-sdk)

What can I build with the Lombard SDK?

The SDK lets you offer established Bitcoin assets to your users: **LBTC** (Bitcoin with native yield) and **BTC.b** (bridged Bitcoin) across all supported chains.

From there, you can build revenue-generating products including **Bitcoin yield and staking flows**, **automated vault strategies,** **whitelabeled Bitcoin assets**, and **cross-chain settlement and routing**. Users can stake BTC to receive LBTC, mint BTC.b, deploy directly into DeFi vaults like Veda or Silo in a single transaction, and handle unstaking or redemptions back to native BTC.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#which-chains-are-supported)

Which chains are supported?

Production chains include Ethereum, Arbitrum, Base, Avalanche, Solana, Sui, and Starknet. For testing, use Sepolia, Holesky, or Bitcoin Signet.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#can-i-deploy-to-defi-protocols-automatically)

Can I deploy to DeFi protocols automatically?

Yes. The Lombard SDK supports direct deployment to Veda and Silo vaults. Instead of stake → receive LBTC → manually deploy, users can do it all in one step using `stakeAndDeploy` or `depositAndDeploy` actions.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#can-i-white-label-bitcoin-assets)

Can I white-label Bitcoin assets?

Yes, but this requires coordination with Lombard. Email [\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
 to discuss white-labeled asset issuance backed by Lombard infrastructure.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#sdk-patterns)

SDK Patterns

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-sdk-actions-work)

How do SDK actions work?

Every action follows the same pattern: create it with your target configuration, prepare it with the specific parameters (amount, recipient), authorize any required signatures, then execute. Actions have predictable status states like `IDLE`, `NEEDS_FEE_AUTHORIZATION`, `READY`, `CONFIRMING`, `COMPLETED`. You can subscribe to events to track progress.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#whats-the-difference-between-using-the-full-sdk-object-and-modular-factories)

What's the difference between using the full SDK object and modular factories?

The full SDK object (`createLombardSDK`) gives you all capabilities in one place—good for exploring. Modular factories (`btcStake`, `evmUnstake`, etc.) let you import only what you need for better tree-shaking and smaller bundle sizes in production.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-happens-if-a-user-cancels-or-an-operation-fails)

What happens if a user cancels or an operation fails?

If an error occurs, the action stays at the step where it failed—it doesn't reset. This means users can retry the same step without starting over. All SDK errors are `LombardError` instances with a code, message, and metadata so you can handle them appropriately in your UI.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-track-operation-progress)

How do I track operation progress?

Subscribe to events on the action object. You get `StatusChange` events when the action moves between states, `Progress` events with confirmation counts, `Completed` when it's done, and `Error` if something fails. This lets you update your UI in real-time as operations progress.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#wallets)

Wallets

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#which-bitcoin-wallets-are-supported)

Which Bitcoin wallets are supported?

Currently OKX Wallet via the `window.okxwallet.bitcoin` provider. The wallet must support `getAccounts`, `signMessage`, and `signPsbt` methods.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#which-evm-wallets-work)

Which EVM wallets work?

Any wallet that implements the EIP-1193 interface. MetaMask, WalletConnect, Coinbase Wallet, etc. If you're using Wagmi, you can pass in the wallet client directly.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-about-solana-sui-or-starknet)

What about Solana, Sui, or Starknet?

The SDK supports standard wallet adapters for each chain. For Solana use `window.solana`, for Sui use `window.suiWallet`, for Starknet use `window.starknet`. You configure all your providers once in the SDK config and it handles the rest.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#data-and-tracking)

Data & Tracking

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-fetch-a-users-deposit-history)

How do I fetch a user's deposit history?

Call `sdk.api.deposits(address)` with their destination address. You get back an array of all deposits with amounts, transaction hashes, chains, notarization status, and claim status.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#can-i-check-if-a-deposit-address-already-exists)

Can I check if a deposit address already exists?

Yes. Call `sdk.api.depositAddress(recipient, chainId)` and it returns the existing address or throws if none exists. This is useful for showing returning users their existing deposit address without generating a new one.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-referrals-work)

How do referrals work?

Pass a `referralCode` when calling `prepare()` on stake or deposit actions. The code gets attached to the deposit address at generation time and can't be changed afterward. You can check if an address has a referrer with `sdk.referrals.lookupReferrer()`.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-get-exchange-rates-for-lbtc)

How do I get exchange rates for LBTC?

Call `sdk.api.exchangeRatio()` to get current ratios for all supported tokens. For LBTC you'll get `tokenBTCRatio` (how many LBTC per 1 BTC) and `BTCTokenRatio` (how many BTC per 1 LBTC).

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#testing)

Testing

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-is-the-sdk-playground)

What is the SDK Playground?

A live testing environment where you can configure flows, validate execution paths, simulate operations, and generate example SDK code without deploying anything to mainnet. It's the fastest way to understand how the SDK works before writing integration code.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-test-on-testnet)

How do I test on testnet?

Set `env: Env.testnet` in your config and use `partnerId: 'test'`. Get testnet BTC from a Signet faucet and Sepolia ETH from a Sepolia faucet. Everything works the same as production but with test tokens.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#operations-and-security)

Operations & Security

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#who-handles-custody-and-security)

Who handles custody and security?

Lombard operates all custody infrastructure, validator coordination, and Proof-of-Reserve verification. The infrastructure uses audited smart contracts, hardware-enforced signing via Cubist Bascule, Chainlink Proof-of-Reserve, and validation from a 15-institution Security Consortium.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#what-happens-during-an-outage-or-incident)

What happens during an outage or incident?

Lombard monitors infrastructure 24/7 and handles incident response for custody, settlement, and routing issues. You'll receive status updates via your designated communication channel. Your responsibility is communicating with your users and potentially pausing flows if Lombard recommends it.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#has-this-been-used-in-production)

Has this been used in production?

Yes. Major platforms including Binance, Bybit, Ledger, Figment, Xverse and Cool Wallet offer Bitcoin products to their users powered by the Lombard SDK.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#compliance)

Compliance

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#does-lombard-handle-kyc-aml-compliance)

Does Lombard handle KYC/AML compliance?

No. You remain responsible for your compliance obligations. Communicate your KYC/AML requirements, geographic restrictions, and sanctioned address screening policies during partner onboarding so flows can be configured appropriately.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#can-i-restrict-access-by-country-or-user-type)

Can I restrict access by country or user type?

Yes. Enforce geographic and eligibility restrictions in your product layer. Additional restrictions may apply depending on the asset type and custody model you're using.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#support)

Support

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-do-i-get-help)

How do I get help?

Reach out to the Lombard team via [Builder Support](https://docs.lombard.finance/build/the-lombard-sdk/builder-support)
, or via Discord.

[PreviousError Codeschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes)
[NextBuilder Supportchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/builder-support)

Last updated 2 months ago

*   [About the Lombard SDK](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#about-the-lombard-sdk)
    
*   [About Bitcoin Connect](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#about-bitcoin-connect)
    
*   [Partner ID](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#partner-id)
    
*   [How It Works](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#how-it-works)
    
*   [Capabilities](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#capabilities)
    
*   [SDK Patterns](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#sdk-patterns)
    
*   [Wallets](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#wallets)
    
*   [Data & Tracking](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#data-and-tracking)
    
*   [Testing](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#testing)
    
*   [Operations & Security](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#operations-and-security)
    
*   [Compliance](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#compliance)
    
*   [Support](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq#support)

---

# How to Find Out Unstake Fee | Lombard Docs

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#lbtc)

LBTC

[https://etherscan.io/address/0x8236a87084f8b84306f72007f36f2618a5634494#readProxyContractarrow-up-right](https://etherscan.io/address/0x8236a87084f8b84306f72007f36f2618a5634494#readProxyContract)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FE8QoH5TFXs8EilG3l93K%252F01-lbtc-read-as-proxy.png%3Falt%3Dmedia%26token%3Dfd228633-1239-4f44-849a-373d210de809&width=768&dpr=3&quality=100&sign=7be4ba99&sv=2)

Unstake fee calculation depends on what is destination if unstake operation:

*   BTC -> unstake fee is a sum of "redeem fee" and "to native commission"
    
*   BTC.b -> unstake fee equals to "redeem fee"
    

Below is information about how to get both "redeem fee" and "to native commission":

**Function:** 12. getRedeemFee (0xc6d98f1a) **Returns:** amount of LBTC to be taken as redeem fee

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F3LMBBJNqEeAjvFKbZGcB%252F02-lbtc-getRedeemFee.png%3Falt%3Dmedia%26token%3D5bcf4a21-8bc5-4389-9fbc-d12ce916e118&width=768&dpr=3&quality=100&sign=ed9b4e14&sv=2)

**Function:** 28. toNativeCommission (0xb743ab4f) **Returns:** amount of LBTC to be taken as "to native commission"

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FC6Hisiu7GzBouTpW6uMm%252F03-lbtc-toNativeCommission.png%3Falt%3Dmedia%26token%3D8498298d-900f-456d-9db2-dd6fa61d0a4f&width=768&dpr=3&quality=100&sign=6c4cacde&sv=2)

Also there is a function that tells what is the mi amount (after paying fee) that can be redeemed

**Function:** 13. getRedeemForBtcMinAmount (0x1beda7e3) **Returns:** amount of LBTC to be taken as redeem fee

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F5Xyddz6M6qPDUBblGiRb%252F04-lbtc-getRedeemForBtcMinAmount.png%3Falt%3Dmedia%26token%3D1271ffff-d148-4941-9897-9bdb026f9b41&width=768&dpr=3&quality=100&sign=58299d3c&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#btc.b)

BTC.b

[https://etherscan.io/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072#readProxyContractarrow-up-right](https://etherscan.io/address/0xB0F70C0bD6FD87dbEb7C10dC692a2a6106817072#readProxyContract)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FbnkrgQqeBvx5ZzuA3Mmr%252F05-btcb-read-as-proxy.png%3Falt%3Dmedia%26token%3D0d6eb227-24e3-4ec6-ba08-1a6b96e1ee0a&width=768&dpr=3&quality=100&sign=b4474cc0&sv=2)

Unstake fee is calculation: unstake fee is a sum of "redeem fee" and "to native commission"

Below is information about how to get both "redeem fee" and "to native commission":

**Function:** 20. getRedeemFee (0xc6d98f1a) **Returns:** amount of LBTC to be taken as redeem fee

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FFyVl8WdSsvL9jZbuADX3%252F06-btcb-getRedeemFee.png%3Falt%3Dmedia%26token%3D72099e0d-a517-4b5b-a624-0d367b5f4e9d&width=768&dpr=3&quality=100&sign=911424bc&sv=2)

**Function:** 35. toNativeCommission (0xb743ab4f) **Returns:** amount of LBTC to be taken as "to native commission"

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F1lasIoRpaQ6JoF8Sf9dv%252F07-btcb-toNativeCommission.png%3Falt%3Dmedia%26token%3Dfbd76299-b3d5-4399-a3a1-bd72f3ab55d0&width=768&dpr=3&quality=100&sign=4702c820&sv=2)

Also there is a function that tells what is the mi amount (after paying fee) that can be redeemed

**Function:** 21. getRedeemForBtcMinAmount (0x1beda7e3) **Returns:** amount of LBTC to be taken as redeem fee

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FJ3kyyV1izAdKlpQN76X8%252F08-btcb-getRedeemForBtcMinAmount.png%3Falt%3Dmedia%26token%3D69dd93a4-6bd7-4272-93b4-ee8f01d69821&width=768&dpr=3&quality=100&sign=a3f9aea&sv=2)

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#assetrouter)

AssetRouter

In general absolutely the same information can be collected from AssetRouter contract:

[https://etherscan.io/address/0x9ece5fb1ab62d9075c4ec814b321e24d8ea021ac#readProxyContractarrow-up-right](https://etherscan.io/address/0x9ece5fb1ab62d9075c4ec814b321e24d8ea021ac#readProxyContract)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FCudUtTqNOskssU0xEF0r%252F09-assetrouter-read-as-proxy.png%3Falt%3Dmedia%26token%3D95edc469-20f4-4626-a2fc-7bfcb00fde42&width=768&dpr=3&quality=100&sign=29d76053&sv=2)

**Function:** 24. toNativeCommission (0x5698732f) **Returns:** amount of LBTC to be taken as "to native commission"

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FHW8HIxF85xKwCvTUok01%252F10-assetrouter-toNativeCommission.png%3Falt%3Dmedia%26token%3D611d42ae-1a1f-46af-814c-e13acd433959&width=768&dpr=3&quality=100&sign=76cbabbb&sv=2)

**Function:** 25. tokenConfig (0xfe136c4e) **Returns:** basic configuration for selected token, redeem fee, minimal redeemForBTC amount and redeem enabled flag

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252F3Em8ntBBLwaak7qNAvxh%252F11-assetrouter-tokenConfig.png%3Falt%3Dmedia%26token%3D1ce21949-4ecf-48f0-9a68-91c49cd6f632&width=768&dpr=3&quality=100&sign=796191a4&sv=2)

[PreviousLBTC GMP Mint Tracingchevron-left](https://docs.lombard.finance/build/direct-integrations/lbtc-gmp-mint-tracing)
[NextBrand Assetschevron-right](https://docs.lombard.finance/resources/brand-assets)

Last updated 20 hours ago

*   [LBTC](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#lbtc)
    
*   [BTC.b](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#btc.b)
    
*   [AssetRouter](https://docs.lombard.finance/build/direct-integrations/how-to-find-out-unstake-fee#assetrouter)

---

# Capabilities | Lombard Docs

This section covers the specific Bitcoin and cross-chain operations available through the SDK and how to integrate them.

Each capability is organized by blockchain environment:

**Bitcoin** - Native BTC operations including staking, direct deposits, and advanced cross-chain functionality that lets users stake or deposit Bitcoin while simultaneously deploying assets to other networks like Avalanche for maximum capital efficiency.

**EVM** - Operations for Ethereum Virtual Machine-compatible chains, including unstaking assets, deploying LBTC to EVM chains for DeFi participation, and redeeming LBTC back to native Bitcoin for seamless cross-chain movement.

**Non-EVM** - Integration patterns for Solana, Sui, and Starknet, with chain-specific guidance for unstaking operations and asset management beyond the Ethereum ecosystem.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities#quick-links)

Quick Links:

[Bitcoinchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/bitcoin)

Native BTC operations including staking, direct deposits, and deploying assets to DeFi vaults. Covers BTC Stake, BTC Deposit, Stake and Deploy, and Deposit and Deploy flows.

[EVMchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/evm)

Operations for Ethereum Virtual Machine-compatible chains. Includes unstaking LBTC to BTC, deploying LBTC to DeFi protocols, and redeeming BTC.b back to native Bitcoin.

[Non-EVMchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/non-evm)

Integration patterns for Solana, Sui, and Starknet with chain-specific guidance for unstaking operations and asset management beyond the Ethereum ecosystem.

[PreviousAPI Methodschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods)
[NextBitcoinchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/bitcoin)

Last updated 2 months ago

---

# GMP Redeem Tracing | Lombard Docs

Filter `RedeemForBtc` call made on [AssetRouter contract.arrow-up-right](https://etherscan.io/advanced-filter?ps=25&eladd=0x964677F337d6528d659b1892D0045B8B27183fc0&eltpc=0x8784acf2b096380844b252c1cc85752ea2dcccf0fd55ed7a440e0ccd3b56b908&mtd=0x30b93d85%7eRedeem+For+Btc)

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FQOk3p2HAMXxk5wuh0Ymn%252F01-redeem-for-btc-transactions.png%3Falt%3Dmedia%26token%3Deb4ff116-7e4e-41cc-a680-78d27fab44cd&width=768&dpr=3&quality=100&sign=6a4741ee&sv=2)

Open the transaction and navigate to "Logs" tab. Find `MessageSent` event.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FZNAFoQWZiLAkZKc3KieJ%252F02-message-sent-event.png%3Falt%3Dmedia%26token%3D5747b343-9fa2-463c-930a-5093d87e1538&width=768&dpr=3&quality=100&sign=ca8e37a3&sv=2)

Copy data.

Open [input data decoder.arrow-up-right](https://etherscan.io/inputdatadecoder)

Paste data as Input Data, and ABI as Input ABI:

Click decode.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FfhdrazMc78YTyTic2qaM%252F03-decoded-message-v1.png%3Falt%3Dmedia%26token%3D753e601b-8f36-4113-a30a-87d09ef616c2&width=768&dpr=3&quality=100&sign=9807cac6&sv=2)

Copy body to Input Data field and Click "Decode" again.

![](https://docs.lombard.finance/~gitbook/image?url=https%3A%2F%2F1161095600-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl7wTwC5uXA2Yk5tvZMBg%252Fuploads%252FlkDaMyy3qqHI1cW5g1Ss%252F04-decoded-redeem-function.png%3Falt%3Dmedia%26token%3D4e87c1b3-bfbc-4993-bc83-bffc9c771ddb&width=768&dpr=3&quality=100&sign=ed761b95&sv=2)

In the result you can see script pubkey which can be converted to bitcoin address.

[PreviousOraclechevron-left](https://docs.lombard.finance/build/direct-integrations/oracle)
[NextLBTC GMP Mint Tracingchevron-right](https://docs.lombard.finance/build/direct-integrations/lbtc-gmp-mint-tracing)

Last updated 21 hours ago

Copy

    [{\
        "inputs": [\
          {\
            "internalType": "bytes32",\
            "name": "pathId",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "uint256",\
            "name": "nonce",\
            "type": "uint256"\
          },\
          {\
            "internalType": "bytes32",\
            "name": "sender",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes32",\
            "name": "recipient",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes32",\
            "name": "destinationCaller",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes",\
            "name": "body",\
            "type": "bytes"\
          }\
        ],\
        "name": "MessageV1",\
        "outputs": [],\
        "stateMutability": "view",\
        "type": "function"\
      },\
      {\
        "inputs": [\
          {\
            "internalType": "bytes32",\
            "name": "toChainID",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes32",\
            "name": "fromToken",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes32",\
            "name": "redeemer",\
            "type": "bytes32"\
          },\
          {\
            "internalType": "bytes",\
            "name": "scriptpubkey",\
            "type": "bytes"\
          },\
          {\
            "internalType": "uint256",\
            "name": "amount",\
            "type": "uint256"\
          }\
        ],\
        "name": "redeem",\
        "outputs": [],\
        "stateMutability": "view",\
        "type": "function"\
      }]

---

# Concepts | Lombard Docs

This section explains the fundamental architectural patterns and core mechanisms that power the Lombard SDK. It details the complete action lifecycle from initiation to completion, fee authorization processes, event and error handling strategies, Bitcoin deposit address management, and the referral system implementation -providing developers with essential knowledge to build robust integrations.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts#quick-links)

Quick Links:

[TypeScript Typeschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types)

Complete TypeScript type definitions for all SDK interfaces, parameters, and return values.

[Events Referencechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference)

Event constants and payload types for monitoring SDK operations and state changes.

[Error Codeschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes)

Comprehensive error code catalog with descriptions for implementing proper error handling and debugging.

[PreviousTesting and Sandboxchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox)
[NextAction lifecyclechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle)

Last updated 2 months ago

---

# Oracle | Lombard Docs

Lombard is introducing two changes relevant to oracle integrations:

1.  **LBTC** [**becomes yield-bearing on July 22**arrow-up-right](https://docs.google.com/document/d/1aCcZACyAI4hpm6iPpzvvGcZOSQzxFVd2DxcA-2zr-HY/edit?usp=sharing)
    **.** The price of LBTC will accumulate over Bitcoin based on yield earned.
    
2.  **BTC.b launch.** A new yieldless, risk-free Bitcoin wrapper token.
    

Both tokens are minted on Lombard Ledger (the appchain powering the Lombard ecosystem) and bridged via burn-and-mint mechanisms. Two Proof of Reserve feeds are required, one for each asset, with LBTC building on top of BTC.b.

> **Note:** The steps below include testnet URLs. See [API URLsarrow-up-right](https://claude.ai/chat/73424983-8063-4c79-a827-bd15373abb69#api-urls)
>  at the end of this document for production endpoints.

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#step-1-btc.b-lombard-protocol-solvency)

Step 1: BTC.b (Lombard Protocol Solvency)

The supply of BTC backing Lombard Protocol compared to BTC represented on Lombard Ledger.

**Calculate** `**btcReserves**`**:**

BTC supply can be calculated and verified based on all Lombard Protocol BTC addresses. All Lombard Protocol BTC addresses are published on the Base network.

*   Contract address: [https://basescan.org/address/0xe7Ebc588F4EC9297d9867aD75a9b5D86848c8018arrow-up-right](https://basescan.org/address/0xe7Ebc588F4EC9297d9867aD75a9b5D86848c8018)
    
*   Verification examples in Golang: [https://github.com/lombard-finance/verifierarrow-up-right](https://github.com/lombard-finance/verifier)
     (send IDs for access)
    

**Calculate** `**btcSupply**`**:**

Retrieve from Lombard Ledger:

Copy

    GET https://ledger-gastald.lombard-fi.com:1317/lombard-finance/ledger/assets/total_supply/ucbtc

Returns a JSON object with a `value` field.

**Calculate the ratio:**

*   Any ratio value **\> 1.0** should be clipped to 1.0 for reporting purposes, to prove the statement that the protocol is fully solvent.
    
*   Any ratio value **< 1.0** should trigger secondary checks where possible before publishing. Alerts should be in place given the critical impact on DeFi activity (i.e. liquidations) from inaccurate reporting. Monitoring and incident response plan/escalation procedure between teams should be implemented.
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#step-2-lbtc-ratio-lbtc-btc)

Step 2: LBTC Ratio (LBTC/BTC)

Can be combined with Step 1 for completeness.

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#option-a-calculate-via-supply)

Option A: Calculate via Supply

**Retrieve** `**lbtcSupply**` from Lombard Ledger:

**Retrieve** `**btcBackingLBTC**` from Lombard Ledger:

**Calculate:**

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#option-b-use-ratio-directly)

Option B: Use Ratio Directly

Get the ratio directly from Lombard Ledger's LBTC vault view function:

If needed, calculate the inverse: `rate = 1 / ratio`.

**Interpreting the value:**

*   Any value **\> 1.0** shows that LBTC has gained value relative to BTC.
    
*   Any value **< 1.0** shows that LBTC has lost value relative to BTC. Implement secondary checks where possible before publishing. Alerts should be in place given the critical impact on DeFi activity (i.e. liquidations) from inaccurate reporting. Monitoring and incident response plan/escalation procedure should be provided.
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#step-3-btc.b-ratio)

Step 3: BTC.b Ratio

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#option-a-from-lombard-ledger-and-destination-chains)

Option A: From Lombard Ledger and Destination Chains

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#option-b-from-bitcoin-network-lombard-ledger-and-destination-chains)

Option B: From Bitcoin Network, Lombard Ledger and Destination Chains

* * *

### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#api-urls)

API URLs

Environment

URL

Networks

Testnet

`https://ledger-gastald.lombard-fi.com:1317`

Bitcoin Signet, Ethereum Holesky

Production (load balanced)

`https://ledger-mainnet.lombard-fi.com:1317`

Mainnet

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#query-data-at-a-specific-block)

Query Data at a Specific Block

#### 

[hashtag](https://docs.lombard.finance/build/direct-integrations/oracle#resolve-block-at-a-specific-timestamp)

Resolve Block at a Specific Timestamp

Function to get a Cosmos block height at a specific timestamp via binary search on Tendermint RPC:

[PreviousBTC.b to LBTC and LBTC to BTC.b Swapschevron-left](https://docs.lombard.finance/build/direct-integrations/btc.b-to-lbtc-and-lbtc-to-btc.b-swaps)
[NextGMP Redeem Tracingchevron-right](https://docs.lombard.finance/build/direct-integrations/gmp-redeem-tracing)

Last updated 22 hours ago

*   [Step 1: BTC.b (Lombard Protocol Solvency)](https://docs.lombard.finance/build/direct-integrations/oracle#step-1-btc.b-lombard-protocol-solvency)
    
*   [Step 2: LBTC Ratio (LBTC/BTC)](https://docs.lombard.finance/build/direct-integrations/oracle#step-2-lbtc-ratio-lbtc-btc)
    
*   [Step 3: BTC.b Ratio](https://docs.lombard.finance/build/direct-integrations/oracle#step-3-btc.b-ratio)
    
*   [API URLs](https://docs.lombard.finance/build/direct-integrations/oracle#api-urls)
    

Copy

    ratio = btcReserves / btcSupply

Copy

    GET https://ledger-gastald.lombard-fi.com:1317/lombard-finance/ledger/assets/total_supply/uclbtc

Copy

    GET https://ledger-gastald.lombard-fi.com:1317/lombard-finance/ledger/btcstaking/staking_vault_base_balance

Copy

    ratio = lbtcSupply / btcBackingLBTC

Copy

    GET https://ledger-gastald.lombard-fi.com:1317/lombard-finance/ledger/btcstaking/current_ratio/uclbtc

Copy

    ratio = (btcSupply - btcBackingLBTC) / BTC.bDestinationChainsSupply

Copy

    ratio = (btcReserves - (lbtcSupply * lbtcRatio)) / BTC.bDestinationChainsSupply

Copy

    curl -H "x-cosmos-block-height: 6256072" \
      "https://ledger-mainnet.lombard-fi.com:1317/lombard-finance/ledger/btcstaking/staking_vault_base_balance"

Copy

    curl -s -H "x-cosmos-block-height: 6256072" \
      "https://ledger-mainnet.lombard-fi.com:1317/lombard-finance/ledger/assets/total_supply/ucbtc" | jq .

Copy

    export async function getCosmosBlockAtTimestamp(
      rpcUrl: string,
      targetTimestamp: number
    ): Promise<number> {
      // Get latest block height
      const statusRes = await axios.get(`${rpcUrl}/status`);
      const latestHeight = parseInt(statusRes.data.result.sync_info.latest_block_height);
    
      // Check if target is in the future
      const latestBlockRes = await axios.get(`${rpcUrl}/block?height=${latestHeight}`);
      const latestTime = new Date(latestBlockRes.data.result.block.header.time).getTime() / 1000;
      if (targetTimestamp >= latestTime) {
        console.log(`Cosmos: target timestamp is at or after latest block, using height ${latestHeight}`);
        return latestHeight;
      }
    
      let low = 1;
      let high = latestHeight;
      let bestHeight = latestHeight;
      let bestTimeDiff = Number.MAX_SAFE_INTEGER;
    
      while (high - low > 1) {
        const mid = Math.floor((low + high) / 2);
        try {
          const blockRes = await axios.get(`${rpcUrl}/block?height=${mid}`);
          const blockTime = new Date(blockRes.data.result.block.header.time).getTime() / 1000;
          const timeDiff = Math.abs(blockTime - targetTimestamp);
    
          if (timeDiff < bestTimeDiff) {
            bestTimeDiff = timeDiff;
            bestHeight = mid;
          }
    
          if (blockTime < targetTimestamp) {
            low = mid;
          } else {
            high = mid;
          }
        } catch (error) {
          console.error(`Error fetching Cosmos block ${mid}:`, error);
          high = mid - 1;
        }
      }
    
      console.log(`Cosmos: Found block ${bestHeight} for timestamp ${targetTimestamp}`);
      return bestHeight;
    }

---

# Events Reference | Lombard Docs

This section defines all events emitted by the SDK and how to handle them. Covers what triggers each event, what data it returns, and how to implement event listeners in your application.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#event-constants)

Event Constants

Source: `packages/sdk/src/shared/events.ts`

All action types emit the same event types:

Copy

    const StakeEvent = {
      Progress: 'progress',
      StatusChange: 'status-change',
      Completed: 'completed',
      Failed: 'failed',
      Error: 'error',
    } as const;
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#available-event-constants)

Available Event Constants

Copy

    import {
      StakeEvent,
      DepositEvent,
      UnstakeEvent,
      DeployEvent,
      RedeemEvent,
      BridgeEvent,
      StakeAndDeployEvent,
      DepositAndDeployEvent,
    } from '@lombard.finance/sdk';
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#event-handlers)

Event Handlers

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#stakeeventmap)

StakeEventMap

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#depositeventmap)

DepositEventMap

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#unstakeeventmap)

UnstakeEventMap

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#usage)

Usage

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#subscribing)

Subscribing

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#unsubscribing)

Unsubscribing

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#progress-object)

Progress Object

* * *

[PreviousTypeScript Typeschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types)
[NextError Codeschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes)

Last updated 2 months ago

*   [Event Constants](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#event-constants)
    
*   [Event Handlers](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#event-handlers)
    
*   [Usage](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#usage)
    
*   [Progress Object](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference#progress-object)
    

Copy

    interface StakeEventMap {
      'progress': (progress: StrategyProgress<string>) => void;
      'status-change': (status: string) => void;
      'completed': () => void;
      'failed': () => void;
      'error': (error: LombardError) => void;
    }
    

Copy

    interface DepositEventMap {
      'progress': (progress: StrategyProgress<string>) => void;
      'status-change': (status: string) => void;
      'completed': () => void;
      'failed': () => void;
      'error': (error: LombardError) => void;
    }
    

Copy

    interface UnstakeEventMap {
      'progress': (progress: StrategyProgress<string>) => void;
      'status-change': (status: string) => void;
      'completed': () => void;
      'failed': () => void;
      'error': (error: LombardError) => void;
    }
    

Copy

    import { StakeEvent } from '@lombard.finance/sdk';
    
    stake.on(StakeEvent.Progress, (progress) => {
      // progress.status, progress.steps
    });
    
    stake.on(StakeEvent.StatusChange, (status) => {
      // status: string
    });
    
    stake.on(StakeEvent.Completed, () => {
      // Operation completed
    });
    
    stake.on(StakeEvent.Error, (error) => {
      // error: LombardError
    });
    

Copy

    const handler = (status: string) => {
      // Handle status change
    };
    
    stake.on(StakeEvent.StatusChange, handler);
    stake.off(StakeEvent.StatusChange, handler);
    

Copy

    interface StrategyProgress<TStatus> {
      status: TStatus;
      steps: Record<string, StepStatus>;
      confirmations?: number;
      requiredConfirmations?: number;
      metadata?: Record<string, unknown>;
    }

---

# Start here | Lombard Docs

Start here to install the Lombard SDK, configure the environment, and make the first API calls.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#installation)

Installation

Copy

    npm install @lombard.finance/sdk
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#peer-dependencies)

Peer Dependencies

Copy

    npm install viem@^2.23.15 axios@^1 bignumber.js@^9 @bitcoinerlab/[email protected] [email protected]
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#configuration)

Configuration

Create the config once and reuse it throughout theyour application.

Copy

    // lib/lombard.ts
    import { createConfig, Env } from '@lombard.finance/sdk';
    
    export const config = createConfig({
      env: Env.testnet,
      partner: {
        partnerId: 'test',  // See Partners guide for production setup
      },
      providers: {
        evm: () => window.ethereum,
      },
    });
    

> Tip: Export theyour config from a central file (e.g., lib/lombard.ts) and import it wherever the you need SDK functionality is needed.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#configuration-options)

Configuration Options

Option

Type

Required

Description

env

Env

Yes

Environment (prod, testnet, dev)

providers

ProviderGetters

No

Wallet provider functions

partner

PartnerConfig

No

Partner configuration

modules

AnyModule\[\]

No

Custom modules

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#two-ways-to-use-the-sdk)

Two Ways to Use the SDK

Both approaches use the same config object.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#full-sdk-object)

Full SDK Object

Best for exploring all capabilities in one place.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#modular-factories)

Modular Factories

Best for production builds. Only import what you use for optimal tree-shaking.Import only the required modules to enable optimal tree-shaking.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#first-api-calls)

First API Calls

The SDK provides data-fetching methods via `sdk.api.*`:

[PreviousUser Guideschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides)
[NextConfigure PartnerIDchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid)

Last updated 2 months ago

*   [Installation](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#installation)
    
*   [Configuration](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#configuration)
    
*   [Configuration Options](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#configuration-options)
    
*   [Two Ways to Use the SDK](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#two-ways-to-use-the-sdk)
    
*   [First API Calls](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here#first-api-calls)
    

Copy

    interface CreateConfigOptions {
      env: Env;
      providers?: ProviderGetters;
      partner?: PartnerConfig;
      modules?: readonly AnyModule[];
    }
    

Copy

    import { createLombardSDK, Chain, AssetId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    // Chain actions
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    // Data API
    const deposits = await sdk.api.deposits('0x1234...');
    

Copy

    import { btcStake, Chain, AssetId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const stake = btcStake(config, {
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });

---

# Referral System | Lombard Docs

This section explains how referrals and attribution are tracked using the SDK.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#overview)

Overview

The referral system allows tracking user acquisition and attribution. Referral codes can be attached when generating deposit addresses.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#adding-referral-codes)

Adding Referral Codes

Pass a referral code when preparing a stake or deposit action.

Copy

    import { createLombardSDK, Chain, AssetId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    await stake.prepare({
      amount: '0.1',
      recipient: '0x1234567890abcdef1234567890abcdef12345678',
      referralCode: 'PARTNER123',
    });
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#checking-referral-status)

Checking Referral Status

Use the SDK's referrals client to check if an address has a referrer.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#response-type)

Response Type

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#referral-code-rules)

Referral Code Rules

*   Codes are case-insensitive
    
*   Codes are attached at deposit address generation time
    
*   Once set, a referrer cannot be changed for that address
    
*   Codes are associated with destination addresses, not deposit addresses
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#supported-actions)

Supported Actions

Referral codes can be added to:

*   `sdk.chain.btc.stake` — BTC to LBTC staking
    
*   `sdk.chain.btc.deposit` — BTC to BTC.b deposits
    
*   `sdk.chain.btc.stakeAndDeploy` — Stake to DeFi vault
    
*   `sdk.chain.btc.depositAndDeploy` — Deposit to DeFi vault
    

[PreviousBTC deposit addresseschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses)
[NextData APIchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#overview)
    
*   [Adding Referral Codes](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#adding-referral-codes)
    
*   [Checking Referral Status](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#checking-referral-status)
    
*   [Referral Code Rules](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#referral-code-rules)
    
*   [Supported Actions](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system#supported-actions)
    

Copy

    import { createLombardSDK } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    const result = await sdk.referrals.lookupReferrer({
      address: '0x1234567890abcdef1234567890abcdef12345678',
    });
    
    if (result.hasDepositAddress) {
      // result.referrer: 'PARTNER123' or undefined
    }
    

Copy

    interface ReferralLookupResult {
      hasDepositAddress: boolean;
      referrer?: string;
    }

---

# Fee authorization | Lombard Docs

This section describes the fee authorization process for EVM destinations, including signature handling.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#overview)

Overview

When staking BTC to `Ethereum Mainnet` or `Sepolia`, the SDK requires an EIP-712 signature to authorize the network fee. This happens during the `authorize()` step.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#flow)

Flow

Copy

    IDLE → NEEDS_FEE_AUTHORIZATION → READY → ADDRESS_READY
             ↑                          ↑
             prepare()                  authorize()
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#example)

Example

Copy

    import { createLombardSDK, Chain, AssetId, BtcActionStatus } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    await stake.prepare({
      amount: '0.1',
      recipient: '0x1234567890abcdef1234567890abcdef12345678',
    });
    // status: BtcActionStatus.NEEDS_FEE_AUTHORIZATION
    
    await stake.authorize();
    // Wallet prompts user to sign EIP-712 message
    // status: BtcActionStatus.READY
    
    const address = await stake.generateDepositAddress();
    // status: BtcActionStatus.ADDRESS_READY
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#other-destinations)

Other Destinations

For all other chains (Base, Solana, Sui, etc.), the flow uses address confirmation instead of fee authorization.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#stored-signatures)

Stored Signatures

Fee signatures can be reused. If a valid signature exists from a previous operation, `prepare()` will skip directly to `READY`.

[PreviousAction lifecyclechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle)
[NextEvent handlingchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#overview)
    
*   [Flow](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#flow)
    
*   [Example](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#example)
    
*   [Other Destinations](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#other-destinations)
    
*   [Stored Signatures](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization#stored-signatures)
    

Copy

    IDLE → NEEDS_ADDRESS_CONFIRMATION → READY → ADDRESS_READY
    

Copy

    const stake = sdk.chain.btc.stake({
      destChain: Chain.BASE,
      assetOut: AssetId.LBTC,
    });
    
    await stake.prepare({
      amount: '0.1',
      recipient: '0x1234567890abcdef1234567890abcdef12345678',
    });
    // status: BtcActionStatus.NEEDS_ADDRESS_CONFIRMATION
    
    // Sign a message that says 'Destination chain is 8453'
    await stake.authorize();
    // status: BtcActionStatus.READY
    

Copy

    await stake.prepare({
      amount: '0.1',
      recipient: '0x...',
    });
    
    if (stake.status === BtcActionStatus.READY) {
      // Existing signature found - no authorization needed
      const address = await stake.generateDepositAddress();
    }
    
    if (stake.status === BtcActionStatus.NEEDS_FEE_AUTHORIZATION) {
      // Need new signature
      await stake.authorize();
    }

---

# Error handling | Lombard Docs

This section covers error handling and validation failure scenarios in the SDK.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#lombarderror)

LombardError

All SDK errors are instances of `LombardError`.

Copy

    import { LombardError, isLombardError } from '@lombard.finance/sdk';
    
    try {
      await stake.prepare({ amount: '0.0001', recipient: '0x...' });
    } catch (error) {
      if (isLombardError(error)) {
        // error.code: string - Machine-readable error code
        // error.message: string - Human-readable message
        // error.metadata: object - Additional context
      }
    }
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#error-codes)

Error Codes

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#general-errors)

General Errors

Code

Description

unknown-error

Unexpected error

invalid-configuration

Invalid SDK configuration

operation-timeout

Operation timed out

operation-cancelled

User cancelled operation

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#provider-errors)

Provider Errors

Code

Description

provider-missing

Wallet provider not configured

provider-initialization-failed

Failed to initialize provider

provider-call-failed

Provider method call failed

signer-missing

Signer not available

user-rejected

User rejected transaction

network-mismatch

Wrong network selected

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#validation-errors)

Validation Errors

Code

Description

invalid-address

Invalid address format

invalid-amount

Invalid amount format

amount-too-small

Amount below minimum

amount-too-large

Amount above maximum

insufficient-balance

Not enough balance

invalid-parameter

Invalid parameter value

missing-required-parameter

Required parameter missing

invalid-chain

Unsupported chain

invalid-state

Invalid action state

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#contract-errors)

Contract Errors

Code

Description

contract-call-failed

Contract call failed

transaction-failed

Transaction failed

transaction-reverted

Transaction reverted

approval-failed

Token approval failed

insufficient-allowance

Token allowance too low

gas-estimation-failed

Gas estimation failed

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#handling-specific-errors)

Handling Specific Errors

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#error-metadata)

Error Metadata

Errors include relevant context in the `metadata` property.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#retry-pattern)

Retry Pattern

Errors don't reset action state. Retry the failed step directly.

[PreviousEvent handlingchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling)
[NextBTC deposit addresseschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses)

Last updated 2 months ago

*   [LombardError](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#lombarderror)
    
*   [Error Codes](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#error-codes)
    
*   [Handling Specific Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#handling-specific-errors)
    
*   [Error Metadata](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#error-metadata)
    
*   [Retry Pattern](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling#retry-pattern)
    

Copy

    import {
      LombardError,
      ValidationErrorCode,
      ProviderErrorCode,
      isLombardError,
    } from '@lombard.finance/sdk';
    
    try {
      await stake.authorize();
    } catch (error) {
      if (!isLombardError(error)) {
        throw error;
      }
    
      switch (error.code) {
        case ProviderErrorCode.USER_REJECTED:
          // User cancelled - show retry option
          break;
    
        case ValidationErrorCode.AMOUNT_TOO_SMALL:
          // Amount too small - show minimum
          const min = error.metadata?.minimum;
          break;
    
        case ProviderErrorCode.NETWORK_MISMATCH:
          // Wrong network - prompt switch
          break;
    
        default:
          // Generic error handling
          break;
      }
    }
    

Copy

    try {
      await stake.prepare({ amount: '0.0001', recipient: '0x...' });
    } catch (error) {
      if (isLombardError(error) && error.code === 'amount-too-small') {
        // error.metadata.amount: '0.0001'
        // error.metadata.minimum: '0.001'
        // error.metadata.asset: 'BTC'
      }
    }

---

# Reference | Lombard Docs

This section serves as the technical reference library for the Lombard SDK, providing comprehensive TypeScript type definitions, a complete events reference for monitoring SDK operations, and an exhaustive error codes catalog to help developers implement proper error handling and debugging in their integrations.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference#quick-links)

Quick Links:

[Action lifecyclechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle)

How SDK actions are structured, executed, and managed through their complete state machine.

[Fee authorizationchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization)

EIP-712 signature requirements for Ethereum Mainnet operations and signature reuse patterns.

[Event handlingchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling)

Subscribe to action events for tracking progress, status changes, and operation completion.

[Error handlingchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling)

LombardError structure, error codes, validation failures, and retry patterns.

[BTC deposit addresseschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses)

Generate and reuse chain-specific Bitcoin deposit addresses with signature binding.

[Referral Systemchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system)

Track user acquisition and attribution by attaching referral codes to deposit addresses.

[PreviousStarknet Unstakechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities/non-evm/starknet-unstake)
[NextTypeScript Typeschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types)

Last updated 2 months ago

---

# Error Codes | Lombard Docs

This section defines all error code reference for debugging SDK integrations. Shows all possible errors, what causes them, and how to handle them.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#general-errors)

General Errors

Code

Description

`unknown-error`

An unexpected error occurred

`invalid-configuration`

SDK configuration is invalid

`operation-timeout`

Operation timed out

`operation-cancelled`

User cancelled the operation

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#provider-errors)

Provider Errors

Code

Description

`provider-missing`

Required wallet provider not configured

`provider-initialization-failed`

Failed to initialize wallet provider

`provider-call-failed`

Wallet provider method call failed

`signer-missing`

Transaction signer not available

`user-rejected`

User rejected the transaction or signature

`network-mismatch`

Wallet is connected to wrong network

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#validation-errors)

Validation Errors

Code

Description

`invalid-address`

Address format is invalid

`invalid-amount`

Amount format is invalid

`amount-too-small`

Amount is below minimum

`amount-too-large`

Amount is above maximum

`insufficient-balance`

Not enough balance for operation

`invalid-parameter`

Parameter value is invalid

`missing-required-parameter`

Required parameter was not provided

`invalid-chain`

Chain is not supported

`invalid-state`

Action is in invalid state for operation

`invalid-asset`

Asset is not supported

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#contract-errors)

Contract Errors

Code

Description

`contract-call-failed`

Smart contract call failed

`transaction-failed`

Transaction execution failed

`transaction-reverted`

Transaction was reverted

`approval-failed`

Token approval failed

`insufficient-allowance`

Token allowance is too low

`gas-estimation-failed`

Could not estimate gas

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#registry-errors)

Registry Errors

Code

Description

`route-not-found`

No matching route found

`invalid-route-definition`

Route definition is invalid

`unsupported-chain`

Chain is not supported in environment

`unsupported-asset`

Asset is not supported

`incompatible-route`

Route is incompatible with parameters

`environment-mismatch`

Environment mismatch

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#error-handling)

Error Handling

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#error-metadata)

Error Metadata

Errors include context in the `metadata` property:

* * *

[PreviousEvents Referencechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference)
[NextLombard SDK FAQchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/lombard-sdk-faq)

Last updated 2 months ago

*   [General Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#general-errors)
    
*   [Provider Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#provider-errors)
    
*   [Validation Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#validation-errors)
    
*   [Contract Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#contract-errors)
    
*   [Registry Errors](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#registry-errors)
    
*   [Error Handling](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#error-handling)
    
*   [Error Metadata](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/error-codes#error-metadata)
    

Copy

    import {
      isLombardError,
      ProviderErrorCode,
      ValidationErrorCode,
    } from '@lombard.finance/sdk';
    
    try {
      await stake.authorize();
    } catch (error) {
      if (!isLombardError(error)) {
        throw error;
      }
    
      switch (error.code) {
        case ProviderErrorCode.USER_REJECTED:
          // User cancelled - offer retry
          break;
    
        case ValidationErrorCode.AMOUNT_TOO_SMALL:
          // Show minimum amount from error.metadata
          break;
    
        case ProviderErrorCode.NETWORK_MISMATCH:
          // Prompt user to switch networks
          break;
    
        default:
          // Generic error handling
          break;
      }
    }
    

Copy

    if (error.code === ValidationErrorCode.AMOUNT_TOO_SMALL) {
      // error.metadata.amount: provided amount
      // error.metadata.minimum: minimum required
      // error.metadata.asset: asset symbol
    }
    
    if (error.code === ProviderErrorCode.PROVIDER_MISSING) {
      // error.metadata.chain: chain that needs provider
      // error.metadata.providerType: type of provider needed
    }

---

# API Methods | Lombard Docs

This section explains how to fetch deposits, unstakes, points, and exchange rates using the Data API.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#overview)

Overview

The SDK provides data-fetching methods under the `api` namespace. These methods query Lombard's backend APIs.

Copy

    import { createLombardSDK } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#deposits)

deposits

Fetch all deposits for an address.

Copy

    const deposits = await sdk.api.deposits('0x1234...');
    // deposits: Deposit[]
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#response-type)

Response Type

See `Deposit` in `packages/sdk/src/api-functions/getDepositsByAddress/getDepositsByAddress.ts`

Copy

    interface Deposit {
      isNative: boolean;
      txHash: string;
      eventIndex: number;
      amount: BigNumber;
      tokenAmount?: BigNumber;
      depositAddress?: string;
      fromAddress?: string;
      toAddress?: string;
      toChainId: ChainId | SuiChain | SolanaChain | StarknetChainId;
      fromChainId?: ChainId | SuiChain | SolanaChain | StarknetChainId;
      blockHeight?: number;
      blockTime?: number;
      notarizationStatus: ENotarizationStatus;
      sessionState: ESessionState;
      claimTxHash?: string;
      isClaimed: boolean;
      sanctioned?: boolean;
    }
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#unstakes)

unstakes

Fetch all unstakes for an address.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#response-type-1)

Response Type

See `Unstake` in `packages/sdk/src/api-functions/getUnstakesByAddress/getUnstakesByAddress.ts`

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#points)

points

Fetch Lux points for an address.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#exchangeratio)

exchangeRatio

Fetch the current exchange ratios for all supported tokens.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#depositaddress)

depositAddress

Get an existing BTC deposit address for a recipient.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#with-options)

With Options

* * *

[PreviousData APIchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api)
[NextCapabilitieschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/capabilities)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#overview)
    
*   [deposits](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#deposits)
    
*   [unstakes](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#unstakes)
    
*   [points](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#points)
    
*   [exchangeRatio](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#exchangeratio)
    
*   [depositAddress](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/data-api/api-methods#depositaddress)
    

Copy

    const unstakes = await sdk.api.unstakes('0x1234...');
    // unstakes: Unstake[]
    
    // With filters
    const filtered = await sdk.api.unstakes('0x1234...', {
      show_redeems: true,   // default: true
      show_unstakes: true,  // default: true
      to_native: false,     // default: false
    });
    

Copy

    interface Unstake {
      isNative: boolean;
      txHash: string;
      fromChainId: ChainId | SuiChain | SolanaChain | StarknetChainId;
      toChainId?: ChainId | SuiChain | SolanaChain | StarknetChainId | 'bitcoin';
      blockHeight: number;
      blockTime: number;
      fromAddress: string;
      toAddress?: string;
      amount: BigNumber;
      payoutTxHash?: string;
      payoutTxIndex?: number;
      payoutTxStatus: PayoutTxStatus;
      sanctioned?: boolean;
      notarizationStatus?: ENotarizationStatus;
      sessionState?: ESessionState;
      claimTxHash?: string;
    }
    

Copy

    // Current season
    const points = await sdk.api.points('0x1234...');
    // points: { totalPoints, holdingPoints, ... }
    
    // Specific season
    const s1 = await sdk.api.points('0x1234...', 1);
    const s2 = await sdk.api.points('0x1234...', 2);
    

Copy

    const ratios = await sdk.api.exchangeRatio();
    
    // Access LBTC ratios
    const lbtcRatio = ratios.LBTC;
    console.log(`LBTC:BTC = ${lbtcRatio.tokenBTCRatio}`);  // How many LBTC per 1 BTC
    console.log(`BTC:LBTC = ${lbtcRatio.BTCTokenRatio}`);  // How many BTC per 1 LBTC
    

Copy

    import { ChainId } from '@lombard.finance/sdk';
    
    try {
      const btcAddress = await sdk.api.depositAddress(
        '0x1234567890abcdef1234567890abcdef12345678',
        ChainId.ethereum
      );
      // btcAddress: 'bc1q...'
    } catch (error) {
      // No existing deposit address found
    }
    

Copy

    import { ChainId } from '@lombard.finance/sdk';
    
    const btcAddress = await sdk.api.depositAddress(
      '0x1234...',
      ChainId.ethereum,
      {
        partnerId: 'YOUR_PARTNER_ID',  // optional
        token: 'LBTC',                  // optional
      }
    );

---

# TypeScript Types | Lombard Docs

Technical reference for all SDK types, interfaces, and data structures. Use this section to understand parameter formats, response objects, and type constraints.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#configuration-types)

Configuration Types

Source: `packages/sdk/src/config/types.ts`

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#createconfigoptions)

CreateConfigOptions

Copy

    interface CreateConfigOptions {
      env: Env;
      providers?: ProviderGetters;
      modules?: readonly AnyModule[];
      partner?: PartnerConfig;
    }
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#partnerconfig)

PartnerConfig

Copy

    interface PartnerConfig {
      partnerId: string;
    }
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#providergetters)

ProviderGetters

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#environment)

Environment

Source: `packages/sdk-common/src/env.ts`

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#status-types)

Status Types

Source: `packages/sdk/src/shared/constants/statusConstants.ts`

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#btcactionstatus)

BtcActionStatus

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#evmoperationstatus)

EvmOperationStatus

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#nonevmunstakestatus)

NonEvmUnstakeStatus

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#error-types)

Error Types

Source: `packages/sdk/src/shared/errors.ts`

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#lombarderror)

LombardError

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#error-codes)

Error Codes

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#action-types)

Action Types

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#btcstakeparams)

BtcStakeParams

Source: `packages/sdk/src/chains/btc/actions/stake/types.ts`

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#btcstake-prepare-params)

BtcStake Prepare Params

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#evmunstakeparams)

EvmUnstakeParams

Source: `packages/sdk/src/chains/evm/actions/unstake/types.ts`

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#progress-types)

Progress Types

Source: `packages/sdk/src/core/types.ts`

* * *

[PreviousReferencechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference)
[NextEvents Referencechevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/events-reference)

Last updated 2 months ago

*   [Configuration Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#configuration-types)
    
*   [Environment](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#environment)
    
*   [Status Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#status-types)
    
*   [Error Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#error-types)
    
*   [Action Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#action-types)
    
*   [Progress Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/reference/typescript-types#progress-types)
    

Copy

    interface ProviderGetters {
      evm?: ProviderGetter<EvmProvider>;
      bitcoin?: ProviderGetter<BtcProvider>;
      solana?: ProviderGetter<SolanaProvider>;
      sui?: ProviderGetter<SuiProvider>;
      starknet?: ProviderGetter<StarknetProvider>;
    }
    
    type ProviderGetter<TProvider> = (chain?: Chain) => TProvider | Promise<TProvider>;
    

Copy

    const Env = {
      prod: 'prod',
      testnet: 'testnet',
      stage: 'stage',
      dev: 'dev',
      ibc: 'ibc',
    } as const;
    
    type Env = (typeof Env)[keyof typeof Env];
    

Copy

    const BtcActionStatus = {
      IDLE: 'idle',
      NEEDS_FEE_AUTHORIZATION: 'needs_fee_authorization',
      NEEDS_ADDRESS_CONFIRMATION: 'needs_address_confirmation',
      NEEDS_DEPLOY_AUTHORIZATION: 'needs_deploy_authorization',
      READY: 'ready',
      ADDRESS_READY: 'address_ready',
      AWAITING_DEPOSIT: 'awaiting_deposit',
    } as const;
    

Copy

    const EvmOperationStatus = {
      IDLE: 'idle',
      NEEDS_APPROVAL: 'needs-approval',
      READY: 'ready',
      CONFIRMING: 'confirming',
      COMPLETED: 'completed',
    } as const;
    

Copy

    const NonEvmUnstakeStatus = {
      IDLE: 'idle',
      READY: 'ready',
      CONFIRMING: 'confirming',
      COMPLETED: 'completed',
    } as const;
    

Copy

    class LombardError extends Error {
      readonly code: AnyErrorCode;
      readonly metadata?: Record<string, unknown>;
    
      constructor(
        code: AnyErrorCode,
        message: string,
        metadata?: Record<string, unknown>
      );
    
      toJSON(): Record<string, unknown>;
    }
    

Copy

    enum ErrorCode {
      UNKNOWN_ERROR = 'unknown-error',
      INVALID_CONFIGURATION = 'invalid-configuration',
      OPERATION_TIMEOUT = 'operation-timeout',
      OPERATION_CANCELLED = 'operation-cancelled',
    }
    
    enum ProviderErrorCode {
      PROVIDER_MISSING = 'provider-missing',
      PROVIDER_INITIALIZATION_FAILED = 'provider-initialization-failed',
      PROVIDER_CALL_FAILED = 'provider-call-failed',
      SIGNER_MISSING = 'signer-missing',
      USER_REJECTED = 'user-rejected',
      NETWORK_MISMATCH = 'network-mismatch',
    }
    
    enum ValidationErrorCode {
      INVALID_ADDRESS = 'invalid-address',
      INVALID_AMOUNT = 'invalid-amount',
      AMOUNT_TOO_SMALL = 'amount-too-small',
      AMOUNT_TOO_LARGE = 'amount-too-large',
      INSUFFICIENT_BALANCE = 'insufficient-balance',
      INVALID_PARAMETER = 'invalid-parameter',
      MISSING_REQUIRED_PARAMETER = 'missing-required-parameter',
      INVALID_CHAIN = 'invalid-chain',
      INVALID_STATE = 'invalid-state',
      INVALID_ASSET = 'invalid-asset',
    }
    
    enum ContractErrorCode {
      CONTRACT_CALL_FAILED = 'contract-call-failed',
      TRANSACTION_FAILED = 'transaction-failed',
      TRANSACTION_REVERTED = 'transaction-reverted',
      APPROVAL_FAILED = 'approval-failed',
      INSUFFICIENT_ALLOWANCE = 'insufficient-allowance',
      GAS_ESTIMATION_FAILED = 'gas-estimation-failed',
    }
    
    enum RegistryErrorCode {
      ROUTE_NOT_FOUND = 'route-not-found',
      INVALID_ROUTE_DEFINITION = 'invalid-route-definition',
      UNSUPPORTED_CHAIN = 'unsupported-chain',
      UNSUPPORTED_ASSET = 'unsupported-asset',
      INCOMPATIBLE_ROUTE = 'incompatible-route',
      ENVIRONMENT_MISMATCH = 'environment-mismatch',
    }
    

Copy

    interface BtcStakeParams {
      assetOut: AssetId;
      destChain: Chain;
      sourceChain?: typeof Chain.BITCOIN_MAINNET | typeof Chain.BITCOIN_SIGNET;
    }
    

Copy

    interface BtcStkePrepareParams {
      amount: string;
      recipient: string;
      referralCode?: string;
    }
    

Copy

    interface EvmUnstakeParams {
      assetIn: AssetId;
      assetOut: AssetId;
      sourceChain: Chain;
      destChain: Chain;
    }
    
    interface EvmUnstakePrepareParams {
      amount: string;
      recipient: string;
    }
    

Copy

    interface StrategyProgress<TStatus extends string> {
      status: TStatus;
      steps: Record<string, StepStatus>;
      confirmations?: number;
      requiredConfirmations?: number;
      metadata?: Record<string, unknown>;
    }
    
    const StepStatus = {
      IDLE: 'idle',
      PENDING: 'pending',
      COMPLETE: 'complete',
      FAILED: 'failed',
    } as const;

---

# Terms of Service | Lombard Docs

#### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#last-updated-march-12-2025)

Last updated: March 12, 2025

Hello, and welcome to Lombard Finance’s Terms of Use (these “Terms”). These Terms are important because they describe your rights and obligations when using the Services (defined below) offered by us or our affiliates.

Please note that these Terms contain Indemnification, Governing Law, Dispute Resolution, Assumption of Risk and Disclaimer of Warranties and Limitation of Liability sections that affect your rights, including your ability to bring legal claims against us.

Please read these Terms, our [Privacy Policy](https://docs.lombard.finance/resources/privacy-policy)
 (the “Privacy Policy”) and any other terms referenced in this document carefully. If you do not agree to be bound by these Terms of Use, you are not permitted to use our Services.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-1.-introduction)

**1\. Introduction**

The Services are operated by Lombard Finance Ltd (“Lombard Finance”, “we”, “us”, “our”). These Terms govern your access to and use of the Lombard Finance website and related webpages (“Website”) and/or the website-hosted user interface, available at lombard.finance (the “App”), as well as certain features contained on the Website and in the App (collectively, the “Services”). By signing up to use an account, you agree to be bound by the terms and conditions contained in these Terms, including Section 10 ("Dispute Resolution"), as well as the Privacy Policy.

LOMBARD FINANCE IS NOT A BROKER, FINANCIAL INSTITUTION OR CREDITOR. THE SERVICES ARE OFFERED AS AN ADMINISTRATIVE PLATFORM ONLY.

Lombard Finance is not authorised or regulated by the UK Financial Conduct Authority. Protections provided by the UK regulatory system will not be available to you when using Lombard.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-2.-using-our-services)

**2\. Using Our Services**

The Services. The App included in the Services is a front-end, web-based interface to the Protocols (as defined below). The Protocols facilitate the staking and restaking of digital assets. The Protocols are not part of the Services and exist as software deployed on certain blockchain networks. Accordingly, prior to using the Services you should read the Terms carefully, including the Important Disclaimers that follow, and familiarize yourself with the Protocols from other publicly available sources.

#### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#important-disclaimers)

Important Disclaimers.

_Not financial advice_. The Services are not intended as, and do not provide, any investment or financial advice whatsoever. As with any financial or investment decisions, you should conduct your own research and due diligence investigation, to properly evaluate the benefits and risks of any investment or financial transaction. You should also seek the advice and guidance of qualified accountants, financial advisors, tax advisors, legal counsels and investment advisors, in connection with any investment or financial transaction.

_Wallets_. To use certain of the Services you may need to link a third-party digital wallet ("Wallet") with the Services. By using a Wallet in connection with the Services, you agree that you are using the Wallet under the terms and conditions of the applicable third-party provider of such Wallet. Wallets are not associated with, maintained by, supported by or affiliated with the Lombard Finance. You acknowledge and agree that we are not party to any transactions conducted while accessing the Services, and we do not have possession, custody or control over any digital assets appearing on the Services. When you interact with the App, you retain control over your digital assets at all times. We accept no responsibility or liability to you in connection with your use of a Wallet, and makes no representations and warranties regarding how the App will operate with any specific Wallet. The private keys and/or seed phrases necessary to access the assets held in a Wallet are not held by us. We have no ability to help you access or recover your private keys and/or seed phrases for your Wallet.

_Third-party technologies._ The App included in the Services displays data that, in conjunction with certain technologies (including validator nodes, network bridges, and your Wallet) controlled or operated by parties other than Lombard Finance (the “Third-Party Technologies”), facilitates your interfacing with a set of decentralized technologies that allow digital assets, such as Bitcoin (BTC), to be staked and re-staked. The technologies facilitating the staking of Bitcoin are referred to herein as the "Babylon Protocol” and the technologies facilitating the liquid representation of staked or re-staked digital assets are referred to herein as the “Lombard Protocol” (and together are referred to herein as the “Protocols"). The App is not essential to accessing the Protocols. Any transactions or messages that you submit to either Protocol will be executed programmatically, which Lombard Finance cannot pause, reverse, or recall. **The Protocols and the Third-Party Technologies are not part of the Services, and your engagement with the Protocols via the App is entirely at your own risk.**

_Informational purposes only._ Information about the Protocol is available on the Website at lombard.finance (the “Documentation”) is provided for informational purposes only and may be incomplete, contain mistakes, or become out-of-date. Users are responsible for verifying that the Documentation is accurate and up to date. Anytime you interact with the Protocol, you should conduct a test transaction prior to conducting a material transaction. **We are not liable for any damage or loss caused or alleged to be caused by your reliance on the Documentation.**

_Rewards_. In your use of the Services, we may attribute to you certain reputation indicators, points, or other intangible rewards (“Rewards”). Rewards are not, and may never convert to, accrue to, be used as basis to calculate, or become any other tokens or virtual assets or distribution thereof. Rewards are virtual items with no monetary value. Rewards do not constitute any currency or property of any type and are not redeemable, refundable, or eligible for any fiat or virtual currency or anything else of value. Rewards are not transferable between users, and you may not attempt to sell, trade, or transfer any Rewards, or obtain any manner of credit using any Rewards. Any attempt to sell, trade, or transfer any Rewards or tokens redeemable for or representing any Rewards will be null and void. Any token distributions or pass through administrations of digital assets that you may receive are governed separately under the “Token Distributions from Third-Party Platforms” section of these Terms, and the Rewards provided here are entirely distinct from those token distributions.

_Yield._ Your engagement of the Protocols or Third-Party Services (as defined in Section 7) may result in the accumulation and/or transfer of certain digital assets (“Yield”) to an account or Wallet of yours. The amount of Yield you accumulate and/or actually receive, if any, is determined entirely by the Protocols and/or Third-Party Services. **We cannot and do not offer or guarantee the receipt of Yield in connection with your use of the Services or your engagement of the Protocols and/or Third-Party Services.**

_Token Distributions from Third-Party Platforms._ From time to time, we may receive tokens or other digital assets (“Third-Party Tokens”) from protocols, platforms, or other third-party sources and may, at our discretion, distribute such Third-Party Tokens to you based on criteria such as staking activity. We act solely as an administrative agent in receiving and distributing these Third-Party Tokens and do not control, guarantee, or influence their issuance, liquidity, market value, yield, or conversion. We make no guarantees regarding the receipt, amount, timing, or availability of Third-Party Tokens. All distributions are subject to token availability and our discretion. Third-Party Tokens, if distributed, are provided “as-is” with no warranties regarding value, functionality, or compatibility. We may modify, suspend, or terminate any distribution of Third-Party Tokens at any time, with or without notice, and without incurring liability. You are solely responsible for providing accurate and up-to-date wallet addresses or other required information for receiving any Third-Party Tokens, including any applicable anti-money laundering, “know your customer,” or other identity verification requirements. We are not liable for tokens lost or misdirected due to inaccurate information provided by you. You are also responsible for understanding and complying with any tax, legal, or regulatory obligations arising from the receipt or use of Third-Party Tokens. You are encouraged to consult with professional advisors regarding such matters.

Eligibility. You may not use the Services if you:

1.  are below the legal age in your jurisdiction, or if it is otherwise illegal in your jurisdiction for you to access, view and/or use the Services;
    
2.  do not have the technical knowledge necessary or advisable to understand and evaluate the risks of using App, engaging the Protocols, the Third-Party Technologies, and Third-Party Services;
    
3.  are currently located in or, a resident, citizen, national or agent of, or an entity organized, incorporated or doing business in, Belarus, Burundi, Crimea and Sevastopol, Cuba, Democratic Republic of Congo, Iran, Iraq, Libya, North Korea, Russia, Somalia, Sudan, Syria, the United States of America, Venezuela, or Zimbabwe;
    
4.  are a person or entity that is (i) on any list of prohibited or restricted parties maintained by the government of the United Kingdom, the European Union, or the United States, including without limitation the U.S. Treasury Department’s list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person’s List or Entity List, (ii) located or organized in any country or region any country or region that has been designated by the government of the United Kingdom, the European Union, or the United States, as "terrorist supporting" or is otherwise subject to embargo by any of the foregoing, or (iii) owned or controlled by, or intend to transact with, such persons or entities listed in (i)-(ii).
    

If you do not leave the Services, then you will be deemed for all purposes to have represented that none of the conditions listed in (a)-(d) above apply to you.

**Updates to Terms of Use.** Your use of the Services is subject to your agreement to these Terms, which may be updated by us at any time with or without notice to you. The date of the most recent change to these Terms will be provided at the top of each version of these Terms. Any such updates will be effective upon our publishing such updated Terms. If you do not agree with these Terms, you may not use the Services.

**Updates to the Services.** We may update and change our Services from time to time, for example, to reflect changes to our products, our users' needs and our business priorities. We will try to give you reasonable notice of any major changes.

**Terms of Use.** By using the Services, you agree: (a) to provide accurate, current and complete information about yourself; (b) to maintain and promptly update from time to time as necessary your information; (c) that you will use our Services only for yourself, and not on behalf of any third party, unless authorized by such third party; and (d) that you are fully responsible for all activity on the Services that occurs under your name or account. We may, in our sole discretion, refuse to allow you to use the Services, or suspend or terminate your access to the Services. You also agree that any notices, agreements, disclosures, or other communications that we send to you electronically will satisfy any legal communication requirements, including, but not limited to, that such communications be in writing. You may opt out of receiving promotional emails that you have previously opted-in to at any time by following the instructions to unsubscribe, as provided therein.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-3.-termination-of-access-to-services)

**3\. Termination of Access to Services**

**Suspension, Termination, and Cancellation.** Lombard Finance may, at its option and in its sole discretion: (a) suspend, restrict, or terminate your access to any or all of the Services if: (i) we are so required by a facially valid subpoena, court order or binding order of any government authority; (ii) we reasonably suspect you of using the Services in connection with any Prohibited Uses (as defined below); (iii) your use of the Services is subject to any pending litigation, investigation, or government proceeding and/or we, in our sole discretion, perceive a heightened risk of legal or regulatory non-compliance associated with your activity; (iv) any of our service partners are unable to support your use thereof; (v) you take any action that Lombard Finance deems in its sole discretion as circumventing Lombard Finance’s controls, or abusing promotions which Lombard Finance may offer from time to time; or (vi) you breach these Terms.

If Lombard Finance suspends your access or terminates your use of the Services for any reason, we will provide you with notice of our actions, unless a court order or other legal process prevents or prohibits Lombard Finance from providing you with such notice. You acknowledge that Lombard Finance’s decision to take certain actions, including limiting access to or suspending your User Account, may be based on confidential criteria that are essential to Lombard Finance’s risk management and/or security protocols. You agree that Lombard Finance is under no obligation to disclose the details of its risk management and/or security procedures to you.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-4.-user-conduct)

**4\. User Conduct**

**Prohibited Uses.** You may not use the Services to engage in the following categories of activity ("Prohibited Uses"). The Prohibited Uses listed below are representative, but not exhaustive, and Lombard Finance reserves the right to update or amend such list in its sole discretion at any time, with or without notice to you. If you are uncertain as to whether or not your use of the Services involves a Prohibited Use or have questions about how these requirements apply to you, please contact us at [\[email protected\]envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#036f6664626f436f6c6e616271672d656a6d626d6066)
. By using the Services, you agree that you will not use the Services to do or undertake any of the following, as determined by Lombard Finance in its sole discretion:

*   **Abusive Activity:** Actions which: (i) conduct, facilitate, authorize, or permit any text or data mining or web scraping, (ii) impose an unreasonable or disproportionately large load on our infrastructure, or detrimentally interfere with, intercept, or expropriate any system, data, or information; (iii) transmit or upload any material to the Services that contains viruses, Trojan horses, worms, or any other harmful or deleterious programs; or (iv) attempt to gain unauthorized access to the Services.
    
*   **Unlawful Activity:** Activity which would violate, or assist in the violation of, any law, statute, ordinance or regulation, sanctions programs administered in any of the countries where Lombard Finance conducts business, including but not limited to the U.S. Department of Treasury's Office of Foreign Assets Control ("OFAC"), or which would involve proceeds of any unlawful activity.
    
*   **Abuse Other Users:** Interfere with another individual's access to or use of the Services; defame, abuse, extort, harass, stalk, threaten, or otherwise violate or infringe the legal or other rights (such as, but not limited to, rights of privacy, publicity, and intellectual property) of others; or harvest or otherwise collect information from the Services about others, including, without limitation, email addresses, without proper consent.
    
*   **Fraud:** Activity which operates to defraud Lombard Finance, any Lombard Finance user(s) or any other person, or provide any false, inaccurate, or misleading information to Lombard Finance.
    

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-5.-copyright-and-license-to-you)

5\. Copyright and License to You

**Information Ownership.** Unless otherwise indicated in writing by us, the Services and all content and other materials contained therein, including, without limitation, the Lombard Finance logo and all designs, text, graphics, trademarks, pictures, information, data, software, sound files, and/or other files related thereto and/or associated therewith and the selection and arrangement thereof (collectively, “Content”) are and shall remain the sole and proprietary property of Lombard Finance or our affiliates or licensors, if and as applicable.

**Third-Party Intellectual Property.** Notwithstanding anything to the contrary in these Terms, the Services and Content may include software components provided by Lombard Finance or its affiliates or a third party that are subject to separate license terms, in which case those license terms will govern the usage of such software components, as applicable.

**Third-Party Services.** The Services may contain links to third-party websites (“Third-Party Websites”) and/or applications (“Third-Party Applications”). When you click on a link to a Third-Party Website or Third-Party Application, we will not warn you that you have left the Services and are subject to the terms and conditions (including privacy policies, if and as applicable) of another website or destination. Lombard Finance provides these Third-Party Websites and Third-Party Applications only as a convenience and does not review, approve, monitor, endorse, warrant, or make any representations with respect to Third-Party Websites or Third-Party Applications or their products or services. You use all links in Third-Party Websites and Third-Party Applications at your own risk.

**Limited License to You.** These Terms grant users a limited and non-exclusive right to use the Services, including all Content thereon. Except as indicated otherwise herein or in any additional terms or conditions, you may not reproduce, distribute, modify, create derivative works of, publicly display, publicly perform, republish, download, store, transmit, or otherwise exploit any of the Content on our Services, except as follows:

*   Your device may temporarily store copies of such materials in RAM incidental to your accessing and viewing those materials.
    
*   You may store files that are automatically cached by your web browser for display enhancement purposes.
    
*   You may download a single copy of the mobile application to your computer or mobile device solely for your own personal, non-commercial use, provided you agree to be bound by our end user license agreement for such applications.
    

You must not:

*   Modify copies of any Content from the Services.
    
*   Use any illustrations, photographs, video, or audio sequences or any graphics available through the Services separately from the accompanying text.
    
*   Delete or alter any copyright, trademark, or other proprietary rights notices from copies of materials available through the Services.
    

If you wish to make any use of Content other than that set out in this Section, please address your request to: [\[email protected\]envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#a1cdc4c6c0cde1cdceccc3c0d3c58fc7c8cfc0cfc2c4)
.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-6.-risks-inherent-to-blockchain-technologies)

6\. Risks Inherent to Blockchain Technologies

By accessing and using the Services, you represent that you understand the risks inherent to and associated with blockchain networks and cryptographic systems and warrant that you have the technical sophistication and working knowledge required to use, engage, or interact with the Third-Party Technologies, the Protocols, and related blockchain networks, cryptographic systems, smart contracts, and digital assets (collectively, “Blockchain Technologies”).

By accessing and using the Services, you assume all risks associated with using Blockchain Technologies, including, but not limited to, the risk of hardware, software and internet connections failure or problems, the risk of malicious software introduction, and the risk that third parties may obtain unauthorized access to information stored within the Blockchain Technologies. You accept and acknowledge that Lombard Finance will not be responsible for any communication failures, disruptions, errors, distortions or delays you may experience when using any Blockchain Technologies for processing transactions, however caused.

Additionally, you understand that the markets for cryptographic and digital assets are nascent and highly volatile due to risk factors including (but not limited to) adoption, speculation, technology, security, and regulation. You acknowledge that we are not responsible for any of these variables or risks, do not own or control any blockchain, and cannot be held liable for any resulting losses that you experience as a result of your use of Blockchain Technologies. Accordingly, you understand and agree to assume full responsibility for all of the risks of accessing and using Blockchain Technologies as part of your use of the Services.

The Services, including the App, may allow you to browse certain services or products that are developed or operated by persons other than Lombard Finance (“Third-Party Services”), including services or products that purport compatibility with restaked digital assets. The Third-Party Services may display, include or make available content, data, information, applications or materials from third-parties (“Third-Party Materials”) or provide links to certain third party websites. We do not endorse or recommend any Third-Party Materials, the use of any provider of any Third-Party Services, or the restaking or delegation of any assets to any Third-Party Services. You agree that your access and use of such Third-Party Services and Third-Party Materials is governed solely by the terms and conditions of such Third-Party Services and Third-Party Materials, as applicable. We are not responsible or liable for, and make no representations as to any aspect of such Third-Party Materials and Third-Party Services, including, without limitation, their content or the manner in which they handle, protect, manage or process data or any interaction between you and the provider of such Third-Party Services. We are not responsible for examining or evaluating the content, accuracy, completeness, availability, timeliness, validity, copyright compliance, legality, decency, quality, security or any other aspect of such Third-Party Services or Third Party Materials or websites. You irrevocably waive any claim against us with respect to such Third-Party Services and Third-Party Materials. We are not liable for any damage or loss caused or alleged to be caused by or in connection with your enablement, access or use of any such Third-Party Services or Third-Party Materials, or your reliance on the privacy practices, data security processes or other policies of such Third-Party Services. Third-Party Services, Third-Party Materials and links to other websites are provided solely as a convenience to you. Certain Third-Party Services or Third-Party Materials may automatically populate on the Company’s Services. We reserve the right to remove any Third-Party Services or Third-Party Materials from the Services for any reason whatsoever.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-8.-indemnification)

8\. Indemnification

To the fullest extent permitted by applicable law, you agree to indemnify, defend, and hold harmless Lombard Finance, and our respective past, present, and future employees, officers, directors, contractors, consultants, equity holders, suppliers, vendors, service providers, parent companies, subsidiaries, affiliates, agents, representatives, predecessors, successors, and assigns (individually and collectively, the “Lombard Finance Parties”), from and against all actual or alleged claims, damages, awards, judgments, losses, liabilities of every kind, and nature whatsoever, whether known or unknown, that are caused by, arise out of, or are related to (a) your use or misuse of the Services, (b) your violation of these Terms, and/or (c) your violation of any right(s) of any third party. You agree to promptly notify Lombard Finance of any Claim(s) and shall cooperate fully with the Lombard Finance Parties in defending such Claims. You further agree that the Lombard Finance Parties shall have control of the defense or settlement of any third party Claims. THIS INDEMNITY IS IN ADDITION TO, AND NOT IN LIEU OF, ANY OTHER INDEMNITIES SET FORTH IN ANY WRITTEN AGREEMENT(S) BETWEEN YOU AND LOMBARD FINANCE.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-9.-limitation-of-liability)

9\. Limitation of Liability

EXCEPT AS EXPRESSLY PROVIDED TO THE CONTRARY IN A WRITING BY LOMBARD FINANCE, THE SERVICES, CONTENT CONTAINED THEREIN, AND ANY BLOCKCHAIN TECHNOLOGIES REFERENCED THEREIN ARE PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. LOMBARD FINANCE (AND ITS AFFILIATE(S), LICENSOR(S) AND/OR OTHER BUSINESS ASSOCIATE(S)) MAKES NO WARRANTY THAT THE SERVICES: (A) WILL MEET YOUR REQUIREMENTS; (B) WILL BE AVAILABLE ON AN UNINTERRUPTED, TIMELY, SECURE, OR ERROR-FREE BASIS; OR (C) WILL BE ACCURATE, RELIABLE, COMPLETE, LEGAL OR SAFE. LOMBARD FINANCE DISCLAIMS ALL OTHER WARRANTIES OR CONDITIONS, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT AS TO THE SERVICES, CONTENT CONTAINED THEREIN. YOU ACCEPT THE INHERENT SECURITY RISKS OF PROVIDING INFORMATION AND DEALING ONLINE OVER THE INTERNET AND WILL NOT HOLD US RESPONSIBLE FOR ANY BREACH OF SECURITY UNLESS IT IS DUE TO OUR GROSS NEGLIGENCE.

YOU AGREE AND ACKNOWLEDGE THAT LOMBARD FINANCE HAS NO CONTROL OVER AND MAKES NO GUARANTEES OR PROMISES WITH RESPECT TO THE OWNERSHIP RECORD OR SMART CONTRACTS. LOMBARD FINANCE MAKES NO OFFER OR INVITATION TO ACQUIRE, PURCHASE, TRANSFER, SELL, OR OTHERWISE DEAL IN BLOCKCHAIN TECHNOLOGIES. YOU WAIVE ANY AND ALL RIGHTS AND CLAIMS YOU MAY HAVE, WHETHER KNOWN OR UNKNOWN AGAINST LOMBARD FINANCE (AND ANY RELATED PARTIES) RELATED TO BLOCKCHAIN TECHNOLOGIES AVAILABLE ON THE SERVICES.

TO THE FULLEST EXTENT PROVIDED BY LAW, IN NO EVENT WILL LOMBARD FINANCE OR ITS AFFILIATES, OR ITS OR THEIR LICENSORS, SERVICE PROVIDERS, EMPLOYEES, CONTRACTORS, AGENTS, OFFICERS, OR DIRECTORS, BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO, PERSONAL INJURY, PAIN AND SUFFERING, EMOTIONAL DISTRESS, LOSS OF REVENUE, LOSS OF PROFITS, LOSS OF BUSINESS OR ANTICIPATED SAVINGS, LOSS OF USE, LOSS OF GOODWILL, LOSS OF DATA, LOSS OF DIGITAL ASSETS, LOSS OF PRIVATE KEY, LOSS OF SEED PHRASE, LOSS OF ACCESS TO ANY DIGITAL WALLET, OR ANY OTHER DAMAGES OF ANY KIND, UNDER ANY LEGAL THEORY, ARISING OUT OF OR IN CONNECTION WITH YOUR USE, OR INABILITY TO USE, THE SERVICES, INCLUDING BUT NOT LIMITED TO ANY CONTENT ON THE SERVICES OR ANY OTHER WEBSITES AND MOBILE APPLICATIONS OR ANY ITEMS OBTAINED THROUGH THE SERVICES OR SUCH OTHER WEBSITES AND MOBILE APPLICATIONS, WHETHER CAUSED BY TORT (INCLUDING NEGLIGENCE), BREACH OF CONTRACT, OR OTHERWISE, EVEN IF FORESEEABLE.

IN NO EVENT WILL LOMBARD FINANCE’S AGGREGATE LIABILITY FOR ALL CLAIMS RELATING TO THE SERVICES, THE ACCESS TO AND USE OF THE SERVICE, CONTENT, REWARDS OR ANY PRODUCTS OR SERVICES ON THE SERVICES EXCEED $100.

ANY CAUSE OF ACTION OR CLAIM YOU MAY HAVE ARISING OUT OF OR RELATING TO THESE TERMS OR THE SERVICES MUST BE COMMENCED WITHIN ONE (1) YEAR AFTER THE CAUSE OF ACTION ACCRUES, OTHERWISE, SUCH CAUSE OF ACTION OR CLAIM SHALL BE DEEMED PERMANENTLY WAIVED AND BARRED.

THIS SECTION DOES NOT AFFECT ANY LIABILITY THAT CANNOT BE EXCLUDED OR LIMITED UNDER APPLICABLE LAW. BECAUSE SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR THE LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, IN SUCH JURISDICTIONS THE ABOVE LIMITATIONS AND EXCLUSIONS MAY NOT APPLY TO YOU. IN SUCH JURISDICTIONS, OUR LIABILITY IS LIMITED TO THE EXTENT PERMITTED BY LAW, THEREBY MINIMIZING OUR LIABILITY TO YOU TO THE LOWEST AMOUNT PERMITTED BY APPLICABLE LAW.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-10.-dispute-resolution)

10\. Dispute Resolution

**This Section includes an arbitration agreement and an agreement that all claims will be brought only in an individual capacity (and not as a class action or other representative proceeding). Please read it carefully.**

**Informal Process.** You agree that in the event of any dispute between you and Lombard Finance, you will first contact Lombard Finance in a writing that specifically references this section and which describes the dispute and your position in relation to it in sufficient details for the receiving company to engage in meaningful discussions about the dispute (“Dispute Notice”). For a period of no less than thirty days after receipt of the Dispute Notice, or such longer period as the parties may agree in writing, you shall make a good faith and sustained effort for a to resolve the dispute before resorting to more formal means of resolution.

**Agreement to Arbitrate.** All claims, disputes and controversies directly or indirectly arising out of or in connection with or directly or indirectly relating to these Terms or any of the matters or transactions contemplated by these Terms (for the avoidance of doubt, including any claim seeking to invalidate, or alleging that, all or any part of these Terms is unenforceable, void or voidable) (such claims, disputes and controversies, collectively, “Disputes”) shall be resolved by confidential, binding arbitration to be seated in the Cayman Islands and conducted in the English language by a single arbitrator pursuant to the International Arbitration Rules of the International Centre for Dispute Resolution (the “Rules”). The arbitrator shall be appointed in accordance with the procedures set out in the Rules. The award or decision of the arbitrator shall be final and binding upon the parties and the parties expressly waive any right under the laws of any jurisdiction to appeal or otherwise challenge the award, ruling or decision of the arbitrator. The judgment of any award or decision may be entered in any court having competent jurisdiction to the extent necessary. If any party elects to have a Dispute resolved by arbitration pursuant to this provision, no party hereto shall (or shall permit its representatives to) commence, continue or pursue any Dispute in any court; provided, however, that we shall be entitled to obtain an injunction or injunctions to prevent breaches of this provision and to enforce specifically the terms and provisions thereof, this being in addition to any other remedy to which we are entitled at law or in equity, and the parties hereto hereby waive the requirement of any posting of a bond in connection with such injunctive relief or specific performance.

After the informal dispute resolution process, any remaining dispute arising out of or in connection with these Terms or Lombard Finance’s services and/or products, including but not limited to the Services, or relating in any way to the communications between you and Lombard Finance or any other user of the Services, including any question regarding its existence, validity or termination (collectively, “Dispute”), shall be referred to and finally resolved by confidential, binding arbitration to be seated in the Cayman Islands and conducted in the English language by a single arbitrator pursuant to the International Arbitration Rules (the “Rules”) of the International Centre for Dispute Resolution (the “ICDR”)for the time being in force, which rules are deemed to be incorporated by reference in this clause. You and Lombard Finance shall endeavor to agree upon the arbitrator, and if you and Lombard Finance fail to do so within twenty-one (21) days of the commencement of the Arbitration, the appointment shall be made by ICDR in accordance with the Rules. This mandatory arbitration agreement applies to you and to Lombard Finance. However, this arbitration agreement does not (a) govern any Dispute initiated by Lombard Finance for infringement of its intellectual property, or (b) bar you from making use of applicable small claims court procedures in appropriate cases.

The laws of the Cayman Islands shall govern this arbitration agreement, which shall survive any termination of these Terms.

If you wish to begin an arbitration proceeding, after following the informal dispute resolution procedure, you must send a letter requesting arbitration and describing your claim to: [\[email protected\]envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#f9959c9e9895b99596949b988b9dd79f909798979a9c)
 .

**Arbitration Procedure and Rules.** The arbitration will be administered by the ICDR under the Rules by a sole arbitrator. You can access the Rules at [https://www.icdr.org/rules\_forms\_feesarrow-up-right](https://www.icdr.org/rules_forms_fees)
 . Each party shall bear its own filing and administrative fees in the first instance. Lombard Finance will reimburse those fees for claims where the amount in dispute is less than $10,000, unless the arbitrator determines the claims are frivolous, and we will not seek attorneys’ fees and costs in arbitration unless the arbitrator determines the claims are frivolous.

The arbitrator, and not any federal, state, or local court, will have exclusive authority to resolve any dispute relating to the interpretation, applicability, unconscionability, arbitrability, enforceability or formation of this arbitration agreement, including any claim that all or any part of this arbitration agreement is void or voidable. However, the preceding sentence will not apply to the “Class Action Waiver” section below.

**Class Action Waiver. Any Claim must be brought in the respective party’s individual capacity, and not as a plaintiff or class member in any purported class, collective, representative, multiple plaintiff or similar proceeding** (“Class Action”). The parties expressly waive any ability to maintain any Class Action in any forum. If the Claim is subject to arbitration, the arbitrator will not have authority to combine or aggregate similar claims or conduct any Class Action nor make an award to any person or entity not a party to the arbitration. Any claim that all or part of this Class Action Waiver is unenforceable, unconscionable, void or voidable may be determined only by a court of competent jurisdiction and not by an arbitrator. The parties understand that any right to litigate in court, to have a judge or jury decide their case or to be a party to a class or representative action is waived, and that any claims must be decided individually, through arbitration.

**Waiver of Jury Trial.** If for any reason a claim proceeds in court rather than in arbitration, you and Lombard Finance each waive any right to a jury trial.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-11.-miscellaneous)

11\. Miscellaneous

**Governing Law and Venue.** These Terms, your access to and use of the Services and Content, and your participation in the Services, shall be governed by and construed and enforced in accordance with the laws of the Cayman Islands.

**Severability.** If any term, clause or provision of these Terms is held invalid or unenforceable, then that term, clause, or provision will be severable from these Terms and will not affect the validity or enforceability of any remaining part of that term, clause, or provision, or any other term, clause, or provision of these Terms.

**Wavier.** If we fail to insist that you perform any of your obligations under these Terms, or if we do not enforce our rights against you, or if we delay in doing so, that will not mean that we have waived our rights against you and will not mean that you do not have to comply with those obligations. If we do waive a default by you, we will only do so in writing, and that will not mean that we will automatically waive any later default by you.

**Assignability.** These Terms are personal to you, and are not assignable, transferable, or sublicensable by you except with Lombard Finance’s prior written consent.

**Notices.** All notices under these Terms will be in writing and will be deemed to have been duly given when received, if personally delivered or sent by certified or registered mail, return receipt requested; when receipt is electronically confirmed, if transmitted by facsimile or e-mail; or the day after it is sent, if sent for next day delivery by recognized overnight delivery service.

### 

[hashtag](https://docs.lombard.finance/resources/terms-of-service#id-12.-contact-us)

12\. Contact us

If you have any questions or complaints about our Services or these Terms, please email us at [\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
 .

[PreviousUK Residentschevron-left](https://docs.lombard.finance/resources/uk-residents)
[NextPrivacy Policychevron-right](https://docs.lombard.finance/resources/privacy-policy)

Last updated 2 months ago

*   [1\. Introduction](https://docs.lombard.finance/resources/terms-of-service#id-1.-introduction)
    
*   [2\. Using Our Services](https://docs.lombard.finance/resources/terms-of-service#id-2.-using-our-services)
    
*   [3\. Termination of Access to Services](https://docs.lombard.finance/resources/terms-of-service#id-3.-termination-of-access-to-services)
    
*   [4\. User Conduct](https://docs.lombard.finance/resources/terms-of-service#id-4.-user-conduct)
    
*   [5\. Copyright and License to You](https://docs.lombard.finance/resources/terms-of-service#id-5.-copyright-and-license-to-you)
    
*   [6\. Risks Inherent to Blockchain Technologies](https://docs.lombard.finance/resources/terms-of-service#id-6.-risks-inherent-to-blockchain-technologies)
    
*   [8\. Indemnification](https://docs.lombard.finance/resources/terms-of-service#id-8.-indemnification)
    
*   [9\. Limitation of Liability](https://docs.lombard.finance/resources/terms-of-service#id-9.-limitation-of-liability)
    
*   [10\. Dispute Resolution](https://docs.lombard.finance/resources/terms-of-service#id-10.-dispute-resolution)
    
*   [11\. Miscellaneous](https://docs.lombard.finance/resources/terms-of-service#id-11.-miscellaneous)
    
*   [12\. Contact us](https://docs.lombard.finance/resources/terms-of-service#id-12.-contact-us)

---

# Configure PartnerID | Lombard Docs

This section is intended for teams seeking to partner with Lombard and integrate the Lombard SDK. It covers the configuration of a Partner ID, which allows applications to bypass CAPTCHA when generating BTC deposit addresses.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#what-is-a-partner-id)

What is a Partner ID?

A Partner ID is a unique identifier for your integration that enables:

Capability

Description

**CAPTCHA Bypass**

Your users won't need to solve CAPTCHAs when generating deposit addresses

**Deposit Attribution**

All BTC deposits through your integration are tracked to your organization

**Partner Analytics**

Access to dashboards showing your integration's deposit volume (coming soon)

**Economic Incentives**

Eligibility for fee sharing and partner rewards (coming soon)

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#getting-a-partner-id)

Getting a Partner ID

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#step-1-submit-your-interest)

Step 1: Submit Your Interest

Email [**\[email protected\]**envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#93e3f2e1e7fdf6e1e0fbfae3e0d3fffcfef1f2e1f7bdf5fafdf2fdf0f6)
 with basic information about your integration.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#step-2-quick-review-and-partner-id-submission)

Step 2: Quick Review and Partner ID submission

Our team reviews submissions hourly. We'll reach out via email or telegram with your partner ID.

After our conversation, we'll issue your Partner ID - typically within **a few hours**. You'll receive it via email or Telegram.

* * *

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#configuration)

Configuration

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#testing)

Testing

For development, use `test` as the Partner ID to bypass captcha:

* * *

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#frequently-asked-questions)

Frequently Asked Questions

**How long does it take to get a Partner ID?**

After our intro conversation, Partner IDs are issued within a few hours.

**Is there a cost or commercial agreement required?**

No. Partner IDs are issued at no cost. We may discuss commercial partnerships for larger integrations, but it's not required.

**Can I have multiple Partner IDs?**

Yes. If you have multiple products or integrations, request a separate Partner ID for each so you can track attribution independently.

**What if I'm just experimenting?**

Use `'test'` on testnet. You only need a real Partner ID when you're ready for production.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#questions)

Questions?

*   **Email:** [\[email protected\]](https://docs.lombard.finance/cdn-cgi/l/email-protection)
    
*   **Telegram:** @kevsilk
    

[PreviousStart herechevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here)
[NextConnect walletschevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets)

Last updated 2 months ago

*   [What is a Partner ID?](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#what-is-a-partner-id)
    
*   [Getting a Partner ID](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#getting-a-partner-id)
    
*   [Configuration](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#configuration)
    
*   [Testing](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#testing)
    
*   [Frequently Asked Questions](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#frequently-asked-questions)
    
*   [Questions?](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid#questions)
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.prod,
      partner: {
        partnerId: 'YOUR_PARTNER_ID',
      },
      providers: {
        evm: () => window.ethereum,
      },
    });
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      partner: {
        partnerId: 'test',
      },
      providers: {
        evm: () => window.ethereum,
      },
    });

---

# Event handling | Lombard Docs

This section covers event subscriptions for tracking action progress and state changes.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#overview)

Overview

Actions emit events throughout their lifecycle. These events can be used to update application UI and track progress.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#event-types)

Event Types

Event

Payload

Description

status-change

string

Status changed

progress

StrategyProgress

Detailed progress update

completed

void

Operation completed successfully

failed

void

Operation failed

error

LombardError

Error occurred

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#subscribing-to-events)

Subscribing to Events

Copy

    import { createLombardSDK, Chain, AssetId, StakeEvent } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    stake.on(StakeEvent.StatusChange, (status) => {
      // status: 'idle' | 'needs_fee_authorization' | 'ready' | 'address_ready'
    });
    
    stake.on(StakeEvent.Progress, (progress) => {
      // progress.status, progress.steps, progress.confirmations
    });
    
    stake.on(StakeEvent.Completed, () => {
      // Operation completed
    });
    
    stake.on(StakeEvent.Error, (error) => {
      // error.code, error.message, error.metadata
    });
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#progress-object)

Progress Object

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#unsubscribing)

Unsubscribing

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#event-constants)

Event Constants

Each action type has its own event constants.

All event types have the same shape:

* * *

[PreviousFee authorizationchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization)
[NextError handlingchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#overview)
    
*   [Event Types](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#event-types)
    
*   [Subscribing to Events](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#subscribing-to-events)
    
*   [Progress Object](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#progress-object)
    
*   [Unsubscribing](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#unsubscribing)
    
*   [Event Constants](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/event-handling#event-constants)
    

Copy

    interface StrategyProgress<TStatus> {
      status: TStatus;
      steps: Record<string, StepStatus>;
      confirmations?: number;
      requiredConfirmations?: number;
      metadata?: Record<string, unknown>;
    }
    
    const StepStatus = {
      IDLE: 'idle',
      PENDING: 'pending',
      COMPLETE: 'complete',
      FAILED: 'failed',
    };
    

Copy

    const handler = (status: string) => {
      // Handle status change
    };
    
    stake.on(StakeEvent.StatusChange, handler);
    
    // Later...
    stake.off(StakeEvent.StatusChange, handler);
    

Copy

    import {
      StakeEvent,
      DepositEvent,
      UnstakeEvent,
      DeployEvent,
      RedeemEvent,
      BridgeEvent,
    } from '@lombard.finance/sdk';
    

Copy

    const StakeEvent = {
      Progress: 'progress',
      StatusChange: 'status-change',
      Completed: 'completed',
      Failed: 'failed',
      Error: 'error',
    };

---

# Connect wallets | Lombard Docs

This section outlines the supported wallet providers and the steps required to connect Bitcoin, EVM, and non-EVM wallets to the Lombard SDK.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#evm-provider)

EVM Provider

The EVM provider must implement the EIP-1193 interface.

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        evm: () => window.ethereum,
      },
    });
    

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#with-wagmi)

With wagmi

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    import { getWalletClient } from '@wagmi/core';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        evm: async () => {
          const client = await getWalletClient();
          return client;
        },
      },
    });
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#bitcoin-provider)

Bitcoin Provider

Use OKX Wallet for Bitcoin operations.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#bitcoin-provider-interface)

Bitcoin Provider Interface

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#solana-provider)

Solana Provider

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#solana-provider-interface)

Solana Provider Interface

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#sui-provider)

Sui Provider

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#starknet-provider)

Starknet Provider

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#async-providers)

Async Providers

Providers can return promises for async wallet initialization.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#multiple-providers)

Multiple Providers

Configure all providers your application needs.Configure all required providers for the application.

* * *

[PreviousConfigure PartnerIDchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/configure-partnerid)
[NextTesting and Sandboxchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/testing-and-sandbox)

Last updated 2 months ago

*   [EVM Provider](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#evm-provider)
    
*   [Bitcoin Provider](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#bitcoin-provider)
    
*   [Solana Provider](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#solana-provider)
    
*   [Sui Provider](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#sui-provider)
    
*   [Starknet Provider](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#starknet-provider)
    
*   [Async Providers](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#async-providers)
    
*   [Multiple Providers](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/start-here/connect-wallets#multiple-providers)
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        bitcoin: () => window.okxwallet?.bitcoin,
      },
    });
    

Copy

    interface BtcProvider {
      getAccounts(): Promise<string[]>;
      signMessage(message: string, type?: 'ecdsa' | 'bip322-simple'): Promise<string>;
      signPsbt(psbtHex: string, options?: object): Promise<string>;
    }
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        solana: () => window.solana,
      },
    });
    

Copy

    interface SolanaProvider {
      publicKey: { toString(): string };
      signMessage(message: Uint8Array): Promise<{ signature: Uint8Array }>;
      signTransaction(tx: Transaction): Promise<Transaction>;
    }
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        sui: () => window.suiWallet,
      },
    });
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        starknet: () => window.starknet,
      },
    });
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        evm: async () => {
          await window.ethereum.request({ method: 'eth_requestAccounts' });
          return window.ethereum;
        },
      },
    });
    

Copy

    import { createConfig, Env } from '@lombard.finance/sdk';
    
    const config = createConfig({
      env: Env.testnet,
      providers: {
        evm: () => window.ethereum,
        bitcoin: () => window.okxwallet?.bitcoin,
        solana: () => window.solana,
        sui: () => window.suiWallet,
        starknet: () => window.starknet,
      },
    });

---

# BTC deposit addresses | Lombard Docs

This section explains how to generate and reuse BTC deposit addresses.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#overview)

Overview

When staking BTC, the SDK generates a unique deposit address. These addresses are:

*   **Chain-specific** — Bound to a destination chain, partnerId and recipient
    
*   **Reusable** — Can receive multiple deposits
    
*   **Signature-bound** — Tied to the authorization signature (for Ethereum Mainnet)
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#generating-a-deposit-address)

Generating a Deposit Address

Copy

    import { createLombardSDK, Chain, AssetId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    await stake.prepare({
      amount: '0.1',
      recipient: '0x1234567890abcdef1234567890abcdef12345678',
    });
    
    await stake.authorize();
    
    const depositAddress = await stake.generateDepositAddress();
    // depositAddress: 'bc1q...'
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#checking-for-existing-address)

Checking for Existing Address

Use the API to check if a deposit address already exists.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#reusing-addresses)

Reusing Addresses

Deposit addresses can receive multiple deposits. Each deposit is processed independently.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#address-expiration)

Address Expiration

BTC deposit addresses do not expire. However, fee authorization signatures for Ethereum Mainnet may expire after a defined period. When a signature expires, re-authorization is required before generating a new address.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#multiple-chains)

Multiple Chains

Each destination chain requires its own deposit address.

[PreviousError handlingchevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/error-handling)
[NextReferral Systemchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/referral-system)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#overview)
    
*   [Generating a Deposit Address](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#generating-a-deposit-address)
    
*   [Checking for Existing Address](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#checking-for-existing-address)
    
*   [Reusing Addresses](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#reusing-addresses)
    
*   [Address Expiration](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#address-expiration)
    
*   [Multiple Chains](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/btc-deposit-addresses#multiple-chains)
    

Copy

    import { createLombardSDK, ChainId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    try {
      const address = await sdk.api.depositAddress(
        '0x1234567890abcdef1234567890abcdef12345678',
        ChainId.ethereum,
        // Optional override
        {
          partnerId: 'test', // Uses partnerId from sdk config
          token: Token.LBTC // defaults to Token.LBTC
        }
      );
      // Address exists: 'bc1q...'
    } catch (error) {
      // No existing address - need to generate one
    }
    

Copy

    // First deposit
    const depositAddress = await stake.generateDepositAddress();
    // User sends 0.1 BTC
    
    // Later, user can send more BTC to the same address
    // No need to generate a new address
    

Copy

    // Ethereum deposit address
    const ethStake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    await ethStake.prepare({ amount: '0.1', recipient: '0x...' });
    await ethStake.authorize();
    const ethAddress = await ethStake.generateDepositAddress();
    
    // Base deposit address (different)
    const baseStake = sdk.chain.btc.stake({
      destChain: Chain.BASE,
      assetOut: AssetId.LBTC,
    });
    await baseStake.prepare({ amount: '0.1', recipient: '0x...' });
    await baseStake.authorize();
    const baseAddress = await baseStake.generateDepositAddress();

---

# Action lifecycle | Lombard Docs

This section explains how SDK actions are structured, executed, and managed throughout their lifecycle.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#overview)

Overview

Actions are the core building blocks of the SDK. Each action represents a multi-step blockchain operation with:

*   Predictable state machine
    
*   Event-driven progress updates
    
*   Built-in error handling
    
*   Retry support without state reset
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#action-pattern)

Action Pattern

All actions follow the same pattern:

1.  **Create** — Initialize with configuration
    
2.  **Prepare** — Validate parameters and check requirements
    
3.  **Authorize** — Sign any required messages or transactions
    
4.  **Execute** — Perform the main operation
    

Copy

    import { createLombardSDK, Chain, AssetId } from '@lombard.finance/sdk';
    import { config } from './lib/lombard';
    
    const sdk = createLombardSDK(config);
    
    // 1. Create
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    // 2. Prepare
    await stake.prepare({
      amount: '0.1',
      recipient: '0x1234567890abcdef1234567890abcdef12345678',
    });
    
    // 3. Authorize
    await stake.authorize();
    
    // 4. Execute
    const result = await stake.generateDepositAddress();
    // result: 'bc1q...'
    

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#status-states)

Status States

Actions have a `status` property that indicates their current state.

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#btc-action-status)

BTC Action Status

#### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#evm-operation-status)

EVM Operation Status

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#orthogonal-properties)

Orthogonal Properties

Actions have three independent properties:

Property

Type

Description

status

string

Current step in the flow

isLoading

boolean

Whether an async operation is in progress

error

Error

null

These are independent. An action can be in any status with or without an error.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#error-recovery)

Error Recovery

When an error occurs, the status stays at the step where it happened. This enables retry without resetting state.

* * *

### 

[hashtag](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#checking-status)

Checking Status

* * *

[PreviousConceptschevron-left](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts)
[NextFee authorizationchevron-right](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/fee-authorization)

Last updated 2 months ago

*   [Overview](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#overview)
    
*   [Action Pattern](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#action-pattern)
    
*   [Status States](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#status-states)
    
*   [Orthogonal Properties](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#orthogonal-properties)
    
*   [Error Recovery](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#error-recovery)
    
*   [Checking Status](https://docs.lombard.finance/build/the-lombard-sdk/user-guides/concepts/action-lifecycle#checking-status)
    

Copy

    const BtcActionStatus = {
      IDLE: 'idle',
      NEEDS_FEE_AUTHORIZATION: 'needs_fee_authorization',
      NEEDS_ADDRESS_CONFIRMATION: 'needs_address_confirmation',
      NEEDS_DEPLOY_AUTHORIZATION: 'needs_deploy_authorization',
      READY: 'ready',
      ADDRESS_READY: 'address_ready',
      AWAITING_DEPOSIT: 'awaiting_deposit',
    };
    

Copy

    const EvmOperationStatus = {
      IDLE: 'idle',
      NEEDS_APPROVAL: 'needs-approval',
      READY: 'ready',
      CONFIRMING: 'confirming',
      COMPLETED: 'completed',
    };
    

Copy

    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    await stake.prepare({ amount: '0.1', recipient: '0x...' });
    // status: 'needs_fee_authorization'
    
    try {
      await stake.authorize();
    } catch (error) {
      // status is still 'needs_fee_authorization'
      // User can retry
      await stake.authorize();
    }
    

Copy

    import { BtcActionStatus, Chain, AssetId } from '@lombard.finance/sdk';
    
    const stake = sdk.chain.btc.stake({
      destChain: Chain.ETHEREUM,
      assetOut: AssetId.LBTC,
    });
    
    if (stake.status === BtcActionStatus.IDLE) {
      // Ready for prepare()
    }
    
    if (
    	stake.status === BtcActionStatus.NEEDS_FEE_AUTHORIZATION
    	|| stake.status === BtcActionStatus.NEEDS_ADDRESS_CONFIRMATION
      || stake.status === BtcActionStatus.NEEDS_DEPLOY_AUTHORIZATION
    ) {
      // Ready for authorize()
    }
    
    if (stake.status === BtcActionStatus.READY) {
      // Ready for generateDepositAddress()
    }

---

# $BARD Token Airdrop Terms and Conditions | Lombard Docs

**Terms and Conditions**

**1\. Introduction.**

These Token Airdrop Terms & Conditions (“_**Airdrop Terms**_”) govern your participation in and receipt of $BARD Tokens (“_**Tokens**_”) through the Airdrop (as defined below) by the Liquid Bitcoin Operations Inc. (collectively, “**Lombard**”, “**we**” or “**us**”).

Please read these Airdrop Terms carefully, as they include important information about your legal rights. By participating in the Airdrop or claiming Airdrop tokens, you (“_**Participant**_”) are agreeing to these Airdrop Terms. If you do not understand or agree to these Airdrop Terms, please do not participate in the Airdrop.

These Airdrop Terms are supplemental to, and incorporate by reference, the Lombard Terms of Service available at [Terms of Service](https://docs.lombard.finance/resources/terms-of-service)
 (the “_**Terms**_” and, together with the Airdrop Terms, the “_**Agreement**_”). Capitalized terms used but not defined herein have the meaning given in the Terms. In the event of a conflict between these Airdrop Terms and the Terms, these Airdrop Terms will govern.

By participating in the Airdrop (defined below) in any way, you represent and warrant to and for the benefit of Lombard and its affiliates, officers, directors, employees, and third-party service providers (“_**Lombard Parties**_”) (i) that you have read, understand, and agree to be bound by this Agreement; and (ii) that you are eligible to participate in the Airdrop (defined below) and receive Tokens (defined below).

YOU ARE SOLELY RESPONSIBLE FOR MAKING YOUR OWN DECISIONS WITH RESPECT TO YOUR PARTICIPATION IN THE AIRDROP. BY PARTICIPATING IN THE AIRDROP, YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT YOU ASSUME ALL RISK WITH RESPECT THERETO, INCLUDING WITHOUT LIMITATION THOSE SET FORTH IN THESE AIRDROP TERMS. **IN NO EVENT SHALL THE LOMBARD PARTIES HAVE ANY LIABILITY TO YOU OR ANY THIRD PARTY ARISING FOR ANY CLAIMS, DAMAGES, OR OTHER LOSS ARISING FROM OR RELATED TO THE AIRDROP OR ANY TOKENS. YOU PARTICIPATE IN THE AIRDROP AND RECEIVE TOKENS AT YOUR OWN RISK**.

**2\. Airdrop.**

“_**Airdrop**_” means each and every program through which Lombard shall make the Tokens available to certain users. Airdrop mechanics may require users to enable software (including a Wallet, as defined below), agree to the Lombard Terms of Service, and agree to these Airdrop Terms.

The Airdrop shall be conducted during a specified period, as determined by Lombard in its sole discretion and announced on the Site or elsewhere in Lombard’s discretion (the “_**Airdrop Period**_”). Each Participant must follow the instructions set forth in any Airdrop announcement and/or such other instructions as may be provided by Lombard from time to time (the “_**Airdrop Rules**_”) to participate in the Airdrop. The number of Tokens allocated to a Participant in any Airdrop will be determined by Lombard, in its sole discretion, and such allocation may vary among Participants or may vary from time to time during the Airdrop Period.

**3\. Participant Eligibility**

You are not eligible to participate in the Airdrop if you are (i) located in, or a resident of, the United States or any other jurisdiction where participation in the Airdrop may be restricted or prohibited by applicable law or regulations or (ii) a Prohibited Person (as defined below).

You agree and acknowledge that you are not a Prohibited Person and you will not use a “virtual private network” or other tool to circumvent any geographical limitations or other restrictions that we may have implemented for Airdrop recipients. Any such circumvention, or attempted circumvention, may permanently disqualify you from participation in the Airdrop in our sole and absolute discretion.

A “_**Prohibited Person**_” is any person or entity that is (a) the subject of any economic or trade sanctions administered or enforced by any governmental authority, including being designated on any list of prohibited or restricted parties by any governmental authority, such as the U.S. Treasury Department’s list of Specially Designated Nationals, the U.S. Department of Commerce Denied Persons List Entity List, the E.U. Consolidated List of persons and the U.K. Consolidated List of Financial Sanctions Targets, (b) located in, a resident of, are a citizen, national or agent of, or an entity organized, incorporated or doing business in any jurisdiction or territory that is the subject of comprehensive country-wide or regional economic sanctions or has been designated as “terrorist supporting” by the United Nations or the governmental authority of the European Union, United Kingdom or the United States, or (c) owned or controlled by such persons or entities listed in (a)-(b).

You further acknowledge and agree as follows:

*   Lombard, in its sole discretion, shall determine the eligibility criteria for participation in the Airdrop, including what quantity of Tokens shall be distributed to eligible Participants at any time or based on any criteria, as set by Lombard in its sole discretion (“_**Airdrop Criteria**_”). Different Participants may receive different amounts of Tokens in any particular Airdrop, depending on the Airdrop Criteria set forth by Lombard for such Airdrop. Lombard shall have no obligation to notify actual or potential Participants of the Airdrop Criteria for any Airdrop.
    
*   Lombard reserves the sole and absolute right to disqualify any Participant or potential Participant it deems ineligible (in its sole discretion) to participate in any Airdrop.
    
*   Lombard reserves the right to screen Participants, including through the use of third-party analytics tools, and to take any additional steps as it deems necessary or appropriate, in its sole discretion, to verify the identity and eligibility of any Participant.
    
*   Lombard reserves the right, in its sole discretion, to deny any person, internet-protocol address (“_**IP Address**_”), and/or digital-asset, smart-contract, or other blockchain-based protocol address (each, an “_**Airdrop Address**_”) access to the Airdrop (or otherwise exclude such person, IP Address, or Airdrop Address from the Airdrop).
    
*   Your IP Address will be screened and excluded from any Airdrop if our geo-location controls detect that you may be located in a jurisdiction not permitted to participate in the Airdrop or otherwise considered high risk, with respect to the Airdrop or otherwise (collectively, “_**Prohibited Jurisdictions**_”). You agree and understand that the Prohibited Jurisdictions are subject to change at our sole discretion without notice. You agree that it is a breach of this Agreement to circumvent or attempt to circumvent any screening tools used by Lombard, including without limitation by use of proxy or VPNs disguised to mask your presence in a Prohibited Jurisdiction.
    
*   By participating in the Airdrop, you represent that you have sufficient knowledge and experience in business and financial matters, including a sufficient understanding of blockchain technologies, cryptocurrencies and other digital assets, storage mechanisms (such as Wallets), and blockchain-based software systems to be able to assess and evaluate the risks and benefits of participating in the Airdrop. You acknowledge and agree that there are risks associated with purchasing and holding cryptocurrency and using blockchain technology. These include, but are not limited to, risk of losing access to cryptocurrency due to slashing, loss of private key(s), custodial error or purchaser error, risk of mining or blockchain attacks, risk of hacking and security weaknesses, risk of unfavorable regulatory intervention in one or more jurisdictions, risk related to token taxation, risk of personal information disclosure, risk of uninsured losses, volatility risks, and unanticipated risks.
    

**4\. Participant Representations and Warranties; Disclaimers**

*   By participating in any Airdrop, you represent and warrant that you have full legal capacity and authority to bind yourself and agree to the Airdrop Terms. If you are acting as an employee or agent of a legal entity, and enter into the Airdrop Terms on behalf of that entity, you represent and warrant that you have all necessary rights and authorizations to do so on behalf of such entity and to bind such entity to this Agreement.
    
*   You represent and warrant that all information provided during the Airdrop process is true, accurate, and complete.
    
*   You represent and warrant that your participation in the Airdrop does not violate any applicable laws, including without limitation applicable economic and trade sanctions and export control laws and regulations, such as those administered and enforced by the EU, OFSI, OFAC, the U.S. Department of State, the U.S. Department of Commerce, the UN Security Council, and other relevant authorities.
    
*   You represent and warrant now and at the time of receipt of any Token that you (a) lawfully may receive Tokens for free via the Airdrop (other than gas fees or applicable taxes, if any, that may be due to third parties), (b) were not promised the Tokens or any other tokens (whether via the Airdrop or otherwise); and (c) took no action in anticipation of, or in reliance on, receiving the Tokens or any tokens, the occurrence of an Airdrop, or potential participation in any Airdrop.
    
*   You acknowledge and agree that you are solely responsible for all taxes that may be due in connection with your participation in the Airdrop, and Lombard has no liability in connection with the same. Tax treatment of Tokens received via Airdrop may vary in your jurisdiction. You should consult with a tax advisor with respect to the Tokens.
    
*   You acknowledge and agree that you are solely responsible for complying with all applicable laws of the jurisdiction in which you reside and the jurisdiction in which you are participating in the Airdrop and/or claiming Tokens.
    
*   You acknowledge and agree that Lombard reserves the right to require additional information from you and to enter, use, or share such information into or with third parties, and its systems, tools, or functionalities, as Lombard deems appropriate in its sole discretion, including to reduce the risks of money laundering, terrorist financing, sanctions violations, or other potentially illicit activity, and you agree to provide complete and accurate information in response to any such requests.
    
*   You acknowledge and agree that your participation in the Airdrop and claim of Tokens does not require or involve any form of purchase, payment, or tangible consideration from or to us, nor otherwise require or involve any acceptance of value by us from you.
    
*   You acknowledge and agree that Lombard, in our sole discretion, shall determine your eligibility to receive Tokens or participate in the Airdrop.
    
*   You acknowledge and agree that, notwithstanding any documentation, commentary, calculators, metrics, and/or points systems published or otherwise made available by any third party (“_**Third-Party Publications**_”), you are not entitled to receive any Tokens and/or to participate in the Airdrop. Lombard does not review, control, monitor, or confirm the accuracy of information that may be provided through Third-Party Publications. You acknowledge and agree that you have not engaged, and will not engage, in any activities designed to obtain Tokens, including on the basis of, or in reliance on, Third-Party Publications.
    
*   You represent and warrant that you are the legal owner of the wallet that you use to access or participate in the Airdrop and the Services and will not sell, assign, or transfer control of such address or the Tokens to third parties to circumvent any restrictions on the Tokens or to knowingly redistribute Tokens to a person, IP Address, or wallet that would violate these Airdrop Terms if claimed directly by such person, IP Address, or wallet.
    
*   You acknowledge and agree that if you are unable to claim the Airdrop due to technical bugs, smart contract issues, gas fees, wallet incompatibilities, loss of access to a wallet or the key thereto, or for any other reason, you will have no recourse or claim against Lombard or any Lombard Party. In any such cases, neither Lombard nor any Lombard Party will bear any liability.
    
*   You acknowledge and agree that claiming the Airdrop may require interaction with, reliance on, or an integration with third-party products or services (e.g., a wallet or a network or blockchain) that we do not control. In the event that you are unable to access such products, services, or integrations, or if they fail for any reason, and you are unable to participate in the Airdrop or claim Tokens as a result, neither we nor any Lombard Party bear(s) any responsibility or liability to you.
    
*   You agree and acknowledge that the regulatory regime governing blockchain technologies, cryptocurrencies and other digital assets is uncertain, that new regulations or policies may materially adversely affect the potential utility or value of such cryptocurrencies and digital assets, and that there are risks of new taxation related to the purchase or sale of cryptocurrencies and other digital assets.
    
*   LOMBARD MAKES NO CLAIMS ABOUT THE IDENTITY, LEGITIMACY, OR AUTHENTICITY OF TOKENS ON ANY THIRD-PARTY MARKETPLACE OR ANY PURPORTED SUBSEQUENT TRANSACTIONS.
    

**5\. Risk**

You acknowledge and agree that your participation in the Airdrop is at your own risk. You acknowledge and agree that you have carefully reviewed, read, and understood the terms set forth in this Agreement, as well as the Terms.

WITHOUT LIMITING THE FOREGOING, TO THE MAXIMUM EXTENT PERMITTED UNDER APPLICABLE LAW, EACH LOMBARD PARTY DISCLAIM ALL WARRANTIES AND CONDITIONS, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING WITHOUT LIMITATION ANY WARRANTIES RELATING TO TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, USAGE, QUALITY, PERFORMANCE, SUITABILITY OR FITNESS OF THE AIRDROP FOR ANY PARTICULAR PURPOSE, OR AS TO THE ACCURACY, QUALITY, SEQUENCE, RELIABILITY, WORKMANSHIP OR TECHNICAL CODING THEREOF, OR THE ABSENCE OF ANY DEFECTS THEREIN, WHETHER LATENT OR PATENT.

The Lombard Parties make no warranty or representation and disclaim all responsibility and liability for: (a) the completeness, accuracy, availability, timeliness, security or reliability of the Airdrop; (b) any harm to your computer system, loss of data, or other harm that results from your participation in the Airdrop; (c) the operation or compatibility with any other application or any particular system or device, including any Wallets; and (d) whether the Airdrop will be available on an uninterrupted, secure or error-free basis. Nothing contained in these Terms constitutes, or is meant to constitute, financial, legal or other professional advice.

**6\. Indemnification and release**

Without limiting any terms in the Terms, you agree that you shall defend, indemnify, and hold Lombard and the Lombard Parties harmless from and against any and all claims, actions, proceedings, investigations, demands, suits, costs, damages, losses, liabilities and expenses (including attorneys’ fees and costs, and fines or penalties imposed by any regulatory authority) incurred by Lombard Parties arising out of or in connection with: (a) your use of, or conduct in connection with, the Airdrop; (b) the Tokens; (c) your breach or our enforcement of these Airdrop Terms; or (d) your violation of any applicable law, regulation, or rights of any third party. Your obligations under this indemnification provision will continue even after the expiration or earlier termination of this Agreement.

TO THE EXTENT NOT PROHIBITED BY LAW, YOU AGREE THAT IN NO EVENT WILL ANY LOMBARD PARTY BE LIABLE (A) FOR DAMAGES OF ANY KIND, INCLUDING INDIRECT SPECIAL, EXEMPLARY, INCIDENTAL, CONSEQUENTIAL OR PUNITIVE DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS, BUSINESS INTERRUPTION OR ANY OTHER DAMAGES OR LOSSES, ARISING OUT OF OR RELATED TO YOUR PARTICIPATION IN THE AIRDROP), HOWEVER CAUSED AND UNDER ANY THEORY OF LIABILITY, WHETHER UNDER THESE AIRDROP TERMS OR OTHERWISE ARISING IN ANY WAY IN CONNECTION WITH THE AIRDROP OR THESE TERMS AND WHETHER IN CONTRACT, STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) EVEN IF ANY OF THE LOMBARD PARTIES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE, OR (B) FOR ANY OTHER CLAIM, DEMAND OR DAMAGES WHATSOEVER RESULTING FROM OR ARISING OUT OF OR IN CONNECTION WITH THESE TERMS OR THE AIRDROP. THE LOMBARD PARTIES’ TOTAL LIABILITY TO YOU FOR ANY DAMAGES FINALLY AWARDED SHALL NOT EXCEED ONE HUNDRED DOLLARS ($100.00). THE FOREGOING LIMITATIONS WILL APPLY EVEN IF THE ABOVE STATED REMEDY FAILS OF ITS ESSENTIAL PURPOSE.

**7\. No professional advice and no fiduciary duties**

All information provided through the Airdrop site, or otherwise provided by Lombard, is for informational purposes only and should not be construed as professional advice. You should not take, or refrain from taking, any action based on any information contained on the website or obtained in connection with the Airdrop. Before you make any financial, legal, tax or other decisions involving the Airdrop, you should seek independent professional advice from an individual who is licensed and qualified in the area for which such advice would be appropriate.

These Terms are not intended to, and do not, create or impose any fiduciary duties on us. To the fullest extent permitted by law, you acknowledge and agree that we owe no fiduciary duties or liabilities to you or any other party, and that to the extent any such duties or liabilities may exist at law or in equity, those duties and liabilities are hereby irrevocably disclaimed, waived, and eliminated. You further agree that the only duties and obligations that we owe you are those set out expressly in these Terms.

**8\. Governing law**

These Airdrop Terms shall be construed in accordance with the laws of Panama, without reference to its conflict of law provisions, and the obligations, rights and remedies of the parties hereunder shall be determined in accordance with such laws.

**9\. Severability**

If any term, clause, or provision of the Airdrop Terms is held to be illegal, invalid, void, or unenforceable (in whole or in part), then such term, clause, or provision shall be severable from the Terms without affecting the validity or enforceability of any remaining part of that term, clause, or provision, or any other term, clause, or provision in the Terms, which will otherwise remain in full force and effect. Any invalid or unenforceable provisions will be interpreted to affect the intent of the original provisions. If such construction is not possible, the invalid or unenforceable provision will be severed from the Airdrop Terms, but the rest of the Terms will remain in full force and effect.

**10\. Update to the Terms**

We may modify these Terms from time to time in which case we will update the “Last Revised” date at the top of these Terms. The updated Terms will be effective as of the time of posting, or such later date as may be specified in the updated Terms. Your continued access or participation in the Airdrop after the modifications have become effective will be deemed your acceptance of the modified Terms.

**11\. Contact**

You may contact us regarding these Terms by email at [\[email protected\]envelope](https://docs.lombard.finance/cdn-cgi/l/email-protection#eb849b8e998a9f82848598ab87829a9e828f89829f88848285c58d849e858f8a9f828485)
.

[PreviousBrand Assetschevron-left](https://docs.lombard.finance/resources/brand-assets)
[NextUK Residentschevron-right](https://docs.lombard.finance/resources/uk-residents)

Last updated 2 months ago

---