@anywalletkit/protocol-swap2-fynd 0.0.0-stage → 0.1.0

package/dist/router.cjs

@@ -0,0 +1,115 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/router.ts
+var router_exports = {};
+__export(router_exports, {
+  FYND_CHAINS: () => FYND_CHAINS,
+  FyndTransactionError: () => FyndTransactionError,
+  ROUTER_NATIVE: () => ROUTER_NATIVE,
+  TYCHO_ROUTER_ABI: () => TYCHO_ROUTER_ABI,
+  TYCHO_ROUTER_SELECTORS: () => TYCHO_ROUTER_SELECTORS,
+  checkFyndTransaction: () => checkFyndTransaction
+});
+module.exports = __toCommonJS(router_exports);
+var import_viem = require("viem");
+var FYND_CHAINS = Object.freeze({
+  1: { slug: "ethereum", name: "Ethereum", router: "0x1644D2477f809cc2C71bCCFd6Dc9497E3F83210d" },
+  8453: { slug: "base", name: "Base", router: "0xAbA5B53b03eAfaD1C5fc8BD5Fc765fC85Bb3de67" },
+  42161: { slug: "arbitrum", name: "Arbitrum", router: "0x924F147c50eA59f5180a26031A8b65B2aA1e81Cd" },
+  56: { slug: "bsc", name: "BNB Smart Chain", router: "0x7f3D12BBaFb8955E51B3ab9588b34c8ad95BDA4e" },
+  137: { slug: "polygon", name: "Polygon", router: "0xbd4e6011F03355C2A377Fd9Af939322A7d0A1bC1" },
+  130: { slug: "unichain", name: "Unichain", router: "0xCba5574597Ad00EA250Fd106DAB4Fc7461949635" },
+  4663: { slug: "robinhood", name: "Robinhood Chain", router: "0x09215a470bD585E59EB3F4B612fBD2678131fF9e" }
+});
+var ROUTER_NATIVE = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+var ZERO = "0x0000000000000000000000000000000000000000";
+var PARAMS = "uint256 amountIn, address tokenIn, address tokenOut, uint256 expectedAmountOut, uint256 minAmountOut";
+var FEE = "(uint32 clientFeeBps, address clientFeeReceiver, uint256 maxClientContribution, uint256 deadline, bytes clientSignature) clientFeeParams";
+var PERMIT = "((address token, uint160 amount, uint48 expiration, uint48 nonce) details, address spender, uint256 sigDeadline) permitSingle, bytes signature";
+var TYCHO_ROUTER_ABI = (0, import_viem.parseAbi)([
+  `function singleSwap(${PARAMS}, address receiver, ${FEE}, bytes swapData) payable returns (uint256)`,
+  `function sequentialSwap(${PARAMS}, address receiver, ${FEE}, bytes swaps) payable returns (uint256)`,
+  `function splitSwap(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps) payable returns (uint256)`
+]);
+var TYCHO_ROUTER_SELECTORS = new Set(
+  [
+    `singleSwap(${PARAMS}, address receiver, ${FEE}, bytes swapData)`,
+    `sequentialSwap(${PARAMS}, address receiver, ${FEE}, bytes swaps)`,
+    `splitSwap(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps)`,
+    `singleSwapUsingVault(${PARAMS}, address receiver, ${FEE}, bytes swapData)`,
+    `sequentialSwapUsingVault(${PARAMS}, address receiver, ${FEE}, bytes swaps)`,
+    `splitSwapUsingVault(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps)`,
+    `singleSwapPermit2(${PARAMS}, address receiver, ${FEE}, ${PERMIT}, bytes swapData)`,
+    `sequentialSwapPermit2(${PARAMS}, address receiver, ${FEE}, ${PERMIT}, bytes swaps)`,
+    `splitSwapPermit2(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, ${PERMIT}, bytes swaps)`
+  ].map((sig) => (0, import_viem.toFunctionSelector)(`function ${sig}`))
+);
+var FyndTransactionError = class extends Error {
+  constructor(message) {
+    super(`fynd: ${message}`);
+    this.name = "FyndTransactionError";
+  }
+};
+var sameAddress = (a, b) => {
+  try {
+    return (0, import_viem.getAddress)(a) === (0, import_viem.getAddress)(b);
+  } catch {
+    return false;
+  }
+};
+var routerToken = (t) => sameAddress(t, ZERO) ? ROUTER_NATIVE : t;
+function checkFyndTransaction(tx, expected) {
+  const chain = FYND_CHAINS[expected.chainId];
+  if (!chain) throw new FyndTransactionError(`chain ${expected.chainId} has no pinned Tycho router`);
+  if (!sameAddress(tx.to, chain.router)) throw new FyndTransactionError(`the transaction targets ${tx.to}, not the Tycho router on ${chain.name}`);
+  if (sameAddress(expected.receiver, ZERO) || sameAddress(expected.receiver, chain.router)) throw new FyndTransactionError("invalid receiver");
+  if (expected.amountIn <= 0n || expected.minAmountOut <= 0n || expected.minAmountOut > expected.expectedAmountOut) {
+    throw new FyndTransactionError("invalid quote amounts");
+  }
+  const nativeIn = sameAddress(expected.tokenIn, ZERO);
+  if (tx.value !== (nativeIn ? expected.amountIn : 0n)) throw new FyndTransactionError("native value does not match the input");
+  if (!/^0x(?:[0-9a-fA-F]{2}){4,}$/.test(tx.data)) throw new FyndTransactionError("malformed calldata");
+  let call;
+  try {
+    call = (0, import_viem.decodeFunctionData)({ abi: TYCHO_ROUTER_ABI, data: tx.data });
+  } catch {
+    throw new FyndTransactionError("not a plain singleSwap / sequentialSwap / splitSwap call (Permit2 and vault variants are not used)");
+  }
+  const a = call.args;
+  const [amountIn, tokenIn, tokenOut, expectedAmountOut, minAmountOut] = a;
+  const isSplit = call.functionName === "splitSwap";
+  const receiver = isSplit ? a[6] : a[5];
+  const fee = isSplit ? a[7] : a[6];
+  const swaps = isSplit ? a[8] : a[7];
+  if (amountIn !== expected.amountIn) throw new FyndTransactionError(`calldata spends ${amountIn}, not ${expected.amountIn}`);
+  if (!sameAddress(tokenIn, routerToken(expected.tokenIn)) || !sameAddress(tokenOut, routerToken(expected.tokenOut))) {
+    throw new FyndTransactionError("calldata swaps other tokens than requested");
+  }
+  if (!sameAddress(receiver, expected.receiver)) throw new FyndTransactionError(`calldata pays ${receiver}, not ${expected.receiver}`);
+  if (expectedAmountOut !== expected.expectedAmountOut || minAmountOut !== expected.minAmountOut) {
+    throw new FyndTransactionError("calldata amounts do not match the quote");
+  }
+  if (fee.clientFeeBps !== 0 || fee.maxClientContribution !== 0n || !sameAddress(fee.clientFeeReceiver, ZERO)) {
+    throw new FyndTransactionError("calldata carries client-fee parameters \u2014 this module charges none");
+  }
+  if (swaps === "0x" || isSplit && a[5] < 2n) throw new FyndTransactionError("empty or invalid route");
+  return { method: call.functionName };
+}
+//# sourceMappingURL=router.cjs.map

