@babylonlabs-io/ts-sdk 0.0.0-semantic-release.2 → 0.1.0

package/dist/shared/wallets/__tests__/BitcoinWallet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitcoinWallet.test.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/__tests__/BitcoinWallet.test.ts"],"names":[],"mappings":""}

package/dist/shared/wallets/__tests__/EthereumWallet.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EthereumWallet.test.d.ts.map

package/dist/shared/wallets/__tests__/EthereumWallet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EthereumWallet.test.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/__tests__/EthereumWallet.test.ts"],"names":[],"mappings":""}

package/dist/shared/wallets/index.d.ts

@@ -0,0 +1,4 @@
+export type { BitcoinNetwork, BitcoinWallet, Hash, SignPsbtOptions, } from './interfaces';
+export { MockBitcoinWallet, MockEthereumWallet } from './mocks';
+export type { MockBitcoinWalletConfig, MockEthereumWalletConfig, } from './mocks';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/wallets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/wallets/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,aAAa,EACb,IAAI,EACJ,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAChE,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,SAAS,CAAC"}

package/dist/shared/wallets/interfaces/BitcoinWallet.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Bitcoin network types.
+ * Using string literal union for maximum compatibility with wallet providers.
+ */
+export type BitcoinNetwork = "mainnet" | "testnet" | "signet";
+/**
+ * Bitcoin network constants
+ */
+export declare const BitcoinNetworks: {
+    readonly MAINNET: "mainnet";
+    readonly TESTNET: "testnet";
+    readonly SIGNET: "signet";
+};
+/**
+ * Options for signing a specific input in a PSBT.
+ */
+export interface SignInputOptions {
+    /** Input index to sign */
+    index: number;
+    /** Address for signing (optional) */
+    address?: string;
+    /** Public key for signing (optional, hex string) */
+    publicKey?: string;
+    /** Sighash types (optional) */
+    sighashTypes?: number[];
+    /** Disable tweak signer for Taproot script path spend (optional) */
+    disableTweakSigner?: boolean;
+}
+/**
+ * SignPsbt options for advanced signing scenarios.
+ */
+export interface SignPsbtOptions {
+    /** Whether to automatically finalize the PSBT after signing */
+    autoFinalized?: boolean;
+    /**
+     * Specific inputs to sign.
+     * If not provided, wallet will attempt to sign all inputs it can.
+     * Use this to restrict signing to specific inputs (e.g., only depositor's input).
+     */
+    signInputs?: SignInputOptions[];
+    /** Contract information for the signing operation. */
+    contracts?: Array<{
+        /** Contract identifier. */
+        id: string;
+        /** Contract parameters. */
+        params: Record<string, string | number | string[] | number[]>;
+    }>;
+    /** Action metadata. */
+    action?: {
+        /** Action name for tracking. */
+        name: string;
+    };
+}
+/**
+ * This interface is designed to be compatible with @babylonlabs-io/wallet-connector's IBTCProvider
+ *
+ * Supports Unisat, Ledger, OKX, OneKey, Keystone, and other Bitcoin wallets.
+ */
+export interface BitcoinWallet {
+    /**
+     * Returns the wallet's public key as a hex string.
+     *
+     * For Taproot addresses, this should return the x-only public key
+     * (32 bytes = 64 hex characters without 0x prefix).
+     *
+     * For compressed public keys (33 bytes = 66 hex characters),
+     * consumers should strip the first byte to get x-only format.
+     */
+    getPublicKeyHex(): Promise<string>;
+    /**
+     * Returns the wallet's Bitcoin address.
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Signs a PSBT and returns the signed PSBT as hex.
+     *
+     * @param psbtHex - The PSBT to sign in hex format
+     * @param options - Optional signing parameters (e.g., autoFinalized, contracts)
+     * @throws {Error} If the PSBT is invalid or signing fails
+     */
+    signPsbt(psbtHex: string, options?: SignPsbtOptions): Promise<string>;
+    /**
+     * Signs multiple PSBTs and returns the signed PSBTs as hex.
+     * This allows batch signing with a single wallet interaction.
+     *
+     * @param psbtsHexes - Array of PSBTs to sign in hex format
+     * @param options - Optional array of signing parameters for each PSBT
+     * @throws {Error} If any PSBT is invalid or signing fails
+     */
+    signPsbts(psbtsHexes: string[], options?: SignPsbtOptions[]): Promise<string[]>;
+    /**
+     * Signs a message for authentication or proof of ownership.
+     *
+     * @param message - The message to sign
+     * @param type - The signing method: "ecdsa" for standard signatures, "bip322-simple" for BIP-322
+     * @returns Base64-encoded signature
+     */
+    signMessage(message: string, type: "bip322-simple" | "ecdsa"): Promise<string>;
+    /**
+     * Returns the Bitcoin network the wallet is connected to.
+     *
+     * @returns BitcoinNetwork enum value (MAINNET, TESTNET, SIGNET)
+     */
+    getNetwork(): Promise<BitcoinNetwork>;
+}
+//# sourceMappingURL=BitcoinWallet.d.ts.map

