@bsv/wallet-toolbox-client 1.1.0

package/out/src/services/providers/whatsonchain.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMerklePathFromWhatsOnChainTsc = getMerklePathFromWhatsOnChainTsc;
+exports.getRawTxFromWhatsOnChain = getRawTxFromWhatsOnChain;
+exports.getUtxoStatusFromWhatsOnChain = getUtxoStatusFromWhatsOnChain;
+exports.updateBsvExchangeRate = updateBsvExchangeRate;
+const index_client_1 = require("../../index.client");
+const tscProofToMerklePath_1 = require("../../utility/tscProofToMerklePath");
+const axios_1 = __importDefault(require("axios"));
+const whatsonchain_1 = __importDefault(require("whatsonchain"));
+/**
+ * WhatOnChain.com has their own "hash/pos/R/L" proof format and a more TSC compliant proof format.
+ *
+ * The "/proof/tsc" endpoint is much closer to the TSC specification. It provides "index" directly and each node is just the provided hash value.
+ * The "targetType" is unspecified and thus defaults to block header hash, requiring a Chaintracks lookup to get the merkleRoot...
+ * Duplicate hash values are provided in full instead of being replaced by "*".
+ *
+ * @param txid
+ * @param chain
+ * @returns
+ */
+async function getMerklePathFromWhatsOnChainTsc(txid, chain, services) {
+    const r = { name: 'WoCTsc' };
+    try {
+        const url = `https://api.whatsonchain.com/v1/bsv/${chain}/tx/${txid}/proof/tsc`;
+        let { data } = await axios_1.default.get(url);
+        if (!data || data.length < 1)
+            return r;
+        if (!data['target'])
+            data = data[0];
+        const p = data;
+        const header = await services.hashToHeader(p.target);
+        if (!header)
+            throw new index_client_1.sdk.WERR_INVALID_PARAMETER('blockhash', 'a valid on-chain block hash');
+        const proof = { index: p.index, nodes: p.nodes, height: header.height };
+        r.merklePath = (0, tscProofToMerklePath_1.convertProofToMerklePath)(txid, proof);
+        r.header = header;
+    }
+    catch (err) {
+        r.error = index_client_1.sdk.WalletError.fromUnknown(err);
+    }
+    return r;
+}
+async function getRawTxFromWhatsOnChain(txid, chain) {
+    const r = { name: 'WoC', txid: (0, index_client_1.asString)(txid) };
+    try {
+        const url = `https://api.whatsonchain.com/v1/bsv/${chain}/tx/${txid}/hex`;
+        const { data } = await axios_1.default.get(url);
+        if (!data)
+            return r;
+        r.rawTx = (0, index_client_1.asArray)(data);
+    }
+    catch (err) {
+        r.error = index_client_1.sdk.WalletError.fromUnknown(err);
+    }
+    return r;
+}
+async function getUtxoStatusFromWhatsOnChain(output, chain, outputFormat) {
+    const r = {
+        name: 'WoC',
+        status: 'error',
+        error: new index_client_1.sdk.WERR_INTERNAL(),
+        details: []
+    };
+    for (let retry = 0;; retry++) {
+        let url = '';
+        try {
+            const scriptHash = (0, index_client_1.validateScriptHash)(output, outputFormat);
+            url = `https://api.whatsonchain.com/v1/bsv/${chain}/script/${scriptHash}/unspent`;
+            const { data } = await axios_1.default.get(url);
+            if (Array.isArray(data)) {
+                if (data.length === 0) {
+                    r.status = 'success';
+                    r.error = undefined;
+                    r.isUtxo = false;
+                }
+                else {
+                    r.status = 'success';
+                    r.error = undefined;
+                    r.isUtxo = true;
+                    for (const s of data) {
+                        r.details.push({
+                            txid: s.tx_hash,
+                            satoshis: s.value,
+                            height: s.height,
+                            index: s.tx_pos
+                        });
+                    }
+                }
+            }
+            else {
+                throw new index_client_1.sdk.WERR_INTERNAL('data is not an array');
+            }
+            return r;
+        }
+        catch (eu) {
+            const e = index_client_1.sdk.WalletError.fromUnknown(eu);
+            if (e.code !== 'ECONNRESET' || retry > 2) {
+                r.error = new index_client_1.sdk.WERR_INTERNAL(`service failure: ${url}, error: ${JSON.stringify(index_client_1.sdk.WalletError.fromUnknown(eu))}`);
+                return r;
+            }
+        }
+    }
+    return r;
+}
+async function updateBsvExchangeRate(rate, updateMsecs) {
+    if (rate) {
+        // Check if the rate we know is stale enough to update.
+        updateMsecs || (updateMsecs = 1000 * 60 * 15);
+        if (new Date(Date.now() - updateMsecs) < rate.timestamp)
+            return rate;
+    }
+    // TODO: Expand to redundant services with caching...
+    const woc = new whatsonchain_1.default();
+    const r = await woc.exchangeRate();
+    const wocrate = r;
+    if (wocrate.currency !== 'USD')
+        wocrate.rate = NaN;
+    const newRate = {
+        timestamp: new Date(),
+        base: 'USD',
+        rate: wocrate.rate
+    };
+    //console.log(`new bsv rate=${JSON.stringify(newRate)}`)
+    return newRate;
+}
+//# sourceMappingURL=whatsonchain.js.map

