Connect wallets

This section outlines the supported wallet providers and the steps required to connect Bitcoin, EVM, and non-EVM wallets to the Lombard SDK.

---

EVM Provider

The EVM provider must implement the EIP-1193 interface.

import { createConfig, Env } from '@lombard.finance/sdk';

const config = createConfig({
  env: Env.testnet,
  providers: {
    evm: () => window.ethereum,
  },
});

With wagmi

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;
    },
  },
});

---

Bitcoin Provider

Use OKX Wallet for Bitcoin operations.

import { createConfig, Env } from '@lombard.finance/sdk';

const config = createConfig({
  env: Env.testnet,
  providers: {
    bitcoin: () => window.okxwallet?.bitcoin,
  },
});

Bitcoin Provider Interface

interface BtcProvider {
  getAccounts(): Promise<string[]>;
  signMessage(message: string, type?: 'ecdsa' | 'bip322-simple'): Promise<string>;
  signPsbt(psbtHex: string, options?: object): Promise<string>;
}

---

Solana Provider

import { createConfig, Env } from '@lombard.finance/sdk';

const config = createConfig({
  env: Env.testnet,
  providers: {
    solana: () => window.solana,
  },
});

Solana Provider Interface

interface SolanaProvider {
  publicKey: { toString(): string };
  signMessage(message: Uint8Array): Promise<{ signature: Uint8Array }>;
  signTransaction(tx: Transaction): Promise<Transaction>;
}

---

Sui Provider

import { createConfig, Env } from '@lombard.finance/sdk';

const config = createConfig({
  env: Env.testnet,
  providers: {
    sui: () => window.suiWallet,
  },
});

---

Starknet Provider

import { createConfig, Env } from '@lombard.finance/sdk';

const config = createConfig({
  env: Env.testnet,
  providers: {
    starknet: () => window.starknet,
  },
});

---

Async Providers

Providers can return promises for async wallet initialization.

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;
    },
  },
});

---

Multiple Providers

Configure all providers your application needs.Configure all required providers for the application.

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,
  },
});

---