package/dist/shared/wallets/interfaces/BitcoinWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitcoinWallet.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/interfaces/BitcoinWallet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,sDAAsD;IACtD,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,2BAA2B;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,2BAA2B;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;KAC/D,CAAC,CAAC;IACH,uBAAuB;IACvB,MAAM,CAAC,EAAE;QACP,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtE;;;;;;;OAOG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,eAAe,EAAE,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;;;;;OAMG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,GAAG,OAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACvC"}

package/dist/shared/wallets/interfaces/EthereumWallet.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Ethereum transaction hash type (hex string with 0x prefix).
+ * Alias for viem's Hex type, provided for convenience.
+ */
+export type Hash = `0x${string}`;
+//# sourceMappingURL=EthereumWallet.d.ts.map

package/dist/shared/wallets/interfaces/EthereumWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EthereumWallet.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/interfaces/EthereumWallet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC"}

package/dist/shared/wallets/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export { BitcoinNetworks } from './BitcoinWallet';
+export type { BitcoinNetwork, BitcoinWallet, SignPsbtOptions, } from './BitcoinWallet';
+export type { Hash } from './EthereumWallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/wallets/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/interfaces/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/wallets/mocks/MockBitcoinWallet.d.ts

@@ -0,0 +1,29 @@
+import { BitcoinNetwork } from '../interfaces';
+import { BitcoinWallet } from '../interfaces/BitcoinWallet';
+/**
+ * Configuration for MockBitcoinWallet.
+ */
+export interface MockBitcoinWalletConfig {
+    publicKeyHex?: string;
+    address?: string;
+    network?: BitcoinNetwork;
+    shouldFailSigning?: boolean;
+}
+/**
+ * Mock Bitcoin wallet for testing.
+ */
+export declare class MockBitcoinWallet implements BitcoinWallet {
+    private config;
+    constructor(config?: MockBitcoinWalletConfig);
+    getPublicKeyHex(): Promise<string>;
+    getAddress(): Promise<string>;
+    signPsbt(psbtHex: string): Promise<string>;
+    signPsbts(psbtsHexes: string[]): Promise<string[]>;
+    signMessage(message: string, type: "bip322-simple" | "ecdsa"): Promise<string>;
+    getNetwork(): Promise<BitcoinNetwork>;
+    /** Updates configuration for testing different scenarios. */
+    updateConfig(updates: Partial<MockBitcoinWalletConfig>): void;
+    /** Resets to default configuration. */
+    reset(): void;
+}
+//# sourceMappingURL=MockBitcoinWallet.d.ts.map

package/dist/shared/wallets/mocks/MockBitcoinWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockBitcoinWallet.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/mocks/MockBitcoinWallet.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,MAAM,CAAoC;gBAEtC,MAAM,GAAE,uBAA4B;IAa1C,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAIlC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc1C,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASlD,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,GAAG,OAAO,GAC9B,OAAO,CAAC,MAAM,CAAC;IAiBZ,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAI3C,6DAA6D;IAC7D,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI;IAO7D,uCAAuC;IACvC,KAAK,IAAI,IAAI;CASd"}

package/dist/shared/wallets/mocks/MockEthereumWallet.d.ts

@@ -0,0 +1,51 @@
+import { Address, Hex } from 'viem';
+/**
+ * Configuration for MockEthereumWallet.
+ */
+export interface MockEthereumWalletConfig {
+    address?: Address;
+    chainId?: number;
+    shouldFailOperations?: boolean;
+    transactionDelay?: number;
+}
+/**
+ * Mock Ethereum wallet for testing.
+ *
+ * Provides the subset of viem's WalletClient methods used by the SDK.
+ * Can be passed to functions expecting a WalletClient for testing purposes.
+ */
+export declare class MockEthereumWallet {
+    account: {
+        address: Address;
+    };
+    chain: {
+        id: number;
+    };
+    private shouldFailOperations;
+    private transactionDelay;
+    private nonce;
+    constructor(config?: MockEthereumWalletConfig);
+    signMessage(args: {
+        message: string;
+        account?: Address;
+    }): Promise<Hex>;
+    sendTransaction(tx: {
+        to: Address;
+        data?: Hex;
+        value?: bigint;
+        gas?: bigint;
+        account?: {
+            address: Address;
+        };
+        chain?: {
+            id: number;
+        };
+    }): Promise<Hex>;
+    /** Updates configuration for testing different scenarios. */
+    updateConfig(updates: Partial<MockEthereumWalletConfig>): void;
+    /** Resets to default configuration and nonce. */
+    reset(): void;
+    /** Returns current nonce for testing. */
+    getCurrentNonce(): number;
+}
+//# sourceMappingURL=MockEthereumWallet.d.ts.map

