@bsv/wallet-toolbox-client 2.4.4 → 2.4.20

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

@@ -1,777 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setDisableDoubleSpendCheckForTest = setDisableDoubleSpendCheckForTest;
-exports.createAction = createAction;
-const sdk_1 = require("@bsv/sdk");
-const generateChange_1 = require("./generateChange");
-const StorageProvider_1 = require("../StorageProvider");
-const WERR_errors_1 = require("../../sdk/WERR_errors");
-const utilityHelpers_1 = require("../../utility/utilityHelpers");
-const utilityHelpers_noBuffer_1 = require("../../utility/utilityHelpers.noBuffer");
-const EntityProvenTx_1 = require("../schema/entities/EntityProvenTx");
-const Wallet_1 = require("../../Wallet");
-const offsetKey_1 = require("./offsetKey");
-const utils_1 = require("./utils");
-const sdk_2 = require("../../sdk");
-const managedChange_1 = require("./managedChange");
-const actionPlanning_1 = require("./actionPlanning");
-let disableDoubleSpendCheckForTest = true;
-function setDisableDoubleSpendCheckForTest(v) {
-    disableDoubleSpendCheckForTest = v;
-}
-async function createAction(storage, auth, vargs, originator) {
-    const logger = vargs.logger;
-    logger?.group('storage createAction');
-    // stampLog(vargs, `start storage createTransactionSdk`)
-    if (vargs.isTestWerrReviewActions)
-        (0, Wallet_1.throwDummyReviewActions)();
-    if (!vargs.isNewTx) 
-    // The purpose of this function is to create the initial storage records associated
-    // with a new transaction. It's an error if we have no new inputs or outputs...
-    {
-        throw new WERR_errors_1.WERR_INTERNAL();
-    }
-    /**
-     * Steps to create a transaction:
-     * - Verify that all inputs either have proof in vargs.inputBEEF or that options.trustSelf === 'known' and input txid.vout are known valid to storage.
-     * - Create a new transaction record with status 'unsigned' as the anchor for construction work and to new outputs.
-     * - Create all transaction labels.
-     * - Add new commission output
-     * - Attempt to fund the transaction by allocating change outputs:
-     *    - As each change output is selected it is simultaneously locked.
-     * - Create all new output, basket, tag records
-     * - If requested, create result Beef with complete proofs for all inputs used
-     * - Create result inputs with source locking scripts
-     * - Create result outputs with new locking scripts.
-     * - Create and return result.
-     */
-    const userId = auth.userId;
-    const { storageBeef, beef, xinputs } = await validateRequiredInputs(storage, userId, vargs);
-    logger?.log('validated required inputs');
-    const xoutputs = validateRequiredOutputs(storage, userId, vargs);
-    logger?.log('validated required outputs');
-    const changeBasketName = 'default';
-    const changeBasket = (0, utilityHelpers_1.verifyOne)(await storage.findOutputBaskets({
-        partial: { userId, name: changeBasketName }
-    }), `Invalid outputGeneration basket "${changeBasketName}"`);
-    logger?.log('found change basket');
-    const noSendChangeIn = await validateNoSendChange(storage, userId, vargs, changeBasket);
-    logger?.log('validated noSendChange');
-    const availableChangeCount = await storage.countChangeInputs(userId, changeBasket.basketId, !vargs.isDelayed);
-    logger?.log(`counted change inputs ${availableChangeCount}`);
-    const feeModel = (0, StorageProvider_1.validateStorageFeeModel)(storage.feeModel);
-    logger?.log(`validated fee model ${JSON.stringify(feeModel)}`);
-    await preflightInsufficientFundsFastPath(vargs, xinputs, xoutputs, noSendChangeIn, availableChangeCount, feeModel);
-    logger?.log('passed insufficient-funds preflight');
-    let newTx;
-    try {
-        newTx = await createNewTxRecord(storage, userId, vargs, storageBeef);
-        logger?.log('created new transaction record');
-        const ctx = {
-            xinputs,
-            xoutputs,
-            changeBasket,
-            noSendChangeIn,
-            availableChangeCount,
-            feeModel,
-            transactionId: newTx.transactionId
-        };
-        const { allocatedChange, changeOutputs, derivationPrefix, maxPossibleSatoshisAdjustment } = await fundNewTransactionSdk(storage, userId, vargs, ctx);
-        logger?.log('funded new transaction');
-        if (maxPossibleSatoshisAdjustment != null) {
-            const a = maxPossibleSatoshisAdjustment;
-            if (ctx.xoutputs[a.fixedOutputIndex].satoshis !== generateChange_1.maxPossibleSatoshis)
-                throw new WERR_errors_1.WERR_INTERNAL();
-            ctx.xoutputs[a.fixedOutputIndex].satoshis = a.satoshis;
-            logger?.log('adjusted change outputs to max possible');
-        }
-        // The satoshis of the transaction is the satoshis we get back in change minus the satoshis we spend.
-        const satoshis = changeOutputs.reduce((a, e) => a + e.satoshis, 0) - allocatedChange.reduce((a, e) => a + e.satoshis, 0);
-        await storage.updateTransaction(newTx.transactionId, { satoshis });
-        const { outputs, changeVouts } = await createNewOutputs(storage, userId, vargs, ctx, changeOutputs);
-        logger?.log('created new output records');
-        const inputBeef = await mergeAllocatedChangeBeefs(storage, userId, vargs, allocatedChange, beef);
-        logger?.log('merged allocated change beefs');
-        const inputs = await createNewInputs(storage, userId, vargs, ctx, allocatedChange);
-        logger?.log('created new inputs');
-        const r = {
-            reference: newTx.reference,
-            version: newTx.version,
-            lockTime: newTx.lockTime,
-            inputs,
-            outputs,
-            derivationPrefix,
-            inputBeef,
-            noSendChangeOutputVouts: vargs.isNoSend ? changeVouts : undefined
-        };
-        logger?.groupEnd();
-        return r;
-    }
-    catch (error) {
-        if (newTx?.transactionId != null) {
-            try {
-                await storage.updateTransactionStatus('failed', newTx.transactionId);
-                logger?.log(`marked failed createAction transaction ${newTx.transactionId} after construction error`);
-            }
-            catch (cleanupError) {
-                logger?.log(`failed to clean up createAction transaction ${newTx.transactionId}: ${String(cleanupError)}`);
-            }
-        }
-        logger?.groupEnd();
-        throw error;
-    }
-}
-function makeDefaultOutput(userId, transactionId, satoshis, vout) {
-    const now = new Date();
-    const output = {
-        created_at: now,
-        updated_at: now,
-        outputId: 0,
-        userId,
-        transactionId,
-        satoshis,
-        vout,
-        basketId: undefined,
-        change: false,
-        customInstructions: undefined,
-        derivationPrefix: undefined,
-        derivationSuffix: undefined,
-        outputDescription: '',
-        lockingScript: undefined,
-        providedBy: 'you',
-        purpose: '',
-        senderIdentityKey: undefined,
-        spendable: true,
-        spendingDescription: undefined,
-        spentBy: undefined,
-        txid: undefined,
-        type: ''
-    };
-    return output;
-}
-/** Check known outputs for double-spend, mark them spent, return competing txid if found. */
-async function markKnownInputsSpent(storage, knownInputRows, transactionId) {
-    let doubleSpendTxid;
-    await storage.transaction(async (trx) => {
-        const outputIds = knownInputRows.map(ni => (0, utilityHelpers_1.verifyId)(ni.o.outputId));
-        const knownOutputsById = await storage.findOutputsByIds(outputIds, trx);
-        for (const ni of knownInputRows) {
-            const { i, o } = ni;
-            const o2 = knownOutputsById[(0, utilityHelpers_1.verifyId)(o.outputId)];
-            if (!o2)
-                throw new WERR_errors_1.WERR_INTERNAL(`missing outputId ${o.outputId}`);
-            if (o2.spentBy !== undefined && o2.spentBy !== null) {
-                const spendingTx = await storage.findTransactionById((0, utilityHelpers_1.verifyId)(o2.spentBy), trx);
-                if (spendingTx?.txid) {
-                    doubleSpendTxid = spendingTx.txid;
-                    return;
-                }
-            }
-            if (!o2.spendable) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${i.vin}]`, `spendable output. output ${o.txid}:${o.vout} appears to have been spent (spendable=${o2.spendable}).`);
-            }
-            await storage.updateOutput((0, utilityHelpers_1.verifyId)(o.outputId), { spendable: false, spentBy: transactionId, spendingDescription: i.inputDescription }, trx);
-            o.spendable = false;
-            o.spentBy = transactionId;
-            o.spendingDescription = i.inputDescription;
-        }
-    });
-    return doubleSpendTxid;
-}
-/** Build an SDK input record for a new-input row that has a backing output. */
-async function buildSdkInputFromOutput(storage, vargs, vin, i, o, unlockLen) {
-    if ((i == null) && !unlockLen)
-        throw new WERR_errors_1.WERR_INTERNAL(`vin ${vin} non-fixedInput without unlockLen`);
-    const sourceTransaction = vargs.includeAllSourceTransactions && vargs.isSignAction
-        ? await storage.getRawTxOfKnownValidTransaction(o.txid)
-        : undefined;
-    return {
-        vin,
-        sourceTxid: o.txid,
-        sourceVout: o.vout,
-        sourceSatoshis: o.satoshis,
-        sourceLockingScript: (0, utilityHelpers_noBuffer_1.asString)(o.lockingScript),
-        sourceTransaction,
-        unlockingScriptLength: unlockLen || i.unlockingScriptLength,
-        providedBy: (i != null) && o.providedBy === 'storage' ? 'you-and-storage' : o.providedBy,
-        type: o.type,
-        spendingDescription: o.spendingDescription || undefined,
-        derivationPrefix: o.derivationPrefix || undefined,
-        derivationSuffix: o.derivationSuffix || undefined,
-        senderIdentityKey: o.senderIdentityKey || undefined
-    };
-}
-/** Build an SDK input record for a user-specified input with no corresponding stored output. */
-function buildSdkInputFromXInput(vin, i) {
-    return {
-        vin,
-        sourceTxid: i.outpoint.txid,
-        sourceVout: i.outpoint.vout,
-        sourceSatoshis: i.satoshis,
-        sourceLockingScript: i.lockingScript.toHex(),
-        unlockingScriptLength: i.unlockingScriptLength,
-        providedBy: 'you',
-        type: 'custom',
-        spendingDescription: undefined,
-        derivationPrefix: undefined,
-        derivationSuffix: undefined,
-        senderIdentityKey: undefined
-    };
-}
-async function createNewInputs(storage, userId, vargs, ctx, allocatedChange) {
-    const r = [];
-    const newInputs = [];
-    for (const i of ctx.xinputs)
-        newInputs.push({ i, o: i.output });
-    const knownInputRows = newInputs.filter((ni) => ni.i != null && ni.o != null);
-    if (knownInputRows.length > 0) {
-        const doubleSpendTxid = await markKnownInputsSpent(storage, knownInputRows, ctx.transactionId);
-        if (doubleSpendTxid) {
-            const beef = await getCompetingBeefForReview(storage, doubleSpendTxid);
-            throw new WERR_errors_1.WERR_REVIEW_ACTIONS([{ txid: '', status: 'doubleSpend', competingTxs: [doubleSpendTxid], competingBeef: beef.toBinary() }], []);
-        }
-    }
-    for (const o of allocatedChange)
-        newInputs.push({ o, unlockLen: 107 });
-    let vin = -1;
-    for (const { i, o, unlockLen } of newInputs) {
-        vin++;
-        if (o != null) {
-            r.push(await buildSdkInputFromOutput(storage, vargs, vin, i, o, unlockLen));
-        }
-        else {
-            if (i == null)
-                throw new WERR_errors_1.WERR_INTERNAL(`vin ${vin} without output or xinput`);
-            r.push(buildSdkInputFromXInput(vin, i));
-        }
-    }
-    return r;
-}
-async function getCompetingBeefForReview(storage, txid) {
-    try {
-        return await storage.getBeefForTransaction(txid, {});
-    }
-    catch (e) {
-        const walletError = sdk_2.WalletError.fromUnknown(e);
-        if (walletError instanceof WERR_errors_1.WERR_INVALID_PARAMETER || walletError.code === 'WERR_INVALID_PARAMETER') {
-            const beef = new sdk_1.Beef();
-            beef.mergeTxidOnly(txid);
-            return beef;
-        }
-        throw e;
-    }
-}
-/** Randomly reassign vout values across newOutputs using either the provided randomVals or crypto-random bytes. */
-/** Insert the output and attach its tags; return the SDK output descriptor. */
-async function persistNewOutput(storage, o, tags, txTags, txBaskets) {
-    o.outputId = await storage.insertOutput(o);
-    const changeVout = (o.change && o.purpose === 'change' && o.providedBy === 'storage') ? o.vout : undefined;
-    for (const tagName of new Set(tags)) {
-        const tag = txTags[tagName];
-        await storage.insertOutputTagMap({
-            outputId: (0, utilityHelpers_1.verifyId)(o.outputId),
-            outputTagId: (0, utilityHelpers_1.verifyId)(tag.outputTagId),
-            created_at: new Date(),
-            updated_at: new Date(),
-            isDeleted: false
-        });
-    }
-    const ro = {
-        vout: (0, utilityHelpers_1.verifyInteger)(o.vout),
-        satoshis: sdk_1.Validation.validateSatoshis(o.satoshis, 'o.satoshis'),
-        lockingScript: (o.lockingScript == null) ? '' : (0, utilityHelpers_noBuffer_1.asString)(o.lockingScript),
-        providedBy: (0, utilityHelpers_1.verifyTruthy)(o.providedBy),
-        purpose: o.purpose || undefined,
-        basket: Object.values(txBaskets).find(b => b.basketId === o.basketId)?.name,
-        tags,
-        outputDescription: o.outputDescription,
-        derivationSuffix: o.derivationSuffix,
-        customInstructions: o.customInstructions
-    };
-    return { changeVout, ro };
-}
-async function createNewOutputs(storage, userId, vargs, ctx, changeOutputs) {
-    const txBaskets = {};
-    const basketNames = [...new Set(ctx.xoutputs.map(x => x.basket).filter((v) => !!v))];
-    Object.assign(txBaskets, await storage.findOrInsertOutputBasketsBulk(userId, basketNames));
-    const txTags = {};
-    const tagNames = [...new Set(ctx.xoutputs.flatMap(x => x.tags))];
-    Object.assign(txTags, await storage.findOrInsertOutputTagsBulk(userId, tagNames));
-    const newOutputs = [];
-    for (const xo of ctx.xoutputs) {
-        const lockingScript = (0, utilityHelpers_noBuffer_1.asArray)(xo.lockingScript);
-        if (xo.purpose === 'service-charge') {
-            const now = new Date();
-            await storage.insertCommission({ userId, transactionId: ctx.transactionId, lockingScript, satoshis: xo.satoshis, isRedeemed: false, keyOffset: (0, utilityHelpers_1.verifyTruthy)(xo.keyOffset), created_at: now, updated_at: now, commissionId: 0 });
-            const o = makeDefaultOutput(userId, ctx.transactionId, xo.satoshis, xo.vout);
-            o.lockingScript = lockingScript;
-            o.providedBy = 'storage';
-            o.purpose = 'storage-commission';
-            o.type = 'custom';
-            o.spendable = false;
-            newOutputs.push({ o, tags: [] });
-        }
-        else {
-            const o = makeDefaultOutput(userId, ctx.transactionId, xo.satoshis, xo.vout);
-            o.lockingScript = lockingScript;
-            o.basketId = xo.basket ? txBaskets[xo.basket].basketId : undefined;
-            o.customInstructions = xo.customInstructions;
-            o.outputDescription = xo.outputDescription;
-            o.providedBy = xo.providedBy;
-            o.purpose = xo.purpose || '';
-            o.type = 'custom';
-            newOutputs.push({ o, tags: xo.tags });
-        }
-    }
-    for (const o of changeOutputs) {
-        o.spendable = true;
-        newOutputs.push({ o, tags: [] });
-    }
-    if (vargs.options.randomizeOutputs)
-        (0, actionPlanning_1.randomizeOutputVouts)(newOutputs.map(output => output.o), vargs.randomVals);
-    const outputs = [];
-    const changeVouts = [];
-    for (const { o, tags } of newOutputs) {
-        const { changeVout, ro } = await persistNewOutput(storage, o, tags, txTags, txBaskets);
-        if (changeVout !== undefined)
-            changeVouts.push(changeVout);
-        outputs.push(ro);
-    }
-    return { outputs, changeVouts };
-}
-async function createNewTxRecord(storage, userId, vargs, storageBeef) {
-    const now = new Date();
-    const newTx = {
-        created_at: now,
-        updated_at: now,
-        transactionId: 0,
-        version: vargs.version,
-        lockTime: vargs.lockTime,
-        status: 'unsigned',
-        reference: (0, utilityHelpers_1.randomBytesBase64)(12),
-        satoshis: 0, // updated after fundingTransaction
-        userId,
-        isOutgoing: true,
-        inputBEEF: storageBeef.toBinary(),
-        description: vargs.description,
-        txid: undefined,
-        rawTx: undefined
-    };
-    newTx.transactionId = await storage.insertTransaction(newTx);
-    for (const label of vargs.labels) {
-        const txLabel = await storage.findOrInsertTxLabel(userId, label);
-        await storage.findOrInsertTxLabelMap((0, utilityHelpers_1.verifyId)(newTx.transactionId), (0, utilityHelpers_1.verifyId)(txLabel.txLabelId));
-    }
-    return newTx;
-}
-/**
- * Convert vargs.outputs:
- *
- * lockingScript: HexString
- * satoshis: SatoshiValue
- * outputDescription: DescriptionString5to50Bytes
- * basket?: BasketStringUnder300Bytes
- * customInstructions?: string
- * tags: BasketStringUnderBytes[]
- *
- * to XValidCreateActionOutput (which aims for StorageCreateTransactionSdkOutput)
- *
- * adds:
- *   vout: number
- *   providedBy: StorageProvidedBy
- *   purpose?: string
- *   derivationSuffix?: string
- *   keyOffset?: string
- *
- * @param vargs
- * @returns xoutputs
- */
-function validateRequiredOutputs(storage, userId, vargs) {
-    const xoutputs = [];
-    let vout = -1;
-    for (const output of vargs.outputs) {
-        vout++;
-        const xo = {
-            ...output,
-            vout,
-            providedBy: 'you',
-            purpose: undefined,
-            derivationSuffix: undefined,
-            keyOffset: undefined
-        };
-        xoutputs.push(xo);
-    }
-    if (storage.commissionSatoshis > 0 && storage.commissionPubKeyHex) {
-        vout++;
-        const { script, keyOffset } = (0, offsetKey_1.createStorageServiceChargeScript)(storage.commissionPubKeyHex);
-        xoutputs.push({
-            lockingScript: script,
-            satoshis: storage.commissionSatoshis,
-            outputDescription: 'Storage Service Charge',
-            basket: undefined,
-            tags: [],
-            vout,
-            providedBy: 'storage',
-            purpose: 'service-charge',
-            keyOffset
-        });
-    }
-    return xoutputs;
-}
-/**
- * Verify that we are in posession of validity proof data for any inputs being proposed for a new transaction.
- *
- * `vargs.inputs` is the source of inputs.
- * `vargs.inputBEEF` may include new user supplied validity data.
- * 'vargs.options.trustSelf === 'known'` indicates whether we can rely on the storage database records.
- *
- * If there are no inputs, returns an empty `Beef`.
- *
- * Always pulls rawTx data into first level of validity chains so that parsed transaction data is available
- * and checks input sourceSatoshis as well as filling in input sourceLockingScript.
- *
- * This data may be pruned again before being returned to the user based on `vargs.options.knownTxids`.
- *
- * @param storage
- * @param userId
- * @param vargs
- * @returns {storageBeef} containing only validity proof data for only unknown required inputs.
- * @returns {beef} containing verified validity proof data for all required inputs.
- * @returns {xinputs} extended validated required inputs.
- */
-async function validateRequiredInputs(storage, userId, vargs) {
-    // stampLog(vargs, `start storage verifyInputBeef`)
-    const beef = new sdk_1.Beef();
-    if (vargs.inputs.length === 0)
-        return { storageBeef: beef, beef, xinputs: [] };
-    if (vargs.inputBEEF != null)
-        beef.mergeBeef(vargs.inputBEEF);
-    const xinputs = vargs.inputs.map((input, vin) => ({
-        ...input,
-        vin,
-        satoshis: -1,
-        lockingScript: new sdk_1.Script(),
-        output: undefined
-    }));
-    const trustSelf = vargs.options.trustSelf === 'known';
-    const preloadedOutputsByOutpoint = await storage.findOutputsByOutpoints(userId, xinputs.map(i => ({ txid: i.outpoint.txid, vout: i.outpoint.vout })));
-    const preloadedOutputIds = Object.values(preloadedOutputsByOutpoint).map(output => output.outputId);
-    if ((await storage.findReservedActionBatchOutputIds(preloadedOutputIds)).length > 0) {
-        throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputs', 'outputs not reserved by an active action batch');
-    }
-    const inputsByTxid = {};
-    for (const input of xinputs) {
-        inputsByTxid[input.outpoint.txid] ||= [];
-        inputsByTxid[input.outpoint.txid].push(input);
-    }
-    const localKnownInputTxids = {};
-    for (const [txid, txInputs] of Object.entries(inputsByTxid)) {
-        localKnownInputTxids[txid] = txInputs.every(input => {
-            const output = preloadedOutputsByOutpoint[`${input.outpoint.txid}.${input.outpoint.vout}`];
-            return output?.lockingScript !== undefined && Number.isInteger(output?.satoshis);
-        });
-    }
-    await validateBeefTxidOnlyEntries(beef, inputsByTxid, trustSelf, storage);
-    await ensureBeefContainsAllInputTxids(beef, inputsByTxid, localKnownInputTxids, trustSelf, storage);
-    if (!(await beef.verify(await storage.getServices().getChainTracker(), true))) {
-        console.log(`verifyInputBeef failed, inputBEEF failed to verify.\n${beef.toLogString()}\n`);
-        throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputBEEF', 'valid Beef when factoring options.trustSelf');
-    }
-    const storageBeef = beef.clone();
-    for (const input of xinputs) {
-        await resolveInputScript(storage, userId, vargs, input, beef, preloadedOutputsByOutpoint);
-    }
-    return { beef, storageBeef, xinputs };
-}
-/** Check all txidOnly entries in beef: require either trustSelf vouch or throw. */
-async function validateBeefTxidOnlyEntries(beef, inputsByTxid, trustSelf, storage) {
-    for (const btx of beef.txs) {
-        if (!btx.isTxidOnly)
-            continue;
-        if (!trustSelf)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputBEEF', `valid and contain complete proof data for ${btx.txid}`);
-        if (inputsByTxid[btx.txid] == null) {
-            const isKnown = await storage.verifyKnownValidTransaction(btx.txid);
-            if (!isKnown)
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputBEEF', `valid and contain complete proof data for unknown ${btx.txid}`);
-        }
-    }
-}
-/** Ensure beef has an entry (or txidOnly) for every input txid. */
-async function ensureBeefContainsAllInputTxids(beef, inputsByTxid, localKnownInputTxids, trustSelf, storage) {
-    for (const txid of Object.keys(inputsByTxid)) {
-        let btx = beef.findTxid(txid);
-        if (btx == null && localKnownInputTxids[txid])
-            continue;
-        if (btx == null && trustSelf) {
-            if (await storage.verifyKnownValidTransaction(txid))
-                btx = beef.mergeTxidOnly(txid);
-        }
-        if (btx == null) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputBEEF', `valid and contain proof data for possibly known ${txid}, beef ${beef.toLogString()}`);
-        }
-    }
-}
-/** Resolve satoshis and lockingScript for one xinput from either storage or the beef. */
-async function resolveInputScript(storage, userId, vargs, input, beef, preloadedOutputsByOutpoint) {
-    const { txid, vout } = input.outpoint;
-    let output = preloadedOutputsByOutpoint[`${txid}.${vout}`];
-    output ??= (0, utilityHelpers_1.verifyOneOrNone)(await storage.findOutputs({ partial: { userId, txid, vout } }));
-    if (output != null) {
-        if (output.change)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${input.vin}]`, 'an unmanaged input. Change outputs are managed by your wallet.');
-        input.output = output;
-        if (output.lockingScript === undefined || !Number.isInteger(output.satoshis)) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`${txid}.${vout}`, 'output with valid lockingScript and satoshis');
-        }
-        if (!disableDoubleSpendCheckForTest && !output.spendable && !vargs.isNoSend) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`${txid}.${vout}`, 'spendable output unless noSend is true');
-        }
-        input.satoshis = sdk_1.Validation.validateSatoshis(output.satoshis, 'output.satoshis');
-        input.lockingScript = sdk_1.Script.fromBinary((0, utilityHelpers_noBuffer_1.asArray)(output.lockingScript));
-    }
-    else {
-        let btx = beef.findTxid(txid);
-        if (btx.isTxidOnly) {
-            const { rawTx, proven } = await storage.getProvenOrRawTx(txid);
-            if (rawTx == null)
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('inputBEEF', `valid and contain proof data for ${txid}`);
-            btx = beef.mergeRawTx((0, utilityHelpers_noBuffer_1.asArray)(rawTx));
-            if (proven != null)
-                beef.mergeBump(new EntityProvenTx_1.EntityProvenTx(proven).getMerklePath());
-        }
-        if (vout >= btx.tx.outputs.length)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`${txid}.${vout}`, 'valid outpoint');
-        const so = btx.tx.outputs[vout];
-        input.satoshis = sdk_1.Validation.validateSatoshis(so.satoshis, 'so.satoshis');
-        input.lockingScript = so.lockingScript;
-    }
-}
-async function validateNoSendChange(storage, userId, vargs, changeBasket) {
-    const r = [];
-    if (!vargs.isNoSend)
-        return [];
-    const noSendChange = vargs.options.noSendChange;
-    if (noSendChange && noSendChange.length > 0) {
-        for (const op of noSendChange) {
-            const output = (0, utilityHelpers_1.verifyOneOrNone)(await storage.findOutputs({
-                partial: { userId, txid: op.txid, vout: op.vout }
-            }));
-            // noSendChange is signed through the same BRC-29 path as allocated change.
-            // It must satisfy the full managed-change policy, not merely share the
-            // default basket or have a P2PKH-shaped locking script.
-            if (!(0, managedChange_1.isAutoSpendableChangeOutput)(output) ||
-                !(0, utilityHelpers_1.verifyNumber)(output.satoshis) ||
-                output.basketId !== changeBasket.basketId) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('noSendChange outpoint', 'wallet-managed BRC-29 change');
-            }
-            if (r.some(o => o.outputId === output.outputId)) 
-            // noSendChange duplicate OutPoints are not allowed.
-            {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('noSendChange outpoint', 'unique. Duplicates are not allowed.');
-            }
-            r.push(output);
-        }
-    }
-    if ((await storage.findReservedActionBatchOutputIds(r.map(output => output.outputId))).length > 0) {
-        throw new WERR_errors_1.WERR_INVALID_PARAMETER('noSendChange', 'outputs not reserved by an active action batch');
-    }
-    return r;
-}
-async function preflightInsufficientFundsFastPath(vargs, xinputs, xoutputs, noSendChangeIn, availableChangeCount, feeModel) {
-    if (feeModel.model !== 'sat/kb' || !feeModel.value)
-        return;
-    const fixedInputSatoshis = xinputs.reduce((a, e) => a + e.satoshis, 0);
-    const noSendSatoshis = noSendChangeIn.reduce((a, e) => a + Number(e.satoshis || 0), 0);
-    const spending = xoutputs.reduce((a, e) => a + e.satoshis, 0);
-    const minSize = (0, utils_1.transactionSize)(xinputs.map(i => i.unlockingScriptLength || 0), xoutputs.map(o => Math.floor(o.lockingScript.length / 2)));
-    const minFee = Math.ceil((minSize / 1000) * feeModel.value);
-    const minRequired = spending + minFee;
-    const fixedAvailable = fixedInputSatoshis + noSendSatoshis;
-    if (fixedAvailable >= minRequired)
-        return;
-    // Keep common successful path cheap:
-    // - If there are zero change candidates, failure is certain.
-    // Otherwise, defer to the main funding allocator.
-    const deficit = minRequired - fixedAvailable;
-    if (availableChangeCount <= 0) {
-        throw new WERR_errors_1.WERR_INSUFFICIENT_FUNDS(minRequired, deficit);
-    }
-}
-async function fundNewTransactionSdk(storage, userId, vargs, ctx) {
-    const params = {
-        fixedInputs: ctx.xinputs.map(xi => ({
-            satoshis: xi.satoshis,
-            unlockingScriptLength: xi.unlockingScriptLength
-        })),
-        fixedOutputs: ctx.xoutputs.map(xo => ({
-            satoshis: xo.satoshis,
-            lockingScriptLength: xo.lockingScript.length / 2
-        })),
-        feeModel: ctx.feeModel,
-        changeInitialSatoshis: Math.max(1, ctx.changeBasket.minimumDesiredUTXOValue),
-        changeFirstSatoshis: Math.max(1, Math.round(ctx.changeBasket.minimumDesiredUTXOValue / 4)),
-        changeLockingScriptLength: 25,
-        changeUnlockingScriptLength: 107,
-        targetNetCount: ctx.changeBasket.numberOfDesiredUTXOs - ctx.availableChangeCount,
-        randomVals: vargs.randomVals
-    };
-    const noSendChange = [...ctx.noSendChangeIn];
-    const outputs = {};
-    const allocateChangeInput = async (targetSatoshis, exactSatoshis) => {
-        // noSendChange gets allocated first...typically only one input...just allocate in order...
-        if (noSendChange.length > 0) {
-            const o = noSendChange.pop();
-            outputs[o.outputId] = o;
-            // allocate the output in storage, noSendChange is by definition spendable false and part of noSpend transaction batch.
-            await storage.updateOutput(o.outputId, {
-                spendable: false,
-                spentBy: ctx.transactionId
-            });
-            o.spendable = false;
-            o.spentBy = ctx.transactionId;
-            const r = {
-                outputId: o.outputId,
-                satoshis: o.satoshis
-            };
-            return r;
-        }
-        const basketId = ctx.changeBasket.basketId;
-        const o = await storage.allocateChangeInput(userId, basketId, targetSatoshis, exactSatoshis, !vargs.isDelayed, ctx.transactionId);
-        if (o == null)
-            return undefined;
-        outputs[o.outputId] = o;
-        const r = {
-            outputId: o.outputId,
-            satoshis: o.satoshis
-        };
-        return r;
-    };
-    const releaseChangeInput = async (outputId) => {
-        const nsco = ctx.noSendChangeIn.find(o => o.outputId === outputId);
-        if (nsco != null) {
-            noSendChange.push(nsco);
-            return;
-        }
-        await storage.updateOutput(outputId, {
-            spendable: true,
-            spentBy: undefined
-        });
-    };
-    const gcr = await (0, generateChange_1.generateChangeSdk)(params, allocateChangeInput, releaseChangeInput, vargs.logger);
-    const nextRandomVal = () => {
-        let val = 0;
-        if ((vargs.randomVals == null) || vargs.randomVals.length === 0) {
-            const bytes = (0, sdk_1.Random)(4);
-            val = (((bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]) >>> 0) / 0x100000000;
-        }
-        else {
-            val = vargs.randomVals.shift() || 0;
-            vargs.randomVals.push(val);
-        }
-        return val;
-    };
-    /**
-     * @returns a random integer betweenn min and max, inclussive.
-     */
-    const rand = (min, max) => {
-        if (max < min)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('max', `less than min (${min}). max is (${max})`);
-        return Math.floor(nextRandomVal() * (max - min + 1) + min);
-    };
-    const randomDerivation = (count) => {
-        let val = [];
-        if ((vargs.randomVals == null) || vargs.randomVals.length === 0) {
-            val = (0, sdk_1.Random)(count);
-        }
-        else {
-            for (let i = 0; i < count; i++)
-                val.push(rand(0, 255));
-        }
-        return sdk_1.Utils.toBase64(val);
-    };
-    // Generate a derivation prefix for the payment
-    const derivationPrefix = randomDerivation(16);
-    const r = {
-        maxPossibleSatoshisAdjustment: gcr.maxPossibleSatoshisAdjustment,
-        allocatedChange: gcr.allocatedChangeInputs.map(i => outputs[i.outputId]),
-        changeOutputs: gcr.changeOutputs.map((o, i) => ({
-            // what we knnow now and can insert into the database for this new transaction's change output
-            created_at: new Date(),
-            updated_at: new Date(),
-            outputId: 0,
-            userId,
-            transactionId: ctx.transactionId,
-            vout: params.fixedOutputs.length + i,
-            satoshis: o.satoshis,
-            basketId: ctx.changeBasket.basketId,
-            spendable: false,
-            change: true,
-            type: 'P2PKH',
-            derivationPrefix,
-            derivationSuffix: randomDerivation(16),
-            providedBy: 'storage',
-            purpose: 'change',
-            customInstructions: undefined,
-            senderIdentityKey: undefined,
-            outputDescription: '',
-            // what will be known when transaction is signed
-            txid: undefined,
-            lockingScript: undefined,
-            // when this output gets spent
-            spentBy: undefined,
-            spendingDescription: undefined
-        })),
-        derivationPrefix
-    };
-    return r;
-}
-/**
- * Avoid returning any known raw transaction data by converting any known transaction
- * in the `beef` to txidOnly.
- * @returns undefined if `vargs.options.returnTXIDOnly` or trimmed `Beef`
- */
-function trimInputBeef(beef, vargs) {
-    if (vargs.options.returnTXIDOnly)
-        return undefined;
-    const knownTxids = {};
-    for (const txid of vargs.options.knownTxids || [])
-        knownTxids[txid] = true;
-    for (const txid of beef.txs.map(btx => btx.txid))
-        if (knownTxids[txid])
-            beef.makeTxidOnly(txid);
-    return beef.toUint8Array();
-}
-async function mergeAllocatedChangeBeefs(storage, userId, vargs, allocatedChange, beef) {
-    const options = {
-        trustSelf: undefined,
-        knownTxids: vargs.options.knownTxids,
-        mergeToBeef: beef,
-        ignoreStorage: false,
-        ignoreServices: true,
-        ignoreNewProven: false,
-        minProofLevel: undefined
-    };
-    if (vargs.options.returnTXIDOnly)
-        return undefined;
-    const known = new Set(vargs.options.knownTxids ?? []);
-    const missing = Array.from(new Set(allocatedChange
-        .map(o => o.txid)
-        .filter(txid => beef.findTxid(txid) == null && !known.has(txid))));
-    const fetched = new Array(missing.length);
-    const concurrency = Math.min(8, Math.max(1, missing.length));
-    let cursor = 0;
-    await Promise.all(Array.from({ length: concurrency }, async () => {
-        while (cursor < missing.length) {
-            const index = cursor++;
-            fetched[index] = await storage.getBeefForTransaction(missing[index], { ...options, mergeToBeef: undefined });
-        }
-    }));
-    for (const fetchedBeef of fetched) {
-        if (fetchedBeef == null)
-            continue;
-        beef.mergeBeef(fetchedBeef);
-    }
-    return trimInputBeef(beef, vargs);
-}
-//# sourceMappingURL=createAction.js.map