@bsv/overlay 0.1.0-alpha.8 → 0.1.0

package/dist/types/src/Engine.d.ts

@@ -8,6 +8,8 @@ import { LookupQuestion } from './LookupQuestion.js';
 import { LookupAnswer } from './LookupAnswer.js';
 import { ChainTracker, MerklePath, Broadcaster } from '@bsv/sdk';
 import { Advertiser } from './Advertiser.js';
+import { GASPInitialReply, GASPInitialRequest, GASPInitialResponse, GASPNode, GASPNodeResponse, GASPRemote, GASPStorage } from '@bsv/gasp';
+import { SyncConfiguration } from './SyncConfiguration.js';
 /**
  * Am engine for running BSV Overlay Services (topic managers and lookup services).
  */
@@ -20,34 +22,41 @@ export declare class Engine {
     };
     storage: Storage;
     chainTracker: ChainTracker;
-    hostingURL: string;
+    hostingURL?: string | undefined;
     shipTrackers?: string[] | undefined;
     slapTrackers?: string[] | undefined;
     broadcaster?: Broadcaster | undefined;
     advertiser?: Advertiser | undefined;
+    syncConfiguration?: SyncConfiguration | undefined;
     /**
      * Creates a new Overlay Services Engine
      * @param {[key: string]: TopicManager} managers - manages topic admittance
      * @param {[key: string]: LookupService} lookupServices - manages UTXO lookups
      * @param {Storage} storage - for interacting with internally-managed persistent data
      * @param {ChainTracker} chainTracker - Verifies SPV data associated with transactions
-     * @param {string} hostingURL
+     * @param {string} [hostingURL] - The URL this engine is hosted at. Required if going to support peer-discovery with an advertiser.
      * @param {Broadcaster} [Broadcaster] - broadcaster used for broadcasting the incoming transaction
      * @param {Advertiser} [Advertiser] - handles SHIP and SLAP advertisements for peer-discovery
      * @param {string} shipTrackers - SHIP domains we know to bootstrap the system
-     * @param {string} slapTrackers - SAP domains we know to bootstrap the system
+     * @param {string} slapTrackers - SLAP domains we know to bootstrap the system
+     * @param {Record<string, string[] | 'SHIP'>} syncConfiguration — Configuration object describing historical synchronization of topics.
      */
     constructor(managers: {
         [key: string]: TopicManager;
     }, lookupServices: {
         [key: string]: LookupService;
-    }, storage: Storage, chainTracker: ChainTracker, hostingURL: string, shipTrackers?: string[] | undefined, slapTrackers?: string[] | undefined, broadcaster?: Broadcaster | undefined, advertiser?: Advertiser | undefined);
+    }, storage: Storage, chainTracker: ChainTracker, hostingURL?: string | undefined, shipTrackers?: string[] | undefined, slapTrackers?: string[] | undefined, broadcaster?: Broadcaster | undefined, advertiser?: Advertiser | undefined, syncConfiguration?: SyncConfiguration | undefined);
     /**
      * Submits a transaction for processing by Overlay Services.
-     * @param taggedBEEF — The transaction to process
-     * @returns The submitted transaction execution acknowledgement
+     * @param {TaggedBEEF} taggedBEEF - The transaction to process
+     * @param {function(STEAK): void} [onSTEAKReady] - Optional callback function invoked when the STEAK is ready.
+     * @param {string} mode — Indicates the submission behavior, whether historical or current. Historical transactions are not broadcast or propagated.
+     *
+     * The optional callback function should be used to get STEAK when ready, and avoid waiting for broadcast and transaction propagation to complete.
+     *
+     * @returns {Promise<STEAK>} The submitted transaction execution acknowledgement
      */
-    submit(taggedBEEF: TaggedBEEF): Promise<STEAK>;
+    submit(taggedBEEF: TaggedBEEF, onSteakReady?: (steak: STEAK) => void, mode?: 'historical-tx' | 'current-tx'): Promise<STEAK>;
     /**
      * Submit a lookup question to the Overlay Services Engine, and receive bakc a Lookup Answer
      * @param LookupQuestion — The question to ask the Overlay Services Engine
@@ -74,6 +83,36 @@ export declare class Engine {
      * @returns {Promise<void>} A promise that resolves when the synchronization process is complete.
      */
     syncAdvertisements(): Promise<void>;
