@bsv/wallet-toolbox-client 1.7.15 → 1.7.16

package/out/src/signer/methods/acquireDirectCertificate.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireDirectCertificate = acquireDirectCertificate;
+async function acquireDirectCertificate(wallet, auth, vargs) {
+    var _a;
+    const now = new Date();
+    const newCert = {
+        certificateId: 0, // replaced by storage insert
+        created_at: now,
+        updated_at: now,
+        userId: auth.userId,
+        type: vargs.type,
+        subject: vargs.subject,
+        verifier: vargs.keyringRevealer === 'certifier' ? vargs.certifier : vargs.keyringRevealer,
+        serialNumber: vargs.serialNumber,
+        certifier: vargs.certifier,
+        revocationOutpoint: vargs.revocationOutpoint,
+        signature: vargs.signature,
+        fields: [],
+        isDeleted: false
+    };
+    for (const [name, value] of Object.entries(vargs.fields)) {
+        (_a = newCert.fields) === null || _a === void 0 ? void 0 : _a.push({
+            certificateId: 0, // replaced by storage insert
+            created_at: now,
+            updated_at: now,
+            userId: auth.userId,
+            fieldName: name,
+            fieldValue: value,
+            masterKey: vargs.keyringForSubject[name] || ''
+        });
+    }
+    const count = await wallet.storage.insertCertificate(newCert);
+    const r = {
+        type: vargs.type,
+        subject: vargs.subject,
+        serialNumber: vargs.serialNumber,
+        certifier: vargs.certifier,
+        revocationOutpoint: vargs.revocationOutpoint,
+        signature: vargs.signature,
+        fields: vargs.fields
+    };
+    return r;
+}
+//# sourceMappingURL=acquireDirectCertificate.js.map

package/out/src/signer/methods/acquireDirectCertificate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquireDirectCertificate.js","sourceRoot":"","sources":["../../../../../src/signer/methods/acquireDirectCertificate.ts"],"names":[],"mappings":";;AAKA,4DA8CC;AA9CM,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,IAAY,EACZ,KAAmD;;IAEnD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,OAAO,GAAsB;QACjC,aAAa,EAAE,CAAC,EAAE,6BAA6B;QAC/C,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,IAAI,CAAC,MAAO;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe;QACzF,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,KAAK;KACjB,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAA,OAAO,CAAC,MAAM,0CAAE,IAAI,CAAC;YACnB,aAAa,EAAE,CAAC,EAAE,6BAA6B;YAC/C,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,IAAI,CAAC,MAAO;YACpB,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE;SAC/C,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAE7D,MAAM,CAAC,GAA6B;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAA;IAED,OAAO,CAAC,CAAA;AACV,CAAC"}

package/out/src/signer/methods/buildSignableTransaction.d.ts

@@ -0,0 +1,15 @@
+import { Script, Transaction, Validation } from '@bsv/sdk';
+import { Wallet, PendingStorageInput } from '../../Wallet';
+import { StorageCreateActionResult, StorageCreateTransactionSdkOutput } from '../../sdk/WalletStorage.interfaces';
+import { KeyPair } from '../../sdk/types';
+export declare function buildSignableTransaction(dctr: StorageCreateActionResult, args: Validation.ValidCreateActionArgs, wallet: Wallet): {
+    tx: Transaction;
+    amount: number;
+    pdi: PendingStorageInput[];
+    log: string;
+};
+/**
+ * Derive a change output locking script
+ */
+export declare function makeChangeLock(out: StorageCreateTransactionSdkOutput, dctr: StorageCreateActionResult, args: Validation.ValidCreateActionArgs, changeKeys: KeyPair, wallet: Wallet): Script;
+//# sourceMappingURL=buildSignableTransaction.d.ts.map

package/out/src/signer/methods/buildSignableTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSignableTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/signer/methods/buildSignableTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,WAAW,EAAuC,UAAU,EAAE,MAAM,UAAU,CAAA;AACrG,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EACL,yBAAyB,EAEzB,iCAAiC,EAClC,MAAM,oCAAoC,CAAA;AAG3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGzC,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,UAAU,CAAC,qBAAqB,EACtC,MAAM,EAAE,MAAM,GACb;IACD,EAAE,EAAE,WAAW,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,mBAAmB,EAAE,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;CACZ,CA4IA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iCAAiC,EACtC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,UAAU,CAAC,qBAAqB,EACtC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR"}

