@bopen-io/wallet-toolbox 2.1.21-parity-fix.2 → 2.6.2-brc153.2

package/out/src/services/createDefaultWalletServicesOptions.js

@@ -1,21 +1,60 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultChaintracksClient = createDefaultChaintracksClient;
 exports.createDefaultWalletServicesOptions = createDefaultWalletServicesOptions;
+exports.arcadeDefaultUrl = arcadeDefaultUrl;
 exports.arcDefaultUrl = arcDefaultUrl;
 exports.arcGorillaPoolUrl = arcGorillaPoolUrl;
 const utilityHelpers_1 = require("../utility/utilityHelpers");
 const ChaintracksServiceClient_1 = require("./chaintracker/chaintracks/ChaintracksServiceClient");
-function createDefaultWalletServicesOptions(chain, arcCallbackUrl, arcCallbackToken, taalArcApiKey, gorillaPoolArcApiKey, bitailsApiKey, deploymentId, chaintracks) {
+const GoChaintracksServiceClient_1 = require("./chaintracker/chaintracks/GoChaintracksServiceClient");
+const networkConfig_1 = require("./networkConfig");
+function stripTrailingSlash(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/')
+        end--;
+    return value.slice(0, end);
+}
+function configuredChaintracksClient(chain, serviceUrl) {
+    let path = '';
+    try {
+        path = stripTrailingSlash(new URL(serviceUrl).pathname);
+    }
+    catch {
+        // Preserve the legacy client's existing validation/error behavior for an
+        // operator-supplied non-URL value.
+    }
+    if (path.endsWith('/v2'))
+        return new GoChaintracksServiceClient_1.GoChaintracksServiceClient(chain, serviceUrl);
+    return new ChaintracksServiceClient_1.ChaintracksServiceClient(chain, serviceUrl);
+}
+/**
+ * Returns the credential-free default ChainTracks client for a supported
+ * public network, or an operator-configured client for stn/tstn.
+ */
+function createDefaultChaintracksClient(chain) {
+    switch (chain) {
+        case 'main':
+        case 'test':
+        case 'ttn':
+            return new GoChaintracksServiceClient_1.GoChaintracksServiceClient(chain, arcadeDefaultUrl(chain), {
+                apiPrefix: '/chaintracks/v2'
+            });
+        case 'stn':
+            return configuredChaintracksClient(chain, (0, networkConfig_1.stnChaintracksUrl)());
+        case 'tstn':
+            return configuredChaintracksClient(chain, (0, networkConfig_1.tstnChaintracksUrl)());
+    }
+}
+function createDefaultWalletServicesOptions(...[chain, arcCallbackUrl, arcCallbackToken, taalArcApiKey, gorillaPoolArcApiKey, bitailsApiKey, deploymentId, chaintracks, arcadeUrl, arcadeApiKey, arcadeCallbackToken]) {
     if (chain === 'mock') {
-        throw new Error(`createDefaultWalletServicesOptions does not support 'mock' chain. Use MockServices directly.`);
+        throw new Error("createDefaultWalletServicesOptions does not support 'mock' chain. Use MockServices directly.");
     }
-    deploymentId || (deploymentId = `wallet-toolbox-${(0, utilityHelpers_1.randomBytesHex)(16)}`);
-    //const chaintracksUrl = `https://npm-registry.babbage.systems:${chain === 'main' ? 8084 : 8083}`
-    const chaintracksUrl = `https://${chain}net-chaintracks.babbage.systems`;
+    deploymentId ||= `wallet-toolbox-${(0, utilityHelpers_1.randomBytesHex)(16)}`;
     // The mainnet endpoint is always used since these are fiat exchange rates,
     // independent of the chain being used.
-    const chaintracksFiatExchangeRatesUrl = `https://mainnet-chaintracks.babbage.systems/getFiatExchangeRates`;
-    chaintracks || (chaintracks = new ChaintracksServiceClient_1.ChaintracksServiceClient(chain, chaintracksUrl));
+    const chaintracksFiatExchangeRatesUrl = 'https://mainnet-chaintracks.babbage.systems/getFiatExchangeRates';
+    chaintracks ||= createDefaultChaintracksClient(chain);
     const o = {
         chain,
         taalApiKey: undefined,
@@ -46,30 +85,70 @@ function createDefaultWalletServicesOptions(chain, arcCallbackUrl, arcCallbackTo
         chaintracks,
         arcUrl: arcDefaultUrl(chain),
         arcConfig: {
-            apiKey: taalArcApiKey !== null && taalArcApiKey !== void 0 ? taalArcApiKey : undefined,
+            apiKey: taalArcApiKey ?? undefined,
             deploymentId,
-            callbackUrl: arcCallbackUrl !== null && arcCallbackUrl !== void 0 ? arcCallbackUrl : undefined,
-            callbackToken: arcCallbackToken !== null && arcCallbackToken !== void 0 ? arcCallbackToken : undefined
+            callbackUrl: arcCallbackUrl ?? undefined,
+            callbackToken: arcCallbackToken ?? undefined
         },
         arcGorillaPoolUrl: arcGorillaPoolUrl(chain),
         arcGorillaPoolConfig: {
-            apiKey: gorillaPoolArcApiKey !== null && gorillaPoolArcApiKey !== void 0 ? gorillaPoolArcApiKey : undefined,
+            apiKey: gorillaPoolArcApiKey ?? undefined,
             deploymentId,
-            callbackUrl: arcCallbackUrl !== null && arcCallbackUrl !== void 0 ? arcCallbackUrl : undefined,
-            callbackToken: arcCallbackToken !== null && arcCallbackToken !== void 0 ? arcCallbackToken : undefined
+            callbackUrl: arcCallbackUrl ?? undefined,
+            callbackToken: arcCallbackToken ?? undefined
         },
         bitailsApiKey
     };
+    // Arcade (bsv-blockchain/arcade) primary broadcaster.
+    // Opt-in: enabled only when an explicit `arcadeUrl` is provided. Callers can pass
+    // `arcadeDefaultUrl(chain)` to use the known per-chain endpoint. Kept opt-in (rather
+    // than defaulted on) so existing consumers' broadcaster set is unchanged until the
+    // Arcade path has been validated end-to-end; flipping the default is a one-line change.
+    const resolvedArcadeUrl = arcadeUrl;
+    if (resolvedArcadeUrl != null && resolvedArcadeUrl !== '') {
+        o.arcadeUrl = resolvedArcadeUrl;
+        o.arcadeConfig = {
+            apiKey: arcadeApiKey ?? undefined,
+            deploymentId,
+            // SSE (pull) flow: token scopes the /events subscription; no webhook callbackUrl
+            // (Arcade rejects private/loopback URLs). Must match Monitor.options.callbackToken.
+            callbackToken: arcadeCallbackToken ?? arcCallbackToken ?? undefined
+        };
+    }
     return o;
 }
+/**
+ * Default Arcade (bsv-blockchain/arcade) endpoint per chain.
+ * Returns undefined when no public default is known for the chain.
+ */
+function arcadeDefaultUrl(chain) {
+    switch (chain) {
+        case 'main':
+        case 'test':
+        case 'ttn':
+            return (0, networkConfig_1.publicArcadeUrl)(chain);
+        case 'stn':
+            return (0, networkConfig_1.stnArcadeUrl)();
+        case 'tstn':
+            // Private per-deployment endpoint supplied via TSTN_ARCADE_URL (undefined when unset).
+            return (0, networkConfig_1.tstnArcadeUrl)();
+        case 'mock':
+            return undefined;
+    }
+}
 function arcDefaultUrl(chain) {
     switch (chain) {
         case 'main':
             return 'https://arc.taal.com';
         case 'test':
             return 'https://arc-test.taal.com';
-        case 'teratest':
-            return 'https://arc-teratest.taal.com';
+        case 'stn':
+            return (0, networkConfig_1.stnArcadeUrl)() ?? '';
+        case 'ttn':
+            return 'https://arcade-v2-ttn-us-1.bsvblockchain.tech/';
+        case 'tstn':
+            // Private per-deployment endpoint supplied via TSTN_ARCADE_URL ('' when unset).
+            return (0, networkConfig_1.tstnArcadeUrl)() ?? '';
         case 'mock':
             return '';
     }

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

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

package/out/src/services/networkConfig.d.ts

@@ -0,0 +1,18 @@
+import { Chain } from '../sdk/types';
+/** Credential-free public Arcade host for supported networks. */
+export declare function publicArcadeUrl(chain: Chain): string | undefined;
+/** Arcade broadcaster / ARC endpoint for tstn, or `undefined` when `TSTN_ARCADE_URL` is unset. */
+export declare function tstnArcadeUrl(): string | undefined;
+/** Arcade broadcaster / ARC endpoint for stn, or `undefined` when unset. */
+export declare function stnArcadeUrl(): string | undefined;
+/**
+ * ChainTracks service URL for tstn. Falls back to `${TSTN_ARCADE_URL}/chaintracks/v1` when
+ * `TSTN_CHAINTRACKS_URL` is unset (mirrors the ttn layout). Throws when neither is configured.
+ */
+export declare function tstnChaintracksUrl(): string;
+/**
+ * ChainTracks service URL for stn. Falls back to the configured Arcade host's
+ * legacy-compatible path when STN_CHAINTRACKS_URL is unset.
+ */
+export declare function stnChaintracksUrl(): string;
+//# sourceMappingURL=networkConfig.d.ts.map

package/out/src/services/networkConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkConfig.d.ts","sourceRoot":"","sources":["../../../src/services/networkConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAiCpC,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAahE;AAQD,kGAAkG;AAClG,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C"}

package/out/src/services/networkConfig.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicArcadeUrl = publicArcadeUrl;
+exports.tstnArcadeUrl = tstnArcadeUrl;
+exports.stnArcadeUrl = stnArcadeUrl;
+exports.tstnChaintracksUrl = tstnChaintracksUrl;
+exports.stnChaintracksUrl = stnChaintracksUrl;
+/**
+ * Runtime service-endpoint configuration for Teranode networks that do not
+ * have a public, operator-independent service endpoint.
+ *
+ * Unlike `main`, `test`, and `ttn`, the stn/tstn service endpoints are not public and must not be
+ * hardcoded in this (public) source tree. They are supplied at runtime through environment
+ * variables:
+ *
+ *   STN_ARCADE_URL        STN Arcade broadcaster / ARC endpoint base.
+ *   STN_CHAINTRACKS_URL   STN ChainTracks service URL.
+ *   TSTN_ARCADE_URL       Arcade broadcaster / ARC endpoint base. Also the fallback host for
+ *                         ChainTracks when TSTN_CHAINTRACKS_URL is unset
+ *                         (`${TSTN_ARCADE_URL}/chaintracks/v1`, mirroring the ttn layout).
+ *   TSTN_CHAINTRACKS_URL  ChainTracks service URL.
+ *
+ * stn/tstn run only operator-configured Arcade and ChainTracks services; there is no
+ * documented WhatsOnChain service for them, so no WhatsOnChain endpoint is configured and
+ * the WhatsOnChain-only lookups (raw tx, utxo status, txid status, script-hash history) are not
+ * available on stn/tstn.
+ *
+ * `process` is accessed defensively so importing this module remains safe in
+ * browser bundles. Browser applications can still supply an explicit
+ * ChaintracksClientApi without relying on environment variables.
+ */
+function readEnv(name) {
+    const env = typeof process !== 'undefined' ? process.env : undefined;
+    const value = env?.[name];
+    return value != null && value.trim() !== '' ? value.trim() : undefined;
+}
+/** Credential-free public Arcade host for supported networks. */
+function publicArcadeUrl(chain) {
+    switch (chain) {
+        case 'main':
+            return 'https://arcade-v2-us-1.bsvblockchain.tech';
+        case 'test':
+            return 'https://arcade-v2-testnet-us-1.bsvblockchain.tech';
+        case 'ttn':
+            return 'https://arcade-v2-ttn-us-1.bsvblockchain.tech';
+        case 'stn':
+        case 'tstn':
+        case 'mock':
+            return undefined;
+    }
+}
+const stripTrailingSlash = (url) => {
+    let end = url.length;
+    while (end > 0 && url[end - 1] === '/')
+        end--;
+    return url.slice(0, end);
+};
+/** Arcade broadcaster / ARC endpoint for tstn, or `undefined` when `TSTN_ARCADE_URL` is unset. */
+function tstnArcadeUrl() {
+    return readEnv('TSTN_ARCADE_URL');
+}
+/** Arcade broadcaster / ARC endpoint for stn, or `undefined` when unset. */
+function stnArcadeUrl() {
+    return readEnv('STN_ARCADE_URL');
+}
+/**
+ * ChainTracks service URL for tstn. Falls back to `${TSTN_ARCADE_URL}/chaintracks/v1` when
+ * `TSTN_CHAINTRACKS_URL` is unset (mirrors the ttn layout). Throws when neither is configured.
+ */
+function tstnChaintracksUrl() {
+    const explicit = readEnv('TSTN_CHAINTRACKS_URL');
+    if (explicit != null)
+        return explicit;
+    const arcade = tstnArcadeUrl();
+    if (arcade != null)
+        return `${stripTrailingSlash(arcade)}/chaintracks/v1`;
+    throw new Error('tstn chain requires a ChainTracks URL: set TSTN_CHAINTRACKS_URL (or TSTN_ARCADE_URL) in the environment.');
+}
+/**
+ * ChainTracks service URL for stn. Falls back to the configured Arcade host's
+ * legacy-compatible path when STN_CHAINTRACKS_URL is unset.
+ */
+function stnChaintracksUrl() {
+    const explicit = readEnv('STN_CHAINTRACKS_URL');
+    if (explicit != null)
+        return explicit;
+    const arcade = stnArcadeUrl();
+    if (arcade != null)
+        return `${stripTrailingSlash(arcade)}/chaintracks/v1`;
+    throw new Error('stn chain requires a ChainTracks URL: set STN_CHAINTRACKS_URL (or STN_ARCADE_URL) in the environment.');
+}
+//# sourceMappingURL=networkConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networkConfig.js","sourceRoot":"","sources":["../../../src/services/networkConfig.ts"],"names":[],"mappings":";;;;;;;AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;IACpE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACzB,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACxE,CAAC;AAED,iEAAiE;AACjE,yBAAgC,KAAY;IAC1C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,2CAA2C,CAAA;QACpD,KAAK,MAAM;YACT,OAAO,mDAAmD,CAAA;QAC5D,KAAK,KAAK;YACR,OAAO,+CAA+C,CAAA;QACxD,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;IACjD,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;IACpB,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,EAAE,CAAA;IAC7C,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,kGAAkG;AAClG;IACE,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAA;AACnC,CAAC;AAED,4EAA4E;AAC5E;IACE,OAAO,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH;IACE,MAAM,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAChD,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAA;IACrC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAC9B,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,iBAAiB,CAAA;IACzE,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAA;AACH,CAAC;AAED;;;GAGG;AACH;IACE,MAAM,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC/C,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAA;IACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,iBAAiB,CAAA;IACzE,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAA;AACH,CAAC"}

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

@@ -15,6 +15,10 @@ export interface ArcConfig {
     /** additional headers to be attached to all tx submissions. */
     headers?: Record<string, string>;
 }
+export declare function isArcAcceptedTxStatus(txStatus: string | undefined): boolean;
+export declare function isArcDoubleSpendTxStatus(txStatus: string | undefined): boolean;
+export declare function isArcInvalidTxStatus(txStatus: string | undefined): boolean;
+export declare function isArcServiceErrorStatus(status: number | undefined, detail?: string): boolean;
 /**
  * Represents an ARC transaction broadcaster.
  */
@@ -45,6 +49,10 @@ export declare class ARC {
      * Constructs a dictionary of the default & supplied request headers.
      */
     private requestHeaders;
+    private applySuccessfulPostRawTx;
+    private applyFailedPostRawTx;
+    private applyPostRawTxResponse;
+    private applyPostRawTxCatch;
     /**
      * The ARC '/v1/tx' endpoint, as of 2025-02-17 supports all of the following hex string formats:
      *   1. Single serialized raw transaction.

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

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

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

@@ -1,18 +1,74 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ARC = void 0;
+exports.isArcAcceptedTxStatus = isArcAcceptedTxStatus;
+exports.isArcDoubleSpendTxStatus = isArcDoubleSpendTxStatus;
+exports.isArcInvalidTxStatus = isArcInvalidTxStatus;
+exports.isArcServiceErrorStatus = isArcServiceErrorStatus;
 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))}`;
 }
+const arcAcceptedTxStatuses = new Set([
+    'RECEIVED',
+    'SENT_TO_NETWORK',
+    'ANNOUNCED_TO_NETWORK',
+    'ACCEPTED_BY_NETWORK',
+    'SEEN_ON_NETWORK',
+    'STORED',
+    'MINED',
+    'IMMUTABLE'
+]);
+const arcDoubleSpendTxStatuses = new Set([
+    'DOUBLE_SPEND_ATTEMPTED',
+    'SEEN_IN_ORPHAN_MEMPOOL'
+]);
+const arcInvalidTxStatuses = new Set([
+    'INVALID',
+    'MALFORMED',
+    'REJECTED'
+]);
+function isArcAcceptedTxStatus(txStatus) {
+    return txStatus != null && arcAcceptedTxStatuses.has(txStatus);
+}
+function isArcDoubleSpendTxStatus(txStatus) {
+    return txStatus != null && arcDoubleSpendTxStatuses.has(txStatus);
+}
+function isArcInvalidTxStatus(txStatus) {
+    return txStatus != null && arcInvalidTxStatuses.has(txStatus);
+}
+function isArcServiceErrorStatus(status, detail) {
+    if (status == null)
+        return true;
+    if (status === 408 || status === 429 || status === 476 || status >= 500)
+        return true;
+    if (detail == null)
+        return false;
+    const d = detail.toLowerCase();
+    return d.includes('maximum batch size') ||
+        d.includes('too many requests') ||
+        d.includes('rate limit') ||
+        d.includes('timeout') ||
+        d.includes('temporarily') ||
+        d.includes('backpressure') ||
+        d.includes('unavailable');
+}
 /**
  * Represents an ARC transaction broadcaster.
  */
 class ARC {
+    name;
+    URL;
+    apiKey;
+    deploymentId;
+    callbackUrl;
+    callbackToken;
+    headers;
+    httpClient;
     constructor(URL, config, name) {
-        this.name = name !== null && name !== void 0 ? name : 'ARC';
+        this.name = name ?? 'ARC';
         this.URL = URL;
         if (typeof config === 'string') {
             this.apiKey = config;
@@ -22,11 +78,11 @@ class ARC {
             this.callbackUrl = undefined;
         }
         else {
-            const configObj = config !== null && config !== void 0 ? config : {};
+            const configObj = 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.httpClient = httpClient ?? (0, sdk_1.defaultHttpClient)();
+            this.deploymentId = deploymentId ?? defaultDeploymentId();
             this.callbackToken = callbackToken;
             this.callbackUrl = callbackUrl;
             this.headers = headers;
@@ -56,6 +112,90 @@ class ARC {
         }
         return headers;
     }
+    applySuccessfulPostRawTx(result, data, notes) {
+        const { txid, extraInfo, txStatus, competingTxs } = data;
+        result.data = `${txStatus} ${extraInfo}`;
+        if (result.txid !== txid)
+            result.data += ` txid altered from ${result.txid} to ${txid}`;
+        result.txid = txid;
+        const responseNote = {
+            txid,
+            extraInfo,
+            txStatus,
+            competingTxs: competingTxs?.join(',')
+        };
+        if (isArcDoubleSpendTxStatus(txStatus)) {
+            result.status = 'error';
+            result.doubleSpend = true;
+            result.competingTxs = competingTxs;
+            result.notes.push({ ...notes.nne(), ...responseNote, what: 'postRawTxDoubleSpend' });
+            return;
+        }
+        result.notes.push({ ...notes.nn(), ...responseNote, what: 'postRawTxSuccess' });
+    }
+    applyFailedPostRawTx(result, response, data, notes) {
+        result.status = 'error';
+        const responseNote = {
+            txid: data.txid,
+            extraInfo: data.extraInfo,
+            txStatus: data.txStatus,
+            competingTxs: data.competingTxs?.join(',')
+        };
+        const note = {
+            ...notes.nn(),
+            ...notes.nne(),
+            ...responseNote,
+            what: 'postRawTxError'
+        };
+        const errorData = {};
+        result.data = errorData;
+        const responseStatus = response.status;
+        let numericStatus;
+        if (typeof responseStatus === 'number' || typeof responseStatus === 'string') {
+            note.status = responseStatus;
+            errorData.status = responseStatus.toString();
+            const parsed = Number(responseStatus);
+            if (Number.isFinite(parsed))
+                numericStatus = parsed;
+        }
+        else {
+            note.status = typeof responseStatus;
+            errorData.status = 'ERR_UNKNOWN';
+        }
+        const responseData = response.data;
+        if (typeof responseData === 'string' && responseData !== '') {
+            note.data = responseData.slice(0, 128);
+        }
+        else if (responseData != null && typeof responseData === 'object') {
+            errorData.more = responseData;
+            if ('detail' in responseData && typeof responseData.detail === 'string') {
+                errorData.detail = responseData.detail;
+                note.detail = responseData.detail;
+            }
+        }
+        result.serviceError = isArcServiceErrorStatus(numericStatus, errorData.detail);
+        result.notes.push(note);
+    }
+    applyPostRawTxResponse(result, response, notes) {
+        if (response.ok) {
+            this.applySuccessfulPostRawTx(result, response.data, notes);
+        }
+        else {
+            this.applyFailedPostRawTx(result, response, response.data, notes);
+        }
+    }
+    applyPostRawTxCatch(result, error_, notes) {
+        const error = WalletError_1.WalletError.fromUnknown(error_);
+        result.status = 'error';
+        result.serviceError = true;
+        result.data = `${error.code} ${error.message}`;
+        result.notes.push({
+            ...notes.nne(),
+            what: 'postRawTxCatch',
+            code: error.code,
+            description: error.description
+        });
+    }
     /**
      * The ARC '/v1/tx' endpoint, as of 2025-02-17 supports all of the following hex string formats:
      *   1. Single serialized raw transaction.
@@ -71,11 +211,11 @@ class ARC {
      */
     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];
+        if (txids == null) {
+            txids = [txid];
         }
         else {
-            txids = [txid];
+            txid = txids.at(-1);
         }
         const requestOptions = {
             method: 'POST',
@@ -89,92 +229,22 @@ class ARC {
             notes: []
         };
         const url = `${this.URL}/v1/tx`;
-        const nn = () => ({ name: this.name, when: new Date().toISOString() });
-        const nne = () => ({ ...nn(), rawTx, txids: txids.join(','), url });
+        const notes = {
+            nn: () => ({ name: this.name, when: new Date().toISOString() }),
+            nne: () => ({
+                name: this.name,
+                when: new Date().toISOString(),
+                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);
-            }
+            this.applyPostRawTxResponse(r, response, notes);
         }
-        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
-            });
+        catch (error_) {
+            this.applyPostRawTxCatch(r, error_, notes);
         }
         return r;
     }
@@ -206,7 +276,6 @@ class ARC {
         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;
@@ -227,7 +296,7 @@ class ARC {
                     returnedTxid: dr.txid
                 });
             }
-            else if (dr.txStatus === 'SEEN_ON_NETWORK' || dr.txStatus === 'STORED') {
+            else if (isArcAcceptedTxStatus(dr.txStatus)) {
                 tr.data = dr.txStatus;
                 tr.notes.push({
                     ...nn(),
@@ -239,6 +308,12 @@ class ARC {
             else {
                 tr.status = 'error';
                 tr.data = dr;
+                tr.serviceError = !isArcInvalidTxStatus(dr.txStatus);
+                if (isArcDoubleSpendTxStatus(dr.txStatus)) {
+                    tr.doubleSpend = true;
+                    tr.competingTxs = dr.competingTxs ?? undefined;
+                    tr.serviceError = undefined;
+                }
                 tr.notes.push({
                     ...nn(),
                     what: 'postBeefGetTxDataError',