+    /**
+     * This method goes through each topic that we support syncing and attempts to sync with each endpoint
+     * associated with that topic. If the sync configuration is 'SHIP', it will sync to all peers that support
+     * the topic.
+     *
+     * @throws Error if the overlay service engine is not configured for topical synchronization.
+     */
+    startGASPSync(): Promise<void>;
+    /**
+     * Given a GASP request, create an initial response.
+     *
+     * This method processes an initial synchronization request by finding the relevant UTXOs for the given topic
+     * since the provided (TODO: timestamp or block height, we need to decide on sync timing semantics) in the request. It constructs a response that includes a list of these UTXOs
+     * and the (timestamp or block height, TODO...) from the initial request.
+     *
+     * @param initialRequest - The GASP initial request containing the version and the (timestamp or block height, TODO...) since the last sync.
+     * @param topic - The topic for which UTXOs are being requested.
+     * @returns A promise that resolves to a GASPInitialResponse containing the list of UTXOs and the provided timestamp.
+     */
+    provideForeignSyncResponse(initialRequest: GASPInitialRequest, topic: string): Promise<GASPInitialResponse>;
+    /**
+     * Provides a GASPNode for the given graphID, transaction ID, and output index.
+     *
+     * @param graphID - The identifier for the graph to which this node belongs (in the format txid.outputIndex).
+     * @param txid - The transaction ID for the requested output from somewhere within the graph's history.
+     * @param outputIndex - The index of the output in the transaction.
+     * @returns A promise that resolves to a GASPNode containing the raw transaction and other optional data.
+     * @throws An error if no output is found for the given transaction ID and output index.
+     */
+    provideForeignGASPNode(graphID: string, txid: string, outputIndex: number): Promise<GASPNode>;
     /**
      * Traverse and return the history of a UTXO.
      *
@@ -97,13 +136,23 @@ export declare class Engine {
      */
     private deleteUTXODeep;
     /**
-     * Recursively updates the Merkle proof for the given output and its consumedBy outputs.
-     * If the output matches the source transaction ID, its Merkle proof is updated directly.
-     * Otherwise, the Merkle proof is updated for the corresponding input in each transaction.
+     * Given a new transaction proof (txid, proof),
+     *
+     * update tx.merklePath if appropriate,
+     *
+     * and if not, recurse through all input sourceTransactions.
+     *
+     * @param tx transaction which may benefit from new proof.
+     * @param txid BE hex string double hash of transaction proven by proof.
+     * @param proof for txid
+     */
+    private updateInputProofs;
+    /**
+     * Recursively updates beefs (merkle proofs) of this output and its consumedBy lineage.
      *
-     * @param output - The output to update with the new Merkle proof.
-     * @param proof - The Merkle proof to be applied to the output or its inputs.
-     * @param sourceTxid - The transaction ID of the source output whose Merkle proof is being updated.
+     * @param output - An output derived from txid which may benefit from new proof.
+     * @param txid - The txid for which proof is a valid merkle path.
+     * @param proof - The merklePath proving txid is a mined transaction hash
      */
     private updateMerkleProof;
     /**
@@ -138,4 +187,111 @@ export declare class Engine {
      */
     getDocumentationForLookupServiceProvider(provider: any): Promise<string>;
 }