package/out/src/services/providers/whatsonchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsonchain.js","sourceRoot":"","sources":["../../../../../src/services/providers/whatsonchain.ts"],"names":[],"mappings":";;;;;AAiBA,4EA4BC;AASD,4DAiBC;AASD,sEAwDC;AAQD,sDAyBC;AAzKD,qDAA+E;AAC/E,6EAA6E;AAE7E,kDAAyB;AACzB,gEAAuC;AAEvC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,gCAAgC,CACpD,IAAY,EACZ,KAAgB,EAChB,QAA4B;IAE5B,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAErD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,uCAAuC,KAAK,OAAO,IAAI,YAAY,CAAA;QAC/E,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAA;QAEtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,IAAI,CAAA;QACd,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM;YACT,MAAM,IAAI,kBAAG,CAAC,sBAAsB,CAClC,WAAW,EACX,6BAA6B,CAC9B,CAAA;QACH,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;QACvE,CAAC,CAAC,UAAU,GAAG,IAAA,+CAAwB,EAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACpD,CAAC,CAAC,MAAM,GAAG,MAAM,CAAA;IACnB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,CAAC,CAAC,KAAK,GAAG,kBAAG,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,CAAC,CAAA;AACV,CAAC;AASM,KAAK,UAAU,wBAAwB,CAC5C,IAAY,EACZ,KAAgB;IAEhB,MAAM,CAAC,GAAuB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAA,uBAAQ,EAAC,IAAI,CAAC,EAAE,CAAA;IAEnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,uCAAuC,KAAK,OAAO,IAAI,MAAM,CAAA;QACzE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAA;QAEnB,CAAC,CAAC,KAAK,GAAG,IAAA,sBAAO,EAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,CAAC,CAAC,KAAK,GAAG,kBAAG,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,CAAC,CAAA;AACV,CAAC;AASM,KAAK,UAAU,6BAA6B,CACjD,MAAc,EACd,KAAgB,EAChB,YAA4C;IAE5C,MAAM,CAAC,GAA4B;QACjC,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,IAAI,kBAAG,CAAC,aAAa,EAAE;QAC9B,OAAO,EAAE,EAAE;KACZ,CAAA;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,IAAI,GAAG,GAAW,EAAE,CAAA;QAEpB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,MAAM,EAAE,YAAY,CAAC,CAAA;YAE3D,GAAG,GAAG,uCAAuC,KAAK,WAAW,UAAU,UAAU,CAAA;YAEjF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAErC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,CAAC,CAAC,MAAM,GAAG,SAAS,CAAA;oBACpB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAA;oBACnB,CAAC,CAAC,MAAM,GAAG,KAAK,CAAA;gBAClB,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,MAAM,GAAG,SAAS,CAAA;oBACpB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAA;oBACnB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAA;oBACf,KAAK,MAAM,CAAC,IAA8B,IAAI,EAAE,CAAC;wBAC/C,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;4BACb,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,QAAQ,EAAE,CAAC,CAAC,KAAK;4BACjB,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,KAAK,EAAE,CAAC,CAAC,MAAM;yBAChB,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,kBAAG,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAA;YACrD,CAAC;YAED,OAAO,CAAC,CAAA;QACV,CAAC;QAAC,OAAO,EAAW,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,kBAAG,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACzC,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACzC,CAAC,CAAC,KAAK,GAAG,IAAI,kBAAG,CAAC,aAAa,CAC7B,oBAAoB,GAAG,YAAY,IAAI,CAAC,SAAS,CAAC,kBAAG,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CACrF,CAAA;gBACD,OAAO,CAAC,CAAA;YACV,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAQM,KAAK,UAAU,qBAAqB,CACzC,IAA0B,EAC1B,WAAoB;IAEpB,IAAI,IAAI,EAAE,CAAC;QACT,uDAAuD;QACvD,WAAW,KAAX,WAAW,GAAK,IAAI,GAAG,EAAE,GAAG,EAAE,EAAA;QAC9B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAA;IACtE,CAAC;IAED,qDAAqD;IACrD,MAAM,GAAG,GAAG,IAAI,sBAAY,EAAE,CAAA;IAC9B,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,CAAA;IAClC,MAAM,OAAO,GAAqD,CAAC,CAAA;IACnE,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,CAAC,IAAI,GAAG,GAAG,CAAA;IAElD,MAAM,OAAO,GAAwB;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAA;IAED,wDAAwD;IAExD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/out/src/signer/WalletSigner.d.ts

