Common Agent Flows

User sends native BTC and wants yield-bearing LBTC on an EVM chain.

A deposit becomes notarized when Lombard’s validators have signed an attestation that the on-chain Bitcoin deposit confirmed; only at that point can it be claimed to mint LBTC.

sdk-agent: check_fee_authorization → prepare_btc_to_lbtc_deposit → user sends BTC → get_deposit_status → prepare_claim_lbtc_deposit

sdk-agentkit: external deposit flow + claim_lbtc_deposit once notarized

User sends native BTC and wants BTC.b (cross-chain wrapped Bitcoin, not yield-bearing) on an EVM chain. Use the dedicated BTC.b deposit tool; prepare_btc_to_lbtc_deposit mints LBTC instead.

sdk-agent: check_fee_authorization → prepare_btc_to_btcb_deposit → user sends BTC → get_deposit_status tracks confirmations until BTC.b lands on the destination chain

sdk-agentkit: not exposed as a single AgentKit action; use the underlying SDK or sdk-agent

User already holds BTC.b on Ethereum or Base and wants yield-bearing LBTC.

sdk-agent: get_btcb_balance → get_exchange_rate → prepare_btcb_to_lbtc_stake → wallet signs

sdk-agentkit: stake_btcb_to_lbtc (approval + fee authorization handled automatically)

User wants to move out of LBTC into cross-chain BTC.b without leaving the EVM.

sdk-agent: prepare_lbtc_to_btcb (amount + chainId, no Bitcoin recipient needed)

sdk-agentkit: redeem_lbtc_to_btcb

User wants to redeem LBTC back to native Bitcoin.

sdk-agent: prepare_lbtc_to_btc with amount and a Bitcoin recipient → get_redemption_status polls progress

sdk-agentkit: unstake_lbtc_to_btc with a Bitcoin recipient → get_redemption_status

Reverse the bridge: burn BTC.b and receive native BTC. Use the dedicated BTC.b tool; prepare_lbtc_to_btc is for LBTC only.

sdk-agent: prepare_redeem_btcb with amount and a Bitcoin recipient returns a prepared evm.btcbToBtc tx; after execution the app can surface the resulting tx hash and link it to a block explorer

sdk-agentkit: not exposed as a single AgentKit action; use the underlying SDK or sdk-agent

Earn additional yield by deploying LBTC into a vault, then withdraw or cancel as needed.

sdk-agent: get_earn_strategies / get_lbtc_defi_opportunities → prepare_earn_deposit → get_earn_positions → prepare_earn_withdrawal (or prepare_cancel_earn_withdrawal to abort an active one)

sdk-agentkit: deploy_to_earn

Use LBTC as collateral to borrow other assets, then repay.

get_morpho_lbtc_markets → prepare_morpho_supply_collateral → prepare_morpho_borrow → get_morpho_position → prepare_morpho_repay

User mentions a ticker the agent doesn’t recognise (BTCe, LBTCv, an arbitrary 0x… address).

sdk-agent: get_token_info resolves it to a canonical Lombard asset (or reports it as unknown with suggestions) before the model commits to an answer