+export declare class OverlayGASPRemote implements GASPRemote {
+    endpointURL: string;
+    topic: string;
+    constructor(endpointURL: string, topic: string);
+    /**
+     * Given an outgoing initial request, sends the request to the foreign instance and obtains their initial response.
+     * @param request
+     * @returns
+     */
+    getInitialResponse(request: GASPInitialRequest): Promise<GASPInitialResponse>;
+    /**
+     * Given an outgoing txid, outputIndex and optional metadata, request the associated GASP node from the foreign instance.
+     * @param graphID
+     * @param txid
+     * @param outputIndex
+     * @param metadata
+     * @returns
+     */
+    requestNode(graphID: string, txid: string, outputIndex: number, metadata: boolean): Promise<GASPNode>;
+    getInitialReply(response: GASPInitialResponse): Promise<GASPInitialReply>;
+    submitNode(node: GASPNode): Promise<void | GASPNodeResponse>;
+}
+/**
+ * Represents a node in the temporary graph.
+ */
+export interface GraphNode {
+    txid: string;
+    time: number;
+    graphID: string;
+    rawTx: string;
+    outputIndex: number;
+    spentBy?: string;
+    proof?: string;
+    txMetadata?: string;
+    outputMetadata?: string;
+    inputs?: Record<string, {
+        hash: string;
+    }> | undefined;
+    children: GraphNode[];
+    parent?: GraphNode;
+}
+export declare class OverlayGASPStorage implements GASPStorage {
+    topic: string;
+    engine: Engine;
+    maxNodesInGraph?: number | undefined;
+    readonly temporaryGraphNodeRefs: Record<string, GraphNode>;
+    constructor(topic: string, engine: Engine, maxNodesInGraph?: number | undefined);
+    /**
+     *
+     * @param since
+     * @returns
+     */
+    findKnownUTXOs(since: number): Promise<Array<{
+        txid: string;
+        outputIndex: number;
+    }>>;
+    hydrateGASPNode(graphID: string, txid: string, outputIndex: number, metadata: boolean): Promise<GASPNode>;
+    /**
+    * For a given node, returns the inputs needed to complete the graph, including whether updated metadata is requested for those inputs.
+    * @param tx The node for which needed inputs should be found.
+    * @returns A promise for a mapping of requested input transactions and whether metadata should be provided for each.
+    */
+    findNeededInputs(tx: GASPNode): Promise<GASPNodeResponse | undefined>;
+    /**
+     * Ensures that no inputs are requested from foreign nodes before sending any GASP response
+     * Also terminates graphs if the response would be empty.
+     */
+    private stripAlreadyKnownInputs;
+    /**
+    * Appends a new node to a temporary graph.
+    * @param tx The node to append to this graph.
+    * @param spentBy Unless this is the same node identified by the graph ID, denotes the TXID and input index for the node which spent this one, in 36-byte format.
+    * @throws If the node cannot be appended to the graph, either because the graph ID is for a graph the recipient does not want or because the graph has grown to be too large before being finalized.
+    */
+    appendToGraph(tx: GASPNode, spentBy?: string | undefined): Promise<void>;
+    /**
+      * Checks whether the given graph, in its current state, makes reference only to transactions that are proven in the blockchain, or already known by the recipient to be valid.
+      * Additionally, in a breadth-first manner (ensuring that all inputs for any given node are processed before nodes that spend them), it ensures that the root node remains valid according to the rules of the overlay's topic manager,
+      * while considering any coins which the Manager had previously indicated were either valid or invalid.
+      *
+      * 1. Confirm that we are well anchored (according to the rules of SPV)
+      * 2. Is there some sequence of nodes that will result in the admittance of the root node into the topic
+      * 3. If there is some spend chain that, when executed in order to the root node, leads to a valid admittance, we are good to go.
+      *    a) For each node in the chain we need to check topical admittance (such that all relevant inputs to any given node are executed before the node in question).
+      *    b) Once previous nodes are validated, they are taken into account as previous coins to their direct spenders.
+      *
+      * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the tip of this graph.
+      * @throws If the graph is not well-anchored, according to the rules of Bitcoin or the rules of the Overlay Topic Manager.
+      */
+    validateGraphAnchor(graphID: string): Promise<void>;
+    /**
+     * Deletes all data associated with a temporary graph that has failed to sync, if the graph exists.
+     * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the tip of this graph.
+     */
+    discardGraph(graphID: string): Promise<void>;
+    /**
+     * Finalizes a graph, solidifying the new UTXO and its ancestors so that it will appear in the list of known UTXOs.
+     * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the root of this graph.
+     */
+    finalizeGraph(graphID: string): Promise<void>;
+    /**
+     * Computes a full BEEF for a given graph node, based on the temporary graph store.
+     * @param node Graph node for which BEEF is needed.
+     * @returns BEEF array, including all proofs on inputs.
+     */
+    private getBEEFForNode;
+}
 //# sourceMappingURL=Engine.d.ts.map

