@bigmi/core 0.2.1 → 0.3.0-beta.0

package/dist/cjs/transports/blockcypher/__mocks__/getUTXOs/valid.json

@@ -0,0 +1,27 @@
+{
+    "address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
+    "total_received": 190653,
+    "total_sent": 157447,
+    "balance": 33206,
+    "unconfirmed_balance": 0,
+    "final_balance": 33206,
+    "n_tx": 19,
+    "unconfirmed_n_tx": 0,
+    "final_n_tx": 19,
+    "txrefs": [
+        {
+            "tx_hash": "4b6ee974f1dd179071d027562e1fd1c83965efa4a171ec84f00b6c638e36fa4e",
+            "block_height": 897002,
+            "tx_input_n": -1,
+            "tx_output_n": 2,
+            "value": 33206,
+            "ref_balance": 80786,
+            "spent": false,
+            "confirmations": 526,
+            "confirmed": "2025-05-16T19:17:40Z",
+            "double_spend": false,
+            "script": "00140b2cfb49a87dbb35f0a2f1c02f2016a441aac7bc"
+        }
+    ],
+    "tx_url": "https://api.blockcypher.com/v1/btc/main/txs/"
+}

package/dist/cjs/transports/blockcypher/blockcypher.d.ts

@@ -0,0 +1,7 @@
+import type { HttpTransportConfig } from '../http.js';
+type BlockcypherConfig = {
+    baseUrl?: string;
+    apiKey?: string;
+} & HttpTransportConfig;
+export declare const blockcypher: (config?: BlockcypherConfig) => import("../http.js").HttpTransport;
+export {};

package/dist/cjs/transports/blockcypher/blockcypher.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockcypher = void 0;
+const utxo_js_1 = require("../utxo.js");
+const blockcypher = (config) => (0, utxo_js_1.utxo)(config?.baseUrl || 'https://api.blockcypher.com/v1/btc/main', {
+    key: 'blockcypher',
+    ...config,
+});
+exports.blockcypher = blockcypher;
+//# sourceMappingURL=blockcypher.js.map

package/dist/cjs/transports/blockcypher/blockcypher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockcypher.js","sourceRoot":"","sources":["../../../../src/transports/blockcypher/blockcypher.ts"],"names":[],"mappings":";;;AACA,wCAAiC;AAO1B,MAAM,WAAW,GAAG,CAAC,MAA0B,EAAE,EAAE,CACxD,IAAA,cAAI,EAAC,MAAM,EAAE,OAAO,IAAI,yCAAyC,EAAE;IACjE,GAAG,EAAE,aAAa;IAClB,GAAG,MAAM;CACV,CAAC,CAAA;AAJS,QAAA,WAAW,eAIpB"}

package/dist/cjs/transports/blockcypher/blockcypher.types.d.ts

@@ -0,0 +1,32 @@
+export type BlockcypherErrorResponse = {
+    error: string;
+};
+export type BlockcypherBalanceResponse = {
+    address: string;
+    total_received: number;
+    total_sent: number;
+    balance: number;
+    unconfirmed_balance: number;
+    final_balance: number;
+    n_tx: number;
+    unconfirmed_n_tx: number;
+    final_n_tx: number;
+    error?: string;
+    hasMore?: boolean;
+};
+export type BlockcypherUTXO = {
+    tx_hash: string;
+    block_height: number;
+    tx_input_n: number;
+    tx_output_n: number;
+    value: number;
+    ref_balance: number;
+    spent: boolean;
+    confirmations: number;
+    confirmed: string;
+    double_spend: boolean;
+    script: string;
+};
+export type BlockcypherUTXOsResponse = BlockcypherBalanceResponse & {
+    txrefs: BlockcypherUTXO[];
+};

package/dist/cjs/transports/blockcypher/blockcypher.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=blockcypher.types.js.map

package/dist/cjs/transports/blockcypher/blockcypher.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockcypher.types.js","sourceRoot":"","sources":["../../../../src/transports/blockcypher/blockcypher.types.ts"],"names":[],"mappings":""}

package/dist/cjs/transports/blockcypher/getBalance.d.ts

@@ -0,0 +1,2 @@
+import type { RpcMethodHandler } from '../types.js';
+export declare const getBalance: RpcMethodHandler<'getBalance'>;

