@sidhujag/sysweb3-keyring 1.0.619 → 1.0.621

package/cjs/utils/excluded-utxos.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNoExcludedInputs = exports.filterExcludedUtxos = exports.excludedOutpointIds = void 0;
+const invalid = () => Object.assign(new Error('Invalid protected UTXO selection.'), {
+    error: true,
+    code: 'INVALID_EXCLUDED_UTXOS',
+});
+const excludedOutpointIds = (outpoints = []) => {
+    if (!Array.isArray(outpoints) || outpoints.length > 1000)
+        throw invalid();
+    return new Set(outpoints.map((entry) => {
+        if (!entry ||
+            typeof entry.txid !== 'string' ||
+            !/^[0-9a-fA-F]{64}$/.test(entry.txid) ||
+            !Number.isSafeInteger(entry.vout) ||
+            entry.vout < 0 ||
+            entry.vout > 0xffffffff)
+            throw invalid();
+        return `${entry.txid.toLowerCase()}:${entry.vout}`;
+    }));
+};
+exports.excludedOutpointIds = excludedOutpointIds;
+/** Preserve the backend's asset metadata while removing only reserved outputs. */
+const filterExcludedUtxos = (raw, excluded) => {
+    const rows = Array.isArray(raw) ? raw : raw?.utxos;
+    if (!Array.isArray(rows))
+        throw invalid();
+    const utxos = rows.filter((row) => {
+        const txid = row?.txId ?? row?.txid;
+        if (typeof txid !== 'string' ||
+            !/^[0-9a-fA-F]{64}$/.test(txid) ||
+            !Number.isSafeInteger(row.vout) ||
+            row.vout < 0 ||
+            row.vout > 0xffffffff ||
+            (row.txId !== undefined &&
+                row.txid !== undefined &&
+                (typeof row.txId !== 'string' ||
+                    typeof row.txid !== 'string' ||
+                    row.txId.toLowerCase() !== row.txid.toLowerCase())))
+            throw invalid();
+        return !excluded.has(`${txid.toLowerCase()}:${row.vout}`);
+    });
+    return Array.isArray(raw) ? { utxos } : { ...raw, utxos };
+};
+exports.filterExcludedUtxos = filterExcludedUtxos;
+const assertNoExcludedInputs = (psbt, excluded) => {
+    if (!Array.isArray(psbt?.txInputs))
+        throw invalid();
+    for (const input of psbt.txInputs) {
+        const id = `${Buffer.from(input.hash).reverse().toString('hex')}:${input.index}`;
+        if (excluded.has(id))
+            throw Object.assign(new Error('This transaction would spend protected collateral.'), {
+                error: true,
+                code: 'PROTECTED_COLLATERAL',
+            });
+    }
+};
+exports.assertNoExcludedInputs = assertNoExcludedInputs;
+//# sourceMappingURL=excluded-utxos.js.map

package/cjs/utils/excluded-utxos.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sidhujag/sysweb3-keyring",
-  "version": "1.0.619",
+  "version": "1.0.621",
   "description": "Keyring Manager for UTXO and Web3 Wallets",
   "main": "cjs/index.js",
   "types": "types/index.d.ts",

package/types/keyring-manager.d.ts

