@sidhujag/sysweb3-keyring 2.0.0 → 2.1.0

package/cjs/transactions/prepared-bip84.js

@@ -0,0 +1,214 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotPreparedBip84Request = snapshotPreparedBip84Request;
+exports.clearBip84PrivateNodes = clearBip84PrivateNodes;
+exports.signValidatedBip84Plan = signValidatedBip84Plan;
+const secp256k1_1 = __importDefault(require("@bitcoinerlab/secp256k1"));
+const bitcoinjs_lib_1 = require("bitcoinjs-lib");
+const public_bip84_1 = require("../public-bip84");
+const bip84_native_plan_1 = require("./bip84-native-plan");
+/** Private host snapshot. A public prepared DTO never carries signing authority. */
+function snapshotPreparedBip84Request(input) {
+    const r = (0, bip84_native_plan_1.record)(input, ['account', 'prepared']);
+    const a = (0, bip84_native_plan_1.record)(r.account, ['type', 'index', 'expectedAccountKey']);
+    const p = (0, bip84_native_plan_1.record)(r.prepared, ['plan', 'unsignedTransaction', 'feeSatoshis']);
+    if (a.type !== 'HDAccount')
+        return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+    const accountIndex = (0, bip84_native_plan_1.index)(a.index);
+    if (typeof a.expectedAccountKey !== 'string' ||
+        a.expectedAccountKey.length > 112 ||
+        typeof p.unsignedTransaction !== 'string' ||
+        p.unsignedTransaction.length > bip84_native_plan_1.LIMITS.unsignedBytes * 2 ||
+        !/^(?:[0-9a-f]{2})+$/.test(p.unsignedTransaction) ||
+        typeof p.feeSatoshis !== 'string' ||
+        !/^(0|[1-9][0-9]{0,18})$/.test(p.feeSatoshis))
+        return (0, bip84_native_plan_1.fail)('INVALID_REQUEST');
+    const validated = (0, bip84_native_plan_1.validateBip84NativePlan)(p.plan);
+    if (accountIndex !== validated.prepared.plan.account.accountIndex ||
+        a.expectedAccountKey !== validated.prepared.plan.account.canonicalKey)
+        return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+    if (p.unsignedTransaction !== validated.prepared.unsignedTransaction ||
+        p.feeSatoshis !== validated.prepared.feeSatoshis)
+        return (0, bip84_native_plan_1.fail)('INVALID_REQUEST');
+    return {
+        account: Object.freeze({
+            type: 'HDAccount',
+            index: accountIndex,
+            expectedAccountKey: a.expectedAccountKey,
+        }),
+        validated,
+    };
+}
+/** Only operation-owned nodes. No session/shared key objects may be supplied. */
+function clearBip84PrivateNodes(nodes) {
+    while (nodes.length) {
+        const node = nodes.pop();
+        try {
+            node.privateKey?.fill(0);
+        }
+        catch {
+            // Continue retiring the other owned buffers and the operation token.
+            // JS/library copies and inaccessible buffers are not claimed zeroized.
+        }
+    }
+}
+const equal = (left, right) => Buffer.from(left).equals(Buffer.from(right));
+/** Internally owned PSBT only. No provider, generic SDK signer or partial result. */
+function signValidatedBip84Plan(validated, accountNode, assertCurrent) {
+    const nodes = [];
+    try {
+        const { prepared, psbt, previousOutputs } = validated;
+        const { plan } = prepared;
+        const profile = (0, bip84_native_plan_1.bip84Profile)(plan.network.network);
+        assertCurrent();
+        const derivedAccount = (0, public_bip84_1.parseBip84PublicAccount)({
+            network: plan.network.network,
+            accountKey: accountNode.neutered().toBase58(),
+        });
+        if (derivedAccount.canonicalKey !== plan.account.canonicalKey ||
+            derivedAccount.accountIndex !== plan.account.accountIndex)
+            return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+        const branches = new Map();
+        const children = new Map();
+        const publicKeys = [];
+        for (const [i, input] of plan.inputs.entries()) {
+            assertCurrent();
+            let branch = branches.get(input.branch);
+            if (!branch) {
+                branch = accountNode.derive(input.branch);
+                nodes.push(branch);
+                if (branch.index !== input.branch)
+                    return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+                branches.set(input.branch, branch);
+            }
+            const path = `${input.branch}/${input.index}`;
+            let child = children.get(path);
+            if (!child) {
+                child = branch.derive(input.index);
+                nodes.push(child);
+                if (child.index !== input.index)
+                    return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+                children.set(path, child);
+            }
+            const pubkey = Uint8Array.from(child.publicKey);
+            const payment = bitcoinjs_lib_1.payments.p2wpkh({
+                pubkey,
+                network: profile.addressNetwork,
+            });
+            if (pubkey.length !== 33 ||
+                !payment.output ||
+                !equal(payment.output, previousOutputs[i].script))
+                return (0, bip84_native_plan_1.fail)('INPUT_MISMATCH');
+            publicKeys.push(pubkey);
+            const signer = child;
+            assertCurrent();
+            psbt.signInput(i, {
+                publicKey: pubkey,
+                sign(hash) {
+                    assertCurrent();
+                    const signature = signer.sign(hash);
+                    assertCurrent();
+                    return signature;
+                },
+            }, [bitcoinjs_lib_1.Transaction.SIGHASH_ALL]);
+            assertCurrent();
+            const partial = psbt.data.inputs[i].partialSig;
+            if (!partial ||
+                partial.length !== 1 ||
+                !equal(partial[0].pubkey, pubkey) ||
+                bitcoinjs_lib_1.script.signature.decode(partial[0].signature).hashType !==
+                    bitcoinjs_lib_1.Transaction.SIGHASH_ALL ||
+                psbt.validateSignaturesOfInput(i, (key, hash, signature) => equal(key, pubkey) && secp256k1_1.default.verify(hash, key, signature, true), pubkey) !== true)
+                return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+        }
+        // Verify change from the private-derived account as well as the public plan.
+        if (plan.change) {
+            assertCurrent();
+            const branch = accountNode.neutered().derive(1);
+            if (branch.index !== 1)
+                return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+            const child = branch.derive(plan.change.index);
+            if (child.index !== plan.change.index)
+                return (0, bip84_native_plan_1.fail)('ACCOUNT_MISMATCH');
+            const payment = bitcoinjs_lib_1.payments.p2wpkh({
+                pubkey: child.publicKey,
+                network: profile.addressNetwork,
+            });
+            if (!payment.output || !equal(payment.output, psbt.txOutputs[1].script))
+                return (0, bip84_native_plan_1.fail)('INPUT_MISMATCH');
+        }
+        if (psbt.toBuffer().length > bip84_native_plan_1.LIMITS.psbtBytes)
+            return (0, bip84_native_plan_1.fail)('LIMIT_EXCEEDED');
+        assertCurrent();
+        for (let i = 0; i < plan.inputs.length; i++) {
+            psbt.finalizeInput(i);
+            const input = psbt.data.inputs[i];
+            if (!(input.finalScriptWitness instanceof Uint8Array) ||
+                input.finalScriptWitness.length === 0 ||
+                (input.finalScriptSig !== undefined && input.finalScriptSig.length > 0))
+                return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+        }
+        if (psbt.toBuffer().length > bip84_native_plan_1.LIMITS.psbtBytes)
+            return (0, bip84_native_plan_1.fail)('LIMIT_EXCEEDED');
+        assertCurrent();
+        // SJS overrides fee/extraction helpers. Their success is not our fee proof.
+        const bytes = psbt.extractTransaction().toBuffer();
+        if (bytes.length > bip84_native_plan_1.LIMITS.signedBytes)
+            return (0, bip84_native_plan_1.fail)('LIMIT_EXCEEDED');
+        const transaction = bitcoinjs_lib_1.Transaction.fromBuffer(bytes);
+        if (!equal(transaction.toBuffer(), bytes) ||
+            transaction.ins.length !== plan.inputs.length)
+            return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+        for (const [i, input] of transaction.ins.entries()) {
+            assertCurrent();
+            if (input.script.length !== 0 ||
+                input.witness.length !== 2 ||
+                !equal(input.witness[1], publicKeys[i]))
+                return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+            const signature = bitcoinjs_lib_1.script.signature.decode(input.witness[0]);
+            const scriptCode = bitcoinjs_lib_1.payments.p2pkh({ pubkey: publicKeys[i] }).output;
+            if (signature.hashType !== bitcoinjs_lib_1.Transaction.SIGHASH_ALL ||
+                !scriptCode ||
+                !equal(bitcoinjs_lib_1.script.signature.encode(signature.signature, signature.hashType), input.witness[0]) ||
+                !secp256k1_1.default.verify(transaction.hashForWitnessV0(i, scriptCode, previousOutputs[i].value, bitcoinjs_lib_1.Transaction.SIGHASH_ALL), publicKeys[i], signature.signature, true))
+                return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+        }
+        const unsigned = transaction.clone();
+        unsigned.stripWitnesses();
+        if (unsigned.toHex() !== prepared.unsignedTransaction)
+            return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+        const fee = previousOutputs.reduce((sum, output) => sum + output.value, 0n) -
+            transaction.outs.reduce((sum, output) => sum + output.value, 0n);
+        const virtualSize = transaction.virtualSize();
+        if (fee < 0n ||
+            fee.toString() !== prepared.feeSatoshis ||
+            fee > bip84_native_plan_1.LIMITS.maxFee ||
+            fee > BigInt(plan.feeLimits.maxFeeSatoshis) ||
+            !Number.isSafeInteger(virtualSize) ||
+            virtualSize <= 0 ||
+            fee > BigInt(virtualSize) * bip84_native_plan_1.LIMITS.maxFeeRate ||
+            fee > BigInt(virtualSize) * BigInt(plan.feeLimits.maxFeeRateSatPerVByte))
+            return (0, bip84_native_plan_1.fail)('FEE_LIMIT');
+        assertCurrent();
+        return Object.freeze({
+            rawTransaction: transaction.toHex(),
+            txid: transaction.getId(),
+            wtxid: Buffer.from(transaction.getHash(true)).reverse().toString('hex'),
+            unsignedTransaction: prepared.unsignedTransaction,
+            feeSatoshis: fee.toString(),
+            virtualSize,
+        });
+    }
+    catch (error) {
+        if (error instanceof bip84_native_plan_1.Bip84NativeError)
+            throw error;
+        return (0, bip84_native_plan_1.fail)('SIGNATURE_INVALID');
+    }
+    finally {
+        clearBip84PrivateNodes(nodes);
+    }
+}
+//# sourceMappingURL=prepared-bip84.js.map

