otx-btc-wallet-connectors 0.1.0

package/dist/ledger/index.d.mts

@@ -0,0 +1,290 @@
+import { BitcoinNetwork, WalletAccount, SignPsbtOptions } from 'otx-btc-wallet-core';
+import { B as BaseConnector } from '../base-IAFq7sd8.mjs';
+
+/**
+ * Ledger address type configuration
+ */
+type LedgerAddressType = 'legacy' | 'nested-segwit' | 'segwit' | 'taproot';
+/**
+ * Ledger connector options
+ */
+interface LedgerConnectorOptions {
+    /** Address type for derivation (default: 'segwit') */
+    addressType?: LedgerAddressType;
+    /** Account index (default: 0) */
+    accountIndex?: number;
+    /** Address index (default: 0) */
+    addressIndex?: number;
+}
+interface LedgerBtcApp {
+    getWalletPublicKey(path: string, opts?: {
+        verify?: boolean;
+        format?: 'legacy' | 'p2sh' | 'bech32' | 'bech32m';
+    }): Promise<{
+        publicKey: string;
+        bitcoinAddress: string;
+        chainCode: string;
+    }>;
+    getWalletXpub(arg: {
+        path: string;
+        xpubVersion: number;
+    }): Promise<string>;
+    signMessage(path: string, messageHex: string): Promise<{
+        v: number;
+        r: string;
+        s: string;
+    }>;
+    splitTransaction(transactionHex: string, isSegwitSupported?: boolean | null, hasExtraData?: boolean, additionals?: string[]): LedgerTransaction;
+    createPaymentTransaction(arg: {
+        inputs: Array<[LedgerTransaction, number, string | null | undefined, number?]>;
+        associatedKeysets: string[];
+        changePath?: string;
+        outputScriptHex: string;
+        lockTime?: number;
+        sigHashType?: number;
+        segwit?: boolean;
+        additionals?: string[];
+        expiryHeight?: Buffer;
+        useTrustedInputForSegwit?: boolean;
+    }): Promise<string>;
+    serializeTransactionOutputs(tx: LedgerTransaction): Buffer;
+}
+/**
+ * Ledger Transaction type (returned by splitTransaction)
+ */
+interface LedgerTransaction {
+    version: Buffer;
+    inputs: Array<{
+        prevout: Buffer;
+        script: Buffer;
+        sequence: Buffer;
+    }>;
+    outputs?: Array<{
+        amount: Buffer;
+        script: Buffer;
+    }>;
+    locktime?: Buffer;
+    witness?: Buffer;
+}
+/**
+ * UTXO input for createPaymentTransaction
+ */
+interface LedgerUtxoInput {
+    /** Raw transaction hex that created this UTXO */
+    txHex: string;
+    /** Output index in the transaction */
+    outputIndex: number;
+    /** BIP32 derivation path for signing (e.g., "84'/0'/0'/0/0") */
+    derivationPath: string;
+    /** Optional redeem script for P2SH inputs */
+    redeemScript?: string;
+    /** Optional sequence number (default: 0xffffffff) */
+    sequence?: number;
+}
+/**
+ * Output for createPaymentTransaction
+ */
+interface LedgerTxOutput {
+    /** Recipient address */
+    address: string;
+    /** Amount in satoshis */
+    satoshis: number;
+}
+/**
+ * Options for sendBitcoin method
+ */
+interface SendBitcoinOptions {
+    /** Fee rate in sat/vB (optional, defaults to "hour" priority) */
+    feeRate?: number;
+}
+/**
+ * Ledger Hardware Wallet Connector
+ *
+ * @see https://developers.ledger.com/docs/transport/overview
+ * @see https://github.com/LedgerHQ/ledger-live/tree/develop/libs/ledgerjs/packages/hw-app-btc
+ */
+declare class LedgerConnector extends BaseConnector {
+    readonly id = "ledger";
+    readonly name = "Ledger";
+    readonly icon = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAwIiBoZWlnaHQ9IjIwMCIgdmlld0JveD0iMCAwIDIwMCAyMDAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMF83MDM1XzUxMTApIj4KPHJlY3Qgd2lkdGg9IjIwMCIgaGVpZ2h0PSIyMDAiIHJ4PSIzMiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTE0Mi4yMzkgMzcuNUg4NS4wOTY0VjExNC41ODJIMTYyLjIzOVY1Ny40MzkzQzE2Mi4yMzggNTQuODE2IDE2MS43MiA1Mi4yMTg2IDE2MC43MTQgNDkuNzk1OUMxNTkuNzA4IDQ3LjM3MzIgMTU4LjIzMyA0NS4xNzI4IDE1Ni4zNzYgNDMuMzIwN0MxNTQuNTE4IDQxLjQ2ODUgMTUyLjMxMyA0MC4wMDExIDE0OS44ODcgMzkuMDAyM0MxNDcuNDYyIDM4LjAwMzUgMTQ0Ljg2MyAzNy40OTMgMTQyLjIzOSAzNy41WiIgZmlsbD0iYmxhY2siLz4KPHBhdGggZD0iTTY3LjI5MjkgMzcuNUg1Ny40NDY0QzUyLjE1NjMgMzcuNSA0Ny4wODI5IDM5LjYwMTUgNDMuMzQyMiA0My4zNDIyQzM5LjYwMTUgNDcuMDgyOSAzNy41IDUyLjE1NjMgMzcuNSA1Ny40NDY0TDM3LjUgNjcuMjkyOUg2Ny4yOTI5VjM3LjVaIiBmaWxsPSJibGFjayIvPgo8cGF0aCBkPSJNMzcuNSA4NS4xMDM2SDY3LjI5MjlWMTE0Ljg5NkgzNy41Vjg1LjEwMzZaIiBmaWxsPSJibGFjayIvPgo8cGF0aCBkPSJNMTMyLjcwNyAxNjIuMjQ2SDE0Mi41NTNDMTQ1LjE3NyAxNjIuMjQ2IDE0Ny43NzYgMTYxLjcyOSAxNTAuMTk5IDE2MC43MjNDMTUyLjYyMyAxNTkuNzE3IDE1NC44MjQgMTU4LjI0MyAxNTYuNjc3IDE1Ni4zODVDMTU4LjUzIDE1NC41MjcgMTU5Ljk5OCAxNTIuMzIyIDE2MC45OTcgMTQ5Ljg5NkMxNjEuOTk2IDE0Ny40NyAxNjIuNTA3IDE0NC44NyAxNjIuNSAxNDIuMjQ2VjEzMi43MDdIMTMyLjcwN1YxNjIuMjQ2WiIgZmlsbD0iYmxhY2siLz4KPHBhdGggZD0iTTg1LjEwMzUgMTMyLjcwN0gxMTQuODk2VjE2Mi41SDg1LjEwMzVWMTMyLjcwN1oiIGZpbGw9ImJsYWNrIi8+CjxwYXRoIGQ9Ik0zNy41IDEzMi43MDdWMTQyLjU1NEMzNy41IDE0NS4xNzMgMzguMDE1OSAxNDcuNzY3IDM5LjAxODMgMTUwLjE4N0M0MC4wMjA3IDE1Mi42MDcgNDEuNDkgMTU0LjgwNiA0My4zNDIyIDE1Ni42NThDNDUuMTk0NCAxNTguNTEgNDcuMzkzMiAxNTkuOTc5IDQ5LjgxMzMgMTYwLjk4MkM1Mi4yMzMzIDE2MS45ODQgNTQuODI3IDE2Mi41IDU3LjQ0NjQgMTYyLjVINjcuMjkyOVYxMzIuNzA3SDM3LjVaIiBmaWxsPSJibGFjayIvPgo8L2c+CjxkZWZzPgo8Y2xpcFBhdGggaWQ9ImNsaXAwXzcwMzVfNTExMCI+CjxyZWN0IHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIiBmaWxsPSJ3aGl0ZSIvPgo8L2NsaXBQYXRoPgo8L2RlZnM+Cjwvc3ZnPgo=";
+    private _transport;
+    private _btcApp;
+    private _account;
+    private _network;
+    private _options;
+    private _derivationPath;
+    private static readonly CONNECTION_TIMEOUT;
+    constructor(options?: LedgerConnectorOptions);
+    /**
+     * Override checkReady - Ledger is always "ready" since it doesn't require browser extension
+     * The actual device connection happens when connect() is called
+     */
+    protected checkReady(): void;
+    /**
+     * Get the provider - for Ledger this is the Bitcoin app instance
+     */
+    protected getProvider(): LedgerBtcApp | null;
+    /**
+     * Get current address type
+     */
+    getAddressType(): LedgerAddressType;
+    /**
+     * Set address type options before connecting
+     * Call this before connect() to change the address derivation path
+     */
+    setOptions(options: LedgerConnectorOptions): void;
+    /**
+     * Get available address types for UI selection
+     */
+    static getAvailableAddressTypes(): Array<{
+        type: LedgerAddressType;
+        label: string;
+        description: string;
+    }>;
+    /**
+     * Check if WebUSB is supported in the current browser
+     */
+    isSupported(): Promise<boolean>;
+    /**
+     * Initialize transport with timeout
+     * Uses request() instead of create() to always show device selection popup
+     */
+    private initTransport;
+    /**
+     * Get BTC app instance, initializing if needed
+     */
+    private getBtcAppInstance;
+    /**
+     * Connect to Ledger device
+     * IMPORTANT: This must be called within a user gesture (click event)
+     */
+    connect(network?: BitcoinNetwork): Promise<WalletAccount>;
+    /**
+     * Get address with verification on device
+     */
+    getAddressWithVerification(): Promise<WalletAccount>;
+    private setupDisconnectListener;
+    private closeTransport;
+    disconnect(): Promise<void>;
+    getAccounts(): Promise<WalletAccount[]>;
+    signMessage(message: string): Promise<string>;
+    /**
+     * Sign a PSBT with Ledger
+     *
+     * Note: Ledger hardware wallets don't support direct PSBT signing through the standard API.
+     * Use the createTransaction method or sendTransaction instead.
+     */
+    signPsbt(_psbtHex: string, _options?: SignPsbtOptions): Promise<string>;
+    /**
+     * Sign multiple PSBTs
+     */
+    signPsbts(psbtHexs: string[], options?: SignPsbtOptions): Promise<string[]>;
+    /**
+     * Send a Bitcoin transaction
+     *
+     * @param to - Recipient address
+     * @param satoshis - Amount to send in satoshis
+     * @param options - Send options (feeRate, etc.)
+     * @returns Transaction ID after broadcast
+     *
+     * @example
+     * ```typescript
+     * const txid = await ledger.sendTransaction('bc1q...', 50000);
+     * // With custom fee rate
+     * const txid = await ledger.sendTransaction('bc1q...', 50000, { feeRate: 10 });
+     * ```
+     */
+    sendTransaction(to: string, satoshis: number, options?: SendBitcoinOptions): Promise<string>;
+    /**
+     * Create and sign a Bitcoin transaction using Ledger
+     *
+     * This method requires you to provide UTXOs (unspent transaction outputs) which
+     * must be fetched from a blockchain API (e.g., Blockstream, Mempool.space, etc.)
+     *
+     * @param inputs - Array of UTXO inputs to spend
+     * @param outputs - Array of outputs (recipients)
+     * @param changePath - Optional BIP32 path for change output
+     * @returns Signed transaction hex ready for broadcast
+     *
+     * @example
+     * ```typescript
+     * const signedTx = await ledger.createTransaction(
+     *   [{
+     *     txHex: '0100000001...', // Raw tx hex that created the UTXO
+     *     outputIndex: 0,
+     *     derivationPath: "84'/0'/0'/0/0",
+     *   }],
+     *   [{
+     *     address: 'bc1q...',
+     *     satoshis: 50000,
+     *   }],
+     *   "84'/0'/0'/1/0" // Change address path
+     * );
+     * ```
+     */
+    createTransaction(inputs: LedgerUtxoInput[], outputs: LedgerTxOutput[], changePath?: string): Promise<string>;
+    /**
+     * Build output script hex from outputs array
+     * Format: varint(output_count) + [amount(8 bytes LE) + varint(script_len) + script]...
+     */
+    private buildOutputScript;
+    /**
+     * Convert address to scriptPubKey hex
+     */
+    private addressToScriptPubKey;
+    /**
+     * Decode bech32/bech32m address to hex
+     */
+    private decodeBech32;
+    /**
+     * Decode base58check address to hex (without version byte)
+     */
+    private decodeBase58Check;
+    /**
+     * Encode number as varint hex
+     */
+    private encodeVarint;
+    /**
+     * Convert uint16 to little-endian hex
+     */
+    private uint16ToLittleEndian;
+    /**
+     * Convert uint32 to little-endian hex
+     */
+    private uint32ToLittleEndian;
+    /**
+     * Convert uint64 to little-endian hex
+     */
+    private uint64ToLittleEndian;
+    /**
+     * Get additionals array based on address type
+     */
+    private getAdditionals;
+    getNetwork(): Promise<BitcoinNetwork>;
+    /**
+     * Get extended public key (xpub/ypub/zpub) for account
+     */
+    getExtendedPublicKey(): Promise<string>;
+    /**
+     * Get multiple addresses for the account
+     */
+    getAddresses(startIndex: number, count: number): Promise<WalletAccount[]>;
+    /**
+     * Get current derivation path
+     */
+    getDerivationPath(): string;
+    /**
+     * Check if device is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the Ledger Bitcoin app instance for advanced operations
+     * This allows users to call createPaymentTransaction directly
+     */
+    getBtcApp(): LedgerBtcApp | null;
+    private mapLedgerAddressType;
+    private getXpubVersion;
+    private handleLedgerError;
+}
+
+export { type LedgerAddressType, LedgerConnector, type LedgerConnectorOptions, type LedgerTxOutput, type LedgerUtxoInput, type SendBitcoinOptions };

