@trustware/sdk-staging 1.1.9-staging.6 → 1.1.10-staging.0

package/dist/core.cjs

@@ -75,7 +75,7 @@ var init_constants = __esm({
   "src/constants.ts"() {
     "use strict";
     SDK_NAME = "@trustware/sdk";
-    SDK_VERSION = "1.1.9-staging.6";
+    SDK_VERSION = "1.1.10-staging.0";
     API_ROOT = "https://bv-staging-api.trustware.io";
     API_PREFIX = "/api";
     WALLETCONNECT_PROJECT_ID = "72ea74c400f5111d43aea638d7d83a24";
@@ -284,7 +284,9 @@ var init_chains = __esm({
       btc: "bitcoin",
       bitcoin: "bitcoin",
       sei: "cosmos",
-      "pacific-1": "cosmos"
+      "pacific-1": "cosmos",
+      nibiru: "cosmos",
+      "cataclysm-1": "cosmos"
     };
   }
 });
@@ -1480,16 +1482,23 @@ function validateEvmAddress(address) {
   }
   return { isValid: true };
 }
-function validateSeiAddress(address) {
+function resolveCosmosBech32Prefix(chain) {
+  const chainDef = typeof chain === "object" && chain ? chain : void 0;
+  const identifier = chainDef?.networkIdentifier ?? chainDef?.chainId ?? chainDef?.id ?? (typeof chain === "string" ? chain : void 0);
+  const normalized = String(identifier ?? "").trim().toLowerCase();
+  return COSMOS_BECH32_PREFIX_BY_CHAIN_ID[normalized] ?? "sei";
+}
+function validateCosmosAddress(address, chain) {
   const trimmed = address.trim();
-  if ((0, import_viem.isAddress)(trimmed)) {
+  const prefix = resolveCosmosBech32Prefix(chain);
+  if (prefix === "sei" && (0, import_viem.isAddress)(trimmed)) {
     return { isValid: true };
   }
-  const result = validateBech32LikeAddress(trimmed, "sei");
+  const result = validateBech32LikeAddress(trimmed, prefix);
   if (result.isValid) return result;
   return {
     isValid: false,
-    error: "SEI addresses must be 0x-prefixed EVM or sei1 bech32 strings."
+    error: prefix === "sei" ? "SEI addresses must be 0x-prefixed EVM or sei1 bech32 strings." : `Address must be a valid ${prefix}1 bech32 string.`
   };
 }
 function validateSolanaAddress(address) {
@@ -1539,15 +1548,12 @@ function validateAddressForChain(address, chain) {
     case "bitcoin":
       return validateBtcAddress(trimmed);
     case "cosmos":
-      if (chainDef?.networkIdentifier?.toLowerCase() === "sei") {
-        return validateSeiAddress(trimmed);
-      }
-      return validateBech32LikeAddress(trimmed, "sei");
+      return validateCosmosAddress(trimmed, chainDef ?? chain);
     default:
       return { isValid: false, error: "Unsupported or unknown chain type." };
   }
 }
-function validateAddressForRouteChain(address, chainType) {
+function validateAddressForRouteChain(address, chainType, chainRef) {
   switch (normalizeChainType(chainType)) {
     case "evm":
       return validateEvmAddress(address);
@@ -1556,7 +1562,7 @@ function validateAddressForRouteChain(address, chainType) {
     case "bitcoin":
       return validateBtcAddress(address);
     case "cosmos":
-      return validateSeiAddress(address);
+      return validateCosmosAddress(address, chainRef ?? chainType);
     default:
       return { isValid: false, error: "Unsupported chain type." };
   }
@@ -1578,14 +1584,18 @@ function validateRouteAddresses(params) {
   const normalizedDirection = params.direction?.trim().toLowerCase();
   const isDepositFlow = normalizedDirection === "deposit" || (toType === "evm" || toType === "cosmos") && (fromType === "bitcoin" || fromType === "solana");
   if (isDepositFlow) {
-    const fromResult2 = validateAddressForRouteChain(fromAddress, fromType);
+    const fromResult2 = validateAddressForRouteChain(
+      fromAddress,
+      fromType,
+      params.fromChain
+    );
     if (!fromResult2.isValid) {
       return {
         isValid: false,
         error: `From address: ${fromResult2.error ?? "Invalid address."}`
       };
     }
-    const toResult2 = toType === "cosmos" ? validateSeiAddress(toAddress) : validateEvmAddress(toAddress);
+    const toResult2 = toType === "cosmos" ? validateCosmosAddress(toAddress, params.toChain) : validateEvmAddress(toAddress);
     if (!toResult2.isValid) {
       return {
         isValid: false,
@@ -1610,14 +1620,22 @@ function validateRouteAddresses(params) {
     }
     return { isValid: true };
   }
-  const fromResult = validateAddressForRouteChain(fromAddress, fromType);
+  const fromResult = validateAddressForRouteChain(
+    fromAddress,
+    fromType,
+    params.fromChain
+  );
   if (!fromResult.isValid) {
     return {
       isValid: false,
       error: `From address: ${fromResult.error ?? "Invalid address."}`
     };
   }
-  const toResult = validateAddressForRouteChain(toAddress, toType);
+  const toResult = validateAddressForRouteChain(
+    toAddress,
+    toType,
+    params.toChain
+  );
   if (!toResult.isValid) {
     return {
       isValid: false,
@@ -1626,7 +1644,7 @@ function validateRouteAddresses(params) {
   }
   return { isValid: true };
 }
-var import_viem, BECH32_CHARSET;
+var import_viem, BECH32_CHARSET, COSMOS_BECH32_PREFIX_BY_CHAIN_ID;
 var init_address = __esm({
   "src/validation/address.ts"() {
     "use strict";
@@ -1634,6 +1652,12 @@ var init_address = __esm({
     init_index_node4();
     init_chains();
     BECH32_CHARSET = /^[023456789acdefghjklmnpqrstuvwxyz]+$/i;
+    COSMOS_BECH32_PREFIX_BY_CHAIN_ID = {
+      "pacific-1": "sei",
+      sei: "sei",
+      "cataclysm-1": "nibi",
+      nibiru: "nibi"
+    };
   }
 });
 
@@ -2031,6 +2055,20 @@ async function requestSDKRPC(path, init = {}) {
     }
   );
 }
+async function getEVMAllowance(params) {
+  const search = new URLSearchParams(params);
+  return requestSDKRPC(
+    `/evm/allowance?${search.toString()}`,
+    { method: "GET" }
+  );
+}
+async function getEVMTxStatus(params) {
+  const search = new URLSearchParams(params);
+  return requestSDKRPC(
+    `/evm/tx-status?${search.toString()}`,
+    { method: "GET" }
+  );
+}
 async function sendSolanaSerialized(body) {
   return requestSDKRPC(
     "/solana/send-serialized",
@@ -3904,6 +3942,27 @@ var init_wallets = __esm({
 });
 
 // src/core/routes.ts
+function assertValidPostHook(hooks) {
+  const postHook = hooks?.postHook;
+  if (!postHook) return;
+  if (!postHook.target?.trim()) {
+    throw new Error("hooks.postHook.target is required.");
+  }
+  if (!postHook.callData?.trim()) {
+    throw new Error("hooks.postHook.callData is required.");
+  }
+  if (postHook.fullAmount) {
+    if (postHook.amountInputPos === void 0) {
+      throw new Error(
+        "hooks.postHook.amountInputPos is required when fullAmount is true."
+      );
+    }
+  } else if (!postHook.fundAmount?.trim()) {
+    throw new Error(
+      "hooks.postHook.fundAmount is required unless fullAmount is set."
+    );
+  }
+}
 function isEvmTxRequest(txReq) {
   return Boolean(txReq?.data && (txReq.to || txReq.target));
 }
@@ -3922,6 +3981,7 @@ async function buildRoute(body, signal) {
   if (!addressValidation.isValid) {
     throw new Error(addressValidation.error || "Invalid route addresses.");
   }
+  assertValidPostHook(body.hooks);
   const cfg = TrustwareConfigStore.get();
   const url = `${apiBase()}/v1/routes/route`;
   const payload = {
@@ -3960,6 +4020,7 @@ async function buildRoute(body, signal) {
   return { intentId, txReq, actions, finalExchangeRate, route, sponsorship };
 }
 async function buildDepositAddress(body, signal) {
+  assertValidPostHook(body.hooks);
   const cfg = TrustwareConfigStore.get();
   const url = `${apiBase()}/v1/routes/deposit-address`;
   const payload = {
@@ -4001,7 +4062,7 @@ async function buildDepositAddress(body, signal) {
     route
   };
 }
-async function submitReceipt(intentId, txHash, sponsorshipRequestId) {
+async function submitReceipt(intentId, txHash, sponsorshipRequestId, eoaAddress) {
   const r = await rateLimitedFetch(
     `${apiBase()}/v1/route-intent/${intentId}/receipt`,
     {
@@ -4009,7 +4070,8 @@ async function submitReceipt(intentId, txHash, sponsorshipRequestId) {
       headers: jsonHeaders({ "Idempotency-Key": txHash }),
       body: JSON.stringify({
         txHash,
-        ...sponsorshipRequestId ? { sponsorshipRequestId } : {}
+        ...sponsorshipRequestId ? { sponsorshipRequestId } : {},
+        ...eoaAddress ? { eoaAddress } : {}
       })
     }
   );
@@ -4131,7 +4193,9 @@ var init_chainHelpers = __esm({
       btc: "bitcoin",
       bitcoin: "bitcoin",
       sei: "cosmos",
-      "pacific-1": "cosmos"
+      "pacific-1": "cosmos",
+      nibiru: "cosmos",
+      "cataclysm-1": "cosmos"
     };
     SEI_EVM_CHAIN_ID = "1329";
     SEI_COSMOS_CHAIN_ID = "pacific-1";
@@ -4285,7 +4349,8 @@ function filterSupportedChains(chains) {
     }
     if (chainType === "cosmos") {
       const seiKey = canonicalSeiChainKey(chain.chainId ?? chain.id);
-      if (seiKey !== "sei" && seiKey !== "pacific-1") {
+      const isNibiru = normalizeChainKey2(chain.chainId ?? chain.id) === NIBIRU_COSMOS_CHAIN_ID;
+      if (seiKey !== "sei" && !isNibiru) {
         return false;
       }
     }
@@ -4385,7 +4450,7 @@ function useChains() {
     error
   };
 }
-var import_react2, POPULAR_CHAINS_BY_TVL, POPULAR_LIMIT;
+var import_react2, POPULAR_CHAINS_BY_TVL, POPULAR_LIMIT, NIBIRU_COSMOS_CHAIN_ID;
 var init_useChains = __esm({
   "src/core/useChains.ts"() {
     "use strict";
@@ -4396,6 +4461,7 @@ var init_useChains = __esm({
     init_popularChains();
     POPULAR_CHAINS_BY_TVL = popularChains_default.byTvl;
     POPULAR_LIMIT = popularChains_default.popularLimit;
+    NIBIRU_COSMOS_CHAIN_ID = "cataclysm-1";
   }
 });
 
@@ -6180,46 +6246,80 @@ function normalizeSlippage(v) {
   if (n > 5) return 5;
   return n;
 }
+function warnDeprecatedSwapModeFlag() {
+  if (hasWarnedDeprecatedSwapModeFlag) return;
+  hasWarnedDeprecatedSwapModeFlag = true;
+  console.warn(
+    '[Trustware SDK] `features.swapMode` is deprecated \u2014 use `mode: "swap"` on the top-level config instead.'
+  );
+}
+function resolveMode(input) {
+  if (input.mode === "swap") return "swap";
+  if (input.mode === "deposit") return "deposit";
+  if (input.features?.swapMode) {
+    warnDeprecatedSwapModeFlag();
+    return "swap";
+  }
+  return "deposit";
+}
 function resolveConfig(input) {
   if (!input?.apiKey) {
-    throw new Error("TrustwareConfig: 'apiKey' is required.");
+    throw new TrustwareError({
+      code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+      message: "TrustwareConfig: 'apiKey' is required.",
+      userMessage: "Missing required API key configuration."
+    });
   }
-  if (!input.routes?.toChain || !input.routes?.toToken) {
-    throw new Error(
-      "TrustwareConfig: 'routes.toChain' and 'routes.toToken' are required."
-    );
+  const mode = resolveMode(input);
+  if (mode === "deposit" && (!input.routes?.toChain || !input.routes?.toToken)) {
+    throw new TrustwareError({
+      code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+      message: "TrustwareConfig: 'routes.toChain' and 'routes.toToken' are required in deposit mode.",
+      userMessage: "Missing required destination chain/token configuration."
+    });
   }
-  const toChain = input.routes.toChain;
-  if (input.routes.toAddress) {
+  const toChain = input.routes?.toChain;
+  if (input.routes?.toAddress && toChain) {
     const result = validateAddressForChain(input.routes.toAddress, toChain);
     if (!result.isValid) {
       console.error(`[Trustware SDK] Invalid toAddress: ${result.error}`);
-      throw new Error(`Invalid toAddress: ${result.error}`);
+      throw new TrustwareError({
+        code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+        message: `Invalid toAddress: ${result.error}`,
+        userMessage: "The configured destination address is invalid."
+      });
     }
   }
-  if (input.routes.fromAddress) {
-    const result = validateAddressForChain(
-      input.routes.fromAddress,
-      input.routes.fromChain ?? toChain
-    );
-    if (!result.isValid) {
-      console.error(`[Trustware SDK] Invalid fromAddress: ${result.error}`);
-      throw new Error(`Invalid fromAddress: ${result.error}`);
+  if (input.routes?.fromAddress) {
+    const fromChain = input.routes.fromChain ?? toChain;
+    if (fromChain) {
+      const result = validateAddressForChain(
+        input.routes.fromAddress,
+        fromChain
+      );
+      if (!result.isValid) {
+        console.error(`[Trustware SDK] Invalid fromAddress: ${result.error}`);
+        throw new TrustwareError({
+          code: "INVALID_CONFIG" /* INVALID_CONFIG */,
+          message: `Invalid fromAddress: ${result.error}`,
+          userMessage: "The configured source address is invalid."
+        });
+      }
     }
   }
   const autoDetectProvider = typeof input.autoDetectProvider === "boolean" ? input.autoDetectProvider : DEFAULT_AUTO_DETECT_PROVIDER;
   const routes = {
-    toChain: input.routes.toChain,
-    toToken: input.routes.toToken,
-    fromToken: input.routes.fromToken,
-    fromAddress: input.routes.fromAddress,
-    fromChain: input.routes.fromChain,
-    toAddress: input.routes.toAddress,
+    toChain: input.routes?.toChain ?? "",
+    toToken: input.routes?.toToken ?? "",
+    fromToken: input.routes?.fromToken,
+    fromAddress: input.routes?.fromAddress,
+    fromChain: input.routes?.fromChain,
+    toAddress: input.routes?.toAddress,
     defaultSlippage: normalizeSlippage(
-      input.routes.defaultSlippage ?? DEFAULT_SLIPPAGE
+      input.routes?.defaultSlippage ?? DEFAULT_SLIPPAGE
     ),
     options: {
-      ...input.routes.options
+      ...input.routes?.options
     }
   };
   const theme = input.theme ?? "system";
@@ -6238,13 +6338,16 @@ function resolveConfig(input) {
     tokensPagination: input.features?.tokensPagination ?? DEFAULT_FEATURE_FLAGS.tokensPagination,
     balanceStreaming: input.features?.balanceStreaming ?? DEFAULT_FEATURE_FLAGS.balanceStreaming,
     shouldAllowGA4: input.features?.shouldAllowGA4 ?? DEFAULT_FEATURE_FLAGS.shouldAllowGA4,
-    swapMode: input.features?.swapMode ?? DEFAULT_FEATURE_FLAGS.swapMode,
+    // Always mirrors the canonical `mode`, however the caller set it (new `mode` field
+    // or the deprecated `features.swapMode` flag).
+    swapMode: mode === "swap",
     swapDefaultDestToken: input.features?.swapDefaultDestToken ?? DEFAULT_FEATURE_FLAGS.swapDefaultDestToken,
     swapLockDestToken: input.features?.swapLockDestToken ?? DEFAULT_FEATURE_FLAGS.swapLockDestToken,
     swapAllowedDestTokens: input.features?.swapAllowedDestTokens ?? DEFAULT_FEATURE_FLAGS.swapAllowedDestTokens
   };
   return {
     apiKey: input.apiKey,
+    mode,
     routes,
     autoDetectProvider,
     theme,
@@ -6257,12 +6360,15 @@ function resolveConfig(input) {
     onEvent: input.onEvent
   };
 }
+var hasWarnedDeprecatedSwapModeFlag;
 var init_merge = __esm({
   "src/config/merge.ts"() {
     "use strict";
     init_defaults();
     init_config();
     init_index();
+    init_TrustwareError();
+    hasWarnedDeprecatedSwapModeFlag = false;
   }
 });
 
@@ -6351,6 +6457,87 @@ function backendChainId(chain, fallback) {
   const preferred = chain?.networkIdentifier ?? chain?.chainId ?? chain?.id;
   return String(preferred ?? fallback ?? "");
 }
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function sendEvmTx(w, tx) {
+  if (w.type === "eip1193") {
+    const from = await w.getAddress();
+    const params = {
+      from,
+      to: tx.to,
+      data: tx.data,
+      value: tx.value ? `0x${tx.value.toString(16)}` : "0x0"
+    };
+    if (tx.chainId !== void 0) {
+      params.chainId = `0x${tx.chainId.toString(16)}`;
+    }
+    const hash = await w.request({
+      method: "eth_sendTransaction",
+      params: [params]
+    });
+    return hash;
+  }
+  const response = await w.sendTransaction({
+    to: tx.to,
+    data: tx.data,
+    value: tx.value,
+    chainId: tx.chainId
+  });
+  return response.hash;
+}
+async function waitForTxConfirmation(chainId, txHash) {
+  const timeoutMs = 12e4;
+  const intervalMs = 2e3;
+  const started = Date.now();
+  while (Date.now() - started < timeoutMs) {
+    const status = await getEVMTxStatus({ chainId, txHash });
+    if (status.status === "success") return;
+    if (status.status === "reverted") {
+      throw new Error("Approval transaction reverted");
+    }
+    await sleep2(intervalMs);
+  }
+  throw new Error("Timed out waiting for approval confirmation");
+}
+async function ensureApprovals(w, approvals, fallbackChainId) {
+  if (!approvals || approvals.length === 0) return;
+  const owner = await w.getAddress();
+  for (const approval of approvals) {
+    const spender = approval.spender;
+    const tokenAddress = approval.tokenAddress;
+    const amount = approval.amount;
+    if (!spender || !tokenAddress || !amount) continue;
+    const chainId = approval.chainId || String(fallbackChainId ?? "");
+    if (!chainId) continue;
+    const amountWei = BigInt(amount);
+    if (amountWei === 0n) continue;
+    let currentAllowance = 0n;
+    try {
+      const { allowance } = await getEVMAllowance({
+        chainId,
+        tokenAddress,
+        ownerAddress: owner,
+        spenderAddress: spender
+      });
+      currentAllowance = BigInt(allowance || "0");
+    } catch {
+    }
+    if (currentAllowance >= amountWei) continue;
+    const data = (0, import_viem2.encodeFunctionData)({
+      abi: erc20ApproveAbi,
+      functionName: "approve",
+      args: [spender, amountWei]
+    });
+    const hash = await sendEvmTx(w, {
+      to: tokenAddress,
+      data,
+      value: 0n,
+      chainId: Number.isFinite(Number(chainId)) ? Number(chainId) : void 0
+    });
+    await waitForTxConfirmation(chainId, hash);
+  }
+}
 function isUserRejected(e2) {
   const code = e2?.code ?? e2?.data?.code;
   if (code === 4001) return true;
@@ -6384,6 +6571,13 @@ async function sendRouteTransaction(b, fallbackChainId) {
         }
       }
     }
+    if (!validatedSponsorship) {
+      await ensureApprovals(
+        w,
+        b.route?.execution?.approvals,
+        Number.isFinite(target) ? target : void 0
+      );
+    }
     if (w.type === "eip1193") {
       const from = await w.getAddress();
       const hexValue = value ? `0x${value.toString(16)}` : "0x0";
@@ -6480,13 +6674,17 @@ async function runTopUp(params) {
     }
   }
 }
-var import_viem2;
+var import_viem2, erc20ApproveAbi;
 var init_tx = __esm({
   "src/core/tx.ts"() {
     "use strict";
     init_wallets();
     init_routes();
+    init_sdkRpc();
     import_viem2 = require("viem");
+    erc20ApproveAbi = (0, import_viem2.parseAbi)([
+      "function approve(address spender, uint256 amount) returns (bool)"
+    ]);
   }
 });