@bsv/overlay 2.3.0 → 2.6.1

package/dist/esm/src/EngineAdmission.js

@@ -0,0 +1,280 @@
+import { createHash } from 'node:crypto';
+import { extractMerkleProofMetadata } from './BASM.js';
+import { admissionSemanticDigest, asStorageUint64, getAdmissionStorage } from './storage/AdmissionStorage.js';
+export const OVERLAY_ENGINE_POLICY_ID = 'overlay-engine-submit-v1';
+export function getOverlayAdmissionHost(storage) {
+    const admission = getAdmissionStorage(storage);
+    if (admission === undefined || typeof storage !== 'object' || storage === null)
+        return undefined;
+    if (!('admissionScope' in storage))
+        return undefined;
+    const scope = storage.admissionScope;
+    if (scope === undefined ||
+        typeof scope.network !== 'string' ||
+        typeof scope.genesisHash !== 'string' ||
+        typeof scope.nodeId !== 'string' ||
+        !/^[0-9a-f]{64}$/.test(scope.genesisHash)) {
+        return undefined;
+    }
+    const host = storage;
+    return {
+        admission,
+        admissionScope: { ...scope },
+        // Adapters are class instances whose methods read instance state, so each
+        // optional method stays bound to the storage it came from.
+        publishAdmissionPayload: host.publishAdmissionPayload?.bind(host),
+        enlistedIndexTargets: host.enlistedIndexTargets?.bind(host),
+        getHistoryFence: host.getHistoryFence?.bind(host)
+    };
+}
+export function overlayAdmissionContextDigest(offChainValues) {
+    const hash = createHash('sha256');
+    if (offChainValues !== undefined)
+        hash.update(Buffer.from(offChainValues));
+    return hash.digest('hex');
+}
+export function overlayAdmissionOperationId(_mode, txid, topics) {
+    const topicKey = [...topics].sort((a, b) => a.localeCompare(b, 'en')).join('\n');
+    // Historical GASP replay and a later live retry represent the same
+    // transaction admission. Keep their id stable so the durable admission
+    // record is replayed instead of being submitted a second time.
+    const raw = `submit:${txid}:${topicKey}`;
+    if (Buffer.byteLength(raw, 'utf8') <= 512 && raw.isWellFormed())
+        return raw;
+    return `submit:${createHash('sha256').update(raw, 'utf8').digest('hex')}`;
+}
+export function overlayAdmissionMode(mode) {
+    return mode === 'current-tx' ? 'live' : 'historical';
+}
+async function localPayload(host, kind, bytes, txid) {
+    if (host.publishAdmissionPayload !== undefined) {
+        return await host.publishAdmissionPayload({ kind, bytes, txid });
+    }
+    return {
+        kind,
+        digest: createHash('sha256').update(bytes).digest('hex'),
+        byteLength: asStorageUint64(String(bytes.byteLength))
+    };
+}
+/**
+ * Selects the topics that require a new admission decision: topics that did
+ * not fail validation, are not already-applied dupes, and actually admit or
+ * retain something (or consume a previously-admitted coin). Already-applied
+ * (dupe) topics are excluded so that a retry — including a historical GASP
+ * replay after a live admit, or a multi-topic resubmit where only some
+ * topics were previously applied — never re-submits an admission decision
+ * for a topic that MongoAdmissionStorage.assertAppliedAvailable would reject
+ * as belonging to a different operation.
+ */
+export function selectNewAdmissionTopics(validations, failedTopics) {
+    return validations.filter(validation => !failedTopics.has(validation.topic) &&
+        !validation.isDupe &&
+        (validation.admissibleOutputs.outputsToAdmit.length > 0 ||
+            validation.admissibleOutputs.coinsToRetain.length > 0 ||
+            validation.previousCoins.length > 0));
+}
+export async function buildOverlayAdmissionPlan(input) {
+    // Only topics with a genuinely new admission get an identity/decision entry
+    // and take part in the commit. Dupe topics are still reflected in `steak`
+    // below (with their empty admissibleOutputs), matching what the classic
+    // storage path already returns for a dupe, but they must never be
+    // resubmitted to commitAdmission: MongoAdmissionStorage.assertAppliedAvailable
+    // rejects an applied row whose admissionId belongs to a different
+    // operation, which a dupe re-included here would trigger on retry.
+    const accepted = selectNewAdmissionTopics(input.validations, input.failedTopics);
+    const identityTopics = accepted.map(validation => ({
+        topic: validation.topic,
+        policyId: OVERLAY_ENGINE_POLICY_ID
+    }));
+    if (identityTopics.length === 0)
+        throw new Error('Overlay admission plan has no topics');
+    const identity = {
+        scope: input.host.admissionScope,
+        txid: input.txid,
+        mode: input.mode,
+        contextDigest: overlayAdmissionContextDigest(input.offChainValues),
+        topics: identityTopics
+    };
+    const raw = await localPayload(input.host, 'raw-transaction', Buffer.from(input.tx.toBinary()), input.txid);
+    const payloads = [raw];
+    let proof;
+    if (input.tx.merklePath !== undefined) {
+        proof = await localPayload(input.host, 'merkle-path', Buffer.from(input.tx.merklePath.toBinary()));
+        payloads.push(proof);
+    }
+    const merkle = extractMerkleProofMetadata(input.txid, input.tx.merklePath);
+    const decisions = [];
+    const steak = {};
+    for (const validation of input.validations) {
+        steak[validation.topic] = {
+            outputsToAdmit: validation.admissibleOutputs.outputsToAdmit,
+            coinsToRetain: validation.admissibleOutputs.coinsToRetain,
+            coinsRemoved: validation.admissibleOutputs.coinsRemoved ?? []
+        };
+    }
+    for (const validation of accepted) {
+        const { outputsConsumed, outputsToMarkStale } = classifyCoins(input.tx, validation);
+        const fence = input.host.getHistoryFence === undefined
+            ? { chainEpoch: asStorageUint64('0'), topicHistoryGeneration: asStorageUint64('0') }
+            : await input.host.getHistoryFence(validation.topic);
+        const outputs = [];
+        for (const outputIndex of validation.admissibleOutputs.outputsToAdmit) {
+            const txOut = input.tx.outputs[outputIndex];
+            if (typeof txOut?.satoshis !== 'number' || !Number.isSafeInteger(txOut.satoshis))
+                continue;
+            const scriptBytes = Buffer.from(txOut.lockingScript.toBinary());
+            const script = await localPayload(input.host, 'locking-script', scriptBytes);
+            payloads.push(script);
+            outputs.push({
+                txid: input.txid,
+                outputIndex: asStorageUint64(String(outputIndex)),
+                satoshis: asStorageUint64(String(txOut.satoshis)),
+                score: asStorageUint64(String(Date.now())),
+                script: { payload: script, offset: asStorageUint64('0'), byteLength: script.byteLength }
+            });
+        }
+        const spends = validation.previousOutputs.flatMap(output => output === null
+            ? []
+            : [
+                {
+                    outpoint: { txid: output.txid, outputIndex: asStorageUint64(String(output.outputIndex)) },
+                    expectedVersion: '1',
+                    spender: input.txid
+                }
+            ]);
+        decisions.push({
+            topic: validation.topic,
+            expectedHistory: fence,
+            reads: [],
+            spends,
+            evictions: outputsToMarkStale.map(item => ({
+                txid: item.txid,
+                outputIndex: asStorageUint64(String(item.previousOutputIndex))
+            })),
+            outputs,
+            edges: outputsConsumed.flatMap(source => outputs.map(output => ({
+                source: { txid: source.txid, outputIndex: asStorageUint64(String(source.outputIndex)) },
+                consumer: { txid: output.txid, outputIndex: output.outputIndex }
+            }))),
+            applied: appliedRecord(input, proof, merkle)
+        });
+        steak[validation.topic] = {
+            outputsToAdmit: validation.admissibleOutputs.outputsToAdmit,
+            coinsToRetain: validation.admissibleOutputs.coinsToRetain,
+            coinsRemoved: outputsToMarkStale.map(item => item.inputIndex)
+        };
+    }
+    const enlisted = new Set(input.host.enlistedIndexTargets?.() ?? []);
+    const outbox = Object.keys(input.lookupServices)
+        .filter(target => !enlisted.has(target))
+        .map(target => ({
+        eventId: `${overlayAdmissionOperationId(input.mode, input.txid, input.topics)}:lookup:${target}`,
+        kind: 'lookup',
+        target,
+        payloads: [raw]
+    }));
+    if (input.includePropagation && input.mode === 'live') {
+        outbox.push({
+            eventId: `${overlayAdmissionOperationId(input.mode, input.txid, input.topics)}:propagate`,
+            kind: 'propagation',
+            target: 'ship',
+            payloads: [raw]
+        });
+    }
+    return {
+        key: {
+            scope: input.host.admissionScope,
+            operationId: overlayAdmissionOperationId(input.mode, input.txid, input.topics),
+            semanticDigest: admissionSemanticDigest(identity)
+        },
+        identity,
+        payloads: uniquePayloads(payloads),
+        decisions,
+        outbox,
+        steak: JSON.stringify(steak)
+    };
+}
+export async function waitForAdmissionReceipt(admission, plan, rebuild) {
+    let current = plan;
+    for (let attempt = 0; attempt < 8; attempt += 1) {
+        const result = await admission.commitAdmission(current);
+        if (result.state === 'committed')
+            return result;
+        if (result.state === 'rejected') {
+            if (result.code === 'read-conflict' && attempt < 7) {
+                current = await rebuild();
+                continue;
+            }
+            throw new Error(`Overlay admission rejected: ${result.code}`);
+        }
+        const reconciled = await admission.reconcileAdmission(current.key, result.attemptId);
+        if (reconciled.state === 'committed')
+            return reconciled;
+        if (reconciled.state === 'aborted') {
+            current = await rebuild();
+            continue;
+        }
+        if (reconciled.state === 'rejected') {
+            throw new Error(`Overlay admission rejected: ${reconciled.code}`);
+        }
+    }
+    throw new Error('Overlay admission commit is pending');
+}
+function appliedRecord(input, proof, merkle) {
+    const applied = { txid: input.txid };
+    const firstSeen = input.applied?.firstSeenHeight ?? merkle?.blockHeight;
+    if (firstSeen !== undefined)
+        applied.firstSeenHeight = asStorageUint64(String(firstSeen));
+    if (proof !== undefined)
+        applied.proof = proof;
+    const blockHash = input.applied?.blockHash;
+    const height = input.applied?.blockHeight ?? merkle?.blockHeight;
+    const index = input.applied?.blockIndex ?? merkle?.blockIndex;
+    const merkleRoot = input.applied?.merkleRoot ?? merkle?.merkleRoot;
+    if (blockHash !== undefined &&
+        height !== undefined &&
+        index !== undefined &&
+        merkleRoot !== undefined) {
+        applied.block = {
+            height: asStorageUint64(String(height)),
+            hash: blockHash,
+            index: asStorageUint64(String(index)),
+            merkleRoot
+        };
+    }
+    return applied;
+}
+function uniquePayloads(payloads) {
+    const seen = new Set();
+    const result = [];
+    for (const payload of payloads) {
+        const key = `${payload.kind}:${payload.digest}:${payload.byteLength}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(payload);
+    }
+    return result;
+}
+function classifyCoins(tx, validation) {
+    const outputsConsumed = [];
+    const outputsToMarkStale = [];
+    for (const inputIndex of validation.previousCoins) {
+        const input = tx.inputs[inputIndex];
+        const previousTXID = input.sourceTXID ?? input.sourceTransaction?.id('hex');
+        if (typeof previousTXID !== 'string')
+            continue;
+        if (validation.admissibleOutputs.coinsToRetain.includes(inputIndex)) {
+            outputsConsumed.push({ txid: previousTXID, outputIndex: input.sourceOutputIndex });
+        }
+        else {
+            outputsToMarkStale.push({
+                txid: previousTXID,
+                previousOutputIndex: input.sourceOutputIndex,
+                inputIndex
+            });
+        }
+    }
+    return { outputsConsumed, outputsToMarkStale };
+}
+//# sourceMappingURL=EngineAdmission.js.map

package/dist/esm/src/EngineAdmission.js.map

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

package/dist/esm/src/GASP/OverlayGASPRemote.js

@@ -1,9 +1,14 @@
+import { assertGASPInitialResponse, assertGASPNode, assertHash, assertNonnegativeInteger, assertOutpoint, assertOutputIndex, assertTopic, MAX_GASP_NODE_JSON_BYTES, MAX_GASP_PAGE_SIZE, readPeerJSON, securePeerFetch } from '../RemoteSecurity.js';
 export class OverlayGASPRemote {
     endpointURL;
     topic;
-    constructor(endpointURL, topic) {
-        this.endpointURL = endpointURL;
+    fetchImpl;
+    constructor(endpointURL, topic, fetchImpl) {
+        assertTopic(topic);
+        const secured = securePeerFetch(endpointURL, fetchImpl);
+        this.endpointURL = secured.endpoint;
         this.topic = topic;
+        this.fetchImpl = secured.fetchImpl;
     }
     /**
      * Given an outgoing initial request, sends the request to the foreign instance and obtains their initial response.
@@ -11,11 +16,13 @@ export class OverlayGASPRemote {
      * @returns
      */
     async getInitialResponse(request) {
-        // Send out an HTTP request to the URL (current host for topic)
-        // Include the topic in the request
-        // Parse out response and return correct format
+        assertNonnegativeInteger(request.since, 'GASP request since');
+        const pageLimit = request.limit ?? MAX_GASP_PAGE_SIZE;
+        if (!Number.isSafeInteger(pageLimit) || pageLimit < 1 || pageLimit > MAX_GASP_PAGE_SIZE) {
+            throw new TypeError(`GASP request limit must be between 1 and ${MAX_GASP_PAGE_SIZE}`);
+        }
         const url = `${this.endpointURL}/requestSyncResponse`;
-        const response = await fetch(url, {
+        const response = await this.fetchImpl(url, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -23,22 +30,9 @@ export class OverlayGASPRemote {
             },
             body: JSON.stringify(request)
         });
-        if (!response.ok) {
-            throw new Error(`HTTP error! Status: ${response.status}`);
-        }
-        const result = await response.json();
-        // Validate and return the response in the correct format
-        if (!Array.isArray(result.UTXOList) || typeof result.since !== 'number') {
-            throw new TypeError('Invalid response format');
-        }
-        return {
-            UTXOList: result.UTXOList.map((utxo) => ({
-                txid: utxo.txid,
-                outputIndex: utxo.outputIndex,
-                score: utxo.score ?? 0
-            })),
-            since: result.since
-        };
+        const result = await readPeerJSON(response);
+        assertGASPInitialResponse(result, pageLimit);
+        return result;
     }
     /**
      * Given an outgoing txid, outputIndex and optional metadata, request the associated GASP node from the foreign instance.
@@ -49,7 +43,11 @@ export class OverlayGASPRemote {
      * @returns
      */
     async requestNode(graphID, txid, outputIndex, metadata) {
-        // Send an HTTP request with the provided info and get back a gaspNode
+        assertOutpoint(graphID, 'GASP request graphID');
+        assertHash(txid, 'GASP request txid');
+        assertOutputIndex(outputIndex, 'GASP request outputIndex');
+        if (typeof metadata !== 'boolean')
+            throw new TypeError('GASP request metadata flag is invalid');
         const url = `${this.endpointURL}/requestForeignGASPNode`;
         const body = {
             graphID,
@@ -57,31 +55,17 @@ export class OverlayGASPRemote {
             outputIndex,
             metadata
         };
-        const response = await fetch(url, {
+        const response = await this.fetchImpl(url, {
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json'
+                'Content-Type': 'application/json',
+                'X-BSV-Topic': this.topic
             },
             body: JSON.stringify(body)
         });
-        if (!response.ok) {
-            throw new Error(`HTTP error! Status: ${response.status}`);
-        }
-        const result = await response.json();
-        // Validate and return the response in the correct format
-        if (typeof result.graphID !== 'string' || typeof result.rawTx !== 'string' || typeof result.outputIndex !== 'number') {
-            throw new TypeError('Invalid response format');
-        }
-        const gaspNode = {
-            graphID: result.graphID,
-            rawTx: result.rawTx,
-            outputIndex: result.outputIndex,
-            proof: result.proof,
-            txMetadata: result.txMetadata,
-            outputMetadata: result.outputMetadata,
-            inputs: result.inputs
-        };
-        return gaspNode;
+        const result = await readPeerJSON(response, MAX_GASP_NODE_JSON_BYTES);
+        assertGASPNode(result, { graphID, txid, outputIndex });
+        return result;
     }
     // ---- Now optional methods ----
     // When are only syncing to them

package/dist/esm/src/GASP/OverlayGASPRemote.js.map

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