package/dist/cjs/transports/blockcypher/getBalance.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBalance = void 0;
+const url_js_1 = require("../../utils/url.js");
+const getBalance = async (client, { baseUrl, apiKey }, { address }) => {
+    const apiUrl = (0, url_js_1.urlWithParams)(`${baseUrl}/addrs/${address}`, {
+        token: apiKey,
+    });
+    const response = (await client.request({
+        url: apiUrl,
+        fetchOptions: { method: 'GET' },
+    }));
+    if (response.error) {
+        return {
+            error: { code: -1, message: response.error },
+        };
+    }
+    return {
+        result: BigInt(response.balance),
+    };
+};
+exports.getBalance = getBalance;
+//# sourceMappingURL=getBalance.js.map

package/dist/cjs/transports/blockcypher/getBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../../../src/transports/blockcypher/getBalance.ts"],"names":[],"mappings":";;;AAAA,+CAAkD;AAI3C,MAAM,UAAU,GAAmC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,GAAG,OAAO,UAAU,OAAO,EAAE,EAAE;QAC1D,KAAK,EAAE,MAAM;KACd,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM;QACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAChC,CAAC,CAA0C,CAAA;IAC5C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE;SAC7C,CAAA;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;KACjC,CAAA;AACH,CAAC,CAAA;AApBY,QAAA,UAAU,cAoBtB"}

package/dist/cjs/transports/blockcypher/getUTXOs.d.ts

@@ -0,0 +1,2 @@
+import type { RpcMethodHandler } from '../types.js';
+export declare const getUTXOs: RpcMethodHandler<'getUTXOs'>;

package/dist/cjs/transports/blockcypher/getUTXOs.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUTXOs = void 0;
+const request_js_1 = require("../../errors/request.js");
+const utxo_js_1 = require("../../errors/utxo.js");
+const url_js_1 = require("../../utils/url.js");
+const blockchairUTXOTransformer = (utxo) => ({
+    blockHeight: utxo.block_height,
+    isConfirmed: Boolean(utxo.confirmations),
+    confirmations: utxo.confirmations,
+    value: utxo.value,
+    vout: utxo.tx_output_n,
+    txId: utxo.tx_hash,
+    scriptHex: utxo.script,
+});
+const MAX_API_LIMIT = 2000;
+const getUTXOs = async (client, { baseUrl, apiKey }, { address, minValue }) => {
+    async function* fetchUTXOs() {
+        let hasMore = true;
+        let beforeBlock = undefined;
+        while (hasMore) {
+            const apiUrl = (0, url_js_1.urlWithParams)(`${baseUrl}/addrs/${address}`, {
+                token: apiKey,
+                unspentOnly: 'true',
+                includeScript: 'true',
+                before: beforeBlock,
+                limit: MAX_API_LIMIT,
+            });
+            const response = (await client.request({
+                url: apiUrl,
+                fetchOptions: { method: 'GET' },
+            }));
+            if (response.error) {
+                throw new request_js_1.RpcRequestError({
+                    url: apiUrl,
+                    body: {
+                        method: 'fetchUTXOs',
+                        params: {
+                            address,
+                            minValue,
+                        },
+                    },
+                    error: {
+                        code: -1,
+                        message: response.error,
+                    },
+                });
+            }
+            if (minValue && minValue > response.final_balance) {
+                throw new utxo_js_1.InsufficientUTXOBalanceError({
+                    minValue,
+                    address,
+                    balance: response.final_balance,
+                });
+            }
+            if (!response.txrefs || response.txrefs.length === 0) {
+                hasMore = false;
+                continue;
+            }
+            const { hasMore: apiHasMore } = response;
+            hasMore = Boolean(apiHasMore);
+            beforeBlock = response.txrefs[response.txrefs.length - 1].block_height;
+            yield response.txrefs;
+        }
+    }
+    const utxos = [];
+    let valueCount = 0;
+    for await (const batch of fetchUTXOs()) {
+        const utxoBatch = batch.map(blockchairUTXOTransformer);
+        utxos.push(...utxoBatch);
+        if (minValue) {
+            valueCount += utxoBatch.reduce((sum, utxo) => sum + utxo.value, 0);
+            if (valueCount >= minValue) {
+                break;
+            }
+        }
+    }
+    return { result: utxos };
+};
+exports.getUTXOs = getUTXOs;
+//# sourceMappingURL=getUTXOs.js.map

package/dist/cjs/transports/blockcypher/getUTXOs.js.map

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

package/dist/cjs/transports/{blockcypher.d.ts → blockcypher/methods.d.ts}

@@ -1,2 +1,2 @@
-import type { RpcMethods } from './types.js';
+import type { RpcMethods } from '../types.js';
 export declare const blockcypherMethods: RpcMethods;

package/dist/cjs/transports/blockcypher/methods.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockcypherMethods = void 0;
+const getBalance_js_1 = require("./getBalance.js");
+const getUTXOs_js_1 = require("./getUTXOs.js");
+exports.blockcypherMethods = {
+    getBalance: getBalance_js_1.getBalance,
+    getUTXOs: getUTXOs_js_1.getUTXOs,
+};
+//# sourceMappingURL=methods.js.map

