@anywalletkit/protocol-swap2-core 0.6.1 → 0.7.0

package/dist/index.cjs

@@ -51,12 +51,14 @@ __export(src_exports, {
   nativeUnits: () => nativeUnits,
   ownerAssets: () => ownerAssets,
   redactUrls: () => redactUrls,
+  remotePinRefusal: () => remotePinRefusal,
   remoteProvider: () => remoteProvider,
   shortAddress: () => shortAddress,
   slippageClassOf: () => slippageClassOf,
   sourceAssetOf: () => sourceAssetOf,
   suggestSlippage: () => suggestSlippage,
   swap2ChainId: () => swap2ChainId,
+  tonRawAddress: () => tonRawAddress,
   validQuote: () => validQuote
 });
 module.exports = __toCommonJS(src_exports);
@@ -157,6 +159,19 @@ function validQuote(q, params, provider) {
     return false;
   }
 }
+function remotePinRefusal(provider, q, chain) {
+  if (provider.remote !== true || !chain.startsWith("eip155:")) return null;
+  const tx = q.txRequest;
+  if (!tx || tx.serializedTx !== void 0) return null;
+  const pinned = (list, address) => (list ?? []).some((a) => typeof a === "string" && a.toLowerCase() === address.toLowerCase());
+  if (tx.approvalAddress && !pinned(provider.spenders?.(chain), tx.approvalAddress)) {
+    return `${provider.name}: the route approves ${tx.approvalAddress}, which the app did not pin as a spender on ${chain} (remoteProvider spenders)`;
+  }
+  if (tx.data !== void 0 && tx.to && !pinned(provider.callTargets?.(chain), tx.to)) {
+    return `${provider.name}: the route calls ${tx.to}, which the app did not pin as a call target on ${chain} (remoteProvider callTargets)`;
+  }
+  return null;
+}
 
 // src/util.ts
 var import_swap2_assets = require("@anywalletkit/swap2-assets");
@@ -189,20 +204,90 @@ function anySignal(signals) {
   }
   return ctrl.signal;
 }
