@gvnrdao/dh-lit-actions 0.0.68 → 0.0.111

package/pkg-dist/src/modules/bitcoin/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/modules/bitcoin/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAI/B;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAU,GAC3B,OAAO,CAAC,IAAI,EAAE,CAAC;IAQlB;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlE;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnE;;;;;OAKG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAM3D"}

package/pkg-dist/src/modules/bitcoin/provider.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Bitcoin Provider Module
+ *
+ * Provides Bitcoin blockchain data access through RPC provider.
+ * Supports UTXO queries, scriptPubKey retrieval, and transaction queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BitcoinProvider = void 0;
+/**
+ * Bitcoin RPC provider client
+ */
+class BitcoinProvider {
+    constructor(providerUrl) {
+        this.providerUrl = providerUrl;
+    }
+    /**
+     * Get UTXOs for Bitcoin address
+     *
+     * @param address - Bitcoin address
+     * @param minConfirmations - Minimum confirmations required
+     * @returns Array of UTXOs
+     */
+    async getUtxos(address, minConfirmations = 1) {
+        // Query UTXOs from provider
+        // Implementation depends on provider API (Bitcoin Core RPC, Esplora, etc.)
+        // Placeholder - actual implementation would call provider API
+        throw new Error("getUtxos not implemented - provider-specific");
+    }
+    /**
+     * Get scriptPubKey for transaction output
+     *
+     * @param txid - Transaction ID
+     * @param vout - Output index
+     * @returns ScriptPubKey hex string
+     */
+    async getScriptPubKey(txid, vout) {
+        // Query transaction and extract scriptPubKey from specified output
+        // Placeholder - actual implementation would call provider API
+        throw new Error("getScriptPubKey not implemented - provider-specific");
+    }
+    /**
+     * Check if UTXO exists and is unspent
+     *
+     * @param txid - Transaction ID
+     * @param vout - Output index
+     * @returns true if UTXO exists and is unspent
+     */
+    async checkUtxoExists(txid, vout) {
+        // Query UTXO status from provider
+        // Placeholder - actual implementation would call provider API
+        throw new Error("checkUtxoExists not implemented - provider-specific");
+    }
+    /**
+     * Broadcast Bitcoin transaction
+     *
+     * @param txHex - Signed transaction hex
+     * @returns Transaction ID
+     */
+    async broadcastTransaction(txHex) {
+        // Send raw transaction to Bitcoin network
+        // Placeholder - actual implementation would call provider API
+        throw new Error("broadcastTransaction not implemented - provider-specific");
+    }
+}
+exports.BitcoinProvider = BitcoinProvider;
+//# sourceMappingURL=provider.js.map

package/pkg-dist/src/modules/bitcoin/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/modules/bitcoin/provider.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAaH;;GAEG;AACH,MAAa,eAAe;IAG1B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,mBAA2B,CAAC;QAE5B,4BAA4B;QAC5B,2EAA2E;QAE3E,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,IAAY;QAC9C,mEAAmE;QAEnE,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,IAAY;QAC9C,kCAAkC;QAElC,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CAAC,KAAa;QACtC,0CAA0C;QAE1C,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;CACF;AAjED,0CAiEC"}

package/pkg-dist/src/modules/bitcoin/signature.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Bitcoin Signature Module
+ *
+ * Handles conversion of Ethereum-format signatures to Bitcoin DER format.
+ * Implements BIP 62 s-value normalization and DER encoding.
+ *
+ * CRITICAL: Handles both prefixed (0x...) and non-prefixed hex strings correctly.
+ * LIT Protocol returns signatures without 0x prefix.
+ */
+/**
+ * Convert Ethereum signature to Bitcoin DER format
+ *
+ * CRITICAL FIX: Conditional prefix removal
+ * - LIT Protocol returns {r: '59f9d5b0...', s: '6b5a9233...'} (NO 0x prefix)
+ * - Must check for prefix before slicing to avoid removing first data byte
+ *
+ * @param sig - Ethereum signature {r: string, s: string}
+ * @returns DER-encoded signature (hex string)
+ */
+export declare function ethereumSignatureToBtcSignature(sig: {
+    r: string;
+    s: string;
+}): string;
+//# sourceMappingURL=signature.d.ts.map

package/pkg-dist/src/modules/bitcoin/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../../src/modules/bitcoin/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE;IACnD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CA+CT"}

