@bsv/wallet-toolbox 2.13.0 → 2.13.2

package/out/src/services/validateMerklePathResult.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTxid = normalizeTxid;
+exports.snapshotMerklePathResult = snapshotMerklePathResult;
+exports.copyMerklePath = copyMerklePath;
+exports.copyValidatedBlockHeader = copyValidatedBlockHeader;
+exports.validateMerklePathResult = validateMerklePathResult;
+exports.authenticateMerklePathResult = authenticateMerklePathResult;
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../sdk/WERR_errors");
+const WalletError_1 = require("../sdk/WalletError");
+const blockHeaderUtilities_1 = require("./chaintracker/chaintracks/util/blockHeaderUtilities");
+const HEX_32_BYTES = /^[0-9a-fA-F]{64}$/;
+const MAX_BLOCK_HEIGHT = 0x7fffffff;
+const MAX_PATH_LEVELS = 32;
+const MAX_PATH_LEAVES = 4096;
+const MAX_LEAF_OFFSET = 0x7fffffff;
+const MAX_PROOF_CANDIDATES = 8;
+const MAX_PROOF_NOTES = 64;
+const MAX_NOTE_PROPERTIES = 32;
+function invalid(name, requirement) {
+    throw new WERR_errors_1.WERR_INVALID_PARAMETER(name, requirement);
+}
+function normalizeTxid(value, name = 'txid') {
+    if (typeof value !== 'string' || !HEX_32_BYTES.test(value)) {
+        invalid(name, 'exactly 32 hexadecimal bytes');
+    }
+    return value.toLowerCase();
+}
+function requirePlainDataRecord(value, name) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        invalid(name, 'an accessor-free data object');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null && prototype !== sdk_1.MerklePath.prototype) {
+        invalid(name, 'an accessor-free data object');
+    }
+    if (Object.getOwnPropertySymbols(value).length !== 0) {
+        invalid(name, 'an accessor-free data object without symbol properties');
+    }
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Object.values(descriptors).some(descriptor => descriptor.get != null || descriptor.set != null)) {
+        invalid(name, 'accessor-free data properties');
+    }
+    return descriptors;
+}
+function ownValue(descriptors, property, name) {
+    const descriptor = descriptors[property];
+    if (descriptor == null || !('value' in descriptor))
+        invalid(name, `an own ${property} data property`);
+    return descriptor.value;
+}
+function optionalOwnValue(descriptors, property) {
+    const descriptor = descriptors[property];
+    return descriptor != null && 'value' in descriptor ? descriptor.value : undefined;
+}
+function requireDenseArray(value, name, maximum) {
+    if (!Array.isArray(value) || value.length > maximum)
+        invalid(name, `a dense array of at most ${maximum} items`);
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    if (Object.getOwnPropertySymbols(value).length !== 0)
+        invalid(name, 'an array without symbol properties');
+    if (Object.values(descriptors).some(descriptor => descriptor.get != null || descriptor.set != null)) {
+        invalid(name, 'an accessor-free array');
+    }
+    const expectedKeys = new Set(['length', ...Array.from({ length: value.length }, (_, index) => String(index))]);
+    if (Object.keys(descriptors).some(key => !expectedKeys.has(key)) ||
+        expectedKeys.size !== Object.keys(descriptors).length) {
+        invalid(name, 'a dense array without extra properties');
+    }
+    return value;
+}
+function requireInteger(value, name, maximum) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > maximum) {
+        invalid(name, `an integer from 0 through ${maximum}`);
+    }
+    return value;
+}
+function boundedText(value, name, maximum) {
+    if (typeof value !== 'string' || value.length > maximum || /\p{Cc}/u.test(value)) {
+        invalid(name, `at most ${maximum} characters without control characters`);
+    }
+    return value;
+}
+function copyProofNotes(value) {
+    if (value === undefined)
+        return undefined;
+    const notes = requireDenseArray(value, 'getMerklePath result.notes', MAX_PROOF_NOTES);
+    return notes.map((noteValue, index) => {
+        const name = `getMerklePath result.notes[${index}]`;
+        const descriptors = requirePlainDataRecord(noteValue, name);
+        const keys = Object.keys(descriptors);
+        if (keys.length > MAX_NOTE_PROPERTIES || keys.some(key => !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(key))) {
+            invalid(name, `at most ${MAX_NOTE_PROPERTIES} bounded data properties`);
+        }
+        const note = {};
+        for (const key of keys) {
+            const value = ownValue(descriptors, key, name);
+            if (value === undefined || typeof value === 'boolean') {
+                note[key] = value;
+            }
+            else if (typeof value === 'number' && Number.isFinite(value) && Number.isSafeInteger(value)) {
+                note[key] = value;
+            }
+            else if (typeof value === 'string') {
+                note[key] = boundedText(value, `${name}.${key}`, key === 'what' || key === 'when' ? 128 : 512);
+            }
+            else {
+                invalid(`${name}.${key}`, 'a bounded string, safe integer, boolean, or undefined');
+            }
+        }
+        if (typeof note.what !== 'string' || note.what.length === 0)
+            invalid(`${name}.what`, 'a nonempty bounded string');
+        return note;
+    });
+}
+/**
+ * Snapshot the provider envelope before inspecting proof availability or
+ * diagnostics. The optional legacy array mode is bounded for older custom
+ * WalletServices implementations; ordinary providers return one path.
+ */
+function snapshotMerklePathResult(value, allowLegacyArray = false, providerName) {
+    const descriptors = requirePlainDataRecord(value, 'getMerklePath result');
+    const allowed = new Set(['name', 'merklePath', 'header', 'error', 'notes']);
+    if (Object.keys(descriptors).some(key => !allowed.has(key))) {
+        invalid('getMerklePath result', 'only name, merklePath, header, error, and notes data properties');
+    }
+    const nameValue = providerName ?? optionalOwnValue(descriptors, 'name');
+    const name = nameValue === undefined ? undefined : boundedText(nameValue, 'getMerklePath result.name', 128);
+    const merklePathValue = optionalOwnValue(descriptors, 'merklePath');
+    let merklePath;
+    if (merklePathValue !== undefined) {
+        if (Array.isArray(merklePathValue)) {
+            if (!allowLegacyArray)
+                invalid('getMerklePath result.merklePath', 'one MerklePath object');
+            merklePath = requireDenseArray(merklePathValue, 'getMerklePath result.merklePath', MAX_PROOF_CANDIDATES);
+        }
+        else {
+            merklePath = merklePathValue;
+        }
+    }
+    const header = optionalOwnValue(descriptors, 'header');
+    const errorValue = optionalOwnValue(descriptors, 'error');
+    if (errorValue !== undefined && !(errorValue instanceof Error)) {
+        invalid('getMerklePath result.error', 'a WalletError or absent');
+    }
+    const error = errorValue === undefined ? undefined : WalletError_1.WalletError.fromUnknown(errorValue);
+    const notes = copyProofNotes(optionalOwnValue(descriptors, 'notes'));
+    return {
+        ...(name !== undefined ? { name } : {}),
+        ...(merklePath !== undefined ? { merklePath } : {}),
+        ...(header !== undefined ? { header } : {}),
+        ...(error !== undefined ? { error } : {}),
+        ...(notes !== undefined ? { notes } : {})
+    };
+}
+function copyMerklePath(txid, value) {
+    const descriptors = requirePlainDataRecord(value, 'merklePath');
+    const blockHeight = requireInteger(ownValue(descriptors, 'blockHeight', 'merklePath'), 'merklePath.blockHeight', MAX_BLOCK_HEIGHT);
+    const sourcePath = requireDenseArray(ownValue(descriptors, 'path', 'merklePath'), 'merklePath.path', MAX_PATH_LEVELS);
+    if (sourcePath.length === 0)
+        invalid('merklePath.path', 'at least one level');
+    let leafCount = 0;
+    const path = sourcePath.map((sourceLevel, levelIndex) => {
+        const level = requireDenseArray(sourceLevel, `merklePath.path[${levelIndex}]`, MAX_PATH_LEAVES);
+        leafCount += level.length;
+        if (leafCount > MAX_PATH_LEAVES)
+            invalid('merklePath.path', `at most ${MAX_PATH_LEAVES} total leaves`);
+        return level.map((sourceLeaf, leafIndex) => {
+            const name = `merklePath.path[${levelIndex}][${leafIndex}]`;
+            const leafDescriptors = requirePlainDataRecord(sourceLeaf, name);
+            const keys = Object.keys(leafDescriptors);
+            if (keys.length > 4 || keys.some(key => !['offset', 'hash', 'txid', 'duplicate'].includes(key))) {
+                invalid(name, 'only offset, hash, txid, and duplicate data properties');
+            }
+            const offset = requireInteger(ownValue(leafDescriptors, 'offset', name), `${name}.offset`, MAX_LEAF_OFFSET);
+            const hashValue = leafDescriptors.hash?.value;
+            const txidValue = leafDescriptors.txid?.value;
+            const duplicateValue = leafDescriptors.duplicate?.value;
+            if (txidValue !== undefined && txidValue !== true)
+                invalid(`${name}.txid`, 'true or absent');
+            if (duplicateValue !== undefined && duplicateValue !== true)
+                invalid(`${name}.duplicate`, 'true or absent');
+            if (duplicateValue === true) {
+                if (hashValue !== undefined || txidValue !== undefined) {
+                    invalid(name, 'a duplicate marker without hash or txid properties');
+                }
+                return { offset, duplicate: true };
+            }
+            const hash = normalizeTxid(hashValue, `${name}.hash`);
+            return txidValue === true ? { offset, hash, txid: true } : { offset, hash };
+        });
+    });
+    let merklePath;
+    try {
+        merklePath = new sdk_1.MerklePath(blockHeight, path);
+    }
+    catch {
+        invalid('merklePath', 'a structurally consistent bounded Merkle path');
+    }
+    // A compound proof may mark several transaction leaves, while older proof
+    // providers may omit the optional `txid` marker entirely. Membership is
+    // bound by the requested hash and the root computation, not by that marker.
+    const leaf = merklePath.path[0].find(candidate => candidate.hash === txid);
+    if (leaf == null)
+        invalid('merklePath', 'a transaction leaf bound to the requested txid');
+    let root;
+    try {
+        root = normalizeTxid(merklePath.computeRoot(txid), 'merklePath root');
+    }
+    catch {
+        invalid('merklePath', 'a path that computes the requested transaction root');
+    }
+    return { merklePath, root, index: leaf.offset };
+}
+function copyValidatedBlockHeader(value, requireProofOfWork = false, requireHeaderFormat = true) {
+    const descriptors = requirePlainDataRecord(value, 'header');
+    const header = {
+        version: ownValue(descriptors, 'version', 'header'),
+        previousHash: ownValue(descriptors, 'previousHash', 'header'),
+        merkleRoot: ownValue(descriptors, 'merkleRoot', 'header'),
+        time: ownValue(descriptors, 'time', 'header'),
+        bits: ownValue(descriptors, 'bits', 'header'),
+        nonce: ownValue(descriptors, 'nonce', 'header'),
+        height: ownValue(descriptors, 'height', 'header'),
+        hash: ownValue(descriptors, 'hash', 'header')
+    };
+    if (!Number.isSafeInteger(header.height) || header.height < 0 || header.height > MAX_BLOCK_HEIGHT) {
+        invalid('header.height', `an integer from 0 through ${MAX_BLOCK_HEIGHT}`);
+    }
+    const merkleRoot = normalizeTxid(header.merkleRoot, 'header.merkleRoot');
+    const hash = normalizeTxid(header.hash, 'header.hash');
+    if (requireHeaderFormat) {
+        try {
+            (0, blockHeaderUtilities_1.validateHeaderFormat)(header);
+            if (requireProofOfWork)
+                (0, blockHeaderUtilities_1.validateHeaderProofOfWork)(header);
+        }
+        catch {
+            invalid('header', requireProofOfWork ? 'a canonical proof-of-work-valid block header' : 'a canonical block header');
+        }
+    }
+    return {
+        ...header,
+        previousHash: typeof header.previousHash === 'string' ? header.previousHash.toLowerCase() : header.previousHash,
+        merkleRoot,
+        hash
+    };
+}
+function validateMerklePathResult(requestedTxid, result, requireProofOfWork = false, requireHeaderFormat = true) {
+    const txid = normalizeTxid(requestedTxid);
+    const descriptors = requirePlainDataRecord(result, 'getMerklePath result');
+    const merklePathValue = ownValue(descriptors, 'merklePath', 'getMerklePath result');
+    const headerValue = ownValue(descriptors, 'header', 'getMerklePath result');
+    const proof = copyMerklePath(txid, merklePathValue);
+    const header = copyValidatedBlockHeader(headerValue, requireProofOfWork, requireHeaderFormat);
+    if (proof.merklePath.blockHeight !== header.height) {
+        invalid('merklePath.blockHeight', 'the authenticated header height');
+    }
+    if (proof.root !== header.merkleRoot) {
+        invalid('merklePath root', 'the authenticated header Merkle root');
+    }
+    return { ...proof, header };
+}
+async function authenticateMerklePathResult(requestedTxid, result, validator, requireProofOfWork = false, requireHeaderFormat = true) {
+    const validated = validateMerklePathResult(requestedTxid, result, requireProofOfWork, requireHeaderFormat);
+    if ((await validator.isValidRootForHeight(validated.root, validated.header.height)) !== true) {
+        invalid('merklePath root', 'a root authenticated by the configured chain tracker at the proof height');
+    }
+    return validated;
+}
+//# sourceMappingURL=validateMerklePathResult.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { Beef } from '@bsv/sdk';
+import { PostBeefResult, PostTxResultForTxid } from '../sdk/WalletServices.interfaces';
+export declare const MAX_POST_BEEF_BYTES: number;
+export declare const MAX_POST_BEEF_TXIDS = 1000;
+export interface ValidatedPostBeefRequest {
+    beefBytes: number[];
+    txids: string[];
+}
+export declare function normalizePostRawHex(value: unknown, maximumBytes: number, name?: string): string;
+export declare function normalizePostTxids(value: unknown, name?: string, allowEmpty?: boolean): string[];
+export declare function validatePostBeefResult(value: unknown, expectedTxids: string[], configuredProviderName: string, allowInternalTimeoutNote?: boolean): PostBeefResult;
+export declare function validatePostTxResult(value: unknown, expectedTxid: string, configuredProviderName: string): PostTxResultForTxid;
+export declare function validatePostTxResultOrServiceError(value: unknown, expectedTxid: string, configuredProviderName: string): PostTxResultForTxid;
+export declare function validatePostBeefResultOrServiceError(value: unknown, expectedTxids: string[], configuredProviderName: string): PostBeefResult;
+export declare function snapshotPostBeefRequest(beef: Beef, txids: string[]): ValidatedPostBeefRequest;
+export declare function makePostBeefServiceError(providerName: string, txids: string[], what: 'postBeefServiceError' | 'postBeefServiceTimeout', timeoutMs?: number): PostBeefResult;
+//# sourceMappingURL=validatePostBeefResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validatePostBeefResult.d.ts","sourceRoot":"","sources":["../../../src/services/validatePostBeefResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAE/B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAOtF,eAAO,MAAM,mBAAmB,QAAmB,CAAA;AACnD,eAAO,MAAM,mBAAmB,OAAiC,CAAA;AAgBjE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,SAAU,GAAG,MAAM,CAYhG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAU,EAAE,UAAU,UAAQ,GAAG,MAAM,EAAE,CAQ/F;AA+LD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,EAAE,EACvB,sBAAsB,EAAE,MAAM,EAC9B,wBAAwB,UAAQ,GAC/B,cAAc,CAkChB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,sBAAsB,EAAE,MAAM,GAC7B,mBAAmB,CAarB;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,sBAAsB,EAAE,MAAM,GAC7B,mBAAmB,CAMrB;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,EAAE,EACvB,sBAAsB,EAAE,MAAM,GAC7B,cAAc,CAMhB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAe7F;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,EACvD,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAchB"}