package/dist/cjs/transports/blockcypher/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../src/transports/blockcypher/methods.ts"],"names":[],"mappings":";;;AACA,mDAA4C;AAC5C,+CAAwC;AAE3B,QAAA,kBAAkB,GAAe;IAC5C,UAAU,EAAV,0BAAU;IACV,QAAQ,EAAR,sBAAQ;CACT,CAAA"}

package/dist/cjs/transports/getRpcProviderMethods.d.ts

@@ -1,2 +1,4 @@
 import type { RpcMethods } from './types.js';
-export declare function getRpcProviderMethods(key: 'blockchair' | 'ankr' | 'blockcypher' | 'mempool' | string): RpcMethods | null;
+type providers = 'blockchair' | 'ankr' | 'blockcypher' | 'mempool' | string;
+export declare function getRpcProviderMethods(key: providers): RpcMethods | null;
+export {};

package/dist/cjs/transports/getRpcProviderMethods.js

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRpcProviderMethods = getRpcProviderMethods;
-const ankr_js_1 = require("./ankr.js");
-const blockchair_js_1 = require("./blockchair.js");
-const blockcypher_js_1 = require("./blockcypher.js");
-const mempool_js_1 = require("./mempool.js");
+const methods_js_1 = require("./ankr/methods.js");
+const methods_js_2 = require("./blockchair/methods.js");
+const methods_js_3 = require("./blockcypher/methods.js");
+const methods_js_4 = require("./mempool/methods.js");
 function getRpcProviderMethods(key) {
     switch (key) {
         case 'blockchair':
-            return blockchair_js_1.blockchairMethods;
+            return methods_js_2.blockchairMethods;
         case 'ankr':
-            return ankr_js_1.ankrMethods;
+            return methods_js_1.ankrMethods;
         case 'blockcypher':
-            return blockcypher_js_1.blockcypherMethods;
+            return methods_js_3.blockcypherMethods;
         case 'mempool':
-            return mempool_js_1.mempoolMethods;
+            return methods_js_4.mempoolMethods;
         default:
             return null;
     }

package/dist/cjs/transports/getRpcProviderMethods.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRpcProviderMethods.js","sourceRoot":"","sources":["../../../src/transports/getRpcProviderMethods.ts"],"names":[],"mappings":";;AAMA,sDAeC;AArBD,uCAAuC;AACvC,mDAAmD;AACnD,qDAAqD;AACrD,6CAA6C;AAG7C,SAAgB,qBAAqB,CACnC,GAA+D;IAE/D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,YAAY;YACf,OAAO,iCAAiB,CAAA;QAC1B,KAAK,MAAM;YACT,OAAO,qBAAW,CAAA;QACpB,KAAK,aAAa;YAChB,OAAO,mCAAkB,CAAA;QAC3B,KAAK,SAAS;YACZ,OAAO,2BAAc,CAAA;QACvB;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"getRpcProviderMethods.js","sourceRoot":"","sources":["../../../src/transports/getRpcProviderMethods.ts"],"names":[],"mappings":";;AAQA,sDAaC;AArBD,kDAA+C;AAC/C,wDAA2D;AAC3D,yDAA6D;AAC7D,qDAAqD;AAKrD,SAAgB,qBAAqB,CAAC,GAAc;IAClD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,YAAY;YACf,OAAO,8BAAiB,CAAA;QAC1B,KAAK,MAAM;YACT,OAAO,wBAAW,CAAA;QACpB,KAAK,aAAa;YAChB,OAAO,+BAAkB,CAAA;QAC3B,KAAK,SAAS;YACZ,OAAO,2BAAc,CAAA;QACvB;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC"}

package/dist/cjs/transports/mempool/__mocks__/getBalance/invalid.json

@@ -0,0 +1 @@
+"Invalid Bitcoin address"

package/dist/cjs/transports/mempool/__mocks__/getBalance/valid.json

@@ -0,0 +1,17 @@
+{
+    "address": "bc1qpvk0kjdg0kantu9z78qz7gqk53q643auz33yaw",
+    "chain_stats": {
+        "funded_txo_count": 18,
+        "funded_txo_sum": 424052,
+        "spent_txo_count": 17,
+        "spent_txo_sum": 390846,
+        "tx_count": 19
+    },
+    "mempool_stats": {
+        "funded_txo_count": 0,
+        "funded_txo_sum": 0,
+        "spent_txo_count": 0,
+        "spent_txo_sum": 0,
+        "tx_count": 0
+    }
+}