@gsknnft/bigint-buffer 1.4.4 → 1.4.6

package/README.md

@@ -1,90 +1,107 @@
-![CI](https://github.com/gsknknft/bigint-buffer/actions/workflows/ci.yaml/badge.svg)
-![Release](https://github.com/gsknknft/bigint-buffer/actions/workflows/release.yaml/badge.svg)
-
-# @gsknnft/bigint-buffer
-
-Secure BigInt ⇆ Buffer conversion with native bindings, browser fallbacks, and the `bigint-conversion` helper APIs built in. This is the actively maintained fork of the original `bigint-buffer`.
-
-> **Upgrade notice:** `1.4.4` is the CI-verified release (Node 20–24) and matches the 1.4.3 code. `1.4.3` was pre-green; move to 1.4.4 for a fully verified pipeline.
-
-[![NPM Version](https://img.shields.io/npm/v/@gsknnft/bigint-buffer.svg?style=flat-square)](https://www.npmjs.com/package/@gsknnft/bigint-buffer)
-[![Node Version](https://img.shields.io/node/v/@gsknnft/bigint-buffer.svg?style=flat-square)](https://nodejs.org)
-
----
-
-## Why This Package
-
-- Native N-API binding with pure-JS fallback for browsers and constrained environments.
-- Conversion helpers from `bigint-conversion` in-core (no extra deps).
-- ESM and CJS exports plus a UMD/browser bundle.
-- Actively maintained; legacy `bigint-buffer` is deprecated and flagged by audits.
-
----
-
-## Install
-```bash
-npm install @gsknnft/bigint-buffer
-# or pnpm/yarn if preferred
-```
-
----
-
-## Quick Start
-```ts
-import {
-  toBigIntBE, toBigIntLE, toBufferBE, toBufferLE,
-  bigintToBuf, bufToBigint, bigintToHex, hexToBigint,
-  bigintToText, textToBigint, bigintToBase64, base64ToBigint,
-} from "@gsknnft/bigint-buffer";
-
-toBigIntBE(Buffer.from("deadbeef", "hex")); // 3735928559n
-toBufferLE(0xdeadbeefn, 6);                 // <Buffer ef be ad de 00 00>
-bigintToHex(123456789n);                    // "075bcd15"
-textToBigint("Hello");                      // 0x48656c6c6f
-bigintToBase64(123456789n);                 // "B1vNFQ=="
-```
-
-### Conversion Utilities
-```ts
-import { conversionUtils } from "@gsknnft/bigint-buffer";
-
-const arrBuf = conversionUtils.bigintToBuf(123456789n, true); // ArrayBuffer
-const hex = conversionUtils.bigintToHex(123456789n, true);    // '0x...' format
-const text = conversionUtils.bigintToText(123456789n);
-```
-
----
-
-## Runtime
-- Native binary: `build/Release/bigint_buffer.node` (loads automatically when available).
-- Fallback: pure JS bundle for browser and non-native installs.
-- Check which path loaded:
-  ```ts
-  import { isNative } from "@gsknnft/bigint-buffer";
-  console.log(isNative); // true when native binding is active
-  ```
-
----
-
-## Commands
-```bash
-npm run build           # bundle + declarations + type check
-npm test                # vitest with coverage
-npm run test:node       # mocha against built JS (after build/compile)
-npm run rebuild:native  # rebuild the N-API binding
-```
-
----
-
-## API Surface (high level)
-- Core: `toBigIntBE/LE`, `toBufferBE/LE`, `validateBigIntBuffer`, `isNative`
-- Conversion: `bigintToBuf`, `bufToBigint`, `bigintToHex`, `hexToBigint`, `bigintToText`, `textToBigint`, `bigintToBase64`, `base64ToBigint`, `bufToHex`, `hexToBuf`, `textToBuf`, `bufToText`, `parseHex`
-
-All helpers are endian-safe and validated across Node and browser builds.
-
----
- 
-## Support
-- Version: 1.4.4 (CI-verified; 1.4.3 was pre-green)
-- Node: 20+ (tested through 24 LTS under CI)
-- Issues: https://github.com/gsknnft/bigint-buffer/issues
+![CI](https://github.com/gsknknft/bigint-buffer/actions/workflows/ci.yaml/badge.svg)
+![Release](https://github.com/gsknknft/bigint-buffer/actions/workflows/release.yaml/badge.svg)
+
+# @gsknnft/bigint-buffer
+
+Secure BigInt ⇆ Buffer conversion with native bindings, browser fallbacks, and the `bigint-conversion` helper APIs built in. This is the actively maintained fork of the original `bigint-buffer`.
+
+**Upgrade notice:** The current 1.4.x line ships chunked, allocation-free BE/LE converters (Buffer.read/writeBigUInt64* when available) that are fuzzed across empty, tiny, and huge buffers, alongside FixedPoint utilities and packaged native bindings. CI-verified for Node 20–24. Upgrade for the fastest conversions and consistent behaviour across environments.
+
+[![NPM Version](https://img.shields.io/npm/v/@gsknnft/bigint-buffer.svg?style=flat-square)](https://www.npmjs.com/package/@gsknnft/bigint-buffer)
+[![Node Version](https://img.shields.io/node/v/@gsknnft/bigint-buffer.svg?style=flat-square)](https://nodejs.org)
+
+---
+
+## Why This Package
+
+- Native N-API binding with pure-JS fallback for browsers and constrained environments.
+- Conversion helpers from `bigint-conversion` in-core (no extra deps).
+- ESM and CJS exports plus a UMD/browser bundle.
+- Actively maintained; legacy `bigint-buffer` is deprecated and flagged by audits.
+
+---
+
+## Install
+```bash
+npm install @gsknnft/bigint-buffer
+# or pnpm/yarn if preferred
+```
+
+---
+
+## Quick Start
+```ts
+import {
+  toBigIntBE, toBigIntLE, toBufferBE, toBufferLE,
+  bigintToBuf, bufToBigint, bigintToHex, hexToBigint,
+  bigintToText, textToBigint, bigintToBase64, base64ToBigint,
+  // New in 1.4.5
+  toFixedPoint, fromFixedPoint, addFixedPoint, subtractFixedPoint,
+  averageFixedPoint, compareFixedPoint, type FixedPoint,
+} from "@gsknnft/bigint-buffer";
+
+toBigIntBE(Buffer.from("deadbeef", "hex")); // 3735928559n
+toBufferLE(0xdeadbeefn, 6);                 // <Buffer ef be ad de 00 00>
+bigintToHex(123456789n);                    // "075bcd15"
+textToBigint("Hello");                      // 0x48656c6c6f
+bigintToBase64(123456789n);                 // "B1vNFQ=="
+
+// FixedPoint usage
+const fp = toFixedPoint(123456789n, 18);    // Convert bigint to FixedPoint
+const sum = addFixedPoint(fp, fp);          // Add two FixedPoints
+const avg = averageFixedPoint([fp, fp]);    // Average FixedPoints
+```
+
+### Performance
+- BE/LE conversions now stream bytes directly from buffers (64-bit chunks via Buffer.read/writeBigUInt64* when available) with no intermediate hex copies.
+- JS fallback matches the native binding semantics and is exercised against empty, tiny, and very large inputs in CI.
+- Native bindings still load automatically when present; the optimized fallback keeps browser and non-native runtimes fast.
+- Browser bundlers must polyfill Node built-ins: add a node polyfill plugin (e.g. `rollup-plugin-polyfill-node`) or explicit aliases for `buffer`, `path`, and `fs` so the fallback loader can resolve.
+
+### Pushing Performance Further
+- For very large buffers, consider enabling the native binding (included in npm tarball) or adding SIMD/native glue in your host app if you need throughput beyond JS.
+
+### Conversion Utilities
+```ts
+import { conversionUtils } from "@gsknnft/bigint-buffer";
+
+const arrBuf = conversionUtils.bigintToBuf(123456789n, true); // ArrayBuffer
+const hex = conversionUtils.bigintToHex(123456789n, true);    // '0x...' format
+const text = conversionUtils.bigintToText(123456789n);
+```
+
+---
+
+## Runtime
+- Native binary: `build/Release/bigint_buffer.node` (included in npm package; loads automatically when available).
+- Fallback: pure JS bundle for browser and non-native installs (now improved in 1.4.5).
+- Check which path loaded:
+  ```ts
+  import { isNative } from "@gsknnft/bigint-buffer";
+  console.log(isNative); // true when native binding is active
+  ```
+
+---
+
+## Commands
+```bash
+npm run build           # bundle + declarations + type check
+npm test                # vitest with coverage
+npm run test:node       # mocha against built JS (after build/compile)
+npm run rebuild:native  # rebuild the N-API binding
+```
+
+---
+
+## API Surface (high level)
+- Core: `toBigIntBE/LE`, `toBufferBE/LE`, `validateBigIntBuffer`, `isNative`
+- Conversion: `bigintToBuf`, `bufToBigint`, `bigintToHex`, `hexToBigint`, `bigintToText`, `textToBigint`, `bigintToBase64`, `base64ToBigint`, `bufToHex`, `hexToBuf`, `textToBuf`, `bufToText`, `parseHex`
+
+All helpers are endian-safe and validated across Node and browser builds.
+
+---
+ 
+## Support
+- Version: 1.4.5 (FixedPoint, native bindings out-of-the-box, improved JS fallback)
+- Node: 20+ (tested through 24 LTS under CI)
+- Issues: https://github.com/gsknnft/bigint-buffer/issues

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("buffer"),c=require("path"),U=require("fs");let B=!1,f,l;const s=typeof globalThis<"u"&&typeof globalThis.document<"u",x=[c.resolve(__dirname,".."),c.resolve(__dirname,"../../.."),c.resolve(__dirname,"../../../../")],N=()=>{for(const e of x){const t=c.join(e,"build","Release","bigint_buffer.node");if(U.existsSync(t))return e}return x[0]};function L(){try{const e=require("bindings"),t=N();return e({bindings:"bigint_buffer",module_root:t})}catch(e){l=e;return}}s||(f=L(),B=f!==void 0,!B&&l!==void 0&&process.env?.BIGINT_BUFFER_SILENT_NATIVE_FAIL!=="1"&&console.warn("bigint-buffer: Failed to load native bindings; using pure JS fallback. Run npm run rebuild to restore native.",l));f===void 0&&(f={toBigInt:(e,t=!0)=>{const n=o.Buffer.from(e);t||n.reverse();const r=n.toString("hex");return r.length===0?0n:BigInt(`0x${r}`)},fromBigInt:(e,t,n=!0)=>{const r=e.toString(16),i=t.length,g=r.padStart(i*2,"0").slice(0,i*2),h=o.Buffer.from(g,"hex");return n||h.reverse(),h.copy(t),t}});function v(e){if(s||f===void 0){const t=o.Buffer.from(e);t.reverse();const n=t.toString("hex");return n.length===0?BigInt(0):BigInt(`0x${n}`)}return f.toBigInt(e,!1)}function O(){try{return v(o.Buffer.from([1,0]))===BigInt(1)}catch{return!1}}function H(e){if(s||f===void 0){const t=e.toString("hex");return t.length===0?BigInt(0):BigInt(`0x${t}`)}return f.toBigInt(e,!0)}function M(e,t){if(s||f===void 0){const n=e.toString(16),r=o.Buffer.from(n.padStart(t*2,"0").slice(0,t*2),"hex");return r.reverse(),r}return f.fromBigInt(e,o.Buffer.allocUnsafe(t),!1)}function F(e,t){if(s||f===void 0){const n=e.toString(16);return o.Buffer.from(n.padStart(t*2,"0").slice(0,t*2),"hex")}return f.fromBigInt(e,o.Buffer.allocUnsafe(t),!0)}function a(e,t=!1,n){const r=e.match(/^(0x)?([\da-fA-F]+)$/);if(r==null)throw new RangeError("input must be a hexadecimal string, e.g. '0x124fe3a' or '0214f1b2'");let i=r[2];if(n!==void 0){if(n<i.length/2)throw new RangeError(`expected byte length ${n} < input hex byte length ${Math.ceil(i.length/2)}`);i=i.padStart(n*2,"0")}return t?"0x"+i:i}function T(e,t=!1){if(e<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return b(I(e),t)}function p(e){let t=8n;ArrayBuffer.isView(e)?t=BigInt(e.BYTES_PER_ELEMENT*8):e=new Uint8Array(e);let n=0n;for(const r of e.values()){const i=BigInt(r);n=(n<<t)+i}return n}function I(e,t=!1,n){if(e<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return a(e.toString(16),t,n)}function w(e){return BigInt(a(e,!0))}function q(e){if(e<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return m(b(e.toString(16)))}function V(e){return w(E(y(e)))}function d(e){if(o.Buffer.isBuffer(e))return e;if(ArrayBuffer.isView(e))return o.Buffer.from(e.buffer,e.byteOffset,e.byteLength);if(e instanceof ArrayBuffer)return o.Buffer.from(new Uint8Array(e));throw new TypeError("Unsupported input type for Buffer.from")}function m(e){const t=d(e);return s?new TextDecoder().decode(new Uint8Array(t)):o.Buffer.from(t).toString()}function y(e,t=!1){return!s&&!t?o.Buffer.from(new TextEncoder().encode(e).buffer):new TextEncoder().encode(e).buffer}function E(e,t=!1,n){if(s){let r="";const i="0123456789abcdef";return ArrayBuffer.isView(e)?e=new Uint8Array(e.buffer.slice(e.byteOffset,e.byteOffset+e.byteLength)):e=new Uint8Array(e),e.forEach(g=>{r+=i[g>>4]+i[g&15]}),a(r,t,n)}else{const r=d(e);return ArrayBuffer.isView(r)&&(e=new Uint8Array(r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength))),a(o.Buffer.from(d(e)).toString("hex"),t,n)}}function b(e,t=!1){let n=a(e);if(n=a(e,!1,Math.ceil(n.length/2)),s)return Uint8Array.from(n.match(/[\da-fA-F]{2}/g).map(r=>+("0x"+r))).buffer;{const r=o.Buffer.from(n,"hex");return t?r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength):r}}function j(e,t=!1,n=!0){if(e<0n)throw new RangeError("negative bigint");const r=T(e);let i=o.Buffer.isBuffer(r)?r.toString("base64"):o.Buffer.from(r).toString("base64");return t&&(i=i.replace(/\+/g,"-").replace(/\//g,"_")),n||(i=i.replace(/=+$/,"")),i}function z(e){if(!e||e.trim()==="")return 0n;const t=e.trim();if(!/^[A-Za-z0-9+/=_-]*$/.test(t))throw new RangeError("invalid base64");let n=t.replace(/-/g,"+").replace(/_/g,"/");for(;n.length%4!==0;)n+="=";const r=o.Buffer.from(n,"base64");return p(r)}const P=Object.freeze(Object.defineProperty({__proto__:null,base64ToBigint:z,bigintToBase64:j,bigintToBuf:T,bigintToHex:I,bigintToText:q,bufToBigint:p,bufToHex:E,bufToText:m,hexToBigint:w,hexToBuf:b,get isNative(){return B},parseHex:a,textToBigint:V,textToBuf:y,toBigIntBE:H,toBigIntLE:v,toBufferBE:F,toBufferLE:M,validateBigIntBuffer:O},Symbol.toStringTag,{value:"Module"}));let u;exports.isNative=!1;if(typeof window>"u")try{u=require("bindings")("bigint_buffer"),exports.isNative=u!==void 0}catch(e){console.warn("bigint: Failed to load bindings, pure JS will be used (try npm run rebuild?)",e)}function S(e){if(typeof window<"u"||u===void 0){const t=Buffer.from(e);t.reverse();const n=t.toString("hex");return n.length===0?BigInt(0):BigInt(`0x${n}`)}return u.toBigInt(e,!1)}function J(){try{return S(Buffer.from([1,0]))===BigInt(1)}catch{return!1}}function $(e){if(typeof window<"u"||u===void 0){const t=e.toString("hex");return t.length===0?BigInt(0):BigInt(`0x${t}`)}return u.toBigInt(e,!0)}function W(e,t){if(typeof window<"u"||u===void 0){const n=e.toString(16),r=Buffer.from(n.padStart(t*2,"0").slice(0,t*2),"hex");return r.reverse(),r}return u.fromBigInt(e,Buffer.allocUnsafe(t),!1)}function _(e,t){if(typeof window<"u"||u===void 0){const n=e.toString(16);return Buffer.from(n.padStart(t*2,"0").slice(0,t*2),"hex")}return u.fromBigInt(e,Buffer.allocUnsafe(t),!0)}function A(e){if(e<BigInt(0))throw new Error("bigintToBuf: negative bigint values are not supported");if(e===BigInt(0))return Buffer.from([0]);const t=e.toString(16),n=Math.ceil(t.length/2);return _(e,n)}function R(e){return $(e)}function Z(e){if(e<BigInt(0))throw new Error("bigintToHex: negative bigint values are not supported");const t=e.toString(16);return t.length%2===0?t:"0"+t}function k(e){const t=e.startsWith("0x")?e.slice(2):e;return t.length===0?BigInt(0):BigInt(`0x${t}`)}function D(e){return e.toString(10)}function G(e){if(!e?.trim())throw new Error("textToBigint: input string cannot be empty");try{return BigInt(e)}catch(t){throw new Error(`textToBigint: invalid decimal string "${e}" ${t instanceof Error?t.message:String(t)}`)}}function Y(e){if(e<BigInt(0))throw new Error("bigintToBase64: negative bigint values are not supported");return A(e).toString("base64")}function C(e){if(!e?.trim())throw new Error("base64ToBigint: input string cannot be empty");const t=e.trim();if(!/^[A-Za-z0-9+/]+=*$/.test(t))throw new Error("base64ToBigint: invalid base64 string format");const n=Buffer.from(t,"base64");return R(n)}exports.base64ToBigint=C;exports.bigintToBase64=Y;exports.bigintToBuf=A;exports.bigintToHex=Z;exports.bigintToText=D;exports.bufToBigint=R;exports.conversionUtils=P;exports.hexToBigint=k;exports.textToBigint=G;exports.toBigIntBE=$;exports.toBigIntLE=S;exports.toBufferBE=_;exports.toBufferLE=W;exports.validateBigIntBuffer=J;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("buffer"),l=require("path"),H=require("fs");let w=!1,B,h;const u=typeof globalThis<"u"&&typeof globalThis.document<"u",y=[l.resolve(__dirname,"../"),l.resolve(__dirname,"../.."),l.resolve(__dirname,"../../../")],_=()=>{for(const t of y){const e=l.join(t,"build","Release","bigint_buffer.node");if(H.existsSync(e))return t}return y[0]};function W(){try{const t=require("bindings"),e=_();return t({bindings:"bigint_buffer",module_root:e})}catch(t){h=t;return}}u||(B=W(),w=B!==void 0,!w&&h!==void 0&&process.env?.BIGINT_BUFFER_SILENT_NATIVE_FAIL!=="1"&&console.warn("bigint-buffer: Failed to load native bindings; using pure JS fallback. Run npm run rebuild to restore native.",h));B===void 0&&(B={toBigInt:(t,e=!0)=>{const n=v.Buffer.from(t);e||n.reverse();const r=n.toString("hex");return r.length===0?0n:BigInt(`0x${r}`)},fromBigInt:(t,e,n=!0)=>{const r=t.toString(16),i=e.length,o=r.padStart(i*2,"0").slice(0,i*2),c=v.Buffer.from(o,"hex");return n||c.reverse(),c.copy(e),e}});const x=9,d="0x0",q=t=>t.startsWith("0x")||t.startsWith("0X")?t:`0x${t}`,b=t=>{if(t===0n)return d;const e=t<0n,n=e?-t:t,r=E(n);return`${e?"-":""}0x${r}`},s=t=>{if(!t)return 0n;const e=t.trim();if(e.length===0)return 0n;const n=e.startsWith("-"),r=n?e.slice(1):e,i=q(r),o=T(i);return n?-o:o};function j(t,e=x){if(!Number.isFinite(t))return d;const n=Math.pow(10,e),r=BigInt(Math.round(t*n));return b(r)}function k(t,e=x){const n=s(t);if(n===0n)return 0;const r=Math.pow(10,e);return Number(n)/r}function z(t,e){return b(s(t)+s(e))}function D(t,e){return b(s(t)-s(e))}function C(t){if(t.length===0)return d;const e=t.reduce((n,r)=>n+s(r),0n);return b(e/BigInt(t.length))}function J(t,e){const n=s(t)-s(e);return n===0n?0:n>0n?1:-1}function X(t){return s(t)}let f,I;function Z(){try{const t=require("bindings"),e=_();return t({bindings:"bigint_buffer",module_root:e})}catch(t){I=t;return}}let S=!1;u||(f=Z(),S=f!==void 0,!S&&I!==void 0&&process.env?.BIGINT_BUFFER_SILENT_NATIVE_FAIL!=="1"&&console.warn("bigint-buffer: Failed to load native bindings; using pure JS fallback. Run npm run rebuild to restore native.",I));f===void 0&&(f={toBigInt:(t,e=!0)=>{const n=Buffer.from(t);e||n.reverse();const r=n.toString("hex");return r.length===0?0n:BigInt(`0x${r}`)},fromBigInt:(t,e,n=!0)=>{const r=t.toString(16),i=e.length,o=r.padStart(i*2,"0").slice(0,i*2),c=Buffer.from(o,"hex");return n||c.reverse(),c.copy(e),e}});function $(t){if(u||f===void 0){const e=Buffer.from(t);e.reverse();const n=e.toString("hex");return n.length===0?BigInt(0):BigInt(`0x${n}`)}return f.toBigInt(t,!1)}function G(){try{return $(Buffer.from([1,0]))===BigInt(1)}catch{return!1}}function Y(t){if(u||f===void 0){const e=t.toString("hex");return e.length===0?BigInt(0):BigInt(`0x${e}`)}return f.toBigInt(t,!0)}function K(t,e){if(u||f===void 0){const n=t.toString(16),r=Buffer.from(n.padStart(e*2,"0").slice(0,e*2),"hex");return r.reverse(),r}return f.fromBigInt(t,Buffer.allocUnsafe(e),!1)}function Q(t,e){if(u||f===void 0){const n=t.toString(16);return Buffer.from(n.padStart(e*2,"0").slice(0,e*2),"hex")}return f.fromBigInt(t,Buffer.allocUnsafe(e),!0)}function a(t,e=!1,n){const r=t.match(/^(0x)?([\da-fA-F]+)$/);if(r==null)throw new RangeError("input must be a hexadecimal string, e.g. '0x124fe3a' or '0214f1b2'");let i=r[2];if(n!==void 0){if(n<i.length/2)throw new RangeError(`expected byte length ${n} < input hex byte length ${Math.ceil(i.length/2)}`);i=i.padStart(n*2,"0")}return e?"0x"+i:i}function L(t,e=!1){if(t<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return p(E(t),e)}function N(t){let e=8n;ArrayBuffer.isView(t)?e=BigInt(t.BYTES_PER_ELEMENT*8):t=new Uint8Array(t);let n=0n;for(const r of t.values()){const i=BigInt(r);n=(n<<e)+i}return n}function E(t,e=!1,n){if(t<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return a(t.toString(16),e,n)}function T(t){return BigInt(a(t,!0))}function tt(t){if(t<0)throw RangeError("a should be a non-negative integer. Negative values are not supported");return R(p(t.toString(16)))}function et(t){return T(A(U(t)))}function m(t){if(Buffer.isBuffer(t))return t;if(ArrayBuffer.isView(t))return Buffer.from(t.buffer,t.byteOffset,t.byteLength);if(t instanceof ArrayBuffer)return Buffer.from(new Uint8Array(t));throw new TypeError("Unsupported input type for Buffer.from")}function R(t){const e=m(t);return u?new TextDecoder().decode(new Uint8Array(e)):Buffer.from(e).toString()}function U(t,e=!1){return!u&&!e?Buffer.from(new TextEncoder().encode(t).buffer):new TextEncoder().encode(t).buffer}function A(t,e=!1,n){if(u){let r="";const i="0123456789abcdef";return ArrayBuffer.isView(t)?t=new Uint8Array(t.buffer.slice(t.byteOffset,t.byteOffset+t.byteLength)):t=new Uint8Array(t),t.forEach(o=>{r+=i[o>>4]+i[o&15]}),a(r,e,n)}else{const r=m(t);return ArrayBuffer.isView(r)&&(t=new Uint8Array(r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength))),a(Buffer.from(m(t)).toString("hex"),e,n)}}function p(t,e=!1){let n=a(t);if(n=a(t,!1,Math.ceil(n.length/2)),u)return Uint8Array.from(n.match(/[\da-fA-F]{2}/g).map(r=>+("0x"+r))).buffer;{const r=Buffer.from(n,"hex");return e?r.buffer.slice(r.byteOffset,r.byteOffset+r.byteLength):r}}function nt(t,e=!1,n=!0){if(t<0n)throw new RangeError("negative bigint");const r=L(t);let i=Buffer.isBuffer(r)?r.toString("base64"):Buffer.from(r).toString("base64");return e&&(i=i.replace(/\+/g,"-").replace(/\//g,"_")),n||(i=i.replace(/=+$/,"")),i}function rt(t){if(!t||t.trim()==="")return 0n;const e=t.trim();if(!/^[A-Za-z0-9+/=_-]*$/.test(e))throw new RangeError("invalid base64");let n=e.replace(/-/g,"+").replace(/_/g,"/");for(;n.length%4!==0;)n+="=";const r=Buffer.from(n,"base64");return N(r)}const it=Object.freeze(Object.defineProperty({__proto__:null,FIXED_POINT_DECIMALS:x,ZERO_FIXED_POINT:d,addFixedPoint:z,averageFixedPoint:C,base64ToBigint:rt,bigintToBase64:nt,bigintToBuf:L,bigintToHex:E,bigintToText:tt,bufToBigint:N,bufToHex:A,bufToText:R,compareFixedPoint:J,fixedPointToBigInt:X,fromFixedPoint:k,hexToBigint:T,hexToBuf:p,parseHex:a,subtractFixedPoint:D,textToBigint:et,textToBuf:U,toBigIntBE:Y,toBigIntLE:$,toBigIntValue:s,toBufferBE:Q,toBufferLE:K,toFixedPoint:j,validateBigIntBuffer:G},Symbol.toStringTag,{value:"Module"})),ot=typeof Buffer.prototype.readBigUInt64LE=="function",ft=typeof Buffer.prototype.readBigUInt64BE=="function",st=typeof Buffer.prototype.writeBigUInt64LE=="function",ut=typeof Buffer.prototype.writeBigUInt64BE=="function",ct=ot?(t,e)=>t.readBigUInt64LE(e):(t,e)=>{let n=0n;for(let r=7;r>=0;r--)n=(n<<8n)+BigInt(t[e+r]);return n},at=ft?(t,e)=>t.readBigUInt64BE(e):(t,e)=>{let n=0n;for(let r=0;r<8;r++)n=(n<<8n)+BigInt(t[e+r]);return n},gt=st?(t,e,n)=>{t.writeBigUInt64LE(n,e)}:(t,e,n)=>{let r=n;for(let i=0;i<8;i++)t[e+i]=Number(r&0xffn),r>>=8n},lt=ut?(t,e,n)=>{t.writeBigUInt64BE(n,e)}:(t,e,n)=>{let r=n;for(let i=7;i>=0;i--)t[e+i]=Number(r&0xffn),r>>=8n},Bt=t=>{let e=0n,n=1n;const r=t.length,i=r&7;for(let o=0;o<i;o++)e+=BigInt(t[o])*n,n<<=8n;for(let o=i;o<r;o+=8){const c=ct(t,o);e+=c*n,n<<=64n}return e},dt=t=>{const e=t.length;if(e===0)return 0n;let n=0n;const r=e&7;let i=0;if(r!==0)for(;i<r;i++)n=(n<<8n)+BigInt(t[i]);for(;i<e;i+=8){const o=at(t,i);n=(n<<64n)+o}return n},bt=(t,e)=>{const n=e.length;let r=t,i=0;const o=n-n%8;for(;i<o;i+=8)gt(e,i,r&0xffffffffffffffffn),r>>=64n;for(;i<n;i++)e[i]=Number(r&0xffn),r>>=8n;return e},ht=(t,e)=>{const n=e.length;let r=t,i=n;const o=n&-8;for(;i>o;)i--,e[i]=Number(r&0xffn),r>>=8n;for(;i>0;i-=8){const c=r&0xffffffffffffffffn;lt(e,i-8,c),r>>=64n}return e},It=t=>{if(t===0n)return 1;let e=t,n=0;for(;e>0n;)n++,e>>=8n;return n},mt={toBigInt:(t,e=!0)=>e?dt(t):Bt(t),fromBigInt:(t,e,n=!0)=>n?ht(t,e):bt(t,e)};let g=mt;exports.isNative=!1;if(typeof window>"u")try{const t=require("bindings")("bigint_buffer");t!==void 0&&(g=t,exports.isNative=!0)}catch(t){console.warn("bigint: Failed to load bindings, pure JS will be used (try npm run rebuild?)",t)}function F(t){return g.toBigInt(t,!1)}function xt(){try{return F(Buffer.from([1,0]))===BigInt(1)}catch{return!1}}function O(t){return g.toBigInt(t,!0)}function Et(t,e){if(e<0)throw new RangeError("toBufferLE width must be non-negative");const n=e===0?Buffer.alloc(0):Buffer.allocUnsafe(e);return g.fromBigInt(t,n,!1)}function P(t,e){if(e<0)throw new RangeError("toBufferBE width must be non-negative");const n=e===0?Buffer.alloc(0):Buffer.allocUnsafe(e);return g.fromBigInt(t,n,!0)}function M(t){if(t<BigInt(0))throw new Error("bigintToBuf: negative bigint values are not supported");const e=It(t);return P(t,e)}function V(t){return O(t)}function Tt(t){if(t<BigInt(0))throw new Error("bigintToHex: negative bigint values are not supported");const e=t.toString(16);return e.length%2===0?e:"0"+e}function pt(t){const e=t.startsWith("0x")?t.slice(2):t;return e.length===0?BigInt(0):BigInt(`0x${e}`)}function vt(t){return t.toString(10)}function wt(t){if(!t?.trim())throw new Error("textToBigint: input string cannot be empty");try{return BigInt(t)}catch(e){throw new Error(`textToBigint: invalid decimal string "${t}" ${e instanceof Error?e.message:String(e)}`)}}function yt(t){if(t<BigInt(0))throw new Error("bigintToBase64: negative bigint values are not supported");return M(t).toString("base64")}function St(t){if(!t?.trim())throw new Error("base64ToBigint: input string cannot be empty");const e=t.trim();if(!/^[A-Za-z0-9+/]+=*$/.test(e))throw new Error("base64ToBigint: invalid base64 string format");const n=Buffer.from(e,"base64");return V(n)}exports.base64ToBigint=St;exports.bigintToBase64=yt;exports.bigintToBuf=M;exports.bigintToHex=Tt;exports.bigintToText=vt;exports.bufToBigint=V;exports.conversionUtils=it;exports.hexToBigint=pt;exports.textToBigint=wt;exports.toBigIntBE=O;exports.toBigIntLE=F;exports.toBufferBE=P;exports.toBufferLE=Et;exports.validateBigIntBuffer=xt;