@bsv/wallet-toolbox 1.3.21 → 1.3.22

package/mobile/out/src/sdk/PrivilegedKeyManager.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivilegedKeyManager = void 0;
+const sdk_1 = require("@bsv/sdk");
+/**
+ * PrivilegedKeyManager
+ *
+ * This class manages a privileged (i.e., very sensitive) private key, obtained from
+ * an external function (`keyGetter`), which might be backed by HSMs, secure enclaves,
+ * or other secure storage. The manager retains the key in memory only for a limited
+ * duration (`retentionPeriod`), uses XOR-based chunk-splitting obfuscation, and
+ * includes decoy data to raise the difficulty of discovering the real key in memory.
+ *
+ * IMPORTANT: While these measures raise the bar for attackers, JavaScript environments
+ * do not provide perfect in-memory secrecy.
+ */
+class PrivilegedKeyManager {
+    /**
+     * @param keyGetter - Asynchronous function that retrieves the PrivateKey from a secure environment.
+     * @param retentionPeriod - Time in milliseconds to retain the obfuscated key in memory before zeroizing.
+     */
+    constructor(keyGetter, retentionPeriod = 120000) {
+        /**
+         * A list of dynamically generated property names used to store
+         * real key chunks (XORed with random pads).
+         */
+        this.chunkPropNames = [];
+        /**
+         * A list of dynamically generated property names used to store
+         * the random pads that correspond to the real key chunks.
+         */
+        this.chunkPadPropNames = [];
+        /**
+         * A list of decoy property names that will be removed
+         * when the real key is destroyed.
+         */
+        this.decoyPropNamesDestroy = [];
+        /**
+         * A list of decoy property names that remain in memory
+         * even after the real key is destroyed (just to cause confusion).
+         */
+        this.decoyPropNamesRemain = [];
+        /**
+         * Number of chunks to split the 32-byte key into.
+         * Adjust to increase or decrease obfuscation complexity.
+         */
+        this.CHUNK_COUNT = 4;
+        this.keyGetter = keyGetter;
+        this.retentionPeriod = retentionPeriod;
+        // Initialize some random decoy properties that always remain:
+        for (let i = 0; i < 2; i++) {
+            const propName = this.generateRandomPropName();
+            this[propName] = Uint8Array.from((0, sdk_1.Random)(16));
+            this.decoyPropNamesRemain.push(propName);
+        }
+    }
+    /**
+     * Safely destroys the in-memory obfuscated key material by zeroizing
+     * and deleting related fields. Also destroys some (but not all) decoy
+     * properties to further confuse an attacker.
+     */
+    destroyKey() {
+        try {
+            // Zero out real chunk data
+            for (const name of this.chunkPropNames) {
+                const data = this[name];
+                if (data) {
+                    data.fill(0);
+                }
+                delete this[name];
+            }
+            for (const name of this.chunkPadPropNames) {
+                const data = this[name];
+                if (data) {
+                    data.fill(0);
+                }
+                delete this[name];
+            }
+            // Destroy some decoys
+            for (const name of this.decoyPropNamesDestroy) {
+                const data = this[name];
+                if (data) {
+                    data.fill(0);
+                }
+                delete this[name];
+            }
+            // Clear arrays of property names
+            this.chunkPropNames = [];
+            this.chunkPadPropNames = [];
+            this.decoyPropNamesDestroy = [];
+        }
+        catch (_) {
+            // Swallow any errors in the destruction process
+        }
+        finally {
+            if (this.destroyTimer) {
+                clearTimeout(this.destroyTimer);
+                this.destroyTimer = undefined;
+            }
+        }
+    }
+    /**
+     * Re/sets the destruction timer that removes the key from memory
+     * after `retentionPeriod` ms. If a timer is already running, it
+     * is cleared and re-set. This ensures the key remains in memory
+     * for exactly the desired window after its most recent acquisition.
+     */
+    scheduleKeyDestruction() {
+        if (this.destroyTimer) {
+            // TODO: Consider a constructor flag to avoid clearing timers for higher security
+            clearTimeout(this.destroyTimer);
+        }
+        this.destroyTimer = setTimeout(() => {
+            this.destroyKey();
+        }, this.retentionPeriod);
+    }
+    /**
+     * XOR-based obfuscation on a per-chunk basis.
+     * This function takes two equal-length byte arrays
+     * and returns the XOR combination.
+     */
+    xorBytes(a, b) {
+        const out = new Uint8Array(a.length);
+        for (let i = 0; i < a.length; i++) {
+            out[i] = a[i] ^ b[i];
+        }
+        return out;
+    }
+    /**
+     * Splits the 32-byte key into `this.CHUNK_COUNT` smaller chunks
+     * (mostly equal length; the last chunk picks up leftover bytes
+     * if 32 is not evenly divisible).
+     */
+    splitKeyIntoChunks(keyBytes) {
+        const chunkSize = Math.floor(keyBytes.length / this.CHUNK_COUNT);
+        const chunks = [];
+        let offset = 0;
+        for (let i = 0; i < this.CHUNK_COUNT; i++) {
+            const size = i === this.CHUNK_COUNT - 1 ? keyBytes.length - offset : chunkSize;
+            chunks.push(keyBytes.slice(offset, offset + size));
+            offset += size;
+        }
+        return chunks;
+    }
+    /**
+     * Reassembles the chunks from the dynamic properties, XORs them
+     * with their corresponding pads, and returns a single 32-byte
+     * Uint8Array representing the raw key.
+     */
+    reassembleKeyFromChunks() {
+        try {
+            const chunkArrays = [];
+            for (let i = 0; i < this.chunkPropNames.length; i++) {
+                const chunkEnc = this[this.chunkPropNames[i]];
+                const chunkPad = this[this.chunkPadPropNames[i]];
+                if (!chunkEnc || !chunkPad || chunkEnc.length !== chunkPad.length) {
+                    return null;
+                }
+                const rawChunk = this.xorBytes(chunkEnc, chunkPad);
+                chunkArrays.push(rawChunk);
+            }
+            // Concat them back to a single 32-byte array:
+            const totalLength = chunkArrays.reduce((sum, c) => sum + c.length, 0);
+            if (totalLength !== 32) {
+                // We only handle 32-byte keys
+                return null;
+            }
+            const rawKey = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunkArrays) {
+                rawKey.set(chunk, offset);
+                offset += chunk.length;
+                // Attempt to zero the ephemeral chunk
+                chunk.fill(0);
+            }
+            return rawKey;
+        }
+        catch (_) {
+            // If any property is missing or type mismatch, we return null
+            return null;
+        }
+    }
+    /**
+     * Generates a random property name to store key chunks or decoy data.
+     */
+    generateRandomPropName() {
+        // E.g., 8 random hex characters for the property name
+        const randomHex = sdk_1.Utils.toHex((0, sdk_1.Random)(4));
+        return `_${randomHex}_${Math.floor(Math.random() * 1e6)}`;
+    }
+    /**
+     * Forces a PrivateKey to be represented as exactly 32 bytes, left-padding
+     * with zeros if its numeric value has fewer than 32 bytes.
+     */
+    get32ByteRepresentation(privKey) {
+        // The internal "toArray()" can be up to 32 bytes, but sometimes fewer
+        // if the numeric value has leading zeros.
+        const buf = privKey.toArray();
+        if (buf.length > 32) {
+            throw new Error('PrivilegedKeyManager: Expected a 32-byte key, but got more.');
+        }
+        // Left-pad with zeros if needed
+        const keyBytes = new Uint8Array(32);
+        keyBytes.set(buf, 32 - buf.length);
+        return keyBytes;
+    }
+    /**
+     * Returns the privileged key needed to perform cryptographic operations.
+     * Uses in-memory chunk-based obfuscation if the key was already fetched.
+     * Otherwise, it calls out to `keyGetter`, splits the 32-byte representation
+     * of the key, XORs each chunk with a random pad, and stores them under
+     * dynamic property names. Also populates new decoy properties.
+     *
+     * @param reason - The reason for why the key is needed, passed to keyGetter.
+     * @returns The PrivateKey object needed for cryptographic operations.
+     */
+    async getPrivilegedKey(reason) {
+        // If we already have chunk properties, try reassemble
+        if (this.chunkPropNames.length > 0 && this.chunkPadPropNames.length > 0) {
+            const rawKeyBytes = this.reassembleKeyFromChunks();
+            if (rawKeyBytes && rawKeyBytes.length === 32) {
+                // Convert 32 raw bytes back to a PrivateKey
+                // (Leading zeros are preserved, but PrivateKey() will parse it as a big integer.)
+                const hexKey = sdk_1.Utils.toHex([...rawKeyBytes]); // 64 hex chars
+                rawKeyBytes.fill(0); // Zero ephemeral copy
+                this.scheduleKeyDestruction();
+                return new sdk_1.PrivateKey(hexKey, 'hex');
+            }
+        }
+        // Otherwise, fetch a fresh key from the secure environment
+        const fetchedKey = await this.keyGetter(reason);
+        // Force 32‑byte representation (left-pad if necessary)
+        const keyBytes = this.get32ByteRepresentation(fetchedKey);
+        // Clean up any old data first (in case we had something stale)
+        this.destroyKey();
+        // Split the key
+        const chunks = this.splitKeyIntoChunks(keyBytes);
+        // Store new chunk data under random property names
+        for (let i = 0; i < chunks.length; i++) {
+            const chunkProp = this.generateRandomPropName();
+            const padProp = this.generateRandomPropName();
+            this.chunkPropNames.push(chunkProp);
+            this.chunkPadPropNames.push(padProp);
+            // Generate random pad of the same length as the chunk
+            const pad = Uint8Array.from((0, sdk_1.Random)(chunks[i].length));
+            // XOR the chunk to obfuscate
+            const obf = this.xorBytes(chunks[i], pad);
+            this[chunkProp] = obf;
+            this[padProp] = pad;
+        }
+        // Generate some decoy properties that will be destroyed with the key
+        for (let i = 0; i < 2; i++) {
+            const decoyProp = this.generateRandomPropName();
+            this[decoyProp] = Uint8Array.from((0, sdk_1.Random)(32));
+            this.decoyPropNamesDestroy.push(decoyProp);
+        }
+        // Zero out ephemeral original
+        keyBytes.fill(0);
+        // Schedule destruction
+        this.scheduleKeyDestruction();
+        // Return the newly fetched key as a normal PrivateKey
+        return fetchedKey;
+    }
+    async getPublicKey(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).getPublicKey(args);
+    }
+    async revealCounterpartyKeyLinkage(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).revealCounterpartyKeyLinkage(args);
+    }
+    async revealSpecificKeyLinkage(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).revealSpecificKeyLinkage(args);
+    }
+    async encrypt(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).encrypt(args);
+    }
+    async decrypt(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).decrypt(args);
+    }
+    async createHmac(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).createHmac(args);
+    }
+    async verifyHmac(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).verifyHmac(args);
+    }
+    async createSignature(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).createSignature(args);
+    }
+    async verifySignature(args) {
+        return new sdk_1.ProtoWallet(await this.getPrivilegedKey(args.privilegedReason)).verifySignature(args);
+    }
+}
+exports.PrivilegedKeyManager = PrivilegedKeyManager;
+//# sourceMappingURL=PrivilegedKeyManager.js.map

