@bopen-io/wallet-toolbox 1.7.18 → 1.7.19

package/out/src/services/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Services"), exports);
+//# sourceMappingURL=index.js.map

package/out/src/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA0B"}

package/out/src/services/providers/ARC.d.ts

@@ -0,0 +1,92 @@
+import { Beef, HexString, HttpClient } from '@bsv/sdk';
+import { PostBeefResult, PostTxResultForTxid } from '../../sdk/WalletServices.interfaces';
+/** Configuration options for the ARC broadcaster. */
+export interface ArcConfig {
+    /** Authentication token for the ARC API */
+    apiKey?: string;
+    /** The HTTP client used to make requests to the ARC API. */
+    httpClient?: HttpClient;
+    /** Deployment id used annotating api calls in XDeployment-ID header - this value will be randomly generated if not set */
+    deploymentId?: string;
+    /** notification callback endpoint for proofs and double spend notification */
+    callbackUrl?: string;
+    /** default access token for notification callback endpoint. It will be used as a Authorization header for the http callback */
+    callbackToken?: string;
+    /** additional headers to be attached to all tx submissions. */
+    headers?: Record<string, string>;
+}
+/**
+ * Represents an ARC transaction broadcaster.
+ */
+export declare class ARC {
+    readonly name: string;
+    readonly URL: string;
+    readonly apiKey: string | undefined;
+    readonly deploymentId: string;
+    readonly callbackUrl: string | undefined;
+    readonly callbackToken: string | undefined;
+    readonly headers: Record<string, string> | undefined;
+    private readonly httpClient;
+    /**
+     * Constructs an instance of the ARC broadcaster.
+     *
+     * @param {string} URL - The URL endpoint for the ARC API.
+     * @param {ArcConfig} config - Configuration options for the ARC broadcaster.
+     */
+    constructor(URL: string, config?: ArcConfig, name?: string);
+    /**
+     * Constructs an instance of the ARC broadcaster.
+     *
+     * @param {string} URL - The URL endpoint for the ARC API.
+     * @param {string} apiKey - The API key used for authorization with the ARC API.
+     */
+    constructor(URL: string, apiKey?: string, name?: string);
+    /**
+     * Constructs a dictionary of the default & supplied request headers.
+     */
+    private requestHeaders;
+    /**
+     * The ARC '/v1/tx' endpoint, as of 2025-02-17 supports all of the following hex string formats:
+     *   1. Single serialized raw transaction.
+     *   2. Single EF serialized raw transaction (untested).
+     *   3. V1 serialized Beef (results returned reflect only the last transaction in the beef)
+     *
+     * The ARC '/v1/tx' endpoint, as of 2025-02-17 DOES NOT support the following hex string formats:
+     *   1. V2 serialized Beef
+     *
+     * @param rawTx
+     * @param txids
+     * @returns
+     */
+    postRawTx(rawTx: HexString, txids?: string[]): Promise<PostTxResultForTxid>;
+    /**
+     * ARC does not natively support a postBeef end-point aware of multiple txids of interest in the Beef.
+     *
+     * It does process multiple new transactions, however, which allows results for all txids of interest
+     * to be collected by the `/v1/tx/${txid}` endpoint.
+     *
+     * @param beef
+     * @param txids
+     * @returns
+     */
+    postBeef(beef: Beef, txids: string[]): Promise<PostBeefResult>;
+    /**
+     * This seems to only work for recently submitted txids...but that's all we need to complete postBeef!
+     * @param txid
+     * @returns
+     */
+    getTxData(txid: string): Promise<ArcMinerGetTxData>;
+}
+export interface ArcMinerGetTxData {
+    status: number;
+    title: string;
+    blockHash: string;
+    blockHeight: number;
+    competingTxs: null | string[];
+    extraInfo: string;
+    merklePath: string;
+    timestamp: string;
+    txid: string;
+    txStatus: string;
+}
+//# sourceMappingURL=ARC.d.ts.map

