@layerzerolabs/address-utils-ton 0.2.66

package/.turbo/turbo-build.log

@@ -0,0 +1,19 @@
+ WARN  Issue while reading "/home/runner/work/monorepo-internal/monorepo-internal/.npmrc". Failed to replace env in config: ${NPM_TOKEN}
+
+> @layerzerolabs/address-utils-ton@0.0.0 build /home/runner/work/monorepo-internal/monorepo-internal/packages/vms/ton/address-utils-ton
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/packages/vms/ton/address-utils-ton/tsup.config.ts
+CLI Target: ES2023
+CLI Cleaning output folder
+CJS Build start
+ESM Build start
+CJS dist/index.cjs     3.42 KB
+CJS dist/index.cjs.map 7.22 KB
+CJS ⚡️ Build success in 160ms
+ESM dist/index.js     3.00 KB
+ESM dist/index.js.map 7.21 KB
+ESM ⚡️ Build success in 161ms

package/.turbo/turbo-lint.log

@@ -0,0 +1,8 @@
+
+> @layerzerolabs/address-utils-ton@0.0.0 lint /home/runner/work/monorepo-internal/monorepo-internal/packages/vms/ton/address-utils-ton
+> eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)
+
+(node:126312) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1775694520701 is not specified and it doesn't parse as CommonJS.
+Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
+To eliminate this warning, add "type": "module" to /home/runner/work/monorepo-internal/monorepo-internal/package.json.
+(Use `node --trace-warnings ...` to show where the warning was created)

package/.turbo/turbo-test.log

@@ -0,0 +1,16 @@
+
+> @layerzerolabs/address-utils-ton@0.0.0 test /home/runner/work/monorepo-internal/monorepo-internal/packages/vms/ton/address-utils-ton
+> vitest --run --pass-with-no-tests --typecheck
+
+Testing types with tsc and vue-tsc is an experimental feature.
+Breaking changes might not follow SemVer, please pin Vitest's version when using it.
+
+ RUN  v3.2.4 /home/runner/work/monorepo-internal/monorepo-internal/packages/vms/ton/address-utils-ton
+
+No test files found, exiting with code 0
+
+include: **/*.{test,spec}.?(c|m)[jt]s?(x)
+exclude:  **/node_modules/**, **/dist/**, **/cypress/**, **/.{idea,git,cache,output,temp}/**, **/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*
+typecheck include: **/*.{test,spec}-d.?(c|m)[jt]s?(x)
+typecheck exclude: **/node_modules/**, **/dist/**, **/cypress/**, **/.{idea,git,cache,output,temp}/**, **/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*
+