package/out/src/signer/methods/buildSignableTransaction.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSignableTransaction = buildSignableTransaction;
+exports.makeChangeLock = makeChangeLock;
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const ScriptTemplateBRC29_1 = require("../../utility/ScriptTemplateBRC29");
+function buildSignableTransaction(dctr, args, wallet) {
+    var _a;
+    const changeKeys = wallet.getClientChangeKeyPair();
+    const inputBeef = args.inputBEEF ? sdk_1.Beef.fromBinary(args.inputBEEF) : undefined;
+    const { inputs: storageInputs, outputs: storageOutputs } = dctr;
+    const tx = new sdk_1.Transaction(args.version, [], [], args.lockTime);
+    // The order of outputs in storageOutputs is always:
+    // CreateActionArgs.outputs in the original order
+    // Commission output
+    // Change outputs
+    // The Vout values will be randomized if args.options.randomizeOutputs is true. Default is true.
+    const voutToIndex = Array(storageOutputs.length);
+    for (let vout = 0; vout < storageOutputs.length; vout++) {
+        const i = storageOutputs.findIndex(o => o.vout === vout);
+        if (i < 0)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('output.vout', `sequential. ${vout} is missing`);
+        voutToIndex[vout] = i;
+    }
+    //////////////
+    // Add OUTPUTS
+    /////////////
+    for (let vout = 0; vout < storageOutputs.length; vout++) {
+        const i = voutToIndex[vout];
+        const out = storageOutputs[i];
+        if (vout !== out.vout)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('output.vout', `equal to array index. ${out.vout} !== ${vout}`);
+        const change = out.providedBy === 'storage' && out.purpose === 'change';
+        const lockingScript = change
+            ? makeChangeLock(out, dctr, args, changeKeys, wallet)
+            : (0, utilityHelpers_1.asBsvSdkScript)(out.lockingScript);
+        const output = {
+            satoshis: out.satoshis,
+            lockingScript,
+            change
+        };
+        tx.addOutput(output);
+    }
+    if (storageOutputs.length === 0) {
+        // Add a dummy output to avoid transaction rejection by processors for having no outputs.
+        const output = {
+            satoshis: 0,
+            lockingScript: sdk_1.Script.fromASM('OP_FALSE OP_RETURN 42'),
+            change: false
+        };
+        tx.addOutput(output);
+    }
+    //////////////
+    // Merge and sort INPUTS info by vin order.
+    /////////////
+    const inputs = [];
+    for (const storageInput of storageInputs) {
+        const argsInput = storageInput.vin !== undefined && storageInput.vin < args.inputs.length
+            ? args.inputs[storageInput.vin]
+            : undefined;
+        inputs.push({ argsInput, storageInput });
+    }
+    inputs.sort((a, b) => a.storageInput.vin < b.storageInput.vin ? -1 : a.storageInput.vin === b.storageInput.vin ? 0 : 1);
+    const pendingStorageInputs = [];
+    //////////////
+    // Add INPUTS
+    /////////////
+    let totalChangeInputs = 0;
+    for (const { storageInput, argsInput } of inputs) {
+        // Two types of inputs are handled: user specified wth/without unlockingScript and storage specified using SABPPP template.
+        if (argsInput) {
+            // Type 1: User supplied input, with or without an explicit unlockingScript.
+            // If without, signAction must be used to provide the actual unlockScript.
+            const hasUnlock = typeof argsInput.unlockingScript === 'string';
+            const unlock = hasUnlock ? (0, utilityHelpers_1.asBsvSdkScript)(argsInput.unlockingScript) : new sdk_1.Script();
+            const sourceTransaction = args.isSignAction ? (_a = inputBeef === null || inputBeef === void 0 ? void 0 : inputBeef.findTxid(argsInput.outpoint.txid)) === null || _a === void 0 ? void 0 : _a.tx : undefined;
+            const inputToAdd = {
+                sourceTXID: argsInput.outpoint.txid,
+                sourceOutputIndex: argsInput.outpoint.vout,
+                // Include the source transaction for access to the outputs locking script and output satoshis for user side fee calculation.
+                // TODO: Make this conditional to improve performance when user can supply locking scripts themselves.
+                sourceTransaction,
+                unlockingScript: unlock,
+                sequence: argsInput.sequenceNumber
+            };
+            tx.addInput(inputToAdd);
+        }
+        else {
+            // Type2: SABPPP protocol inputs which are signed using ScriptTemplateBRC29.
+            if (storageInput.type !== 'P2PKH')
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('type', `vin ${storageInput.vin}, "${storageInput.type}" is not a supported unlocking script type.`);
+            pendingStorageInputs.push({
+                vin: tx.inputs.length,
+                derivationPrefix: (0, utilityHelpers_1.verifyTruthy)(storageInput.derivationPrefix),
+                derivationSuffix: (0, utilityHelpers_1.verifyTruthy)(storageInput.derivationSuffix),
+                unlockerPubKey: storageInput.senderIdentityKey,
+                sourceSatoshis: storageInput.sourceSatoshis,
+                lockingScript: storageInput.sourceLockingScript
+            });
+            const inputToAdd = {
+                sourceTXID: storageInput.sourceTxid,
+                sourceOutputIndex: storageInput.sourceVout,
+                sourceTransaction: storageInput.sourceTransaction
+                    ? sdk_1.Transaction.fromBinary(storageInput.sourceTransaction)
+                    : undefined,
+                unlockingScript: new sdk_1.Script(),
+                sequence: 0xffffffff
+            };
+            tx.addInput(inputToAdd);
+            totalChangeInputs += sdk_1.Validation.validateSatoshis(storageInput.sourceSatoshis, 'storageInput.sourceSatoshis');
+        }
+    }
+    // The amount is the total of non-foreign inputs minus change outputs
+    // Note that the amount can be negative when we are redeeming more inputs than we are spending
+    const totalChangeOutputs = storageOutputs
+        .filter(x => x.purpose === 'change')
+        .reduce((acc, el) => acc + el.satoshis, 0);
+    const amount = totalChangeInputs - totalChangeOutputs;
+    return {
+        tx,
+        amount,
+        pdi: pendingStorageInputs,
+        log: ''
+    };
+}
+/**
+ * Derive a change output locking script
+ */
+function makeChangeLock(out, dctr, args, changeKeys, wallet) {
+    const derivationPrefix = dctr.derivationPrefix;
+    const derivationSuffix = (0, utilityHelpers_1.verifyTruthy)(out.derivationSuffix);
+    const sabppp = new ScriptTemplateBRC29_1.ScriptTemplateBRC29({
+        derivationPrefix,
+        derivationSuffix,
+        keyDeriver: wallet.keyDeriver
+    });
+    const lockingScript = sabppp.lock(changeKeys.privateKey, changeKeys.publicKey);
+    return lockingScript;
+}
+//# sourceMappingURL=buildSignableTransaction.js.map