package/pkg-dist/src/modules/bitcoin/signature.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Bitcoin Signature Module
+ *
+ * Handles conversion of Ethereum-format signatures to Bitcoin DER format.
+ * Implements BIP 62 s-value normalization and DER encoding.
+ *
+ * CRITICAL: Handles both prefixed (0x...) and non-prefixed hex strings correctly.
+ * LIT Protocol returns signatures without 0x prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ethereumSignatureToBtcSignature = ethereumSignatureToBtcSignature;
+/**
+ * Convert Ethereum signature to Bitcoin DER format
+ *
+ * CRITICAL FIX: Conditional prefix removal
+ * - LIT Protocol returns {r: '59f9d5b0...', s: '6b5a9233...'} (NO 0x prefix)
+ * - Must check for prefix before slicing to avoid removing first data byte
+ *
+ * @param sig - Ethereum signature {r: string, s: string}
+ * @returns DER-encoded signature (hex string)
+ */
+function ethereumSignatureToBtcSignature(sig) {
+    // CRITICAL FIX: Conditional prefix removal
+    // Check for 0x prefix before slicing to avoid removing first data byte
+    const rHex = sig.r.startsWith("0x") ? sig.r.slice(2) : sig.r;
+    const sHex = sig.s.startsWith("0x") ? sig.s.slice(2) : sig.s;
+    let r = Buffer.from(rHex, "hex");
+    let s = Buffer.from(sHex, "hex");
+    // BIP 62: s-value normalization (low-s requirement)
+    // Bitcoin requires s <= n/2 where n is the curve order
+    // If s > n/2, replace with n - s
+    // @ts-ignore - EC available in LIT runtime (elliptic library)
+    const EC = require("elliptic").ec;
+    const secp256k1 = new EC("secp256k1");
+    const n = secp256k1.curve.n;
+    let sBN = BigInt("0x" + s.toString("hex"));
+    const halfN = n.divn(2);
+    if (sBN > BigInt(halfN.toString())) {
+        // s is too large, normalize it
+        sBN = BigInt(n.toString()) - sBN;
+        s = Buffer.from(sBN.toString(16).padStart(64, "0"), "hex");
+    }
+    // Ensure positive representation (DER requires leading 0x00 if high bit set)
+    // If first byte >= 0x80, prepend 0x00 to indicate positive number
+    if (r[0] >= 0x80) {
+        r = Buffer.concat([Buffer.from([0x00]), r]);
+    }
+    if (s[0] >= 0x80) {
+        s = Buffer.concat([Buffer.from([0x00]), s]);
+    }
+    // Remove leading zero bytes (unless needed for sign bit)
+    while (r.length > 1 && r[0] === 0x00 && r[1] < 0x80) {
+        r = r.slice(1);
+    }
+    while (s.length > 1 && s[0] === 0x00 && s[1] < 0x80) {
+        s = s.slice(1);
+    }
+    // DER encode using bip66
+    // @ts-ignore - bip66 available in LIT runtime
+    const bip66 = require("bip66");
+    return Buffer.from(bip66.encode(r, s)).toString("hex");
+}
+//# sourceMappingURL=signature.js.map

package/pkg-dist/src/modules/bitcoin/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../../../src/modules/bitcoin/signature.ts"],"names":[],"mappings":"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"}

package/pkg-dist/src/modules/bitcoin/transaction.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Bitcoin Transaction Module
+ *
+ * Provides Bitcoin transaction building and signature hash computation.
+ * Implements Bitcoin protocol transaction structure and SIGHASH_ALL signing.
+ */
+/**
+ * UTXO input for transaction building
+ */
+export interface UTXOInput {
+    txid: string;
+    vout: number;
+    value: number;
+    scriptPubKey: string;
+}
+/**
+ * Transaction building parameters
+ */
+export interface TransactionParams {
+    utxo: UTXOInput;
+    destination: string;
+    amount: number;
+    changeAddress: string;
+    changeAmount: number;
+    network: string;
+    pkpPublicKey: string;
+}
+/**
+ * Transaction building result
+ */
+export interface TransactionResult {
+    txHex: string;
+    sigHash: string;
+}
+/**
+ * Build Bitcoin transaction and compute signature hash
+ *
+ * Creates a SegWit (P2WPKH) Bitcoin transaction following BIP 143:
+ * - Version: 4 bytes (little endian) - version 2
+ * - Input count: varint
+ * - Inputs: txid (reversed) + vout + scriptSig (empty for witness) + sequence
+ * - Output count: varint
+ * - Outputs: value + scriptPubKey
+ * - Locktime: 4 bytes
+ *
+ * For BIP 143 SIGHASH_ALL signature hash (P2WPKH):
+ * The sighash preimage includes:
+ * 1. nVersion (4 bytes)
+ * 2. hashPrevouts (32 bytes) - double SHA256 of all input outpoints
+ * 3. hashSequence (32 bytes) - double SHA256 of all input sequences
+ * 4. outpoint (36 bytes) - txid + vout of input being signed
+ * 5. scriptCode (variable) - for P2WPKH: OP_DUP OP_HASH160 <20-byte-hash> OP_EQUALVERIFY OP_CHECKSIG
+ * 6. value (8 bytes) - value of output being spent
+ * 7. nSequence (4 bytes) - sequence of input being signed
+ * 8. hashOutputs (32 bytes) - double SHA256 of all outputs
+ * 9. nLocktime (4 bytes)
+ * 10. nHashType (4 bytes) - SIGHASH_ALL = 0x01000000
+ *
+ * @param params - Transaction parameters
+ * @returns Transaction hex and signature hash
+ */
+export declare function buildBitcoinTransaction(params: TransactionParams): TransactionResult;
+//# sourceMappingURL=transaction.d.ts.map

