fixed encoding for large values

Author: jackielu3

CHANGELOG.md

@@ -5,6 +5,7 @@ All notable changes to this project will be documented in this file. The format
 ## Table of Contents
 
 - [Unreleased](#unreleased)
+- [1.9.26 - 2025-12-09](#1926---2025-12-09)
 - [1.9.25 - 2025-12-09](#1925---2025-12-09)
 - [1.9.24 - 2025-12-09](#1924---2025-12-09)
 - [1.9.23 - 2025-12-08](#1923---2025-12-08)
@@ -198,6 +199,13 @@ All notable changes to this project will be documented in this file. The format
 
 ---
 
+## [1.9.26] - 2025-12-09
+
+### Fixed
+- Clarified and corrected byte-order helper behavior when converting numeric values to byte arrays.
+
+---
+
 ## [1.9.25] - 2025-12-09
 
 ### Added

docs/reference/primitives.md

@@ -5299,24 +5299,24 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 | | | |
 | --- | --- | --- |
-| [BI_EIGHT](#variable-bi_eight) | [biModSqrt](#variable-bimodsqrt) | [multiply](#variable-multiply) |
-| [BI_FOUR](#variable-bi_four) | [biModSub](#variable-bimodsub) | [rightShift](#variable-rightshift) |
-| [BI_ONE](#variable-bi_one) | [checkBit](#variable-checkbit) | [ripemd160](#variable-ripemd160) |
-| [BI_THREE](#variable-bi_three) | [encode](#variable-encode) | [scalarMultiplyWNAF](#variable-scalarmultiplywnaf) |
-| [BI_TWO](#variable-bi_two) | [exclusiveOR](#variable-exclusiveor) | [sha1](#variable-sha1) |
-| [BI_ZERO](#variable-bi_zero) | [fromBase58](#variable-frombase58) | [sha256](#variable-sha256) |
-| [GX_BIGINT](#variable-gx_bigint) | [fromBase58Check](#variable-frombase58check) | [sha256hmac](#variable-sha256hmac) |
-| [GY_BIGINT](#variable-gy_bigint) | [getBytes](#variable-getbytes) | [sha512](#variable-sha512) |
-| [MASK_256](#variable-mask_256) | [hash160](#variable-hash160) | [sha512hmac](#variable-sha512hmac) |
-| [N_BIGINT](#variable-n_bigint) | [hash256](#variable-hash256) | [sign](#variable-sign) |
-| [P_BIGINT](#variable-p_bigint) | [incrementLeastSignificantThirtyTwoBits](#variable-incrementleastsignificantthirtytwobits) | [toArray](#variable-toarray) |
-| [P_PLUS1_DIV4](#variable-p_plus1_div4) | [jpAdd](#variable-jpadd) | [toBase58](#variable-tobase58) |
-| [biMod](#variable-bimod) | [jpDouble](#variable-jpdouble) | [toBase58Check](#variable-tobase58check) |
-| [biModAdd](#variable-bimodadd) | [jpNeg](#variable-jpneg) | [toHex](#variable-tohex) |
-| [biModInv](#variable-bimodinv) | [minimallyEncode](#variable-minimallyencode) | [toUTF8](#variable-toutf8) |
-| [biModMul](#variable-bimodmul) | [modInvN](#variable-modinvn) | [verify](#variable-verify) |
-| [biModPow](#variable-bimodpow) | [modMulN](#variable-modmuln) | [zero2](#variable-zero2) |
-| [biModSqr](#variable-bimodsqr) | [modN](#variable-modn) |  |
+| [BI_EIGHT](#variable-bi_eight) | [biModSqrt](#variable-bimodsqrt) | [modN](#variable-modn) |
+| [BI_FOUR](#variable-bi_four) | [biModSub](#variable-bimodsub) | [multiply](#variable-multiply) |
+| [BI_ONE](#variable-bi_one) | [checkBit](#variable-checkbit) | [rightShift](#variable-rightshift) |
+| [BI_THREE](#variable-bi_three) | [encode](#variable-encode) | [ripemd160](#variable-ripemd160) |
+| [BI_TWO](#variable-bi_two) | [exclusiveOR](#variable-exclusiveor) | [scalarMultiplyWNAF](#variable-scalarmultiplywnaf) |
+| [BI_ZERO](#variable-bi_zero) | [fromBase58](#variable-frombase58) | [sha1](#variable-sha1) |
+| [GX_BIGINT](#variable-gx_bigint) | [fromBase58Check](#variable-frombase58check) | [sha256](#variable-sha256) |
+| [GY_BIGINT](#variable-gy_bigint) | [getBytes](#variable-getbytes) | [sha256hmac](#variable-sha256hmac) |
+| [MASK_256](#variable-mask_256) | [getBytes64](#variable-getbytes64) | [sha512](#variable-sha512) |
+| [N_BIGINT](#variable-n_bigint) | [hash160](#variable-hash160) | [sha512hmac](#variable-sha512hmac) |
+| [P_BIGINT](#variable-p_bigint) | [hash256](#variable-hash256) | [sign](#variable-sign) |
+| [P_PLUS1_DIV4](#variable-p_plus1_div4) | [incrementLeastSignificantThirtyTwoBits](#variable-incrementleastsignificantthirtytwobits) | [toArray](#variable-toarray) |
+| [biMod](#variable-bimod) | [jpAdd](#variable-jpadd) | [toBase58](#variable-tobase58) |
+| [biModAdd](#variable-bimodadd) | [jpDouble](#variable-jpdouble) | [toBase58Check](#variable-tobase58check) |
+| [biModInv](#variable-bimodinv) | [jpNeg](#variable-jpneg) | [toHex](#variable-tohex) |
+| [biModMul](#variable-bimodmul) | [minimallyEncode](#variable-minimallyencode) | [toUTF8](#variable-toutf8) |
+| [biModPow](#variable-bimodpow) | [modInvN](#variable-modinvn) | [verify](#variable-verify) |
+| [biModSqr](#variable-bimodsqr) | [modMulN](#variable-modmuln) | [zero2](#variable-zero2) |
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
@@ -5673,6 +5673,31 @@ getBytes = function (numericValue: number): number[] {
 
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
 
+---
+### Variable: getBytes64
+
+```ts
+getBytes64 = function (numericValue: number): number[] {
+    if (numericValue < 0 || numericValue > Number.MAX_SAFE_INTEGER) {
+        throw new Error("getBytes64: value out of range");
+    }
+    const hi = Math.floor(numericValue / 4294967296);
+    const lo = numericValue >>> 0;
+    return [
+        (hi >>> 24) & 255,
+        (hi >>> 16) & 255,
+        (hi >>> 8) & 255,
+        hi & 255,
+        (lo >>> 24) & 255,
+        (lo >>> 16) & 255,
+        (lo >>> 8) & 255,
+        lo & 255
+    ];
+}
+```
+
+Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Enums](#enums), [Variables](#variables)
+
 ---
 ### Variable: hash160
 

src/primitives/AESGCM.ts

@@ -202,6 +202,26 @@ export const getBytes = function (numericValue: number): number[] {
   ]
 }
 
+export const getBytes64 = function (numericValue: number): number[] {
+  if (numericValue < 0 || numericValue > Number.MAX_SAFE_INTEGER) {
+    throw new Error('getBytes64: value out of range')
+  }
+
+  const hi = Math.floor(numericValue / 0x100000000)
+  const lo = numericValue >>> 0
+
+  return [
+    (hi >>> 24) & 0xFF,
+    (hi >>> 16) & 0xFF,
+    (hi >>> 8) & 0xFF,
+    hi & 0xFF,
+    (lo >>> 24) & 0xFF,
+    (lo >>> 16) & 0xFF,
+    (lo >>> 8) & 0xFF,
+    lo & 0xFF
+  ]
+}
+
 const createZeroBlock = function (length: number): number[] {
   return new Array(length).fill(0)
 }
@@ -398,8 +418,10 @@ export function AESGCM (
 
     preCounterBlock = preCounterBlock.concat(createZeroBlock(8))
 
-    preCounterBlock = ghash(preCounterBlock.concat(createZeroBlock(4))
-      .concat(getBytes(initializationVector.length * 8)), hashSubKey)
+    preCounterBlock = ghash(
+      preCounterBlock.concat(getBytes64(initializationVector.length * 8)),
+      hashSubKey
+    )
   }
 
   const cipherText = gctr(plainText, incrementLeastSignificantThirtyTwoBits(preCounterBlock), key)
@@ -413,9 +435,9 @@ export function AESGCM (
     plainTag = plainTag.concat(createZeroBlock(16 - (cipherText.length % 16)))
   }
 
-  plainTag = plainTag.concat(createZeroBlock(4))
-    .concat(getBytes(0))
-    .concat(createZeroBlock(4)).concat(getBytes(cipherText.length * 8))
+  plainTag = plainTag
+    .concat(getBytes64(0))
+    .concat(getBytes64(cipherText.length * 8))
 
   return {
     result: cipherText,
@@ -457,7 +479,10 @@ export function AESGCMDecrypt (
 
     preCounterBlock = preCounterBlock.concat(createZeroBlock(8))
 
-    preCounterBlock = ghash(preCounterBlock.concat(createZeroBlock(4)).concat(getBytes(initializationVector.length * 8)), hashSubKey)
+    preCounterBlock = ghash(
+      preCounterBlock.concat(getBytes64(initializationVector.length * 8)),
+      hashSubKey
+    )
   }
 
   // Decrypt to obtain the plain text
@@ -472,10 +497,9 @@ export function AESGCMDecrypt (
     compareTag = compareTag.concat(createZeroBlock(16 - (cipherText.length % 16)))
   }
 
-  compareTag = compareTag.concat(createZeroBlock(4))
-    .concat(getBytes(0))
-    .concat(createZeroBlock(4))
-    .concat(getBytes(cipherText.length * 8))
+  compareTag = compareTag
+    .concat(getBytes64(0))
+    .concat(getBytes64(cipherText.length * 8))
 
   // Generate the authentication tag
   const calculatedTag = gctr(ghash(compareTag, hashSubKey), preCounterBlock, key)