package/dist/router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router.ts"],"sourcesContent":["/**\n * TychoRouterV3 — the only contract a Fynd quote may settle through (Fynd\n * License §3: every settlement of a Fynd output goes through the router in\n * Propeller Heads' registry). This file pins the router per chain and checks\n * Fynd's encoded transaction against the request before anything is approved\n * or sent: right contract, right method, the exact input, the requested\n * tokens, the user as receiver, the quoted output and minimum, and no client\n * fee. The route inside `swaps` is opaque and is not inspected here — the\n * router itself reverts below `minAmountOut`.\n */\nimport {decodeFunctionData, getAddress, parseAbi, toFunctionSelector, type Hex} from \"viem\";\n\n/** Router registry: github.com/propeller-heads/tycho crates/tycho-execution/config/deployment_registry.json (TychoRouterV3, effective 2026-09-01). */\nexport const FYND_CHAINS: Readonly<Record<number, {slug: string; name: string; router: `0x${string}`}>> = Object.freeze({\n  1: {slug: \"ethereum\", name: \"Ethereum\", router: \"0x1644D2477f809cc2C71bCCFd6Dc9497E3F83210d\"},\n  8453: {slug: \"base\", name: \"Base\", router: \"0xAbA5B53b03eAfaD1C5fc8BD5Fc765fC85Bb3de67\"},\n  42161: {slug: \"arbitrum\", name: \"Arbitrum\", router: \"0x924F147c50eA59f5180a26031A8b65B2aA1e81Cd\"},\n  56: {slug: \"bsc\", name: \"BNB Smart Chain\", router: \"0x7f3D12BBaFb8955E51B3ab9588b34c8ad95BDA4e\"},\n  137: {slug: \"polygon\", name: \"Polygon\", router: \"0xbd4e6011F03355C2A377Fd9Af939322A7d0A1bC1\"},\n  130: {slug: \"unichain\", name: \"Unichain\", router: \"0xCba5574597Ad00EA250Fd106DAB4Fc7461949635\"},\n  4663: {slug: \"robinhood\", name: \"Robinhood Chain\", router: \"0x09215a470bD585E59EB3F4B612fBD2678131fF9e\"},\n});\n\n/** The router's native-coin sentinel (lib/NativeETH.sol); Fynd's API uses the zero address instead. */\nexport const ROUTER_NATIVE = \"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\";\nconst ZERO = \"0x0000000000000000000000000000000000000000\";\n\nconst PARAMS = \"uint256 amountIn, address tokenIn, address tokenOut, uint256 expectedAmountOut, uint256 minAmountOut\";\nconst FEE = \"(uint32 clientFeeBps, address clientFeeReceiver, uint256 maxClientContribution, uint256 deadline, bytes clientSignature) clientFeeParams\";\nconst PERMIT = \"((address token, uint160 amount, uint48 expiration, uint48 nonce) details, address spender, uint256 sigDeadline) permitSingle, bytes signature\";\n\n/** The three entry points a wallet swap uses (plain `transferFrom` from the user). */\nexport const TYCHO_ROUTER_ABI = parseAbi([\n  `function singleSwap(${PARAMS}, address receiver, ${FEE}, bytes swapData) payable returns (uint256)`,\n  `function sequentialSwap(${PARAMS}, address receiver, ${FEE}, bytes swaps) payable returns (uint256)`,\n  `function splitSwap(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps) payable returns (uint256)`,\n]);\n\n/** Every swap entry point of the router (Permit2 and vault variants included) — for recognizing history. */\nexport const TYCHO_ROUTER_SELECTORS: ReadonlySet<string> = new Set(\n  [\n    `singleSwap(${PARAMS}, address receiver, ${FEE}, bytes swapData)`,\n    `sequentialSwap(${PARAMS}, address receiver, ${FEE}, bytes swaps)`,\n    `splitSwap(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps)`,\n    `singleSwapUsingVault(${PARAMS}, address receiver, ${FEE}, bytes swapData)`,\n    `sequentialSwapUsingVault(${PARAMS}, address receiver, ${FEE}, bytes swaps)`,\n    `splitSwapUsingVault(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, bytes swaps)`,\n    `singleSwapPermit2(${PARAMS}, address receiver, ${FEE}, ${PERMIT}, bytes swapData)`,\n    `sequentialSwapPermit2(${PARAMS}, address receiver, ${FEE}, ${PERMIT}, bytes swaps)`,\n    `splitSwapPermit2(${PARAMS}, uint256 nTokens, address receiver, ${FEE}, ${PERMIT}, bytes swaps)`,\n  ].map((sig) => toFunctionSelector(`function ${sig}`)),\n);\n\nexport class FyndTransactionError extends Error {\n  constructor(message: string) {\n    super(`fynd: ${message}`);\n    this.name = \"FyndTransactionError\";\n  }\n}\n\nexport interface ExpectedSwap {\n  chainId: number;\n  /** ERC-20 address, or the zero address for the native coin. */\n  tokenIn: string;\n  tokenOut: string;\n  amountIn: bigint;\n  receiver: string;\n  /** Fynd's gross `amount_out` (before the router fee and slippage). */\n  expectedAmountOut: bigint;\n  /** Fynd's `min_amount_received` — what the router enforces on-chain. */\n  minAmountOut: bigint;\n}\n\nexport interface EncodedTx {\n  to: string;\n  value: bigint;\n  data: string;\n}\n\nconst sameAddress = (a: string, b: string) => {\n  try {\n    return getAddress(a) === getAddress(b);\n  } catch {\n    return false;\n  }\n};\nconst routerToken = (t: string) => (sameAddress(t, ZERO) ? ROUTER_NATIVE : t);\n\n/** Refuses (throws {@link FyndTransactionError}) unless `tx` is exactly the swap the wallet asked for. */\nexport function checkFyndTransaction(tx: EncodedTx, expected: ExpectedSwap): {method: \"singleSwap\" | \"sequentialSwap\" | \"splitSwap\"} {\n  const chain = FYND_CHAINS[expected.chainId];\n  if (!chain) throw new FyndTransactionError(`chain ${expected.chainId} has no pinned Tycho router`);\n  if (!sameAddress(tx.to, chain.router)) throw new FyndTransactionError(`the transaction targets ${tx.to}, not the Tycho router on ${chain.name}`);\n  if (sameAddress(expected.receiver, ZERO) || sameAddress(expected.receiver, chain.router)) throw new FyndTransactionError(\"invalid receiver\");\n  if (expected.amountIn <= 0n || expected.minAmountOut <= 0n || expected.minAmountOut > expected.expectedAmountOut) {\n    throw new FyndTransactionError(\"invalid quote amounts\");\n  }\n  const nativeIn = sameAddress(expected.tokenIn, ZERO);\n  if (tx.value !== (nativeIn ? expected.amountIn : 0n)) throw new FyndTransactionError(\"native value does not match the input\");\n  if (!/^0x(?:[0-9a-fA-F]{2}){4,}$/.test(tx.data)) throw new FyndTransactionError(\"malformed calldata\");\n\n  let call: ReturnType<typeof decodeFunctionData<typeof TYCHO_ROUTER_ABI>>;\n  try {\n    call = decodeFunctionData({abi: TYCHO_ROUTER_ABI, data: tx.data as Hex});\n  } catch {\n    throw new FyndTransactionError(\"not a plain singleSwap / sequentialSwap / splitSwap call (Permit2 and vault variants are not used)\");\n  }\n  const a = call.args;\n  const [amountIn, tokenIn, tokenOut, expectedAmountOut, minAmountOut] = a;\n  const isSplit = call.functionName === \"splitSwap\";\n  const receiver = (isSplit ? a[6] : a[5]) as string;\n  const fee = (isSplit ? a[7] : a[6]) as {clientFeeBps: number; clientFeeReceiver: string; maxClientContribution: bigint; deadline: bigint; clientSignature: string};\n  const swaps = (isSplit ? a[8] : a[7]) as string;\n  if (amountIn !== expected.amountIn) throw new FyndTransactionError(`calldata spends ${amountIn}, not ${expected.amountIn}`);\n  if (!sameAddress(tokenIn, routerToken(expected.tokenIn)) || !sameAddress(tokenOut, routerToken(expected.tokenOut))) {\n    throw new FyndTransactionError(\"calldata swaps other tokens than requested\");\n  }\n  if (!sameAddress(receiver, expected.receiver)) throw new FyndTransactionError(`calldata pays ${receiver}, not ${expected.receiver}`);\n  if (expectedAmountOut !== expected.expectedAmountOut || minAmountOut !== expected.minAmountOut) {\n    throw new FyndTransactionError(\"calldata amounts do not match the quote\");\n  }\n  if (fee.clientFeeBps !== 0 || fee.maxClientContribution !== 0n || !sameAddress(fee.clientFeeReceiver, ZERO)) {\n    throw new FyndTransactionError(\"calldata carries client-fee parameters — this module charges none\");\n  }\n  if (swaps === \"0x\" || (isSplit && (a[5] as bigint) < 2n)) throw new FyndTransactionError(\"empty or invalid route\");\n  return {method: call.functionName};\n}\n"],"mappings":"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","names":[]}