package/mobile/out/src/sdk/PrivilegedKeyManager.js.map

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

package/mobile/out/src/sdk/WERR_errors.d.ts

@@ -0,0 +1,115 @@
+import { AtomicBEEF, OutpointString, SendWithResult, TXIDHexString, WalletNetwork } from '@bsv/sdk';
+import { WalletError } from './WalletError';
+import { ReviewActionResult } from './WalletStorage.interfaces';
+/**
+ * Not implemented.
+ */
+export declare class WERR_NOT_IMPLEMENTED extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * An internal error has occurred.
+ *
+ * This is an example of an error with an optional custom `message`.
+ */
+export declare class WERR_INTERNAL extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * The ${parameter} parameter is invalid.
+ *
+ * This is an example of an error object with a custom property `parameter` and templated `message`.
+ */
+export declare class WERR_INVALID_OPERATION extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * Unable to broadcast transaction at this time.
+ */
+export declare class WERR_BROADCAST_UNAVAILABLE extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * The ${parameter} parameter is invalid.
+ *
+ * This is an example of an error object with a custom property `parameter` and templated `message`.
+ */
+export declare class WERR_INVALID_PARAMETER extends WalletError {
+    parameter: string;
+    constructor(parameter: string, mustBe?: string);
+}
+/**
+ * The required ${parameter} parameter is missing.
+ *
+ * This is an example of an error object with a custom property `parameter`
+ */
+export declare class WERR_MISSING_PARAMETER extends WalletError {
+    parameter: string;
+    constructor(parameter: string);
+}
+/**
+ * The request is invalid.
+ */
+export declare class WERR_BAD_REQUEST extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * Configured network chain is invalid or does not match across services.
+ */
+export declare class WERR_NETWORK_CHAIN extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * Access is denied due to an authorization error.
+ */
+export declare class WERR_UNAUTHORIZED extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * WalletStorageManager is not accessing user's active storage or there are conflicting active stores configured.
+ */
+export declare class WERR_NOT_ACTIVE extends WalletError {
+    constructor(message?: string);
+}
+/**
+ * Insufficient funds in the available inputs to cover the cost of the required outputs
+ * and the transaction fee (${moreSatoshisNeeded} more satoshis are needed,
+ * for a total of ${totalSatoshisNeeded}), plus whatever would be required in order
+ * to pay the fee to unlock and spend the outputs used to provide the additional satoshis.
+ */
+export declare class WERR_INSUFFICIENT_FUNDS extends WalletError {
+    totalSatoshisNeeded: number;
+    moreSatoshisNeeded: number;
+    /**
+     * @param totalSatoshisNeeded Total satoshis required to fund transactions after net of required inputs and outputs.
+     * @param moreSatoshisNeeded Shortfall on total satoshis required to fund transactions after net of required inputs and outputs.
+     */
+    constructor(totalSatoshisNeeded: number, moreSatoshisNeeded: number);
+}
+export declare class WERR_INVALID_PUBLIC_KEY extends WalletError {
+    key: string;
+    /**
+     * @param key The invalid public key that caused the error.
+     * @param environment Optional environment flag to control whether the key is included in the message.
+     */
+    constructor(key: string, network?: WalletNetwork);
+}
+/**
+ * When a `createAction` or `signAction` is completed in undelayed mode (`acceptDelayedBroadcast`: false),
+ * any unsucccessful result will return the results by way of this exception to ensure attention is
+ * paid to processing errors.
+ */
+export declare class WERR_REVIEW_ACTIONS extends WalletError {
+    reviewActionResults: ReviewActionResult[];
+    sendWithResults: SendWithResult[];
+    txid?: TXIDHexString | undefined;
+    tx?: AtomicBEEF | undefined;
+    noSendChange?: OutpointString[] | undefined;
+    /**
+     * All parameters correspond to their comparable `createAction` or `signSction` results
+     * with the exception of `reviewActionResults`;
+     * which contains more details, particularly for double spend results.
+     */
+    constructor(reviewActionResults: ReviewActionResult[], sendWithResults: SendWithResult[], txid?: TXIDHexString | undefined, tx?: AtomicBEEF | undefined, noSendChange?: OutpointString[] | undefined);
+}
+//# sourceMappingURL=WERR_errors.d.ts.map

