@t2000/sdk 5.5.1 → 5.6.0

package/dist/browser.cjs

@@ -442,10 +442,60 @@ async function executeTx(client, signer, buildTx, options = {}) {
   }
   return { digest: txn.digest, gasCostSui, effects };
 }
+var PREFLIGHT_MAX_AMOUNT = 1e6;
+var PREFLIGHT_OK = { valid: true };
+function preflightFail(code, error) {
+  return { valid: false, code, error };
+}
+function checkPositiveAmount(amount, label = "Amount", max = PREFLIGHT_MAX_AMOUNT) {
+  if (typeof amount !== "number" || !Number.isFinite(amount)) {
+    return preflightFail("INVALID_AMOUNT", `${label} must be a finite number`);
+  }
+  if (amount <= 0) {
+    return preflightFail("INVALID_AMOUNT", `${label} must be greater than zero`);
+  }
+  if (amount > max) {
+    return preflightFail("INVALID_AMOUNT", `${label} ${amount} exceeds the sane maximum (${max})`);
+  }
+  return PREFLIGHT_OK;
+}
+function checkSuiAddress(address, label = "recipient") {
+  try {
+    if (typeof address === "string" && address.trim() !== "" && utils.isValidSuiAddress(utils.normalizeSuiAddress(address))) {
+      return PREFLIGHT_OK;
+    }
+  } catch {
+  }
+  return preflightFail("INVALID_ADDRESS", `Invalid ${label} address: ${address}`);
+}
 
 // src/wallet/pay.ts