@@ -79,7 +79,7 @@ export declare class KeyringManager implements IKeyringManager {
     private isDescriptor;
     private isXpubLike;
     private isWatchOnlyAccount;
-    getEncryptedXprv: (hd: SyscoinHDSigner) => any;
+    getEncryptedXprv: (hd: SyscoinHDSigner) => string;
     getSeed: (pwd: string) => Promise<any>;
     deriveSLHDSASetupSecretForAccount: ({ accountIndex, }: {
         accountIndex: number;

package/types/transactions/ethereum.d.ts

@@ -11,6 +11,7 @@ export declare class EthereumTransactions implements IEthereumTransactions {
     trezorSigner: TrezorKeyring;
     ledgerSigner: LedgerKeyring;
     private getNetwork;
+    private captureSigningContext?;
     private abortController;
     private getDecryptedPrivateKey;
     private gasOverrides;
@@ -28,7 +29,8 @@ export declare class EthereumTransactions implements IEthereumTransactions {
         activeAccountId: number;
         activeAccountType: KeyringAccountType;
         activeNetwork: INetwork;
-    }, ledgerSigner: LedgerKeyring, trezorSigner: TrezorKeyring);
+    }, ledgerSigner: LedgerKeyring, trezorSigner: TrezorKeyring, captureSigningContext?: () => () => void);
+    private captureEvmSigningContext;
     get web3Provider(): CustomJsonRpcProvider;
     private ensureProvidersInitialized;
     private isUtxoNetwork;

package/types/transactions/syscoin.d.ts

@@ -4,6 +4,7 @@ import { LedgerKeyring } from '../ledger';
 import { SyscoinHDSigner } from '../signers';
 import { TrezorKeyring } from '../trezor';
 import { ISyscoinTransactions, KeyringAccountType, accountType } from '../types';
+import { ExcludedOutpoint } from '../utils/excluded-utxos';
 export declare class SyscoinTransactions implements ISyscoinTransactions {
     private getSigner;
     private getReadOnlySigner;
@@ -39,7 +40,7 @@ export declare class SyscoinTransactions implements ISyscoinTransactions {
     private createNativeSweepPSBT;
     private createUnsignedPSBT;
     private signPSBTWithMethod;
-    getEstimateSysTransactionFee: ({ txOptions, isMax, nativeSweep, amount, receivingAddress, feeRate, token, }: {
+    getEstimateSysTransactionFee: ({ txOptions, isMax, nativeSweep, amount, receivingAddress, feeRate, token, excludedOutpoints, }: {
         amount: number | string;
         feeRate?: number;
         receivingAddress: string;
@@ -50,6 +51,7 @@ export declare class SyscoinTransactions implements ISyscoinTransactions {
         txOptions?: any;
         isMax?: boolean | false;
         nativeSweep?: boolean;
+        excludedOutpoints?: readonly ExcludedOutpoint[];
     }) => Promise<{
         grossAmount?: string | undefined;
         recipientAmount?: string | undefined;

package/types/types.d.ts

@@ -99,7 +99,7 @@ export interface ISyscoinTransactionFeeQuote {
     recipientAmount?: string;
 }
 export interface ISyscoinTransactions {
-    getEstimateSysTransactionFee: ({ txOptions, amount, receivingAddress, feeRate, token, isMax, nativeSweep, }: {
+    getEstimateSysTransactionFee: ({ txOptions, amount, receivingAddress, feeRate, token, isMax, nativeSweep, excludedOutpoints, }: {
         amount: number | string;
         feeRate?: number;
         receivingAddress: string;
@@ -111,6 +111,11 @@ export interface ISyscoinTransactions {
         isMax?: boolean | false;
         /** Resolve explicit native MAX from one current funding snapshot. Requires isMax and token:null. */
         nativeSweep?: boolean;
+        /** Coin-control exclusions supplied by a trusted wallet policy, not transaction outputs. */
+        excludedOutpoints?: readonly {
+            txid: string;
+            vout: number;
+        }[];
     }) => Promise<ISyscoinTransactionFeeQuote>;
     getRecommendedFee: (explorerUrl: string) => Promise<number>;
     decodeRawTransaction: (psbtOrHex: any, isRawHex?: boolean) => any;

package/types/utils/excluded-utxos.d.ts

@@ -0,0 +1,13 @@
+export interface ExcludedOutpoint {
+    txid: string;
+    vout: number;
+}
+export declare const excludedOutpointIds: (outpoints?: readonly ExcludedOutpoint[]) => Set<string>;
+/** Preserve the backend's asset metadata while removing only reserved outputs. */
+export declare const filterExcludedUtxos: (raw: any, excluded: ReadonlySet<string>) => any;
+export declare const assertNoExcludedInputs: (psbt: {
+    txInputs: {
+        hash: Uint8Array;
+        index: number;
+    }[];
+}, excluded: ReadonlySet<string>) => void;