package/mobile/out/src/sdk/WERR_errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WERR_errors.d.ts","sourceRoot":"","sources":["../../../../src/sdk/WERR_errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,WAAW;gBAC7C,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IAE5C,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,MAAM;CAIlB;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IAClC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAGrC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,CAAC,EAAE,MAAM;CAO7B;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IAM7C,mBAAmB,EAAE,MAAM;IAC3B,kBAAkB,EAAE,MAAM;IANnC;;;OAGG;gBAEM,mBAAmB,EAAE,MAAM,EAC3B,kBAAkB,EAAE,MAAM;CAOpC;AAED,qBAAa,uBAAwB,SAAQ,WAAW;IAM7C,GAAG,EAAE,MAAM;IALpB;;;OAGG;gBAEM,GAAG,EAAE,MAAM,EAClB,OAAO,GAAE,aAAyB;CAQrC;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAOzC,mBAAmB,EAAE,kBAAkB,EAAE;IACzC,eAAe,EAAE,cAAc,EAAE;IACjC,IAAI,CAAC,EAAE,aAAa;IACpB,EAAE,CAAC,EAAE,UAAU;IACf,YAAY,CAAC,EAAE,cAAc,EAAE;IAVxC;;;;OAIG;gBAEM,mBAAmB,EAAE,kBAAkB,EAAE,EACzC,eAAe,EAAE,cAAc,EAAE,EACjC,IAAI,CAAC,EAAE,aAAa,YAAA,EACpB,EAAE,CAAC,EAAE,UAAU,YAAA,EACf,YAAY,CAAC,EAAE,cAAc,EAAE,YAAA;CAIzC"}

