@anywalletkit/protocol-swap2-core 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -22,6 +22,7 @@ var src_exports = {};
 __export(src_exports, {
   BaseSwap2Protocol: () => BaseSwap2Protocol,
   NATIVE_DECIMALS: () => NATIVE_DECIMALS,
+  SLIPPAGE_ROUNDING_BPS: () => SLIPPAGE_ROUNDING_BPS,
   SWAP2_CHAIN_ALIASES: () => SWAP2_CHAIN_ALIASES,
   SWAP2_ID_PREFIX: () => SWAP2_ID_PREFIX,
   SingleProviderSwap2: () => SingleProviderSwap2,
@@ -55,6 +56,7 @@ __export(src_exports, {
   remoteProvider: () => remoteProvider,
   shortAddress: () => shortAddress,
   slippageClassOf: () => slippageClassOf,
+  slippageFloor: () => slippageFloor,
   sourceAssetOf: () => sourceAssetOf,
   suggestSlippage: () => suggestSlippage,
   swap2ChainId: () => swap2ChainId,
@@ -122,6 +124,11 @@ var Swap2MaybeSentError = class extends Swap2ExecutionError {
 };
 
 // src/validate.ts
+var SLIPPAGE_ROUNDING_BPS = 1;
+function slippageFloor(dest, slippageBps) {
+  const keep = 1e4 - slippageBps - SLIPPAGE_ROUNDING_BPS;
+  return keep <= 0 ? 0n : dest * BigInt(keep) / 10000n;
+}
 function validQuote(q, params, provider) {
   try {
     if (q.provider !== provider || q.sourceAmount !== params.amountIn) return false;
@@ -136,8 +143,7 @@ function validQuote(q, params, provider) {
     }
     if (params.slippageBps !== void 0) {
       if (!Number.isInteger(params.slippageBps) || params.slippageBps < 0 || params.slippageBps >= 1e4) return false;
-      const required = dest * BigInt(1e4 - params.slippageBps) / 10000n;
-      if (min < required) return false;
+      if (min < slippageFloor(dest, params.slippageBps)) return false;
     }
     if (!Number.isFinite(q.etaSeconds) || q.etaSeconds < 0) return false;
     if (!Number.isFinite(q.reliability) || q.reliability < 0 || q.reliability > 1) return false;
@@ -571,16 +577,18 @@ function reviewedIdentity(plan) {
   return JSON.stringify(pinned, (_k, v) => typeof v === "bigint" ? v.toString() : v);
 }
 var SWAP2_ID_PREFIX = "awk1";
-function encodeId(provider, intentId, sourceTxHash, destTxHash) {
+var CONFIRMED_SEGMENT = "ok";
+function encodeId(provider, intentId, sourceTxHash, destTxHash, destTxConfirmed = false) {
   const enc = (v) => encodeURIComponent(v).replace(/\./g, "%2E");
-  const parts = [provider, intentId, ...sourceTxHash != null ? [sourceTxHash, ...destTxHash != null ? [destTxHash] : []] : []];
+  const dest = destTxHash != null ? [destTxHash, ...destTxConfirmed ? [CONFIRMED_SEGMENT] : []] : [];
+  const parts = [provider, intentId, ...sourceTxHash != null ? [sourceTxHash, ...dest] : []];
   return `${SWAP2_ID_PREFIX}.${parts.map(enc).join(".")}`;
 }
 function decodeId(id) {
   try {
     if (!id.startsWith(`${SWAP2_ID_PREFIX}.`)) throw new Error("unsupported id version");
     const parts = id.slice(SWAP2_ID_PREFIX.length + 1).split(".");
-    if (parts.length < 2 || parts.length > 4 || !parts[0] || !parts[1]) throw new Error("invalid id shape");
+    if (parts.length < 2 || parts.length > 5 || !parts[0] || !parts[1]) throw new Error("invalid id shape");
     const provider = decodeURIComponent(parts[0]);
     const intentId = decodeURIComponent(parts[1]);
     const sourceTxHash = parts[2] ? decodeURIComponent(parts[2]) : void 0;
@@ -588,7 +596,8 @@ function decodeId(id) {
     if (!/^[A-Za-z0-9_-]+$/.test(provider) || !intentId || parts[2] !== void 0 && !sourceTxHash || parts[3] !== void 0 && !destTxHash) {
       throw new Error("invalid id contents");
     }
-    return { provider, intentId, ...sourceTxHash ? { sourceTxHash } : {}, ...destTxHash ? { destTxHash } : {} };
+    if (parts[4] !== void 0 && parts[4] !== CONFIRMED_SEGMENT) throw new Error("invalid id contents");
+    return { provider, intentId, ...sourceTxHash ? { sourceTxHash } : {}, ...destTxHash ? { destTxHash } : {}, ...parts[4] !== void 0 ? { destTxConfirmed: true } : {} };
   } catch {
     throw new Swap2ValidationError("swap2: malformed swap2 status id");
   }
@@ -721,13 +730,30 @@ function assertQuoteConstraints(q, options) {
   }
   if (options.slippage !== void 0) {
     const scale = 1000000000n;
-    const permitted = BigInt(floorScaled(options.slippage, 1e9));
-    const required = nominal * (scale - permitted) / scale;
+    const permitted = BigInt(floorScaled(options.slippage, 1e9)) + BigInt(SLIPPAGE_ROUNDING_BPS) * 100000n;
+    const required = permitted >= scale ? 0n : nominal * (scale - permitted) / scale;
     if (guaranteed < required) {
       throw new Error(`swap2: quote exceeds caller slippage (${options.slippage})`);
     }
   }
 }
+function bridgeOutOf(params, q, toTokenDecimals) {
+  let decimals = (0, import_swap2_assets2.resolveAsset)(params.destChain, params.destToken)?.decimals;
+  if (decimals === void 0 && toTokenDecimals !== void 0) {
+    if (q.destDecimals !== void 0 && q.destDecimals !== toTokenDecimals) {
+      throw new Swap2ValidationError(`swap2: the quote's destDecimals ${q.destDecimals} do not match toTokenDecimals ${toTokenDecimals}`);
+    }
+    decimals = toTokenDecimals;
+  }
+  return {
+    destChain: params.destChain,
+    recipient: params.destAddress,
+    destToken: params.destToken,
+    minAmountOut: q.minDestAmount,
+    ...decimals !== void 0 ? { destDecimals: decimals } : {},
+    ...params.slippageBps !== void 0 ? { slippageBps: params.slippageBps } : {}
+  };
+}
 function requireExecutionFloor(options) {
   if (options.minAmountOut === void 0) {
     throw new Error("swap2: swap2() requires caller-supplied minAmountOut");
@@ -826,6 +852,10 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
     }
     const destChain = toCaip2(options.toChain, this.fromChain);
     const constraints = callerConstraints(options);
+    const toDecimals = options.toTokenDecimals;
+    if (toDecimals !== void 0 && (!Number.isInteger(toDecimals) || toDecimals < 0 || toDecimals > 36)) {
+      throw new Swap2ValidationError("swap2: toTokenDecimals must be whole decimals in 0..36");
+    }
     const amountIn = exactPositiveAmount(options.fromTokenAmount, "fromTokenAmount");
     const source = this.sourceAsset(options);
     const params = {
@@ -1355,7 +1385,8 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
           maxValueOut: ((source.contract ? 0n : BigInt(q.sourceAmount)) + allowance).toString(),
           // Only a same-chain swap lands in this account; a bridge delivers elsewhere.
           ...params.destChain === this.fromChain ? { tokenIn: { token: params.destToken, minAmount: q.minDestAmount } } : {},
-          ...source.contract ? { source: { token: source.contract, maxAmount: q.sourceAmount } } : {}
+          ...source.contract ? { source: { token: source.contract, maxAmount: q.sourceAmount } } : {},
+          ...params.destChain !== this.fromChain ? { bridgeOut: bridgeOutOf(params, q, executionOptions.toTokenDecimals) } : {}
         };
         sent = await signer.sendSerializedTransaction(unsigned.serializedTx, expect);
       } else if (tokenId) {
@@ -1439,10 +1470,10 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
   }
   /** Status of a swap by the id `swap2()` returned, asked from the provider that executed it. */
   async getSwap2Status(id, _options) {
-    const { provider: name, intentId, sourceTxHash, destTxHash } = decodeId(id);
+    const { provider: name, intentId, sourceTxHash, destTxHash, destTxConfirmed } = decodeId(id);
     const provider = this.providerFor(name);
     if (!provider) throw new Error(`swap2: no swap2 found for id '${id}'`);
-    return mapStatus(await provider.trackIntent({ intentId, ...sourceTxHash != null ? { sourceTxHash } : {}, ...destTxHash != null ? { destTxHash } : {} }));
+    return mapStatus(await provider.trackIntent({ intentId, ...sourceTxHash != null ? { sourceTxHash } : {}, ...destTxHash != null ? { destTxHash, ...destTxConfirmed ? { destTxConfirmed } : {} } : {} }));
   }
   /**
    * Two-phase routes (CCTP-style burn-and-mint): once `getSwap2Status` reports
@@ -1515,7 +1546,21 @@ var BaseSwap2Protocol = class extends import_core.Swap2Protocol {
     });
     if (!sent.hash) throw new Swap2ExecutionError("swap2: account did not return a claim transaction hash");
     this.emitPhase("broadcast", { hash: sent.hash });
-    return { hash: sent.hash, chain: unsigned.chain, id: encodeId(name, intentId, sourceTxHash, sent.hash) };
+    let confirmed = false;
+    if (typeof signer.waitForTransaction === "function") {
+      try {
+        await signer.waitForTransaction(sent.hash);
+        confirmed = true;
+      } catch (e) {
+        const err = e;
+        const timedOut = /timeout|timed out/i.test(String(err?.name ?? "")) || /timed out|timeout/i.test(String(err?.message ?? ""));
+        const reverted = err?.code === "reverted" || !timedOut && /\breverted\b/i.test(String(err?.message ?? ""));
+        if (reverted) {
+          throw new Swap2ExecutionError(`swap2: the claim transaction ${sent.hash} on ${unsigned.chain} reverted \u2014 poll the status of '${id}' and claim again if it is still action-required`, { cause: e });
+        }
+      }
+    }
+    return { hash: sent.hash, chain: unsigned.chain, id: encodeId(name, intentId, sourceTxHash, sent.hash, confirmed) };
   }
   /** The inherited bridge() has no floor field: quote first, then bind execution
    * to that quote's minimum so the inherited convenience API stays safe. */
@@ -1592,7 +1637,10 @@ function structuredCloneSafe(value) {
   if (value === null || typeof value !== "object") return value;
   if (Array.isArray(value)) return value.map((v) => structuredCloneSafe(v));
   const out = {};
-  for (const [k, v] of Object.entries(value)) out[k] = structuredCloneSafe(v);
+  for (const [k, v] of Object.entries(value)) {
+    if (k === "__proto__") Object.defineProperty(out, k, { value: structuredCloneSafe(v), writable: true, enumerable: true, configurable: true });
+    else out[k] = structuredCloneSafe(v);
+  }
   return out;
 }
 function deepFreeze(value) {