package/dist/router.d.cts

@@ -0,0 +1,185 @@
+/** Router registry: github.com/propeller-heads/tycho crates/tycho-execution/config/deployment_registry.json (TychoRouterV3, effective 2026-09-01). */
+declare const FYND_CHAINS: Readonly<Record<number, {
+    slug: string;
+    name: string;
+    router: `0x${string}`;
+}>>;
+/** The router's native-coin sentinel (lib/NativeETH.sol); Fynd's API uses the zero address instead. */
+declare const ROUTER_NATIVE = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/** The three entry points a wallet swap uses (plain `transferFrom` from the user). */
+declare const TYCHO_ROUTER_ABI: readonly [{
+    readonly name: "singleSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swapData";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "sequentialSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swaps";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "splitSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "nTokens";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swaps";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}];
+/** Every swap entry point of the router (Permit2 and vault variants included) — for recognizing history. */
+declare const TYCHO_ROUTER_SELECTORS: ReadonlySet<string>;
+declare class FyndTransactionError extends Error {
+    constructor(message: string);
+}
+interface ExpectedSwap {
+    chainId: number;
+    /** ERC-20 address, or the zero address for the native coin. */
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: bigint;
+    receiver: string;
+    /** Fynd's gross `amount_out` (before the router fee and slippage). */
+    expectedAmountOut: bigint;
+    /** Fynd's `min_amount_received` — what the router enforces on-chain. */
+    minAmountOut: bigint;
+}
+interface EncodedTx {
+    to: string;
+    value: bigint;
+    data: string;
+}
+/** Refuses (throws {@link FyndTransactionError}) unless `tx` is exactly the swap the wallet asked for. */
+declare function checkFyndTransaction(tx: EncodedTx, expected: ExpectedSwap): {
+    method: "singleSwap" | "sequentialSwap" | "splitSwap";
+};
+
+export { type EncodedTx, type ExpectedSwap, FYND_CHAINS, FyndTransactionError, ROUTER_NATIVE, TYCHO_ROUTER_ABI, TYCHO_ROUTER_SELECTORS, checkFyndTransaction };