package/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2026 - LayerZero Labs Ltd.
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+var ton = require('@ton/ton');
+var base58 = require('bs58');
+var commonEncodingUtils = require('@layerzerolabs/common-encoding-utils');
+var tonSdkTools = require('@layerzerolabs/ton-sdk-tools');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var base58__default = /*#__PURE__*/_interopDefault(base58);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var to32ByteBuffer = /* @__PURE__ */ __name((value, maxIntermediateBufferSize = 66) => {
+  if (typeof value === "string") {
+    if (!commonEncodingUtils.isHexString(value)) {
+      throw new Error("only hex string is supported");
+    }
+    let hex = commonEncodingUtils.trim0x(value);
+    if (hex.length % 2 !== 0) {
+      hex = "0" + hex;
+    }
+    value = tonSdkTools.bufferToBigInt(Buffer.from(hex, "hex"));
+  }
+  if (value instanceof Uint8Array) {
+    value = tonSdkTools.bufferToBigInt(Buffer.from(value));
+  }
+  const bf = tonSdkTools.bigintToSizedBuffer(BigInt(value), maxIntermediateBufferSize);
+  return bf.subarray(-32);
+}, "to32ByteBuffer");
+var bigintToAddress = /* @__PURE__ */ __name((value) => {
+  const buf = to32ByteBuffer(value);
+  return ton.Address.parse(`0:${buf.toString("hex")}`);
+}, "bigintToAddress");
+var parseTonAddress = /* @__PURE__ */ __name((address) => {
+  if (address instanceof ton.Address) {
+    return address;
+  }
+  try {
+    if (typeof address === "bigint" || typeof address === "number") {
+      return bigintToAddress(BigInt(address));
+    }
+    if (address.startsWith("0x")) {
+      return bigintToAddress(BigInt(address));
+    }
+    try {
+      return ton.Address.parse(address);
+    } catch {
+      const _isBase58 = commonEncodingUtils.isBase58(address);
+      const _isHex = commonEncodingUtils.isHexString(address);
+      if (_isHex) {
+        return bigintToAddress(BigInt(`0x${address}`));
+      }
+      if (_isBase58) {
+        return bigintToAddress(BigInt(`0x${Buffer.from(base58__default.default.decode(address)).toString("hex")}`));
+      }
+      throw new Error(`The address ${address} cannot be decoded as TON, hex, or base58`);
+    }
+  } catch (err) {
+    console.error("Error parsing address", {
+      address,
+      error: err?.message ?? err
+    });
+    throw err;
+  }
+}, "parseTonAddress");
+var _addressToNotPaddedHex = /* @__PURE__ */ __name((address) => {
+  return `0x${parseTonAddress(address).hash.toString("hex")}`;
+}, "_addressToNotPaddedHex");
+var addressToHex = /* @__PURE__ */ __name((address) => {
+  return `0x${to32ByteBuffer(_addressToNotPaddedHex(address)).toString("hex").toLowerCase()}`;
+}, "addressToHex");
+var addressToBigInt = /* @__PURE__ */ __name((address) => {
+  return BigInt(_addressToNotPaddedHex(address));
+}, "addressToBigInt");
+var compareAddresses = /* @__PURE__ */ __name((addressA, addressB) => {
+  return parseTonAddress(addressA).equals(parseTonAddress(addressB));
+}, "compareAddresses");
+var numberOfLeadingZeroBitsInAddress = /* @__PURE__ */ __name((address) => {
+  return 32 * 8 - addressToBigInt(address).toString(2).length;
+}, "numberOfLeadingZeroBitsInAddress");
+
+exports.addressToBigInt = addressToBigInt;
+exports.addressToHex = addressToHex;
+exports.bigintToAddress = bigintToAddress;
+exports.compareAddresses = compareAddresses;
+exports.numberOfLeadingZeroBitsInAddress = numberOfLeadingZeroBitsInAddress;
+exports.parseTonAddress = parseTonAddress;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["to32ByteBuffer","value","maxIntermediateBufferSize","isHexString","Error","hex","trim0x","length","bufferToBigInt","Buffer","from","Uint8Array","bf","bigintToSizedBuffer","BigInt","subarray","bigintToAddress","buf","Address","parse","toString","parseTonAddress","address","startsWith","_isBase58","isBase58","_isHex","base58","decode","err","console","error","message","_addressToNotPaddedHex","hash","addressToHex","toLowerCase","addressToBigInt","compareAddresses","addressA","addressB","equals","numberOfLeadingZeroBitsInAddress"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Address } from '@ton/ton';\nimport base58 from 'bs58';\n\nimport type { HexString } from '@layerzerolabs/common-chain-model';\nimport { isBase58, isHexString, trim0x } from '@layerzerolabs/common-encoding-utils';\nimport { bigintToSizedBuffer, bufferToBigInt } from '@layerzerolabs/ton-sdk-tools';\n\nexport type AddressTypeLike = Address | string | bigint;\n\nconst to32ByteBuffer = (\n    value: bigint | number | string | Uint8Array,\n    maxIntermediateBufferSize = 66,\n): Buffer => {\n    if (typeof value === 'string') {\n        if (!isHexString(value)) {\n            throw new Error('only hex string is supported');\n        }\n        let hex = trim0x(value);\n        if (hex.length % 2 !== 0) {\n            hex = '0' + hex;\n        }\n        value = bufferToBigInt(Buffer.from(hex, 'hex'));\n    }\n    if (value instanceof Uint8Array) {\n        value = bufferToBigInt(Buffer.from(value));\n    }\n    const bf = bigintToSizedBuffer(BigInt(value), maxIntermediateBufferSize);\n    // trim from the left, keep the right 32 bytes\n    return bf.subarray(-32);\n};\n\nexport const bigintToAddress = (value: bigint): Address => {\n    const buf = to32ByteBuffer(value);\n    return Address.parse(`0:${buf.toString('hex')}`);\n};\n\nexport const parseTonAddress = (address: AddressTypeLike): Address => {\n    if (address instanceof Address) {\n        return address;\n    }\n\n    try {\n        if (typeof address === 'bigint' || typeof address === 'number') {\n            return bigintToAddress(BigInt(address));\n        }\n\n        if (address.startsWith('0x')) {\n            // If it's a hex address format it to ton format\n            return bigintToAddress(BigInt(address));\n        }\n\n        try {\n            return Address.parse(address);\n        } catch {\n            //at this point, our address is either hex without a '0x', or base58\n            const _isBase58 = isBase58(address);\n            const _isHex = isHexString(address);\n\n            //this includes the case where the address is both base58 and hex\n            //but nearly every address generated this way is hex (only 1/(~5.5e12) are b58)\n            if (_isHex) {\n                return bigintToAddress(BigInt(`0x${address}`));\n            }\n\n            if (_isBase58) {\n                return bigintToAddress(\n                    BigInt(`0x${Buffer.from(base58.decode(address)).toString('hex')}`),\n                );\n            }\n\n            //this is the case where the address is invalid in any encoding\n            throw new Error(`The address ${address} cannot be decoded as TON, hex, or base58`);\n        }\n    } catch (err: any) {\n        console.error('Error parsing address', {\n            address,\n            error: err?.message ?? err,\n        });\n        throw err;\n    }\n};\n\nconst _addressToNotPaddedHex = (address: AddressTypeLike) => {\n    return `0x${parseTonAddress(address).hash.toString('hex')}`;\n};\n\nexport const addressToHex = (address: AddressTypeLike): HexString => {\n    return `0x${to32ByteBuffer(_addressToNotPaddedHex(address)).toString('hex').toLowerCase()}`;\n};\n\nexport const addressToBigInt = (address: AddressTypeLike) => {\n    return BigInt(_addressToNotPaddedHex(address));\n};\n\nexport const compareAddresses = (addressA: AddressTypeLike, addressB: AddressTypeLike) => {\n    return parseTonAddress(addressA).equals(parseTonAddress(addressB));\n};\n\n/**\n * Since toString(2) does not include leading zeros, we can calculate the leading zeros by subtracting\n * the total length of address in binary from the total length of addresses in TON in bits (32 bytes * 8)\n */\nexport const numberOfLeadingZeroBitsInAddress = (address: AddressTypeLike) => {\n    return 32 * 8 - addressToBigInt(address).toString(2).length;\n};\n"]}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { Address } from '@ton/ton';
+import type { HexString } from '@layerzerolabs/common-chain-model';
+export type AddressTypeLike = Address | string | bigint;
+export declare const bigintToAddress: (value: bigint) => Address;
+export declare const parseTonAddress: (address: AddressTypeLike) => Address;
+export declare const addressToHex: (address: AddressTypeLike) => HexString;
+export declare const addressToBigInt: (address: AddressTypeLike) => bigint;
+export declare const compareAddresses: (addressA: AddressTypeLike, addressB: AddressTypeLike) => boolean;
+/**
+ * Since toString(2) does not include leading zeros, we can calculate the leading zeros by subtracting
+ * the total length of address in binary from the total length of addresses in TON in bits (32 bytes * 8)
+ */
+export declare const numberOfLeadingZeroBitsInAddress: (address: AddressTypeLike) => number;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAInE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAwBxD,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,OAG/C,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,eAAe,KAAG,OA4C1D,CAAC;AAMF,eAAO,MAAM,YAAY,GAAI,SAAS,eAAe,KAAG,SAEvD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,eAAe,WAEvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,UAAU,eAAe,EAAE,UAAU,eAAe,YAEpF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,GAAI,SAAS,eAAe,WAExE,CAAC"}

package/dist/index.js

@@ -0,0 +1,79 @@
+import { Address } from '@ton/ton';
+import base58 from 'bs58';
+import { isBase58, isHexString, trim0x } from '@layerzerolabs/common-encoding-utils';
+import { bufferToBigInt, bigintToSizedBuffer } from '@layerzerolabs/ton-sdk-tools';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var to32ByteBuffer = /* @__PURE__ */ __name((value, maxIntermediateBufferSize = 66) => {
+  if (typeof value === "string") {
+    if (!isHexString(value)) {
+      throw new Error("only hex string is supported");
+    }
+    let hex = trim0x(value);
+    if (hex.length % 2 !== 0) {
+      hex = "0" + hex;
+    }
+    value = bufferToBigInt(Buffer.from(hex, "hex"));
+  }
+  if (value instanceof Uint8Array) {
+    value = bufferToBigInt(Buffer.from(value));
+  }
+  const bf = bigintToSizedBuffer(BigInt(value), maxIntermediateBufferSize);
+  return bf.subarray(-32);
+}, "to32ByteBuffer");
+var bigintToAddress = /* @__PURE__ */ __name((value) => {
+  const buf = to32ByteBuffer(value);
+  return Address.parse(`0:${buf.toString("hex")}`);
+}, "bigintToAddress");
+var parseTonAddress = /* @__PURE__ */ __name((address) => {
+  if (address instanceof Address) {
+    return address;
+  }
+  try {
+    if (typeof address === "bigint" || typeof address === "number") {
+      return bigintToAddress(BigInt(address));
+    }
+    if (address.startsWith("0x")) {
+      return bigintToAddress(BigInt(address));
+    }
+    try {
+      return Address.parse(address);
+    } catch {
+      const _isBase58 = isBase58(address);
+      const _isHex = isHexString(address);
+      if (_isHex) {
+        return bigintToAddress(BigInt(`0x${address}`));
+      }
+      if (_isBase58) {
+        return bigintToAddress(BigInt(`0x${Buffer.from(base58.decode(address)).toString("hex")}`));
+      }
+      throw new Error(`The address ${address} cannot be decoded as TON, hex, or base58`);
+    }
+  } catch (err) {
+    console.error("Error parsing address", {
+      address,
+      error: err?.message ?? err
+    });
+    throw err;
+  }
+}, "parseTonAddress");
+var _addressToNotPaddedHex = /* @__PURE__ */ __name((address) => {
+  return `0x${parseTonAddress(address).hash.toString("hex")}`;
+}, "_addressToNotPaddedHex");
+var addressToHex = /* @__PURE__ */ __name((address) => {
+  return `0x${to32ByteBuffer(_addressToNotPaddedHex(address)).toString("hex").toLowerCase()}`;
+}, "addressToHex");
+var addressToBigInt = /* @__PURE__ */ __name((address) => {
+  return BigInt(_addressToNotPaddedHex(address));
+}, "addressToBigInt");
+var compareAddresses = /* @__PURE__ */ __name((addressA, addressB) => {
+  return parseTonAddress(addressA).equals(parseTonAddress(addressB));
+}, "compareAddresses");
+var numberOfLeadingZeroBitsInAddress = /* @__PURE__ */ __name((address) => {
+  return 32 * 8 - addressToBigInt(address).toString(2).length;
+}, "numberOfLeadingZeroBitsInAddress");
+
+export { addressToBigInt, addressToHex, bigintToAddress, compareAddresses, numberOfLeadingZeroBitsInAddress, parseTonAddress };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["to32ByteBuffer","value","maxIntermediateBufferSize","isHexString","Error","hex","trim0x","length","bufferToBigInt","Buffer","from","Uint8Array","bf","bigintToSizedBuffer","BigInt","subarray","bigintToAddress","buf","Address","parse","toString","parseTonAddress","address","startsWith","_isBase58","isBase58","_isHex","base58","decode","err","console","error","message","_addressToNotPaddedHex","hash","addressToHex","toLowerCase","addressToBigInt","compareAddresses","addressA","addressB","equals","numberOfLeadingZeroBitsInAddress"],"mappings":";;;;;;;AASA,IAAMA,cAAAA,mBAAiB,MAAA,CAAA,CACnBC,KAAAA,EACAC,yBAAAA,GAA4B,EAAA,KAAE;AAE9B,EAAA,IAAI,OAAOD,UAAU,QAAA,EAAU;AAC3B,IAAA,IAAI,CAACE,WAAAA,CAAYF,KAAAA,CAAAA,EAAQ;AACrB,MAAA,MAAM,IAAIG,MAAM,8BAAA,CAAA;AACpB,IAAA;AACA,IAAA,IAAIC,GAAAA,GAAMC,OAAOL,KAAAA,CAAAA;AACjB,IAAA,IAAII,GAAAA,CAAIE,MAAAA,GAAS,CAAA,KAAM,CAAA,EAAG;AACtBF,MAAAA,GAAAA,GAAM,GAAA,GAAMA,GAAAA;AAChB,IAAA;AACAJ,IAAAA,KAAAA,GAAQO,cAAAA,CAAeC,MAAAA,CAAOC,IAAAA,CAAKL,GAAAA,EAAK,KAAA,CAAA,CAAA;AAC5C,EAAA;AACA,EAAA,IAAIJ,iBAAiBU,UAAAA,EAAY;AAC7BV,IAAAA,KAAAA,GAAQO,cAAAA,CAAeC,MAAAA,CAAOC,IAAAA,CAAKT,KAAAA,CAAAA,CAAAA;AACvC,EAAA;AACA,EAAA,MAAMW,EAAAA,GAAKC,mBAAAA,CAAoBC,MAAAA,CAAOb,KAAAA,GAAQC,yBAAAA,CAAAA;AAE9C,EAAA,OAAOU,EAAAA,CAAGG,SAAS,GAAC,CAAA;AACxB,CAAA,EApBuB,gBAAA,CAAA;AAsBhB,IAAMC,eAAAA,2BAAmBf,KAAAA,KAAAA;AAC5B,EAAA,MAAMgB,GAAAA,GAAMjB,eAAeC,KAAAA,CAAAA;AAC3B,EAAA,OAAOiB,QAAQC,KAAAA,CAAM,CAAA,EAAA,EAAKF,IAAIG,QAAAA,CAAS,KAAA,CAAA,CAAA,CAAQ,CAAA;AACnD,CAAA,EAH+B,iBAAA;AAKxB,IAAMC,eAAAA,2BAAmBC,OAAAA,KAAAA;AAC5B,EAAA,IAAIA,mBAAmBJ,OAAAA,EAAS;AAC5B,IAAA,OAAOI,OAAAA;AACX,EAAA;AAEA,EAAA,IAAI;AACA,IAAA,IAAI,OAAOA,OAAAA,KAAY,QAAA,IAAY,OAAOA,YAAY,QAAA,EAAU;AAC5D,MAAA,OAAON,eAAAA,CAAgBF,MAAAA,CAAOQ,OAAAA,CAAAA,CAAAA;AAClC,IAAA;AAEA,IAAA,IAAIA,OAAAA,CAAQC,UAAAA,CAAW,IAAA,CAAA,EAAO;AAE1B,MAAA,OAAOP,eAAAA,CAAgBF,MAAAA,CAAOQ,OAAAA,CAAAA,CAAAA;AAClC,IAAA;AAEA,IAAA,IAAI;AACA,MAAA,OAAOJ,OAAAA,CAAQC,MAAMG,OAAAA,CAAAA;IACzB,CAAA,CAAA,MAAQ;AAEJ,MAAA,MAAME,SAAAA,GAAYC,SAASH,OAAAA,CAAAA;AAC3B,MAAA,MAAMI,MAAAA,GAASvB,YAAYmB,OAAAA,CAAAA;AAI3B,MAAA,IAAII,MAAAA,EAAQ;AACR,QAAA,OAAOV,eAAAA,CAAgBF,MAAAA,CAAO,CAAA,EAAA,EAAKQ,OAAAA,EAAS,CAAA,CAAA;AAChD,MAAA;AAEA,MAAA,IAAIE,SAAAA,EAAW;AACX,QAAA,OAAOR,eAAAA,CACHF,MAAAA,CAAO,CAAA,EAAA,EAAKL,MAAAA,CAAOC,KAAKiB,MAAAA,CAAOC,MAAAA,CAAON,OAAAA,CAAAA,CAAAA,CAAUF,QAAAA,CAAS,KAAA,CAAA,EAAQ,CAAA,CAAA;AAEzE,MAAA;AAGA,MAAA,MAAM,IAAIhB,KAAAA,CAAM,CAAA,YAAA,EAAekB,OAAAA,CAAAA,yCAAAA,CAAkD,CAAA;AACrF,IAAA;AACJ,EAAA,CAAA,CAAA,OAASO,GAAAA,EAAU;AACfC,IAAAA,OAAAA,CAAQC,MAAM,uBAAA,EAAyB;AACnCT,MAAAA,OAAAA;AACAS,MAAAA,KAAAA,EAAOF,KAAKG,OAAAA,IAAWH;KAC3B,CAAA;AACA,IAAA,MAAMA,GAAAA;AACV,EAAA;AACJ,CAAA,EA5C+B,iBAAA;AA8C/B,IAAMI,sBAAAA,2BAA0BX,OAAAA,KAAAA;AAC5B,EAAA,OAAO,KAAKD,eAAAA,CAAgBC,OAAAA,EAASY,IAAAA,CAAKd,QAAAA,CAAS,KAAA,CAAA,CAAA,CAAA;AACvD,CAAA,EAF+B,wBAAA,CAAA;AAIxB,IAAMe,YAAAA,2BAAgBb,OAAAA,KAAAA;AACzB,EAAA,OAAO,CAAA,EAAA,EAAKtB,cAAAA,CAAeiC,sBAAAA,CAAuBX,OAAAA,CAAAA,EAAUF,QAAAA,CAAS,KAAA,CAAA,CAAOgB,WAAAA,EAAW,CAAA,CAAA;AAC3F,CAAA,EAF4B,cAAA;AAIrB,IAAMC,eAAAA,2BAAmBf,OAAAA,KAAAA;AAC5B,EAAA,OAAOR,MAAAA,CAAOmB,sBAAAA,CAAuBX,OAAAA,CAAAA,CAAAA;AACzC,CAAA,EAF+B,iBAAA;AAIxB,IAAMgB,gBAAAA,mBAAmB,MAAA,CAAA,CAACC,QAAAA,EAA2BC,QAAAA,KAAAA;AACxD,EAAA,OAAOnB,gBAAgBkB,QAAAA,CAAAA,CAAUE,MAAAA,CAAOpB,eAAAA,CAAgBmB,QAAAA,CAAAA,CAAAA;AAC5D,CAAA,EAFgC,kBAAA;AAQzB,IAAME,gCAAAA,2BAAoCpB,OAAAA,KAAAA;AAC7C,EAAA,OAAO,KAAK,CAAA,GAAIe,eAAAA,CAAgBf,OAAAA,CAAAA,CAASF,QAAAA,CAAS,CAAA,CAAA,CAAGb,MAAAA;AACzD,CAAA,EAFgD,kCAAA","file":"index.js","sourcesContent":["import { Address } from '@ton/ton';\nimport base58 from 'bs58';\n\nimport type { HexString } from '@layerzerolabs/common-chain-model';\nimport { isBase58, isHexString, trim0x } from '@layerzerolabs/common-encoding-utils';\nimport { bigintToSizedBuffer, bufferToBigInt } from '@layerzerolabs/ton-sdk-tools';\n\nexport type AddressTypeLike = Address | string | bigint;\n\nconst to32ByteBuffer = (\n    value: bigint | number | string | Uint8Array,\n    maxIntermediateBufferSize = 66,\n): Buffer => {\n    if (typeof value === 'string') {\n        if (!isHexString(value)) {\n            throw new Error('only hex string is supported');\n        }\n        let hex = trim0x(value);\n        if (hex.length % 2 !== 0) {\n            hex = '0' + hex;\n        }\n        value = bufferToBigInt(Buffer.from(hex, 'hex'));\n    }\n    if (value instanceof Uint8Array) {\n        value = bufferToBigInt(Buffer.from(value));\n    }\n    const bf = bigintToSizedBuffer(BigInt(value), maxIntermediateBufferSize);\n    // trim from the left, keep the right 32 bytes\n    return bf.subarray(-32);\n};\n\nexport const bigintToAddress = (value: bigint): Address => {\n    const buf = to32ByteBuffer(value);\n    return Address.parse(`0:${buf.toString('hex')}`);\n};\n\nexport const parseTonAddress = (address: AddressTypeLike): Address => {\n    if (address instanceof Address) {\n        return address;\n    }\n\n    try {\n        if (typeof address === 'bigint' || typeof address === 'number') {\n            return bigintToAddress(BigInt(address));\n        }\n\n        if (address.startsWith('0x')) {\n            // If it's a hex address format it to ton format\n            return bigintToAddress(BigInt(address));\n        }\n\n        try {\n            return Address.parse(address);\n        } catch {\n            //at this point, our address is either hex without a '0x', or base58\n            const _isBase58 = isBase58(address);\n            const _isHex = isHexString(address);\n\n            //this includes the case where the address is both base58 and hex\n            //but nearly every address generated this way is hex (only 1/(~5.5e12) are b58)\n            if (_isHex) {\n                return bigintToAddress(BigInt(`0x${address}`));\n            }\n\n            if (_isBase58) {\n                return bigintToAddress(\n                    BigInt(`0x${Buffer.from(base58.decode(address)).toString('hex')}`),\n                );\n            }\n\n            //this is the case where the address is invalid in any encoding\n            throw new Error(`The address ${address} cannot be decoded as TON, hex, or base58`);\n        }\n    } catch (err: any) {\n        console.error('Error parsing address', {\n            address,\n            error: err?.message ?? err,\n        });\n        throw err;\n    }\n};\n\nconst _addressToNotPaddedHex = (address: AddressTypeLike) => {\n    return `0x${parseTonAddress(address).hash.toString('hex')}`;\n};\n\nexport const addressToHex = (address: AddressTypeLike): HexString => {\n    return `0x${to32ByteBuffer(_addressToNotPaddedHex(address)).toString('hex').toLowerCase()}`;\n};\n\nexport const addressToBigInt = (address: AddressTypeLike) => {\n    return BigInt(_addressToNotPaddedHex(address));\n};\n\nexport const compareAddresses = (addressA: AddressTypeLike, addressB: AddressTypeLike) => {\n    return parseTonAddress(addressA).equals(parseTonAddress(addressB));\n};\n\n/**\n * Since toString(2) does not include leading zeros, we can calculate the leading zeros by subtracting\n * the total length of address in binary from the total length of addresses in TON in bits (32 bytes * 8)\n */\nexport const numberOfLeadingZeroBitsInAddress = (address: AddressTypeLike) => {\n    return 32 * 8 - addressToBigInt(address).toString(2).length;\n};\n"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@layerzerolabs/address-utils-ton",
+  "version": "0.2.66",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "require": "./dist/index.cjs",
+    "import": "./dist/index.js",
+    "default": "./dist/index.cjs"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@layerzerolabs/ton-sdk-tools": "3.0.167",
+    "@ton/ton": "npm:@layerzerolabs/ton@15.1.0-rc.9",
+    "bs58": "^5.0.0",
+    "@layerzerolabs/common-encoding-utils": "0.2.66",
+    "@layerzerolabs/common-chain-model": "0.2.66"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "vitest": "^3.2.3",
+    "@layerzerolabs/typescript-configuration": "0.2.66",
+    "@layerzerolabs/tsup-configuration": "0.2.66"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)",
+    "test": "vitest --run --pass-with-no-tests --typecheck"
+  }
+}

