# @lombard.finance/sdk-solana

The Lombard's Solana SDK package provides a set of function that allow interacting with the Lombard protocol and its features for Solana users.

## Installation

```bash
npm install @lombard.finance/sdk @lombard.finance/sdk-solana
```

## Usage

### Connecting to a Wallet

```typescript
import { connectWallet, WalletType } from '@lombard.finance/sdk-solana';

// Connect to Phantom wallet
const { publicKey, walletProvider } = await connectWallet({
  walletType: 'phantom',
  network: 'mainnet',
});

console.log('Connected wallet address:', publicKey);
```

### Checking Balances

```typescript
import { getBalance } from '@lombard.finance/sdk-solana';

// Get SOL balance
const { total, decimals } = await getBalance({
  publicKey: '5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CYxjdePDovp',
});

console.log('SOL Balance:', total.toString());

// Get SPL token balance
const tokenBalance = await getBalance({
  publicKey: '5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CYxjdePDovp',
  tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC token address
});

console.log('Token Balance:', tokenBalance.total.toString());
```

### Sending Transactions

```typescript
import { sendTransaction } from '@lombard.finance/sdk-solana';

// Send SOL
const result = await sendTransaction({
  from: walletProvider,
  to: 'ReceipientSolanaAddress',
  amount: '0.1',
});

console.log('Transaction signature:', result.signature);

// Send SPL token
const tokenResult = await sendTransaction({
  from: walletProvider,
  to: 'ReceipientSolanaAddress',
  amount: '10',
  tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC token address
  decimals: 6,
});

console.log('Token transaction signature:', tokenResult.signature);
```

### Signing Messages

```typescript
import { signMessage } from '@lombard.finance/sdk-solana';

const { signature, publicKey } = await signMessage({
  message: 'Hello, Solana!',
  publicKey: walletProvider.publicKey.toString(),
});

console.log('Signature:', signature);
```

### Generating BTC deposit address

Similar to the EVM SDK (`@lombard.finance/sdk`) the generation of the deposit address requires a signature.
To successfully generate a deposit address run `signLbtcDestinationAddrSolana` and then use the generated signature as a parameter of the EVM SDK's `generateDepositBtcAddress`.

```javascript

const { signature } = await signLbtcDestinationAddrSolana({
  // The connected wallet provider:
  provider: walletProvider,
  // The chosen Solana chain (network):
  network: 'mainnet-beta'
});

const depositAddress = await generateDepositBtcAddress({
  // The connected address
  address,
  // The chosen Solana chain (network) - prefixed with `solana:`
  chainId: 'solana:mainnet-beta',
  // The generated signature:
  signature,
  // Optional env
  env: Env.prod,
  // Optional partnerId
  partnerId,
}),

```

### Claiming tokens (Asset Router)

Mints BTC.b or LBTC on Solana from a notarized deposit payload using the
Asset Router program. Replaces the previous `claimLBTC` helper.

```typescript
import { claimToken } from '@lombard.finance/sdk-solana';

const txHash = await claimToken(provider, {
  recipientAddress: address,
  tokenMint: getConfig(Env.prod).btcbTokenMint, // or lbtcTokenMint
  network: 'mainnet-beta',
  // Obtained from `getDepositsByAddress`
  proofSignature: selectedOutput.proof,
  rawPayload: selectedOutput.raw_payload,
});
```

### Redeeming tokens for BTC (Asset Router)

Burns BTC.b or LBTC on Solana and sends a GMP message through the Mailbox to
trigger a BTC payout to the specified Bitcoin address.

```typescript
import { redeemForBtc } from '@lombard.finance/sdk-solana';

// BTC.b → BTC (default)
const { signature } = await redeemForBtc(provider, {
  amount: '2000',
  btcAddress: 'bc1q...',
  network: 'devnet',
  env: 'stage',
});

// LBTC → BTC (pass LBTC mint)
const { signature } = await redeemForBtc(provider, {
  amount: '2000',
  btcAddress: 'bc1q...',
  tokenMint: 'LBTCojyVJ63rsEED2DLEGWMzSxWJyQynXE91LMLgV1J',
  network: 'devnet',
  env: 'stage',
});
```

### Redeeming LBTC for BTC.b (Asset Router)

Burns LBTC and sends a GMP message to route BTC.b to the recipient on Solana.

```typescript
import { redeem } from '@lombard.finance/sdk-solana';

const txHash = await redeem(provider, {
  amount: '2000',
  recipient: '8yarEiDaJVik7n6wX8JCbubTbtZD3WZ67Q1ytMDA2BKA',
  network: 'devnet',
  env: 'dev',
});
```

Optional overrides: `tokenMint` (source token), `toTokenAddress` (destination
token), `toLchainId` (destination chain). All default to LBTC → BTC.b on Solana.