package/cjs/transactions/prepared-bip84.js.map

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

package/cjs/transactions/prepared-evm.js

@@ -70,6 +70,7 @@ function snapshotPreparedEvmRequest(input) {
         !network.url ||
         network.url.length > 4096 ||
         network.url.trim() !== network.url ||
+        // eslint-disable-next-line no-control-regex -- Reject endpoint control characters and lone surrogates.
         /[\uD800-\uDFFF\u0000-\u001f\u007f]/u.test(network.url))
         throw invalid();
     const chainId = quantity(network.chainId, UINT256, true);

package/cjs/transactions/prepared-evm.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepared-evm.js","sourceRoot":"","sources":["../../../src/transactions/prepared-evm.ts"],"names":[],"mappings":";;AAgHA,gEA2GC;AAED,4CAkBC;AAGD,0DAuCC;AAzRD,4CAA4C;AAC5C,0CAA0C;AAC1C,oDAAiD;AAEjD,yDAAqD;AAqDrD,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;AAClC,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AAChC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AACjC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;AAE5E,6EAA6E;AAC7E,SAAS,MAAM,CACb,KAAc,EACd,IAAuB;IAEvB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,OAAO,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IACE,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEnE,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IACE,CAAC,UAAU;YACX,CAAC,UAAU,CAAC,UAAU;YACtB,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;YAE1D,MAAM,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,KAAK;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,GAAG,OAAO,IAAI,CAAC,QAAQ,IAAI,MAAM,KAAK,EAAE,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QACjE,MAAM,OAAO,EAAE,CAAC;IAClB,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,IAAA,oBAAU,EAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,0BAA0B,CACxC,KAAc;IAEd,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxE,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,EAAa,GAAG,CAAC;QACzB,OAAO,CAAC,EAAa,GAAG,UAAU;QACnC,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC;QAE7D,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,IACE,OAAO,CAAC,IAAI,KAAK,UAAU;QAC3B,OAAO,CAAC,MAAM,KAAK,EAAE;QACrB,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;QAC/B,CAAC,OAAO,CAAC,GAAG;QACZ,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,GAAG;QAClC,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QAEvD,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,gFAAgF;IAChF,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QAC3D,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,cAAc,GAAG,MAAM,CAAC,wBAAwB,CACpD,IAAI,CAAC,WAAW,EAChB,MAAM,CACP,CAAC;IACF,IACE,CAAC,cAAc;QACf,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;QAE9D,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC;IAClC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG;QACb,MAAM;QACN,MAAM;QACN,IAAI;QACJ,SAAS;QACT,OAAO;QACP,OAAO;QACP,UAAU;QACV,MAAM;KACP,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CACxB,IAAI,CAAC,WAAW,EAChB,IAAI,KAAK,CAAC;QACR,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC;QACzB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,sBAAsB,CAAC,CACxD,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,IACE,IAAI,KAAK,eAAe;QACxB,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,OAAO;QAExD,MAAM,OAAO,EAAE,CAAC;IAClB,IACE,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ;QACpC,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc;QAChD,CAAC,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAEjD,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG;QACb,IAAI;QACJ,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO;QACP,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnE,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;QAClC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;QACtD,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,MAAM,IAAI,GACR,IAAI,KAAK,CAAC;QACR,CAAC,CAAC,EAAE,IAAI,EAAE,CAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;QAChE,CAAC,CAAC;YACE,IAAI,EAAE,CAAU;YAChB,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC;YAChD,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC;SACjE,CAAC;IACR,IACE,IAAI,CAAC,IAAI,KAAK,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;QAE7D,MAAM,OAAO,EAAE,CAAC;IAClB,MAAM,UAAU,GACd,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO;QAAE,MAAM,OAAO,EAAE,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,EAAE,EAAE,OAAO,CAAC,EAAY;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,eAAe;SAChB,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,OAAO;YACP,MAAM,EAAE,EAAE;YACV,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IACjD,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU;QAAE,MAAM,OAAO,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC;IACpC,OAAO,GAAG,EAAE;QACV,MAAM,MAAM,GAAY,KAAK,EAAE,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,2EAA2E;YAC3E,IACE,MAAM,KAAK,IAAI;gBACf,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC;gBAE5D,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtD,MAAM,IAAI,SAAS,CACjB,gEAAgE,CACjE,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAgB,uBAAuB,CACrC,WAAmC,EACnC,UAAkB;IAElB,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;QACtC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;YACxB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;YAC5C,CAAC,CAAC;gBACE,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;gBAC9C,oBAAoB,EAAE,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC;aAC/D,CAAC;KACP,CAAC;IACF,MAAM,QAAQ,GAAG,yBAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAA,kCAAe,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,yBAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,IACE,CAAC,MAAM,CAAC,QAAQ,EAAE;QAClB,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI;QAChC,MAAM,CAAC,kBAAkB,KAAK,QAAQ,CAAC,kBAAkB;QACzD,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,YAAY;QAC7C,MAAM,CAAC,IAAI,KAAK,IAAA,kBAAS,EAAC,cAAc,CAAC;QAEzC,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,cAAc;QACd,IAAI,EAAE,MAAM,CAAC,IAAK;QAClB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,IAAI,EAAE,MAAM,CAAC,IAAK;QAClB,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"prepared-evm.js","sourceRoot":"","sources":["../../../src/transactions/prepared-evm.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sidhujag/sysweb3-keyring",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Keyring Manager for UTXO and Web3 Wallets",
   "main": "cjs/index.js",
   "types": "types/index.d.ts",
@@ -47,6 +47,18 @@
       ],
       "cjs/ledger/host-types.js": [
         "types/ledger/host-types.d.ts"
+      ],
+      "cjs/public-bip84": [
+        "types/public-bip84.d.ts"
+      ],
+      "cjs/public-bip84.js": [
+        "types/public-bip84.d.ts"
+      ],
+      "cjs/bip84-native": [
+        "types/bip84-native.d.ts"
+      ],
+      "cjs/bip84-native.js": [
+        "types/bip84-native.d.ts"
       ]
     }
   },
