@multiversx/sdk-dapp-liquidity 2.2.0 → 2.3.0-alpha.0

package/helpers/assertConfirmRateData.d.ts

@@ -0,0 +1,19 @@
+export interface ConfirmRateGuardParams {
+    nativeAuthToken?: string | null;
+    orderId?: string | null;
+    fromChainId?: string | null;
+    toChainId?: string | null;
+    sender?: string | null;
+    receiver?: string | null;
+}
+/**
+ * Asserts that all required data is present before calling confirmRate.
+ *
+ * Throws {@link ConfirmRateError} for missing system tokens (nativeAuthToken, orderId) —
+ * these indicate an unexpected app-state problem and should not be shown verbatim.
+ *
+ * Throws {@link MissingConfirmRateDataError} for missing form fields (fromChainId,
+ * toChainId, sender, receiver) — the message names the field and can be surfaced to the
+ * user to explain why the bridge couldn't proceed.
+ */
+export declare function assertConfirmRateData({ nativeAuthToken, orderId, fromChainId, toChainId, sender, receiver }: ConfirmRateGuardParams): void;

package/helpers/assertConfirmRateData.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../types/errors.js");function s({nativeAuthToken:e,orderId:n,fromChainId:i,toChainId:t,sender:a,receiver:o}){if(!e)throw new r.ConfirmRateError("Cannot confirm rate. Please reconnect your wallet.");if(!n)throw new r.ConfirmRateError("Cannot confirm rate. Please request a new rate.");if(!i)throw new r.MissingConfirmRateDataError("Missing source chain.");if(!t)throw new r.MissingConfirmRateDataError("Missing destination chain.");if(!a)throw new r.MissingConfirmRateDataError("Missing sender address.");if(!o)throw new r.MissingConfirmRateDataError("Missing destination address")}exports.assertConfirmRateData=s;

package/helpers/assertConfirmRateData.mjs

@@ -0,0 +1,29 @@
+import { ConfirmRateError as e, MissingConfirmRateDataError as n } from "../types/errors.mjs";
+function f({
+  nativeAuthToken: r,
+  orderId: i,
+  fromChainId: t,
+  toChainId: o,
+  sender: a,
+  receiver: s
+}) {
+  if (!r)
+    throw new e(
+      "Cannot confirm rate. Please reconnect your wallet."
+    );
+  if (!i)
+    throw new e(
+      "Cannot confirm rate. Please request a new rate."
+    );
+  if (!t)
+    throw new n("Missing source chain.");
+  if (!o)
+    throw new n("Missing destination chain.");
+  if (!a)
+    throw new n("Missing sender address.");
+  if (!s)
+    throw new n("Missing destination address");
+}
+export {
+  f as assertConfirmRateData
+};

package/helpers/isValidAddressForChainType.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@solana/web3.js"),n=require("bitcoinjs-lib"),s=require("viem"),t=require("../types/chainType.js"),c=/^erd1[0-9a-z]{58}$/,u=/^0x[0-9a-fA-F]{64}$/,a=(e,r)=>{if(!e||!r)return!1;try{switch(r){case t.ChainType.evm:return s.isAddress(e);case t.ChainType.mvx:return c.test(e);case t.ChainType.sol:try{return new i.PublicKey(e),!0}catch{return!1}case t.ChainType.sui:return u.test(e);case t.ChainType.btc:try{return n.address.toOutputScript(e,n.networks.bitcoin),!0}catch{return!1}default:return!1}}catch{return!1}};exports.isValidAddressForChainType=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@solana/web3.js"),n=require("bitcoinjs-lib"),i=require("viem"),t=require("../types/chainType.js"),c=/^erd1[0-9a-z]{58}$/,d=/^0x[0-9a-fA-F]{64}$/,a=new Set(["0x0000000000000000000000000000000000000000","0x0000000000000000000000000000000000000000000000000000000000000000","erd1deaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaqtv0gag","1111111111111111111114oLvT2"]),u=e=>{const r=e.toLowerCase();return a.has(r)||a.has(e)},o=(e,r)=>{if(!e||!r||u(e))return!1;try{switch(r){case t.ChainType.evm:return i.isAddress(e);case t.ChainType.mvx:return c.test(e);case t.ChainType.sol:try{return new s.PublicKey(e),!0}catch{return!1}case t.ChainType.sui:return d.test(e);case t.ChainType.btc:try{return n.address.toOutputScript(e,n.networks.bitcoin),!0}catch{return!1}default:return!1}}catch{return!1}};exports.isValidAddressForChainType=o;

package/helpers/isValidAddressForChainType.mjs

@@ -1,27 +1,39 @@
-import { PublicKey as c } from "@solana/web3.js";
-import { address as n, networks as o } from "bitcoinjs-lib";
+import { PublicKey as n } from "@solana/web3.js";
+import { address as o, networks as d } from "bitcoinjs-lib";
 import { isAddress as s } from "viem";