package/dist/router.d.ts

@@ -0,0 +1,185 @@
+/** Router registry: github.com/propeller-heads/tycho crates/tycho-execution/config/deployment_registry.json (TychoRouterV3, effective 2026-09-01). */
+declare const FYND_CHAINS: Readonly<Record<number, {
+    slug: string;
+    name: string;
+    router: `0x${string}`;
+}>>;
+/** The router's native-coin sentinel (lib/NativeETH.sol); Fynd's API uses the zero address instead. */
+declare const ROUTER_NATIVE = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/** The three entry points a wallet swap uses (plain `transferFrom` from the user). */
+declare const TYCHO_ROUTER_ABI: readonly [{
+    readonly name: "singleSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swapData";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "sequentialSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swaps";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "splitSwap";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "amountIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenIn";
+    }, {
+        readonly type: "address";
+        readonly name: "tokenOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "expectedAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "minAmountOut";
+    }, {
+        readonly type: "uint256";
+        readonly name: "nTokens";
+    }, {
+        readonly type: "address";
+        readonly name: "receiver";
+    }, {
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly type: "uint32";
+            readonly name: "clientFeeBps";
+        }, {
+            readonly type: "address";
+            readonly name: "clientFeeReceiver";
+        }, {
+            readonly type: "uint256";
+            readonly name: "maxClientContribution";
+        }, {
+            readonly type: "uint256";
+            readonly name: "deadline";
+        }, {
+            readonly type: "bytes";
+            readonly name: "clientSignature";
+        }];
+        readonly name: "clientFeeParams";
+    }, {
+        readonly type: "bytes";
+        readonly name: "swaps";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}];
+/** Every swap entry point of the router (Permit2 and vault variants included) — for recognizing history. */
+declare const TYCHO_ROUTER_SELECTORS: ReadonlySet<string>;
+declare class FyndTransactionError extends Error {
+    constructor(message: string);
+}
+interface ExpectedSwap {
+    chainId: number;
+    /** ERC-20 address, or the zero address for the native coin. */
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: bigint;
+    receiver: string;
+    /** Fynd's gross `amount_out` (before the router fee and slippage). */
+    expectedAmountOut: bigint;
+    /** Fynd's `min_amount_received` — what the router enforces on-chain. */
+    minAmountOut: bigint;
+}
+interface EncodedTx {
+    to: string;
+    value: bigint;
+    data: string;
+}
+/** Refuses (throws {@link FyndTransactionError}) unless `tx` is exactly the swap the wallet asked for. */
+declare function checkFyndTransaction(tx: EncodedTx, expected: ExpectedSwap): {
+    method: "singleSwap" | "sequentialSwap" | "splitSwap";
+};
+
+export { type EncodedTx, type ExpectedSwap, FYND_CHAINS, FyndTransactionError, ROUTER_NATIVE, TYCHO_ROUTER_ABI, TYCHO_ROUTER_SELECTORS, checkFyndTransaction };

