@moonbeam-network/xcm-utils 1.0.0-dev.28 → 1.0.0-dev.280

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2022 PureStake
+Copyright 2024 Moonbeam Foundation
 
 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:
 

package/README.md

@@ -1,9 +1,20 @@
-![Moonbeam](https://docs.moonbeam.network/images/builders/interoperability/xcm/sdk/xcm-sdk-banner.png)
+The Utils package contains the utility functions for the Moonbeam XCM SDK and MRL SDK.
 
-The Moonbeam XCM SDK enables developers to easily deposit and withdraw assets to Moonbeam/Moonriver from the relay chain and other parachains in the Polkadot/Kusama ecosystem. With the SDK, you don't need to worry about determining the multilocation of the origin or destination assets or which extrinsics are used on which networks to send XCM transfers. To deposit or withdraw assets, you simply define the asset and origin chain you want to deposit from or withdraw back to, along with the sending account's signer, and the amount to send.
+# Documentation for the Moonbeam XCM SDK
 
-# Documentation
+## v3 (current)
 
-## v1 (current)
+### Usage
 
-- TODO: (coming soon)
+- [XCM SDK](https://moonbeam-foundation.github.io/xcm-sdk/latest/example-usage/xcm)
+- [MRL SDK](https://moonbeam-foundation.github.io/xcm-sdk/latest/example-usage/mrl)
+
+### References
+
+- [XCM SDK](https://moonbeam-foundation.github.io/xcm-sdk/latest/reference/xcm)
+- [MRL SDK](https://moonbeam-foundation.github.io/xcm-sdk/latest/reference/mrl)
+
+## v2 (previous)
+
+- [usage](https://moonbeam-foundation.github.io/xcm-sdk/v2/example-usage)
+- [references](https://moonbeam-foundation.github.io/xcm-sdk/v2/reference/interfaces)

package/build/index.d.ts

@@ -1,35 +1,45 @@
 import { RoundingMode } from 'big.js';
 import { ApiPromise } from '@polkadot/api';
 
-declare function formatAssetIdToERC20(id: string): string;
+declare function isHexString(asset: unknown): boolean;
+declare function isEthAddress(address: string): boolean;
 
-declare function toDecimal(
-  number: bigint | number | string,
-  decimals: number,
-  maxDecimal?: number,
-  roundType?: RoundingMode,
-): string;
-declare function toBigInt(
-  amount: bigint | string | number,
-  decimals: number,
-): bigint;
-declare function convertDecimals(
-  number: string | bigint,
-  decimals: number,
-  targetDecimals: number,
-): bigint;
-declare function hasDecimalOverflow(
-  fl: number | string,
-  maxDecimal: number,
-): boolean;
+declare function formatAssetIdToERC20(id: string): string;
+declare function convertAddressTo32Bytes(address: string): string;
 
-declare function getPolkadotApi(ws: string): Promise<ApiPromise>;
+declare function toDecimal(number: bigint | number | string, decimals: number, maxDecimal?: number, roundType?: RoundingMode): string;
+declare function toBigInt(amount: bigint | string | number, decimals: number): bigint;
+declare function convertDecimals(number: string | bigint, decimals: number, targetDecimals: number): bigint;
+declare function hasDecimalOverflow(fl: number | string, maxDecimal: number): boolean;
 
-export {
-  convertDecimals,
-  formatAssetIdToERC20,
-  getPolkadotApi,
-  hasDecimalOverflow,
-  toBigInt,
-  toDecimal,
+/**
+ * reference: https://github.com/Moonsong-Labs/xcm-tools/blob/main/scripts/calculate-sovereign-account.ts
+ */
+declare function getSovereignAccountAddresses(paraId: number): {
+    generic: string;
+    moonbeam: string;
+    relay: string;
+};
+/**
+ * reference: https://github.com/Moonsong-Labs/xcm-tools/blob/main/scripts/calculate-multilocation-derivative-account.ts
+ */
+declare function getMultilocationDerivedAddresses({ paraId, address, isParents, }: {
+    paraId?: number;
+    address: string;
+    isParents?: boolean;
+}): {
+    address20: `0x${string}`;
+    address32: `0x${string}`;
 };
+
+declare enum MRLTypes {
+    XcmVersionedMultiLocation = "XcmVersionedMultiLocation",
+    XcmVersionedLocation = "XcmVersionedLocation",
+    XcmRoutingUserAction = "XcmRoutingUserAction",
+    VersionedUserAction = "VersionedUserAction"
+}
+declare function getPolkadotApi(ws: string | string[]): Promise<ApiPromise>;
+
+declare function getPolkadotAppsUrl(ws: string): string;
+
+export { MRLTypes, convertAddressTo32Bytes, convertDecimals, formatAssetIdToERC20, getMultilocationDerivedAddresses, getPolkadotApi, getPolkadotAppsUrl, getSovereignAccountAddresses, hasDecimalOverflow, isEthAddress, isHexString, toBigInt, toDecimal };

package/build/index.mjs

@@ -1,2 +1,162 @@
-function b(t){if(t.startsWith("0x"))return t;if(!/^\d{38,39}$/.test(t))throw new Error(`Asset id: ${t} must be a string and have 38-39 digits`);return`0xffffffff${BigInt(t).toString(16).padStart(32,"0")}`}import i from"big.js";i.NE=-18;function p(t,r,n=6,o){let s=i(t.toString().replace(/[^0-9]/g,"")),m=i(10).pow(r);return s.div(m).round(n,o).toString()}function u(t,r){if(typeof t=="bigint")return t;let n=i(10).pow(r),o=i(t).mul(n);return BigInt(o.toFixed(0,i.roundDown))}function h(t,r,n){let o=p(t,r,r);return u(o.toString(),n)}function A(t,r){let n=t.toString().split(".");return n.length>1&&n[1].length>r}import{ApiPromise as g,WsProvider as f}from"@polkadot/api";import{typesBundle as c}from"@polkadot/apps-config";import a from"lru-cache";var e=new a({max:20,dispose:async t=>{let r=await t;r.isConnected&&r.disconnect()}});async function E(t){let r=e.get(t)||g.create({noInitWarn:!0,provider:new f(t),typesBundle:c});e.set(t,r);let n=await r;return await n.isReady,n}export{h as convertDecimals,b as formatAssetIdToERC20,E as getPolkadotApi,A as hasDecimalOverflow,u as toBigInt,p as toDecimal};
+// src/format/address.ts
+function isHexString(asset) {
+  return typeof asset === "string" && asset.startsWith("0x");
+}
+function isEthAddress(address) {
+  return address.length === 42 && address.startsWith("0x");
+}
+
+// src/format/asset.ts
+function formatAssetIdToERC20(id) {
+  if (id.startsWith("0x")) {
+    return id;
+  }
+  if (!/^\d{38,39}$/.test(id)) {
+    throw new Error(`Asset id: ${id} must be a string and have 38-39 digits`);
+  }
+  return `0xffffffff${BigInt(id).toString(16).padStart(32, "0")}`;
+}
+function convertAddressTo32Bytes(address) {
+  if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
+    throw new Error(`Invalid address: ${address}`);
+  }
+  return `0x000000000000000000000000${address.substring(2)}`;
+}
+
+// src/numbers/decimals.ts
+import Big from "big.js";
+Big.NE = -18;
+function toDecimal(number, decimals, maxDecimal = 6, roundType) {
+  const dividend = Big(number.toString().replace(/[^0-9]/g, ""));
+  const divisor = Big(10).pow(decimals);
+  const result = dividend.div(divisor).round(maxDecimal, roundType);
+  return result.toString();
+}
+function toBigInt(amount, decimals) {
+  if (typeof amount === "bigint") {
+    return amount;
+  }
+  const multiplier = Big(10).pow(decimals);
+  const result = Big(amount).mul(multiplier);
+  return BigInt(result.toFixed(0, Big.roundDown));
+}
+function convertDecimals(number, decimals, targetDecimals) {
+  const decimalNumber = toDecimal(number, decimals, decimals);
+  return toBigInt(decimalNumber.toString(), targetDecimals);
+}
+function hasDecimalOverflow(fl, maxDecimal) {
+  const parts = fl.toString().split(".");
+  return parts.length > 1 && parts[1].length > maxDecimal;
+}
+
+// src/polkadot/polkadot.address.ts
+import {
+  bnToU8a,
+  compactToU8a,
+  hexToU8a,
+  stringToU8a,
+  u8aToHex
+} from "@polkadot/util";
+import { blake2AsU8a, decodeAddress } from "@polkadot/util-crypto";
+function getSovereignAccountAddresses(paraId) {
+  const paraIdU8a = bnToU8a(paraId, { bitLength: 32 });
+  const relay = u8aToHex(
+    new Uint8Array([...stringToU8a("para"), ...paraIdU8a])
+  ).padEnd(66, "0");
+  const generic = u8aToHex(
+    new Uint8Array([...stringToU8a("sibl"), ...paraIdU8a])
+  ).padEnd(66, "0");
+  const moonbeam = generic.slice(0, 42);
+  return {
+    generic,
+    moonbeam,
+    relay
+  };
+}
+function getMultilocationDerivedAddresses({
+  paraId,
+  address,
+  isParents = false
+}) {
+  const parents = isParents ? 1 : 0;
+  const accType = isEthAddress(address) ? "AccountKey20" : "AccountId32";
+  const decodedAddress = isEthAddress(address) ? hexToU8a(address) : decodeAddress(address);
+  const family = parents === 0 && paraId ? "ChildChain" : parents === 1 && !paraId ? "ParentChain" : "SiblingChain";
+  const blake = blake2AsU8a(
+    new Uint8Array([
+      ...stringToU8a(family),
+      ...paraId ? compactToU8a(paraId) : [],
+      ...compactToU8a(accType.length + (isEthAddress(address) ? 20 : 32)),
+      ...stringToU8a(accType),
+      ...decodedAddress
+    ])
+  );
+  const address20 = u8aToHex(blake.slice(0, 20));
+  const address32 = u8aToHex(blake.slice(0, 32));
+  return {
+    address20,
+    address32
+  };
+}
+
+// src/polkadot/polkadot.api.ts
+import { ApiPromise, WsProvider } from "@polkadot/api";
+import { typesBundle } from "@polkadot/apps-config";
+import { LRUCache } from "lru-cache";
+var MRLTypes = /* @__PURE__ */ ((MRLTypes2) => {
+  MRLTypes2["XcmVersionedMultiLocation"] = "XcmVersionedMultiLocation";
+  MRLTypes2["XcmVersionedLocation"] = "XcmVersionedLocation";
+  MRLTypes2["XcmRoutingUserAction"] = "XcmRoutingUserAction";
+  MRLTypes2["VersionedUserAction"] = "VersionedUserAction";
+  return MRLTypes2;
+})(MRLTypes || {});
+var cache = new LRUCache({
+  max: 20,
+  dispose: async (promise) => {
+    const api = await promise;
+    if (api.isConnected) {
+      api.disconnect();
+    }
+  }
+});
+async function getPolkadotApi(ws) {
+  const key = Array.isArray(ws) ? ws.join(";") : ws;
+  const promise = cache.get(key) || ApiPromise.create({
+    noInitWarn: true,
+    provider: new WsProvider(ws),
+    types: {
+      ["XcmRoutingUserAction" /* XcmRoutingUserAction */]: {
+        destination: "XcmVersionedLocation" /* XcmVersionedLocation */
+      },
+      ["VersionedUserAction" /* VersionedUserAction */]: {
+        _enum: { V1: "XcmRoutingUserAction" /* XcmRoutingUserAction */ }
+      }
+    },
+    typesBundle
+  });
+  cache.set(key, promise);
+  const api = await promise;
+  await api.isReady;
+  return api;
+}
+
+// src/polkadot/polkadot.apps.ts
+function getPolkadotAppsUrl(ws) {
+  return `https://polkadot.js.org/apps/?rpc=${encodeURIComponent(ws)}#/explorer/query`;
+}
+export {
+  MRLTypes,
+  convertAddressTo32Bytes,
+  convertDecimals,
+  formatAssetIdToERC20,
+  getMultilocationDerivedAddresses,
+  getPolkadotApi,
+  getPolkadotAppsUrl,
+  getSovereignAccountAddresses,
+  hasDecimalOverflow,
+  isEthAddress,
+  isHexString,
+  toBigInt,
+  toDecimal
+};
 //# sourceMappingURL=index.mjs.map

package/build/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/format/asset.ts","../src/numbers/decimals.ts","../src/polkadot/polkadot.api.ts"],"sourcesContent":["export function formatAssetIdToERC20(id: string) {\n  if (id.startsWith('0x')) {\n    return id;\n  }\n\n  if (!/^\\d{38,39}$/.test(id)) {\n    throw new Error(`Asset id: ${id} must be a string and have 38-39 digits`);\n  }\n\n  return `0xffffffff${BigInt(id).toString(16).padStart(32, '0')}`;\n}\n","import Big, { RoundingMode } from 'big.js';\n\nBig.NE = -18;\n\nexport function toDecimal(\n  number: bigint | number | string,\n  decimals: number,\n  maxDecimal = 6,\n  roundType?: RoundingMode,\n): string {\n  const dividend = Big(number.toString().replace(/[^0-9]/g, ''));\n  const divisor = Big(10).pow(decimals);\n  const result = dividend.div(divisor).round(maxDecimal, roundType);\n\n  return result.toString();\n}\n\nexport function toBigInt(\n  amount: bigint | string | number,\n  decimals: number,\n): bigint {\n  if (typeof amount === 'bigint') {\n    return amount;\n  }\n\n  const multiplier = Big(10).pow(decimals);\n  const result = Big(amount).mul(multiplier);\n\n  return BigInt(result.toFixed(0, Big.roundDown));\n}\n\nexport function convertDecimals(\n  number: string | bigint,\n  decimals: number,\n  targetDecimals: number,\n): bigint {\n  const decimalNumber = toDecimal(number, decimals, decimals);\n\n  return toBigInt(decimalNumber.toString(), targetDecimals);\n}\n\nexport function hasDecimalOverflow(fl: number | string, maxDecimal: number) {\n  const parts = fl.toString().split('.');\n  return parts.length > 1 && parts[1].length > maxDecimal;\n}\n","import { ApiPromise, WsProvider } from '@polkadot/api';\nimport { typesBundle } from '@polkadot/apps-config';\nimport LRU from 'lru-cache';\n\nconst cache = new LRU<string, Promise<ApiPromise>>({\n  max: 20,\n  // eslint-disable-next-line sort-keys\n  dispose: async (promise: Promise<ApiPromise>) => {\n    const api = await promise;\n\n    if (api.isConnected) {\n      api.disconnect();\n    }\n  },\n});\n\nexport async function getPolkadotApi(ws: string): Promise<ApiPromise> {\n  const promise =\n    cache.get(ws) ||\n    ApiPromise.create({\n      noInitWarn: true,\n      provider: new WsProvider(ws),\n      typesBundle,\n    });\n\n  cache.set(ws, promise);\n\n  const api = await promise;\n\n  await api.isReady;\n\n  return api;\n}\n"],"mappings":"AAAO,SAASA,EAAqBC,EAAY,CAC/C,GAAIA,EAAG,WAAW,IAAI,EACpB,OAAOA,EAGT,GAAI,CAAC,cAAc,KAAKA,CAAE,EACxB,MAAM,IAAI,MAAM,aAAaA,0CAA2C,EAG1E,MAAO,aAAa,OAAOA,CAAE,EAAE,SAAS,EAAE,EAAE,SAAS,GAAI,GAAG,GAC9D,CCVA,OAAOC,MAA2B,SAElCA,EAAI,GAAK,IAEF,SAASC,EACdC,EACAC,EACAC,EAAa,EACbC,EACQ,CACR,IAAMC,EAAWN,EAAIE,EAAO,SAAS,EAAE,QAAQ,UAAW,EAAE,CAAC,EACvDK,EAAUP,EAAI,EAAE,EAAE,IAAIG,CAAQ,EAGpC,OAFeG,EAAS,IAAIC,CAAO,EAAE,MAAMH,EAAYC,CAAS,EAElD,SAAS,CACzB,CAEO,SAASG,EACdC,EACAN,EACQ,CACR,GAAI,OAAOM,GAAW,SACpB,OAAOA,EAGT,IAAMC,EAAaV,EAAI,EAAE,EAAE,IAAIG,CAAQ,EACjCQ,EAASX,EAAIS,CAAM,EAAE,IAAIC,CAAU,EAEzC,OAAO,OAAOC,EAAO,QAAQ,EAAGX,EAAI,SAAS,CAAC,CAChD,CAEO,SAASY,EACdV,EACAC,EACAU,EACQ,CACR,IAAMC,EAAgBb,EAAUC,EAAQC,EAAUA,CAAQ,EAE1D,OAAOK,EAASM,EAAc,SAAS,EAAGD,CAAc,CAC1D,CAEO,SAASE,EAAmBC,EAAqBZ,EAAoB,CAC1E,IAAMa,EAAQD,EAAG,SAAS,EAAE,MAAM,GAAG,EACrC,OAAOC,EAAM,OAAS,GAAKA,EAAM,CAAC,EAAE,OAASb,CAC/C,CC5CA,OAAS,cAAAc,EAAY,cAAAC,MAAkB,gBACvC,OAAS,eAAAC,MAAmB,wBAC5B,OAAOC,MAAS,YAEhB,IAAMC,EAAQ,IAAID,EAAiC,CACjD,IAAK,GAEL,QAAS,MAAOE,GAAiC,CAC/C,IAAMC,EAAM,MAAMD,EAEdC,EAAI,aACNA,EAAI,WAAW,CAEnB,CACF,CAAC,EAED,eAAsBC,EAAeC,EAAiC,CACpE,IAAMH,EACJD,EAAM,IAAII,CAAE,GACZR,EAAW,OAAO,CAChB,WAAY,GACZ,SAAU,IAAIC,EAAWO,CAAE,EAC3B,YAAAN,CACF,CAAC,EAEHE,EAAM,IAAII,EAAIH,CAAO,EAErB,IAAMC,EAAM,MAAMD,EAElB,aAAMC,EAAI,QAEHA,CACT","names":["formatAssetIdToERC20","id","Big","toDecimal","number","decimals","maxDecimal","roundType","dividend","divisor","toBigInt","amount","multiplier","result","convertDecimals","targetDecimals","decimalNumber","hasDecimalOverflow","fl","parts","ApiPromise","WsProvider","typesBundle","LRU","cache","promise","api","getPolkadotApi","ws"]}
+{"version":3,"sources":["../src/format/address.ts","../src/format/asset.ts","../src/numbers/decimals.ts","../src/polkadot/polkadot.address.ts","../src/polkadot/polkadot.api.ts","../src/polkadot/polkadot.apps.ts"],"sourcesContent":["export function isHexString(asset: unknown): boolean {\n  return typeof asset === 'string' && asset.startsWith('0x');\n}\n\nexport function isEthAddress(address: string): boolean {\n  return address.length === 42 && address.startsWith('0x');\n}\n","export function formatAssetIdToERC20(id: string) {\n  if (id.startsWith('0x')) {\n    return id;\n  }\n\n  if (!/^\\d{38,39}$/.test(id)) {\n    throw new Error(`Asset id: ${id} must be a string and have 38-39 digits`);\n  }\n\n  return `0xffffffff${BigInt(id).toString(16).padStart(32, '0')}`;\n}\n\nexport function convertAddressTo32Bytes(address: string): string {\n  if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {\n    throw new Error(`Invalid address: ${address}`);\n  }\n\n  return `0x000000000000000000000000${address.substring(2)}`;\n}\n","import Big, { type RoundingMode } from 'big.js';\n\nBig.NE = -18;\n\nexport function toDecimal(\n  number: bigint | number | string,\n  decimals: number,\n  maxDecimal = 6,\n  roundType?: RoundingMode,\n): string {\n  const dividend = Big(number.toString().replace(/[^0-9]/g, ''));\n  const divisor = Big(10).pow(decimals);\n  const result = dividend.div(divisor).round(maxDecimal, roundType);\n\n  return result.toString();\n}\n\nexport function toBigInt(\n  amount: bigint | string | number,\n  decimals: number,\n): bigint {\n  if (typeof amount === 'bigint') {\n    return amount;\n  }\n\n  const multiplier = Big(10).pow(decimals);\n  const result = Big(amount).mul(multiplier);\n\n  return BigInt(result.toFixed(0, Big.roundDown));\n}\n\nexport function convertDecimals(\n  number: string | bigint,\n  decimals: number,\n  targetDecimals: number,\n): bigint {\n  const decimalNumber = toDecimal(number, decimals, decimals);\n\n  return toBigInt(decimalNumber.toString(), targetDecimals);\n}\n\nexport function hasDecimalOverflow(fl: number | string, maxDecimal: number) {\n  const parts = fl.toString().split('.');\n  return parts.length > 1 && parts[1].length > maxDecimal;\n}\n","import {\n  bnToU8a,\n  compactToU8a,\n  hexToU8a,\n  stringToU8a,\n  u8aToHex,\n} from '@polkadot/util';\nimport { blake2AsU8a, decodeAddress } from '@polkadot/util-crypto';\nimport { isEthAddress } from '../format';\n\n/**\n * reference: https://github.com/Moonsong-Labs/xcm-tools/blob/main/scripts/calculate-sovereign-account.ts\n */\n\nexport function getSovereignAccountAddresses(paraId: number) {\n  const paraIdU8a = bnToU8a(paraId, { bitLength: 32 });\n  const relay = u8aToHex(\n    new Uint8Array([...stringToU8a('para'), ...paraIdU8a]),\n  ).padEnd(66, '0');\n  const generic = u8aToHex(\n    new Uint8Array([...stringToU8a('sibl'), ...paraIdU8a]),\n  ).padEnd(66, '0');\n  const moonbeam = generic.slice(0, 42);\n\n  return {\n    generic,\n    moonbeam,\n    relay,\n  };\n}\n\n/**\n * reference: https://github.com/Moonsong-Labs/xcm-tools/blob/main/scripts/calculate-multilocation-derivative-account.ts\n */\n\nexport function getMultilocationDerivedAddresses({\n  paraId,\n  address,\n  isParents = false,\n}: {\n  paraId?: number;\n  address: string;\n  isParents?: boolean;\n}) {\n  const parents = isParents ? 1 : 0;\n  const accType = isEthAddress(address) ? 'AccountKey20' : 'AccountId32';\n  const decodedAddress = isEthAddress(address)\n    ? hexToU8a(address)\n    : decodeAddress(address);\n\n  // Describe Family\n  // https://github.com/paritytech/polkadot/blob/master/xcm/xcm-builder/src/location_conversion.rs#L96-L118\n  const family =\n    parents === 0 && paraId\n      ? 'ChildChain'\n      : parents === 1 && !paraId\n        ? 'ParentChain'\n        : 'SiblingChain';\n\n  const blake = blake2AsU8a(\n    new Uint8Array([\n      ...stringToU8a(family),\n      ...(paraId ? compactToU8a(paraId) : []),\n      ...compactToU8a(accType.length + (isEthAddress(address) ? 20 : 32)),\n      ...stringToU8a(accType),\n      ...decodedAddress,\n    ]),\n  );\n\n  const address20 = u8aToHex(blake.slice(0, 20));\n  const address32 = u8aToHex(blake.slice(0, 32));\n\n  return {\n    address20,\n    address32,\n  };\n}\n","import { ApiPromise, WsProvider } from '@polkadot/api';\nimport { typesBundle } from '@polkadot/apps-config';\nimport { LRUCache } from 'lru-cache';\n\nexport enum MRLTypes {\n  // TODO handle both types according to RT version\n  XcmVersionedMultiLocation = 'XcmVersionedMultiLocation',\n  XcmVersionedLocation = 'XcmVersionedLocation',\n  XcmRoutingUserAction = 'XcmRoutingUserAction',\n  VersionedUserAction = 'VersionedUserAction',\n}\n\nconst cache = new LRUCache<string, Promise<ApiPromise>>({\n  max: 20,\n  dispose: async (promise: Promise<ApiPromise>) => {\n    const api = await promise;\n\n    if (api.isConnected) {\n      api.disconnect();\n    }\n  },\n});\n\nexport async function getPolkadotApi(\n  ws: string | string[],\n): Promise<ApiPromise> {\n  const key = Array.isArray(ws) ? ws.join(';') : ws;\n  const promise =\n    cache.get(key) ||\n    ApiPromise.create({\n      noInitWarn: true,\n      provider: new WsProvider(ws),\n      types: {\n        [MRLTypes.XcmRoutingUserAction]: {\n          destination: MRLTypes.XcmVersionedLocation,\n        },\n        [MRLTypes.VersionedUserAction]: {\n          _enum: { V1: MRLTypes.XcmRoutingUserAction },\n        },\n      },\n      typesBundle,\n    });\n\n  cache.set(key, promise);\n\n  const api = await promise;\n\n  await api.isReady;\n\n  return api;\n}\n","export function getPolkadotAppsUrl(ws: string) {\n  return `https://polkadot.js.org/apps/?rpc=${encodeURIComponent(ws)}#/explorer/query`;\n}\n"],"mappings":"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","names":["MRLTypes"]}

package/package.json

@@ -1,26 +1,13 @@
 {
   "name": "@moonbeam-network/xcm-utils",
-  "version": "1.0.0-dev.28",
+  "version": "1.0.0-dev.280",
   "description": "Moonbeam XCM utilities",
-  "scripts": {
-    "build": "tsup",
-    "dev": "npm run build -- --watch",
-    "link": "npm ln",
-    "lint": "eslint . --ext .js,.ts",
-    "lint:fix": "npm run lint -- --fix",
-    "typecheck": "tsc --noEmit",
-    "test": "jest /src",
-    "test:watch": "npm test -- --watch",
-    "test:update": "npm test -- -u",
-    "test:ci": "npm test -- --ci",
-    "prepack": "prettier --write build/index.d.ts"
-  },
-  "author": "PureStake",
+  "author": "moonbeam-foundation",
   "license": "MIT",
   "repository": {
     "directory": "packages/utils",
     "type": "git",
-    "url": "git+https://github.com/PureStake/xcm-sdk.git"
+    "url": "git+https://github.com/moonbeam-foundation/xcm-sdk.git"
   },
   "keywords": [
     "moonbeam",
@@ -29,36 +16,42 @@
     "utils"
   ],
   "bugs": {
-    "url": "https://github.com/PureStake/xcm-sdk/issues"
+    "url": "https://github.com/moonbeam-foundation/xcm-sdk/issues"
   },
-  "homepage": "https://docs.moonbeam.network/builders/xcm/xcm-sdk/xcm-sdk/",
+  "homepage": "https://moonbeam-foundation.github.io/xcm-sdk/latest",
   "files": [
     "build"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "import": {
-        "types": "./build/index.d.ts",
-        "default": "./build/index.mjs"
-      },
-      "require": {
-        "types": "./build/index.d.ts",
-        "default": "./build/index.cjs"
-      }
+      "import": "./build/index.mjs",
+      "types": "./build/index.d.ts",
+      "default": "./build/index.mjs"
     }
   },
   "types": "./build/index.d.ts",
-  "main": "./build/index.cjs",
+  "main": "./build/index.mjs",
   "dependencies": {
-    "big.js": "^6.2.1",
-    "lru-cache": "^7.17.0"
+    "big.js": "^7.0.1",
+    "lru-cache": "^11.1.0"
   },
   "devDependencies": {
-    "@types/big.js": "^6.1.6"
+    "@types/big.js": "^6.2.2"
   },
   "peerDependencies": {
-    "@polkadot/apps-config": "^0.132.1",
-    "@polkadot/api": "^10.10.1"
+    "@polkadot/api": "16.5.4",
+    "@polkadot/apps-config": "0.169.1",
+    "@polkadot/util": "14.0.1",
+    "@polkadot/util-crypto": "14.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "link": "pnpm ln --global",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:update": "vitest -u"
   }
 }

package/build/index.cjs

@@ -1,2 +0,0 @@
-"use strict";var l=Object.create;var s=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var P=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var h=(t,r)=>{for(var n in r)s(t,n,{get:r[n],enumerable:!0})},p=(t,r,n,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of w(r))!v.call(t,o)&&o!==n&&s(t,o,{get:()=>r[o],enumerable:!(i=x(r,o))||i.enumerable});return t};var u=(t,r,n)=>(n=t!=null?l(P(t)):{},p(r||!t||!t.__esModule?s(n,"default",{value:t,enumerable:!0}):n,t)),A=t=>p(s({},"__esModule",{value:!0}),t);var R={};h(R,{convertDecimals:()=>y,formatAssetIdToERC20:()=>S,getPolkadotApi:()=>I,hasDecimalOverflow:()=>B,toBigInt:()=>f,toDecimal:()=>g});module.exports=A(R);function S(t){if(t.startsWith("0x"))return t;if(!/^\d{38,39}$/.test(t))throw new Error(`Asset id: ${t} must be a string and have 38-39 digits`);return`0xffffffff${BigInt(t).toString(16).padStart(32,"0")}`}var e=u(require("big.js"),1);e.default.NE=-18;function g(t,r,n=6,i){let o=(0,e.default)(t.toString().replace(/[^0-9]/g,"")),b=(0,e.default)(10).pow(r);return o.div(b).round(n,i).toString()}function f(t,r){if(typeof t=="bigint")return t;let n=(0,e.default)(10).pow(r),i=(0,e.default)(t).mul(n);return BigInt(i.toFixed(0,e.default.roundDown))}function y(t,r,n){let i=g(t,r,r);return f(i.toString(),n)}function B(t,r){let n=t.toString().split(".");return n.length>1&&n[1].length>r}var m=require("@polkadot/api"),a=require("@polkadot/apps-config"),d=u(require("lru-cache"),1),c=new d.default({max:20,dispose:async t=>{let r=await t;r.isConnected&&r.disconnect()}});async function I(t){let r=c.get(t)||m.ApiPromise.create({noInitWarn:!0,provider:new m.WsProvider(t),typesBundle:a.typesBundle});c.set(t,r);let n=await r;return await n.isReady,n}0&&(module.exports={convertDecimals,formatAssetIdToERC20,getPolkadotApi,hasDecimalOverflow,toBigInt,toDecimal});
-//# sourceMappingURL=index.cjs.map

package/build/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts","../src/format/asset.ts","../src/numbers/decimals.ts","../src/polkadot/polkadot.api.ts"],"sourcesContent":["export * from './format';\nexport * from './numbers';\nexport * from './polkadot';\n","export function formatAssetIdToERC20(id: string) {\n  if (id.startsWith('0x')) {\n    return id;\n  }\n\n  if (!/^\\d{38,39}$/.test(id)) {\n    throw new Error(`Asset id: ${id} must be a string and have 38-39 digits`);\n  }\n\n  return `0xffffffff${BigInt(id).toString(16).padStart(32, '0')}`;\n}\n","import Big, { RoundingMode } from 'big.js';\n\nBig.NE = -18;\n\nexport function toDecimal(\n  number: bigint | number | string,\n  decimals: number,\n  maxDecimal = 6,\n  roundType?: RoundingMode,\n): string {\n  const dividend = Big(number.toString().replace(/[^0-9]/g, ''));\n  const divisor = Big(10).pow(decimals);\n  const result = dividend.div(divisor).round(maxDecimal, roundType);\n\n  return result.toString();\n}\n\nexport function toBigInt(\n  amount: bigint | string | number,\n  decimals: number,\n): bigint {\n  if (typeof amount === 'bigint') {\n    return amount;\n  }\n\n  const multiplier = Big(10).pow(decimals);\n  const result = Big(amount).mul(multiplier);\n\n  return BigInt(result.toFixed(0, Big.roundDown));\n}\n\nexport function convertDecimals(\n  number: string | bigint,\n  decimals: number,\n  targetDecimals: number,\n): bigint {\n  const decimalNumber = toDecimal(number, decimals, decimals);\n\n  return toBigInt(decimalNumber.toString(), targetDecimals);\n}\n\nexport function hasDecimalOverflow(fl: number | string, maxDecimal: number) {\n  const parts = fl.toString().split('.');\n  return parts.length > 1 && parts[1].length > maxDecimal;\n}\n","import { ApiPromise, WsProvider } from '@polkadot/api';\nimport { typesBundle } from '@polkadot/apps-config';\nimport LRU from 'lru-cache';\n\nconst cache = new LRU<string, Promise<ApiPromise>>({\n  max: 20,\n  // eslint-disable-next-line sort-keys\n  dispose: async (promise: Promise<ApiPromise>) => {\n    const api = await promise;\n\n    if (api.isConnected) {\n      api.disconnect();\n    }\n  },\n});\n\nexport async function getPolkadotApi(ws: string): Promise<ApiPromise> {\n  const promise =\n    cache.get(ws) ||\n    ApiPromise.create({\n      noInitWarn: true,\n      provider: new WsProvider(ws),\n      typesBundle,\n    });\n\n  cache.set(ws, promise);\n\n  const api = await promise;\n\n  await api.isReady;\n\n  return api;\n}\n"],"mappings":"0jBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,EAAA,yBAAAC,EAAA,mBAAAC,EAAA,uBAAAC,EAAA,aAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAR,GCAO,SAASS,EAAqBC,EAAY,CAC/C,GAAIA,EAAG,WAAW,IAAI,EACpB,OAAOA,EAGT,GAAI,CAAC,cAAc,KAAKA,CAAE,EACxB,MAAM,IAAI,MAAM,aAAaA,0CAA2C,EAG1E,MAAO,aAAa,OAAOA,CAAE,EAAE,SAAS,EAAE,EAAE,SAAS,GAAI,GAAG,GAC9D,CCVA,IAAAC,EAAkC,uBAElC,EAAAC,QAAI,GAAK,IAEF,SAASC,EACdC,EACAC,EACAC,EAAa,EACbC,EACQ,CACR,IAAMC,KAAW,EAAAN,SAAIE,EAAO,SAAS,EAAE,QAAQ,UAAW,EAAE,CAAC,EACvDK,KAAU,EAAAP,SAAI,EAAE,EAAE,IAAIG,CAAQ,EAGpC,OAFeG,EAAS,IAAIC,CAAO,EAAE,MAAMH,EAAYC,CAAS,EAElD,SAAS,CACzB,CAEO,SAASG,EACdC,EACAN,EACQ,CACR,GAAI,OAAOM,GAAW,SACpB,OAAOA,EAGT,IAAMC,KAAa,EAAAV,SAAI,EAAE,EAAE,IAAIG,CAAQ,EACjCQ,KAAS,EAAAX,SAAIS,CAAM,EAAE,IAAIC,CAAU,EAEzC,OAAO,OAAOC,EAAO,QAAQ,EAAG,EAAAX,QAAI,SAAS,CAAC,CAChD,CAEO,SAASY,EACdV,EACAC,EACAU,EACQ,CACR,IAAMC,EAAgBb,EAAUC,EAAQC,EAAUA,CAAQ,EAE1D,OAAOK,EAASM,EAAc,SAAS,EAAGD,CAAc,CAC1D,CAEO,SAASE,EAAmBC,EAAqBZ,EAAoB,CAC1E,IAAMa,EAAQD,EAAG,SAAS,EAAE,MAAM,GAAG,EACrC,OAAOC,EAAM,OAAS,GAAKA,EAAM,CAAC,EAAE,OAASb,CAC/C,CC5CA,IAAAc,EAAuC,yBACvCC,EAA4B,iCAC5BC,EAAgB,0BAEVC,EAAQ,IAAI,EAAAC,QAAiC,CACjD,IAAK,GAEL,QAAS,MAAOC,GAAiC,CAC/C,IAAMC,EAAM,MAAMD,EAEdC,EAAI,aACNA,EAAI,WAAW,CAEnB,CACF,CAAC,EAED,eAAsBC,EAAeC,EAAiC,CACpE,IAAMH,EACJF,EAAM,IAAIK,CAAE,GACZ,aAAW,OAAO,CAChB,WAAY,GACZ,SAAU,IAAI,aAAWA,CAAE,EAC3B,yBACF,CAAC,EAEHL,EAAM,IAAIK,EAAIH,CAAO,EAErB,IAAMC,EAAM,MAAMD,EAElB,aAAMC,EAAI,QAEHA,CACT","names":["src_exports","__export","convertDecimals","formatAssetIdToERC20","getPolkadotApi","hasDecimalOverflow","toBigInt","toDecimal","__toCommonJS","formatAssetIdToERC20","id","import_big","Big","toDecimal","number","decimals","maxDecimal","roundType","dividend","divisor","toBigInt","amount","multiplier","result","convertDecimals","targetDecimals","decimalNumber","hasDecimalOverflow","fl","parts","import_api","import_apps_config","import_lru_cache","cache","LRU","promise","api","getPolkadotApi","ws"]}