-import { ChainType as r } from "../types/chainType.mjs";
-const u = /^erd1[0-9a-z]{58}$/, i = /^0x[0-9a-fA-F]{64}$/, p = (t, e) => {
-  if (!t || !e)
+import { ChainType as t } from "../types/chainType.mjs";
+const c = /^erd1[0-9a-z]{58}$/, u = /^0x[0-9a-fA-F]{64}$/, a = /* @__PURE__ */ new Set([
+  // EVM all-zero (20 bytes)
+  "0x0000000000000000000000000000000000000000",
+  // Sui all-zero (32 bytes)
+  "0x0000000000000000000000000000000000000000000000000000000000000000",
+  // MultiversX dead address
+  "erd1deaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaqtv0gag",
+  // BTC unspendable genesis output (base58 is case-sensitive; keep original case)
+  "1111111111111111111114oLvT2"
+]), i = (e) => {
+  const r = e.toLowerCase();
+  return a.has(r) || a.has(e);
+}, p = (e, r) => {
+  if (!e || !r || i(e))
     return !1;
   try {
-    switch (e) {
-      case r.evm:
-        return s(t);
-      case r.mvx:
-        return u.test(t);
-      case r.sol:
+    switch (r) {
+      case t.evm:
+        return s(e);
+      case t.mvx:
+        return c.test(e);
+      case t.sol:
         try {
-          return new c(t), !0;
+          return new n(e), !0;
         } catch {
           return !1;
         }
-      case r.sui:
-        return i.test(t);
-      case r.btc:
+      case t.sui:
+        return u.test(e);
+      case t.btc:
         try {
-          return n.toOutputScript(t, o.bitcoin), !0;
+          return o.toOutputScript(e, d.bitcoin), !0;
         } catch {
           return !1;
         }

package/helpers/tests/assertConfirmRateData.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/helpers/tests/assertConfirmRateData.spec.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";const t=require("../../types/errors.js"),r=require("../assertConfirmRateData.js"),e={nativeAuthToken:"valid-token",orderId:"order-123",fromChainId:"1",toChainId:"44",sender:"0x71C7656EC7ab88b098defB751B7401B5f6d8976F",receiver:"erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx"};describe("assertConfirmRateData",()=>{it("does not throw when all required fields are present",()=>{expect(()=>r.assertConfirmRateData(e)).not.toThrow()}),describe("ConfirmRateError — system token missing",()=>{it("throws ConfirmRateError when nativeAuthToken is missing",()=>{expect(()=>r.assertConfirmRateData({...e,nativeAuthToken:void 0})).toThrow(t.ConfirmRateError)}),it("throws ConfirmRateError when nativeAuthToken is empty string",()=>{expect(()=>r.assertConfirmRateData({...e,nativeAuthToken:""})).toThrow(t.ConfirmRateError)}),it("throws ConfirmRateError when orderId is missing",()=>{expect(()=>r.assertConfirmRateData({...e,orderId:void 0})).toThrow(t.ConfirmRateError)}),it("throws ConfirmRateError when orderId is empty string",()=>{expect(()=>r.assertConfirmRateData({...e,orderId:""})).toThrow(t.ConfirmRateError)})}),describe("MissingConfirmRateDataError — required form field missing",()=>{it("throws MissingConfirmRateDataError when fromChainId is missing",()=>{expect(()=>r.assertConfirmRateData({...e,fromChainId:void 0})).toThrow(t.MissingConfirmRateDataError)}),it("throws MissingConfirmRateDataError when toChainId is missing",()=>{expect(()=>r.assertConfirmRateData({...e,toChainId:void 0})).toThrow(t.MissingConfirmRateDataError)}),it("throws MissingConfirmRateDataError when sender is missing",()=>{expect(()=>r.assertConfirmRateData({...e,sender:void 0})).toThrow(t.MissingConfirmRateDataError)}),it("throws MissingConfirmRateDataError when sender is empty string",()=>{expect(()=>r.assertConfirmRateData({...e,sender:""})).toThrow(t.MissingConfirmRateDataError)}),it("throws MissingConfirmRateDataError when receiver is missing",()=>{expect(()=>r.assertConfirmRateData({...e,receiver:void 0})).toThrow(t.MissingConfirmRateDataError)}),it("throws MissingConfirmRateDataError when receiver is empty string",()=>{expect(()=>r.assertConfirmRateData({...e,receiver:""})).toThrow(t.MissingConfirmRateDataError)}),it("error message names the missing field (fromChainId)",()=>{expect(()=>r.assertConfirmRateData({...e,fromChainId:""})).toThrow(/source chain/i)}),it("error message names the missing field (sender)",()=>{expect(()=>r.assertConfirmRateData({...e,sender:""})).toThrow(/sender/i)})}),describe("error priority — system tokens are checked before form fields",()=>{it("throws ConfirmRateError (not MissingConfirmRateDataError) when both nativeAuthToken and sender are missing",()=>{expect(()=>r.assertConfirmRateData({...e,nativeAuthToken:"",sender:""})).toThrow(t.ConfirmRateError)})})});

package/helpers/tests/assertConfirmRateData.spec.mjs

@@ -0,0 +1,77 @@
+import { ConfirmRateError as t, MissingConfirmRateDataError as i } from "../../types/errors.mjs";
+import { assertConfirmRateData as r } from "../assertConfirmRateData.mjs";
+const e = {
+  nativeAuthToken: "valid-token",
+  orderId: "order-123",
+  fromChainId: "1",
+  toChainId: "44",
+  sender: "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
+  receiver: "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx"
+};
+describe("assertConfirmRateData", () => {
+  it("does not throw when all required fields are present", () => {
+    expect(() => r(e)).not.toThrow();
+  }), describe("ConfirmRateError — system token missing", () => {
+    it("throws ConfirmRateError when nativeAuthToken is missing", () => {
+      expect(
+        () => r({ ...e, nativeAuthToken: void 0 })
+      ).toThrow(t);
+    }), it("throws ConfirmRateError when nativeAuthToken is empty string", () => {
+      expect(
+        () => r({ ...e, nativeAuthToken: "" })
+      ).toThrow(t);
+    }), it("throws ConfirmRateError when orderId is missing", () => {
+      expect(
+        () => r({ ...e, orderId: void 0 })
+      ).toThrow(t);
+    }), it("throws ConfirmRateError when orderId is empty string", () => {
+      expect(
+        () => r({ ...e, orderId: "" })
+      ).toThrow(t);
+    });
+  }), describe("MissingConfirmRateDataError — required form field missing", () => {
+    it("throws MissingConfirmRateDataError when fromChainId is missing", () => {
+      expect(
+        () => r({ ...e, fromChainId: void 0 })
+      ).toThrow(i);
+    }), it("throws MissingConfirmRateDataError when toChainId is missing", () => {
+      expect(
+        () => r({ ...e, toChainId: void 0 })
+      ).toThrow(i);
+    }), it("throws MissingConfirmRateDataError when sender is missing", () => {
+      expect(
+        () => r({ ...e, sender: void 0 })
+      ).toThrow(i);
+    }), it("throws MissingConfirmRateDataError when sender is empty string", () => {
+      expect(
+        () => r({ ...e, sender: "" })
+      ).toThrow(i);
+    }), it("throws MissingConfirmRateDataError when receiver is missing", () => {
+      expect(
+        () => r({ ...e, receiver: void 0 })
+      ).toThrow(i);
+    }), it("throws MissingConfirmRateDataError when receiver is empty string", () => {
+      expect(
+        () => r({ ...e, receiver: "" })
+      ).toThrow(i);
+    }), it("error message names the missing field (fromChainId)", () => {
+      expect(
+        () => r({ ...e, fromChainId: "" })
+      ).toThrow(/source chain/i);
+    }), it("error message names the missing field (sender)", () => {
+      expect(
+        () => r({ ...e, sender: "" })
+      ).toThrow(/sender/i);
+    });
+  }), describe("error priority — system tokens are checked before form fields", () => {
+    it("throws ConfirmRateError (not MissingConfirmRateDataError) when both nativeAuthToken and sender are missing", () => {
+      expect(
+        () => r({
+          ...e,
+          nativeAuthToken: "",
+          sender: ""
+        })
+      ).toThrow(t);
+    });
+  });
+});

package/helpers/tests/isValidAddressForChainType.spec.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";const a=require("../../types/chainType.js"),e=require("../isValidAddressForChainType.js");describe("isValidAddressForChainType",()=>{describe("EVM",()=>{it("accepts a valid checksummed EVM address",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",a.ChainType.evm)).toBe(!0)}),it("accepts a lowercase EVM address",()=>{expect(e.isValidAddressForChainType("0x71c7656ec7ab88b098defb751b7401b5f6d8976f",a.ChainType.evm)).toBe(!0)}),it("rejects a non-EVM string",()=>{expect(e.isValidAddressForChainType("not-an-address",a.ChainType.evm)).toBe(!1)})}),describe("MVX",()=>{it("accepts a valid erd1 address",()=>{expect(e.isValidAddressForChainType("erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",a.ChainType.mvx)).toBe(!0)}),it("rejects an EVM address for MVX",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",a.ChainType.mvx)).toBe(!1)})}),describe("Solana",()=>{it("accepts a valid base58 Solana address",()=>{expect(e.isValidAddressForChainType("9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",a.ChainType.sol)).toBe(!0)}),it("rejects an invalid Solana address",()=>{expect(e.isValidAddressForChainType("notasoladdr",a.ChainType.sol)).toBe(!1)})}),describe("Sui",()=>{it("accepts a valid Sui address (0x + 64 hex chars)",()=>{expect(e.isValidAddressForChainType("0x"+"a".repeat(64),a.ChainType.sui)).toBe(!0)}),it("rejects an EVM-shaped address (0x + 40 hex chars) for Sui — the reported bug",()=>{expect(e.isValidAddressForChainType("0x2566c27aaafa46818c4d91fd4ab88137d26764fd",a.ChainType.sui)).toBe(!1)}),it("rejects a non-hex string for Sui",()=>{expect(e.isValidAddressForChainType("notasuiaddr",a.ChainType.sui)).toBe(!1)})}),describe("BTC",()=>{it("accepts a valid bech32 mainnet address",()=>{expect(e.isValidAddressForChainType("bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",a.ChainType.btc)).toBe(!0)}),it("accepts a valid legacy P2PKH address",()=>{expect(e.isValidAddressForChainType("1BoatSLRHtKNngkdXEeobR76b53LETtpyT",a.ChainType.btc)).toBe(!0)}),it("rejects a garbage string for BTC",()=>{expect(e.isValidAddressForChainType("notabtcaddr",a.ChainType.btc)).toBe(!1)})}),describe("edge cases",()=>{it("returns true for undefined address (no constraint)",()=>{expect(e.isValidAddressForChainType(void 0,a.ChainType.evm)).toBe(!1)}),it("returns true for undefined chainType (no constraint)",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",void 0)).toBe(!1)})})});
+"use strict";const a=require("../../types/chainType.js"),e=require("../isValidAddressForChainType.js");describe("isValidAddressForChainType",()=>{describe("EVM",()=>{it("accepts a valid checksummed EVM address",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",a.ChainType.evm)).toBe(!0)}),it("accepts a lowercase EVM address",()=>{expect(e.isValidAddressForChainType("0x71c7656ec7ab88b098defb751b7401b5f6d8976f",a.ChainType.evm)).toBe(!0)}),it("rejects a non-EVM string",()=>{expect(e.isValidAddressForChainType("not-an-address",a.ChainType.evm)).toBe(!1)})}),describe("MVX",()=>{it("accepts a valid erd1 address",()=>{expect(e.isValidAddressForChainType("erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",a.ChainType.mvx)).toBe(!0)}),it("rejects an EVM address for MVX",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",a.ChainType.mvx)).toBe(!1)})}),describe("Solana",()=>{it("accepts a valid base58 Solana address",()=>{expect(e.isValidAddressForChainType("9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",a.ChainType.sol)).toBe(!0)}),it("rejects an invalid Solana address",()=>{expect(e.isValidAddressForChainType("notasoladdr",a.ChainType.sol)).toBe(!1)})}),describe("Sui",()=>{it("accepts a valid Sui address (0x + 64 hex chars)",()=>{expect(e.isValidAddressForChainType("0x"+"a".repeat(64),a.ChainType.sui)).toBe(!0)}),it("rejects an EVM-shaped address (0x + 40 hex chars) for Sui — the reported bug",()=>{expect(e.isValidAddressForChainType("0x2566c27aaafa46818c4d91fd4ab88137d26764fd",a.ChainType.sui)).toBe(!1)}),it("rejects a non-hex string for Sui",()=>{expect(e.isValidAddressForChainType("notasuiaddr",a.ChainType.sui)).toBe(!1)})}),describe("BTC",()=>{it("accepts a valid bech32 mainnet address",()=>{expect(e.isValidAddressForChainType("bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",a.ChainType.btc)).toBe(!0)}),it("accepts a valid legacy P2PKH address",()=>{expect(e.isValidAddressForChainType("1BoatSLRHtKNngkdXEeobR76b53LETtpyT",a.ChainType.btc)).toBe(!0)}),it("rejects a garbage string for BTC",()=>{expect(e.isValidAddressForChainType("notabtcaddr",a.ChainType.btc)).toBe(!1)})}),describe("edge cases",()=>{it("returns true for undefined address (no constraint)",()=>{expect(e.isValidAddressForChainType(void 0,a.ChainType.evm)).toBe(!1)}),it("returns true for undefined chainType (no constraint)",()=>{expect(e.isValidAddressForChainType("0x71C7656EC7ab88b098defB751B7401B5f6d8976F",void 0)).toBe(!1)})}),describe("burn / null addresses",()=>{it("rejects EVM all-zero burn address",()=>{expect(e.isValidAddressForChainType("0x0000000000000000000000000000000000000000",a.ChainType.evm)).toBe(!1)}),it("rejects Sui all-zero burn address",()=>{expect(e.isValidAddressForChainType("0x0000000000000000000000000000000000000000000000000000000000000000",a.ChainType.sui)).toBe(!1)}),it("rejects MultiversX dead address",()=>{expect(e.isValidAddressForChainType("erd1deaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaqtv0gag",a.ChainType.mvx)).toBe(!1)}),it("rejects BTC unspendable genesis burn address",()=>{expect(e.isValidAddressForChainType("1111111111111111111114oLvT2",a.ChainType.btc)).toBe(!1)}),it("rejects EVM all-zero burn address regardless of case",()=>{expect(e.isValidAddressForChainType("0X0000000000000000000000000000000000000000".toLowerCase(),a.ChainType.evm)).toBe(!1)})})});