package/out/src/signer/methods/buildSignableTransaction.js.map

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

package/out/src/signer/methods/completeSignedTransaction.d.ts

@@ -0,0 +1,10 @@
+import { Beef, SignActionSpend, Transaction } from '@bsv/sdk';
+import { PendingSignAction, Wallet } from '../../Wallet';
+export declare function completeSignedTransaction(prior: PendingSignAction, spends: Record<number, SignActionSpend>, wallet: Wallet): Promise<Transaction>;
+/**
+ * @param txid The TXID of a transaction in the beef for which all unlocking scripts must be valid.
+ * @param beef Must contain transactions for txid and all its inputs.
+ * @throws WERR_INVALID_PARAMETER if any unlocking script is invalid, if sourceTXID is invalid, if beef doesn't contain required transactions.
+ */
+export declare function verifyUnlockScripts(txid: string, beef: Beef): void;
+//# sourceMappingURL=completeSignedTransaction.d.ts.map

package/out/src/signer/methods/completeSignedTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completeSignedTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/signer/methods/completeSignedTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,eAAe,EAAS,WAAW,EAAE,MAAM,UAAU,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAMxD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAmDtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CA+ClE"}

package/out/src/signer/methods/completeSignedTransaction.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completeSignedTransaction = completeSignedTransaction;
+exports.verifyUnlockScripts = verifyUnlockScripts;
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const ScriptTemplateBRC29_1 = require("../../utility/ScriptTemplateBRC29");
+const WalletError_1 = require("../../sdk/WalletError");
+async function completeSignedTransaction(prior, spends, wallet) {
+    /////////////////////
+    // Insert the user provided unlocking scripts from "spends" arg
+    /////////////////////
+    for (const [key, spend] of Object.entries(spends)) {
+        const vin = Number(key);
+        const createInput = prior.args.inputs[vin];
+        const input = prior.tx.inputs[vin];
+        if (!createInput || !input || createInput.unlockingScript || !Number.isInteger(createInput.unlockingScriptLength))
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args', `spend does not correspond to prior input with valid unlockingScriptLength.`);
+        if (spend.unlockingScript.length / 2 > createInput.unlockingScriptLength)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args', `spend unlockingScript length ${spend.unlockingScript.length} exceeds expected length ${createInput.unlockingScriptLength}`);
+        input.unlockingScript = (0, utilityHelpers_1.asBsvSdkScript)(spend.unlockingScript);
+        if (spend.sequenceNumber !== undefined)
+            input.sequence = spend.sequenceNumber;
+    }
+    const results = {
+        sdk: {}
+    };
+    /////////////////////
+    // Insert SABPPP unlock templates for wallet signed inputs
+    /////////////////////
+    for (const pdi of prior.pdi) {
+        const sabppp = new ScriptTemplateBRC29_1.ScriptTemplateBRC29({
+            derivationPrefix: pdi.derivationPrefix,
+            derivationSuffix: pdi.derivationSuffix,
+            keyDeriver: wallet.keyDeriver
+        });
+        const keys = wallet.getClientChangeKeyPair();
+        const lockerPrivKey = keys.privateKey;
+        const unlockerPubKey = pdi.unlockerPubKey || keys.publicKey;
+        const sourceSatoshis = pdi.sourceSatoshis;
+        const lockingScript = (0, utilityHelpers_1.asBsvSdkScript)(pdi.lockingScript);
+        const unlockTemplate = sabppp.unlock(lockerPrivKey, unlockerPubKey, sourceSatoshis, lockingScript);
+        const input = prior.tx.inputs[pdi.vin];
+        input.unlockingScriptTemplate = unlockTemplate;
+    }
+    /////////////////////
+    // Sign wallet signed inputs making transaction fully valid.
+    /////////////////////
+    await prior.tx.sign();
+    return prior.tx;
+}
+/**
+ * @param txid The TXID of a transaction in the beef for which all unlocking scripts must be valid.
+ * @param beef Must contain transactions for txid and all its inputs.
+ * @throws WERR_INVALID_PARAMETER if any unlocking script is invalid, if sourceTXID is invalid, if beef doesn't contain required transactions.
+ */
+function verifyUnlockScripts(txid, beef) {
+    var _a, _b, _c, _d;
+    const tx = (_a = beef.findTxid(txid)) === null || _a === void 0 ? void 0 : _a.tx;
+    if (!tx)
+        throw new WERR_errors_1.WERR_INVALID_PARAMETER(`txid`, `contained in beef, txid ${txid}`);
+    for (let i = 0; i < tx.inputs.length; i++) {
+        const input = tx.inputs[i];
+        if (!input.sourceTXID)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${i}].sourceTXID`, `valid`);
+        if (!input.unlockingScript)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${i}].unlockingScript`, `valid`);
+        input.sourceTransaction = (_b = beef.findTxid(input.sourceTXID)) === null || _b === void 0 ? void 0 : _b.tx;
+        if (!input.sourceTransaction) {
+            // The beef doesn't contain all the source transactions only if advanced features
+            // such as knownTxids are used.
+            // Skip unlock script checks.
+            return;
+            // throw new WERR_INVALID_PARAMETER(`inputs[${i}].sourceTXID`, `contained in beef`)
+        }
+    }
+    for (let i = 0; i < tx.inputs.length; i++) {
+        const input = tx.inputs[i];
+        const sourceOutput = input.sourceTransaction.outputs[input.sourceOutputIndex];
+        const otherInputs = tx.inputs.filter((_, idx) => idx !== i);
+        const spend = new sdk_1.Spend({
+            sourceTXID: input.sourceTXID,
+            sourceOutputIndex: input.sourceOutputIndex,
+            lockingScript: sourceOutput.lockingScript,
+            sourceSatoshis: (_c = sourceOutput.satoshis) !== null && _c !== void 0 ? _c : 0,
+            transactionVersion: tx.version,
+            otherInputs,
+            unlockingScript: input.unlockingScript,
+            inputSequence: (_d = input.sequence) !== null && _d !== void 0 ? _d : 0,
+            inputIndex: i,
+            outputs: tx.outputs,
+            lockTime: tx.lockTime
+        });
+        try {
+            const spendValid = spend.validate();
+            if (!spendValid)
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${i}].unlockScript`, `valid`);
+        }
+        catch (eu) {
+            const e = WalletError_1.WalletError.fromUnknown(eu);
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`inputs[${i}].unlockScript`, `valid. ${e.message}`);
+        }
+    }
+}
+//# sourceMappingURL=completeSignedTransaction.js.map

package/out/src/signer/methods/completeSignedTransaction.js.map

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

package/out/src/signer/methods/createAction.d.ts

@@ -0,0 +1,14 @@
+import { AtomicBEEF, CreateActionResult, OutpointString, SendWithResult, SignableTransaction, TXIDHexString, Validation } from '@bsv/sdk';
+import { AuthId, ReviewActionResult, StorageProcessActionResults } from '../../sdk/WalletStorage.interfaces';
+import { PendingSignAction, Wallet } from '../../Wallet';
+export interface CreateActionResultX extends CreateActionResult {
+    txid?: TXIDHexString;
+    tx?: AtomicBEEF;
+    noSendChange?: OutpointString[];
+    sendWithResults?: SendWithResult[];
+    signableTransaction?: SignableTransaction;
+    notDelayedResults?: ReviewActionResult[];
+}
+export declare function createAction(wallet: Wallet, auth: AuthId, vargs: Validation.ValidCreateActionArgs): Promise<CreateActionResultX>;
+export declare function processAction(prior: PendingSignAction | undefined, wallet: Wallet, auth: AuthId, vargs: Validation.ValidProcessActionArgs): Promise<StorageProcessActionResults>;
+//# sourceMappingURL=createAction.d.ts.map

package/out/src/signer/methods/createAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAction.d.ts","sourceRoot":"","sources":["../../../../../src/signer/methods/createAction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EAGb,UAAU,EACX,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,MAAM,EACN,kBAAkB,EAElB,2BAA2B,EAC5B,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGxD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,EAAE,CAAC,EAAE,UAAU,CAAA;IACf,YAAY,CAAC,EAAE,cAAc,EAAE,CAAA;IAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CAAA;CACzC;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,CAAC,qBAAqB,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAuC9B;AAqED,wBAAsB,aAAa,CACjC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,CAAC,sBAAsB,GACvC,OAAO,CAAC,2BAA2B,CAAC,CAetC"}

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

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAction = createAction;
+exports.processAction = processAction;
+const sdk_1 = require("@bsv/sdk");
+const buildSignableTransaction_1 = require("./buildSignableTransaction");
+const completeSignedTransaction_1 = require("./completeSignedTransaction");
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+async function createAction(wallet, auth, vargs) {
+    var _a;
+    const r = {};
+    const logger = vargs.logger;
+    let prior = undefined;
+    if (vargs.isNewTx || vargs.isTestWerrReviewActions) {
+        prior = await createNewTx(wallet, vargs);
+        logger === null || logger === void 0 ? void 0 : logger.log('created new transaction');
+        if (vargs.isSignAction) {
+            const r = makeSignableTransactionResult(prior, wallet, vargs);
+            logger === null || logger === void 0 ? void 0 : logger.log('created signable transaction result');
+            return r;
+        }
+        prior.tx = await (0, completeSignedTransaction_1.completeSignedTransaction)(prior, {}, wallet);
+        logger === null || logger === void 0 ? void 0 : logger.log('completed signed transaction');
+        r.txid = prior.tx.id('hex');
+        const beef = new sdk_1.Beef();
+        if (prior.dcr.inputBeef)
+            beef.mergeBeef(prior.dcr.inputBeef);
+        beef.mergeTransaction(prior.tx);
+        logger === null || logger === void 0 ? void 0 : logger.log('merged beef');
+        (0, completeSignedTransaction_1.verifyUnlockScripts)(r.txid, beef);
+        logger === null || logger === void 0 ? void 0 : logger.log('verified unlock scripts');
+        r.noSendChange = (_a = prior.dcr.noSendChangeOutputVouts) === null || _a === void 0 ? void 0 : _a.map(vout => `${r.txid}.${vout}`);
+        if (!vargs.options.returnTXIDOnly)
+            r.tx = beef.toBinaryAtomic(r.txid);
+    }
+    const { sendWithResults, notDelayedResults } = await processAction(prior, wallet, auth, vargs);
+    logger === null || logger === void 0 ? void 0 : logger.log('processed transaction');
+    r.sendWithResults = sendWithResults;
+    r.notDelayedResults = notDelayedResults;
+    return r;
+}
+async function createNewTx(wallet, vargs) {
+    const logger = vargs.logger;
+    const storageArgs = removeUnlockScripts(vargs);
+    const dcr = await wallet.storage.createAction(storageArgs);
+    const reference = dcr.reference;
+    const { tx, amount, pdi } = (0, buildSignableTransaction_1.buildSignableTransaction)(dcr, vargs, wallet);
+    logger === null || logger === void 0 ? void 0 : logger.log('built signable transaction');
+    const prior = { reference, dcr, args: vargs, amount, tx, pdi };
+    return prior;
+}
+function makeSignableTransactionResult(prior, wallet, args) {
+    var _a;
+    if (!prior.dcr.inputBeef)
+        throw new WERR_errors_1.WERR_INTERNAL('prior.dcr.inputBeef must be valid');
+    const txid = prior.tx.id('hex');
+    const r = {
+        noSendChange: args.isNoSend ? (_a = prior.dcr.noSendChangeOutputVouts) === null || _a === void 0 ? void 0 : _a.map(vout => `${txid}.${vout}`) : undefined,
+        signableTransaction: {
+            reference: prior.dcr.reference,
+            tx: makeSignableTransactionBeef(prior.tx, prior.dcr.inputBeef)
+        }
+    };
+    wallet.pendingSignActions[r.signableTransaction.reference] = prior;
+    return r;
+}
+function makeSignableTransactionBeef(tx, inputBEEF) {
+    // This is a special case beef for transaction signing.
+    // We only need the transaction being signed, and for each input, the raw source transaction.
+    const beef = new sdk_1.Beef();
+    for (const input of tx.inputs) {
+        if (!input.sourceTransaction)
+            throw new WERR_errors_1.WERR_INTERNAL('Every signableTransaction input must have a sourceTransaction');
+        beef.mergeRawTx(input.sourceTransaction.toBinary());
+    }
+    beef.mergeRawTx(tx.toBinary());
+    return beef.toBinaryAtomic(tx.id('hex'));
+}
+function removeUnlockScripts(args) {
+    let storageArgs = args;
+    if (!storageArgs.inputs.every(i => i.unlockingScript === undefined)) {
+        // Never send unlocking scripts to storage, all it needs is the script length.
+        storageArgs = { ...args, inputs: [] };
+        for (const i of args.inputs) {
+            const di = {
+                ...i,
+                unlockingScriptLength: i.unlockingScript !== undefined ? i.unlockingScript.length : i.unlockingScriptLength
+            };
+            delete di.unlockingScript;
+            storageArgs.inputs.push(di);
+        }
+    }
+    return storageArgs;
+}
+async function processAction(prior, wallet, auth, vargs) {
+    const args = {
+        isNewTx: vargs.isNewTx,
+        isSendWith: vargs.isSendWith,
+        isNoSend: vargs.isNoSend,
+        isDelayed: vargs.isDelayed,
+        reference: prior ? prior.reference : undefined,
+        txid: prior ? prior.tx.id('hex') : undefined,
+        rawTx: prior ? prior.tx.toBinary() : undefined,
+        sendWith: vargs.isSendWith ? vargs.options.sendWith : [],
+        logger: vargs.logger
+    };
+    const r = await wallet.storage.processAction(args);
+    return r;
+}
+function makeDummyTransactionForOutputSatoshis(vout, satoshis) {
+    const tx = new sdk_1.Transaction();
+    for (let i = 0; i < vout; i++)
+        tx.addOutput({ lockingScript: new sdk_1.Script(), satoshis: 0 });
+    tx.addOutput({ lockingScript: new sdk_1.Script(), satoshis });
+    return tx;
+}
+//# sourceMappingURL=createAction.js.map

package/out/src/signer/methods/createAction.js.map

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

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

@@ -0,0 +1,32 @@
+import { InternalizeActionArgs } from '@bsv/sdk';
+import { Wallet } from '../../Wallet';
+import { AuthId, StorageInternalizeActionResult } from '../../sdk/WalletStorage.interfaces';
+/**
+ * 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 must be in the 'unproven' or 'completed' status. Any other status is 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. A change output in the "default" basket may not be target of an insertion into a different basket.
+ * 3. These baskets do not affect the wallet's balance and are typed "custom".
+ *
+ * "wallet payment" Merge Rules:
+ * 1. Targetting an existing change "default" basket output results in a no-op. No error. No alterations made.
+ * 2. Targetting a previously "custom" non-change output converts it into a change output. This alters the transaction's `amount`, and the wallet balance.
+ *
+ */
+export declare function internalizeAction(wallet: Wallet, auth: AuthId, args: InternalizeActionArgs): Promise<StorageInternalizeActionResult>;
+//# sourceMappingURL=internalizeAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internalizeAction.d.ts","sourceRoot":"","sources":["../../../../../src/signer/methods/internalizeAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,qBAAqB,EAAwD,MAAM,UAAU,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAA;AAG3F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,8BAA8B,CAAC,CAqEzC"}

package/out/src/signer/methods/internalizeAction.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internalizeAction = internalizeAction;
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+/**
+ * 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 must be in the 'unproven' or 'completed' status. Any other status is 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. A change output in the "default" basket may not be target of an insertion into a different basket.
+ * 3. These baskets do not affect the wallet's balance and are typed "custom".
+ *
+ * "wallet payment" Merge Rules:
+ * 1. Targetting an existing change "default" basket output results in a no-op. No error. No alterations made.
+ * 2. Targetting a previously "custom" non-change output converts it into a change output. This alters the transaction's `amount`, and the wallet balance.
+ *
+ */
+async function internalizeAction(wallet, auth, args) {
+    const vargs = sdk_1.Validation.validateInternalizeActionArgs(args);
+    const { ab, tx, txid } = await validateAtomicBeef();
+    const brc29ProtocolID = [2, '3241645161d8'];
+    for (const o of vargs.outputs) {
+        if (o.outputIndex < 0 || o.outputIndex >= tx.outputs.length)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('outputIndex', `a valid output index in range 0 to ${tx.outputs.length - 1}`);
+        switch (o.protocol) {
+            case 'basket insertion':
+                setupBasketInsertionForOutput(o, vargs);
+                break;
+            case 'wallet payment':
+                setupWalletPaymentForOutput(o, vargs);
+                break;
+            default:
+                throw new WERR_errors_1.WERR_INTERNAL(`unexpected protocol ${o.protocol}`);
+        }
+    }
+    const r = await wallet.storage.internalizeAction(args);
+    return r;
+    function setupWalletPaymentForOutput(o, dargs) {
+        const p = o.paymentRemittance;
+        const output = tx.outputs[o.outputIndex];
+        if (!p)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('paymentRemittance', `valid for protocol ${o.protocol}`);
+        const keyID = `${p.derivationPrefix} ${p.derivationSuffix}`;
+        const privKey = wallet.keyDeriver.derivePrivateKey(brc29ProtocolID, keyID, p.senderIdentityKey);
+        const expectedLockScript = new sdk_1.P2PKH().lock(privKey.toAddress());
+        if (output.lockingScript.toHex() !== expectedLockScript.toHex())
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('paymentRemittance', `locked by script conforming to BRC-29`);
+    }
+    function setupBasketInsertionForOutput(o, dargs) {
+        /*
+        No additional validations...
+        */
+    }
+    /**
+     * Verifies that the `tx` argument passed to internalizeAction is a valid AtomicBEEF,
+     * and the proofs are valid according to the wallet's configured chainTracker.
+     * THIS DOES NOT GUARANTEE:
+     * 1. That the transaction has been broadcast. (Is known to the network).
+     * 2. That the proofs are for the same block as recorded in the wallet's configured storage in the event of a reorg.
+     */
+    async function validateAtomicBeef() {
+        const ab = sdk_1.Beef.fromBinary(vargs.tx);
+        // TODO: Add support for known txids...which would speed up processing by avoiding a network call,
+        // unless a local chaintracker is used.
+        const txValid = await ab.verify(await wallet.getServices().getChainTracker(), false);
+        if (!txValid || !ab.atomicTxid) {
+            console.log(`internalizeAction beef is invalid: ${ab.toLogString()}`);
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('tx', 'valid AtomicBEEF');
+        }
+        const txid = ab.atomicTxid;
+        const btx = ab.findTxid(txid);
+        if (!btx)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('tx', `valid AtomicBEEF with newest txid of ${txid}`);
+        const tx = btx.tx;
+        return { ab, tx, txid };
+    }
+}
+//# sourceMappingURL=internalizeAction.js.map