package/mobile/out/src/sdk/WERR_errors.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WERR_REVIEW_ACTIONS = exports.WERR_INVALID_PUBLIC_KEY = exports.WERR_INSUFFICIENT_FUNDS = exports.WERR_NOT_ACTIVE = exports.WERR_UNAUTHORIZED = exports.WERR_NETWORK_CHAIN = exports.WERR_BAD_REQUEST = exports.WERR_MISSING_PARAMETER = exports.WERR_INVALID_PARAMETER = exports.WERR_BROADCAST_UNAVAILABLE = exports.WERR_INVALID_OPERATION = exports.WERR_INTERNAL = exports.WERR_NOT_IMPLEMENTED = void 0;
+const WalletError_1 = require("./WalletError");
+/**
+ * Not implemented.
+ */
+class WERR_NOT_IMPLEMENTED extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_NOT_IMPLEMENTED', message !== null && message !== void 0 ? message : 'Not implemented.');
+    }
+}
+exports.WERR_NOT_IMPLEMENTED = WERR_NOT_IMPLEMENTED;
+/**
+ * An internal error has occurred.
+ *
+ * This is an example of an error with an optional custom `message`.
+ */
+class WERR_INTERNAL extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_INTERNAL', message !== null && message !== void 0 ? message : 'An internal error has occurred.');
+    }
+}
+exports.WERR_INTERNAL = WERR_INTERNAL;
+/**
+ * The ${parameter} parameter is invalid.
+ *
+ * This is an example of an error object with a custom property `parameter` and templated `message`.
+ */
+class WERR_INVALID_OPERATION extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_INVALID_OPERATION', message !== null && message !== void 0 ? message : `An invalid operation was requested.`);
+    }
+}
+exports.WERR_INVALID_OPERATION = WERR_INVALID_OPERATION;
+/**
+ * Unable to broadcast transaction at this time.
+ */
+class WERR_BROADCAST_UNAVAILABLE extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_BROADCAST_UNAVAILABLE', `Unable to broadcast transaction at this time.`);
+    }
+}
+exports.WERR_BROADCAST_UNAVAILABLE = WERR_BROADCAST_UNAVAILABLE;
+/**
+ * The ${parameter} parameter is invalid.
+ *
+ * This is an example of an error object with a custom property `parameter` and templated `message`.
+ */
+class WERR_INVALID_PARAMETER extends WalletError_1.WalletError {
+    constructor(parameter, mustBe) {
+        super('WERR_INVALID_PARAMETER', `The ${parameter} parameter must be ${mustBe !== null && mustBe !== void 0 ? mustBe : 'valid.'}`);
+        this.parameter = parameter;
+    }
+}
+exports.WERR_INVALID_PARAMETER = WERR_INVALID_PARAMETER;
+/**
+ * The required ${parameter} parameter is missing.
+ *
+ * This is an example of an error object with a custom property `parameter`
+ */
+class WERR_MISSING_PARAMETER extends WalletError_1.WalletError {
+    constructor(parameter) {
+        super('WERR_MISSING_PARAMETER', `The required ${parameter} parameter is missing.`);
+        this.parameter = parameter;
+    }
+}
+exports.WERR_MISSING_PARAMETER = WERR_MISSING_PARAMETER;
+/**
+ * The request is invalid.
+ */
+class WERR_BAD_REQUEST extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_BAD_REQUEST', message !== null && message !== void 0 ? message : 'The request is invalid.');
+    }
+}
+exports.WERR_BAD_REQUEST = WERR_BAD_REQUEST;
+/**
+ * Configured network chain is invalid or does not match across services.
+ */
+class WERR_NETWORK_CHAIN extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_NETWORK_CHAIN', message !== null && message !== void 0 ? message : 'Configured network chain is invalid or does not match across services.');
+    }
+}
+exports.WERR_NETWORK_CHAIN = WERR_NETWORK_CHAIN;
+/**
+ * Access is denied due to an authorization error.
+ */
+class WERR_UNAUTHORIZED extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_UNAUTHORIZED', message !== null && message !== void 0 ? message : 'Access is denied due to an authorization error.');
+    }
+}
+exports.WERR_UNAUTHORIZED = WERR_UNAUTHORIZED;
+/**
+ * WalletStorageManager is not accessing user's active storage or there are conflicting active stores configured.
+ */
+class WERR_NOT_ACTIVE extends WalletError_1.WalletError {
+    constructor(message) {
+        super('WERR_NOT_ACTIVE', message !== null && message !== void 0 ? message : `WalletStorageManager is not accessing user's active storage or there are conflicting active stores configured.`);
+    }
+}
+exports.WERR_NOT_ACTIVE = WERR_NOT_ACTIVE;
+/**
+ * Insufficient funds in the available inputs to cover the cost of the required outputs
+ * and the transaction fee (${moreSatoshisNeeded} more satoshis are needed,
+ * for a total of ${totalSatoshisNeeded}), plus whatever would be required in order
+ * to pay the fee to unlock and spend the outputs used to provide the additional satoshis.
+ */
+class WERR_INSUFFICIENT_FUNDS extends WalletError_1.WalletError {
+    /**
+     * @param totalSatoshisNeeded Total satoshis required to fund transactions after net of required inputs and outputs.
+     * @param moreSatoshisNeeded Shortfall on total satoshis required to fund transactions after net of required inputs and outputs.
+     */
+    constructor(totalSatoshisNeeded, moreSatoshisNeeded) {
+        super('WERR_INSUFFICIENT_FUNDS', `Insufficient funds in the available inputs to cover the cost of the required outputs and the transaction fee (${moreSatoshisNeeded} more satoshis are needed, for a total of ${totalSatoshisNeeded}), plus whatever would be required in order to pay the fee to unlock and spend the outputs used to provide the additional satoshis.`);
+        this.totalSatoshisNeeded = totalSatoshisNeeded;
+        this.moreSatoshisNeeded = moreSatoshisNeeded;
+    }
+}
+exports.WERR_INSUFFICIENT_FUNDS = WERR_INSUFFICIENT_FUNDS;
+class WERR_INVALID_PUBLIC_KEY extends WalletError_1.WalletError {
+    /**
+     * @param key The invalid public key that caused the error.
+     * @param environment Optional environment flag to control whether the key is included in the message.
+     */
+    constructor(key, network = 'mainnet') {
+        const message = network === 'mainnet'
+            ? `The provided public key "${key}" is invalid or malformed.`
+            : `The provided public key is invalid or malformed.`;
+        super('WERR_INVALID_PUBLIC_KEY', message);
+        this.key = key;
+    }
+}
+exports.WERR_INVALID_PUBLIC_KEY = WERR_INVALID_PUBLIC_KEY;
+/**
+ * When a `createAction` or `signAction` is completed in undelayed mode (`acceptDelayedBroadcast`: false),
+ * any unsucccessful result will return the results by way of this exception to ensure attention is
+ * paid to processing errors.
+ */
+class WERR_REVIEW_ACTIONS extends WalletError_1.WalletError {
+    /**
+     * All parameters correspond to their comparable `createAction` or `signSction` results
+     * with the exception of `reviewActionResults`;
+     * which contains more details, particularly for double spend results.
+     */
+    constructor(reviewActionResults, sendWithResults, txid, tx, noSendChange) {
+        super('WERR_REVIEW_ACTIONS', 'Undelayed createAction or signAction results require review.');
+        this.reviewActionResults = reviewActionResults;
+        this.sendWithResults = sendWithResults;
+        this.txid = txid;
+        this.tx = tx;
+        this.noSendChange = noSendChange;
+    }
+}
+exports.WERR_REVIEW_ACTIONS = WERR_REVIEW_ACTIONS;
+//# sourceMappingURL=WERR_errors.js.map