+function preflightPay(input) {
+  if (typeof input.url !== "string" || input.url.trim() === "") {
+    return preflightFail("FACILITATOR_REJECTION", "A target URL is required to pay");
+  }
+  let parsed;
+  try {
+    parsed = new URL(input.url);
+  } catch {
+    return preflightFail("FACILITATOR_REJECTION", `Invalid URL: ${input.url}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    return preflightFail(
+      "FACILITATOR_REJECTION",
+      `URL must be http(s): got ${parsed.protocol}//`
+    );
+  }
+  if (input.maxPrice !== void 0) {
+    const priceCheck = checkPositiveAmount(input.maxPrice, "maxPrice");
+    if (!priceCheck.valid) return priceCheck;
+  }
+  return PREFLIGHT_OK;
+}
 async function payWithMpp(args) {
   const { signer, client, options } = args;
+  const pf = preflightPay({ url: options.url, maxPrice: options.maxPrice });
+  if (!pf.valid) throw new exports.T2000Error(pf.code, pf.error);
   const method = (options.method ?? "GET").toUpperCase();
   const canHaveBody = method !== "GET" && method !== "HEAD";
   const reqInit = {
@@ -537,14 +587,14 @@ async function ensureAddressBalanceCovers(args) {
   const addressBalance = total - coinSum;
   if (addressBalance >= amountRaw) return 0;
   const shortfall = amountRaw - addressBalance;
-  const { Transaction: Transaction2 } = await import('@mysten/sui/transactions');
+  const { Transaction: Transaction3 } = await import('@mysten/sui/transactions');
   const { selectAndSplitCoin: selectAndSplitCoin2 } = await Promise.resolve().then(() => (init_coinSelection(), coinSelection_exports));
   const grpcClient = await makeGrpcBuildClient(client);
   const migration = await executeTx(
     client,
     signer,
     async () => {
-      const tx = new Transaction2();
+      const tx = new Transaction3();
       const { coin } = await selectAndSplitCoin2(tx, client, owner, asset, shortfall, {
         sponsoredContext: true,
         // coin-objects-only — never the address balance
@@ -656,12 +706,35 @@ var SUPPORTED_ASSETS = {
   }
 };
 var STABLE_ASSETS = ["USDC", "USDsui"];
-({
+var OPERATION_ASSETS = {
+  send: ["USDC", "USDsui", "SUI"],
+  swap: "*"
+};
+function isAllowedAsset(op, asset) {
+  const allowed = OPERATION_ASSETS[op];
+  if (allowed === "*") return true;
+  const target = asset.toLowerCase();
+  return allowed.some((a) => a.toLowerCase() === target);
+}
+function assertAllowedAsset(op, asset) {
+  if (!asset) return;
+  if (!isAllowedAsset(op, asset)) {
+    const allowed = OPERATION_ASSETS[op];
+    const list = Array.isArray(allowed) ? allowed.join(", ") : "any";
+    const swapHint = " Swap to USDC or USDsui first, or send SUI." ;
+    throw new exports.T2000Error(
+      "INVALID_ASSET",
+      `${op} only supports ${list}. Cannot use ${asset}.${swapHint}`
+    );
+  }
+}
+var GASLESS_STABLE_TYPES = {
   USDC: SUPPORTED_ASSETS.USDC.type,
   USDsui: SUPPORTED_ASSETS.USDsui.type
-});
+};
 var T2000_OVERLAY_FEE_WALLET = process.env.T2000_OVERLAY_FEE_WALLET ?? "0x5366efbf2b4fe5767fe2e78eb197aa5f5d138d88ac3333fbf3f80a1927da473a";
 var DEFAULT_NETWORK = "mainnet";
+var GASLESS_MIN_STABLE_AMOUNT = 0.01;
 var GAS_RESERVE_MIN = 0.05;
 init_errors();
 function validateAddress(address) {
@@ -902,6 +975,9 @@ function rawToStable(raw, decimals) {
 function getDecimals(asset) {
   return SUPPORTED_ASSETS[asset].decimals;
 }
+function displayToRaw(amount, decimals) {
+  return BigInt(Math.round(amount * 10 ** decimals));
+}
 function formatUsd(amount) {
   return `$${amount.toFixed(2)}`;
 }
@@ -939,6 +1015,23 @@ function fromBase642(b64) {
 // src/protocols/cetus-swap.ts
 init_token_registry();
 init_token_registry();
+function preflightSwap(input) {
+  if (typeof input.from !== "string" || input.from.trim() === "") {
+    return preflightFail("INVALID_ASSET", "A `from` token is required to swap");
+  }
+  if (typeof input.to !== "string" || input.to.trim() === "") {
+    return preflightFail("INVALID_ASSET", "A `to` token is required to swap");
+  }
+  const amountCheck = checkPositiveAmount(input.amount, "Amount", Number.POSITIVE_INFINITY);
+  if (!amountCheck.valid) return amountCheck;
+  const resolvedFrom = resolveTokenType(input.from);
+  const resolvedTo = resolveTokenType(input.to);
+  const sameToken = input.from.trim() === input.to.trim() || resolvedFrom !== null && resolvedFrom === resolvedTo;
+  if (sameToken) {
+    return preflightFail("INVALID_ASSET", `Cannot swap ${input.from} to itself`);
+  }
+  return PREFLIGHT_OK;
+}
 var OVERLAY_FEE_RATE = 1e-3;
 var clientCache = /* @__PURE__ */ new Map();
 function getClient(walletAddress, overlayFee) {
@@ -1004,6 +1097,64 @@ async function buildSwapTx(params) {
   });
   return outputCoin;
 }
+init_errors();
+function preflightSend(input) {
+  try {
+    assertAllowedAsset("send", input.asset);
+  } catch (e) {
+    return preflightFail("INVALID_ASSET", e.message);
+  }
+  const amountCheck = checkPositiveAmount(input.amount);
+  if (!amountCheck.valid) return amountCheck;
+  if ((input.asset === "USDC" || input.asset === "USDsui") && input.amount < GASLESS_MIN_STABLE_AMOUNT) {
+    return preflightFail(
+      "INVALID_AMOUNT",
+      `Minimum gasless transfer is ${GASLESS_MIN_STABLE_AMOUNT} ${input.asset}. Got ${input.amount}.`
+    );
+  }
+  const addressCheck = checkSuiAddress(input.to);
+  if (!addressCheck.valid) return addressCheck;
+  return PREFLIGHT_OK;
+}
+async function buildSendTx({
+  client,
+  address,
+  to,
+  amount,
+  asset
+}) {
+  const pf = preflightSend({ to, amount, asset });
+  if (!pf.valid) throw new exports.T2000Error(pf.code, pf.error);
+  const recipient = validateAddress(to);
+  const assetInfo = SUPPORTED_ASSETS[asset];
+  if (!assetInfo) throw new exports.T2000Error("ASSET_NOT_SUPPORTED", `Asset ${asset} is not supported`);
+  const rawAmount = displayToRaw(amount, assetInfo.decimals);
+  const tx = new transactions.Transaction();
+  tx.setSender(address);
+  const balanceResp = await client.core.getBalance({ owner: address, coinType: assetInfo.type });
+  const totalBalance = BigInt(balanceResp.balance.balance);
+  if (totalBalance < rawAmount) {
+    throw new exports.T2000Error("INSUFFICIENT_BALANCE", `Insufficient ${asset} balance`, {
+      available: Number(totalBalance) / 10 ** assetInfo.decimals,
+      required: amount
+    });
+  }
+  if (asset === "SUI") {
+    const [sendCoin] = tx.splitCoins(tx.gas, [rawAmount]);
+    tx.transferObjects([sendCoin], recipient);
+    return tx;
+  }
+  const coinType = GASLESS_STABLE_TYPES[asset];
+  tx.moveCall({
+    target: "0x2::balance::send_funds",
+    typeArguments: [coinType],
+    arguments: [
+      tx.balance({ type: coinType, balance: rawAmount }),
+      tx.pure.address(recipient)
+    ]
+  });
+  return tx;
+}
 
 // src/browser.ts
 init_token_registry();
@@ -1016,13 +1167,18 @@ exports.KeypairSigner = KeypairSigner;
 exports.LABEL_PATTERNS = LABEL_PATTERNS;
 exports.MIST_PER_SUI = MIST_PER_SUI;
 exports.OVERLAY_FEE_RATE = OVERLAY_FEE_RATE;
+exports.PREFLIGHT_MAX_AMOUNT = PREFLIGHT_MAX_AMOUNT;
+exports.PREFLIGHT_OK = PREFLIGHT_OK;
 exports.STABLE_ASSETS = STABLE_ASSETS;
 exports.SUI_DECIMALS = SUI_DECIMALS;
 exports.SUPPORTED_ASSETS = SUPPORTED_ASSETS;
 exports.T2000_OVERLAY_FEE_WALLET = T2000_OVERLAY_FEE_WALLET;
 exports.USDC_DECIMALS = USDC_DECIMALS;
 exports.ZkLoginSigner = ZkLoginSigner;
+exports.buildSendTx = buildSendTx;
 exports.buildSwapTx = buildSwapTx;
+exports.checkPositiveAmount = checkPositiveAmount;
+exports.checkSuiAddress = checkSuiAddress;
 exports.classifyAction = classifyAction;
 exports.classifyLabel = classifyLabel;
 exports.classifyTransaction = classifyTransaction;
@@ -1044,6 +1200,10 @@ exports.mapWalletError = mapWalletError;
 exports.mistToSui = mistToSui;
 exports.parseSuiRpcTx = parseSuiRpcTx;
 exports.payWithMpp = payWithMpp;
+exports.preflightFail = preflightFail;
+exports.preflightPay = preflightPay;
+exports.preflightSend = preflightSend;
+exports.preflightSwap = preflightSwap;
 exports.rawToStable = rawToStable;
 exports.rawToUsdc = rawToUsdc;
 exports.refineLendingLabel = refineLendingLabel;