package/src/index.ts

@@ -0,0 +1,105 @@
+import { Address } from '@ton/ton';
+import base58 from 'bs58';
+
+import type { HexString } from '@layerzerolabs/common-chain-model';
+import { isBase58, isHexString, trim0x } from '@layerzerolabs/common-encoding-utils';
+import { bigintToSizedBuffer, bufferToBigInt } from '@layerzerolabs/ton-sdk-tools';
+
+export type AddressTypeLike = Address | string | bigint;
+
+const to32ByteBuffer = (
+    value: bigint | number | string | Uint8Array,
+    maxIntermediateBufferSize = 66,
+): Buffer => {
+    if (typeof value === 'string') {
+        if (!isHexString(value)) {
+            throw new Error('only hex string is supported');
+        }
+        let hex = trim0x(value);
+        if (hex.length % 2 !== 0) {
+            hex = '0' + hex;
+        }
+        value = bufferToBigInt(Buffer.from(hex, 'hex'));
+    }
+    if (value instanceof Uint8Array) {
+        value = bufferToBigInt(Buffer.from(value));
+    }
+    const bf = bigintToSizedBuffer(BigInt(value), maxIntermediateBufferSize);
+    // trim from the left, keep the right 32 bytes
+    return bf.subarray(-32);
+};
+
+export const bigintToAddress = (value: bigint): Address => {
+    const buf = to32ByteBuffer(value);
+    return Address.parse(`0:${buf.toString('hex')}`);
+};
+
+export const parseTonAddress = (address: AddressTypeLike): Address => {
+    if (address instanceof Address) {
+        return address;
+    }
+
+    try {
+        if (typeof address === 'bigint' || typeof address === 'number') {
+            return bigintToAddress(BigInt(address));
+        }
+
+        if (address.startsWith('0x')) {
+            // If it's a hex address format it to ton format
+            return bigintToAddress(BigInt(address));
+        }
+
+        try {
+            return Address.parse(address);
+        } catch {
+            //at this point, our address is either hex without a '0x', or base58
+            const _isBase58 = isBase58(address);
+            const _isHex = isHexString(address);
+
+            //this includes the case where the address is both base58 and hex
+            //but nearly every address generated this way is hex (only 1/(~5.5e12) are b58)
+            if (_isHex) {
+                return bigintToAddress(BigInt(`0x${address}`));
+            }
+
+            if (_isBase58) {
+                return bigintToAddress(
+                    BigInt(`0x${Buffer.from(base58.decode(address)).toString('hex')}`),
+                );
+            }
+
+            //this is the case where the address is invalid in any encoding
+            throw new Error(`The address ${address} cannot be decoded as TON, hex, or base58`);
+        }
+    } catch (err: any) {
+        console.error('Error parsing address', {
+            address,
+            error: err?.message ?? err,
+        });
+        throw err;
+    }
+};
+
+const _addressToNotPaddedHex = (address: AddressTypeLike) => {
+    return `0x${parseTonAddress(address).hash.toString('hex')}`;
+};
+
+export const addressToHex = (address: AddressTypeLike): HexString => {
+    return `0x${to32ByteBuffer(_addressToNotPaddedHex(address)).toString('hex').toLowerCase()}`;
+};
+
+export const addressToBigInt = (address: AddressTypeLike) => {
+    return BigInt(_addressToNotPaddedHex(address));
+};
+
+export const compareAddresses = (addressA: AddressTypeLike, addressB: AddressTypeLike) => {
+    return parseTonAddress(addressA).equals(parseTonAddress(addressB));
+};
+
+/**
+ * Since toString(2) does not include leading zeros, we can calculate the leading zeros by subtracting
+ * the total length of address in binary from the total length of addresses in TON in bits (32 bytes * 8)
+ */
+export const numberOfLeadingZeroBitsInAddress = (address: AddressTypeLike) => {
+    return 32 * 8 - addressToBigInt(address).toString(2).length;
+};

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "extends": "@layerzerolabs/typescript-configuration/tsconfig.base.json",
+    "compilerOptions": {
+        "rootDir": "./src",
+        "outDir": "./dist",
+        "strictPropertyInitialization": false,
+        "noUnusedLocals": false,
+        "noUnusedParameters": false,
+        "jsx": "react-jsx"
+    },
+    "exclude": [
+        "node_modules",
+        "**/__mocks__/*",
+        "**/__tests__/*",
+        "**/*.spec.ts",
+        "**/*.test.ts",
+        "dist"
+    ],
+    "include": ["src/**/*"]
+}

package/tsup.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsup';
+
+import { createPackageTsupConfig } from '@layerzerolabs/tsup-configuration';
+
+export default defineConfig(({ watch }) => ({
+    ...createPackageTsupConfig(),
+    clean: !watch,
+}));