BTC Deposit

Deposit BTC to receive BTC.b on an EVM chain.

---

Overview

The BTC Deposit action converts native Bitcoin to BTC.b (wrapped Bitcoin). The flow is similar to BTC Stake but produces BTC.b instead of LBTC.

---

Basic Usage

import { createLombardSDK, Chain, AssetId } from '@lombard.finance/sdk';
import { config } from './lib/lombard';

const sdk = createLombardSDK(config);

const deposit = sdk.chain.btc.deposit({
  destChain: Chain.KATANA,
  assetOut: AssetId.BTCb,
});

await deposit.prepare({
  amount: '0.1',
  recipient: '0x1234567890abcdef1234567890abcdef12345678',
});

await deposit.authorize();

const depositAddress = await deposit.generateDepositAddress();
// depositAddress: 'bc1q...'

---

Parameters

Deposit Options

Parameter	Type	Required	Description
destChain	Chain	Yes	Destination chain for BTC.b
assetOut	AssetId	Yes	Output asset (AssetId.BTCb)
sourceChain	Chain	No	Bitcoin network

Prepare Parameters

Parameter	Type	Required	Description
amount	string	Yes	Amount in BTC
recipient	string	Yes	Destination address for BTC.b
referralCode	string	No	Referral code for attribution

---

With Referral Code

await deposit.prepare({
  amount: '0.1',
  recipient: '0x1234567890abcdef1234567890abcdef12345678',
  referralCode: 'PARTNER123',
});

---

Status Flow

IDLE → NEEDS_FEE_AUTHORIZATION → READY → ADDRESS_READY