package/dist/router.js

@@ -0,0 +1,17 @@
+import {
+  FYND_CHAINS,
+  FyndTransactionError,
+  ROUTER_NATIVE,
+  TYCHO_ROUTER_ABI,
+  TYCHO_ROUTER_SELECTORS,
+  checkFyndTransaction
+} from "./chunk-F5P3PLJN.js";
+export {
+  FYND_CHAINS,
+  FyndTransactionError,
+  ROUTER_NATIVE,
+  TYCHO_ROUTER_ABI,
+  TYCHO_ROUTER_SELECTORS,
+  checkFyndTransaction
+};
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/module.json

@@ -0,0 +1,22 @@
+{
+  "name": "@anywalletkit/protocol-swap2-fynd",
+  "type": "swap2",
+  "chains": [
+    "eip155:1",
+    "eip155:56",
+    "eip155:130",
+    "eip155:137",
+    "eip155:4663",
+    "eip155:8453",
+    "eip155:42161"
+  ],
+  "tier": "core",
+  "maintainers": [
+    "@ultratestbro"
+  ],
+  "conformance": "0.x",
+  "repo": "https://github.com/ultratestbro/anywalletkit",
+  "path": "packages/protocol-swap2-fynd",
+  "description": "Fynd same-chain swaps: Propeller Heads' solver over Tycho-indexed pools, settled through TychoRouterV3; router, method, tokens, amounts, receiver and minimum checked against the request before signing. Fynd outputs are under the Fynd License.",
+  "addedAt": "2026-10-24"
+}

