# Lombard Docs > Lombard makes bitcoin productive. This file follows the llms.txt convention (https://llmstxt.org) and gives AI agents a curated map of the Lombard documentation. The site is built with Nextra on Next.js (server-rendered), so every linked page is fully crawlable as rendered HTML. ## Overview - [Overview](https://docs.lombard.finance/): Top-level entry point to the Lombard documentation. ## Learn - [How Lombard Works, Onchain Bitcoin Infrastructure Explained](https://docs.lombard.finance/learn): Learn how Lombard's protocol works, from minting LBTC and earning yield through Babylon to cross-chain deployment, security, and tokenomics. - [Lombard Products, LBTC, BTC.b, Smart Accounts & Earn](https://docs.lombard.finance/learn/products): Lombard's products make bitcoin productive, LBTC for yield, BTC.b for bridged BTC, Bitcoin Smart Accounts for custody, and Bitcoin Earn for managed yield. - [Assets](https://docs.lombard.finance/learn/products/assets): Lombard issues two Bitcoin-backed tokens that serve different purposes within the Bitcoin Capital Markets ecosystem. - [Infrastructure](https://docs.lombard.finance/learn/products/infrastructure): Lombard's infrastructure layer provides the security, bridging, oracle, and developer tools that power the protocol. - [Yield](https://docs.lombard.finance/learn/products/yield): Lombard transforms idle Bitcoin into productive capital by layering multiple yield sources. - [Lombard Protocol Architecture, The Lombard Ledger](https://docs.lombard.finance/learn/architecture): How the Lombard Ledger, 14-member Security Consortium, and CubeSigner work together to secure and move bitcoin across 10+ blockchains. - [Strategies: Overview](https://docs.lombard.finance/learn/architecture/strategies): Lombard Strategies are on-chain ERC-20 tokens that represent proportional ownership in a managed portfolio. - [Strategy: Deposits and Redemptions](https://docs.lombard.finance/learn/architecture/strategies/deposits-and-redemptions): The strategy accepts multiple ERC-20 tokens for deposits. - [Strategy: Accounting](https://docs.lombard.finance/learn/architecture/strategies/accounting): Strategy accounting is based on externally posted Net Asset Value (NAV), represented by pricePerShare. - [Strategy: Fee System](https://docs.lombard.finance/learn/architecture/strategies/fees): The strategy has four distinct fee surfaces: two flow fees that divert tokens or shares at transaction time, and two dilution fees that mint new shares to a treasury over time. - [Strategy: Shards](https://docs.lombard.finance/learn/architecture/strategies/shards): Shards are separate upgradeable contracts that act as custody and execution endpoints for portfolio capital. - [Shard Validators](https://docs.lombard.finance/learn/architecture/strategies/shard-validators): Every Shard and RemoteShard instance holds a reference to exactly one IShardExecValidator contract. - [Strategy: Roles and Security](https://docs.lombard.finance/learn/architecture/strategies/roles-and-security): Strategy contracts use OpenZeppelin AccessControlDefaultAdminRulesUpgradeable, which adds a mandatory timelock on DEFAULTADMINROLE transfers. - [How Lombard Secures Bitcoin, 14 Institutions, 10 Audits](https://docs.lombard.finance/learn/security): Lombard protects every transaction via a 14-member Security Consortium, hardware-backed keys, and 10 independent audits. - [Consortium Members](https://docs.lombard.finance/learn/security/consortium-members): The Lombard Security Consortium consists of 14 independent institutional members that collectively govern all critical protocol operations. - [Audits](https://docs.lombard.finance/learn/security/audits): Lombard maintains a rigorous security audit program with multiple independent firms reviewing the protocol's smart contracts and infrastructure. - [Bug Bounty](https://docs.lombard.finance/learn/security/bug-bounty): Lombard operates a bug bounty program through Immunefi, the leading blockchain security platform. - [Lombard Transparency, Proof of Reserve & On-Chain Audits](https://docs.lombard.finance/learn/transparency): Every LBTC is backed 1:1 by native bitcoin. - [Oracles](https://docs.lombard.finance/learn/transparency/oracles): Lombard uses oracle infrastructure to provide transparent, independently verifiable data about protocol reserves and asset pricing. - [Smart Contracts](https://docs.lombard.finance/learn/transparency/smart-contracts): All Lombard smart contracts are publicly deployed and verified on their respective block explorers. - [Bridging Architecture](https://docs.lombard.finance/learn/transparency/bridging-architecture): Lombard enables LBTC and BTC.b to move across blockchains through a dual-verification bridging system. - [Risks](https://docs.lombard.finance/learn/transparency/risks): Lombard is committed to transparent risk disclosure. - [BARD Token, Fixed Supply, Governance & Staking](https://docs.lombard.finance/learn/tokenomics): BARD has a fixed supply of 1 billion tokens. - [Lombard Finance Foundation](https://docs.lombard.finance/learn/tokenomics/foundation): The Lombard Finance Foundation (formerly known as the Liquid Bitcoin Foundation) is an independent steward of the Lombard ecosystem, incorporated in the Cayman Islands. ## Use - [LBTC, The World's Leading Yield-Bearing Bitcoin](https://docs.lombard.finance/use/lbtc): LBTC is Lombard's yield-bearing bitcoin. - [Understanding Yield](https://docs.lombard.finance/use/lbtc/understanding-yield): Your LBTC earns Bitcoin yield automatically. - [Fees](https://docs.lombard.finance/use/lbtc/fees): All fees associated with staking, unstaking, and holding LBTC. - [BTC.b, 1:1 Bridged Bitcoin with 0% Minting Fee](https://docs.lombard.finance/use/btcb): BTC.b is a 1:1 bitcoin representation secured by Lombard's 14-member consortium, 0% minting fee, neutral by design, usable as BSA collateral. - [Bitcoin Smart Accounts, Borrow Against BTC Without Moving It](https://docs.lombard.finance/use/bsa): Lombard's institutional product. - [Bitcoin Earn, Managed Bitcoin Yield from One Deposit](https://docs.lombard.finance/use/bitcoin-earn): Deposit BTC and earn yield from professionally managed strategies spanning DeFi money markets and institutional onchain credit, continuously rebalanced by risk managers. - [Bitcoin Onchain Credit Strategy, Fixed Institutional Yield](https://docs.lombard.finance/use/bitcoin-earn/onchain-credit): Flow Traders pays a fixed premium to borrow stablecoins through Cap Protocol. - [BARD Token, Governance, Staking & Utility](https://docs.lombard.finance/use/bard): BARD is Lombard's governance and utility token with a fixed supply of 1 billion. - [Bridge LBTC and BTC.b Across Chains, Lombard](https://docs.lombard.finance/use/bridging): How to move LBTC and BTC.b between Ethereum, Solana, Avalanche, and 10+ other chains using Lombard's cross-chain infrastructure, powered by Chainlink CCIP. - [Deploy LBTC in DeFi, 70+ Protocols, Pools & Strategies](https://docs.lombard.finance/use/defi): A guide to using LBTC and BTC.b across DeFi, Aave, Morpho, Pendle, Uniswap, and 70+ integrations across 10+ chains. - [FAQ](https://docs.lombard.finance/use/faq): Find answers to the most common questions about Lombard, LBTC, BTC.b, and $BARD. - [Lombard FAQ, Onchain Bitcoin, Security & Protocol Questions](https://docs.lombard.finance/use/faq/general): Common questions about Lombard, how it works, how your BTC is protected by 14 institutions, what the risks are, and how to get started. - [LBTC FAQ, Yield, Unstaking & Deposit Questions Answered](https://docs.lombard.finance/use/faq/lbtc): How LBTC yield accrues through the exchange rate, how long unstaking takes (up to 10 days), how to verify your deposit address, and more. - [BTC.b FAQ, Bridging, Fees & Supported Chains](https://docs.lombard.finance/use/faq/btcb): Common questions about BTC.b, how it differs from LBTC, the 0% fee model, consortium security, and how to mint and redeem. - [BARD FAQ, Token, Claims & Governance Questions](https://docs.lombard.finance/use/faq/bard): Common questions about BARD, fixed 1B supply, how to claim, the $6.75M community sale, staking, and governance participation. - [Troubleshooting Lombard, Common Issues & How to Fix Them](https://docs.lombard.finance/use/troubleshooting): Solutions to common Lombard issues, deposit delays, wallet connection problems, minting errors, and unstaking questions. ## Build - [Build on Lombard, Bitcoin Connect Developer Platform](https://docs.lombard.finance/build): Integrate onchain bitcoin into any app, exchange, or wallet. - [Lombard SDK, Add Bitcoin Yield & Staking to Your App](https://docs.lombard.finance/build/sdk): A production-ready SDK for BTC staking, yield, and cross-chain DeFi. - [How Integration Works](https://docs.lombard.finance/build/sdk/how-integration-works): This section outlines the typical path teams follow when integrating the Lombard SDK, from initial alignment through production launch. - [The SDK Playground](https://docs.lombard.finance/build/sdk/playground): The Playground is a live environment for exploring and validating Bitcoin integrations before production. - [Start Here](https://docs.lombard.finance/build/sdk/start-here): Install the SDK, configure your environment, connect wallets, and make your first API calls. - [Configure PartnerID](https://docs.lombard.finance/build/sdk/start-here/configure-partnerid): This section is for teams looking to partner with Lombard and integrate the Lombard SDK. - [Connect Wallets](https://docs.lombard.finance/build/sdk/start-here/connect-wallets): The Lombard SDK supports multiple blockchain wallet types. - [Testing and Sandbox](https://docs.lombard.finance/build/sdk/start-here/testing-and-sandbox): This section explains how to configure and use the SDK's testnet environment, covering environment setup, testnet-specific parameters, and how to validate integrations before deploying to mainnet. - [Concepts](https://docs.lombard.finance/build/sdk/concepts): Before implementing SDK actions, it helps to understand the core patterns that govern how the SDK works. - [Action Lifecycle](https://docs.lombard.finance/build/sdk/concepts/action-lifecycle): Actions are the core building blocks of the SDK. - [Fee Authorization](https://docs.lombard.finance/build/sdk/concepts/fee-authorization): Fee authorization applies when staking BTC to Ethereum Mainnet or Sepolia. - [Event Handling](https://docs.lombard.finance/build/sdk/concepts/event-handling): Actions emit events throughout their lifecycle. - [Error Handling](https://docs.lombard.finance/build/sdk/concepts/error-handling): The SDK implements comprehensive error handling through the LombardError class. - [BTC Deposit Addresses](https://docs.lombard.finance/build/sdk/concepts/btc-deposit-addresses): Each combination of destination chain, recipient address, and Partner ID receives a unique Bitcoin deposit address. - [Referral System](https://docs.lombard.finance/build/sdk/concepts/referral-system): The Lombard SDK provides referral tracking for user acquisition and attribution. - [Data API](https://docs.lombard.finance/build/sdk/data-api): The Lombard SDK includes built-in data-fetching methods for querying backend services. - [API Methods](https://docs.lombard.finance/build/sdk/data-api/api-methods): Complete reference for all data-fetching methods available through sdk.api.. - [Capabilities](https://docs.lombard.finance/build/sdk/capabilities): The SDK organizes actions by blockchain environment. - [BTC Stake](https://docs.lombard.finance/build/sdk/capabilities/bitcoin/btc-stake): The BTC Stake action converts native Bitcoin into LBTC on an EVM chain. - [BTC Deposit](https://docs.lombard.finance/build/sdk/capabilities/bitcoin/btc-deposit): The BTC Deposit action converts native Bitcoin to BTC.b (wrapped Bitcoin) on EVM chains. - [BTC Stake and Deploy](https://docs.lombard.finance/build/sdk/capabilities/bitcoin/btc-stake-and-deploy): Stake BTC directly into a DeFi vault in a single operation. - [BTC Deposit and Deploy](https://docs.lombard.finance/build/sdk/capabilities/bitcoin/btc-deposit-and-deploy): The BTC Deposit and Deploy action combines depositing and vault deployment. - [EVM Unstake](https://docs.lombard.finance/build/sdk/capabilities/evm/evm-unstake): Burns LBTC on an EVM chain and releases native BTC to a Bitcoin address. - [EVM Deploy](https://docs.lombard.finance/build/sdk/capabilities/evm/evm-deploy): Deposits LBTC into a DeFi vault for yield generation. - [EVM Redeem](https://docs.lombard.finance/build/sdk/capabilities/evm/evm-redeem): Burns BTC.b on an EVM chain and releases native BTC to your Bitcoin wallet. - [EVM Withdraw](https://docs.lombard.finance/build/sdk/capabilities/evm/evm-withdraw): Queue a withdrawal of vault shares from DeFi protocols (currently Veda vaults). - [Solana Deposit](https://docs.lombard.finance/build/sdk/capabilities/non-evm/solana-deposit): The BTC Deposit action converts native Bitcoin to BTC.b (wrapped Bitcoin) on Solana. - [Solana Redeem](https://docs.lombard.finance/build/sdk/capabilities/non-evm/solana-redeem): Converts BTC.b tokens on Solana into native Bitcoin by burning the wrapped asset and dispatching a cross-chain message. - [Solana Unstake](https://docs.lombard.finance/build/sdk/capabilities/non-evm/solana-unstake): Burns LBTC on Solana and releases BTC to a Bitcoin address. - [Sui Unstake](https://docs.lombard.finance/build/sdk/capabilities/non-evm/sui-unstake): Burns LBTC on Sui and releases BTC to a Bitcoin address. - [Starknet Unstake](https://docs.lombard.finance/build/sdk/capabilities/non-evm/starknet-unstake): Burns LBTC on Starknet and releases BTC to a Bitcoin address. - [Reference](https://docs.lombard.finance/build/sdk/reference): Complete API reference for the Lombard SDK, including TypeScript types, events, and error codes. - [TypeScript Types](https://docs.lombard.finance/build/sdk/reference/typescript-types): Complete type definitions for SDK interfaces, parameters, and return values. - [Events Reference](https://docs.lombard.finance/build/sdk/reference/events-reference): All action types share identical event structures defined in packages/sdk/src/shared/events.ts. - [Error Codes](https://docs.lombard.finance/build/sdk/reference/error-codes): Comprehensive catalog of all SDK error codes with descriptions. - [SDK FAQ](https://docs.lombard.finance/build/sdk/faq): Quick answers to common integration questions. - [Builder Support](https://docs.lombard.finance/build/sdk/support): Contact the Lombard team to get started: - [Bitcoin for AI Agents, Lombard's Bitcoin Agent SDK](https://docs.lombard.finance/build/agents): The Bitcoin Agent SDK lets AI agents hold, stake, earn yield on, and borrow against Bitcoin autonomously, without touching user keys. - [Quickstart](https://docs.lombard.finance/build/agents/quickstart): This section covers what the SDK does, how to choose between the two packages, and how to install and run your first Bitcoin agent action. - [Configure Partner ID](https://docs.lombard.finance/build/agents/configure-partner-id): This section covers the environment variables required to attribute native BTC deposits to your integration and enable revenue sharing in production. - [Flow Coverage Matrix](https://docs.lombard.finance/build/agents/flow-coverage-matrix): This section covers which package supports which BTC, LBTC, and BTC.b flows, so you can confirm coverage before you build. - [Common Agent Flows](https://docs.lombard.finance/build/agents/common-flows): This section covers nine step-by-step walkthroughs for the most common agent tasks, from native BTC deposits to Morpho borrowing. - [Capabilities](https://docs.lombard.finance/build/agents/capabilities): This section covers the full tool and action reference for both packages, including the curated system prompt shipped with sdk-agent. - [Fee Authorization](https://docs.lombard.finance/build/agents/fee-authorization): This section covers how EIP-712 fee signing works in each package and when it is required before a transaction can be submitted. - [Action Lifecycle](https://docs.lombard.finance/build/agents/action-lifecycle): This section covers how prepared transactions flow from agent to chain in sdk-agent, and how sdk-agentkit handles execution automatically. - [README](https://docs.lombard.finance/build/agents/readme): This section covers links to the npm packages, GitHub repository, and builder support channels. - [Direct Integrations](https://docs.lombard.finance/build/direct-integrations): For advanced users and protocols that need to interact with Lombard's smart contracts without relying on the SDK or web app. - [BTC.b to LBTC and LBTC to BTC.b Swaps](https://docs.lombard.finance/build/direct-integrations/swaps): This guide explains converting between BTC.b and LBTC through smart contract interactions via block explorers. - [Oracle Integration](https://docs.lombard.finance/build/direct-integrations/oracle): This guide covers oracle integration for Lombard's Bitcoin-backed assets, including Proof of Reserve feeds for LBTC and BTC.b. - [GMP Redeem Tracing](https://docs.lombard.finance/build/direct-integrations/gmp-redeem-tracing): Step-by-step guide for tracing GMP (Generic Message Passing) redemption transactions on the Ethereum blockchain. - [LBTC GMP Mint Tracing](https://docs.lombard.finance/build/direct-integrations/lbtc-gmp-mint-tracing): Step-by-step guide for tracing LBTC minting transactions through multiple blockchain systems. - [How to Find Out Unstake Fee](https://docs.lombard.finance/build/direct-integrations/unstake-fee): Query unstake fee information directly from Lombard's smart contracts. ## Bsa Partner Integration - [BSA Integration Overview](https://docs.lombard.finance/bsa-partner-integration): Private integration reference for BSA partners. - [BSA Integration Guide](https://docs.lombard.finance/bsa-partner-integration/bsa-integration-guide): Guide to the core repos and protocol flows needed to deploy an instance of the BSA protocol. - [API States](https://docs.lombard.finance/bsa-partner-integration/api-states): Response payload and tranche lifecycle states for the BSA API. - [BSA Arbitration Oracle Handbook](https://docs.lombard.finance/bsa-partner-integration/bsa-arbitration-oracle-handbook): Operations to deploy, initialize, recover, and upgrade a BSA Arbitration Oracle (AO). ## Optional - [Glossary, Key Terms Explained | Lombard](https://docs.lombard.finance/resources/glossary): Definitions of every key term in the Lombard ecosystem, LBTC, BTC.b, Bitcoin Smart Accounts, Bitcoin Connect, the Security Consortium, and more. - [Brand Assets](https://docs.lombard.finance/resources/brand): Official branding materials for Lombard. - [BARD Airdrop Terms](https://docs.lombard.finance/resources/airdrop-terms): Terms and conditions governing the distribution of $BARD tokens through Lombard's airdrop program. - [Global Terms of Service](https://docs.lombard.finance/resources/terms): Updated and effective: 25 June 2026 - [Global Risk Disclosures](https://docs.lombard.finance/resources/risk-disclosures): Updated and effective: 25 June 2026 - [Privacy Policy](https://docs.lombard.finance/resources/privacy): Updated and effective: 25 June 2026 - [MiCA Whitepaper](https://docs.lombard.finance/resources/mica-whitepaper): Crypto-asset white paper for the BARD token, prepared in accordance with Regulation (EU) 2023/1114 (MiCA). - [Lombard Community, Lux Rewards, Referrals & Governance](https://docs.lombard.finance/learn/community): Earn Lux by actively deploying LBTC and BTC.b across DeFi. - [Lux Rewards](https://docs.lombard.finance/learn/community/lux-rewards): Lux is the reward unit of the Lombard ecosystem. - [Referral Program](https://docs.lombard.finance/learn/community/referral-program): The Lombard referral program rewards you for growing the ecosystem. - [Kaito Yappers](https://docs.lombard.finance/learn/community/kaito-yappers): The Kaito Yappers program rewarded community content creators on X (formerly Twitter) who drove genuine discussion and awareness about Lombard.