package/out/src/services/providers/ARC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ARC.d.ts","sourceRoot":"","sources":["../../../../src/services/providers/ARC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAIJ,SAAS,EACT,UAAU,EAIX,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAA4B,MAAM,qCAAqC,CAAA;AAKnH,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,0HAA0H;IAC1H,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+HAA+H;IAC/H,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAMD;;GAEG;AACH,qBAAa,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IAEvC;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM;IAC1D;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAuBvD;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4GjF;;;;;;;;;OASG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAoEpE;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAU1D;AASD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,IAAI,GAAG,MAAM,EAAE,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/out/src/services/providers/ARC.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARC = void 0;
+const sdk_1 = require("@bsv/sdk");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const WalletError_1 = require("../../sdk/WalletError");
+function defaultDeploymentId() {
+    return `ts-sdk-${sdk_1.Utils.toHex((0, sdk_1.Random)(16))}`;
+}
+/**
+ * Represents an ARC transaction broadcaster.
+ */
+class ARC {
+    constructor(URL, config, name) {
+        this.name = name !== null && name !== void 0 ? name : 'ARC';
+        this.URL = URL;
+        if (typeof config === 'string') {
+            this.apiKey = config;
+            this.httpClient = (0, sdk_1.defaultHttpClient)();
+            this.deploymentId = defaultDeploymentId();
+            this.callbackToken = undefined;
+            this.callbackUrl = undefined;
+        }
+        else {
+            const configObj = config !== null && config !== void 0 ? config : {};
+            const { apiKey, deploymentId, httpClient, callbackToken, callbackUrl, headers } = configObj;
+            this.apiKey = apiKey;
+            this.httpClient = httpClient !== null && httpClient !== void 0 ? httpClient : (0, sdk_1.defaultHttpClient)();
+            this.deploymentId = deploymentId !== null && deploymentId !== void 0 ? deploymentId : defaultDeploymentId();
+            this.callbackToken = callbackToken;
+            this.callbackUrl = callbackUrl;
+            this.headers = headers;
+        }
+    }
+    /**
+     * Constructs a dictionary of the default & supplied request headers.
+     */
+    requestHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            'XDeployment-ID': this.deploymentId
+        };
+        if (this.apiKey != null && this.apiKey !== '') {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        }
+        if (this.callbackUrl != null && this.callbackUrl !== '') {
+            headers['X-CallbackUrl'] = this.callbackUrl;
+        }
+        if (this.callbackToken != null && this.callbackToken !== '') {
+            headers['X-CallbackToken'] = this.callbackToken;
+        }
+        if (this.headers != null) {
+            for (const key in this.headers) {
+                headers[key] = this.headers[key];
+            }
+        }
+        return headers;
+    }
+    /**
+     * The ARC '/v1/tx' endpoint, as of 2025-02-17 supports all of the following hex string formats:
+     *   1. Single serialized raw transaction.
+     *   2. Single EF serialized raw transaction (untested).
+     *   3. V1 serialized Beef (results returned reflect only the last transaction in the beef)
+     *
+     * The ARC '/v1/tx' endpoint, as of 2025-02-17 DOES NOT support the following hex string formats:
+     *   1. V2 serialized Beef
+     *
+     * @param rawTx
+     * @param txids
+     * @returns
+     */
+    async postRawTx(rawTx, txids) {
+        let txid = sdk_1.Utils.toHex((0, utilityHelpers_1.doubleSha256BE)(sdk_1.Utils.toArray(rawTx, 'hex')));
+        if (txids) {
+            txid = txids.slice(-1)[0];
+        }
+        else {
+            txids = [txid];
+        }
+        const requestOptions = {
+            method: 'POST',
+            headers: this.requestHeaders(),
+            data: { rawTx },
+            signal: AbortSignal.timeout(1000 * 30) // 30 seconds timeout, error.code will be 'ABORT_ERR'
+        };
+        const r = {
+            txid,
+            status: 'success',
+            notes: []
+        };
+        const url = `${this.URL}/v1/tx`;
+        const nn = () => ({ name: this.name, when: new Date().toISOString() });
+        const nne = () => ({ ...nn(), rawTx, txids: txids.join(','), url });
+        try {
+            const response = await this.httpClient.request(url, requestOptions);
+            const { txid, extraInfo, txStatus, competingTxs } = response.data;
+            const nnr = () => ({
+                txid,
+                extraInfo,
+                txStatus,
+                competingTxs: competingTxs === null || competingTxs === void 0 ? void 0 : competingTxs.join(',')
+            });
+            if (response.ok) {
+                r.data = `${txStatus} ${extraInfo}`;
+                if (r.txid !== txid)
+                    r.data += ` txid altered from ${r.txid} to ${txid}`;
+                r.txid = txid;
+                if (txStatus === 'DOUBLE_SPEND_ATTEMPTED' || txStatus === 'SEEN_IN_ORPHAN_MEMPOOL') {
+                    r.status = 'error';
+                    r.doubleSpend = true;
+                    r.competingTxs = competingTxs;
+                    r.notes.push({ ...nne(), ...nnr(), what: 'postRawTxDoubleSpend' });
+                }
+                else {
+                    r.notes.push({ ...nn(), ...nnr(), what: 'postRawTxSuccess' });
+                }
+            }
+            else if (typeof response === 'string') {
+                r.notes.push({ ...nne(), what: 'postRawTxString', response });
+                r.status = 'error';
+                // response is not normally a string
+                r.serviceError = true;
+            }
+            else {
+                r.status = 'error';
+                // Treat unknown errors as service errors
+                r.serviceError = true;
+                const n = {
+                    ...nn(),
+                    ...nne(),
+                    ...nnr(),
+                    what: 'postRawTxError'
+                };
+                const ed = {};
+                r.data = ed;
+                const st = typeof response.status;
+                if (st === 'number' || st === 'string') {
+                    n.status = response.status;
+                    ed.status = response.status.toString();
+                }
+                else {
+                    n.status = st;
+                    ed.status = 'ERR_UNKNOWN';
+                }
+                let d = response.data;
+                if (d && typeof d === 'string') {
+                    n.data = response.data.slice(0, 128);
+                    try {
+                        d = JSON.parse(d);
+                    }
+                    catch (_a) {
+                        // Intentionally left empty
+                    }
+                }
+                else if (d && typeof d === 'object') {
+                    ed.more = d;
+                    ed.detail = d['detail'];
+                    if (typeof ed.detail !== 'string')
+                        ed.detail = undefined;
+                    if (ed.detail) {
+                        n.detail = ed.detail;
+                    }
+                }
+                r.notes.push(n);
+            }
+        }
+        catch (eu) {
+            const e = WalletError_1.WalletError.fromUnknown(eu);
+            r.status = 'error';
+            r.serviceError = true;
+            r.data = `${e.code} ${e.message}`;
+            r.notes.push({
+                ...nne(),
+                what: 'postRawTxCatch',
+                code: e.code,
+                description: e.description
+            });
+        }
+        return r;
+    }
+    /**
+     * ARC does not natively support a postBeef end-point aware of multiple txids of interest in the Beef.
+     *
+     * It does process multiple new transactions, however, which allows results for all txids of interest
+     * to be collected by the `/v1/tx/${txid}` endpoint.
+     *
+     * @param beef
+     * @param txids
+     * @returns
+     */
+    async postBeef(beef, txids) {
+        const r = {
+            name: this.name,
+            status: 'success',
+            txidResults: [],
+            notes: []
+        };
+        const nn = () => ({ name: this.name, when: new Date().toISOString() });
+        if (beef.version === sdk_1.BEEF_V2 && beef.txs.every(btx => !btx.isTxidOnly)) {
+            beef.version = sdk_1.BEEF_V1;
+            r.notes.push({ ...nn(), what: 'postBeefV2ToV1' });
+        }
+        const beefHex = beef.toHex();
+        const prtr = await this.postRawTx(beefHex, txids);
+        r.status = prtr.status;
+        r.txidResults = [prtr];
+        // Since postRawTx only returns results for a single txid,
+        // replicate the basic results any additional txids.
+        // TODO: Temporary hack...
+        for (const txid of txids) {
+            if (prtr.txid === txid)
+                continue;
+            const tr = {
+                txid,
+                status: 'success',
+                notes: []
+            };
+            // For the extra txids, go back to the service for confirmation...
+            const dr = await this.getTxData(txid);
+            if (dr.txid !== txid) {
+                tr.status = 'error';
+                tr.data = 'internal error';
+                tr.notes.push({
+                    ...nn(),
+                    what: 'postBeefGetTxDataInternal',
+                    txid,
+                    returnedTxid: dr.txid
+                });
+            }
+            else if (dr.txStatus === 'SEEN_ON_NETWORK' || dr.txStatus === 'STORED') {
+                tr.data = dr.txStatus;
+                tr.notes.push({
+                    ...nn(),
+                    what: 'postBeefGetTxDataSuccess',
+                    txid,
+                    txStatus: dr.txStatus
+                });
+            }
+            else {
+                tr.status = 'error';
+                tr.data = dr;
+                tr.notes.push({
+                    ...nn(),
+                    what: 'postBeefGetTxDataError',
+                    txid,
+                    txStatus: dr.txStatus
+                });
+            }
+            r.txidResults.push(tr);
+            if (r.status === 'success' && tr.status === 'error')
+                r.status = 'error';
+        }
+        return r;
+    }
+    /**
+     * This seems to only work for recently submitted txids...but that's all we need to complete postBeef!
+     * @param txid
+     * @returns
+     */
+    async getTxData(txid) {
+        const requestOptions = {
+            method: 'GET',
+            headers: this.requestHeaders()
+        };
+        const response = await this.httpClient.request(`${this.URL}/v1/tx/${txid}`, requestOptions);
+        return response.data;
+    }
+}
+exports.ARC = ARC;
+//# sourceMappingURL=ARC.js.map