package/package.json

@@ -1,6 +1,86 @@
 {
   "name": "@anywalletkit/protocol-swap2-fynd",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Fynd (Propeller Heads) same-chain swaps for Any Wallet Kit: exact-input routes across the pools Tycho indexes on Ethereum, Base, Arbitrum, BNB Chain, Polygon, Unichain and Robinhood Chain, settled through TychoRouterV3 with the transaction checked against the request before signing.",
+  "license": "Apache-2.0",
+  "homepage": "https://docs.anywallet.tech",
+  "bugs": {
+    "url": "https://github.com/ultratestbro/anywalletkit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ultratestbro/anywalletkit.git",
+    "directory": "packages/protocol-swap2-fynd"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "require": "./dist/provider.cjs"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.js",
+      "require": "./dist/router.cjs"
+    },
+    "./activity": {
+      "types": "./dist/activity.d.ts",
+      "import": "./dist/activity.js",
+      "require": "./dist/activity.cjs"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js",
+      "require": "./dist/protocol.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "module.json"
+  ],
+  "dependencies": {
+    "viem": "^2.57.2",
+    "@anywalletkit/protocol-swap2-core": "0.3.0",
+    "@anywalletkit/swap2-assets": "0.1.2"
+  },
+  "peerDependencies": {
+    "@anywalletkit/core": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "vitest": "^5.0.3",
+    "@anywalletkit/core": "0.3.0",
+    "@anywalletkit/conformance": "0.3.0"
+  },
+  "keywords": [
+    "swap2",
+    "swap",
+    "dex-aggregator",
+    "fynd",
+    "tycho",
+    "evm",
+    "anywalletkit"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "echo ok"
+  }
 }