package/dist/types/src/Engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../../src/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAe,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C;;GAEG;AACH,qBAAa,MAAM;IAcR,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE;IACzC,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE;IAChD,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,YAAY;IAC1B,UAAU,EAAE,MAAM;IAClB,YAAY,CAAC;IACb,YAAY,CAAC;IACb,WAAW,CAAC;IACZ,UAAU,CAAC;IArBpB;;;;;;;;;;;OAWG;gBAEM,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,EACzC,cAAc,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,EAChD,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,sBAAU,EACvB,YAAY,CAAC,sBAAU,EACvB,WAAW,CAAC,yBAAa,EACzB,UAAU,CAAC,wBAAY;IAGhC;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAqRpD;;;;OAIG;IACG,MAAM,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAuCnE;;;;;;;;;;;;;;;;;;OAkBG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEzC;;;;;;;;;;;;;;OAcG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,EAC5G,YAAY,SAAI,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiE9B;;;;OAIG;YACW,cAAc;IA+C5B;;;;;;;;OAQG;YACW,iBAAiB;IAyC/B;;;;;OAKG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5C;;;;OAIG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrD;;;;OAIG;IACG,+BAA+B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpE;;;;OAIG;IACG,wCAAwC,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;CAI/E"}
+{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../../src/Engine.ts"],"names":[],"mappings":"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"}

package/dist/types/src/GASP/OverlayGASPRemote.d.ts

@@ -0,0 +1,23 @@
+import { GASPInitialReply, GASPInitialRequest, GASPInitialResponse, GASPNode, GASPNodeResponse, GASPRemote } from '@bsv/gasp';
+export declare class OverlayGASPRemote implements GASPRemote {
+    endpointURL: string;
+    constructor(endpointURL: string);
+    /**
+     * Given an outgoing initial request, sends the request to the foreign instance and obtains their initial response.
+     * @param request
+     * @returns
+     */
+    getInitialResponse(request: GASPInitialRequest): Promise<GASPInitialResponse>;
+    /**
+     * Given an outgoing txid, outputIndex and optional metadata, request the associated GASP node from the foreign instance.
+     * @param graphID
+     * @param txid
+     * @param outputIndex
+     * @param metadata
+     * @returns
+     */
+    requestNode(graphID: string, txid: string, outputIndex: number, metadata: boolean): Promise<GASPNode>;
+    getInitialReply(response: GASPInitialResponse): Promise<GASPInitialReply>;
+    submitNode(node: GASPNode): Promise<void | GASPNodeResponse>;
+}
+//# sourceMappingURL=OverlayGASPRemote.d.ts.map

package/dist/types/src/GASP/OverlayGASPRemote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayGASPRemote.d.ts","sourceRoot":"","sources":["../../../../src/GASP/OverlayGASPRemote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE7H,qBAAa,iBAAkB,YAAW,UAAU;IAC9B,WAAW,EAAE,MAAM;gBAAnB,WAAW,EAAE,MAAM;IAEvC;;;;OAIG;IACG,kBAAkB,CAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiCpF;;;;;;;OAOG;IACG,WAAW,CAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6CtG,eAAe,CAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM1E,UAAU,CAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,gBAAgB,CAAC;CAGpE"}

package/dist/types/src/GASP/OverlayGASPStorage.d.ts

@@ -0,0 +1,68 @@
+import { GASPNode, GASPNodeResponse, GASPStorage } from '@bsv/gasp';
+import { Engine } from '../Engine.js';
+/**
+ * Represents a node in the temporary graph.
+ */
+export interface GraphNode {
+    txid: string;
+    time: number;
+    graphID: string;
+    rawTx: string;
+    outputIndex: number;
+    spentBy?: string;
+    proof?: string;
+    txMetadata?: string;
+    outputMetadata?: string;
+    inputs?: Record<string, {
+        hash: string;
+    }> | undefined;
+    children: GraphNode[];
+    parent?: GraphNode;
+}
+export declare class OverlayGASPStorage implements GASPStorage {
+    topic: string;
+    engine: Engine;
+    maxNodesInGraph?: number | undefined;
+    readonly temporaryGraphNodeRefs: Record<string, GraphNode>;
+    constructor(topic: string, engine: Engine, maxNodesInGraph?: number | undefined);
+    /**
+     *
+     * @param since
+     * @returns
+     */
+    findKnownUTXOs(since: number): Promise<Array<{
+        txid: string;
+        outputIndex: number;
+    }>>;
+    hydrateGASPNode(graphID: string, txid: string, outputIndex: number, metadata: boolean): Promise<GASPNode>;
+    /**
+    * For a given node, returns the inputs needed to complete the graph, including whether updated metadata is requested for those inputs.
+    * @param tx The node for which needed inputs should be found.
+    * @returns A promise for a mapping of requested input transactions and whether metadata should be provided for each.
+    */
+    findNeededInputs(tx: GASPNode): Promise<GASPNodeResponse | undefined>;
+    /**
+    * Appends a new node to a temporary graph.
+    * @param tx The node to append to this graph.
+    * @param spentBy Unless this is the same node identified by the graph ID, denotes the TXID and input index for the node which spent this one, in 36-byte format.
+    * @throws If the node cannot be appended to the graph, either because the graph ID is for a graph the recipient does not want or because the graph has grown to be too large before being finalized.
+    */
+    appendToGraph(tx: GASPNode, spentBy?: string | undefined): Promise<void>;
+    /**
+      * Checks whether the given graph, in its current state, makes reference only to transactions that are proven in the blockchain, or already known by the recipient to be valid.
+      * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the tip of this graph.
+      * @throws If the graph is not well-anchored.
+      */
+    validateGraphAnchor(graphID: string): Promise<void>;
+    /**
+     * Deletes all data associated with a temporary graph that has failed to sync, if the graph exists.
+     * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the tip of this graph.
+     */
+    discardGraph(graphID: string): Promise<void>;
+    /**
+     * Finalizes a graph, solidifying the new UTXO and its ancestors so that it will appear in the list of known UTXOs.
+     * @param graphID The TXID and output index (in 36-byte format) for the UTXO at the tip of this graph.
+     */
+    finalizeGraph(graphID: string): Promise<void>;
+}
+//# sourceMappingURL=OverlayGASPStorage.d.ts.map

package/dist/types/src/GASP/OverlayGASPStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayGASPStorage.d.ts","sourceRoot":"","sources":["../../../../src/GASP/OverlayGASPStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;IACrD,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAED,qBAAa,kBAAmB,YAAW,WAAW;IAGjC,KAAK,EAAE,MAAM;IAAS,MAAM,EAAE,MAAM;IAAS,eAAe,CAAC;IAFhF,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAK;gBAE5C,KAAK,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM,EAAS,eAAe,CAAC,oBAAQ;IAExF;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IASpF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/G;;;;MAIE;IACI,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAgD3E;;;;;MAKE;IACI,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD9E;;;;QAII;IACE,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwEzD;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/types/src/SyncConfiguration.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Configuration for synchronizing supported topic managers.
+ *
+ * This configuration determines which topics should support synchronization and specifies the mode of synchronization.
+ *
+ * There are two synchronization modes:
+ * 1. Sync to predefined hardcoded peers for the specified topic, including associated hosting URLs.
+ * 2. Use SHIP (Service Host Interconnect Protocol) to sync with all known peers that support the specified topic.
+ *
+ * Each entry in the configuration object maps a topic to either an array of overlay service peers (hardcoded URLs) or the string 'SHIP' (for dynamic syncing using SHIP).
+ *
+ * @example
+ * // Example usage of SyncConfiguration
+ * const config: SyncConfiguration = {
+ *   "topicManager1": ["http://peer1.com", "http://peer2.com"],
+ *   "topicManager2": "SHIP"
+ * }
+ */
+export type SyncConfiguration = Record<string, string[] | 'SHIP'>;
+//# sourceMappingURL=SyncConfiguration.d.ts.map

package/dist/types/src/SyncConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncConfiguration.d.ts","sourceRoot":"","sources":["../../../src/SyncConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAA"}

package/dist/types/src/TopicManager.d.ts

@@ -9,6 +9,14 @@ export interface TopicManager {
      * The transaction's BEEF structure will always contain the transactions associated with previous coins for reference (if any), regardless of whether the current transaction was directly proven.
      */
     identifyAdmissibleOutputs: (beef: number[], previousCoins: number[]) => Promise<AdmittanceInstructions>;
+    /**
+     * Identifies and returns the inputs needed to anchor any topical outputs from this transaction to their associated previous history.
+     * @throws - if there are no potentially valid topical outputs in this transaction
+     */
+    identifyNeededInputs?: (beef: number[]) => Promise<Array<{
+        txid: string;
+        outputIndex: number;
+    }>>;
     /**
     * Returns a Markdown-formatted documentation string for the topic manager.
     */

package/dist/types/src/TopicManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TopicManager.d.ts","sourceRoot":"","sources":["../../../src/TopicManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEvG;;MAEE;IACF,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAEvC;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAA;QACZ,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC,CAAA;CACH"}
+{"version":3,"file":"TopicManager.d.ts","sourceRoot":"","sources":["../../../src/TopicManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEvG;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAEhG;;MAEE;IACF,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAEvC;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAA;QACZ,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC,CAAA;CACH"}

package/dist/types/src/storage/Storage.d.ts

@@ -30,6 +30,13 @@ export interface Storage {
      * @param txid — TXID of the outputs to find
      */
     findOutputsForTransaction: (txid: string) => Promise<Output[]>;
+    /**
+     * Finds current UTXOs that have been admitted into a given topic
+     * @param topic - The topic for which we want to find Unspent Transaction Outputs (UTXOs).
+     * @param since - Optional parameter indicating the minimum date (timestamp? block height?) to retrieve matching UTXOs from. TODO: We need to decide about which time format to use for synchronization.
+     * @returns A promise that resolves to an array of matching UTXOs.
+     */
+    findUTXOsForTopic: (topic: string, since?: number) => Promise<Output[]>;
     /**
      * Deletes an output from storage
      * @param txid — The TXID of the output to delete

package/dist/types/src/storage/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7C;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAE1G;;;OAGG;IACH,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE9D;;;;;OAKG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjF;;;;;MAKE;IACF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpF;;;;;;MAME;IACF,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QACrF,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpB;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAErG;;;OAGG;IACH,wBAAwB,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1E"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../../src/storage/Storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7C;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAE1G;;;OAGG;IACH,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE9D;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvE;;;;;OAKG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjF;;;;;MAKE;IACF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpF;;;;;;MAME;IACF,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QACrF,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpB;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAErG;;;OAGG;IACH,wBAAwB,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;OAIG;IACH,2BAA2B,EAAE,CAAC,EAAE,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1E"}

package/dist/types/src/storage/knex/KnexStorage.d.ts

@@ -6,6 +6,7 @@ export declare class KnexStorage implements Storage {
     constructor(knex: Knex);
     findOutput(txid: string, outputIndex: number, topic?: string, spent?: boolean): Promise<Output | null>;
     findOutputsForTransaction(txid: string): Promise<Output[]>;
+    findUTXOsForTopic(topic: string, since?: number): Promise<Output[]>;
     deleteOutput(txid: string, outputIndex: number, topic: string): Promise<void>;
     insertOutput(output: Output): Promise<void>;
     markUTXOAsSpent(txid: string, outputIndex: number, topic?: string): Promise<void>;

package/dist/types/src/storage/knex/KnexStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnexStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/knex/KnexStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,qBAAa,WAAY,YAAW,OAAO;IACzC,IAAI,EAAE,IAAI,CAAA;gBAEE,IAAI,EAAE,IAAI;IAIhB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BtG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiB1D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3I,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjG,wBAAwB,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E,2BAA2B,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAOzF"}
+{"version":3,"file":"KnexStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/knex/KnexStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,qBAAa,WAAY,YAAW,OAAO;IACzC,IAAI,EAAE,IAAI,CAAA;gBAEE,IAAI,EAAE,IAAI;IAIhB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BtG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmB1D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BnE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3I,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjG,wBAAwB,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E,2BAA2B,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAOzF"}