package/mobile/out/src/sdk/WERR_errors.js.map

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

package/mobile/out/src/sdk/WalletError.d.ts

@@ -0,0 +1,44 @@
+import { ErrorCodeString10To40Bytes, ErrorDescriptionString20To200Bytes, WalletErrorObject } from '@bsv/sdk';
+/**
+ * Derived class constructors should use the derived class name as the value for `name`,
+ * and an internationalizable constant string for `message`.
+ *
+ * If a derived class intends to wrap another WalletError, the public property should
+ * be named `walletError` and will be recovered by `fromUnknown`.
+ *
+ * Optionaly, the derived class `message` can include template parameters passed in
+ * to the constructor. See WERR_MISSING_PARAMETER for an example.
+ *
+ * To avoid derived class name colisions, packages should include a package specific
+ * identifier after the 'WERR_' prefix. e.g. 'WERR_FOO_' as the prefix for Foo package error
+ * classes.
+ */
+export declare class WalletError extends Error implements WalletErrorObject {
+    details?: Record<string, string> | undefined;
+    isError: true;
+    constructor(name: string, message: string, stack?: string, details?: Record<string, string> | undefined);
+    /**
+     * Error class compatible accessor for  `code`.
+     */
+    get code(): ErrorCodeString10To40Bytes;
+    set code(v: ErrorCodeString10To40Bytes);
+    /**
+     * Error class compatible accessor for `description`.
+     */
+    get description(): ErrorDescriptionString20To200Bytes;
+    set description(v: ErrorDescriptionString20To200Bytes);
+    /**
+     * Recovers all public fields from WalletError derived error classes and relevant Error derived errors.
+     *
+     */
+    static fromUnknown(err: unknown): WalletError;
+    /**
+     * @returns standard HTTP error status object with status property set to 'error'.
+     */
+    asStatus(): {
+        status: string;
+        code: string;
+        description: string;
+    };
+}
+//# sourceMappingURL=WalletError.d.ts.map

package/mobile/out/src/sdk/WalletError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletError.d.ts","sourceRoot":"","sources":["../../../../src/sdk/WalletError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,kCAAkC,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5G;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,KAAM,YAAW,iBAAiB;IAQxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IANzC,OAAO,EAAE,IAAI,CAAO;gBAGlB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA;IAOzC;;OAEG;IACH,IAAI,IAAI,IAAI,0BAA0B,CAErC;IACD,IAAI,IAAI,CAAC,CAAC,EAAE,0BAA0B,EAErC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,kCAAkC,CAEpD;IACD,IAAI,WAAW,CAAC,CAAC,EAAE,kCAAkC,EAEpD;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW;IAqD7C;;OAEG;IACH,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAOlE"}