@bsv/wallet-toolbox-client 2.4.4 → 2.4.20

package/out/src/storage/methods/getBeefForTransaction.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBeefForTransaction = getBeefForTransaction;
-const sdk_1 = require("@bsv/sdk");
-const EntityProvenTx_1 = require("../schema/entities/EntityProvenTx");
-const WERR_errors_1 = require("../../sdk/WERR_errors");
-/**
- * Creates a `Beef` to support the validity of a transaction identified by its `txid`.
- *
- * `storage` is used to retrieve proven transactions and their merkle paths,
- * or proven_tx_req record with beef of external inputs (internal inputs meged by recursion).
- * Otherwise external services are used.
- *
- * `options.maxRecursionDepth` can be set to prevent overly deep chained dependencies. Will throw ERR_EXTSVS_ENVELOPE_DEPTH if exceeded.
- *
- * If `trustSelf` is true, a partial `Beef` will be returned where transactions known by `storage` to
- * be valid by verified proof are represented solely by 'txid'.
- *
- * If `knownTxids` is defined, any 'txid' required by the `Beef` that appears in the array is represented solely as a 'known' txid.
- *
- * @param storage the chain on which txid exists.
- * @param txid the transaction hash for which an envelope is requested.
- * @param options
- */
-async function getBeefForTransaction(storage, txid, options) {
-    const beef = options.mergeToBeef instanceof sdk_1.Beef
-        ? options.mergeToBeef
-        : options.mergeToBeef != null
-            ? sdk_1.Beef.fromBinary(options.mergeToBeef)
-            : new sdk_1.Beef();
-    const knownTxids = new Set(options.knownTxids ?? []);
-    const scheduled = new Set([txid]);
-    let frontier = [{ txid, depth: 0 }];
-    const requestedConcurrency = options.maxConcurrency ?? 8;
-    const concurrency = Number.isFinite(requestedConcurrency)
-        ? Math.max(1, Math.min(32, Math.floor(requestedConcurrency)))
-        : 8;
-    while (frontier.length > 0) {
-        const current = frontier.filter(item => beef.findTxid(item.txid) == null);
-        const resolved = await mapWithConcurrency(current, concurrency, async (item) => await resolveBeefForTransaction(storage, item.txid, options, knownTxids, item.depth));
-        const next = [];
-        for (let i = 0; i < resolved.length; i++) {
-            const result = resolved[i];
-            beef.mergeBeef(result.beef);
-            for (const dependency of result.dependencies) {
-                if (!scheduled.has(dependency) && beef.findTxid(dependency) == null) {
-                    scheduled.add(dependency);
-                    next.push({ txid: dependency, depth: current[i].depth + 1 });
-                }
-            }
-        }
-        frontier = next;
-    }
-    return beef;
-}
-async function mapWithConcurrency(values, concurrency, mapper) {
-    const results = new Array(values.length);
-    let cursor = 0;
-    await Promise.all(Array.from({ length: Math.min(concurrency, values.length) }, async () => {
-        while (cursor < values.length) {
-            const index = cursor++;
-            results[index] = await mapper(values[index]);
-        }
-    }));
-    return results;
-}
-/**
- * @returns rawTx if txid known to network, if merkle proof available then also proven result is valid.
- */
-async function getProvenOrRawTxFromServices(storage, txid, options) {
-    const por = await EntityProvenTx_1.EntityProvenTx.fromTxid(txid, storage.getServices());
-    if ((por.proven != null) && !options.ignoreStorage && !options.ignoreNewProven) {
-        por.proven.provenTxId = await storage.insertProvenTx(por.proven.toApi());
-    }
-    return { proven: por.proven?.toApi(), rawTx: por.rawTx };
-}
-async function resolveBeefForTransaction(storage, txid, options, knownTxids, recursionDepth) {
-    const maxDepth = storage.maxRecursionDepth;
-    if (maxDepth && maxDepth <= recursionDepth) {
-        throw new WERR_errors_1.WERR_INVALID_OPERATION(`Maximum BEEF depth exceeded. Limit is ${storage.maxRecursionDepth}`);
-    }
-    const beef = new sdk_1.Beef();
-    if (knownTxids.has(txid)) {
-        // This txid is one of the txids the caller claims to already know are valid...
-        beef.mergeTxidOnly(txid);
-        return { beef, dependencies: [] };
-    }
-    if (!options.ignoreStorage) {
-        // if we can use storage, ask storage if it has the txid
-        const requiredLevels = options.minProofLevel === undefined ? undefined : options.minProofLevel + recursionDepth;
-        const knownBeef = await storage.getValidBeefForTxid(txid, beef, options.trustSelf, options.knownTxids, undefined, requiredLevels, options.chainTracker, options.skipInvalidProofs);
-        if (knownBeef != null)
-            return { beef: knownBeef, dependencies: [] };
-    }
-    if (options.ignoreServices) {
-        throw new WERR_errors_1.WERR_INVALID_PARAMETER(`txid ${txid}`, `valid transaction on chain ${storage.chain}`);
-    }
-    // if storage doesn't know about txid, use services
-    // to find it and if it has a proof, remember it.
-    const r = await getProvenOrRawTxFromServices(storage, txid, options);
-    if ((r.proven != null) && options.minProofLevel !== undefined && options.minProofLevel > recursionDepth) {
-        // ignore proof at this recursion depth
-        r.proven = undefined;
-    }
-    if (r.proven != null) {
-        // storage has proven this txid,
-        // merge both the raw transaction and its merkle path
-        const mp = new EntityProvenTx_1.EntityProvenTx(r.proven).getMerklePath();
-        if (options.chainTracker != null) {
-            const root = mp.computeRoot();
-            const isValid = await options.chainTracker.isValidRootForHeight(root, r.proven.height);
-            if (!isValid) {
-                if (!options.skipInvalidProofs) {
-                    throw new WERR_errors_1.WERR_INVALID_MERKLE_ROOT(r.proven.blockHash, r.proven.height, root, txid);
-                }
-                // ignore this currently invalid proof and try to recurse deeper
-                r.proven = undefined;
-            }
-        }
-        if (r.proven != null) {
-            beef.mergeRawTx(r.proven.rawTx);
-            beef.mergeBump(mp);
-            return { beef, dependencies: [] };
-        }
-    }
-    if (r.rawTx == null)
-        throw new WERR_errors_1.WERR_INVALID_PARAMETER(`txid ${txid}`, `valid transaction on chain ${storage.chain}`);
-    // merge the raw transaction and recurse over its inputs.
-    const beefTx = beef.mergeRawTx(r.rawTx);
-    return { beef, dependencies: beefTx.inputTxids };
-}
-//# sourceMappingURL=getBeefForTransaction.js.map