package/dist/ledger/index.d.ts

@@ -0,0 +1,290 @@
+import { BitcoinNetwork, WalletAccount, SignPsbtOptions } from 'otx-btc-wallet-core';
+import { B as BaseConnector } from '../base-IAFq7sd8.js';
+
+/**
+ * Ledger address type configuration
+ */
+type LedgerAddressType = 'legacy' | 'nested-segwit' | 'segwit' | 'taproot';
+/**
+ * Ledger connector options
+ */
+interface LedgerConnectorOptions {
+    /** Address type for derivation (default: 'segwit') */
+    addressType?: LedgerAddressType;
+    /** Account index (default: 0) */
+    accountIndex?: number;
+    /** Address index (default: 0) */
+    addressIndex?: number;
+}
+interface LedgerBtcApp {
+    getWalletPublicKey(path: string, opts?: {
+        verify?: boolean;
+        format?: 'legacy' | 'p2sh' | 'bech32' | 'bech32m';
+    }): Promise<{
+        publicKey: string;
+        bitcoinAddress: string;
+        chainCode: string;
+    }>;
+    getWalletXpub(arg: {
+        path: string;
+        xpubVersion: number;
+    }): Promise<string>;
+    signMessage(path: string, messageHex: string): Promise<{
+        v: number;
+        r: string;
+        s: string;
+    }>;
+    splitTransaction(transactionHex: string, isSegwitSupported?: boolean | null, hasExtraData?: boolean, additionals?: string[]): LedgerTransaction;
+    createPaymentTransaction(arg: {
+        inputs: Array<[LedgerTransaction, number, string | null | undefined, number?]>;
+        associatedKeysets: string[];
+        changePath?: string;
+        outputScriptHex: string;
+        lockTime?: number;
+        sigHashType?: number;
+        segwit?: boolean;
+        additionals?: string[];
+        expiryHeight?: Buffer;
+        useTrustedInputForSegwit?: boolean;
+    }): Promise<string>;
+    serializeTransactionOutputs(tx: LedgerTransaction): Buffer;
+}
+/**
+ * Ledger Transaction type (returned by splitTransaction)
+ */
+interface LedgerTransaction {
+    version: Buffer;
+    inputs: Array<{
+        prevout: Buffer;
+        script: Buffer;
+        sequence: Buffer;
+    }>;
+    outputs?: Array<{
+        amount: Buffer;
+        script: Buffer;
+    }>;
+    locktime?: Buffer;
+    witness?: Buffer;
+}
+/**
+ * UTXO input for createPaymentTransaction
+ */
+interface LedgerUtxoInput {
+    /** Raw transaction hex that created this UTXO */
+    txHex: string;
+    /** Output index in the transaction */
+    outputIndex: number;
+    /** BIP32 derivation path for signing (e.g., "84'/0'/0'/0/0") */
+    derivationPath: string;
+    /** Optional redeem script for P2SH inputs */
+    redeemScript?: string;
+    /** Optional sequence number (default: 0xffffffff) */
+    sequence?: number;
+}
+/**
+ * Output for createPaymentTransaction
+ */
+interface LedgerTxOutput {
+    /** Recipient address */
+    address: string;
+    /** Amount in satoshis */
+    satoshis: number;
+}
+/**
+ * Options for sendBitcoin method
+ */
+interface SendBitcoinOptions {
+    /** Fee rate in sat/vB (optional, defaults to "hour" priority) */
+    feeRate?: number;
+}
+/**
+ * Ledger Hardware Wallet Connector
+ *
+ * @see https://developers.ledger.com/docs/transport/overview
+ * @see https://github.com/LedgerHQ/ledger-live/tree/develop/libs/ledgerjs/packages/hw-app-btc
+ */
+declare class LedgerConnector extends BaseConnector {
+    readonly id = "ledger";
+    readonly name = "Ledger";
+    readonly icon = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAwIiBoZWlnaHQ9IjIwMCIgdmlld0JveD0iMCAwIDIwMCAyMDAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMF83MDM1XzUxMTApIj4KPHJlY3Qgd2lkdGg9IjIwMCIgaGVpZ2h0PSIyMDAiIHJ4PSIzMiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTE0Mi4yMzkgMzcuNUg4NS4wOTY0VjExNC41ODJIMTYyLjIzOVY1Ny40MzkzQzE2Mi4yMzggNTQuODE2IDE2MS43MiA1Mi4yMTg2IDE2MC43MTQgNDkuNzk1OUMxNTkuNzA4IDQ3LjM3MzIgMTU4LjIzMyA0NS4xNzI4IDE1Ni4zNzYgNDMuMzIwN0MxNTQuNTE4IDQxLjQ2ODUgMTUyLjMxMyA0MC4wMDExIDE0OS44ODcgMzkuMDAyM0MxNDcuNDYyIDM4LjAwMzUgMTQ0Ljg2MyAzNy40OTMgMTQyLjIzOSAzNy41WiIgZmlsbD0iYmxhY2siLz4KPHBhdGggZD0iTTY3LjI5MjkgMzcuNUg1Ny40NDY0QzUyLjE1NjMgMzcuNSA0Ny4wODI5IDM5LjYwMTUgNDMuMzQyMiA0My4zNDIyQzM5LjYwMTUgNDcuMDgyOSAzNy41IDUyLjE1NjMgMzcuNSA1Ny40NDY0TDM3LjUgNjcuMjkyOUg2Ny4yOTI5VjM3LjVaIiBmaWxsPSJibGFjayIvPgo8cGF0aCBkPSJNMzcuNSA4NS4xMDM2SDY3LjI5MjlWMTE0Ljg5NkgzNy41Vjg1LjEwMzZaIiBmaWxsPSJibGFjayIvPgo8cGF0aCBkPSJNMTMyLjcwNyAxNjIuMjQ2SDE0Mi41NTNDMTQ1LjE3NyAxNjIuMjQ2IDE0Ny43NzYgMTYxLjcyOSAxNTAuMTk5IDE2MC43MjNDMTUyLjYyMyAxNTkuNzE3IDE1NC44MjQgMTU4LjI0MyAxNTYuNjc3IDE1Ni4zODVDMTU4LjUzIDE1NC41MjcgMTU5Ljk5OCAxNTIuMzIyIDE2MC45OTcgMTQ5Ljg5NkMxNjEuOTk2IDE0Ny40NyAxNjIuNTA3IDE0NC44NyAxNjIuNSAxNDIuMjQ2VjEzMi43MDdIMTMyLjcwN1YxNjIuMjQ2WiIgZmlsbD0iYmxhY2siLz4KPHBhdGggZD0iTTg1LjEwMzUgMTMyLjcwN0gxMTQuODk2VjE2Mi41SDg1LjEwMzVWMTMyLjcwN1oiIGZpbGw9ImJsYWNrIi8+CjxwYXRoIGQ9Ik0zNy41IDEzMi43MDdWMTQyLjU1NEMzNy41IDE0NS4xNzMgMzguMDE1OSAxNDcuNzY3IDM5LjAxODMgMTUwLjE4N0M0MC4wMjA3IDE1Mi42MDcgNDEuNDkgMTU0LjgwNiA0My4zNDIyIDE1Ni42NThDNDUuMTk0NCAxNTguNTEgNDcuMzkzMiAxNTkuOTc5IDQ5LjgxMzMgMTYwLjk4MkM1Mi4yMzMzIDE2MS45ODQgNTQuODI3IDE2Mi41IDU3LjQ0NjQgMTYyLjVINjcuMjkyOVYxMzIuNzA3SDM3LjVaIiBmaWxsPSJibGFjayIvPgo8L2c+CjxkZWZzPgo8Y2xpcFBhdGggaWQ9ImNsaXAwXzcwMzVfNTExMCI+CjxyZWN0IHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIiBmaWxsPSJ3aGl0ZSIvPgo8L2NsaXBQYXRoPgo8L2RlZnM+Cjwvc3ZnPgo=";
+    private _transport;
+    private _btcApp;
+    private _account;
+    private _network;
+    private _options;
+    private _derivationPath;
+    private static readonly CONNECTION_TIMEOUT;
+    constructor(options?: LedgerConnectorOptions);
+    /**
+     * Override checkReady - Ledger is always "ready" since it doesn't require browser extension
+     * The actual device connection happens when connect() is called
+     */
+    protected checkReady(): void;
+    /**
+     * Get the provider - for Ledger this is the Bitcoin app instance
+     */
+    protected getProvider(): LedgerBtcApp | null;
+    /**
+     * Get current address type
+     */
+    getAddressType(): LedgerAddressType;
+    /**
+     * Set address type options before connecting
+     * Call this before connect() to change the address derivation path
+     */
+    setOptions(options: LedgerConnectorOptions): void;
+    /**
+     * Get available address types for UI selection
+     */
+    static getAvailableAddressTypes(): Array<{
+        type: LedgerAddressType;
+        label: string;
+        description: string;
+    }>;
+    /**
+     * Check if WebUSB is supported in the current browser
+     */
+    isSupported(): Promise<boolean>;
+    /**
+     * Initialize transport with timeout
+     * Uses request() instead of create() to always show device selection popup
+     */
+    private initTransport;
+    /**
+     * Get BTC app instance, initializing if needed
+     */
+    private getBtcAppInstance;
+    /**
+     * Connect to Ledger device
+     * IMPORTANT: This must be called within a user gesture (click event)
+     */
+    connect(network?: BitcoinNetwork): Promise<WalletAccount>;
+    /**
+     * Get address with verification on device
+     */
+    getAddressWithVerification(): Promise<WalletAccount>;
+    private setupDisconnectListener;
+    private closeTransport;
+    disconnect(): Promise<void>;
+    getAccounts(): Promise<WalletAccount[]>;
+    signMessage(message: string): Promise<string>;
+    /**
+     * Sign a PSBT with Ledger
+     *
+     * Note: Ledger hardware wallets don't support direct PSBT signing through the standard API.
+     * Use the createTransaction method or sendTransaction instead.
+     */
+    signPsbt(_psbtHex: string, _options?: SignPsbtOptions): Promise<string>;
+    /**
+     * Sign multiple PSBTs
+     */
+    signPsbts(psbtHexs: string[], options?: SignPsbtOptions): Promise<string[]>;
+    /**
+     * Send a Bitcoin transaction
+     *
+     * @param to - Recipient address
+     * @param satoshis - Amount to send in satoshis
+     * @param options - Send options (feeRate, etc.)
+     * @returns Transaction ID after broadcast
+     *
+     * @example
+     * ```typescript
+     * const txid = await ledger.sendTransaction('bc1q...', 50000);
+     * // With custom fee rate
+     * const txid = await ledger.sendTransaction('bc1q...', 50000, { feeRate: 10 });
+     * ```
+     */
+    sendTransaction(to: string, satoshis: number, options?: SendBitcoinOptions): Promise<string>;
+    /**
+     * Create and sign a Bitcoin transaction using Ledger
+     *
+     * This method requires you to provide UTXOs (unspent transaction outputs) which
+     * must be fetched from a blockchain API (e.g., Blockstream, Mempool.space, etc.)
+     *
+     * @param inputs - Array of UTXO inputs to spend
+     * @param outputs - Array of outputs (recipients)
+     * @param changePath - Optional BIP32 path for change output
+     * @returns Signed transaction hex ready for broadcast
+     *
+     * @example
+     * ```typescript
+     * const signedTx = await ledger.createTransaction(
+     *   [{
+     *     txHex: '0100000001...', // Raw tx hex that created the UTXO
+     *     outputIndex: 0,
+     *     derivationPath: "84'/0'/0'/0/0",
+     *   }],
+     *   [{
+     *     address: 'bc1q...',
+     *     satoshis: 50000,
+     *   }],
+     *   "84'/0'/0'/1/0" // Change address path
+     * );
+     * ```
+     */
+    createTransaction(inputs: LedgerUtxoInput[], outputs: LedgerTxOutput[], changePath?: string): Promise<string>;
+    /**
+     * Build output script hex from outputs array
+     * Format: varint(output_count) + [amount(8 bytes LE) + varint(script_len) + script]...
+     */
+    private buildOutputScript;
+    /**
+     * Convert address to scriptPubKey hex
+     */
+    private addressToScriptPubKey;
+    /**
+     * Decode bech32/bech32m address to hex
+     */
+    private decodeBech32;
+    /**
+     * Decode base58check address to hex (without version byte)
+     */
+    private decodeBase58Check;
+    /**
+     * Encode number as varint hex
+     */
+    private encodeVarint;
+    /**
+     * Convert uint16 to little-endian hex
+     */
+    private uint16ToLittleEndian;
+    /**
+     * Convert uint32 to little-endian hex
+     */
+    private uint32ToLittleEndian;
+    /**
+     * Convert uint64 to little-endian hex
+     */
+    private uint64ToLittleEndian;
+    /**
+     * Get additionals array based on address type
+     */
+    private getAdditionals;
+    getNetwork(): Promise<BitcoinNetwork>;
+    /**
+     * Get extended public key (xpub/ypub/zpub) for account
+     */
+    getExtendedPublicKey(): Promise<string>;
+    /**
+     * Get multiple addresses for the account
+     */
+    getAddresses(startIndex: number, count: number): Promise<WalletAccount[]>;
+    /**
+     * Get current derivation path
+     */
+    getDerivationPath(): string;
+    /**
+     * Check if device is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the Ledger Bitcoin app instance for advanced operations
+     * This allows users to call createPaymentTransaction directly
+     */
+    getBtcApp(): LedgerBtcApp | null;
+    private mapLedgerAddressType;
+    private getXpubVersion;
+    private handleLedgerError;
+}
+
+export { type LedgerAddressType, LedgerConnector, type LedgerConnectorOptions, type LedgerTxOutput, type LedgerUtxoInput, type SendBitcoinOptions };

package/dist/ledger/index.js

@@ -0,0 +1,14 @@
+'use strict';
+
+var chunkLNKTYZJM_js = require('../chunk-LNKTYZJM.js');
+require('../chunk-FISNQZZ7.js');
+require('../chunk-MFXLQWOE.js');
+
+
+
+Object.defineProperty(exports, "LedgerConnector", {
+  enumerable: true,
+  get: function () { return chunkLNKTYZJM_js.LedgerConnector; }
+});
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/ledger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/ledger/index.mjs

@@ -0,0 +1,5 @@
+export { LedgerConnector } from '../chunk-LVZMONQL.mjs';
+import '../chunk-AW2JZIHR.mjs';
+import '../chunk-5Z5Q2Y75.mjs';
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/ledger/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}