package/pkg-dist/src/modules/bitcoin/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/modules/bitcoin/transaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CAyInB"}

package/pkg-dist/src/modules/bitcoin/transaction.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Bitcoin Transaction Module
+ *
+ * Provides Bitcoin transaction building and signature hash computation.
+ * Implements Bitcoin protocol transaction structure and SIGHASH_ALL signing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBitcoinTransaction = buildBitcoinTransaction;
+const address_1 = require("./address");
+/**
+ * Build Bitcoin transaction and compute signature hash
+ *
+ * Creates a SegWit (P2WPKH) Bitcoin transaction following BIP 143:
+ * - Version: 4 bytes (little endian) - version 2
+ * - Input count: varint
+ * - Inputs: txid (reversed) + vout + scriptSig (empty for witness) + sequence
+ * - Output count: varint
+ * - Outputs: value + scriptPubKey
+ * - Locktime: 4 bytes
+ *
+ * For BIP 143 SIGHASH_ALL signature hash (P2WPKH):
+ * The sighash preimage includes:
+ * 1. nVersion (4 bytes)
+ * 2. hashPrevouts (32 bytes) - double SHA256 of all input outpoints
+ * 3. hashSequence (32 bytes) - double SHA256 of all input sequences
+ * 4. outpoint (36 bytes) - txid + vout of input being signed
+ * 5. scriptCode (variable) - for P2WPKH: OP_DUP OP_HASH160 <20-byte-hash> OP_EQUALVERIFY OP_CHECKSIG
+ * 6. value (8 bytes) - value of output being spent
+ * 7. nSequence (4 bytes) - sequence of input being signed
+ * 8. hashOutputs (32 bytes) - double SHA256 of all outputs
+ * 9. nLocktime (4 bytes)
+ * 10. nHashType (4 bytes) - SIGHASH_ALL = 0x01000000
+ *
+ * @param params - Transaction parameters
+ * @returns Transaction hex and signature hash
+ */
+function buildBitcoinTransaction(params) {
+    const { utxo, destination, amount, changeAddress, changeAmount, pkpPublicKey, } = params;
+    // Transaction structure components
+    const txVersion = "02000000"; // Version 2 (little endian)
+    const inputCount = "01"; // 1 input
+    // Input: txid (reversed) + vout + empty scriptSig + sequence
+    const txidReversed = reverseHex(utxo.txid);
+    const voutHex = numToLittleEndianHex(utxo.vout, 4);
+    const sequence = "ffffffff"; // No locktime
+    // Build outputs
+    const outputs = [];
+    // Output 1: To destination
+    const destinationScript = (0, address_1.addressToScriptPubKey)(destination);
+    const destinationValue = numToLittleEndianHex(amount, 8);
+    const destinationScriptLen = numToVarInt(destinationScript.length / 2);
+    outputs.push(destinationValue + destinationScriptLen + destinationScript);
+    // Output 2: Change (if any)
+    if (changeAmount > 0) {
+        const changeScript = (0, address_1.addressToScriptPubKey)(changeAddress);
+        const changeValue = numToLittleEndianHex(changeAmount, 8);
+        const changeScriptLen = numToVarInt(changeScript.length / 2);
+        outputs.push(changeValue + changeScriptLen + changeScript);
+    }
+    const outputCount = numToVarInt(outputs.length);
+    const outputsHex = outputs.join("");
+    const locktime = "00000000"; // No locktime
+    // ========================================================================
+    // BIP 143 Signature Hash Computation (for P2WPKH)
+    // ========================================================================
+    // 1. nVersion (4 bytes)
+    const nVersion = txVersion;
+    // 2. hashPrevouts - double SHA256 of all input outpoints (txid + vout)
+    const outpoint = reverseHex(utxo.txid) + voutHex;
+    // @ts-ignore - ethers available in LIT runtime
+    const hashPrevouts = ethers.utils.sha256(
+    // @ts-ignore
+    ethers.utils.sha256("0x" + outpoint));
+    // 3. hashSequence - double SHA256 of all input sequences
+    // @ts-ignore - ethers available in LIT runtime
+    const hashSequence = ethers.utils.sha256(
+    // @ts-ignore
+    ethers.utils.sha256("0x" + sequence));
+    // 4. outpoint being signed (txid + vout)
+    const outpointSigning = outpoint;
+    // 5. scriptCode for P2WPKH
+    // For P2WPKH, scriptCode is: OP_DUP OP_HASH160 <20-byte-pubkey-hash> OP_EQUALVERIFY OP_CHECKSIG
+    // Extract the 20-byte hash from the P2WPKH scriptPubKey
+    const scriptPubKeyHex = utxo.scriptPubKey.startsWith("0x")
+        ? utxo.scriptPubKey.slice(2)
+        : utxo.scriptPubKey;
+    // P2WPKH scriptPubKey format: OP_0 (0x00) + PUSH20 (0x14) + 20-byte-hash
+    // Extract the 20-byte hash (skip first 2 bytes: 0x00 0x14)
+    const pubkeyHash = scriptPubKeyHex.slice(4); // Skip "0014"
+    // Build scriptCode: OP_DUP OP_HASH160 <20-byte-hash> OP_EQUALVERIFY OP_CHECKSIG
+    // 0x76 = OP_DUP, 0xa9 = OP_HASH160, 0x14 = PUSH 20 bytes, 0x88 = OP_EQUALVERIFY, 0xac = OP_CHECKSIG
+    const scriptCode = "1976a914" + pubkeyHash + "88ac";
+    // 6. value of output being spent (8 bytes, little endian)
+    const valueHex = numToLittleEndianHex(utxo.value, 8);
+    // 7. nSequence of input being signed
+    const nSequence = sequence;
+    // 8. hashOutputs - double SHA256 of all outputs
+    // @ts-ignore - ethers available in LIT runtime
+    const hashOutputs = ethers.utils.sha256(
+    // @ts-ignore
+    ethers.utils.sha256("0x" + outputsHex));
+    // 9. nLocktime
+    const nLocktime = locktime;
+    // 10. nHashType (SIGHASH_ALL = 0x01000000)
+    const nHashType = "01000000";
+    // Build BIP 143 preimage
+    const bip143Preimage = nVersion +
+        hashPrevouts.slice(2) + // Remove 0x prefix
+        hashSequence.slice(2) +
+        outpointSigning +
+        scriptCode +
+        valueHex +
+        nSequence +
+        hashOutputs.slice(2) +
+        nLocktime +
+        nHashType;
+    // Double SHA256 for BIP 143 signature hash
+    // @ts-ignore - ethers available in LIT runtime
+    const hash1 = ethers.utils.sha256("0x" + bip143Preimage);
+    // @ts-ignore - ethers available in LIT runtime
+    const sigHash = ethers.utils.sha256(hash1);
+    // Unsigned transaction WITHOUT SegWit marker/flag
+    // SDK will convert this to proper SegWit format using PSBT
+    // For P2WPKH, the scriptSig MUST be empty (witness data separate)
+    const unsignedTx = txVersion +
+        inputCount +
+        txidReversed +
+        voutHex +
+        "00" + // Empty scriptSig - P2WPKH requires this
+        sequence +
+        outputCount +
+        outputsHex +
+        locktime;
+    return {
+        txHex: unsignedTx,
+        sigHash: sigHash,
+    };
+}
+/**
+ * Reverse hex string (for txid byte order)
+ * Bitcoin stores txid in reverse byte order
+ */
+function reverseHex(hex) {
+    const clean = hex.startsWith("0x") ? hex.slice(2) : hex;
+    const bytes = clean.match(/../g);
+    if (!bytes) {
+        throw new Error(`Invalid hex string: ${hex}`);
+    }
+    return bytes.reverse().join("");
+}
+/**
+ * Convert number to little-endian hex
+ * Bitcoin uses little-endian byte order
+ */
+function numToLittleEndianHex(num, bytes) {
+    let hex = num.toString(16).padStart(bytes * 2, "0");
+    const pairs = hex.match(/../g);
+    if (!pairs) {
+        throw new Error(`Invalid hex conversion: ${num}`);
+    }
+    return pairs.reverse().join("");
+}
+/**
+ * VarInt encoding (Bitcoin compact size)
+ *
+ * Format:
+ * - < 0xfd: 1 byte
+ * - <= 0xffff: 0xfd + 2 bytes (little endian)
+ * - <= 0xffffffff: 0xfe + 4 bytes (little endian)
+ * - > 0xffffffff: 0xff + 8 bytes (little endian)
+ */
+function numToVarInt(num) {
+    if (num < 0xfd) {
+        return num.toString(16).padStart(2, "0");
+    }
+    else if (num <= 0xffff) {
+        return "fd" + numToLittleEndianHex(num, 2);
+    }
+    else if (num <= 0xffffffff) {
+        return "fe" + numToLittleEndianHex(num, 4);
+    }
+    else {
+        return "ff" + numToLittleEndianHex(num, 8);
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/pkg-dist/src/modules/bitcoin/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../../src/modules/bitcoin/transaction.ts"],"names":[],"mappings":"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"}

package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts

@@ -20,6 +20,13 @@ export declare class BitcoinDataProvider implements IBitcoinDataProvider {
     private config;
     private timeout;
     constructor(config: BitcoinDataProviderConfig);
+    /**
+     * Get current Bitcoin block height from provider
+     *
+     * Returns null if block height cannot be fetched (e.g., provider doesn't support it).
+     * This allows graceful degradation for providers that don't implement the Esplora API fully.
+     */
+    private getCurrentBlockHeight;
     /**
      * Fetch all UTXOs for a Bitcoin address
      *
@@ -44,9 +51,12 @@ export declare class BitcoinDataProvider implements IBitcoinDataProvider {
     /**
      * Parse Esplora/Blockstream/Mempool.space UTXO response
      *
-     * Expected format: Array of {txid, vout, value, confirmations}
+     * Supports multiple formats:
+     * - Esplora format: {txid, vout, value, status: {confirmed, block_height}}
+     * - Blockstream format: {txid, vout, value, confirmations}
      *
      * @param data Raw response from provider API
+     * @param currentBlockHeight Current block height (for calculating confirmations from block_height), or null if unavailable
      * @returns Array of normalized UTXOs
      */
     private parseBlockstreamUTXOs;
@@ -69,6 +79,17 @@ export declare class BitcoinDataProvider implements IBitcoinDataProvider {
      * @returns Complete UTXO set with balance breakdown
      */
     getUTXOSet(address: string, minConfirmations: number): Promise<UTXOSet>;
+    /**
+     * Get balance for a Bitcoin address (fast, no UTXO details)
+     *
+     * This method uses the standard Esplora /address/:address endpoint
+     * to get confirmed balance from chain_stats.
+     *
+     * @param address - Bitcoin address
+     * @returns Balance in satoshis (confirmed balance only)
+     * @throws Error if the request fails or response is invalid
+     */
+    getBalance(address: string): Promise<bigint>;
     /**
      * Get transaction with confirmation count
      *

package/pkg-dist/src/modules/bitcoin-data-provider.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitcoin-data-provider.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-data-provider.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACR,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAEpF;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,yBAAyB;IAK7C;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAqDhD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,iBAAiB;IAqB/B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;;OAMG;YACW,sBAAsB;IAkDpC;;;;;;;;;OASG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IAkBnB;;;;;;;;OAQG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CA+E3D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}
+{"version":3,"file":"bitcoin-data-provider.module.d.ts","sourceRoot":"","sources":["../../../src/modules/bitcoin-data-provider.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACR,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAEpF;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,yBAAyB;IAO7C;;;;;OAKG;YACW,qBAAqB;IA+DnC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAqDhD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,iBAAiB;IAqB/B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;;;;OAMG;YACW,sBAAsB;IA2DpC;;;;;;;;;OASG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;IAkBnB;;;;;;;;;OASG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuElD;;;;;;;;OAQG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CA+E3D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}