@t2000/sdk 5.5.0 → 5.6.0

package/dist/index.js

@@ -1,3 +1,4 @@
+import { normalizeStructTag, isValidSuiAddress, normalizeSuiAddress, fromBase64 } from '@mysten/sui/utils';
 import { coinWithBalance, Transaction } from '@mysten/sui/transactions';
 import { AggregatorClient, Env } from '@cetusprotocol/aggregator-sdk';
 import BN from 'bn.js';
@@ -5,7 +6,6 @@ import { EventEmitter } from 'eventemitter3';
 import { createPaymentTransactionUri } from '@mysten/payment-kit';
 import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { SuiGraphQLClient } from '@mysten/sui/graphql';
-import { normalizeStructTag, normalizeSuiAddress, isValidSuiAddress, fromBase64 } from '@mysten/sui/utils';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { decodeSuiPrivateKey } from '@mysten/sui/cryptography';
 import { access, mkdir, writeFile, readFile } from 'fs/promises';
@@ -112,6 +112,37 @@ var init_errors = __esm({
     };
   }
 });
+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() !== "" && isValidSuiAddress(normalizeSuiAddress(address))) {
+      return PREFLIGHT_OK;
+    }
+  } catch {
+  }
+  return preflightFail("INVALID_ADDRESS", `Invalid ${label} address: ${address}`);
+}
+var PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK;
+var init_preflight = __esm({
+  "src/preflight.ts"() {
+    PREFLIGHT_MAX_AMOUNT = 1e6;
+    PREFLIGHT_OK = { valid: true };
+  }
+});
 
 // src/token-registry.ts
 var token_registry_exports = {};
@@ -376,10 +407,28 @@ __export(cetus_swap_exports, {
   findSwapRoute: () => findSwapRoute,
   isCetusRouteFresh: () => isCetusRouteFresh,
   isPrecomputedRouteCompatibleWithProviders: () => isPrecomputedRouteCompatibleWithProviders,
+  preflightSwap: () => preflightSwap,
   resolveTokenType: () => resolveTokenType,
   serializeCetusRoute: () => serializeCetusRoute,
   verifyCetusRouteCoinMatch: () => verifyCetusRouteCoinMatch
 });