@@ -0,0 +1,11 @@
+import { KeyDeriver } from '@bsv/sdk';
+import { sdk } from '../index.client';
+import { WalletStorageManager } from '../storage/WalletStorageManager';
+export declare class WalletSigner {
+    isWalletSigner: true;
+    chain: sdk.Chain;
+    keyDeriver: KeyDeriver;
+    storage: WalletStorageManager;
+    constructor(chain: sdk.Chain, keyDeriver: KeyDeriver, storage: WalletStorageManager);
+}
+//# sourceMappingURL=WalletSigner.d.ts.map

package/out/src/signer/WalletSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletSigner.d.ts","sourceRoot":"","sources":["../../../../src/signer/WalletSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,qBAAa,YAAY;IACvB,cAAc,EAAE,IAAI,CAAO;IAE3B,KAAK,EAAE,GAAG,CAAC,KAAK,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,oBAAoB,CAAA;gBAG3B,KAAK,EAAE,GAAG,CAAC,KAAK,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,oBAAoB;CAMhC"}

package/out/src/signer/WalletSigner.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletSigner = void 0;
+class WalletSigner {
+    constructor(chain, keyDeriver, storage) {
+        this.isWalletSigner = true;
+        this.chain = chain;
+        this.keyDeriver = keyDeriver;
+        this.storage = storage;
+    }
+}
+exports.WalletSigner = WalletSigner;
+//# sourceMappingURL=WalletSigner.js.map

package/out/src/signer/WalletSigner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletSigner.js","sourceRoot":"","sources":["../../../../src/signer/WalletSigner.ts"],"names":[],"mappings":";;;AAIA,MAAa,YAAY;IAOvB,YACE,KAAgB,EAChB,UAAsB,EACtB,OAA6B;QAT/B,mBAAc,GAAS,IAAI,CAAA;QAWzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAhBD,oCAgBC"}

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

@@ -0,0 +1,4 @@
+import { AcquireCertificateResult } from '@bsv/sdk';
+import { sdk, Wallet } from '../../index.client';
+export declare function acquireDirectCertificate(wallet: Wallet, auth: sdk.AuthId, vargs: sdk.ValidAcquireDirectCertificateArgs): Promise<AcquireCertificateResult>;
+//# sourceMappingURL=acquireDirectCertificate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acquireDirectCertificate.d.ts","sourceRoot":"","sources":["../../../../../src/signer/methods/acquireDirectCertificate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,GAAG,EAAS,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEvD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,iCAAiC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,CA6CnC"}

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

