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

package/reactjs/hooks/useBridgeFormik.d.ts

@@ -94,6 +94,7 @@ export declare const useBridgeFormik: ({ sender, receiver, firstToken, firstAmou
     fromChainError: string | undefined;
     senderAddressError: string | undefined;
     receiverAddressError: string | undefined;
+    confirmRateError: string | undefined;
     handleBlur: {
         (e: React.FocusEvent<any, Element>): void;
         <T = any>(fieldOrEvent: T): T extends string ? (e: any) => void : void;

package/reactjs/hooks/useBridgeFormik.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("formik"),d=require("react"),u=require("yup"),G=require("./validation/useAmountSchema.js"),H=require("./validation/useSecondAmountSchema.js"),J=require("../../api/confirmRate.js"),K=require("../../helpers/assertRateConfirmationMatchesIntent.js"),Q=require("../../helpers/getApiURL.js"),y=require("../../helpers/isValidAddressForChainType.js"),j=require("../../types/providerType.js"),X=require("../context/useWeb3App.js");var E=(o=>(o.firstToken="firstToken",o.firstAmount="firstAmount",o.secondToken="secondToken",o.secondAmount="secondAmount",o.fromChainId="fromChainId",o.toChainId="toChainId",o))(E||{});const Y=({sender:o,receiver:c,firstToken:m,firstAmount:h,secondToken:l,secondAmount:A,fromChainId:p,toChainId:I,setForceRefetchRate:C,rate:n,onSubmit:M,isMvxConnected:O,senderChainType:v,receiverChainType:S})=>{const i=d.useRef(),{nativeAuthToken:P}=X.useWeb3App(),q=!o||!v?!0:y.isValidAddressForChainType(o,v),T=!c||!S?!0:y.isValidAddressForChainType(c,S),V=o&&!q?`Invalid ${v} sender address`:void 0,$=c&&!T?`Invalid ${S} receiver address`:void 0,w={firstAmount:"",secondAmount:"",fromChainId:p??"",toChainId:I??""},_=()=>{a.setTouched({},!1),a.setErrors({}),e("firstAmount",""),e("secondAmount","")},F=async s=>{var b,g;if(!i.current){i.current=!0;try{if(!q||!T){i.current=!1;return}const{data:k}=await J.confirmRate({url:Q.getApiURL(),nativeAuthToken:P??"",body:{tokenIn:((b=s.firstToken)==null?void 0:b.address)??"",amountIn:(h==null?void 0:h.toString())??"",fromChainId:s.fromChainId??"",tokenOut:((g=s.secondToken)==null?void 0:g.address)??"",toChainId:s.toChainId??"",amountOut:(A==null?void 0:A.toString())??"",sender:o??"",receiver:c??"",fee:(n==null?void 0:n.fee)??"0",provider:(n==null?void 0:n.provider)??j.ProviderType.None,orderId:(n==null?void 0:n.orderId)??""}}),t=k;if(!t||t.length===0){i.current=!1;return}K.assertRateConfirmationMatchesIntent({fromChainId:s.fromChainId??"",sender:o??""},t),_(),M({transactions:t,provider:(n==null?void 0:n.provider)??j.ProviderType.None})}catch(k){console.error("Error confirming rate:",k),C==null||C(t=>t+1)}finally{i.current=!1}}},a=D.useFormik({initialValues:w,validationSchema:u.object().shape({firstAmount:G.useAmountSchema({isMvxConnected:O}),firstToken:u.object().required(),secondAmount:H.useSecondAmountSchema(),secondToken:u.object().required(),fromChainId:u.string().required(),toChainId:u.string().required()}),onSubmit:F}),{errors:r,touched:f,handleBlur:L,handleSubmit:N,handleChange:R,setFieldValue:e,setFieldTouched:U}=a;d.useEffect(()=>{e("firstToken",m,!0)},[m]),d.useEffect(()=>{e("secondToken",l,!0)},[l]),d.useEffect(()=>{e("fromChainId",p,!0)},[p]),d.useEffect(()=>{e("toChainId",I,!0)},[I]);const W="secondAmount"in r&&"secondAmount"in f?r.secondAmount:void 0,x="firstAmount"in r&&"firstAmount"in f?r.firstAmount:void 0,z="fromChainId"in r&&"fromChainId"in f?r.fromChainId:void 0;return{formik:a,errors:r,touched:f,firstToken:m,secondToken:l,firstAmountError:x,secondAmountError:W,fromChainError:z,senderAddressError:V,receiverAddressError:$,handleBlur:L,handleChange:R,handleSubmit:N,setFieldValue:e,resetSwapForm:_,setFieldTouched:U}};exports.BridgeFormikValuesEnum=E;exports.useBridgeFormik=Y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const J=require("formik"),d=require("react"),a=require("yup"),K=require("./validation/useAmountSchema.js"),Q=require("./validation/useSecondAmountSchema.js"),X=require("../../api/confirmRate.js"),Y=require("../../helpers/assertConfirmRateData.js"),Z=require("../../helpers/assertRateConfirmationMatchesIntent.js"),B=require("../../helpers/getApiURL.js"),R=require("../../helpers/isValidAddressForChainType.js"),j=require("../../types/errors.js"),M=require("../../types/providerType.js"),oo=require("../context/useWeb3App.js");var D=(r=>(r.firstToken="firstToken",r.firstAmount="firstAmount",r.secondToken="secondToken",r.secondAmount="secondAmount",r.fromChainId="fromChainId",r.toChainId="toChainId",r))(D||{});const ro=({sender:r,receiver:c,firstToken:h,firstAmount:I,secondToken:C,secondAmount:l,fromChainId:p,toChainId:A,setForceRefetchRate:S,rate:o,onSubmit:O,isMvxConnected:P,senderChainType:q,receiverChainType:v})=>{const u=d.useRef(),{nativeAuthToken:k}=oo.useWeb3App(),[V,_]=d.useState(void 0),g=!r||!q?!0:R.isValidAddressForChainType(r,q),T=!c||!v?!0:R.isValidAddressForChainType(c,v),$=r&&!g?`Invalid ${q} sender address`:void 0,w=c&&!T?`Invalid ${v} receiver address`:void 0,F={firstAmount:"",secondAmount:"",fromChainId:p??"",toChainId:A??""},b=()=>{f.setTouched({},!1),f.setErrors({}),e("firstAmount",""),e("secondAmount","")},L=async t=>{var y,E;if(!u.current){u.current=!0,_(void 0);try{if(!g||!T){u.current=!1;return}Y.assertConfirmRateData({nativeAuthToken:k,orderId:o==null?void 0:o.orderId,fromChainId:t.fromChainId,toChainId:t.toChainId,sender:r,receiver:c});const{data:i}=await X.confirmRate({url:B.getApiURL(),nativeAuthToken:k??"",body:{tokenIn:((y=t.firstToken)==null?void 0:y.address)??"",amountIn:(I==null?void 0:I.toString())??"",fromChainId:t.fromChainId??"",tokenOut:((E=t.secondToken)==null?void 0:E.address)??"",toChainId:t.toChainId??"",amountOut:(l==null?void 0:l.toString())??"",sender:r??"",receiver:c??"",fee:(o==null?void 0:o.fee)??"0",provider:(o==null?void 0:o.provider)??M.ProviderType.None,orderId:(o==null?void 0:o.orderId)??""}}),s=i;if(!s||s.length===0){u.current=!1;return}Z.assertRateConfirmationMatchesIntent({fromChainId:t.fromChainId??"",sender:r??""},s),b(),O({transactions:s,provider:(o==null?void 0:o.provider)??M.ProviderType.None})}catch(i){console.error("Error confirming rate:",i),i instanceof j.ConfirmRateError||i instanceof j.MissingConfirmRateDataError?_(i.message):S==null||S(s=>s+1)}finally{u.current=!1}}},f=J.useFormik({initialValues:F,validationSchema:a.object().shape({firstAmount:K.useAmountSchema({isMvxConnected:P}),firstToken:a.object().required(),secondAmount:Q.useSecondAmountSchema(),secondToken:a.object().required(),fromChainId:a.string().required(),toChainId:a.string().required()}),onSubmit:L}),{errors:n,touched:m,handleBlur:N,handleSubmit:U,handleChange:W,setFieldValue:e,setFieldTouched:x}=f;d.useEffect(()=>{e("firstToken",h,!0)},[h]),d.useEffect(()=>{e("secondToken",C,!0)},[C]),d.useEffect(()=>{e("fromChainId",p,!0)},[p]),d.useEffect(()=>{e("toChainId",A,!0)},[A]);const z="secondAmount"in n&&"secondAmount"in m?n.secondAmount:void 0,G="firstAmount"in n&&"firstAmount"in m?n.firstAmount:void 0,H="fromChainId"in n&&"fromChainId"in m?n.fromChainId:void 0;return{formik:f,errors:n,touched:m,firstToken:h,secondToken:C,firstAmountError:G,secondAmountError:z,fromChainError:H,senderAddressError:$,receiverAddressError:w,confirmRateError:V,handleBlur:N,handleChange:W,handleSubmit:U,setFieldValue:e,resetSwapForm:b,setFieldTouched:x}};exports.BridgeFormikValuesEnum=D;exports.useBridgeFormik=ro;

package/reactjs/hooks/useBridgeFormik.mjs

@@ -1,131 +1,144 @@
-import { useFormik as K } from "formik";
-import { useRef as Q, useEffect as u } from "react";
-import { object as k, string as w } from "yup";
-import { useAmountSchema as V } from "./validation/useAmountSchema.mjs";
-import { useSecondAmountSchema as X } from "./validation/useSecondAmountSchema.mjs";
-import { confirmRate as Y } from "../../api/confirmRate.mjs";
-import { assertRateConfirmationMatchesIntent as Z } from "../../helpers/assertRateConfirmationMatchesIntent.mjs";
-import { getApiURL as _ } from "../../helpers/getApiURL.mjs";
-import { isValidAddressForChainType as y } from "../../helpers/isValidAddressForChainType.mjs";
-import { ProviderType as N } from "../../types/providerType.mjs";
-import { useWeb3App as F } from "../context/useWeb3App.mjs";
-var R = /* @__PURE__ */ ((o) => (o.firstToken = "firstToken", o.firstAmount = "firstAmount", o.secondToken = "secondToken", o.secondAmount = "secondAmount", o.fromChainId = "fromChainId", o.toChainId = "toChainId", o))(R || {});
-const co = ({
-  sender: o,
+import { useFormik as Q } from "formik";
+import { useRef as V, useState as X, useEffect as u } from "react";
+import { object as k, string as y } from "yup";
+import { useAmountSchema as Y } from "./validation/useAmountSchema.mjs";
+import { useSecondAmountSchema as Z } from "./validation/useSecondAmountSchema.mjs";
+import { confirmRate as _ } from "../../api/confirmRate.mjs";
+import { assertConfirmRateData as F } from "../../helpers/assertConfirmRateData.mjs";
+import { assertRateConfirmationMatchesIntent as B } from "../../helpers/assertRateConfirmationMatchesIntent.mjs";
+import { getApiURL as oo } from "../../helpers/getApiURL.mjs";
+import { isValidAddressForChainType as D } from "../../helpers/isValidAddressForChainType.mjs";
+import { ConfirmRateError as ro, MissingConfirmRateDataError as no } from "../../types/errors.mjs";
+import { ProviderType as M } from "../../types/providerType.mjs";
+import { useWeb3App as io } from "../context/useWeb3App.mjs";
+var to = /* @__PURE__ */ ((r) => (r.firstToken = "firstToken", r.firstAmount = "firstAmount", r.secondToken = "secondToken", r.secondAmount = "secondAmount", r.fromChainId = "fromChainId", r.toChainId = "toChainId", r))(to || {});
+const So = ({
+  sender: r,
   receiver: e,
-  firstToken: c,
-  firstAmount: a,
-  secondToken: h,
-  secondAmount: I,
+  firstToken: a,
+  firstAmount: h,
+  secondToken: I,
+  secondAmount: C,
   fromChainId: p,
   toChainId: A,
   setForceRefetchRate: l,
-  rate: r,
-  onSubmit: O,
-  isMvxConnected: $,
-  senderChainType: C,
-  receiverChainType: S
+  rate: o,
+  onSubmit: N,
+  isMvxConnected: O,
+  senderChainType: S,
+  receiverChainType: v
 }) => {
-  const d = Q(), { nativeAuthToken: j } = F(), T = !o || !C ? !0 : y(o, C), b = !e || !S ? !0 : y(e, S), x = o && !T ? `Invalid ${C} sender address` : void 0, L = e && !b ? `Invalid ${S} receiver address` : void 0, M = {
+  const m = V(), { nativeAuthToken: g } = io(), [$, T] = X(
+    void 0
+  ), E = !r || !S ? !0 : D(r, S), b = !e || !v ? !0 : D(e, v), j = r && !E ? `Invalid ${S} sender address` : void 0, x = e && !b ? `Invalid ${v} receiver address` : void 0, L = {
     firstAmount: "",
     secondAmount: "",
     fromChainId: p ?? "",
     toChainId: A ?? ""
-  }, g = () => {
-    m.setTouched({}, !1), m.setErrors({}), i("firstAmount", ""), i("secondAmount", "");
-  }, P = async (s) => {
-    var q, E;
-    if (!d.current) {
-      d.current = !0;
+  }, q = () => {
+    f.setTouched({}, !1), f.setErrors({}), i("firstAmount", ""), i("secondAmount", "");
+  }, P = async (t) => {
+    var R, w;
+    if (!m.current) {
+      m.current = !0, T(void 0);
       try {
-        if (!T || !b) {
-          d.current = !1;
+        if (!E || !b) {
+          m.current = !1;
           return;
         }
-        const { data: v } = await Y({
-          url: _(),
-          nativeAuthToken: j ?? "",
+        F({
+          nativeAuthToken: g,
+          orderId: o == null ? void 0 : o.orderId,
+          fromChainId: t.fromChainId,
+          toChainId: t.toChainId,
+          sender: r,
+          receiver: e
+        });
+        const { data: d } = await _({
+          url: oo(),
+          nativeAuthToken: g ?? "",
           body: {
-            tokenIn: ((q = s.firstToken) == null ? void 0 : q.address) ?? "",
-            amountIn: (a == null ? void 0 : a.toString()) ?? "",
-            fromChainId: s.fromChainId ?? "",
-            tokenOut: ((E = s.secondToken) == null ? void 0 : E.address) ?? "",
-            toChainId: s.toChainId ?? "",
-            amountOut: (I == null ? void 0 : I.toString()) ?? "",
-            sender: o ?? "",
+            tokenIn: ((R = t.firstToken) == null ? void 0 : R.address) ?? "",
+            amountIn: (h == null ? void 0 : h.toString()) ?? "",
+            fromChainId: t.fromChainId ?? "",
+            tokenOut: ((w = t.secondToken) == null ? void 0 : w.address) ?? "",
+            toChainId: t.toChainId ?? "",
+            amountOut: (C == null ? void 0 : C.toString()) ?? "",
+            sender: r ?? "",
             receiver: e ?? "",
-            fee: (r == null ? void 0 : r.fee) ?? "0",
-            provider: (r == null ? void 0 : r.provider) ?? N.None,
-            orderId: (r == null ? void 0 : r.orderId) ?? ""
+            fee: (o == null ? void 0 : o.fee) ?? "0",
+            provider: (o == null ? void 0 : o.provider) ?? M.None,
+            orderId: (o == null ? void 0 : o.orderId) ?? ""
           }
-        }), t = v;
-        if (!t || t.length === 0) {
-          d.current = !1;
+        }), s = d;
+        if (!s || s.length === 0) {
+          m.current = !1;
           return;
         }
-        Z(
-          { fromChainId: s.fromChainId ?? "", sender: o ?? "" },
-          t
-        ), g(), O({
-          transactions: t,
-          provider: (r == null ? void 0 : r.provider) ?? N.None
+        B(
+          { fromChainId: t.fromChainId ?? "", sender: r ?? "" },
+          s
+        ), q(), N({
+          transactions: s,
+          provider: (o == null ? void 0 : o.provider) ?? M.None
         });
-      } catch (v) {
-        console.error("Error confirming rate:", v), l == null || l((t) => t + 1);
+      } catch (d) {
+        console.error("Error confirming rate:", d), d instanceof ro || d instanceof no ? T(d.message) : l == null || l((s) => s + 1);
       } finally {
-        d.current = !1;
+        m.current = !1;
       }
     }
-  }, m = K({
-    initialValues: M,
+  }, f = Q({
+    initialValues: L,
     validationSchema: k().shape({
-      firstAmount: V({ isMvxConnected: $ }),
+      firstAmount: Y({ isMvxConnected: O }),
       firstToken: k().required(),
-      secondAmount: X(),
+      secondAmount: Z(),
       secondToken: k().required(),
-      fromChainId: w().required(),
-      toChainId: w().required()
+      fromChainId: y().required(),
+      toChainId: y().required()
     }),
     onSubmit: P
   }), {
     errors: n,
-    touched: f,
+    touched: c,
     handleBlur: U,
     handleSubmit: W,
     handleChange: z,
     setFieldValue: i,
-    setFieldTouched: D
-  } = m;
+    setFieldTouched: G
+  } = f;
   u(() => {
-    i("firstToken", c, !0);
-  }, [c]), u(() => {
-    i("secondToken", h, !0);
-  }, [h]), u(() => {
+    i("firstToken", a, !0);
+  }, [a]), u(() => {
+    i("secondToken", I, !0);
+  }, [I]), u(() => {
     i("fromChainId", p, !0);
   }, [p]), u(() => {
     i("toChainId", A, !0);
   }, [A]);
-  const G = "secondAmount" in n && "secondAmount" in f ? n.secondAmount : void 0, H = "firstAmount" in n && "firstAmount" in f ? n.firstAmount : void 0, J = "fromChainId" in n && "fromChainId" in f ? n.fromChainId : void 0;
+  const H = "secondAmount" in n && "secondAmount" in c ? n.secondAmount : void 0, J = "firstAmount" in n && "firstAmount" in c ? n.firstAmount : void 0, K = "fromChainId" in n && "fromChainId" in c ? n.fromChainId : void 0;
   return {
-    formik: m,
+    formik: f,
     errors: n,
-    touched: f,
-    firstToken: c,
-    secondToken: h,
-    firstAmountError: H,
-    secondAmountError: G,
-    fromChainError: J,
-    senderAddressError: x,
-    receiverAddressError: L,
+    touched: c,
+    firstToken: a,
+    secondToken: I,
+    firstAmountError: J,
+    secondAmountError: H,
+    fromChainError: K,
+    senderAddressError: j,
+    receiverAddressError: x,
+    confirmRateError: $,
     handleBlur: U,
     handleChange: z,
     handleSubmit: W,
     setFieldValue: i,
-    resetSwapForm: g,
-    setFieldTouched: D
+    resetSwapForm: q,
+    setFieldTouched: G
   };
 };
 export {
-  R as BridgeFormikValuesEnum,
-  co as useBridgeFormik
+  to as BridgeFormikValuesEnum,
+  So as useBridgeFormik
 };

package/reactjs/hooks/useNamespaceAddress.d.ts

@@ -0,0 +1,19 @@
+import { ChainType } from '../../types/chainType';
+
+/**
+ * Returns the connected wallet address scoped to the AppKit namespace that corresponds
+ * to the given chain type, preventing a stale SUI address from leaking into EVM form
+ * fields (and vice-versa) during namespace switches.
+ *
+ * Mapping:
+ *   ChainType.sui  → 'sui'    namespace
+ *   ChainType.evm  → 'eip155' namespace
+ *   ChainType.mvx  → undefined (MVX addresses come from the dApp's own auth layer)
+ *   all others     → undefined
+ *
+ * Because hooks must be called unconditionally and before derived values in the same
+ * component, call this hook at the top of the component and pass the chain type that
+ * will be resolved later (it can be undefined on first render — the hook reads both
+ * namespaces unconditionally and picks based on chainType).
+ */
+export declare function useNamespaceAddress(chainType: ChainType | undefined): string | undefined;

package/reactjs/hooks/useNamespaceAddress.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@reown/appkit/react"),s=require("../../types/chainType.js");function u(c){const t=e.useAppKitAccount({namespace:"sui"}),n=e.useAppKitAccount({namespace:"eip155"});switch(c){case s.ChainType.sui:return t.address;case s.ChainType.evm:return n.address;default:return}}exports.useNamespaceAddress=u;

package/reactjs/hooks/useNamespaceAddress.mjs

@@ -0,0 +1,16 @@
+import { useAppKitAccount as e } from "@reown/appkit/react";
+import { ChainType as s } from "../../types/chainType.mjs";
+function a(c) {
+  const t = e({ namespace: "sui" }), r = e({ namespace: "eip155" });
+  switch (c) {
+    case s.sui:
+      return t.address;
+    case s.evm:
+      return r.address;
+    default:
+      return;
+  }
+}
+export {
+  a as useNamespaceAddress
+};

package/types/errors.d.ts

@@ -1,3 +1,18 @@
 export declare class RateConfirmationMismatchError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown when a required system token (nativeAuthToken, orderId) is missing before
+ * calling confirmRate. Generic message — not shown verbatim to end users.
+ */
+export declare class ConfirmRateError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a required form field (fromChainId, toChainId, sender, receiver) is
+ * missing or empty before calling confirmRate. Message names the missing field so it
+ * can be displayed to the user.
+ */
+export declare class MissingConfirmRateDataError extends Error {
+    constructor(message: string);
+}

package/types/errors.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class t extends Error{constructor(r){super(r),this.name="RateConfirmationMismatchError"}}exports.RateConfirmationMismatchError=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o extends Error{constructor(r){super(r),this.name="RateConfirmationMismatchError"}}class e extends Error{constructor(r){super(r),this.name="ConfirmRateError"}}class s extends Error{constructor(r){super(r),this.name="MissingConfirmRateDataError"}}exports.ConfirmRateError=e;exports.MissingConfirmRateDataError=s;exports.RateConfirmationMismatchError=o;

package/types/errors.mjs

@@ -3,6 +3,18 @@ class o extends Error {
     super(r), this.name = "RateConfirmationMismatchError";
   }
 }
+class s extends Error {
+  constructor(r) {
+    super(r), this.name = "ConfirmRateError";
+  }
+}
+class a extends Error {
+  constructor(r) {
+    super(r), this.name = "MissingConfirmRateDataError";
+  }
+}
 export {
+  s as ConfirmRateError,
+  a as MissingConfirmRateDataError,
   o as RateConfirmationMismatchError
 };