+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;
+}
 function serializeCetusRoute(route, context) {
   return {
     routerData: serializeRouterDataV3(route.routerData),
@@ -631,6 +680,7 @@ var OVERLAY_FEE_RATE, clientCache;
 var init_cetus_swap = __esm({
   "src/protocols/cetus-swap.ts"() {
     init_token_registry();
+    init_preflight();
     init_token_registry();
     OVERLAY_FEE_RATE = 1e-3;
     clientCache = /* @__PURE__ */ new Map();
@@ -1004,8 +1054,33 @@ async function executeTx(client, signer, buildTx, options = {}) {
 
 // src/wallet/pay.ts
 init_errors();
+init_preflight();
+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 T2000Error(pf.code, pf.error);
   const method = (options.method ?? "GET").toUpperCase();
   const canHaveBody = method !== "GET" && method !== "HEAD";
   const reqInit = {
@@ -1240,6 +1315,25 @@ function normalizeAsset(input) {
 }
 
 // src/wallet/send.ts
+init_preflight();
+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,
@@ -1247,17 +1341,11 @@ async function buildSendTx({
   amount,
   asset
 }) {
-  assertAllowedAsset("send", asset);
+  const pf = preflightSend({ to, amount, asset });
+  if (!pf.valid) throw new T2000Error(pf.code, pf.error);
   const recipient = validateAddress(to);
   const assetInfo = SUPPORTED_ASSETS[asset];
   if (!assetInfo) throw new T2000Error("ASSET_NOT_SUPPORTED", `Asset ${asset} is not supported`);
-  if (amount <= 0) throw new T2000Error("INVALID_AMOUNT", "Amount must be greater than zero");
-  if ((asset === "USDC" || asset === "USDsui") && amount < GASLESS_MIN_STABLE_AMOUNT) {
-    throw new T2000Error(
-      "INVALID_AMOUNT",
-      `Minimum gasless transfer is ${GASLESS_MIN_STABLE_AMOUNT} ${asset}. Got ${amount}.`
-    );
-  }
   const rawAmount = displayToRaw(amount, assetInfo.decimals);
   const tx = new Transaction();
   tx.setSender(address);
@@ -1552,7 +1640,7 @@ var TX_NODE_FRAGMENT = `
   }
 `;
 var HISTORY_QUERY = `query History($address: SuiAddress!, $last: Int!) {
-  transactions(last: $last, filter: { sentAddress: $address }) {
+  transactions(last: $last, filter: { affectedAddress: $address }) {
     nodes {${TX_NODE_FRAGMENT}}
   }
 }`;
@@ -1679,7 +1767,12 @@ function extractCommands(txBlock) {
 init_token_registry();
 
 // src/utils/suins.ts
-var SUI_MAINNET_URL = "https://fullnode.mainnet.sui.io:443";
+var RESOLVE_NAME_QUERY = `query ResolveSuins($name: String!) {
+  address(name: $name) { address }
+}`;
+var REVERSE_NAME_QUERY = `query ReverseSuins($address: SuiAddress!) {
+  address(address: $address) { defaultNameRecord { domain } }
+}`;
 var SUI_ADDRESS_REGEX = /^0x[a-fA-F0-9]{1,64}$/i;
 var SUI_ADDRESS_STRICT_REGEX = /^0x[a-fA-F0-9]{64}$/i;
 var SUINS_NAME_REGEX = /^[a-z0-9-]+(\.[a-z0-9-]+)*\.sui$/;
@@ -1717,76 +1810,45 @@ async function resolveSuinsViaRpc(rawName, ctx = {}) {
   if (!SUINS_NAME_REGEX.test(name)) {
     throw new InvalidAddressError(rawName);
   }
-  const url = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  const gql = getSuiGraphQLClient();
   let res;
   try {
-    res = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 1,
-        method: "suix_resolveNameServiceAddress",
-        params: [name]
-      }),
-      signal: ctx.signal ?? AbortSignal.timeout(8e3)
+    res = await gql.query({
+      query: RESOLVE_NAME_QUERY,
+      variables: { name },
+      signal: ctx.signal
     });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     throw new SuinsRpcError(name, msg);
   }
-  if (!res.ok) {
-    throw new SuinsRpcError(name, `HTTP ${res.status}`);
-  }
-  let body;
-  try {
-    body = await res.json();
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new SuinsRpcError(name, `JSON parse failed: ${msg}`);
-  }
-  if (body.error) {
-    throw new SuinsRpcError(name, body.error.message);
+  if (res.errors?.length) {
+    throw new SuinsRpcError(name, res.errors.map((e) => e.message ?? "unknown error").join("; "));
   }
-  return body.result ?? null;
+  return res.data?.address?.address ?? null;
 }
 async function resolveAddressToSuinsViaRpc(rawAddress, ctx = {}) {
   const address = rawAddress.trim().toLowerCase();
   if (!SUI_ADDRESS_REGEX.test(address)) {
     throw new InvalidAddressError(rawAddress);
   }
-  const url = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  const gql = getSuiGraphQLClient();
   let res;
   try {
-    res = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        id: 1,
-        method: "suix_resolveNameServiceNames",
-        params: [address]
-      }),
-      signal: ctx.signal ?? AbortSignal.timeout(8e3)
+    res = await gql.query({
+      query: REVERSE_NAME_QUERY,
+      variables: { address },
+      signal: ctx.signal
     });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     throw new SuinsRpcError(address, msg);
   }
-  if (!res.ok) {
-    throw new SuinsRpcError(address, `HTTP ${res.status}`);
-  }
-  let body;
-  try {
-    body = await res.json();
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new SuinsRpcError(address, `JSON parse failed: ${msg}`);
-  }
-  if (body.error) {
-    throw new SuinsRpcError(address, body.error.message);
+  if (res.errors?.length) {
+    throw new SuinsRpcError(address, res.errors.map((e) => e.message ?? "unknown error").join("; "));
   }
-  return body.result?.data ?? [];
+  const domain = res.data?.address?.defaultNameRecord?.domain;
+  return domain ? [domain] : [];
 }
 async function normalizeAddressInput(value, ctx = {}) {
   const trimmed = value.trim();
@@ -2079,7 +2141,9 @@ var T2000 = class _T2000 extends EventEmitter {
       amountUsd: approxUsdValue(params.from, params.amount) ?? 0,
       force: params.force
     });
-    const { findSwapRoute: findSwapRoute2, buildSwapTx: buildSwapTx2, resolveTokenType: resolveTokenType2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+    const { findSwapRoute: findSwapRoute2, buildSwapTx: buildSwapTx2, resolveTokenType: resolveTokenType2, preflightSwap: preflightSwap2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+    const pf = preflightSwap2({ from: params.from, to: params.to, amount: params.amount });
+    if (!pf.valid) throw new T2000Error(pf.code, pf.error);
     const fromType = resolveTokenType2(params.from);
     const toType = resolveTokenType2(params.to);
     if (!fromType) throw new T2000Error("ASSET_NOT_SUPPORTED", `Unknown token: ${params.from}. Provide the full coin type.`);
@@ -2809,6 +2873,9 @@ function displayHandle(label) {
   return `${label}@${parentDisplay}`;
 }
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, DEFAULT_GRPC_URL, DEFAULT_NETWORK, ETH_TYPE, GASLESS_MIN_STABLE_AMOUNT, GASLESS_STABLE_TYPES, GAS_RESERVE_MIN, IKA_TYPE, InvalidAddressError, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, LimitEnforcer, LimitExceededError, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, OPERATION_ASSETS, OVERLAY_FEE_RATE, SENDABLE_ASSETS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SuinsNotRegisteredError, SuinsRpcError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addSendToTx, addSwapToTx, approxUsdValue, assertAllowedAsset, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, buildSwapTx, classifyAction, classifyLabel, classifyTransaction, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, executeTx, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getLimits, getSponsoredSwapProviders, getSuiClient, getSuiGrpcClient, getSwapQuote, hasLimits, isAllowedAsset, isCetusRouteFresh, isInRegistry, keypairFromPrivateKey, loadKey, looksLikeSuiNs, mapMoveAbortCode, mapWalletError, mistToSui, normalizeAddressInput, normalizeAsset, normalizeCoinType, parseSuiRpcTx, payWithMpp, queryHistory, queryTransaction, rawToStable, rawToUsdc, readLimitsFile, recordDailySpend, refineLendingLabel, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, resolveSymbol, resolveTokenType, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, setLimits, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists, writeLimitsFile };
+// src/index.ts
+init_preflight();
+
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, DEFAULT_GRPC_URL, DEFAULT_NETWORK, ETH_TYPE, GASLESS_MIN_STABLE_AMOUNT, GASLESS_STABLE_TYPES, GAS_RESERVE_MIN, IKA_TYPE, InvalidAddressError, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, LimitEnforcer, LimitExceededError, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, OPERATION_ASSETS, OVERLAY_FEE_RATE, PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK, SENDABLE_ASSETS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SuinsNotRegisteredError, SuinsRpcError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addSendToTx, addSwapToTx, approxUsdValue, assertAllowedAsset, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, buildSwapTx, checkPositiveAmount, checkSuiAddress, classifyAction, classifyLabel, classifyTransaction, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, executeTx, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getLimits, getSponsoredSwapProviders, getSuiClient, getSuiGrpcClient, getSwapQuote, hasLimits, isAllowedAsset, isCetusRouteFresh, isInRegistry, keypairFromPrivateKey, loadKey, looksLikeSuiNs, mapMoveAbortCode, mapWalletError, mistToSui, normalizeAddressInput, normalizeAsset, normalizeCoinType, parseSuiRpcTx, payWithMpp, preflightFail, preflightPay, preflightSend, preflightSwap, queryBalance, queryHistory, queryTransaction, rawToStable, rawToUsdc, readLimitsFile, recordDailySpend, refineLendingLabel, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, resolveSymbol, resolveTokenType, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, setLimits, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists, writeLimitsFile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map