@chainvue/verus-sdk 0.4.1 → 0.5.1

package/dist/types/index.d.ts

@@ -6,7 +6,7 @@ import type { Network } from '../constants/index.js';
 export interface Utxo {
     txid: string;
     outputIndex: number;
-    satoshis: number;
+    satoshis: bigint;
     script: string;
     /** Height where this UTXO was created (0 = mempool) */
     height?: number;
@@ -14,18 +14,18 @@ export interface Utxo {
 /** Decoded currency values on a UTXO */
 export interface DecodedUtxo extends Utxo {
     /** Currency i-address → satoshi amount */
-    currencyValues: Map<string, number>;
+    currencyValues: Map<string, bigint>;
 }
 /** Result of UTXO selection */
 export interface SelectionResult {
     /** Selected UTXOs */
     selected: Utxo[];
     /** Native (VRSC) change in satoshis */
-    nativeChange: number;
+    nativeChange: bigint;
     /** Currency changes: i-address → satoshi amount */
-    currencyChanges: Map<string, number>;
+    currencyChanges: Map<string, bigint>;
     /** Estimated fee in satoshis */
-    fee: number;
+    fee: bigint;
 }
 /** SDK configuration */
 export interface VerusSDKConfig {
@@ -35,7 +35,7 @@ export interface VerusSDKConfig {
 export interface SignedTxResult {
     signedTx: string;
     txid: string;
-    fee: number;
+    fee: bigint;
 }
 /** Transfer parameters */
 export interface TransferParams {
@@ -43,7 +43,7 @@ export interface TransferParams {
     /** Recipient address (R-address) */
     to: string;
     /** Amount in satoshis */
-    amount: number;
+    amount: bigint;
     utxos: Utxo[];
     changeAddress: string;
     expiryHeight?: number;
@@ -54,7 +54,7 @@ export interface TransferTokenParams {
     /** Recipient address (R-address or i-address) */
     to: string;
     /** Amount in satoshis */
-    amount: number;
+    amount: bigint;
     /** Currency i-address */
     currency: string;
     /** Address type: 'PKH' (R-address) or 'ID' (i-address) */
@@ -67,7 +67,7 @@ export interface TransferTokenParams {
 export interface ConvertParams {
     wif: string;
     /** Amount in satoshis */
-    amount: number;
+    amount: bigint;
     /** Source currency i-address */
     currency: string;
     /** Target currency i-address */
@@ -82,8 +82,8 @@ export interface ConvertParams {
 export interface CurrencyOutput {
     /** Currency i-address (use system ID for native VRSC) */
     currency: string;
-    /** Amount in satoshis (as string) */
-    satoshis: string;
+    /** Amount in satoshis */
+    satoshis: bigint;
     /** Recipient address */
     address: string;
     /** Address type: 'PKH' (R-address), 'ID' (i-address), 'ETH' (Ethereum) */
@@ -99,7 +99,7 @@ export interface CurrencyOutput {
     /** Fee currency i-address */
     feeCurrency?: string;
     /** Fee amount in satoshis */
-    feeSatoshis?: string;
+    feeSatoshis?: bigint;
     /** Pre-conversion flag */
     preconvert?: boolean;
 }
@@ -114,7 +114,7 @@ export interface SendCurrencyParams {
 /** Send currency result */
 export interface SendCurrencyResult extends SignedTxResult {
     inputsUsed: number;
-    nativeChange: number;
+    nativeChange: bigint;
 }
 /** Simple P2PKH build+sign parameters */
 export interface BuildAndSignParams {
@@ -123,13 +123,13 @@ export interface BuildAndSignParams {
         txid: string;
         vout: number;
         scriptPubKey: string;
-        amount: number;
+        amount: bigint;
     }>;
     outputs: Array<{
         address: string;
-        amount: number;
+        amount: bigint;
     }>;
-    fee?: number;
+    fee?: bigint;
     expiryHeight?: number;
 }
 /** Commitment data returned from createCommitment */
@@ -169,12 +169,12 @@ export interface RegisterIdentityParams {
     recoveryAuthority?: string;
     /** Referral chain: i-addresses tracing referral levels (up to 3) */
     referralChain?: string[];
-    /** Registration fee in VRSC satoshis (default: 10000000000 = 100 VRSC) */
-    registrationFee?: number;
+    /** Registration fee in VRSC satoshis (default: 10000000000n = 100 VRSC) */
+    registrationFee?: bigint;
     /** Registration fee in parent currency satoshis (for sub-IDs) */
-    registrationFeeAmount?: number;
+    registrationFeeAmount?: bigint;
     /** Native import fee in VRSC satoshis (for sub-IDs on fractional currencies) */
-    nativeImportFee?: number;
+    nativeImportFee?: bigint;
     /** Number of referral levels (default: 3) */
     referralLevels?: number;
     expiryHeight?: number;
@@ -182,11 +182,11 @@ export interface RegisterIdentityParams {
 /** Register identity result */
 export interface RegisterIdentityResult extends SignedTxResult {
     identityAddress: string;
-    registrationFee: number;
+    registrationFee: bigint;
     referralPayments: number;
-    referralAmountEach: number;
+    referralAmountEach: bigint;
     inputsUsed: number;
-    nativeChange: number;
+    nativeChange: bigint;
 }
 /** Update identity parameters */
 export interface UpdateIdentityParams {
@@ -208,7 +208,7 @@ export interface UpdateIdentityResult extends SignedTxResult {
     identityAddress: string;
     operation: string;
     inputsUsed: number;
-    nativeChange: number;
+    nativeChange: bigint;
 }
 /** Lock identity parameters */
 export interface LockIdentityParams {
@@ -256,7 +256,7 @@ export interface DefineCurrencyParams {
     identityHex: string;
     identityUtxo: Utxo;
     currencyDefScript: string;
-    currencyDefValue?: number;
+    currencyDefValue?: bigint;
     utxos: Utxo[];
     changeAddress: string;
     expiryHeight?: number;
@@ -265,7 +265,7 @@ export interface DefineCurrencyParams {
 export interface DefineCurrencyResult extends SignedTxResult {
     identityAddress: string;
     inputsUsed: number;
-    nativeChange: number;
+    nativeChange: bigint;
 }
 /** Sign message parameters */
 export interface SignMessageParams {

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,oEAAoE;AACpE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,0CAA0C;IAC1C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAwB;AACxB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACnC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2BAA2B;AAC3B,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+BAA+B;AAC/B,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,IAAI,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+BAA+B;AAC/B,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAED,4BAA4B;AAC5B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,oDAAoD;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,yBAAyB,EAAE,YAAY,CAAC;CACtD;AAED,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,oBAAoB,CAAC;IAChC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -13,10 +13,29 @@ export declare function writeCompactSize(value: number): Buffer;
  * Decode an i-address to its 20-byte hash
  */
 export declare function iAddressToHash(iAddress: string): Buffer;
-/** Convert coin units to satoshis */
-export declare function toSatoshis(coins: number): number;
-/** Convert satoshis to coin units */
-export declare function toCoins(satoshis: number): number;
+/** Number of decimal places in a coin amount */
+export declare const AMOUNT_DECIMALS = 8;
+/** Satoshis per coin unit */
+export declare const SATS_PER_COIN = 100000000n;
+/**
+ * Parse a decimal coin-amount string into bigint satoshis. Exact arithmetic
+ * only — rejects anything outside the grammar (negative, exponent notation,
+ * more than 8 fraction digits, empty, non-numeric) with a typed error.
+ */
+export declare function parseSats(decimal: string): bigint;
+/** Convert coin units (decimal string) to satoshis — alias of parseSats */
+export declare function toSatoshis(coins: string): bigint;
+/**
+ * Convert satoshis to a decimal coin-unit string (minimal form, trailing
+ * fraction zeros trimmed). Exact — never goes through float64.
+ */
+export declare function toCoins(satoshis: bigint): string;
+/**
+ * Convert bigint satoshis to the `number` that @bitgo/utxo-lib expects at its
+ * boundary. The SDK is exact-integer internally; this is the single checked
+ * crossing into the signing library, which still models values as float64.
+ */
+export declare function toSafeNumber(sats: bigint): number;
 /**
  * Convert an R-address or P2SH address to a scriptPubKey Buffer
  */
@@ -28,7 +47,7 @@ export interface DecodedInput {
 }
 /** One output of a signed transaction. `address` is null for smart outputs. */
 export interface DecodedOutput {
-    valueSat: number;
+    valueSat: bigint;
     scriptHex: string;
     /** Base58 address when the script is plain P2PKH/P2SH, else null. */
     address: string | null;

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB7D;AAID,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,GAAG,SAAS,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAqCpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAID,gDAAgD;AAChD,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,6BAA6B;AAC7B,eAAO,MAAM,aAAa,aAAe,CAAC;AAS1C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWhD;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8B7D;AAID,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,GAAG,SAAS,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAqCpE"}

package/dist/utils/index.js

@@ -6,17 +6,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SATS_PER_COIN = exports.AMOUNT_DECIMALS = void 0;
 exports.sha256d = sha256d;
 exports.writeCompactSize = writeCompactSize;
 exports.iAddressToHash = iAddressToHash;
+exports.parseSats = parseSats;
 exports.toSatoshis = toSatoshis;
 exports.toCoins = toCoins;
+exports.toSafeNumber = toSafeNumber;
 exports.addressToScriptPubKey = addressToScriptPubKey;
 exports.summarizeSignedTransaction = summarizeSignedTransaction;
 const crypto_1 = require("crypto");
 const bs58check_1 = __importDefault(require("bs58check"));
 const verus_typescript_primitives_1 = require("verus-typescript-primitives");
 const index_js_1 = require("../constants/index.js");
+const errors_js_1 = require("../errors.js");
 /**
  * SHA256d (double SHA-256) of one or more buffers
  */
@@ -59,19 +63,73 @@ function iAddressToHash(iAddress) {
     const { hash } = (0, verus_typescript_primitives_1.fromBase58Check)(iAddress);
     return Buffer.from(hash);
 }
-/** Convert coin units to satoshis */
+// ─── Exact money conversions (bigint satoshis ↔ decimal strings) ─────────
+/** Number of decimal places in a coin amount */
+exports.AMOUNT_DECIMALS = 8;
+/** Satoshis per coin unit */
+exports.SATS_PER_COIN = 100000000n;
+/**
+ * Grammar for decimal coin amounts: non-negative, no leading zeros in the
+ * integer part, optional `.` with 1–8 fraction digits. No exponents, no
+ * signs, no whitespace.
+ */
+const DECIMAL_AMOUNT_RE = /^(?:0|[1-9]\d*)(?:\.\d{1,8})?$/;
+/**
+ * Parse a decimal coin-amount string into bigint satoshis. Exact arithmetic
+ * only — rejects anything outside the grammar (negative, exponent notation,
+ * more than 8 fraction digits, empty, non-numeric) with a typed error.
+ */
+function parseSats(decimal) {
+    if (typeof decimal !== 'string' || !DECIMAL_AMOUNT_RE.test(decimal)) {
+        throw new errors_js_1.InvalidAmountError(String(decimal));
+    }
+    const [whole = '0', fraction = ''] = decimal.split('.');
+    return BigInt(whole) * exports.SATS_PER_COIN + BigInt(fraction.padEnd(exports.AMOUNT_DECIMALS, '0'));
+}
+/** Convert coin units (decimal string) to satoshis — alias of parseSats */
 function toSatoshis(coins) {
-    return Math.round(coins * 1e8);
+    return parseSats(coins);
 }
-/** Convert satoshis to coin units */
+/**
+ * Convert satoshis to a decimal coin-unit string (minimal form, trailing
+ * fraction zeros trimmed). Exact — never goes through float64.
+ */
 function toCoins(satoshis) {
-    return satoshis / 1e8;
+    const sign = satoshis < 0n ? '-' : '';
+    const abs = satoshis < 0n ? -satoshis : satoshis;
+    const whole = abs / exports.SATS_PER_COIN;
+    const fraction = abs % exports.SATS_PER_COIN;
+    if (fraction === 0n)
+        return `${sign}${whole}`;
+    const fractionStr = fraction
+        .toString()
+        .padStart(exports.AMOUNT_DECIMALS, '0')
+        .replace(/0+$/, '');
+    return `${sign}${whole}.${fractionStr}`;
+}
+const MAX_SAFE_SATS = BigInt(Number.MAX_SAFE_INTEGER);
+/**
+ * Convert bigint satoshis to the `number` that @bitgo/utxo-lib expects at its
+ * boundary. The SDK is exact-integer internally; this is the single checked
+ * crossing into the signing library, which still models values as float64.
+ */
+function toSafeNumber(sats) {
+    if (sats < 0n || sats > MAX_SAFE_SATS) {
+        throw new errors_js_1.InvalidAmountError(sats.toString(), 'outside the safe-integer range supported by the underlying signing library');
+    }
+    return Number(sats);
 }
 /**
  * Convert an R-address or P2SH address to a scriptPubKey Buffer
  */
 function addressToScriptPubKey(address) {
-    const decoded = bs58check_1.default.decode(address);
+    let decoded;
+    try {
+        decoded = bs58check_1.default.decode(address);
+    }
+    catch (err) {
+        throw new errors_js_1.InvalidAddressError(address, err.message);
+    }
     const prefix = decoded[0];
     const hash = decoded.slice(1);
     if (prefix === 0x3c) {
@@ -91,7 +149,7 @@ function addressToScriptPubKey(address) {
         ]);
     }
     else {
-        throw new Error(`Unsupported address prefix: 0x${prefix.toString(16)}. Use sendCurrency for i-address destinations.`);
+        throw new errors_js_1.InvalidAddressError(address, `Unsupported address prefix: 0x${(prefix ?? 0).toString(16)}. Use sendCurrency for i-address destinations.`);
     }
 }
 /**
@@ -102,9 +160,11 @@ function addressToScriptPubKey(address) {
  * transaction parsing.
  */
 function summarizeSignedTransaction(hex, network) {
-    // Lazy require keeps utils' import graph light for non-tx consumers.
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    const { Transaction, address: addressLib, networks, smarttxs } = require('@bitgo/utxo-lib');
+    // Lazy require keeps utils' import graph light for non-tx consumers. The
+    // fork's ambient module declaration (bitgo-utxo-lib.d.ts) types the shape.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports -- deliberate lazy load; see above
+    const utxolib = require('@bitgo/utxo-lib');
+    const { Transaction, address: addressLib, networks, smarttxs } = utxolib;
     const net = network === 'testnet' ? networks.verustest : networks.verus;
     const chainId = network === 'testnet' ? index_js_1.NETWORK_CONFIG.testnet.chainId : index_js_1.NETWORK_CONFIG.mainnet.chainId;
     const tx = Transaction.fromHex(hex, net);
@@ -127,14 +187,14 @@ function summarizeSignedTransaction(hex, network) {
                 const unpacked = smarttxs.unpackOutput({ script: out.script, value: out.value }, chainId);
                 const evalCodes = (unpacked.params ?? []).map((p) => p.eval);
                 if (unpacked.destinations.length === 1 && evalCodes.every((code) => code === 0)) {
-                    addr = unpacked.destinations[0];
+                    addr = unpacked.destinations[0] ?? null;
                 }
             }
             catch {
                 addr = null; // exotic CC output — no address form
             }
         }
-        return { valueSat: out.value, scriptHex: out.script.toString('hex'), address: addr };
+        return { valueSat: BigInt(out.value), scriptHex: out.script.toString('hex'), address: addr };
     });
     return { txid: tx.getId(), inputs, outputs };
 }

package/dist/utils/index.js.map

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

package/dist/utxo/index.d.ts

@@ -3,19 +3,25 @@
  *
  * Selects UTXOs to cover required native + currency amounts,
  * calculates fees, and determines change outputs.
+ *
+ * All amounts are bigint satoshis — exact integer arithmetic only.
  */
 import type { Utxo, DecodedUtxo, SelectionResult } from '../types/index.js';
 export type { Utxo, DecodedUtxo, SelectionResult };
 /**
  * Decode a UTXO's script to extract currency values
+ *
+ * Throws TransactionBuildError if a smart output fails to decode — a failed
+ * token decode must never be silently reclassified as native-only, because
+ * selection would then spend token value it did not account for.
  */
 export declare function decodeUtxo(utxo: Utxo, systemId: string): DecodedUtxo;
 /**
  * Estimate transaction fee based on input/output counts
  */
-export declare function estimateFee(numInputs: number, numOutputs: number, feePerKb?: number, hasSmartOutputs?: boolean): number;
+export declare function estimateFee(numInputs: number, numOutputs: number, feePerKb?: bigint, hasSmartOutputs?: boolean): bigint;
 /**
  * Select UTXOs to cover required amounts
  */
-export declare function selectUtxos(utxos: Utxo[], requiredNative: number, requiredCurrencies?: Map<string, number>, numOutputs?: number, systemId?: string, feePerKb?: number, hasSmartOutputs?: boolean): SelectionResult;
+export declare function selectUtxos(utxos: Utxo[], requiredNative: bigint, requiredCurrencies?: Map<string, bigint>, numOutputs?: number, systemId?: string, feePerKb?: bigint, hasSmartOutputs?: boolean): SelectionResult;
 //# sourceMappingURL=index.d.ts.map

package/dist/utxo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utxo/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAK5E,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AAQnD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAwBpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAA2B,EACrC,eAAe,GAAE,OAAe,GAC/B,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,kBAAkB,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EACnD,UAAU,GAAE,MAAU,EACtB,QAAQ,GAAE,MAAuC,EACjD,QAAQ,GAAE,MAA2B,EACrC,eAAe,GAAE,OAAe,GAC/B,eAAe,CA4GjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utxo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAK5E,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AA6BnD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CA2BpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAA2B,EACrC,eAAe,GAAE,OAAe,GAC/B,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,kBAAkB,GAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,EACnD,UAAU,GAAE,MAAU,EACtB,QAAQ,GAAE,MAAuC,EACjD,QAAQ,GAAE,MAA2B,EACrC,eAAe,GAAE,OAAe,GAC/B,eAAe,CA+GjB"}

package/dist/utxo/index.js

@@ -4,6 +4,8 @@
  *
  * Selects UTXOs to cover required native + currency amounts,
  * calculates fees, and determines change outputs.
+ *
+ * All amounts are bigint satoshis — exact integer arithmetic only.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeUtxo = decodeUtxo;
@@ -12,33 +14,58 @@ exports.selectUtxos = selectUtxos;
 const utxo_lib_1 = require("@bitgo/utxo-lib");
 const index_js_1 = require("../constants/index.js");
 const errors_js_1 = require("../errors.js");
+const index_js_2 = require("../utils/index.js");
 const { unpackOutput } = utxo_lib_1.smarttxs;
 // Transaction size estimation constants
 const INPUT_SIZE = 180;
 const P2PKH_OUTPUT_SIZE = 34;
 const SMART_OUTPUT_SIZE = 200;
 const TX_OVERHEAD = 60;
+/** Absolute fee floor in satoshis */
+const MIN_FEE = 10000n;
+/**
+ * True when the script is a Verus smart (CryptoCondition) output. Used to
+ * separate "plain script that unpackOutput doesn't model" (fine — native
+ * only) from "smart output that failed to decode" (dangerous — the UTXO may
+ * carry token value we cannot see).
+ */
+function isSmartTransactionScript(script) {
+    try {
+        const chunks = utxo_lib_1.script.decompile(script);
+        if (chunks === null)
+            return false;
+        return chunks.some((chunk) => typeof chunk === 'number' && chunk === utxo_lib_1.opcodes.OP_CHECKCRYPTOCONDITION);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Decode a UTXO's script to extract currency values
+ *
+ * Throws TransactionBuildError if a smart output fails to decode — a failed
+ * token decode must never be silently reclassified as native-only, because
+ * selection would then spend token value it did not account for.
  */
 function decodeUtxo(utxo, systemId) {
     const currencyValues = new Map();
+    const script = Buffer.from(utxo.script, 'hex');
+    const nativeValue = (0, index_js_2.toSafeNumber)(utxo.satoshis);
     try {
-        const output = {
-            value: utxo.satoshis,
-            script: Buffer.from(utxo.script, 'hex'),
-        };
-        const unpacked = unpackOutput(output, systemId, true);
+        const unpacked = unpackOutput({ value: nativeValue, script }, systemId, true);
         for (const [currency, value] of Object.entries(unpacked.values)) {
-            const amount = typeof value === 'number' ? value : value.toNumber();
-            if (amount > 0) {
+            const amount = BigInt(value.toString(10));
+            if (amount > 0n) {
                 currencyValues.set(currency, amount);
             }
         }
     }
-    catch {
-        // If unpacking fails, treat as native-only
-        if (utxo.satoshis > 0) {
+    catch (err) {
+        if (isSmartTransactionScript(script)) {
+            throw new errors_js_1.TransactionBuildError(`cannot decode smart output ${utxo.txid}:${utxo.outputIndex}: ${err.message}`);
+        }
+        // Plain script that unpackOutput doesn't model (e.g. P2SH) — native-only
+        if (utxo.satoshis > 0n) {
             currencyValues.set(systemId, utxo.satoshis);
         }
     }
@@ -50,8 +77,8 @@ function decodeUtxo(utxo, systemId) {
 function estimateFee(numInputs, numOutputs, feePerKb = index_js_1.DEFAULT_FEE_PER_KB, hasSmartOutputs = false) {
     const outputSize = hasSmartOutputs ? SMART_OUTPUT_SIZE : P2PKH_OUTPUT_SIZE;
     const txSize = TX_OVERHEAD + numInputs * INPUT_SIZE + numOutputs * outputSize;
-    const fee = Math.ceil((txSize / 1000) * feePerKb);
-    return Math.max(fee, 10000);
+    const fee = (BigInt(txSize) * feePerKb + 999n) / 1000n; // ceil(txSize * feePerKb / 1000)
+    return fee > MIN_FEE ? fee : MIN_FEE;
 }
 /**
  * Select UTXOs to cover required amounts
@@ -70,8 +97,8 @@ function selectUtxos(utxos, requiredNative, requiredCurrencies = new Map(), numO
             for (const [currency, needed] of remaining) {
                 if (currency === systemId)
                     continue;
-                const utxoAmount = utxo.currencyValues.get(currency) || 0;
-                if (utxoAmount > 0 && needed > 0) {
+                const utxoAmount = utxo.currencyValues.get(currency) || 0n;
+                if (utxoAmount > 0n && needed > 0n) {
                     hasNeededCurrency = true;
                     break;
                 }
@@ -79,20 +106,20 @@ function selectUtxos(utxos, requiredNative, requiredCurrencies = new Map(), numO
             if (hasNeededCurrency) {
                 selected.push(utxo);
                 for (const [currency, amount] of utxo.currencyValues) {
-                    if (currency === systemId) {
-                        remainingNative -= amount;
-                    }
-                    else {
-                        const needed = remaining.get(currency) || 0;
-                        remaining.set(currency, needed - amount);
-                    }
+                    // The UTXO's native value is credited once below via utxo.satoshis;
+                    // unpackOutput also reports it under systemId in currencyValues, so
+                    // skipping it here avoids double-counting.
+                    if (currency === systemId)
+                        continue;
+                    const needed = remaining.get(currency) || 0n;
+                    remaining.set(currency, needed - amount);
                 }
                 remainingNative -= utxo.satoshis;
             }
         }
         for (const [currency, needed] of remaining) {
-            if (currency !== systemId && needed > 0) {
-                const totalAvailable = decoded.reduce((sum, u) => sum + (u.currencyValues.get(currency) || 0), 0);
+            if (currency !== systemId && needed > 0n) {
+                const totalAvailable = decoded.reduce((sum, u) => sum + (u.currencyValues.get(currency) || 0n), 0n);
                 throw new errors_js_1.InsufficientFundsError(needed + totalAvailable, totalAvailable, currency);
             }
         }
@@ -100,18 +127,18 @@ function selectUtxos(utxos, requiredNative, requiredCurrencies = new Map(), numO
     // Phase 2: Select UTXOs for native amount + fee
     const nativeOnly = decoded
         .filter((u) => !selected.includes(u))
-        .sort((a, b) => b.satoshis - a.satoshis);
+        .sort((a, b) => (b.satoshis > a.satoshis ? 1 : b.satoshis < a.satoshis ? -1 : 0));
     let changeOutputCount = 0;
     for (const [currency, needed] of remaining) {
-        if (currency !== systemId && needed < 0) {
+        if (currency !== systemId && needed < 0n) {
             changeOutputCount++;
         }
     }
     let fee = estimateFee(selected.length + 1, numOutputs + 1 + changeOutputCount, feePerKb, hasSmartOutputs);
-    while (remainingNative + fee > 0) {
+    while (remainingNative + fee > 0n) {
         const next = nativeOnly.shift();
         if (!next) {
-            const totalAvailable = decoded.reduce((sum, u) => sum + u.satoshis, 0);
+            const totalAvailable = decoded.reduce((sum, u) => sum + u.satoshis, 0n);
             throw new errors_js_1.InsufficientFundsError(requiredNative + fee, totalAvailable, 'VRSC');
         }
         selected.push(next);
@@ -119,18 +146,18 @@ function selectUtxos(utxos, requiredNative, requiredCurrencies = new Map(), numO
         fee = estimateFee(selected.length, numOutputs + 1 + changeOutputCount, feePerKb, hasSmartOutputs);
     }
     // Calculate change
-    const totalNativeIn = selected.reduce((sum, u) => sum + u.satoshis, 0);
+    const totalNativeIn = selected.reduce((sum, u) => sum + u.satoshis, 0n);
     const actualNativeChange = totalNativeIn - requiredNative - fee;
     const currencyChanges = new Map();
     for (const [currency, needed] of remaining) {
-        if (currency !== systemId && needed < 0) {
+        if (currency !== systemId && needed < 0n) {
             currencyChanges.set(currency, -needed);
         }
     }
-    const finalNativeChange = actualNativeChange > index_js_1.DUST_THRESHOLD ? actualNativeChange : 0;
+    const finalNativeChange = actualNativeChange > index_js_1.DUST_THRESHOLD ? actualNativeChange : 0n;
     const finalFee = actualNativeChange > index_js_1.DUST_THRESHOLD ? fee : fee + actualNativeChange;
     return {
-        selected: selected.map(({ currencyValues, ...utxo }) => utxo),
+        selected: selected.map(({ currencyValues: _currencyValues, ...utxo }) => utxo),
         nativeChange: finalNativeChange,
         currencyChanges,
         fee: finalFee,