package/dist/shared/wallets/mocks/MockEthereumWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockEthereumWallet.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/mocks/MockEthereumWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAE7B,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtB,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAa;gBAEd,MAAM,GAAE,wBAA6B;IAoB3C,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAqBvE,eAAe,CAAC,EAAE,EAAE;QACxB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;QAC/B,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;KACxB,GAAG,OAAO,CAAC,GAAG,CAAC;IAiChB,6DAA6D;IAC7D,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;IAe9D,iDAAiD;IACjD,KAAK,IAAI,IAAI;IASb,yCAAyC;IACzC,eAAe,IAAI,MAAM;CAG1B"}

package/dist/shared/wallets/mocks/index.d.ts

@@ -0,0 +1,5 @@
+export { MockBitcoinWallet } from './MockBitcoinWallet';
+export type { MockBitcoinWalletConfig } from './MockBitcoinWallet';
+export { MockEthereumWallet } from './MockEthereumWallet';
+export type { MockEthereumWalletConfig } from './MockEthereumWallet';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/wallets/mocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/wallets/mocks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tbv/core/clients/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SDK Clients
+ *
+ * API clients for external services used by the SDK.
+ *
+ * @module clients
+ */
+export * from './mempool';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/clients/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,WAAW,CAAC"}

package/dist/tbv/core/clients/mempool/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Mempool API Client
+ *
+ * Client for interacting with mempool.space API for Bitcoin network operations.
+ *
+ * @module clients/mempool
+ */
+export { getAddressTxs, getAddressUtxos, getMempoolApiUrl, getNetworkFees, getTxHex, getTxInfo, getUtxoInfo, MEMPOOL_API_URLS, pushTx, } from './mempoolApi';
+export type { AddressTx } from './mempoolApi';
+export type { MempoolUTXO, NetworkFees, TxInfo, TxInput, TxOutput, TxStatus, UtxoInfo, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/clients/mempool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/clients/mempool/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EACV,WAAW,EACX,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/dist/tbv/core/clients/mempool/mempoolApi.d.ts

@@ -0,0 +1,94 @@
+import { MempoolUTXO, NetworkFees, TxInfo, UtxoInfo } from './types';
+/**
+ * Default mempool API URLs by network.
+ */
+export declare const MEMPOOL_API_URLS: {
+    readonly mainnet: "https://mempool.space/api";
+    readonly testnet: "https://mempool.space/testnet/api";
+    readonly signet: "https://mempool.space/signet/api";
+};
+/**
+ * Push a signed transaction to the Bitcoin network.
+ *
+ * @param txHex - The signed transaction hex string
+ * @param apiUrl - Mempool API base URL
+ * @returns The transaction ID
+ * @throws Error if broadcasting fails
+ */
+export declare function pushTx(txHex: string, apiUrl: string): Promise<string>;
+/**
+ * Get transaction information from mempool.
+ *
+ * @param txid - The transaction ID
+ * @param apiUrl - Mempool API base URL
+ * @returns Transaction information
+ */
+export declare function getTxInfo(txid: string, apiUrl: string): Promise<TxInfo>;
+/**
+ * Get the hex representation of a transaction.
+ *
+ * @param txid - The transaction ID
+ * @param apiUrl - Mempool API base URL
+ * @returns The transaction hex string
+ * @throws Error if the request fails or transaction is not found
+ */
+export declare function getTxHex(txid: string, apiUrl: string): Promise<string>;
+/**
+ * Get UTXO information for a specific transaction output.
+ *
+ * This is used for constructing PSBTs where we need the witnessUtxo data.
+ * Only supports Taproot (P2TR) and native SegWit (P2WPKH, P2WSH) script types.
+ *
+ * @param txid - The transaction ID containing the UTXO
+ * @param vout - The output index
+ * @param apiUrl - Mempool API base URL
+ * @returns UTXO information with value and scriptPubKey
+ */
+export declare function getUtxoInfo(txid: string, vout: number, apiUrl: string): Promise<UtxoInfo>;
+/**
+ * Get all UTXOs for a Bitcoin address.
+ *
+ * @param address - The Bitcoin address
+ * @param apiUrl - Mempool API base URL
+ * @returns Array of UTXOs sorted by value (largest first)
+ */
+export declare function getAddressUtxos(address: string, apiUrl: string): Promise<MempoolUTXO[]>;
+/**
+ * Get the mempool API URL for a given network.
+ *
+ * @param network - Bitcoin network (mainnet, testnet, signet)
+ * @returns The mempool API URL
+ */
+export declare function getMempoolApiUrl(network: "mainnet" | "testnet" | "signet"): string;
+/**
+ * Transaction summary from address transactions endpoint.
+ */
+export interface AddressTx {
+    txid: string;
+    status: {
+        confirmed: boolean;
+        block_height?: number;
+    };
+}
+/**
+ * Get recent transactions for a Bitcoin address.
+ *
+ * Returns the last 25 confirmed transactions plus any unconfirmed (mempool) transactions.
+ * This is useful for checking if a specific transaction has been broadcast.
+ *
+ * @param address - The Bitcoin address
+ * @param apiUrl - Mempool API base URL
+ * @returns Array of recent transactions
+ */
+export declare function getAddressTxs(address: string, apiUrl: string): Promise<AddressTx[]>;
+/**
+ * Fetches Bitcoin network fee recommendations from mempool.space API.
+ *
+ * @param apiUrl - Mempool API base URL
+ * @returns Fee rates in sat/vbyte for different confirmation times
+ * @throws Error if request fails or returns invalid data
+ *
+ * @see https://mempool.space/docs/api/rest#get-recommended-fees
+ */
+export declare function getNetworkFees(apiUrl: string): Promise<NetworkFees>;
+//# sourceMappingURL=mempoolApi.d.ts.map

package/dist/tbv/core/clients/mempool/mempoolApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mempoolApi.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/clients/mempool/mempoolApi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAiCX;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC3E;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,CAAC,CA8CxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GACxC,MAAM,CAER;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBzE"}

package/dist/tbv/core/clients/mempool/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Mempool API Types
+ *
+ * Type definitions for mempool.space API responses.
+ *
+ * @module clients/mempool/types
+ */
+/**
+ * UTXO information from mempool API.
+ */
+export interface MempoolUTXO {
+    txid: string;
+    vout: number;
+    value: number;
+    scriptPubKey: string;
+    confirmed: boolean;
+}
+/**
+ * Transaction input from mempool API.
+ */
+export interface TxInput {
+    txid: string;
+    vout: number;
+    prevout: {
+        scriptpubkey: string;
+        scriptpubkey_asm: string;
+        scriptpubkey_type: string;
+        scriptpubkey_address: string;
+        value: number;
+    };
+    scriptsig: string;
+    scriptsig_asm: string;
+    witness: string[];
+    is_coinbase: boolean;
+    sequence: number;
+}
+/**
+ * Transaction output from mempool API.
+ */
+export interface TxOutput {
+    scriptpubkey: string;
+    scriptpubkey_asm: string;
+    scriptpubkey_type: string;
+    scriptpubkey_address: string;
+    value: number;
+}
+/**
+ * Transaction status from mempool API.
+ */
+export interface TxStatus {
+    confirmed: boolean;
+    block_height?: number;
+    block_hash?: string;
+    block_time?: number;
+}
+/**
+ * Full transaction info from mempool API.
+ */
+export interface TxInfo {
+    txid: string;
+    version: number;
+    locktime: number;
+    vin: TxInput[];
+    vout: TxOutput[];
+    size: number;
+    weight: number;
+    fee: number;
+    status: TxStatus;
+}
+/**
+ * UTXO info for a specific output (used for PSBT construction).
+ *
+ * Only supports Taproot (P2TR) and native SegWit (P2WPKH, P2WSH) script types.
+ */
+export interface UtxoInfo {
+    txid: string;
+    vout: number;
+    value: number;
+    scriptPubKey: string;
+}
+/**
+ * Bitcoin network fee recommendations (sat/vbyte) from mempool.space API.
+ *
+ * @see https://mempool.space/docs/api/rest#get-recommended-fees
+ */
+export interface NetworkFees {
+    /** Next block (~10 min) */
+    fastestFee: number;
+    /** ~30 minutes */
+    halfHourFee: number;
+    /** ~1 hour */
+    hourFee: number;
+    /** Economy (no time guarantee) */
+    economyFee: number;
+    /** Minimum network fee */
+    minimumFee: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tbv/core/clients/mempool/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/clients/mempool/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB"}