package/out/src/services/providers/ARC.js.map

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

package/out/src/services/providers/Bitails.d.ts

@@ -0,0 +1,50 @@
+import { Beef, HexString, HttpClient } from '@bsv/sdk';
+import { Chain } from '../../sdk/types';
+import { GetMerklePathResult, PostBeefResult, WalletServices } from '../../sdk/WalletServices.interfaces';
+export interface BitailsConfig {
+    /** Authentication token for BitTails API */
+    apiKey?: string;
+    /** The HTTP client used to make requests to the API. */
+    httpClient?: HttpClient;
+}
+/**
+ *
+ */
+export declare class Bitails {
+    readonly chain: Chain;
+    readonly apiKey: string;
+    readonly URL: string;
+    readonly httpClient: HttpClient;
+    constructor(chain?: Chain, config?: BitailsConfig);
+    getHttpHeaders(): Record<string, string>;
+    /**
+     * Bitails does not natively support a postBeef end-point aware of multiple txids of interest in the Beef.
+     *
+     * Send rawTx in `txids` order from beef.
+     *
+     * @param beef
+     * @param txids
+     * @returns
+     */
+    postBeef(beef: Beef, txids: string[]): Promise<PostBeefResult>;
+    /**
+     * @param raws Array of raw transactions to broadcast as hex strings
+     * @param txids Array of txids for transactions in raws for which results are requested, remaining raws are supporting only.
+     * @returns
+     */
+    postRaws(raws: HexString[], txids?: string[]): Promise<PostBeefResult>;
+    /**
+     *
+     * @param txid
+     * @param services
+     * @returns
+     */
+    getMerklePath(txid: string, services: WalletServices): Promise<GetMerklePathResult>;
+}
+export interface BitailsMerkleProof {
+    index: number;
+    txOrId: string;
+    target: string;
+    nodes: string[];
+}
+//# sourceMappingURL=Bitails.d.ts.map

package/out/src/services/providers/Bitails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bitails.d.ts","sourceRoot":"","sources":["../../../../src/services/providers/Bitails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAqB,SAAS,EAAE,UAAU,EAAS,MAAM,UAAU,CAAA;AAChF,OAAO,EAAE,KAAK,EAAkB,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAKzG,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;gBAEnB,KAAK,GAAE,KAAc,EAAE,MAAM,GAAE,aAAkB;IAQ7D,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAYxC;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAwBpE;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAgH5E;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAyC1F;AAUD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB"}