package/helpers/tests/isValidAddressForChainType.spec.mjs

@@ -1,4 +1,4 @@
-import { ChainType as t } from "../../types/chainType.mjs";
+import { ChainType as a } from "../../types/chainType.mjs";
 import { isValidAddressForChainType as e } from "../isValidAddressForChainType.mjs";
 describe("isValidAddressForChainType", () => {
   describe("EVM", () => {
@@ -6,18 +6,18 @@ describe("isValidAddressForChainType", () => {
       expect(
         e(
           "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
-          t.evm
+          a.evm
         )
       ).toBe(!0);
     }), it("accepts a lowercase EVM address", () => {
       expect(
         e(
           "0x71c7656ec7ab88b098defb751b7401b5f6d8976f",
-          t.evm
+          a.evm
         )
       ).toBe(!0);
     }), it("rejects a non-EVM string", () => {
-      expect(e("not-an-address", t.evm)).toBe(
+      expect(e("not-an-address", a.evm)).toBe(
         !1
       );
     });
@@ -26,14 +26,14 @@ describe("isValidAddressForChainType", () => {
       expect(
         e(
           "erd1spyavw0956vq68xj8y4tenjpq2wd5a9p2c6j8gsz7ztyrnpxrruqzu66jx",
-          t.mvx
+          a.mvx
         )
       ).toBe(!0);
     }), it("rejects an EVM address for MVX", () => {
       expect(
         e(
           "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
-          t.mvx
+          a.mvx
         )
       ).toBe(!1);
     });
@@ -42,28 +42,28 @@ describe("isValidAddressForChainType", () => {
       expect(
         e(
           "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
-          t.sol
+          a.sol
         )
       ).toBe(!0);
     }), it("rejects an invalid Solana address", () => {
-      expect(e("notasoladdr", t.sol)).toBe(
+      expect(e("notasoladdr", a.sol)).toBe(
         !1
       );
     });
   }), describe("Sui", () => {
     it("accepts a valid Sui address (0x + 64 hex chars)", () => {
       expect(
-        e("0x" + "a".repeat(64), t.sui)
+        e("0x" + "a".repeat(64), a.sui)
       ).toBe(!0);
     }), it("rejects an EVM-shaped address (0x + 40 hex chars) for Sui — the reported bug", () => {
       expect(
         e(
           "0x2566c27aaafa46818c4d91fd4ab88137d26764fd",
-          t.sui
+          a.sui
         )
       ).toBe(!1);
     }), it("rejects a non-hex string for Sui", () => {
-      expect(e("notasuiaddr", t.sui)).toBe(
+      expect(e("notasuiaddr", a.sui)).toBe(
         !1
       );
     });
@@ -72,24 +72,24 @@ describe("isValidAddressForChainType", () => {
       expect(
         e(
           "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
-          t.btc
+          a.btc
         )
       ).toBe(!0);
     }), it("accepts a valid legacy P2PKH address", () => {
       expect(
         e(
           "1BoatSLRHtKNngkdXEeobR76b53LETtpyT",
-          t.btc
+          a.btc
         )
       ).toBe(!0);
     }), it("rejects a garbage string for BTC", () => {
-      expect(e("notabtcaddr", t.btc)).toBe(
+      expect(e("notabtcaddr", a.btc)).toBe(
         !1
       );
     });
   }), describe("edge cases", () => {
     it("returns true for undefined address (no constraint)", () => {
-      expect(e(void 0, t.evm)).toBe(!1);
+      expect(e(void 0, a.evm)).toBe(!1);
     }), it("returns true for undefined chainType (no constraint)", () => {
       expect(
         e(
@@ -98,5 +98,39 @@ describe("isValidAddressForChainType", () => {
         )
       ).toBe(!1);
     });
+  }), describe("burn / null addresses", () => {
+    it("rejects EVM all-zero burn address", () => {
+      expect(
+        e(
+          "0x0000000000000000000000000000000000000000",
+          a.evm
+        )
+      ).toBe(!1);
+    }), it("rejects Sui all-zero burn address", () => {
+      expect(
+        e(
+          "0x0000000000000000000000000000000000000000000000000000000000000000",
+          a.sui
+        )
+      ).toBe(!1);
+    }), it("rejects MultiversX dead address", () => {
+      expect(
+        e(
+          "erd1deaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaddeaqtv0gag",
+          a.mvx
+        )
+      ).toBe(!1);
+    }), it("rejects BTC unspendable genesis burn address", () => {
+      expect(
+        e("1111111111111111111114oLvT2", a.btc)
+      ).toBe(!1);
+    }), it("rejects EVM all-zero burn address regardless of case", () => {
+      expect(
+        e(
+          "0X0000000000000000000000000000000000000000".toLowerCase(),
+          a.evm
+        )
+      ).toBe(!1);
+    });
   });
 });

package/package.json

@@ -3,7 +3,7 @@
   "author": "MultiversX",
   "description": "A complete toolkit for bridging assets between MultiversX, Ethereum, BNB Chain and Sui",
   "license": "MIT",
-  "version": "2.2.0",
+  "version": "2.3.0-alpha.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/multiversx/mx-sdk-dapp-liquidity.git"
@@ -79,11 +79,6 @@
     "wagmi": "3.6.14",
     "yup": "1.4.0"
   },
-  "pnpm": {
-    "overrides": {
-      "protobufjs": ">=7.5.5"
-    }
-  },
   "peerDependencies": {
     "@multiversx/sdk-core": ">= 15.x",
     "@wagmi/core": ">= 3.x",

package/reactjs/adapters/SuiAdapter.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";var y=Object.defineProperty;var v=(d,o,t)=>o in d?y(d,o,{enumerable:!0,configurable:!0,writable:!0,value:t}):d[o]=t;var l=(d,o,t)=>v(d,typeof o!="symbol"?o+"":o,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("@reown/appkit-controllers"),g="walletConnect",m=["sui:mainnet","sui:testnet","sui:devnet"];class w extends h.AdapterBlueprint{constructor(t){super({namespace:"sui",adapterType:"sui"});l(this,"sharedWcProvider");l(this,"explicitCaipChainsFromInit");l(this,"expectedSuiAddress");l(this,"suiNetworksFromConfig",[]);this.explicitCaipChainsFromInit=(t==null?void 0:t.explicitCaipChains)??[],this.expectedSuiAddress=t==null?void 0:t.expectedSuiAddress}construct(t){super.construct(t),this.suiNetworksFromConfig=t.networks??[]}pickChainsFromExplicit(t,e){if(t.length===0)return m;if(e!=null){const n=e.toString(),i=t.find(s=>s===`sui:${n}`||s.endsWith(`:${n}`));if(i)return[i]}return t}resolveSuiChainsForConnect(t){const e=this.getCaipNetworks("sui"),n=e.length>0?e:this.suiNetworksFromConfig;if(n.length===0)return this.pickChainsFromExplicit(this.explicitCaipChainsFromInit,t);const i=s=>s.caipNetworkId||`sui:${s.id}`;if(t!=null){const s=n.find(r=>{var c;return((c=r.id)==null?void 0:c.toString())===t.toString()});if(s)return[i(s)]}return n.map(i)}getCaipNetworksForWalletConnectConnector(){return this.suiNetworksFromConfig.length>0?this.suiNetworksFromConfig:(this.explicitCaipChainsFromInit.length>0?this.explicitCaipChainsFromInit:m).map(e=>{const n=e.startsWith("sui:")?e.slice(4):e;return{id:n,chainNamespace:"sui",caipNetworkId:e,name:"Sui",nativeCurrency:{name:"SUI",symbol:"SUI",decimals:9},rpcUrls:{default:{http:[`https://fullnode.${n}.sui.io:443`]}}}})}syncConnectors(){}async setUniversalProvider(t){this.sharedWcProvider=t;const e=new h.WalletConnectConnector({provider:t,namespace:"sui",caipNetworks:this.getCaipNetworksForWalletConnectConnector()});this.addConnector(e),h.WcHelpersUtil.listenWcProvider({universalProvider:t,namespace:"sui",onConnect:n=>this.onConnect(n,g),onDisconnect:()=>this.onDisconnect(g),onAccountsChanged:n=>this.onAccountsChanged(n,g,!1)})}getWcProvider(){if(!this.sharedWcProvider)throw new Error("SuiAdapter: UniversalProvider not ready — setUniversalProvider must run before connect");return this.sharedWcProvider}async connectWalletConnect(t){var r,c;const e=this.getWcProvider();if((c=(r=e.session)==null?void 0:r.namespaces)!=null&&c.sui)return{clientId:await e.client.core.crypto.getClientId()};const n=this.resolveSuiChainsForConnect(t),i=n.length>0?n:m;return await e.connect({optionalNamespaces:{sui:{methods:["sui_signPersonalMessage","sui_signTransaction","sui_signAndExecuteTransaction"],chains:i,events:[]}}}),{clientId:await e.client.core.crypto.getClientId()}}async connect(t){var C,f,p;const e=this.connectors.find(u=>u.id===t.id);if(!e)throw new Error("Sui connector not found");const n=this.getConnection({address:t.address,connectorId:e.id,connections:this.connections,connectors:this.connectors});if(n!=null&&n.account){const u=((C=n.caipNetwork)==null?void 0:C.id)??t.chainId??"mainnet";return this.emit("accountChanged",{address:n.account.address,chainId:u,connector:e}),{id:e.id,address:n.account.address,chainId:u,provider:e.provider,type:e.type}}const i=this.getWcProvider(),r=(f=h.WcHelpersUtil.getWalletConnectAccounts(i,"sui")[0])==null?void 0:f.address;if(!r)throw new Error("No Sui account found after WalletConnect session");if(this.expectedSuiAddress&&r!==this.expectedSuiAddress)throw new Error(`Sui account mismatch: expected ${this.expectedSuiAddress}, got ${r}`);const c=(p=this.getCaipNetworks())==null?void 0:p.find(u=>u.id===t.chainId);this.addConnection({connectorId:e.id,accounts:[{address:r}],caipNetwork:c});const a=t.chainId??(c==null?void 0:c.id)??"mainnet";return this.emit("accountChanged",{address:r,chainId:a,connector:e}),{id:e.id,address:r,chainId:a,provider:e.provider,type:e.type}}async disconnect(t){if(t!=null&&t.id){if(this.sharedWcProvider)try{await this.sharedWcProvider.disconnect()}catch{}this.deleteConnection(t.id)}return this.connections.length===0?this.emit("disconnect"):this.emitFirstAvailableConnection(),{connections:this.connections}}async getAccounts(t){return this.sharedWcProvider?{accounts:h.WcHelpersUtil.getWalletConnectAccounts(this.sharedWcProvider,"sui").map(n=>({namespace:"sui",address:n.address,type:"eoa"}))}:{accounts:[]}}async getBalance(t){var e,n,i;if(!t.address)return{balance:"0",symbol:"SUI"};try{const s=(e=this.getCaipNetworks())==null?void 0:e.find(p=>p.id===t.chainId),r=`https://fullnode.${s==null?void 0:s.id}.sui.io:443`;if(!r)return{balance:"0",symbol:"SUI"};const a=await(await fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"suix_getBalance",params:[t.address,"0x2::sui::SUI"]})})).json(),C=((n=a==null?void 0:a.result)==null?void 0:n.totalBalance)??"0";return{balance:(parseInt(C,10)/1e9).toString(),symbol:((i=s==null?void 0:s.nativeCurrency)==null?void 0:i.symbol)||"SUI"}}catch{return{balance:"0",symbol:"SUI"}}}async switchNetwork(t){await super.switchNetwork(t)}async syncConnection(t){return this.connect({...t,type:""})}async syncConnections({connectToFirstConnector:t,caipNetwork:e}){if(!this.sharedWcProvider)return;const n=h.WcHelpersUtil.getWalletConnectAccounts(this.sharedWcProvider,"sui");n.length>0&&this.addConnection({connectorId:g,accounts:n.map(i=>({address:i.address})),caipNetwork:e}),t&&this.emitFirstAvailableConnection()}getWalletConnectProvider(t){return t.provider}getChainScope(t){if(t!=null&&t.startsWith("sui:"))return t;const e=this.explicitCaipChainsFromInit.find(n=>n.startsWith("sui:"));return e||"sui:mainnet"}async signMessage(t){const e=this.getWcProvider(),n=this.getChainScope();return{signature:(await e.request({method:"sui_signPersonalMessage",params:{message:t.message,address:t.address}},n)).signature}}async sendTransaction(t){var s;const e=this.getWcProvider(),n=this.getChainScope((s=t.caipNetwork)==null?void 0:s.caipNetworkId);return{hash:(await e.request({method:"sui_signAndExecuteTransaction",params:{transaction:t.data,address:t.to}},n)).digest}}async estimateGas(){return{gas:0n}}async writeContract(){return{hash:""}}parseUnits(){return 0n}formatUnits(){return""}async getCapabilities(){return{}}async grantPermissions(){return{}}async revokePermissions(){return"0x"}async walletGetAssets(){return{}}}exports.SuiAdapter=w;
+"use strict";var y=Object.defineProperty;var v=(d,o,t)=>o in d?y(d,o,{enumerable:!0,configurable:!0,writable:!0,value:t}):d[o]=t;var l=(d,o,t)=>v(d,typeof o!="symbol"?o+"":o,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("@reown/appkit-controllers"),g="walletConnect",m=["sui:mainnet","sui:testnet","sui:devnet"];class w extends h.AdapterBlueprint{constructor(t){super({namespace:"sui",adapterType:"sui"});l(this,"sharedWcProvider");l(this,"explicitCaipChainsFromInit");l(this,"expectedSuiAddress");l(this,"suiNetworksFromConfig",[]);this.explicitCaipChainsFromInit=(t==null?void 0:t.explicitCaipChains)??[],this.expectedSuiAddress=t==null?void 0:t.expectedSuiAddress}construct(t){super.construct(t),this.suiNetworksFromConfig=t.networks??[]}pickChainsFromExplicit(t,e){if(t.length===0)return m;if(e!=null){const n=e.toString(),i=t.find(s=>s===`sui:${n}`||s.endsWith(`:${n}`));if(i)return[i]}return t}resolveSuiChainsForConnect(t){const e=this.getCaipNetworks("sui"),n=e.length>0?e:this.suiNetworksFromConfig;if(n.length===0)return this.pickChainsFromExplicit(this.explicitCaipChainsFromInit,t);const i=s=>s.caipNetworkId||`sui:${s.id}`;if(t!=null){const s=n.find(r=>{var c;return((c=r.id)==null?void 0:c.toString())===t.toString()});if(s)return[i(s)]}return n.map(i)}getCaipNetworksForWalletConnectConnector(){return this.suiNetworksFromConfig.length>0?this.suiNetworksFromConfig:(this.explicitCaipChainsFromInit.length>0?this.explicitCaipChainsFromInit:m).map(e=>{const n=e.startsWith("sui:")?e.slice(4):e;return{id:n,chainNamespace:"sui",caipNetworkId:e,name:"Sui",nativeCurrency:{name:"SUI",symbol:"SUI",decimals:9},rpcUrls:{default:{http:[`https://fullnode.${n}.sui.io:443`]}}}})}syncConnectors(){}async setUniversalProvider(t){this.sharedWcProvider=t;const e=new h.WalletConnectConnector({provider:t,namespace:"sui",caipNetworks:this.getCaipNetworksForWalletConnectConnector()});this.addConnector(e),h.WcHelpersUtil.listenWcProvider({universalProvider:t,namespace:"sui",onConnect:n=>this.onConnect(n,g),onDisconnect:()=>this.onDisconnect(g),onAccountsChanged:n=>this.onAccountsChanged(n,g,!1)})}getWcProvider(){if(!this.sharedWcProvider)throw new Error("SuiAdapter: UniversalProvider not ready — setUniversalProvider must run before connect");return this.sharedWcProvider}async connectWalletConnect(t){var r,c;const e=this.getWcProvider();if((c=(r=e.session)==null?void 0:r.namespaces)!=null&&c.sui)return{clientId:await e.client.core.crypto.getClientId()};const n=this.resolveSuiChainsForConnect(t),i=n.length>0?n:m;return await e.connect({optionalNamespaces:{sui:{methods:["sui_signPersonalMessage","sui_signTransaction","sui_signAndExecuteTransaction"],chains:i,events:[]}}}),{clientId:await e.client.core.crypto.getClientId()}}async connect(t){var C,f,p;const e=this.connectors.find(u=>u.id===t.id);if(!e)throw new Error("Sui connector not found");const n=this.getConnection({address:t.address,connectorId:e.id,connections:this.connections,connectors:this.connectors});if(n!=null&&n.account){const u=((C=n.caipNetwork)==null?void 0:C.id)??t.chainId??"mainnet";return this.emit("accountChanged",{address:n.account.address,chainId:u,connector:e}),{id:e.id,address:n.account.address,chainId:u,provider:e.provider,type:e.type}}const i=this.getWcProvider(),r=(f=h.WcHelpersUtil.getWalletConnectAccounts(i,"sui")[0])==null?void 0:f.address;if(!r)throw new Error("No Sui account found after WalletConnect session");if(this.expectedSuiAddress&&r!==this.expectedSuiAddress)throw new Error(`Sui account mismatch: expected ${this.expectedSuiAddress}, got ${r}`);const c=(p=this.getCaipNetworks())==null?void 0:p.find(u=>u.id===t.chainId);this.addConnection({connectorId:e.id,accounts:[{address:r}],caipNetwork:c});const a=t.chainId??(c==null?void 0:c.id)??"mainnet";return this.emit("accountChanged",{address:r,chainId:a,connector:e}),{id:e.id,address:r,chainId:a,provider:e.provider,type:e.type}}async disconnect(t){var e,n,i;if((i=(n=(e=this.sharedWcProvider)==null?void 0:e.session)==null?void 0:n.namespaces)!=null&&i.sui)try{await this.sharedWcProvider.disconnect()}catch{}if(t!=null&&t.id)this.deleteConnection(t.id);else for(const s of[...this.connections])this.deleteConnection(s.connectorId);return this.connections.length===0?this.emit("disconnect"):this.emitFirstAvailableConnection(),{connections:this.connections}}async getAccounts(t){return this.sharedWcProvider?{accounts:h.WcHelpersUtil.getWalletConnectAccounts(this.sharedWcProvider,"sui").map(n=>({namespace:"sui",address:n.address,type:"eoa"}))}:{accounts:[]}}async getBalance(t){var e,n,i;if(!t.address)return{balance:"0",symbol:"SUI"};try{const s=(e=this.getCaipNetworks())==null?void 0:e.find(p=>p.id===t.chainId),r=`https://fullnode.${s==null?void 0:s.id}.sui.io:443`;if(!r)return{balance:"0",symbol:"SUI"};const a=await(await fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"suix_getBalance",params:[t.address,"0x2::sui::SUI"]})})).json(),C=((n=a==null?void 0:a.result)==null?void 0:n.totalBalance)??"0";return{balance:(parseInt(C,10)/1e9).toString(),symbol:((i=s==null?void 0:s.nativeCurrency)==null?void 0:i.symbol)||"SUI"}}catch{return{balance:"0",symbol:"SUI"}}}async switchNetwork(t){await super.switchNetwork(t)}async syncConnection(t){return this.connect({...t,type:""})}async syncConnections({connectToFirstConnector:t,caipNetwork:e}){if(!this.sharedWcProvider)return;const n=h.WcHelpersUtil.getWalletConnectAccounts(this.sharedWcProvider,"sui");n.length>0&&this.addConnection({connectorId:g,accounts:n.map(i=>({address:i.address})),caipNetwork:e}),t&&this.emitFirstAvailableConnection()}getWalletConnectProvider(t){return t.provider}getChainScope(t){if(t!=null&&t.startsWith("sui:"))return t;const e=this.explicitCaipChainsFromInit.find(n=>n.startsWith("sui:"));return e||"sui:mainnet"}async signMessage(t){const e=this.getWcProvider(),n=this.getChainScope();return{signature:(await e.request({method:"sui_signPersonalMessage",params:{message:t.message,address:t.address}},n)).signature}}async sendTransaction(t){var s;const e=this.getWcProvider(),n=this.getChainScope((s=t.caipNetwork)==null?void 0:s.caipNetworkId);return{hash:(await e.request({method:"sui_signAndExecuteTransaction",params:{transaction:t.data,address:t.to}},n)).digest}}async estimateGas(){return{gas:0n}}async writeContract(){return{hash:""}}parseUnits(){return 0n}formatUnits(){return""}async getCapabilities(){return{}}async grantPermissions(){return{}}async revokePermissions(){return"0x"}async walletGetAssets(){return{}}}exports.SuiAdapter=w;