@@ -79,7 +91,7 @@
     "varuint-bitcoin": "^2.0.0"
   },
   "peerDependencies": {
-    "syscoinjs-lib": "^1.0.275"
+    "syscoinjs-lib": "^1.0.276"
   },
   "resolutions": {
     "axios": "^1.18.1",

package/types/bip84-native.d.ts

@@ -0,0 +1,3 @@
+/** Pure native-coin BIP84 transfer preparation, without a wallet or provider. */
+export { Bip84NativeError, prepareBip84NativeTransaction, } from './transactions/bip84-native-plan';
+export type { Bip84NativeErrorCode, Bip84NetworkBinding, Bip84Guard, Bip84NativePlan, PreparedBip84NativeTransaction, } from './transactions/bip84-native-plan';

package/types/keyring-core.d.ts

@@ -1,6 +1,9 @@
 import { INetwork, INetworkType } from '@sidhujag/sysweb3-network';
 import { IDecryptPrivateRecordParams, IEncryptedPrivateRecord, IEncryptPrivateRecordParams } from './private-records';
 import { SyscoinHDSigner } from './signers';
+import { Bip84HdPublicRequest, Bip84HdPublicResult } from './software-utxo-account';
+import { Bip84Guard } from './transactions/bip84-native-plan';
+import { PreparedBip84SigningRequest, SignedBip84NativeTransaction } from './transactions/prepared-bip84';
 import { type ISyscoinHardwareSigners } from './transactions/syscoin-core';
 import { IKeyringAccountState, ICreateSmartAccountParams, ISyscoinTransactions, KeyringAccountType, IEthereumTransactions } from './types';
 import type { LedgerKeyring } from './ledger';
@@ -73,6 +76,7 @@ export declare class KeyringCore<TLedger extends KeyringLedgerSigner | undefined
     private sessionPassword;
     private sessionMnemonic;
     private privateRecordSessionRevision;
+    private bip84Operation;
     constructor(dependencies: KeyringCoreDependencies<TLedger, TTrezor>);
     private createSyscoinTransactions;
     private requireLedgerSigner;
@@ -187,6 +191,10 @@ export declare class KeyringCore<TLedger extends KeyringLedgerSigner | undefined
      */
     private getDecryptedPrivateKey;
     private capturePsbtSigningContext;
+    /** Fixed-profile public UTXO derivation; private material remains operation-local. */
+    protected deriveSoftwareBip84HdPublicAccount(input: Bip84HdPublicRequest, options: Bip84Guard): Promise<Bip84HdPublicResult>;
+    /** Fixed selected-account native signing. No storage, discovery or broadcast. */
+    protected signPreparedSoftwareBip84Transaction(input: PreparedBip84SigningRequest, options: Bip84Guard): Promise<SignedBip84NativeTransaction>;
     /** Fixed-path derivation for an authenticated software host; no persistence. */
     protected deriveSoftwareEvmHdRuntimeAccount(input: EvmHdRuntimeAccountRequest, options: EvmHdRuntimeAccountOptions): Promise<EncryptedEvmHdRuntimeAccount>;
     /** The software facade owns this public capability; no device fallback. */

package/types/public-bip84.d.ts

@@ -0,0 +1,39 @@
+export type Bip84PublicNetwork = 'bitcoin' | 'syscoin';
+export type Bip84PublicAccountRequest = Readonly<{
+    network: Bip84PublicNetwork;
+    accountKey: string;
+}>;
+export type Bip84PublicAccount = Readonly<{
+    network: Bip84PublicNetwork;
+    policy: 'bip84-p2wpkh';
+    canonicalKey: string;
+    accountIndex: number;
+}>;
+export type Bip84PublicAddressRequest = Bip84PublicAccountRequest & Readonly<{
+    branch: 0 | 1;
+    index: number;
+}>;
+export type Bip84PublicAddress = Readonly<{
+    account: Bip84PublicAccount;
+    branch: 0 | 1;
+    index: number;
+    address: string;
+    scriptPubKey: string;
+}>;
+export declare class PublicBip84Error extends Error {
+    readonly code: 'INVALID_INPUT' | 'INVALID_ACCOUNT' | 'INVALID_DERIVATION';
+    constructor(code: 'INVALID_INPUT' | 'INVALID_ACCOUNT' | 'INVALID_DERIVATION');
+}
+/**
+ * Validate one public account and normalize xpub/zpub aliases. The chosen
+ * network and BIP84 policy are explicit; ancestry/purpose is not attested.
+ * No keyring, storage, provider, randomness or wallet signing is involved.
+ * BIP32Factory runs its upstream deterministic ECC self-tests at module load.
+ */
+export declare function parseBip84PublicAccount(request: Bip84PublicAccountRequest): Bip84PublicAccount;
+/**
+ * Derive only /0/index or /1/index from a validated mainnet account key.
+ * One bounded input and two child derivations; no discovery, cache or range
+ * iteration. Callers own scan limits and privacy consent. Returned data is public.
+ */
+export declare function deriveBip84PublicAddress(request: Bip84PublicAddressRequest): Bip84PublicAddress;

package/types/software-utxo-account.d.ts

@@ -0,0 +1,13 @@
+import { Bip84PublicAccount, Bip84PublicAddress } from './public-bip84';
+import { Bip84NetworkBinding } from './transactions/bip84-native-plan';
+export type Bip84HdPublicRequest = Readonly<{
+    network: Bip84NetworkBinding;
+    accountIndex: number;
+}>;
+export type Bip84HdPublicResult = Readonly<{
+    type: 'HDAccount';
+    accountIndex: number;
+    account: Bip84PublicAccount;
+    receive: Bip84PublicAddress;
+}>;
+export declare function snapshotBip84HdPublicRequest(value: unknown): Bip84HdPublicRequest;

package/types/software.d.ts

@@ -2,6 +2,9 @@
 import { KeyringCore } from './keyring-core';
 import type { KeyringStoragePort } from './keyring-core';
 import type { EncryptedEvmHdRuntimeAccount, EvmHdRuntimeAccountOptions, EvmHdRuntimeAccountRequest } from './software-hd-account';
+import type { Bip84HdPublicRequest, Bip84HdPublicResult } from './software-utxo-account';
+import type { Bip84Guard } from './transactions/bip84-native-plan';
+import type { PreparedBip84SigningRequest, SignedBip84NativeTransaction } from './transactions/prepared-bip84';
 import type { PreparedEvmSigningOptions, PreparedSoftwareEvmSigningRequest, SignedPreparedEvmTransaction } from './transactions/prepared-evm';
 declare const softwareHostBrand: unique symbol;
 /** Opaque handle minted by createSoftwareKeyringHost; no injectable persistence. */
@@ -18,6 +21,10 @@ export declare class SoftwareKeyring extends KeyringCore<undefined, undefined> {
      * never a public account/catalogue DTO. The host owns index allocation.
      */
     deriveEvmHdRuntimeAccount(request: EvmHdRuntimeAccountRequest, options: EvmHdRuntimeAccountOptions): Promise<EncryptedEvmHdRuntimeAccount>;
+    /** Derive public BIP84 account data from the live seed; no storage or discovery. */
+    deriveBip84HdPublicAccount(request: Bip84HdPublicRequest, options: Bip84Guard): Promise<Bip84HdPublicResult>;
+    /** Sign the selected HD account's exact prepared native transaction offline. */
+    signPreparedBip84Transaction(request: PreparedBip84SigningRequest, options: Bip84Guard): Promise<SignedBip84NativeTransaction>;
     /**
      * Sign exactly the prepared envelope without RPC, fee/nonce discovery or
      * broadcasting. The host must journal the result before submitting it.
@@ -37,3 +44,6 @@ export type { KeyringStoragePort } from './keyring-core';
 export type { IKeyringAccountState } from './types';
 export type { PreparedEvmTransaction, PreparedEvmSigningOptions, PreparedSoftwareEvmSigningRequest, SignedPreparedEvmTransaction, } from './transactions/prepared-evm';
 export type { EncryptedEvmHdRuntimeAccount, EvmHdRuntimeAccountOptions, EvmHdRuntimeAccountRequest, } from './software-hd-account';
+export type { Bip84HdPublicRequest, Bip84HdPublicResult, } from './software-utxo-account';
+export type { Bip84Guard } from './transactions/bip84-native-plan';
+export type { PreparedBip84SigningRequest, SignedBip84NativeTransaction, } from './transactions/prepared-bip84';

package/types/transactions/bip84-native-plan.d.ts

@@ -0,0 +1,83 @@
+import { Psbt, Network } from 'bitcoinjs-lib';
+import { Bip84PublicAccount, Bip84PublicNetwork } from '../public-bip84';
+export type Bip84NetworkBinding = Readonly<{
+    network: Bip84PublicNetwork;
+    endpoint: string;
+}>;
+export type Bip84Guard = Readonly<{
+    assertCurrent(): void;
+}>;
+export type Bip84NativePlan = Readonly<{
+    network: Bip84NetworkBinding;
+    account: Bip84PublicAccount;
+    inputs: readonly Readonly<{
+        txid: string;
+        vout: number;
+        branch: 0 | 1;
+        index: number;
+    }>[];
+    previousTransactions: readonly Readonly<{
+        txid: string;
+        rawTransaction: string;
+    }>[];
+    recipient: Readonly<{
+        address: string;
+        valueSatoshis: string;
+    }>;
+    change: Readonly<{
+        index: number;
+        valueSatoshis: string;
+    }> | null;
+    locktime: 0;
+    rbf: boolean;
+    feeLimits: Readonly<{
+        maxFeeSatoshis: string;
+        maxFeeRateSatPerVByte: string;
+    }>;
+}>;
+export type PreparedBip84NativeTransaction = Readonly<{
+    plan: Bip84NativePlan;
+    unsignedTransaction: string;
+    feeSatoshis: string;
+}>;
+export type Bip84NativeErrorCode = 'INVALID_REQUEST' | 'LIMIT_EXCEEDED' | 'UNSUPPORTED_NETWORK' | 'UNSUPPORTED_PARENT' | 'ACCOUNT_MISMATCH' | 'INPUT_MISMATCH' | 'FEE_LIMIT' | 'SIGNATURE_INVALID' | 'CANCELLED' | 'BUSY';
+export declare class Bip84NativeError extends Error {
+    readonly code: Bip84NativeErrorCode;
+    constructor(code: Bip84NativeErrorCode);
+}
+export declare const LIMITS: Readonly<{
+    inputs: 64;
+    parentBytes: 1000000;
+    totalParentBytes: 2000000;
+    parentComponents: 8192;
+    unsignedBytes: number;
+    signedBytes: number;
+    psbtBytes: number;
+    maxFee: 10000000n;
+    maxFeeRate: 1000n;
+}>;
+export type Bip84Profile = Readonly<{
+    chainId: number;
+    slip44: number;
+    currency: string;
+    maximumMoney: bigint;
+    addressNetwork: Network;
+}>;
+export declare const bip84Profile: (network: Bip84PublicNetwork) => Bip84Profile;
+export declare const fail: (code: Bip84NativeErrorCode) => never;
+export declare function record(value: unknown, fields: readonly string[]): Record<string, unknown>;
+export declare function index(value: unknown): number;
+export declare function snapshotBip84Network(value: unknown): Bip84NetworkBinding;
+export declare function snapshotBip84Guard(value: unknown): () => void;
+export type ValidatedBip84Plan = {
+    prepared: PreparedBip84NativeTransaction;
+    psbt: Psbt;
+    previousOutputs: readonly Readonly<{
+        script: Uint8Array;
+        value: bigint;
+    }>[];
+};
+/** Internal result includes owned mutable transaction data; public entry exports only prepare. */
+export declare function validateBip84NativePlan(value: unknown): ValidatedBip84Plan;
+/** Pure bounded preparation; returned data carries no signing authorization. */
+export declare function prepareBip84NativeTransaction(plan: Bip84NativePlan): PreparedBip84NativeTransaction;

package/types/transactions/prepared-bip84.d.ts

@@ -0,0 +1,27 @@
+import { BIP32Interface } from 'bip32';
+import { PreparedBip84NativeTransaction, ValidatedBip84Plan } from './bip84-native-plan';
+export type PreparedBip84SigningRequest = Readonly<{
+    account: Readonly<{
+        type: 'HDAccount';
+        index: number;
+        expectedAccountKey: string;
+    }>;
+    prepared: PreparedBip84NativeTransaction;
+}>;
+export type SignedBip84NativeTransaction = Readonly<{
+    rawTransaction: string;
+    txid: string;
+    wtxid: string;
+    unsignedTransaction: string;
+    feeSatoshis: string;
+    virtualSize: number;
+}>;
+/** Private host snapshot. A public prepared DTO never carries signing authority. */
+export declare function snapshotPreparedBip84Request(input: unknown): {
+    account: PreparedBip84SigningRequest['account'];
+    validated: ValidatedBip84Plan;
+};
+/** Only operation-owned nodes. No session/shared key objects may be supplied. */
+export declare function clearBip84PrivateNodes(nodes: BIP32Interface[]): void;
+/** Internally owned PSBT only. No provider, generic SDK signer or partial result. */
+export declare function signValidatedBip84Plan(validated: ValidatedBip84Plan, accountNode: BIP32Interface, assertCurrent: () => void): SignedBip84NativeTransaction;