@layerzerolabs/common-encoding-utils 0.2.64 → 0.2.66

package/dist/byte-codec.js

@@ -0,0 +1,3 @@
+export { ByteCodec } from './2BTCXNB3.js';
+//# sourceMappingURL=byte-codec.js.map
+//# sourceMappingURL=byte-codec.js.map

package/dist/byte-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"byte-codec.js"}

package/dist/index.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var DF2CBFKF_cjs = require('./DF2CBFKF.cjs');
 
 // src/index.ts
 var base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;
@@ -10,11 +9,11 @@ var hexStringRegex = /^(0x)?[0-9A-Fa-f]*$/;
 function isBase58(address) {
   return base58regex.test(address);
 }
-__name(isBase58, "isBase58");
+DF2CBFKF_cjs.__name(isBase58, "isBase58");
 function isBase64(address) {
   return base64regex.test(address);
 }
-__name(isBase64, "isBase64");
+DF2CBFKF_cjs.__name(isBase64, "isBase64");
 function isHexString(value, length) {
   if (typeof value !== "string" || !value.match(hexStringRegex)) {
     return false;
@@ -24,7 +23,7 @@ function isHexString(value, length) {
   }
   return true;
 }
-__name(isHexString, "isHexString");
+DF2CBFKF_cjs.__name(isHexString, "isHexString");
 function hexZeroPad(value, length) {
   if (!isHexString(value)) {
     throw new Error(`invalid hex string: ${value}`);
@@ -34,25 +33,25 @@ function hexZeroPad(value, length) {
   }
   return `0x${trim0x(value).padStart(2 * length, "0")}`;
 }
-__name(hexZeroPad, "hexZeroPad");
+DF2CBFKF_cjs.__name(hexZeroPad, "hexZeroPad");
 function trim0x(str) {
   return str.replace(/^0x/, "");
 }
-__name(trim0x, "trim0x");
+DF2CBFKF_cjs.__name(trim0x, "trim0x");
 function ensure0xPrefixed(str) {
   return `0x${trim0x(str)}`;
 }
-__name(ensure0xPrefixed, "ensure0xPrefixed");
+DF2CBFKF_cjs.__name(ensure0xPrefixed, "ensure0xPrefixed");
 function trimLeadingZeros(hexString) {
   let withoutPrefix = trim0x(hexString);
   withoutPrefix = withoutPrefix.replace(/^0+/, "");
   return ensure0xPrefixed(withoutPrefix);
 }
-__name(trimLeadingZeros, "trimLeadingZeros");
+DF2CBFKF_cjs.__name(trimLeadingZeros, "trimLeadingZeros");
 function hexToUint8Array(hexString) {
   return Uint8Array.from(Buffer.from(trim0x(hexString), "hex"));
 }
-__name(hexToUint8Array, "hexToUint8Array");
+DF2CBFKF_cjs.__name(hexToUint8Array, "hexToUint8Array");
 function hexToAscii(hex) {
   if (!isHexString(hex)) {
     throw new Error(`Invalid hex string ${hex}`);
@@ -69,31 +68,35 @@ function hexToAscii(hex) {
   }
   return str;
 }
-__name(hexToAscii, "hexToAscii");
+DF2CBFKF_cjs.__name(hexToAscii, "hexToAscii");
 function stringToUint8Array(str) {
   const value = str.replace(/^0x/i, "");
   const len = value.length + 1 - (value.length + 1) % 2;
   return Uint8Array.from(Buffer.from(value.padStart(len, "0"), "hex"));
 }
-__name(stringToUint8Array, "stringToUint8Array");
+DF2CBFKF_cjs.__name(stringToUint8Array, "stringToUint8Array");
 function hexToBytes(hex) {
   const value = hex.replace(/^0x/i, "");
   const len = value.length + 1 - (value.length + 1) % 2;
   return Uint8Array.from(Buffer.from(value.padStart(len, "0"), "hex"));
 }
-__name(hexToBytes, "hexToBytes");
+DF2CBFKF_cjs.__name(hexToBytes, "hexToBytes");
 function bytesToHex(bytes) {
-  return Buffer.from(bytes).toString("hex");
+  return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString("hex");
 }
-__name(bytesToHex, "bytesToHex");
+DF2CBFKF_cjs.__name(bytesToHex, "bytesToHex");
 function bytesToHexPrefixed(bytes) {
   return ensure0xPrefixed(bytesToHex(bytes));
 }
-__name(bytesToHexPrefixed, "bytesToHexPrefixed");
+DF2CBFKF_cjs.__name(bytesToHexPrefixed, "bytesToHexPrefixed");
 function bytesToBase64(bytes) {
-  return Buffer.from(bytes).toString("base64");
+  return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString("base64");
 }
-__name(bytesToBase64, "bytesToBase64");
+DF2CBFKF_cjs.__name(bytesToBase64, "bytesToBase64");
+function base64ToBytes(base64) {
+  return Uint8Array.from(Buffer.from(base64, "base64"));
+}
+DF2CBFKF_cjs.__name(base64ToBytes, "base64ToBytes");
 function hexToBase64(hexString) {
   const hex = trim0x(hexString);
   if (!/^[0-9a-fA-F]+$/.test(hex)) {
@@ -109,14 +112,14 @@ function hexToBase64(hexString) {
   const base64String = Buffer.from(bytes).toString("base64");
   return base64String;
 }
-__name(hexToBase64, "hexToBase64");
+DF2CBFKF_cjs.__name(hexToBase64, "hexToBase64");
 function base64ToHex(base64String) {
   if (!/^[A-Za-z0-9+/=]*$/.test(base64String)) {
     throw new Error(`Invalid base64 string: ${base64String}`);
   }
   return `0x${Buffer.from(base64String, "base64").toString("hex")}`;
 }
-__name(base64ToHex, "base64ToHex");
+DF2CBFKF_cjs.__name(base64ToHex, "base64ToHex");
 function padString(str, length, left, padding = "0") {
   const diff = length - str.length;
   let result = str;
@@ -126,23 +129,28 @@ function padString(str, length, left, padding = "0") {
   }
   return result;
 }
-__name(padString, "padString");
+DF2CBFKF_cjs.__name(padString, "padString");
 function padLeft(str, length, padding = "0") {
   return padString(str, length, true, padding);
 }
-__name(padLeft, "padLeft");
+DF2CBFKF_cjs.__name(padLeft, "padLeft");
 function calcByteLength(str, byteSize = 8) {
   const { length } = str;
   const remainder = length % byteSize;
   return remainder ? (length - remainder) / byteSize * byteSize + byteSize : length;
 }
-__name(calcByteLength, "calcByteLength");
+DF2CBFKF_cjs.__name(calcByteLength, "calcByteLength");
 function padAlignHex(str, byteSize = 8, padding = "0") {
   const trimmed = trim0x(str);
   return padLeft(trimmed, calcByteLength(trimmed, byteSize), padding);
 }
-__name(padAlignHex, "padAlignHex");
+DF2CBFKF_cjs.__name(padAlignHex, "padAlignHex");
 
+Object.defineProperty(exports, "ByteCodec", {
+  enumerable: true,
+  get: function () { return DF2CBFKF_cjs.ByteCodec; }
+});
+exports.base64ToBytes = base64ToBytes;
 exports.base64ToHex = base64ToHex;
 exports.bytesToBase64 = bytesToBase64;
 exports.bytesToHex = bytesToHex;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["base58regex","base64regex","hexStringRegex","isBase58","address","test","isBase64","isHexString","value","length","match","hexZeroPad","Error","trim0x","padStart","str","replace","ensure0xPrefixed","trimLeadingZeros","hexString","withoutPrefix","hexToUint8Array","Uint8Array","from","Buffer","hexToAscii","hex","i","l","startsWith","code","parseInt","slice","String","fromCharCode","stringToUint8Array","len","hexToBytes","bytesToHex","bytes","toString","bytesToHexPrefixed","bytesToBase64","hexToBase64","substr","base64String","base64ToHex","padString","left","padding","diff","result","pad","repeat","padLeft","calcByteLength","byteSize","remainder","padAlignHex","trimmed"],"mappings":"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","file":"index.cjs","sourcesContent":["export type HexString = `0x${string}`;\n\nconst base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;\nconst base64regex = /^[A-Za-z0-9+/]*={0,2}$/;\nconst hexStringRegex = /^(0x)?[0-9A-Fa-f]*$/;\n\nexport function isBase58(address: string): boolean {\n    return base58regex.test(address);\n}\n\nexport function isBase64(address: string): boolean {\n    return base64regex.test(address);\n}\n\nexport function isHexString(value: any, length?: number): value is HexString {\n    if (typeof value !== 'string' || !value.match(hexStringRegex)) {\n        return false;\n    }\n    if (length && value.length !== 2 + 2 * length) {\n        return false;\n    }\n    return true;\n}\n\nexport function hexZeroPad(value: string, length: number): HexString {\n    if (!isHexString(value)) {\n        throw new Error(`invalid hex string: ${value}`);\n    }\n\n    if (value.length > 2 * length + 2) {\n        throw new Error('value out of range');\n    }\n\n    return `0x${trim0x(value).padStart(2 * length, '0')}`;\n}\n\nexport function trim0x(str: string): string {\n    return str.replace(/^0x/, '');\n}\n\nexport function ensure0xPrefixed(str: string): HexString {\n    return `0x${trim0x(str)}`;\n}\n\nexport function trimLeadingZeros(hexString: string): HexString {\n    // Remove the '0x' prefix\n    let withoutPrefix = trim0x(hexString);\n\n    // Trim leading zeros\n    withoutPrefix = withoutPrefix.replace(/^0+/, '');\n\n    // Add back the '0x' prefix\n    return ensure0xPrefixed(withoutPrefix);\n}\n\nexport function hexToUint8Array(hexString: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(trim0x(hexString), 'hex'));\n}\n\nexport function hexToAscii(hex: string): string {\n    if (!isHexString(hex)) {\n        throw new Error(`Invalid hex string ${hex}`);\n    }\n\n    let str = '';\n    let i = 0;\n    const l = hex.length;\n    if (hex.startsWith('0x')) {\n        i = 2;\n    }\n    for (; i < l; i += 2) {\n        const code = parseInt(hex.slice(i, i + 2), 16);\n        str += String.fromCharCode(code);\n    }\n\n    return str;\n}\n\nexport function stringToUint8Array(str: string): Uint8Array {\n    const value = str.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\n/**\n * A function to convert hex string to Uint8Array (not prefixed)\n * @param hex hex string\n * @returns Uint8Array\n */\nexport function hexToBytes(hex: string): Uint8Array {\n    const value = hex.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\nexport function bytesToHex(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes).toString('hex');\n}\n\n/**\n * 0x prefixed hex string from Uint8Array\n * @param bytes\n */\nexport function bytesToHexPrefixed(bytes: Uint8Array | ArrayBuffer): HexString {\n    return ensure0xPrefixed(bytesToHex(bytes));\n}\n\nexport function bytesToBase64(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes).toString('base64');\n}\n\nexport function hexToBase64(hexString: string): string {\n    const hex = trim0x(hexString);\n    // Validate that the input is a valid hex string\n    if (!/^[0-9a-fA-F]+$/.test(hex)) {\n        throw new Error(`Invalid hex string: ${hexString}`);\n    }\n\n    // Ensure the hex string has an even length\n    if (hex.length % 2 !== 0) {\n        throw new Error('Hex string must have an even length');\n    }\n\n    // Convert hex string to a byte array\n    const bytes = new Uint8Array(hex.length / 2);\n    for (let i = 0; i < hex.length; i += 2) {\n        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);\n    }\n\n    // Convert the byte array to a base64 string\n    const base64String = Buffer.from(bytes).toString('base64');\n\n    return base64String;\n}\n\nexport function base64ToHex(base64String: string): HexString {\n    if (!/^[A-Za-z0-9+/=]*$/.test(base64String)) {\n        throw new Error(`Invalid base64 string: ${base64String}`);\n    }\n    return `0x${Buffer.from(base64String, 'base64').toString('hex')}`;\n}\n\nfunction padString(str: string, length: number, left: boolean, padding = '0') {\n    const diff = length - str.length;\n    let result = str;\n    if (diff > 0) {\n        const pad = padding.repeat(diff);\n        result = left ? pad + str : str + pad;\n    }\n    return result;\n}\n\nfunction padLeft(str: string, length: number, padding = '0') {\n    return padString(str, length, true, padding);\n}\nfunction calcByteLength(str: string, byteSize = 8) {\n    const { length } = str;\n    const remainder = length % byteSize;\n    return remainder ? ((length - remainder) / byteSize) * byteSize + byteSize : length;\n}\n\n/**\n * Pads a hex string on the left so its length is a multiple of `byteSize`.\n * Used to align hex strings.\n * @param str Hex string.\n * @param byteSize Group size to align to, in hex chars (default: 8).\n * @param padding Left-pad character (default: '0').\n * @returns Hex string left-padded to a multiple of `byteSize`.\n */\nexport function padAlignHex(str: string, byteSize = 8, padding = '0') {\n    const trimmed = trim0x(str);\n    return padLeft(trimmed, calcByteLength(trimmed, byteSize), padding);\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["base58regex","base64regex","hexStringRegex","isBase58","address","test","isBase64","isHexString","value","length","match","hexZeroPad","Error","trim0x","padStart","str","replace","ensure0xPrefixed","trimLeadingZeros","hexString","withoutPrefix","hexToUint8Array","Uint8Array","from","Buffer","hexToAscii","hex","i","l","startsWith","code","parseInt","slice","String","fromCharCode","stringToUint8Array","len","hexToBytes","bytesToHex","bytes","ArrayBuffer","toString","bytesToHexPrefixed","bytesToBase64","base64ToBytes","base64","hexToBase64","substr","base64String","base64ToHex","padString","left","padding","diff","result","pad","repeat","padLeft","calcByteLength","byteSize","remainder","padAlignHex","trimmed"],"mappings":"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","file":"index.cjs","sourcesContent":["export * from './byte-codec';\n\nexport type HexString = `0x${string}`;\n\nconst base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;\nconst base64regex = /^[A-Za-z0-9+/]*={0,2}$/;\nconst hexStringRegex = /^(0x)?[0-9A-Fa-f]*$/;\n\nexport function isBase58(address: string): boolean {\n    return base58regex.test(address);\n}\n\nexport function isBase64(address: string): boolean {\n    return base64regex.test(address);\n}\n\nexport function isHexString(value: any, length?: number): value is HexString {\n    if (typeof value !== 'string' || !value.match(hexStringRegex)) {\n        return false;\n    }\n    if (length && value.length !== 2 + 2 * length) {\n        return false;\n    }\n    return true;\n}\n\nexport function hexZeroPad(value: string, length: number): HexString {\n    if (!isHexString(value)) {\n        throw new Error(`invalid hex string: ${value}`);\n    }\n\n    if (value.length > 2 * length + 2) {\n        throw new Error('value out of range');\n    }\n\n    return `0x${trim0x(value).padStart(2 * length, '0')}`;\n}\n\nexport function trim0x(str: string): string {\n    return str.replace(/^0x/, '');\n}\n\nexport function ensure0xPrefixed(str: string): HexString {\n    return `0x${trim0x(str)}`;\n}\n\nexport function trimLeadingZeros(hexString: string): HexString {\n    // Remove the '0x' prefix\n    let withoutPrefix = trim0x(hexString);\n\n    // Trim leading zeros\n    withoutPrefix = withoutPrefix.replace(/^0+/, '');\n\n    // Add back the '0x' prefix\n    return ensure0xPrefixed(withoutPrefix);\n}\n\nexport function hexToUint8Array(hexString: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(trim0x(hexString), 'hex'));\n}\n\nexport function hexToAscii(hex: string): string {\n    if (!isHexString(hex)) {\n        throw new Error(`Invalid hex string ${hex}`);\n    }\n\n    let str = '';\n    let i = 0;\n    const l = hex.length;\n    if (hex.startsWith('0x')) {\n        i = 2;\n    }\n    for (; i < l; i += 2) {\n        const code = parseInt(hex.slice(i, i + 2), 16);\n        str += String.fromCharCode(code);\n    }\n\n    return str;\n}\n\nexport function stringToUint8Array(str: string): Uint8Array {\n    const value = str.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\n/**\n * A function to convert hex string to Uint8Array (not prefixed)\n * @param hex hex string\n * @returns Uint8Array\n */\nexport function hexToBytes(hex: string): Uint8Array {\n    const value = hex.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\nexport function bytesToHex(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString(\n        'hex',\n    );\n}\n\n/**\n * 0x prefixed hex string from Uint8Array\n * @param bytes\n */\nexport function bytesToHexPrefixed(bytes: Uint8Array | ArrayBuffer): HexString {\n    return ensure0xPrefixed(bytesToHex(bytes));\n}\n\nexport function bytesToBase64(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString(\n        'base64',\n    );\n}\n\nexport function base64ToBytes(base64: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(base64, 'base64'));\n}\n\nexport function hexToBase64(hexString: string): string {\n    const hex = trim0x(hexString);\n    // Validate that the input is a valid hex string\n    if (!/^[0-9a-fA-F]+$/.test(hex)) {\n        throw new Error(`Invalid hex string: ${hexString}`);\n    }\n\n    // Ensure the hex string has an even length\n    if (hex.length % 2 !== 0) {\n        throw new Error('Hex string must have an even length');\n    }\n\n    // Convert hex string to a byte array\n    const bytes = new Uint8Array(hex.length / 2);\n    for (let i = 0; i < hex.length; i += 2) {\n        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);\n    }\n\n    // Convert the byte array to a base64 string\n    const base64String = Buffer.from(bytes).toString('base64');\n\n    return base64String;\n}\n\nexport function base64ToHex(base64String: string): HexString {\n    if (!/^[A-Za-z0-9+/=]*$/.test(base64String)) {\n        throw new Error(`Invalid base64 string: ${base64String}`);\n    }\n    return `0x${Buffer.from(base64String, 'base64').toString('hex')}`;\n}\n\nfunction padString(str: string, length: number, left: boolean, padding = '0') {\n    const diff = length - str.length;\n    let result = str;\n    if (diff > 0) {\n        const pad = padding.repeat(diff);\n        result = left ? pad + str : str + pad;\n    }\n    return result;\n}\n\nfunction padLeft(str: string, length: number, padding = '0') {\n    return padString(str, length, true, padding);\n}\nfunction calcByteLength(str: string, byteSize = 8) {\n    const { length } = str;\n    const remainder = length % byteSize;\n    return remainder ? ((length - remainder) / byteSize) * byteSize + byteSize : length;\n}\n\n/**\n * Pads a hex string on the left so its length is a multiple of `byteSize`.\n * Used to align hex strings.\n * @param str Hex string.\n * @param byteSize Group size to align to, in hex chars (default: 8).\n * @param padding Left-pad character (default: '0').\n * @returns Hex string left-padded to a multiple of `byteSize`.\n */\nexport function padAlignHex(str: string, byteSize = 8, padding = '0') {\n    const trimmed = trim0x(str);\n    return padLeft(trimmed, calcByteLength(trimmed, byteSize), padding);\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './byte-codec';
 export type HexString = `0x${string}`;
 export declare function isBase58(address: string): boolean;
 export declare function isBase64(address: string): boolean;
@@ -22,6 +23,7 @@ export declare function bytesToHex(bytes: Uint8Array | ArrayBuffer): string;
  */
 export declare function bytesToHexPrefixed(bytes: Uint8Array | ArrayBuffer): HexString;
 export declare function bytesToBase64(bytes: Uint8Array | ArrayBuffer): string;
+export declare function base64ToBytes(base64: string): Uint8Array;
 export declare function hexToBase64(hexString: string): string;
 export declare function base64ToHex(base64String: string): HexString;
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,KAAK,MAAM,EAAE,CAAC;AAMtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAQ3E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAUnE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAS7D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAIlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAE7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAErE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBrD;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAK3D;AAqBD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,OAAO,SAAM,UAGnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,KAAK,MAAM,EAAE,CAAC;AAMtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAQ3E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAUnE;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAS7D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB9C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAIlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAE7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAIrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAExD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBrD;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAK3D;AAqBD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,OAAO,SAAM,UAGnE"}

package/dist/index.js

@@ -1,5 +1,5 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { __name } from './2BTCXNB3.js';
+export { ByteCodec } from './2BTCXNB3.js';
 
 // src/index.ts
 var base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;
@@ -81,7 +81,7 @@ function hexToBytes(hex) {
 }
 __name(hexToBytes, "hexToBytes");
 function bytesToHex(bytes) {
-  return Buffer.from(bytes).toString("hex");
+  return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString("hex");
 }
 __name(bytesToHex, "bytesToHex");
 function bytesToHexPrefixed(bytes) {
@@ -89,9 +89,13 @@ function bytesToHexPrefixed(bytes) {
 }
 __name(bytesToHexPrefixed, "bytesToHexPrefixed");
 function bytesToBase64(bytes) {
-  return Buffer.from(bytes).toString("base64");
+  return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString("base64");
 }
 __name(bytesToBase64, "bytesToBase64");
+function base64ToBytes(base64) {
+  return Uint8Array.from(Buffer.from(base64, "base64"));
+}
+__name(base64ToBytes, "base64ToBytes");
 function hexToBase64(hexString) {
   const hex = trim0x(hexString);
   if (!/^[0-9a-fA-F]+$/.test(hex)) {
@@ -141,6 +145,6 @@ function padAlignHex(str, byteSize = 8, padding = "0") {
 }
 __name(padAlignHex, "padAlignHex");
 
-export { base64ToHex, bytesToBase64, bytesToHex, bytesToHexPrefixed, ensure0xPrefixed, hexToAscii, hexToBase64, hexToBytes, hexToUint8Array, hexZeroPad, isBase58, isBase64, isHexString, padAlignHex, stringToUint8Array, trim0x, trimLeadingZeros };
+export { base64ToBytes, base64ToHex, bytesToBase64, bytesToHex, bytesToHexPrefixed, ensure0xPrefixed, hexToAscii, hexToBase64, hexToBytes, hexToUint8Array, hexZeroPad, isBase58, isBase64, isHexString, padAlignHex, stringToUint8Array, trim0x, trimLeadingZeros };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["base58regex","base64regex","hexStringRegex","isBase58","address","test","isBase64","isHexString","value","length","match","hexZeroPad","Error","trim0x","padStart","str","replace","ensure0xPrefixed","trimLeadingZeros","hexString","withoutPrefix","hexToUint8Array","Uint8Array","from","Buffer","hexToAscii","hex","i","l","startsWith","code","parseInt","slice","String","fromCharCode","stringToUint8Array","len","hexToBytes","bytesToHex","bytes","toString","bytesToHexPrefixed","bytesToBase64","hexToBase64","substr","base64String","base64ToHex","padString","left","padding","diff","result","pad","repeat","padLeft","calcByteLength","byteSize","remainder","padAlignHex","trimmed"],"mappings":"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","file":"index.js","sourcesContent":["export type HexString = `0x${string}`;\n\nconst base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;\nconst base64regex = /^[A-Za-z0-9+/]*={0,2}$/;\nconst hexStringRegex = /^(0x)?[0-9A-Fa-f]*$/;\n\nexport function isBase58(address: string): boolean {\n    return base58regex.test(address);\n}\n\nexport function isBase64(address: string): boolean {\n    return base64regex.test(address);\n}\n\nexport function isHexString(value: any, length?: number): value is HexString {\n    if (typeof value !== 'string' || !value.match(hexStringRegex)) {\n        return false;\n    }\n    if (length && value.length !== 2 + 2 * length) {\n        return false;\n    }\n    return true;\n}\n\nexport function hexZeroPad(value: string, length: number): HexString {\n    if (!isHexString(value)) {\n        throw new Error(`invalid hex string: ${value}`);\n    }\n\n    if (value.length > 2 * length + 2) {\n        throw new Error('value out of range');\n    }\n\n    return `0x${trim0x(value).padStart(2 * length, '0')}`;\n}\n\nexport function trim0x(str: string): string {\n    return str.replace(/^0x/, '');\n}\n\nexport function ensure0xPrefixed(str: string): HexString {\n    return `0x${trim0x(str)}`;\n}\n\nexport function trimLeadingZeros(hexString: string): HexString {\n    // Remove the '0x' prefix\n    let withoutPrefix = trim0x(hexString);\n\n    // Trim leading zeros\n    withoutPrefix = withoutPrefix.replace(/^0+/, '');\n\n    // Add back the '0x' prefix\n    return ensure0xPrefixed(withoutPrefix);\n}\n\nexport function hexToUint8Array(hexString: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(trim0x(hexString), 'hex'));\n}\n\nexport function hexToAscii(hex: string): string {\n    if (!isHexString(hex)) {\n        throw new Error(`Invalid hex string ${hex}`);\n    }\n\n    let str = '';\n    let i = 0;\n    const l = hex.length;\n    if (hex.startsWith('0x')) {\n        i = 2;\n    }\n    for (; i < l; i += 2) {\n        const code = parseInt(hex.slice(i, i + 2), 16);\n        str += String.fromCharCode(code);\n    }\n\n    return str;\n}\n\nexport function stringToUint8Array(str: string): Uint8Array {\n    const value = str.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\n/**\n * A function to convert hex string to Uint8Array (not prefixed)\n * @param hex hex string\n * @returns Uint8Array\n */\nexport function hexToBytes(hex: string): Uint8Array {\n    const value = hex.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\nexport function bytesToHex(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes).toString('hex');\n}\n\n/**\n * 0x prefixed hex string from Uint8Array\n * @param bytes\n */\nexport function bytesToHexPrefixed(bytes: Uint8Array | ArrayBuffer): HexString {\n    return ensure0xPrefixed(bytesToHex(bytes));\n}\n\nexport function bytesToBase64(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes).toString('base64');\n}\n\nexport function hexToBase64(hexString: string): string {\n    const hex = trim0x(hexString);\n    // Validate that the input is a valid hex string\n    if (!/^[0-9a-fA-F]+$/.test(hex)) {\n        throw new Error(`Invalid hex string: ${hexString}`);\n    }\n\n    // Ensure the hex string has an even length\n    if (hex.length % 2 !== 0) {\n        throw new Error('Hex string must have an even length');\n    }\n\n    // Convert hex string to a byte array\n    const bytes = new Uint8Array(hex.length / 2);\n    for (let i = 0; i < hex.length; i += 2) {\n        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);\n    }\n\n    // Convert the byte array to a base64 string\n    const base64String = Buffer.from(bytes).toString('base64');\n\n    return base64String;\n}\n\nexport function base64ToHex(base64String: string): HexString {\n    if (!/^[A-Za-z0-9+/=]*$/.test(base64String)) {\n        throw new Error(`Invalid base64 string: ${base64String}`);\n    }\n    return `0x${Buffer.from(base64String, 'base64').toString('hex')}`;\n}\n\nfunction padString(str: string, length: number, left: boolean, padding = '0') {\n    const diff = length - str.length;\n    let result = str;\n    if (diff > 0) {\n        const pad = padding.repeat(diff);\n        result = left ? pad + str : str + pad;\n    }\n    return result;\n}\n\nfunction padLeft(str: string, length: number, padding = '0') {\n    return padString(str, length, true, padding);\n}\nfunction calcByteLength(str: string, byteSize = 8) {\n    const { length } = str;\n    const remainder = length % byteSize;\n    return remainder ? ((length - remainder) / byteSize) * byteSize + byteSize : length;\n}\n\n/**\n * Pads a hex string on the left so its length is a multiple of `byteSize`.\n * Used to align hex strings.\n * @param str Hex string.\n * @param byteSize Group size to align to, in hex chars (default: 8).\n * @param padding Left-pad character (default: '0').\n * @returns Hex string left-padded to a multiple of `byteSize`.\n */\nexport function padAlignHex(str: string, byteSize = 8, padding = '0') {\n    const trimmed = trim0x(str);\n    return padLeft(trimmed, calcByteLength(trimmed, byteSize), padding);\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["base58regex","base64regex","hexStringRegex","isBase58","address","test","isBase64","isHexString","value","length","match","hexZeroPad","Error","trim0x","padStart","str","replace","ensure0xPrefixed","trimLeadingZeros","hexString","withoutPrefix","hexToUint8Array","Uint8Array","from","Buffer","hexToAscii","hex","i","l","startsWith","code","parseInt","slice","String","fromCharCode","stringToUint8Array","len","hexToBytes","bytesToHex","bytes","ArrayBuffer","toString","bytesToHexPrefixed","bytesToBase64","base64ToBytes","base64","hexToBase64","substr","base64String","base64ToHex","padString","left","padding","diff","result","pad","repeat","padLeft","calcByteLength","byteSize","remainder","padAlignHex","trimmed"],"mappings":";;;;AAIA,IAAMA,WAAAA,GAAc,yBAAA;AACpB,IAAMC,WAAAA,GAAc,wBAAA;AACpB,IAAMC,cAAAA,GAAiB,qBAAA;AAEhB,SAASC,SAASC,OAAAA,EAAe;AACpC,EAAA,OAAOJ,WAAAA,CAAYK,KAAKD,OAAAA,CAAAA;AAC5B;AAFgBD,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAIT,SAASG,SAASF,OAAAA,EAAe;AACpC,EAAA,OAAOH,WAAAA,CAAYI,KAAKD,OAAAA,CAAAA;AAC5B;AAFgBE,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAIT,SAASC,WAAAA,CAAYC,OAAYC,MAAAA,EAAe;AACnD,EAAA,IAAI,OAAOD,KAAAA,KAAU,QAAA,IAAY,CAACA,KAAAA,CAAME,KAAAA,CAAMR,cAAAA,CAAAA,EAAiB;AAC3D,IAAA,OAAO,KAAA;AACX,EAAA;AACA,EAAA,IAAIO,MAAAA,IAAUD,KAAAA,CAAMC,MAAAA,KAAW,CAAA,GAAI,IAAIA,MAAAA,EAAQ;AAC3C,IAAA,OAAO,KAAA;AACX,EAAA;AACA,EAAA,OAAO,IAAA;AACX;AARgBF,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA;AAUT,SAASI,UAAAA,CAAWH,OAAeC,MAAAA,EAAc;AACpD,EAAA,IAAI,CAACF,WAAAA,CAAYC,KAAAA,CAAAA,EAAQ;AACrB,IAAA,MAAM,IAAII,KAAAA,CAAM,CAAA,oBAAA,EAAuBJ,KAAAA,CAAAA,CAAO,CAAA;AAClD,EAAA;AAEA,EAAA,IAAIA,KAAAA,CAAMC,MAAAA,GAAS,CAAA,GAAIA,MAAAA,GAAS,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAIG,MAAM,oBAAA,CAAA;AACpB,EAAA;AAEA,EAAA,OAAO,CAAA,EAAA,EAAKC,OAAOL,KAAAA,CAAAA,CAAOM,SAAS,CAAA,GAAIL,MAAAA,EAAQ,GAAA,CAAA,CAAA,CAAA;AACnD;AAVgBE,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAYT,SAASE,OAAOE,GAAAA,EAAW;AAC9B,EAAA,OAAOA,GAAAA,CAAIC,OAAAA,CAAQ,KAAA,EAAO,EAAA,CAAA;AAC9B;AAFgBH,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASI,iBAAiBF,GAAAA,EAAW;AACxC,EAAA,OAAO,CAAA,EAAA,EAAKF,MAAAA,CAAOE,GAAAA,CAAAA,CAAAA,CAAAA;AACvB;AAFgBE,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA;AAIT,SAASC,iBAAiBC,SAAAA,EAAiB;AAE9C,EAAA,IAAIC,aAAAA,GAAgBP,OAAOM,SAAAA,CAAAA;AAG3BC,EAAAA,aAAAA,GAAgBA,aAAAA,CAAcJ,OAAAA,CAAQ,KAAA,EAAO,EAAA,CAAA;AAG7C,EAAA,OAAOC,iBAAiBG,aAAAA,CAAAA;AAC5B;AATgBF,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA;AAWT,SAASG,gBAAgBF,SAAAA,EAAiB;AAC7C,EAAA,OAAOG,UAAAA,CAAWC,KAAKC,MAAAA,CAAOD,IAAAA,CAAKV,OAAOM,SAAAA,CAAAA,EAAY,KAAA,CAAA,CAAA;AAC1D;AAFgBE,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAIT,SAASI,WAAWC,GAAAA,EAAW;AAClC,EAAA,IAAI,CAACnB,WAAAA,CAAYmB,GAAAA,CAAAA,EAAM;AACnB,IAAA,MAAM,IAAId,KAAAA,CAAM,CAAA,mBAAA,EAAsBc,GAAAA,CAAAA,CAAK,CAAA;AAC/C,EAAA;AAEA,EAAA,IAAIX,GAAAA,GAAM,EAAA;AACV,EAAA,IAAIY,CAAAA,GAAI,CAAA;AACR,EAAA,MAAMC,IAAIF,GAAAA,CAAIjB,MAAAA;AACd,EAAA,IAAIiB,GAAAA,CAAIG,UAAAA,CAAW,IAAA,CAAA,EAAO;AACtBF,IAAAA,CAAAA,GAAI,CAAA;AACR,EAAA;AACA,EAAA,OAAOA,CAAAA,GAAIC,CAAAA,EAAGD,CAAAA,IAAK,CAAA,EAAG;AAClB,IAAA,MAAMG,IAAAA,GAAOC,SAASL,GAAAA,CAAIM,KAAAA,CAAML,GAAGA,CAAAA,GAAI,CAAA,GAAI,EAAA,CAAA;AAC3CZ,IAAAA,GAAAA,IAAOkB,MAAAA,CAAOC,aAAaJ,IAAAA,CAAAA;AAC/B,EAAA;AAEA,EAAA,OAAOf,GAAAA;AACX;AAjBgBU,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAmBT,SAASU,mBAAmBpB,GAAAA,EAAW;AAC1C,EAAA,MAAMP,KAAAA,GAAQO,GAAAA,CAAIC,OAAAA,CAAQ,MAAA,EAAQ,EAAA,CAAA;AAClC,EAAA,MAAMoB,MAAM5B,KAAAA,CAAMC,MAAAA,GAAS,CAAA,GAAA,CAAMD,KAAAA,CAAMC,SAAS,CAAA,IAAK,CAAA;AACrD,EAAA,OAAOa,UAAAA,CAAWC,IAAAA,CAAKC,MAAAA,CAAOD,IAAAA,CAAKf,KAAAA,CAAMM,SAASsB,GAAAA,EAAK,GAAA,CAAA,EAAM,KAAA,CAAA,CAAA;AACjE;AAJgBD,MAAAA,CAAAA,kBAAAA,EAAAA,oBAAAA,CAAAA;AAWT,SAASE,WAAWX,GAAAA,EAAW;AAClC,EAAA,MAAMlB,KAAAA,GAAQkB,GAAAA,CAAIV,OAAAA,CAAQ,MAAA,EAAQ,EAAA,CAAA;AAClC,EAAA,MAAMoB,MAAM5B,KAAAA,CAAMC,MAAAA,GAAS,CAAA,GAAA,CAAMD,KAAAA,CAAMC,SAAS,CAAA,IAAK,CAAA;AACrD,EAAA,OAAOa,UAAAA,CAAWC,IAAAA,CAAKC,MAAAA,CAAOD,IAAAA,CAAKf,KAAAA,CAAMM,SAASsB,GAAAA,EAAK,GAAA,CAAA,EAAM,KAAA,CAAA,CAAA;AACjE;AAJgBC,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAMT,SAASC,WAAWC,KAAAA,EAA+B;AACtD,EAAA,OAAOf,MAAAA,CAAOD,IAAAA,CAAKgB,KAAAA,YAAiBC,WAAAA,GAAc,IAAIlB,UAAAA,CAAWiB,KAAAA,CAAAA,GAASA,KAAAA,CAAAA,CAAOE,QAAAA,CAC7E,KAAA,CAAA;AAER;AAJgBH,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA;AAUT,SAASI,mBAAmBH,KAAAA,EAA+B;AAC9D,EAAA,OAAOtB,gBAAAA,CAAiBqB,UAAAA,CAAWC,KAAAA,CAAAA,CAAAA;AACvC;AAFgBG,MAAAA,CAAAA,kBAAAA,EAAAA,oBAAAA,CAAAA;AAIT,SAASC,cAAcJ,KAAAA,EAA+B;AACzD,EAAA,OAAOf,MAAAA,CAAOD,IAAAA,CAAKgB,KAAAA,YAAiBC,WAAAA,GAAc,IAAIlB,UAAAA,CAAWiB,KAAAA,CAAAA,GAASA,KAAAA,CAAAA,CAAOE,QAAAA,CAC7E,QAAA,CAAA;AAER;AAJgBE,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA;AAMT,SAASC,cAAcC,MAAAA,EAAc;AACxC,EAAA,OAAOvB,WAAWC,IAAAA,CAAKC,MAAAA,CAAOD,IAAAA,CAAKsB,MAAAA,EAAQ,QAAA,CAAA,CAAA;AAC/C;AAFgBD,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA;AAIT,SAASE,YAAY3B,SAAAA,EAAiB;AACzC,EAAA,MAAMO,GAAAA,GAAMb,OAAOM,SAAAA,CAAAA;AAEnB,EAAA,IAAI,CAAC,gBAAA,CAAiBd,IAAAA,CAAKqB,GAAAA,CAAAA,EAAM;AAC7B,IAAA,MAAM,IAAId,KAAAA,CAAM,CAAA,oBAAA,EAAuBO,SAAAA,CAAAA,CAAW,CAAA;AACtD,EAAA;AAGA,EAAA,IAAIO,GAAAA,CAAIjB,MAAAA,GAAS,CAAA,KAAM,CAAA,EAAG;AACtB,IAAA,MAAM,IAAIG,MAAM,qCAAA,CAAA;AACpB,EAAA;AAGA,EAAA,MAAM2B,KAAAA,GAAQ,IAAIjB,UAAAA,CAAWI,GAAAA,CAAIjB,SAAS,CAAA,CAAA;AAC1C,EAAA,KAAA,IAASkB,IAAI,CAAA,EAAGA,CAAAA,GAAID,GAAAA,CAAIjB,MAAAA,EAAQkB,KAAK,CAAA,EAAG;AACpCY,IAAAA,KAAAA,CAAMZ,CAAAA,GAAI,CAAA,CAAA,GAAKI,QAAAA,CAASL,IAAIqB,MAAAA,CAAOpB,CAAAA,EAAG,CAAA,CAAA,EAAI,EAAA,CAAA;AAC9C,EAAA;AAGA,EAAA,MAAMqB,eAAexB,MAAAA,CAAOD,IAAAA,CAAKgB,KAAAA,CAAAA,CAAOE,SAAS,QAAA,CAAA;AAEjD,EAAA,OAAOO,YAAAA;AACX;AAtBgBF,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA;AAwBT,SAASG,YAAYD,YAAAA,EAAoB;AAC5C,EAAA,IAAI,CAAC,mBAAA,CAAoB3C,IAAAA,CAAK2C,YAAAA,CAAAA,EAAe;AACzC,IAAA,MAAM,IAAIpC,KAAAA,CAAM,CAAA,uBAAA,EAA0BoC,YAAAA,CAAAA,CAAc,CAAA;AAC5D,EAAA;AACA,EAAA,OAAO,CAAA,EAAA,EAAKxB,OAAOD,IAAAA,CAAKyB,YAAAA,EAAc,QAAA,CAAA,CAAUP,QAAAA,CAAS,KAAA,CAAA,CAAA,CAAA;AAC7D;AALgBQ,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA;AAOhB,SAASC,SAAAA,CAAUnC,GAAAA,EAAaN,MAAAA,EAAgB0C,IAAAA,EAAeC,UAAU,GAAA,EAAG;AACxE,EAAA,MAAMC,IAAAA,GAAO5C,SAASM,GAAAA,CAAIN,MAAAA;AAC1B,EAAA,IAAI6C,MAAAA,GAASvC,GAAAA;AACb,EAAA,IAAIsC,OAAO,CAAA,EAAG;AACV,IAAA,MAAME,GAAAA,GAAMH,OAAAA,CAAQI,MAAAA,CAAOH,IAAAA,CAAAA;AAC3BC,IAAAA,MAAAA,GAASH,IAAAA,GAAOI,GAAAA,GAAMxC,GAAAA,GAAMA,GAAAA,GAAMwC,GAAAA;AACtC,EAAA;AACA,EAAA,OAAOD,MAAAA;AACX;AARSJ,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAUT,SAASO,OAAAA,CAAQ1C,GAAAA,EAAaN,MAAAA,EAAgB2C,OAAAA,GAAU,GAAA,EAAG;AACvD,EAAA,OAAOF,SAAAA,CAAUnC,GAAAA,EAAKN,MAAAA,EAAQ,IAAA,EAAM2C,OAAAA,CAAAA;AACxC;AAFSK,MAAAA,CAAAA,OAAAA,EAAAA,SAAAA,CAAAA;AAGT,SAASC,cAAAA,CAAe3C,GAAAA,EAAa4C,QAAAA,GAAW,CAAA,EAAC;AAC7C,EAAA,MAAM,EAAElD,QAAM,GAAKM,GAAAA;AACnB,EAAA,MAAM6C,YAAYnD,MAAAA,GAASkD,QAAAA;AAC3B,EAAA,OAAOC,SAAAA,GAAAA,CAAcnD,MAAAA,GAASmD,SAAAA,IAAaD,QAAAA,GAAYA,WAAWA,QAAAA,GAAWlD,MAAAA;AACjF;AAJSiD,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA;AAcF,SAASG,WAAAA,CAAY9C,GAAAA,EAAa4C,QAAAA,GAAW,CAAA,EAAGP,UAAU,GAAA,EAAG;AAChE,EAAA,MAAMU,OAAAA,GAAUjD,OAAOE,GAAAA,CAAAA;AACvB,EAAA,OAAO0C,QAAQK,OAAAA,EAASJ,cAAAA,CAAeI,OAAAA,EAASH,QAAAA,GAAWP,OAAAA,CAAAA;AAC/D;AAHgBS,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA","file":"index.js","sourcesContent":["export * from './byte-codec';\n\nexport type HexString = `0x${string}`;\n\nconst base58regex = /^[A-HJ-NP-Za-km-z1-9]*$/;\nconst base64regex = /^[A-Za-z0-9+/]*={0,2}$/;\nconst hexStringRegex = /^(0x)?[0-9A-Fa-f]*$/;\n\nexport function isBase58(address: string): boolean {\n    return base58regex.test(address);\n}\n\nexport function isBase64(address: string): boolean {\n    return base64regex.test(address);\n}\n\nexport function isHexString(value: any, length?: number): value is HexString {\n    if (typeof value !== 'string' || !value.match(hexStringRegex)) {\n        return false;\n    }\n    if (length && value.length !== 2 + 2 * length) {\n        return false;\n    }\n    return true;\n}\n\nexport function hexZeroPad(value: string, length: number): HexString {\n    if (!isHexString(value)) {\n        throw new Error(`invalid hex string: ${value}`);\n    }\n\n    if (value.length > 2 * length + 2) {\n        throw new Error('value out of range');\n    }\n\n    return `0x${trim0x(value).padStart(2 * length, '0')}`;\n}\n\nexport function trim0x(str: string): string {\n    return str.replace(/^0x/, '');\n}\n\nexport function ensure0xPrefixed(str: string): HexString {\n    return `0x${trim0x(str)}`;\n}\n\nexport function trimLeadingZeros(hexString: string): HexString {\n    // Remove the '0x' prefix\n    let withoutPrefix = trim0x(hexString);\n\n    // Trim leading zeros\n    withoutPrefix = withoutPrefix.replace(/^0+/, '');\n\n    // Add back the '0x' prefix\n    return ensure0xPrefixed(withoutPrefix);\n}\n\nexport function hexToUint8Array(hexString: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(trim0x(hexString), 'hex'));\n}\n\nexport function hexToAscii(hex: string): string {\n    if (!isHexString(hex)) {\n        throw new Error(`Invalid hex string ${hex}`);\n    }\n\n    let str = '';\n    let i = 0;\n    const l = hex.length;\n    if (hex.startsWith('0x')) {\n        i = 2;\n    }\n    for (; i < l; i += 2) {\n        const code = parseInt(hex.slice(i, i + 2), 16);\n        str += String.fromCharCode(code);\n    }\n\n    return str;\n}\n\nexport function stringToUint8Array(str: string): Uint8Array {\n    const value = str.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\n/**\n * A function to convert hex string to Uint8Array (not prefixed)\n * @param hex hex string\n * @returns Uint8Array\n */\nexport function hexToBytes(hex: string): Uint8Array {\n    const value = hex.replace(/^0x/i, '');\n    const len = value.length + 1 - ((value.length + 1) % 2);\n    return Uint8Array.from(Buffer.from(value.padStart(len, '0'), 'hex'));\n}\n\nexport function bytesToHex(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString(\n        'hex',\n    );\n}\n\n/**\n * 0x prefixed hex string from Uint8Array\n * @param bytes\n */\nexport function bytesToHexPrefixed(bytes: Uint8Array | ArrayBuffer): HexString {\n    return ensure0xPrefixed(bytesToHex(bytes));\n}\n\nexport function bytesToBase64(bytes: Uint8Array | ArrayBuffer): string {\n    return Buffer.from(bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes).toString(\n        'base64',\n    );\n}\n\nexport function base64ToBytes(base64: string): Uint8Array {\n    return Uint8Array.from(Buffer.from(base64, 'base64'));\n}\n\nexport function hexToBase64(hexString: string): string {\n    const hex = trim0x(hexString);\n    // Validate that the input is a valid hex string\n    if (!/^[0-9a-fA-F]+$/.test(hex)) {\n        throw new Error(`Invalid hex string: ${hexString}`);\n    }\n\n    // Ensure the hex string has an even length\n    if (hex.length % 2 !== 0) {\n        throw new Error('Hex string must have an even length');\n    }\n\n    // Convert hex string to a byte array\n    const bytes = new Uint8Array(hex.length / 2);\n    for (let i = 0; i < hex.length; i += 2) {\n        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);\n    }\n\n    // Convert the byte array to a base64 string\n    const base64String = Buffer.from(bytes).toString('base64');\n\n    return base64String;\n}\n\nexport function base64ToHex(base64String: string): HexString {\n    if (!/^[A-Za-z0-9+/=]*$/.test(base64String)) {\n        throw new Error(`Invalid base64 string: ${base64String}`);\n    }\n    return `0x${Buffer.from(base64String, 'base64').toString('hex')}`;\n}\n\nfunction padString(str: string, length: number, left: boolean, padding = '0') {\n    const diff = length - str.length;\n    let result = str;\n    if (diff > 0) {\n        const pad = padding.repeat(diff);\n        result = left ? pad + str : str + pad;\n    }\n    return result;\n}\n\nfunction padLeft(str: string, length: number, padding = '0') {\n    return padString(str, length, true, padding);\n}\nfunction calcByteLength(str: string, byteSize = 8) {\n    const { length } = str;\n    const remainder = length % byteSize;\n    return remainder ? ((length - remainder) / byteSize) * byteSize + byteSize : length;\n}\n\n/**\n * Pads a hex string on the left so its length is a multiple of `byteSize`.\n * Used to align hex strings.\n * @param str Hex string.\n * @param byteSize Group size to align to, in hex chars (default: 8).\n * @param padding Left-pad character (default: '0').\n * @returns Hex string left-padded to a multiple of `byteSize`.\n */\nexport function padAlignHex(str: string, byteSize = 8, padding = '0') {\n    const trimmed = trim0x(str);\n    return padLeft(trimmed, calcByteLength(trimmed, byteSize), padding);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/common-encoding-utils",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -16,18 +16,13 @@
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.3",
-    "@layerzerolabs/tsup-configuration": "0.2.64",
-    "@layerzerolabs/typescript-configuration": "0.2.64"
+    "@layerzerolabs/tsup-configuration": "0.2.66",
+    "@layerzerolabs/typescript-configuration": "0.2.66"
   },
   "publishConfig": {
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "externalRepoConfig": {
-    "targets": [
-      "audit-external"
-    ]
-  },
   "scripts": {
     "build": "tsup",
     "lint": "eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)",

package/src/byte-codec.ts

@@ -0,0 +1,265 @@
+/**
+ * Growable byte codec backed by `ArrayBuffer` + `DataView`.
+ *
+ * Low-level building block for constructing byte payloads deterministically.
+ * Higher-level concerns (e.g. hashing, ABI encoding, function signatures) should
+ * live in wrappers/subclasses.
+ */
+
+function uMax(bits: number): bigint {
+    if (!Number.isInteger(bits) || bits < 0) {
+        throw new RangeError(`ByteCodec: invalid bit width: ${bits}`);
+    }
+    // (2^bits) - 1, as bigint
+    return bits === 0 ? 0n : (1n << BigInt(bits)) - 1n;
+}
+
+// TODO: add tests for this class — currently has zero test coverage
+export class ByteCodec {
+    // Start with a small-ish initial capacity to avoid frequent reallocations for
+    // common short payloads (e.g. function selector + a few fixed-width fields),
+    // while still staying tiny in memory terms. Buffer grows by doubling as needed.
+    #buf = new ArrayBuffer(128);
+    #view = new DataView(this.#buf);
+    #cursor = 0;
+
+    static readonly #ZERO = 0n;
+    static readonly #U8_MAX = uMax(8);
+    static readonly #U16_MAX = uMax(16);
+    static readonly #U32_MAX = uMax(32);
+    static readonly #U64_MAX = uMax(64);
+    static readonly #U128_MAX = uMax(128);
+    static readonly #U256_MAX = uMax(256);
+
+    static #outOfRange(targetLength: number, value: bigint): RangeError {
+        return new RangeError(`ByteCodec: value out of range for u${targetLength * 8}: ${value}`);
+    }
+
+    /**
+     * Read helpers (big-endian). These are intentionally small/low-level so other
+     * packages can share a single implementation for parsing encoded payloads.
+     */
+    static readU16be(buf: Uint8Array, offset: number): number {
+        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+        return view.getUint16(offset, false);
+    }
+
+    static readU8(buf: Uint8Array, offset: number): number {
+        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+        return view.getUint8(offset);
+    }
+
+    static readU32be(buf: Uint8Array, offset: number): number {
+        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+        return view.getUint32(offset, false);
+    }
+
+    static readU128be(buf: Uint8Array, offset: number): bigint {
+        return ByteCodec.readUNbe(buf, offset, 16);
+    }
+
+    static readUNbe(buf: Uint8Array, offset: number, length: number): bigint {
+        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+
+        let out = 0n;
+        const end = offset + length;
+
+        // Fast path: read 8 bytes at a time
+        let cursor = offset;
+        while (cursor + 8 <= end) {
+            out = (out << 64n) | view.getBigUint64(cursor, false);
+            cursor += 8;
+        }
+
+        // Tail: 0..7 bytes
+        while (cursor < end) {
+            out = (out << 8n) | BigInt(view.getUint8(cursor));
+            cursor += 1;
+        }
+
+        return out;
+    }
+
+    static readBytes32(buf: Uint8Array, offset: number): Uint8Array {
+        if (offset + 32 > buf.length) throw new RangeError(`ByteCodec: out of bounds at ${offset}`);
+        return buf.slice(offset, offset + 32);
+    }
+
+    /**
+     * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).
+     *
+     * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.
+     */
+    static leftPad(bytes: Uint8Array, targetLength: number, padByte = 0): Uint8Array {
+        if (!Number.isInteger(targetLength) || targetLength < 0) {
+            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+        }
+        if (!Number.isInteger(padByte) || padByte < 0 || padByte > 255) {
+            throw new RangeError(`ByteCodec: invalid pad byte: ${padByte}`);
+        }
+        if (bytes.length > targetLength) {
+            throw new RangeError(
+                `ByteCodec: bytes length ${bytes.length} exceeds target ${targetLength}`,
+            );
+        }
+
+        const out = new Uint8Array(targetLength);
+        if (padByte !== 0) out.fill(padByte);
+        out.set(bytes, targetLength - bytes.length);
+        return out;
+    }
+
+    /**
+     * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),
+     * reverting on overflow.
+     *
+     * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:
+     * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero
+     * - returns the low `targetLength` bytes as the result
+     *
+     * Examples:
+     * - cast bytes32 -> u128: castUNbe(bytes32, 16)
+     * - cast bytesN -> u64:   castUNbe(bytesN, 8)
+     */
+    static castUNbe(bytes: Uint8Array, targetLength: number): bigint {
+        if (!Number.isInteger(targetLength) || targetLength < 0) {
+            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+        }
+
+        const len = bytes.length;
+        if (len <= targetLength) return ByteCodec.readUNbe(bytes, 0, len);
+
+        // Overflow check: any excess high bytes must be 0x00.
+        const excess = len - targetLength;
+        for (let i = 0; i < excess; i++) {
+            if (bytes[i] !== 0)
+                throw ByteCodec.#outOfRange(targetLength, ByteCodec.readUNbe(bytes, 0, len));
+        }
+
+        return ByteCodec.readUNbe(bytes, excess, targetLength);
+    }
+
+    static castU8be(bytes: Uint8Array): bigint {
+        return ByteCodec.castUNbe(bytes, 1);
+    }
+
+    static castU16be(bytes: Uint8Array): bigint {
+        return ByteCodec.castUNbe(bytes, 2);
+    }
+
+    static castU32be(bytes: Uint8Array): bigint {
+        return ByteCodec.castUNbe(bytes, 4);
+    }
+
+    static castU64be(bytes: Uint8Array): bigint {
+        return ByteCodec.castUNbe(bytes, 8);
+    }
+
+    static castU128be(bytes: Uint8Array): bigint {
+        return ByteCodec.castUNbe(bytes, 16);
+    }
+
+    protected ensureCapacity(additionalBytes: number): void {
+        const needed = this.#cursor + additionalBytes;
+        if (needed <= this.#buf.byteLength) return;
+
+        let nextCap = this.#buf.byteLength;
+        while (nextCap < needed) nextCap *= 2;
+
+        // Grow by allocating a new ArrayBuffer and copying the written prefix
+        // [0..cursor) into it. We then swap the backing buffer+view.
+        const next = new ArrayBuffer(nextCap);
+        new Uint8Array(next).set(new Uint8Array(this.#buf, 0, this.#cursor));
+        this.#buf = next;
+        this.#view = new DataView(this.#buf);
+    }
+
+    bytes(b: Uint8Array): this {
+        this.ensureCapacity(b.length);
+        new Uint8Array(this.#buf, this.#cursor, b.length).set(b);
+        this.#cursor += b.length;
+        return this;
+    }
+
+    bytes32(b: Uint8Array): this {
+        return this.bytes(ByteCodec.leftPad(b, 32));
+    }
+
+    bool(b: boolean): this {
+        return this.u8(b ? 1n : ByteCodec.#ZERO);
+    }
+
+    u8(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U8_MAX)
+            throw new RangeError(`ByteCodec: value out of range for u8: ${v}`);
+        this.ensureCapacity(1);
+        this.#view.setUint8(this.#cursor, Number(v));
+        this.#cursor += 1;
+        return this;
+    }
+
+    u16be(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U16_MAX)
+            throw new RangeError(`ByteCodec: value out of range for u16: ${v}`);
+        this.ensureCapacity(2);
+        this.#view.setUint16(this.#cursor, Number(v), false);
+        this.#cursor += 2;
+        return this;
+    }
+
+    u32be(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U32_MAX) {
+            throw new RangeError(`ByteCodec: value out of range for u32: ${v}`);
+        }
+        this.ensureCapacity(4);
+        this.#view.setUint32(this.#cursor, Number(v), false);
+        this.#cursor += 4;
+        return this;
+    }
+
+    u64be(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U64_MAX) {
+            throw new RangeError(`ByteCodec: value out of range for u64: ${v}`);
+        }
+        this.ensureCapacity(8);
+        this.#view.setBigUint64(this.#cursor, v, false);
+        this.#cursor += 8;
+        return this;
+    }
+
+    u128be(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U128_MAX) {
+            throw new RangeError(`ByteCodec: value out of range for u128: ${v}`);
+        }
+        this.ensureCapacity(16);
+        const hi = (v >> 64n) & ByteCodec.#U64_MAX;
+        const lo = v & ByteCodec.#U64_MAX;
+        this.#view.setBigUint64(this.#cursor, hi, false);
+        this.#view.setBigUint64(this.#cursor + 8, lo, false);
+        this.#cursor += 16;
+        return this;
+    }
+
+    u256be(v: bigint): this {
+        if (v < ByteCodec.#ZERO || v > ByteCodec.#U256_MAX) {
+            throw new RangeError(`ByteCodec: value out of range for u256: ${v}`);
+        }
+        this.ensureCapacity(32);
+        const w0 = (v >> 192n) & ByteCodec.#U64_MAX;
+        const w1 = (v >> 128n) & ByteCodec.#U64_MAX;
+        const w2 = (v >> 64n) & ByteCodec.#U64_MAX;
+        const w3 = v & ByteCodec.#U64_MAX;
+        this.#view.setBigUint64(this.#cursor, w0, false);
+        this.#view.setBigUint64(this.#cursor + 8, w1, false);
+        this.#view.setBigUint64(this.#cursor + 16, w2, false);
+        this.#view.setBigUint64(this.#cursor + 24, w3, false);
+        this.#cursor += 32;
+        return this;
+    }
+    /**
+     * Returns a copy of the accumulated bytes (no shared backing buffer).
+     */
+    toBytes(): Uint8Array {
+        return new Uint8Array(this.#buf, 0, this.#cursor).slice();
+    }
+}