package/out/src/storage/methods/getBeefForTransaction.js.map

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

package/out/src/storage/methods/getSyncChunk.d.ts

@@ -1,10 +0,0 @@
-import { StorageReader } from '../StorageReader';
-import { RequestSyncChunkArgs, SyncChunk } from '../../sdk/WalletStorage.interfaces';
-/**
- * Gets the next sync chunk of updated data from un-remoted storage (could be using a remote DB connection).
- * @param storage
- * @param args
- * @returns
- */
-export declare function getSyncChunk(storage: StorageReader, args: RequestSyncChunkArgs): Promise<SyncChunk>;
-//# sourceMappingURL=getSyncChunk.d.ts.map

package/out/src/storage/methods/getSyncChunk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getSyncChunk.d.ts","sourceRoot":"","sources":["../../../../../src/storage/methods/getSyncChunk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAahD,OAAO,EAA6B,oBAAoB,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAI/G;;;;;GAKG;AACH,wBAAsB,YAAY,CAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAwP1G"}

package/out/src/storage/methods/getSyncChunk.js

@@ -1,273 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSyncChunk = getSyncChunk;
-const utilityHelpers_1 = require("../../utility/utilityHelpers");
-const WERR_errors_1 = require("../../sdk/WERR_errors");
-/**
- * Gets the next sync chunk of updated data from un-remoted storage (could be using a remote DB connection).
- * @param storage
- * @param args
- * @returns
- */
-async function getSyncChunk(storage, args) {
-    const r = {
-        fromStorageIdentityKey: args.fromStorageIdentityKey,
-        toStorageIdentityKey: args.toStorageIdentityKey,
-        userIdentityKey: args.identityKey
-    };
-    let itemCount = args.maxItems;
-    let roughSize = args.maxRoughSize;
-    let i = 0;
-    let done = false;
-    const user = (0, utilityHelpers_1.verifyTruthy)(await storage.findUserByIdentityKey(args.identityKey));
-    if ((args.since == null) || user.updated_at > new Date(args.since))
-        r.user = user;
-    const chunkers = [
-        {
-            name: 'provenTx',
-            maxDivider: 100,
-            preAdd: () => {
-                r.provenTxs = [];
-            },
-            addItem: (i) => {
-                r.provenTxs.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.getProvenTxsForUser(args);
-            }
-        },
-        {
-            name: 'outputBasket',
-            maxDivider: 1,
-            preAdd: () => {
-                r.outputBaskets = [];
-            },
-            addItem: (i) => {
-                r.outputBaskets.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findOutputBaskets({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'outputTag',
-            maxDivider: 1,
-            preAdd: () => {
-                r.outputTags = [];
-            },
-            addItem: (i) => {
-                r.outputTags.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findOutputTags({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'txLabel',
-            maxDivider: 1,
-            preAdd: () => {
-                r.txLabels = [];
-            },
-            addItem: (i) => {
-                r.txLabels.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findTxLabels({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'transaction',
-            maxDivider: 25,
-            preAdd: () => {
-                r.transactions = [];
-            },
-            addItem: (i) => {
-                r.transactions.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findTransactions({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'output',
-            maxDivider: 25,
-            preAdd: () => {
-                r.outputs = [];
-            },
-            addItem: (i) => {
-                r.outputs.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findOutputs({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'txLabelMap',
-            maxDivider: 1,
-            preAdd: () => {
-                r.txLabelMaps = [];
-            },
-            addItem: (i) => {
-                r.txLabelMaps.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.getTxLabelMapsForUser(args);
-            }
-        },
-        {
-            name: 'outputTagMap',
-            maxDivider: 1,
-            preAdd: () => {
-                r.outputTagMaps = [];
-            },
-            addItem: (i) => {
-                r.outputTagMaps.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.getOutputTagMapsForUser(args);
-            }
-        },
-        {
-            name: 'certificate',
-            maxDivider: 25,
-            preAdd: () => {
-                r.certificates = [];
-            },
-            addItem: (i) => {
-                r.certificates.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findCertificates({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'certificateField',
-            maxDivider: 25,
-            preAdd: () => {
-                r.certificateFields = [];
-            },
-            addItem: (i) => {
-                r.certificateFields.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findCertificateFields({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'commission',
-            maxDivider: 25,
-            preAdd: () => {
-                r.commissions = [];
-            },
-            addItem: (i) => {
-                r.commissions.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.findCommissions({
-                    partial: { userId: args.userId },
-                    since: args.since,
-                    paged: args.paged
-                });
-            }
-        },
-        {
-            name: 'provenTxReq',
-            maxDivider: 100,
-            preAdd: () => {
-                r.provenTxReqs = [];
-            },
-            addItem: (i) => {
-                r.provenTxReqs.push(i);
-            },
-            findItems: async (storage, args) => {
-                return await storage.getProvenTxReqsForUser(args);
-            }
-        }
-    ];
-    const addItems = async (a) => {
-        if (i >= args.offsets.length) {
-            done = true;
-            return;
-        }
-        let { offset, name: oname } = args.offsets[i++];
-        if (a.name !== oname) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('offsets', `in dependency order. '${a.name}' expected, found ${oname}.`);
-        }
-        let preAddCalled = false;
-        while (!done) {
-            const limit = Math.min(itemCount, Math.max(10, args.maxItems / a.maxDivider));
-            if (limit <= 0)
-                break;
-            const items = await a.findItems(storage, {
-                userId: user.userId,
-                since: args.since,
-                paged: { limit, offset }
-            });
-            checkEntityValues(items);
-            if (!preAddCalled) {
-                a.preAdd();
-                preAddCalled = true;
-            }
-            if (items.length === 0)
-                break;
-            for (const item of items) {
-                offset++;
-                a.addItem(item);
-                itemCount--;
-                roughSize -= JSON.stringify(item).length;
-                if (itemCount <= 0 || roughSize < 0) {
-                    done = true;
-                    break;
-                }
-            }
-        }
-    };
-    for (; !done;) {
-        for (const c of chunkers) {
-            await addItems(c);
-        }
-    }
-    return r;
-}
-function checkIsDate(v) {
-    if (!(v instanceof Date))
-        throw new WERR_errors_1.WERR_INVALID_OPERATION('bad date');
-}
-function checkEntityValues(es) {
-    for (const e of es) {
-        checkIsDate(e['created_at']);
-        checkIsDate(e['updated_at']);
-        for (const key of Object.keys(e))
-            if (e[key] === null)
-                throw new WERR_errors_1.WERR_INVALID_OPERATION();
-    }
-}
-//# sourceMappingURL=getSyncChunk.js.map

package/out/src/storage/methods/getSyncChunk.js.map

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

package/out/src/storage/methods/internalizeAction.d.ts

@@ -1,102 +0,0 @@
-import { Transaction as BsvTransaction, InternalizeActionArgs } from '@bsv/sdk';
-import { StorageProvider } from '../StorageProvider';
-import { AuthId, StorageInternalizeActionResult } from '../../sdk/WalletStorage.interfaces';
-/**
- * Record of a spent-input transition this internalize call performed.
- * Carries enough state to roll back the exact change via
- * {@link restoreInputsToSpendable}: which row, and whether we touched
- * `spentBy` (only true for rows owned by the internalizing user).
- */
-export interface SpentInputTransition {
-    outputId: number;
-    /** true if the call set spentBy; false if only spendable was flipped. */
-    setSpentBy: boolean;
-}
-/**
- * Mark every storage row at each consumed-input outpoint as spent — across
- * all users that track that outpoint. An on-chain spend invalidates the UTXO
- * for every wallet that references it, not just the wallet that called
- * `internalizeAction`. Returns the per-row transitions so the caller can
- * roll back via {@link restoreInputsToSpendable} on broadcast failure.
- *
- * Cross-user semantics:
- *   - For rows owned by `userId` (the internalizing user) we also set
- *     `spentBy=transactionId`. They own the corresponding transaction
- *     record; the FK target exists in their scope.
- *   - For rows owned by other users we set `spendable=false` and leave
- *     `spentBy` untouched. `spentBy` references the owning user's
- *     `transactions.transactionId`, and that user has no record of our
- *     transaction yet — they'd need to internalize it themselves to get
- *     one. Leaving `spentBy` undefined keeps the field consistent with
- *     "this UTXO is spent, but my wallet didn't witness the spend".
- *
- * Mirrors what `createAction` does for wallet-originated transactions and
- * what `TaskUnFail.unfailReq` does when reviving a previously-failed tx.
- * Without this, an externally-broadcast tx that consumed user UTXOs would
- * leave those UTXOs as phantom spendable rows, picked up by subsequent
- * `createAction` fund selection.
- *
- * Idempotent: rows already `spendable=false` are skipped. Rows already
- * `spentBy` a different transaction are also skipped (a competing spend
- * has been recorded; do not overwrite).
- */
-export declare function markUserInputsSpent(storage: StorageProvider, userId: number, tx: BsvTransaction, transactionId: number): Promise<SpentInputTransition[]>;
-/**
- * Revert the spendable=true → false transitions performed by
- * {@link markUserInputsSpent}. Used when an internalize call's downstream
- * broadcast fails non-fatally so the caller can retry with the same UTXOs.
- *
- * Only undoes what was changed: `spendable=true` always; `spentBy=undefined`
- * only when the original transition set it. Avoids clobbering a competing
- * spent-by on cross-user rows.
- *
- * The downstream `attemptToPostReqsToNetwork` path also calls
- * `updateTransactionStatus('failed')` on doubleSpend/invalidTx outcomes,
- * which independently restores same-user inputs (via
- * `EntityTransaction.getInputs` filtered by userId). This explicit rollback
- * covers cross-user rows and any path where the downstream restore did not
- * run, and is a no-op when the downstream restore already happened.
- */
-export declare function restoreInputsToSpendable(storage: StorageProvider, transitions: SpentInputTransition[]): Promise<void>;
-/**
- * Internalize Action allows a wallet to take ownership of outputs in a pre-existing transaction.
- * The transaction may, or may not already be known to both the storage and user.
- *
- * Two types of outputs are handled: "wallet payments" and "basket insertions".
- *
- * A "basket insertion" output is considered a custom output and has no effect on the wallet's "balance".
- *
- * A "wallet payment" adds an outputs value to the wallet's change "balance". These outputs are assigned to the "default" basket.
- *
- * Processing starts with simple validation and then checks for a pre-existing transaction.
- * If the transaction is already known to the user, then the outputs are reviewed against the existing outputs treatment,
- * and merge rules are added to the arguments passed to the storage layer.
- *
- * The existing transaction's `status` determines what the merge path does next:
- *  - `'unproven'`, `'completed'`, or `'sending'`: outputs are merged into the existing record. The transaction status is left as-is.
- *    The `'sending'` case covers a transaction this wallet already signed and handed to broadcast processing, but
- *    whose proven_tx_req has not yet been advanced by the normal monitor/posting flow.
- *  - `'nosend'`: an ambiguous case. The transaction was created with `noSend: true` and may have been externally
- *    broadcast, may be sitting in a sendWith chain, or may be stuck mid-flight. The merge path treats the
- *    `internalizeAction` call as explicit authorization to advance the lifecycle. Specifically: `transactions.status`
- *    is promoted to `'completed'` (when a BUMP is included in the BEEF) or `'unproven'` (otherwise), and the
- *    `proven_tx_req` is moved out of `'nosend'` so Monitor's standard proof-fetching flow can finalize it.
- *    This makes the `internalizeAction` semantics consistent regardless of whether the originator shares the
- *    same storage as the internalizer or not.
- *  - Any other status: an error.
- *
- * When the transaction already exists, the description is updated. The isOutgoing sense is not changed.
- *
- * "basket insertion" Merge Rules:
- * 1. The "default" basket may not be specified as the insertion basket.
- * 2. Managed change may not be reclassified as a basket insertion.
- * 3. Basket insertions do not affect wallet balance and are typed "custom".
- *
- * "wallet payment" Merge Rules:
- * 1. Targeting an existing managed output is idempotent.
- * 2. Targeting an existing custom output converts it to managed BRC-29
- *    change and increases wallet balance. This includes verified recovery of
- *    a legacy custom row that was incorrectly placed in the default basket.
- */
-export declare function internalizeAction(storage: StorageProvider, auth: AuthId, args: InternalizeActionArgs): Promise<StorageInternalizeActionResult>;
-//# sourceMappingURL=internalizeAction.d.ts.map

package/out/src/storage/methods/internalizeAction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"internalizeAction.d.ts","sourceRoot":"","sources":["../../../../../src/storage/methods/internalizeAction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,IAAI,cAAc,EAG7B,qBAAqB,EAOtB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAsB,MAAM,oCAAoC,CAAA;AAY/G;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,cAAc,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,oBAAoB,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,8BAA8B,CAAC,CAQzC"}