package/out/src/services/validatePostBeefResult.js

@@ -0,0 +1,334 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_POST_BEEF_TXIDS = exports.MAX_POST_BEEF_BYTES = void 0;
+exports.normalizePostRawHex = normalizePostRawHex;
+exports.normalizePostTxids = normalizePostTxids;
+exports.validatePostBeefResult = validatePostBeefResult;
+exports.validatePostTxResult = validatePostTxResult;
+exports.validatePostTxResultOrServiceError = validatePostTxResultOrServiceError;
+exports.validatePostBeefResultOrServiceError = validatePostBeefResultOrServiceError;
+exports.snapshotPostBeefRequest = snapshotPostBeefRequest;
+exports.makePostBeefServiceError = makePostBeefServiceError;
+const validationHelpers_1 = require("@bsv/sdk/wallet/validationHelpers");
+const sdk_1 = require("@bsv/sdk");
+const utils_1 = require("@bsv/sdk/primitives/utils");
+const WERR_errors_1 = require("../sdk/WERR_errors");
+const WalletError_1 = require("../sdk/WalletError");
+const utilityHelpers_1 = require("../utility/utilityHelpers");
+const validateMerklePathResult_1 = require("./validateMerklePathResult");
+exports.MAX_POST_BEEF_BYTES = 64 * 1024 * 1024;
+exports.MAX_POST_BEEF_TXIDS = validationHelpers_1.MAXIMUM_SEND_WITH_TRANSACTIONS;
+const MAX_COMPETING_TXIDS = 24;
+const MAX_TOTAL_NOTES = 128;
+const MAX_NOTE_PROPERTIES = 24;
+const MAX_DATA_NODES = 512;
+const MAX_DATA_BYTES = 64 * 1024;
+const MAX_BLOCK_HEIGHT = 0x7fffffff;
+const unsafeKeys = new Set(['__proto__', 'constructor', 'prototype']);
+const omittedDiagnosticKeys = new Set(['rawTx', 'raws', 'beef', 'url', 'txids']);
+function normalizePostRawHex(value, maximumBytes, name = 'rawTx') {
+    if (!Number.isSafeInteger(maximumBytes) || maximumBytes < 1)
+        invalid('maximumBytes', 'a positive safe integer');
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value.length > maximumBytes * 2 ||
+        value.length % 2 !== 0 ||
+        !/^[0-9a-fA-F]+$/.test(value)) {
+        invalid(name, `nonempty hexadecimal data no larger than ${maximumBytes} bytes`);
+    }
+    return value.toLowerCase();
+}
+function normalizePostTxids(value, name = 'txids', allowEmpty = false) {
+    const txids = denseArray(value, name, exports.MAX_POST_BEEF_TXIDS).map((txid, index) => (0, validateMerklePathResult_1.normalizeTxid)(txid, `${name}[${index}]`));
+    if ((!allowEmpty && txids.length === 0) || new Set(txids).size !== txids.length) {
+        invalid(name, `${allowEmpty ? '0' : '1'} through ${exports.MAX_POST_BEEF_TXIDS} unique transaction IDs`);
+    }
+    return txids;
+}
+function invalid(name, requirement) {
+    throw new WERR_errors_1.WERR_INVALID_PARAMETER(name, requirement);
+}
+function plainDescriptors(value, name) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        invalid(name, 'an accessor-free plain data object');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        invalid(name, 'an accessor-free plain data object');
+    const result = Object.getOwnPropertyDescriptors(value);
+    if (Object.getOwnPropertySymbols(value).length !== 0 ||
+        Object.values(result).some(property => property.get != null || property.set != null)) {
+        invalid(name, 'accessor-free data properties without symbols');
+    }
+    return result;
+}
+function read(source, property) {
+    return source[property]?.value;
+}
+function denseArray(value, name, maximum) {
+    if (!Array.isArray(value) || value.length > maximum)
+        invalid(name, `a dense array of at most ${maximum} items`);
+    const properties = Object.getOwnPropertyDescriptors(value);
+    const expected = new Set(['length', ...Array.from({ length: value.length }, (_, index) => String(index))]);
+    if (Object.getOwnPropertySymbols(value).length !== 0 ||
+        Object.keys(properties).length !== expected.size ||
+        Object.keys(properties).some(key => !expected.has(key)) ||
+        Object.values(properties).some(property => property.get != null || property.set != null)) {
+        invalid(name, 'an accessor-free dense array without extra properties');
+    }
+    return Array.from({ length: value.length }, (_, index) => properties[String(index)].value);
+}
+function boundedText(value, name, maximum) {
+    if (typeof value !== 'string' || value.length === 0 || (0, utils_1.toArray)(value, 'utf8').length > maximum) {
+        invalid(name, `1 through ${maximum} UTF-8 bytes`);
+    }
+    if (/\p{Cc}/u.test(value))
+        invalid(name, 'text without control characters');
+    return value;
+}
+function copyJsonValue(value, name, budget, depth = 0) {
+    if (budget.nodes-- <= 0 || depth > 4)
+        invalid(name, 'bounded JSON-like diagnostic data');
+    if (value === null || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || Math.abs(value) > Number.MAX_SAFE_INTEGER)
+            invalid(name, 'a finite safe number');
+        return value;
+    }
+    if (typeof value === 'string') {
+        const bytes = (0, utils_1.toArray)(value, 'utf8').length;
+        budget.bytes -= bytes;
+        if (bytes > 4096 || budget.bytes < 0)
+            invalid(name, 'bounded diagnostic strings');
+        return value.replace(/\p{Cc}/gu, ' ');
+    }
+    if (Array.isArray(value)) {
+        return denseArray(value, name, 64).map((item, index) => copyJsonValue(item, `${name}[${index}]`, budget, depth + 1));
+    }
+    const source = plainDescriptors(value, name);
+    const keys = Object.keys(source);
+    if (keys.length > 32 || keys.some(key => unsafeKeys.has(key)))
+        invalid(name, 'at most 32 safe data properties');
+    const result = {};
+    for (const key of keys)
+        result[key] = copyJsonValue(read(source, key), `${name}.${key}`, budget, depth + 1);
+    return result;
+}
+function copyNotes(value, name, budget, allowInternalTimeoutNote) {
+    if (value === undefined)
+        return [];
+    const notes = denseArray(value, name, MAX_TOTAL_NOTES);
+    if (notes.length > budget.notes)
+        invalid(name, `at most ${MAX_TOTAL_NOTES} notes across one provider result`);
+    budget.notes -= notes.length;
+    return notes.map((candidate, index) => {
+        const noteName = `${name}[${index}]`;
+        const source = plainDescriptors(candidate, noteName);
+        const keys = Object.keys(source);
+        if (keys.length > MAX_NOTE_PROPERTIES || keys.some(key => unsafeKeys.has(key))) {
+            invalid(noteName, `at most ${MAX_NOTE_PROPERTIES} safe scalar properties`);
+        }
+        const what = boundedText(read(source, 'what'), `${noteName}.what`, 128);
+        if (what === 'postBeefServiceTimeout' && !allowInternalTimeoutNote) {
+            invalid(`${noteName}.what`, 'a provider diagnostic rather than a reserved local timeout marker');
+        }
+        const result = { what };
+        for (const key of keys) {
+            if (key === 'what' || omittedDiagnosticKeys.has(key))
+                continue;
+            const item = read(source, key);
+            if (item === undefined)
+                continue;
+            if (typeof item === 'boolean')
+                result[key] = item;
+            else if (typeof item === 'number' && Number.isFinite(item) && Math.abs(item) <= Number.MAX_SAFE_INTEGER) {
+                result[key] = item;
+            }
+            else if (typeof item === 'string') {
+                if (item.length > 0)
+                    result[key] = boundedText(item, `${noteName}.${key}`, key === 'when' ? 64 : 1024);
+            }
+            else {
+                invalid(`${noteName}.${key}`, 'a bounded string, finite number, boolean, or absent');
+            }
+        }
+        return result;
+    });
+}
+function optionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        invalid(name, 'a boolean or absent');
+    return value;
+}
+function copyTxidResult(value, index, expected, budget, allowInternalTimeoutNote) {
+    const name = `postBeef result.txidResults[${index}]`;
+    const source = plainDescriptors(value, name);
+    const allowed = new Set([
+        'txid',
+        'status',
+        'alreadyKnown',
+        'doubleSpend',
+        'blockHash',
+        'blockHeight',
+        'merklePath',
+        'competingTxs',
+        'data',
+        'notes',
+        'serviceError'
+    ]);
+    if (Object.keys(source).some(key => !allowed.has(key)))
+        invalid(name, 'only documented transaction-result fields');
+    const txid = (0, validateMerklePathResult_1.normalizeTxid)(read(source, 'txid'), `${name}.txid`);
+    if (!expected.has(txid))
+        invalid(`${name}.txid`, 'one of the exact requested transaction IDs');
+    const status = read(source, 'status');
+    if (status !== 'success' && status !== 'error')
+        invalid(`${name}.status`, "'success' or 'error'");
+    const alreadyKnown = optionalBoolean(read(source, 'alreadyKnown'), `${name}.alreadyKnown`);
+    const doubleSpend = optionalBoolean(read(source, 'doubleSpend'), `${name}.doubleSpend`);
+    const serviceError = optionalBoolean(read(source, 'serviceError'), `${name}.serviceError`);
+    if (status === 'success' && (doubleSpend === true || serviceError === true)) {
+        invalid(name, 'successful results without double-spend or service-error flags');
+    }
+    if (status === 'error' && alreadyKnown === true)
+        invalid(name, 'already-known results classified as success');
+    if (doubleSpend === true && serviceError === true)
+        invalid(name, 'a single error class');
+    let competingTxs;
+    const rawCompeting = read(source, 'competingTxs');
+    if (rawCompeting !== undefined) {
+        if (doubleSpend !== true)
+            invalid(`${name}.competingTxs`, 'present only for a double-spend result');
+        competingTxs = denseArray(rawCompeting, `${name}.competingTxs`, MAX_COMPETING_TXIDS).map((item, itemIndex) => (0, validateMerklePathResult_1.normalizeTxid)(item, `${name}.competingTxs[${itemIndex}]`));
+        if (competingTxs.includes(txid) || new Set(competingTxs).size !== competingTxs.length) {
+            invalid(`${name}.competingTxs`, 'unique competing IDs that exclude the submitted transaction');
+        }
+    }
+    const result = { txid, status };
+    if (alreadyKnown !== undefined)
+        result.alreadyKnown = alreadyKnown;
+    if (doubleSpend !== undefined)
+        result.doubleSpend = doubleSpend;
+    if (serviceError !== undefined)
+        result.serviceError = serviceError;
+    if (competingTxs !== undefined)
+        result.competingTxs = competingTxs;
+    const blockHash = read(source, 'blockHash');
+    if (blockHash !== undefined)
+        result.blockHash = (0, validateMerklePathResult_1.normalizeTxid)(blockHash, `${name}.blockHash`);
+    const blockHeight = read(source, 'blockHeight');
+    if (blockHeight !== undefined) {
+        if (!Number.isSafeInteger(blockHeight) ||
+            blockHeight < 0 ||
+            blockHeight > MAX_BLOCK_HEIGHT) {
+            invalid(`${name}.blockHeight`, `an integer from 0 through ${MAX_BLOCK_HEIGHT}, or absent`);
+        }
+        result.blockHeight = blockHeight;
+    }
+    const data = read(source, 'data');
+    if (data !== undefined)
+        result.data = copyJsonValue(data, `${name}.data`, budget);
+    const notes = copyNotes(read(source, 'notes'), `${name}.notes`, budget, allowInternalTimeoutNote);
+    if (notes.length > 0)
+        result.notes = notes;
+    return result;
+}
+function validatePostBeefResult(value, expectedTxids, configuredProviderName, allowInternalTimeoutNote = false) {
+    const expected = new Set(expectedTxids.map((txid, index) => (0, validateMerklePathResult_1.normalizeTxid)(txid, `txids[${index}]`)));
+    if (expected.size !== expectedTxids.length || expected.size === 0 || expected.size > exports.MAX_POST_BEEF_TXIDS) {
+        invalid('txids', `1 through ${exports.MAX_POST_BEEF_TXIDS} unique transaction IDs`);
+    }
+    const source = plainDescriptors(value, 'postBeef result');
+    if (Object.keys(source).some(key => !['name', 'status', 'error', 'txidResults', 'data', 'notes'].includes(key))) {
+        invalid('postBeef result', 'only documented aggregate-result fields');
+    }
+    const name = boundedText(configuredProviderName, 'postBeef provider name', 128);
+    const status = read(source, 'status');
+    if (status !== 'success' && status !== 'error')
+        invalid('postBeef result.status', "'success' or 'error'");
+    const budget = { notes: MAX_TOTAL_NOTES, nodes: MAX_DATA_NODES, bytes: MAX_DATA_BYTES };
+    const txidResults = denseArray(read(source, 'txidResults'), 'postBeef result.txidResults', expected.size).map((candidate, index) => copyTxidResult(candidate, index, expected, budget, allowInternalTimeoutNote));
+    if (txidResults.length !== expected.size || new Set(txidResults.map(result => result.txid)).size !== expected.size) {
+        invalid('postBeef result.txidResults', 'exactly one result for every requested transaction ID');
+    }
+    const allSuccessful = txidResults.every(result => result.status === 'success');
+    if ((status === 'success') !== allSuccessful) {
+        invalid('postBeef result.status', 'success exactly when every requested transaction result succeeds');
+    }
+    const result = { name, status, txidResults };
+    const error = read(source, 'error');
+    if (error !== undefined) {
+        if (status !== 'error' || !(error instanceof Error))
+            invalid('postBeef result.error', 'an Error on an error result');
+        result.error = WalletError_1.WalletError.fromUnknown(error);
+    }
+    const data = read(source, 'data');
+    if (data !== undefined)
+        result.data = copyJsonValue(data, 'postBeef result.data', budget);
+    const notes = copyNotes(read(source, 'notes'), 'postBeef result.notes', budget, allowInternalTimeoutNote);
+    if (notes.length > 0)
+        result.notes = notes;
+    return result;
+}
+function validatePostTxResult(value, expectedTxid, configuredProviderName) {
+    const source = plainDescriptors(value, 'post transaction result');
+    const status = read(source, 'status');
+    const aggregate = validatePostBeefResult({
+        name: configuredProviderName,
+        status,
+        txidResults: [value]
+    }, [expectedTxid], configuredProviderName);
+    return aggregate.txidResults[0];
+}
+function validatePostTxResultOrServiceError(value, expectedTxid, configuredProviderName) {
+    try {
+        return validatePostTxResult(value, expectedTxid, configuredProviderName);
+    }
+    catch {
+        return makePostBeefServiceError(configuredProviderName, [expectedTxid], 'postBeefServiceError').txidResults[0];
+    }
+}
+function validatePostBeefResultOrServiceError(value, expectedTxids, configuredProviderName) {
+    try {
+        return validatePostBeefResult(value, expectedTxids, configuredProviderName);
+    }
+    catch {
+        return makePostBeefServiceError(configuredProviderName, expectedTxids, 'postBeefServiceError');
+    }
+}
+function snapshotPostBeefRequest(beef, txids) {
+    if (!(beef instanceof sdk_1.Beef))
+        invalid('beef', 'a BEEF instance');
+    const normalizedTxids = normalizePostTxids(txids);
+    const beefBytes = Array.from(beef.toBinary());
+    if (beefBytes.length === 0 || beefBytes.length > exports.MAX_POST_BEEF_BYTES) {
+        invalid('beef', `a serialized BEEF no larger than ${exports.MAX_POST_BEEF_BYTES} bytes`);
+    }
+    const owned = sdk_1.Beef.fromBinaryStrict(beefBytes);
+    for (const [index, txid] of normalizedTxids.entries()) {
+        const rawTx = owned.findTxid(txid)?.rawTx;
+        if (rawTx == null || (0, utils_1.toHex)((0, utilityHelpers_1.doubleSha256BE)(Array.from(rawTx))) !== txid) {
+            invalid(`txids[${index}]`, 'a raw transaction with the exact ID in the submitted BEEF');
+        }
+    }
+    return { beefBytes, txids: normalizedTxids };
+}
+function makePostBeefServiceError(providerName, txids, what, timeoutMs) {
+    const candidate = {
+        name: providerName,
+        status: 'error',
+        txidResults: txids.map(txid => ({ txid, status: 'error', serviceError: true })),
+        notes: [
+            {
+                when: new Date().toISOString(),
+                what,
+                ...(timeoutMs === undefined ? {} : { timeoutMs })
+            }
+        ]
+    };
+    return validatePostBeefResult(candidate, txids, providerName, true);
+}
+//# sourceMappingURL=validatePostBeefResult.js.map