+var SCHEME_MAX = 32;
+var isLetter = (c) => c >= 97 && c <= 122 || c >= 65 && c <= 90;
+var isSchemeChar = (c) => isLetter(c) || c >= 48 && c <= 57 || c === 43 || c === 45 || c === 46;
+var endsUrl = (c) => c === 34 || c === 39 || c === 60 || c === 62 || c >= 9 && c <= 13 || c === 32 || c === 160 || c === 5760 || c >= 8192 && c <= 8202 || c === 8232 || c === 8233 || c === 8239 || c === 8287 || c === 12288 || c === 65279;
 function redactUrls(text) {
-  return text.replace(/\b[a-z][a-z0-9+.-]*:\/\/[^\s"'<>]+/gi, "<url>");
+  let out = "";
+  let done = 0;
+  for (let at = text.indexOf("://"); at !== -1; at = text.indexOf("://", at + 3)) {
+    let start = at;
+    while (start > done && at - start < SCHEME_MAX && isSchemeChar(text.charCodeAt(start - 1))) start--;
+    while (start < at && !isLetter(text.charCodeAt(start))) start++;
+    if (start === at) continue;
+    let end = at + 3;
+    while (end < text.length && !endsUrl(text.charCodeAt(end))) end++;
+    if (end === at + 3) continue;
+    out += `${text.slice(done, start)}<url>`;
+    done = end;
+    at = end - 3;
+  }
+  return done === 0 ? text : out + text.slice(done);
 }
 function sourceAssetOf(params) {
   const decimals = params.sourceDecimals;
   return (0, import_swap2_assets.resolveAsset)(params.sourceChain, params.sourceToken, decimals === void 0 ? {} : { allowUnlisted: true, decimals });
 }
+var B64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function base64Bytes(text) {
+  const s = text.replace(/-/g, "+").replace(/_/g, "/").replace(/=+$/, "");
+  if (!/^[A-Za-z0-9+/]*$/.test(s) || s.length % 4 === 1) return null;
+  const out = new Uint8Array(Math.floor(s.length * 3 / 4));
+  let bits = 0, acc = 0, n = 0;
+  for (const ch of s) {
+    acc = acc << 6 | B64.indexOf(ch);
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      out[n++] = acc >> bits & 255;
+    }
+  }
+  return out.subarray(0, n);
+}
+function crc16(bytes) {
+  let crc = 0;
+  for (const b of bytes) {
+    crc ^= b << 8;
+    for (let i = 0; i < 8; i++) crc = crc & 32768 ? (crc << 1 ^ 4129) & 65535 : crc << 1 & 65535;
+  }
+  return crc;
+}
+function tonRawAddress(address) {
+  if (address && typeof address === "object") {
+    const o = address;
+    if (typeof o.toRawString === "function") {
+      try {
+        return tonRawAddress(o.toRawString());
+      } catch {
+        return null;
+      }
+    }
+    if (typeof o.workChain === "number" && o.hash instanceof Uint8Array && o.hash.length === 32) {
+      return `${o.workChain}:${Array.from(o.hash, (b) => b.toString(16).padStart(2, "0")).join("")}`;
+    }
+    return null;
+  }
+  if (typeof address !== "string") return null;
+  const raw = /^(-?[0-9]{1,3}):([0-9a-fA-F]{64})$/.exec(address.trim());
+  if (raw) return `${Number(raw[1])}:${raw[2].toLowerCase()}`;
+  if (!/^[A-Za-z0-9+/_-]{48}$/.test(address.trim())) return null;
+  const bytes = base64Bytes(address.trim());
+  if (!bytes || bytes.length !== 36 || crc16(bytes.subarray(0, 34)) !== (bytes[34] << 8 | bytes[35])) return null;
+  const wc = bytes[1] === 255 ? -1 : bytes[1];
+  return `${wc}:${Array.from(bytes.subarray(2, 34), (b) => b.toString(16).padStart(2, "0")).join("")}`;
+}
 
 // src/remote.ts
 function remoteProvider(opts) {
   const name = opts.name;
   if (!/^[A-Za-z0-9_-]+$/.test(name)) throw new Error("swap2-remote: invalid provider name");
-  const baseUrl = opts.baseUrl.replace(/\/+$/, "");
+  const baseUrl = opts.baseUrl.trim().replace(/\/+$/, "");
   if (!baseUrl) throw new Error("swap2-remote: baseUrl is required");
+  const insecure = /^[a-z][a-z0-9+.-]*:/i.test(baseUrl) ? !/^https:\/\//i.test(baseUrl) : /^[\\/]{2}/.test(baseUrl);
+  if (insecure && opts.allowInsecureBaseUrl !== true) {
+    throw new Error("swap2-remote: baseUrl must be https:// or a same-origin path (allowInsecureBaseUrl for local development)");
+  }
   const supportsRoute = opts.supportsRoute;
   const enabled = opts.enabled;
   const headers = Object.freeze({ ...opts.headers });
@@ -211,6 +296,12 @@ function remoteProvider(opts) {
   if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 6e4) {
     throw new Error("swap2-remote: timeoutMs must be an integer between 1 and 60000");
   }
+  const requests = /* @__PURE__ */ new Map();
+  const remember = (intentId, params) => {
+    requests.delete(intentId);
+    requests.set(intentId, params);
+    if (requests.size > 64) requests.delete(requests.keys().next().value);
+  };
   async function call(action, body, signal) {
     const timeout = timeoutSignal(timeoutMs);
     const requestSignal = signal ? anySignal([signal, timeout]) : timeout;
@@ -231,6 +322,8 @@ function remoteProvider(opts) {
   }
   return {
     name,
+    remote: true,
+    ...opts.verifyBuild ? { verifiesBuilds: true } : {},
     // The browser side has no dark-flag env; the backend enforces its own
     // flags — a disabled provider simply quotes null / rejects build.
     enabled: () => enabled ? enabled() : true,
@@ -242,10 +335,30 @@ function remoteProvider(opts) {
       if (out && typeof out === "object" && "noQuote" in out) {
         throw new Error(String(out.noQuote).slice(0, 300));
       }
+      if (out && typeof out === "object" && typeof out.intentId === "string") remember(out.intentId, params);
+      if (out && opts.verifyQuote) {
+        let refusal;
+        try {
+          refusal = opts.verifyQuote(params, out);
+        } catch (e) {
+          refusal = e instanceof Error ? e.message : String(e);
+        }
+        if (refusal) throw new Error(`${name}: the quote fails this app's own check \u2014 ${refusal.slice(0, 240)}`);
+      }
       return out;
     },
     async buildDeposit(quote) {
-      return call("build", { quote });
+      const tx = await call("build", { quote });
+      if (opts.verifyBuild) {
+        let refusal;
+        try {
+          refusal = await opts.verifyBuild(quote, tx, requests.get(quote.intentId));
+        } catch (e) {
+          refusal = e instanceof Error ? e.message : String(e);
+        }
+        if (refusal) throw new Error(`${name}: the build fails this app's own check \u2014 ${refusal.slice(0, 240)}`);
+      }
+      return tx;
     },
     async preflightDeposit(quote, tx) {
       await call("preflight", { quote, tx });
@@ -267,7 +380,9 @@ function remoteProvider(opts) {
     ...opts.supportsChain ? { supportsChain: opts.supportsChain.bind(opts) } : {},
     ...opts.supportsChainPair ? { supportsChainPair: opts.supportsChainPair.bind(opts) } : {},
     ...opts.supportsSameChain !== void 0 ? { supportsSameChain: opts.supportsSameChain } : {},
-    ...opts.claimTargets ? { claimTargets: opts.claimTargets } : {}
+    ...opts.claimTargets ? { claimTargets: opts.claimTargets } : {},
+    ...opts.callTargets ? { callTargets: opts.callTargets } : {},
+    ...opts.spenders ? { spenders: opts.spenders } : {}
   };
 }
 
@@ -383,7 +498,64 @@ function normalizeTypedDomain(domain) {
   else if (typeof raw === "string" && /^0x[0-9a-fA-F]+$/.test(raw)) chainId = safeChainId(BigInt(raw));
   return chainId === void 0 || !Number.isSafeInteger(chainId) ? domain : { ...domain, chainId };
 }
+function assertTypedOrder(typedData, approvalAddress, e) {
+  const fail = (why) => new Swap2ValidationError(`swap2: typed order refused \u2014 ${why}`);
+  let parsed;
+  try {
+    parsed = JSON.parse(typedData);
+  } catch {
+    throw fail("the typed data is not JSON");
+  }
+  if (!parsed || typeof parsed !== "object") throw fail("the typed data is not an object");
+  const td = parsed;
+  const primary = td.primaryType;
+  if (typeof primary !== "string" || !primary) throw fail("it names no primaryType");
+  if (/^permit/i.test(primary)) throw fail(`${primary} is a token approval, not an order`);
+  if (primary !== "Order") throw fail(`primaryType ${primary} is not an order this engine signs`);
+  const fields = td.types?.Order;
+  const has = (name, type) => Array.isArray(fields) && fields.some((f) => f?.name === name && f?.type === type);
+  if (!has("maker", "address") || !has("makerAsset", "address") || !has("makingAmount", "uint256")) throw fail("the Order type has no maker / makerAsset / makingAmount");
+  const verifying = td.domain?.verifyingContract;
+  if (!approvalAddress || typeof verifying !== "string" || verifying.toLowerCase() !== approvalAddress.toLowerCase()) {
+    throw fail(`verifyingContract ${String(verifying)} is not the settlement contract the swap approves`);
+  }
+  if (e.chainId !== null && normalizeTypedDomain(td.domain)?.chainId !== e.chainId) throw fail("the domain chainId is not the source chain");
+  const m = td.message ?? {};
+  if (String(m.maker ?? "").toLowerCase() !== e.self.toLowerCase()) throw fail("the maker is not this account");
+  if (!e.token || String(m.makerAsset ?? "").toLowerCase() !== e.token.toLowerCase()) throw fail("the makerAsset is not the source token");
+  const raw = m.makingAmount;
+  const making = typeof raw === "string" && /^(?:0x[0-9a-fA-F]{1,64}|[0-9]{1,78})$/.test(raw) ? BigInt(raw) : typeof raw === "number" && Number.isSafeInteger(raw) ? BigInt(raw) : null;
+  if (making === null || making !== BigInt(e.amount)) throw fail(`makingAmount ${String(raw)} is not the swap's ${e.amount}`);
+}
 var DEFAULT_SERIALIZED_NATIVE_ALLOWANCE = 20000000n;
+var DEFAULT_TON_GAS_CEILING = 1000000000n;
+var JETTON_TRANSFER_OP = 260734629;
+function readTonBody(cell) {
+  let s;
+  try {
+    s = cell.beginParse();
+  } catch {
+    return { op: null };
+  }
+  let op;
+  try {
+    op = s.loadUint(32);
+  } catch {
+    return { op: null };
+  }
+  if (op !== JETTON_TRANSFER_OP) return { op };
+  try {
+    s.loadUintBig(64);
+    const amount = s.loadCoins();
+    const destination = tonRawAddress(s.loadAddress());
+    const response = s.loadMaybeAddress();
+    s.loadMaybeRef();
+    const forwardTon = s.loadCoins();
+    return { op, jettonTransfer: { amount, destination, responseDestination: response == null ? null : tonRawAddress(response), forwardTon } };
+  } catch {
+    return { op };
+  }
+}
 function reviewedIdentity(plan) {
   const { feeUsd: _fee, etaSeconds: _eta, validUntilMs: _valid, approvals: _approvals, destAmount: _dest, requoted: _requoted, ...pinned } = plan;
   return JSON.stringify(pinned, (_k, v) => typeof v === "bigint" ? v.toString() : v);
@@ -876,10 +1048,12 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
       throw new Error(`swap2: provider transaction chain ${unsigned.chainId} does not match ${this.fromChain}`);
     }
     let tokenId;
+    let engineTransfer = false;
     if (!unsigned.data && !unsigned.bodyBoc && !unsigned.typedData && !serialized) {
       const src = this.sourceAsset(executionOptions);
       if (src?.contract) {
         if (this.fromChain.startsWith("eip155:")) {
+          engineTransfer = true;
           unsigned = {
             ...unsigned,
             to: src.contract,
@@ -918,12 +1092,66 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
     } else if (!unsigned.typedData && !unsigned.bodyBoc && executionValue !== BigInt(q.sourceAmount) + declaredNativeFee(q, this.fromChain)) {
       throw new Error("swap2: provider execution amount does not match the validated quote");
     }
+    let tonBody;
+    if (cellBody !== void 0) {
+      const refuse = (why) => {
+        throw new Swap2ValidationError(`swap2: TON cell-body build refused \u2014 ${why}`);
+      };
+      const raw = this._config.tonGasCeiling;
+      const ceiling = raw === void 0 ? DEFAULT_TON_GAS_CEILING : BigInt(raw);
+      if (ceiling < 0n) throw new Swap2ConfigurationError("swap2: tonGasCeiling must be non-negative");
+      if (provider.remote === true && provider.verifiesBuilds !== true) refuse("a remote provider's cell body needs the app's own validator (remoteProvider verifyBuild)");
+      tonBody = readTonBody(cellBody);
+      const input = BigInt(q.sourceAmount);
+      if (source.contract) {
+        if (executionValue > ceiling) refuse(`it attaches ${executionValue} nanoTON to a jetton transfer, more than the ${ceiling} gas ceiling`);
+        const t = tonBody.jettonTransfer;
+        if (!t) refuse("a jetton-source body must be a jetton transfer");
+        if (t.amount !== input) refuse(`the jetton transfer moves ${t.amount}, not the swap's ${input}`);
+        if (!t.responseDestination || t.responseDestination !== tonRawAddress(selfAddress)) refuse("the jetton transfer returns its excess to another wallet");
+        if (t.forwardTon >= executionValue) refuse("the jetton transfer forwards more TON than the message carries");
+        const own = typeof signer.getJettonWalletAddress === "function" ? tonRawAddress(await signer.getJettonWalletAddress(source.contract)) : null;
+        if (!own) refuse("the account cannot name its own jetton wallet (getJettonWalletAddress), so the target cannot be checked");
+        if (tonRawAddress(unsigned.to) !== own) refuse(`it is sent to ${unsigned.to}, not this account's ${source.symbol ?? "source"} jetton wallet`);
+      } else {
+        if (executionValue < input || executionValue - input > ceiling) refuse(`it attaches ${executionValue} nanoTON for a ${input} input, more than the ${ceiling} gas ceiling on top`);
+        const pinned = provider.remote === true ? [...provider.callTargets?.(this.fromChain) ?? [], ...q.depositAddress ? [q.depositAddress] : []].map(tonRawAddress).filter((a) => !!a) : [];
+        if (pinned.length && !pinned.includes(tonRawAddress(unsigned.to) ?? "")) refuse(`remote provider '${q.provider}' sends it to ${unsigned.to}, which the app did not pin (remoteProvider callTargets)`);
+      }
+    }
+    const remote = provider.remote === true;
+    const pins = (list) => (list ?? []).filter((a) => typeof a === "string" && /^0x[0-9a-fA-F]{40}$/.test(a)).map((a) => a.toLowerCase());
+    const pinnedTargets = remote ? pins(provider.callTargets?.(this.fromChain)) : [];
+    const pinnedSpenders = remote ? pins(provider.spenders?.(this.fromChain)) : [];
+    if (remote && unsigned.approvalAddress && !pinnedSpenders.includes(unsigned.approvalAddress.toLowerCase())) {
+      throw new Swap2ValidationError(`swap2: remote provider '${q.provider}' asks to approve ${unsigned.approvalAddress} on ${this.fromChain}, which the app did not pin as a spender (remoteProvider spenders) \u2014 refused`);
+    }
+    if (unsigned.typedData !== void 0) {
+      const chainId = this.fromChain.startsWith("eip155:") ? Number(this.fromChain.slice("eip155:".length)) : null;
+      assertTypedOrder(unsigned.typedData, unsigned.approvalAddress, { self: selfAddress, token: source.contract ?? void 0, amount: q.sourceAmount, chainId });
+    }
     if (unsigned.data !== void 0 && this.fromChain.startsWith("eip155:")) {
       const call = (0, import_tx_preview_evm.decodeCall)({ to: unsigned.to, data: unsigned.data, value: executionValue });
-      const named = call.transfer?.to ?? call.approval?.spender;
-      const allowed = [selfAddress, q.depositAddress, unsigned.approvalAddress, unsigned.to].filter((a) => !!a).map((a) => a.toLowerCase());
-      if (named && !allowed.includes(named.toLowerCase())) {
-        throw new Swap2ValidationError(`swap2: quote calldata (${call.method}) names ${(0, import_viem.getAddress)(named)}, which is not this account, the deposit address or the declared spender \u2014 refused`);
+      if (call.undecodable) throw new Swap2ValidationError("swap2: quote calldata is not hex bytes \u2014 refused");
+      if (call.approval && call.approval.kind !== "erc20") {
+        throw new Swap2ValidationError(`swap2: quote calldata is ${call.approval.kind === "operator" ? "an operator approval (setApprovalForAll)" : "a Permit2 approval"} \u2014 never a swap's main call; refused`);
+      }
+      if (call.transfer || call.approval) {
+        if (!source.contract || unsigned.to.toLowerCase() !== source.contract.toLowerCase()) {
+          throw new Swap2ValidationError(`swap2: quote calldata (${call.method}) moves ${(0, import_viem.getAddress)(unsigned.to)}, not the source token \u2014 refused`);
+        }
+        if (call.method === "transferFrom") throw new Swap2ValidationError("swap2: quote calldata pulls the source token with transferFrom \u2014 refused");
+        const amount = call.transfer?.amount ?? call.approval?.amount ?? null;
+        if (amount === null || amount > BigInt(q.sourceAmount)) {
+          throw new Swap2ValidationError(`swap2: quote calldata (${call.method}) covers ${amount === null ? "an unlimited amount" : amount} of the source token, more than the swap's ${q.sourceAmount} \u2014 refused`);
+        }
+        const named = (call.transfer?.to ?? call.approval.spender).toLowerCase();
+        const allowed = engineTransfer ? [q.depositAddress] : remote ? [selfAddress, ...pinnedTargets, ...pinnedSpenders] : [selfAddress, q.depositAddress, unsigned.approvalAddress];
+        if (!allowed.filter((a) => !!a).map((a) => a.toLowerCase()).includes(named)) {
+          throw new Swap2ValidationError(`swap2: quote calldata (${call.method}) names ${(0, import_viem.getAddress)(named)}, which is not this account, the deposit address or ${remote ? "a spender the app pinned" : "the declared spender"} \u2014 refused`);
+        }
+      } else if (remote && !pinnedTargets.includes(unsigned.to.toLowerCase())) {
+        throw new Swap2ValidationError(`swap2: remote provider '${q.provider}' calls ${(0, import_viem.getAddress)(unsigned.to)} on ${this.fromChain}, which the app did not pin as a call target (remoteProvider callTargets) \u2014 refused`);
       }
     }
     const needsApproval = !!unsigned.approvalAddress && !!source.contract;
@@ -985,7 +1213,7 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
           ...unsigned.chainId !== void 0 ? { chainId: unsigned.chainId } : {},
           ...unsigned.gasLimit ? { gasLimit: BigInt(unsigned.gasLimit) } : {},
           ...unsigned.memo ? { memo: unsigned.memo, ...unsigned.memoEncoding ? { memoEncoding: unsigned.memoEncoding } : {} } : {},
-          ...cellBody !== void 0 ? { cellBody: true } : {}
+          ...cellBody !== void 0 ? { cellBody: true, ...tonBody ? { cellBodyDecoded: tonBody } : {} } : {}
         }
       };
       const previous = carried?.reviewed;
@@ -1250,6 +1478,7 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
       throw new Swap2ValidationError(`swap2: claim target ${unsigned.to} is not a contract '${name}' declares for ${unsigned.chain} \u2014 refused`);
     }
     const claimCall = (0, import_tx_preview_evm.decodeCall)({ to: unsigned.to, data: unsigned.data, value: 0n });
+    if (claimCall.undecodable) throw new Swap2ValidationError("swap2: claim calldata is not hex bytes \u2014 refused");
     if (claimCall.transfer || claimCall.approval) {
       throw new Swap2ValidationError(`swap2: claim calldata (${claimCall.method}) moves tokens or grants an allowance \u2014 refused`);
     }
@@ -1382,6 +1611,11 @@ var SingleProviderSwap2 = class extends BaseSwap2Protocol {
         this.lastRefusal ||= `${name}: rejected by validation (minDest=${quote.minDestAmount} vs floor=${snapshot.minAmountOut ?? "-"})`;
         return null;
       }
+      const unpinned = remotePinRefusal(this.provider, quote, snapshot.sourceChain);
+      if (unpinned) {
+        this.lastRefusal ||= unpinned;
+        return null;
+      }
       return { ...quote, provider: name };
     } catch (err) {
       this.lastRefusal ||= `${name}: ${(err instanceof Error ? err.message : String(err)).slice(0, 160)}`;