@@ -0,0 +1,47 @@
+"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":";;AAGA,4DAiDC;AAjDM,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,IAAgB,EAChB,KAA4C;;IAE5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,OAAO,GAAuB;QAClC,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,EACN,KAAK,CAAC,eAAe,KAAK,WAAW;YACnC,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,eAAe;QAC3B,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/createAction.d.ts

@@ -0,0 +1,7 @@
+import { CreateActionResult, SendWithResult, SignActionSpend } from '@bsv/sdk';
+import { Transaction } from '@bsv/sdk';
+import { PendingSignAction, sdk, Wallet } from '../../index.client';
+export declare function createAction(wallet: Wallet, auth: sdk.AuthId, vargs: sdk.ValidCreateActionArgs): Promise<CreateActionResult>;
+export declare function completeSignedTransaction(prior: PendingSignAction, spends: Record<number, SignActionSpend>, wallet: Wallet): Promise<Transaction>;
+export declare function processAction(prior: PendingSignAction | undefined, wallet: Wallet, auth: sdk.AuthId, vargs: sdk.ValidProcessActionArgs): Promise<SendWithResult[] | undefined>;
+//# 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,kBAAkB,EAClB,cAAc,EAEd,eAAe,EAChB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAU,WAAW,EAAoB,MAAM,UAAU,CAAA;AAChE,OAAO,EAGL,iBAAiB,EAGjB,GAAG,EAEH,MAAM,EACP,MAAM,oBAAoB,CAAA;AAE3B,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,qBAAqB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAgED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CA8DtB;AAqBD,wBAAsB,aAAa,CACjC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,sBAAsB,GAChC,OAAO,CAAC,cAAc,EAAE,GAAG,SAAS,CAAC,CAevC"}

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

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAction = createAction;
+exports.completeSignedTransaction = completeSignedTransaction;
+exports.processAction = processAction;
+const sdk_1 = require("@bsv/sdk");
+const index_client_1 = require("../../index.client");
+async function createAction(wallet, auth, vargs) {
+    var _a;
+    const r = {};
+    let prior = undefined;
+    if (vargs.isNewTx) {
+        prior = await createNewTx(wallet, vargs);
+        if (vargs.isSignAction) {
+            return makeSignableTransactionResult(prior, wallet, vargs);
+        }
+        prior.tx = await completeSignedTransaction(prior, {}, wallet);
+        r.txid = prior.tx.id('hex');
+        r.noSendChange = (_a = prior.dcr.noSendChangeOutputVouts) === null || _a === void 0 ? void 0 : _a.map(vout => `${r.txid}.${vout}`);
+        if (!vargs.options.returnTXIDOnly)
+            r.tx = (0, index_client_1.makeAtomicBeef)(prior.tx, prior.dcr.inputBeef);
+    }
+    r.sendWithResults = await processAction(prior, wallet, auth, vargs);
+    return r;
+}
+async function createNewTx(wallet, args) {
+    const storageArgs = removeUnlockScripts(args);
+    const dcr = await wallet.storage.createAction(storageArgs);
+    const reference = dcr.reference;
+    const { tx, amount, pdi } = buildSignableTransaction(dcr, args, wallet);
+    const prior = { reference, dcr, args, amount, tx, pdi };
+    return prior;
+}
+function makeSignableTransactionResult(prior, wallet, args) {
+    var _a;
+    if (!prior.dcr.inputBeef)
+        throw new index_client_1.sdk.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: (0, index_client_1.makeAtomicBeef)(prior.tx, prior.dcr.inputBeef)
+        }
+    };
+    wallet.pendingSignActions[r.signableTransaction.reference] = prior;
+    return r;
+}
+/**
+ * Derive a change output locking script
+ */
+function makeChangeLock(out, dctr, args, changeKeys, wallet) {
+    const derivationPrefix = dctr.derivationPrefix;
+    const derivationSuffix = (0, index_client_1.verifyTruthy)(out.derivationSuffix);
+    const sabppp = new index_client_1.ScriptTemplateSABPPP({
+        derivationPrefix,
+        derivationSuffix,
+        keyDeriver: wallet.keyDeriver
+    });
+    const lockingScript = sabppp.lock(changeKeys.privateKey, changeKeys.publicKey);
+    return lockingScript;
+}
+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 index_client_1.sdk.WERR_INVALID_PARAMETER('args', `spend does not correspond to prior input with valid unlockingScriptLength.`);
+        if (spend.unlockingScript.length / 2 > createInput.unlockingScriptLength)
+            throw new index_client_1.sdk.WERR_INVALID_PARAMETER('args', `spend unlockingScript length ${spend.unlockingScript.length} exceeds expected length ${createInput.unlockingScriptLength}`);
+        input.unlockingScript = (0, index_client_1.asBsvSdkScript)(spend.unlockingScript);
+        if (spend.sequenceNumber !== undefined)
+            input.sequence = spend.sequenceNumber;
+    }
+    const results = {
+        sdk: {}
+    };
+    /////////////////////
+    // Insert SABPPP unlock templates for storage signed inputs
+    /////////////////////
+    for (const pdi of prior.pdi) {
+        const sabppp = new index_client_1.ScriptTemplateSABPPP({
+            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, index_client_1.asBsvSdkScript)(pdi.lockingScript);
+        const unlockTemplate = sabppp.unlock(lockerPrivKey, unlockerPubKey, sourceSatoshis, lockingScript);
+        const input = prior.tx.inputs[pdi.vin];
+        input.unlockingScriptTemplate = unlockTemplate;
+    }
+    /////////////////////
+    // Sign storage signed inputs making transaction fully valid.
+    /////////////////////
+    await prior.tx.sign();
+    return prior.tx;
+}
+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 : []
+    };
+    const r = await wallet.storage.processAction(args);
+    return r.sendWithResults;
+}
+function buildSignableTransaction(dctr, args, wallet) {
+    const changeKeys = wallet.getClientChangeKeyPair();
+    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 index_client_1.sdk.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 index_client_1.sdk.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, index_client_1.asBsvSdkScript)(out.lockingScript);
+        const output = {
+            satoshis: out.satoshis,
+            lockingScript,
+            change
+        };
+        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, index_client_1.asBsvSdkScript)(argsInput.unlockingScript)
+                : new sdk_1.Script();
+            const inputToAdd = {
+                sourceTXID: argsInput.outpoint.txid,
+                sourceOutputIndex: argsInput.outpoint.vout,
+                unlockingScript: unlock,
+                sequence: argsInput.sequenceNumber
+            };
+            tx.addInput(inputToAdd);
+        }
+        else {
+            // Type2: SABPPP protocol inputs which are signed using ScriptTemplateSABPPP.
+            if (storageInput.type !== 'P2PKH')
+                throw new index_client_1.sdk.WERR_INVALID_PARAMETER('type', `vin ${storageInput.vin}, "${storageInput.type}" is not a supported unlocking script type.`);
+            pendingStorageInputs.push({
+                vin: tx.inputs.length,
+                derivationPrefix: (0, index_client_1.verifyTruthy)(storageInput.derivationPrefix),
+                derivationSuffix: (0, index_client_1.verifyTruthy)(storageInput.derivationSuffix),
+                unlockerPubKey: storageInput.senderIdentityKey,
+                sourceSatoshis: storageInput.sourceSatoshis,
+                lockingScript: storageInput.sourceLockingScript
+            });
+            const inputToAdd = {
+                sourceTXID: storageInput.sourceTxid,
+                sourceOutputIndex: storageInput.sourceVout,
+                unlockingScript: new sdk_1.Script(),
+                sequence: 0xffffffff
+            };
+            tx.addInput(inputToAdd);
+            totalChangeInputs += (0, index_client_1.verifyTruthy)(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: ''
+    };
+}
+//# 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,31 @@
+import { InternalizeActionArgs, InternalizeActionResult } from '@bsv/sdk';
+import { sdk, Wallet } from '../../index.client';
+/**
+ * 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: sdk.AuthId, args: InternalizeActionArgs): Promise<InternalizeActionResult>;
+//# 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,EAEL,qBAAqB,EACrB,uBAAuB,EAIxB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,CAAC,MAAM,EAChB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAoGlC"}