@anywalletkit/protocol-swap2-balancer 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @anywalletkit/protocol-swap2-balancer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Balancer v2 same-chain swaps as a swap2 module: Smart Order Router paths from
+the Balancer API, `queryBatchSwap` on the Vault for the on-chain quote,
+`batchSwap` execution, on the chains in `BALANCER_V2_CHAINS` (Vault `WETH()`
+verified before use). Standalone through `BalancerSwap2Protocol`, or as one
+provider of the router.
+
+## Activity
+
+`describeActivity(tx, ctx)` recognizes `batchSwap` `0x945bcec9` and `swap`
+`0x52bbbe29` on the Vault (`0xBA12…2C8`, the same address on every chain) on a
+chain this module serves, as `swap`, "Swapped A → B" from the owner's net
+transfers (a native `value` leg included). Subtitle `Balancer v2 · <chain>`,
+counterparty = the Vault.
+
+Fixtures (`fixtures/activity/`, public Ethereum transactions — the test
+wallet's Balancer runs were quote-only on the matrix): Vault `swap` COW → GNO,
+`batchSwap` BAL → USDT (the call this module builds), `batchSwap` ETH → WNCG
+with native input; negatives: a Uniswap `exactInputSingle`, a LI.FI swap.

package/dist/activity.cjs

@@ -0,0 +1,68 @@
+"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/activity.ts
+var activity_exports = {};
+__export(activity_exports, {
+  BALANCER_MODULE: () => BALANCER_MODULE,
+  BALANCER_VAULT_SELECTORS: () => BALANCER_VAULT_SELECTORS,
+  describeBalancerActivity: () => describeBalancerActivity
+});
+module.exports = __toCommonJS(activity_exports);
+var import_activity = require("@anywalletkit/protocol-swap2-core/activity");
+var import_util2 = require("@anywalletkit/protocol-swap2-core/util");
+
+// src/provider.ts
+var import_viem = require("viem");
+var import_swap2_assets = require("@anywalletkit/swap2-assets");
+var import_util = require("@anywalletkit/protocol-swap2-core/util");
+var BALANCER_V2_VAULT = "0xBA12222222228d8Ba445958a75a0704d566BF2C8";
+var BALANCER_V2_CHAINS = Object.freeze({
+  1: { api: "MAINNET", weth: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" },
+  10: { api: "OPTIMISM", weth: "0x4200000000000000000000000000000000000006" },
+  100: { api: "GNOSIS", weth: "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d" },
+  137: { api: "POLYGON", weth: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270" },
+  146: { api: "SONIC", weth: "0x039e2fB66102314Ce7b64Ce5Ce3E5183bc94aD38" },
+  8453: { api: "BASE", weth: "0x4200000000000000000000000000000000000006" },
+  9745: { api: "PLASMA", weth: "0x6100E367285b01F48D07953803A2d8dCA5D19873" },
+  42161: { api: "ARBITRUM", weth: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1" },
+  43114: { api: "AVALANCHE", weth: "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7" }
+});
+var SWAP_STEP = "(bytes32 poolId, uint256 assetInIndex, uint256 assetOutIndex, uint256 amount, bytes userData)";
+var FUNDS = "(address sender, bool fromInternalBalance, address recipient, bool toInternalBalance)";
+var VAULT_ABI = (0, import_viem.parseAbi)([
+  `function queryBatchSwap(uint8 kind, ${SWAP_STEP}[] swaps, address[] assets, ${FUNDS} funds) returns (int256[] assetDeltas)`,
+  `function batchSwap(uint8 kind, ${SWAP_STEP}[] swaps, address[] assets, ${FUNDS} funds, int256[] limits, uint256 deadline) payable returns (int256[] assetDeltas)`,
+  "function WETH() view returns (address)"
+]);
+
+// src/activity.ts
+var BALANCER_MODULE = "@anywalletkit/protocol-swap2-balancer";
+var BALANCER_VAULT_SELECTORS = /* @__PURE__ */ new Set([
+  "0x945bcec9",
+  // batchSwap(uint8,(bytes32,uint256,uint256,uint256,bytes)[],address[],(address,bool,address,bool),int256[],uint256)
+  "0x52bbbe29"
+  // swap((bytes32,uint8,address,address,uint256,bytes),(address,bool,address,bool),uint256,uint256)
+]);
+function describeBalancerActivity(tx, ctx) {
+  if (!(0, import_util2.isEvm)(tx.chain) || !BALANCER_V2_CHAINS[(0, import_util2.evmRef)(tx.chain)]) return null;
+  if (!(0, import_activity.matchesCall)(tx, [BALANCER_V2_VAULT], BALANCER_VAULT_SELECTORS)) return null;
+  return (0, import_activity.describeSwapLike)(tx, ctx, { protocol: BALANCER_MODULE, subtitle: `Balancer v2 \xB7 ${(0, import_activity.chainLabel)(tx.chain)}`, kind: "swap" });
+}
+//# sourceMappingURL=activity.cjs.map

package/dist/activity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/activity.ts","../src/provider.ts"],"sourcesContent":["/**\n * Activity recognition for Balancer v2: `swap` / `batchSwap` on the Vault\n * (one address on every chain) on a chain the module serves → `swap`,\n * \"Swapped A → B\" from the owner's net transfers.\n */\nimport type {ActivityItem, ChainTx, DescribeActivityContext} from \"@anywalletkit/core\";\nimport {chainLabel, describeSwapLike, matchesCall} from \"@anywalletkit/protocol-swap2-core/activity\";\nimport {evmRef, isEvm} from \"@anywalletkit/protocol-swap2-core/util\";\nimport {BALANCER_V2_CHAINS, BALANCER_V2_VAULT} from \"./provider.js\";\n\nexport const BALANCER_MODULE = \"@anywalletkit/protocol-swap2-balancer\";\n\n/** Vault swap entry points (`viem toFunctionSelector`, 2026-10-14). */\nexport const BALANCER_VAULT_SELECTORS: ReadonlySet<string> = new Set([\n  \"0x945bcec9\", // batchSwap(uint8,(bytes32,uint256,uint256,uint256,bytes)[],address[],(address,bool,address,bool),int256[],uint256)\n  \"0x52bbbe29\", // swap((bytes32,uint8,address,address,uint256,bytes),(address,bool,address,bool),uint256,uint256)\n]);\n\nexport function describeBalancerActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null {\n  if (!isEvm(tx.chain) || !BALANCER_V2_CHAINS[evmRef(tx.chain)]) return null;\n  if (!matchesCall(tx, [BALANCER_V2_VAULT], BALANCER_VAULT_SELECTORS)) return null;\n  return describeSwapLike(tx, ctx, {protocol: BALANCER_MODULE, subtitle: `Balancer v2 · ${chainLabel(tx.chain)}`, kind: \"swap\"});\n}\n","import {decodeFunctionData, decodeFunctionResult, encodeFunctionData, getAddress, parseAbi, type Hex} from \"viem\";\nimport {describeBalancerActivity} from \"./activity.js\";\nimport {ccAsset} from \"@anywalletkit/swap2-assets\";\nimport {evmRef, isEvm, timeoutSignal} from \"@anywalletkit/protocol-swap2-core/util\";\nimport type {Asset, CrossChainProvider, IntentRef, IntentStatus, Quote, QuoteParams, UnsignedTx} from \"@anywalletkit/protocol-swap2-core/types\";\n\n/**\n * Balancer v2 — the cp0x permissionless Balancer venue (balancer.cp0x.com).\n *\n * Discovery only from the API: Balancer's SOR (`sorGetSwapPaths`, v2 pools)\n * suggests the path. Everything on the money path is on-chain: the Vault\n * prices that exact path (`queryBatchSwap` via eth_call), the quote uses the\n * Vault's number, and `batchSwap` carries `limits` (in ≤ amountIn, out ≥ min)\n * plus a deadline — the Vault itself refuses anything worse. Native coins use\n * the Vault's own ETH sentinel (address 0): it wraps/unwraps through WETH.\n */\n\nconst ZERO = \"0x0000000000000000000000000000000000000000\";\n/** The same Balancer v2 Vault address on every chain it is deployed on. */\nexport const BALANCER_V2_VAULT = \"0xBA12222222228d8Ba445958a75a0704d566BF2C8\";\nconst DEFAULT_API = \"https://api-v3.balancer.fi/\";\nconst DEFAULT_SLIPPAGE_BPS = 50;\nconst DEFAULT_TTL_MS = 300_000;\nconst DEFAULT_DEADLINE_S = 600;\n\n/** Chains where the v2 Vault is live, with the SOR API name and the Vault's WETH() (verified on-chain 2026-10-13). */\nexport const BALANCER_V2_CHAINS: Readonly<Record<number, {api: string; weth: `0x${string}`}>> = Object.freeze({\n  1: {api: \"MAINNET\", weth: \"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\"},\n  10: {api: \"OPTIMISM\", weth: \"0x4200000000000000000000000000000000000006\"},\n  100: {api: \"GNOSIS\", weth: \"0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d\"},\n  137: {api: \"POLYGON\", weth: \"0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270\"},\n  146: {api: \"SONIC\", weth: \"0x039e2fB66102314Ce7b64Ce5Ce3E5183bc94aD38\"},\n  8453: {api: \"BASE\", weth: \"0x4200000000000000000000000000000000000006\"},\n  9745: {api: \"PLASMA\", weth: \"0x6100E367285b01F48D07953803A2d8dCA5D19873\"},\n  42161: {api: \"ARBITRUM\", weth: \"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1\"},\n  43114: {api: \"AVALANCHE\", weth: \"0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7\"},\n});\n\nconst SWAP_STEP = \"(bytes32 poolId, uint256 assetInIndex, uint256 assetOutIndex, uint256 amount, bytes userData)\";\nconst FUNDS = \"(address sender, bool fromInternalBalance, address recipient, bool toInternalBalance)\";\nconst VAULT_ABI = parseAbi([\n  `function queryBatchSwap(uint8 kind, ${SWAP_STEP}[] swaps, address[] assets, ${FUNDS} funds) returns (int256[] assetDeltas)`,\n  `function batchSwap(uint8 kind, ${SWAP_STEP}[] swaps, address[] assets, ${FUNDS} funds, int256[] limits, uint256 deadline) payable returns (int256[] assetDeltas)`,\n  \"function WETH() view returns (address)\",\n]);\n\ntype Step = {poolId: Hex; assetInIndex: bigint; assetOutIndex: bigint; amount: bigint; userData: Hex};\ntype Funds = {sender: Hex; fromInternalBalance: boolean; recipient: Hex; toInternalBalance: boolean};\n\nexport interface BalancerProviderConfig {\n  enabled?: boolean;\n  /** JSON-RPC endpoints per EVM chain id (on-chain pricing + receipts). */\n  rpcUrls: Readonly<Record<number, readonly string[]>>;\n  /** Balancer API (SOR) base URL — discovery only. */\n  apiUrl?: string;\n  defaultSlippageBps?: number;\n  quoteTtlMs?: number;\n  deadlineSeconds?: number;\n}\n\ninterface SorPath {\n  pools: string[];\n  tokens: {address: string; decimals: number}[];\n  inputAmountRaw: string;\n  outputAmountRaw: string;\n  protocolVersion: number;\n}\n\n/** Base units → the decimal string the SOR expects (\"1.5\"). */\nfunction human(amount: bigint, decimals: number): string {\n  const s = amount.toString().padStart(decimals + 1, \"0\");\n  const whole = s.slice(0, s.length - decimals);\n  const frac = s.slice(s.length - decimals).replace(/0+$/, \"\");\n  return frac ? `${whole}.${frac}` : whole;\n}\n\nexport function balancerProvider(config: BalancerProviderConfig): CrossChainProvider {\n  const api = config.apiUrl ?? DEFAULT_API;\n  const slippageDefault = config.defaultSlippageBps ?? DEFAULT_SLIPPAGE_BPS;\n  const ttl = config.quoteTtlMs ?? DEFAULT_TTL_MS;\n  const deadlineS = config.deadlineSeconds ?? DEFAULT_DEADLINE_S;\n  const verified = new Map<number, Promise<void>>();\n\n  const chainIdOf = (caip2: string): number | null => {\n    if (!isEvm(caip2)) return null;\n    const id = evmRef(caip2);\n    return BALANCER_V2_CHAINS[id] && config.rpcUrls[id]?.length ? id : null;\n  };\n\n  async function rpc(chainId: number, method: string, params: unknown[]): Promise<unknown> {\n    let lastErr: unknown;\n    for (const url of config.rpcUrls[chainId] ?? []) {\n      try {\n        const res = await fetch(url, {method: \"POST\", headers: {\"content-type\": \"application/json\"}, body: JSON.stringify({jsonrpc: \"2.0\", id: 1, method, params}), signal: timeoutSignal(12_000)});\n        if (!res.ok) throw new Error(`HTTP ${res.status}`);\n        const body = (await res.json()) as {result?: unknown; error?: {message?: string}};\n        if (body.error) throw Object.assign(new Error(body.error.message ?? \"rpc error\"), {rpc: true});\n        return body.result ?? null;\n      } catch (e) {\n        if ((e as {rpc?: boolean}).rpc) throw e; // a revert is an answer, not a dead endpoint\n        lastErr = e;\n      }\n    }\n    throw new Error(`balancer: no RPC answered on chain ${chainId} (${lastErr instanceof Error ? lastErr.message : String(lastErr)})`);\n  }\n\n  /** The Vault is deployed here and wraps through the WETH we pinned. */\n  function verify(chainId: number): Promise<void> {\n    let p = verified.get(chainId);\n    if (!p) {\n      p = (async () => {\n        const raw = (await rpc(chainId, \"eth_call\", [{to: BALANCER_V2_VAULT, data: encodeFunctionData({abi: VAULT_ABI, functionName: \"WETH\"})}, \"latest\"])) as Hex;\n        const weth = decodeFunctionResult({abi: VAULT_ABI, functionName: \"WETH\", data: raw});\n        if (getAddress(weth) !== getAddress(BALANCER_V2_CHAINS[chainId]!.weth)) throw new Error(`balancer: the Vault on chain ${chainId} is not the pinned deployment — refusing`);\n      })();\n      p.catch(() => verified.delete(chainId));\n      verified.set(chainId, p);\n    }\n    return p;\n  }\n\n  /** Vault.queryBatchSwap on chain: the asset deltas this exact batch would produce. */\n  async function query(chainId: number, swaps: readonly Step[], assets: readonly Hex[], funds: Funds): Promise<readonly bigint[]> {\n    const data = encodeFunctionData({abi: VAULT_ABI, functionName: \"queryBatchSwap\", args: [0, swaps, assets, funds]});\n    const raw = (await rpc(chainId, \"eth_call\", [{to: BALANCER_V2_VAULT, data}, \"latest\"])) as Hex;\n    return decodeFunctionResult({abi: VAULT_ABI, functionName: \"queryBatchSwap\", data: raw});\n  }\n\n  return {\n    name: \"balancer\",\n    describeActivity: describeBalancerActivity,\n    supportsSameChain: true,\n    enabled: () => config.enabled ?? true,\n    supportsChain: (caip2: string) => chainIdOf(caip2) !== null,\n    supportsChainPair: (from: string, to: string) => from === to && chainIdOf(from) !== null,\n    supportsRoute: (from: Asset, to: Asset) => from.chain === to.chain && chainIdOf(from.chain) !== null,\n\n    async getQuote(params: QuoteParams, signal?: AbortSignal): Promise<Quote | null> {\n      const refuse = (why: string): null => {\n        params.onRefusal?.(`balancer: ${why}`);\n        return null;\n      };\n      if (params.flex) return refuse(\"amount-flexible deposits are not supported\");\n      if (params.sourceChain !== params.destChain) return refuse(\"same-chain swaps only\");\n      const chainId = chainIdOf(params.sourceChain);\n      if (chainId === null) return refuse(`no Balancer v2 Vault or RPC for ${params.sourceChain}`);\n      const chain = BALANCER_V2_CHAINS[chainId]!;\n      const src = ccAsset(params.sourceChain, params.sourceToken);\n      if (!src) return refuse(`unknown source token ${params.sourceToken}`);\n      const nativeIn = !src.contract;\n      const nativeOut = /^0x0+$/.test(params.destToken);\n      if (!nativeOut && !/^0x[0-9a-fA-F]{40}$/.test(params.destToken)) return refuse(\"destination token must be an EVM address\");\n      if (!/^0x[0-9a-fA-F]{40}$/.test(params.destAddress)) return refuse(\"recipient must be an EVM address\");\n      let amountIn: bigint;\n      try {\n        amountIn = BigInt(params.amountIn);\n      } catch {\n        return refuse(\"amount is not an integer\");\n      }\n      if (amountIn <= 0n) return refuse(\"amount must be positive\");\n      const tokenIn = getAddress(nativeIn ? chain.weth : src.contract!);\n      const tokenOut = getAddress(nativeOut ? chain.weth : params.destToken);\n      if (tokenIn === tokenOut) return refuse(nativeIn || nativeOut ? \"that is a wrap/unwrap, not a swap\" : \"same token in and out\");\n\n      try {\n        await verify(chainId);\n        // 1) Discovery: the SOR's v2 paths (never trusted for price).\n        // Values are inlined (this API ignores GraphQL variables); all are validated\n        // addresses / a decimal number / a fixed enum, so nothing user-shaped is spliced.\n        const query_ = `query { sorGetSwapPaths(chain: ${chain.api}, swapAmount: \"${human(amountIn, src.decimals)}\", swapType: EXACT_IN, tokenIn: \"${tokenIn}\", tokenOut: \"${tokenOut}\", useProtocolVersion: 2) { protocolVersion paths { pools tokens { address decimals } inputAmountRaw outputAmountRaw protocolVersion } } }`;\n        const res = await fetch(api, {\n          method: \"POST\",\n          headers: {\"content-type\": \"application/json\"},\n          body: JSON.stringify({query: query_}),\n          signal: signal ?? timeoutSignal(12_000),\n        });\n        if (!res.ok) return refuse(`SOR answered HTTP ${res.status}`);\n        const body = (await res.json()) as {data?: {sorGetSwapPaths?: {protocolVersion?: number; paths?: SorPath[]}}; errors?: {message?: string}[]};\n        const paths = body.data?.sorGetSwapPaths?.paths ?? [];\n        if (body.errors?.length) return refuse(`SOR: ${body.errors[0]?.message?.slice(0, 120) ?? \"error\"}`);\n        if (!paths.length || paths.some((p) => p.protocolVersion !== 2 || p.pools.length === 0 || p.tokens.length !== p.pools.length + 1)) {\n          return refuse(\"no Balancer v2 pool route for this pair and amount\");\n        }\n        if (paths.reduce((s, p) => s + BigInt(p.inputAmountRaw), 0n) !== amountIn) return refuse(\"the SOR split does not add up to the amount\");\n\n        // 2) Build the batch from the suggested paths.\n        const assets: Hex[] = [];\n        const indexOf = (a: string) => {\n          const addr = getAddress(a);\n          let i = assets.findIndex((x) => x === addr);\n          if (i < 0) i = assets.push(addr) - 1;\n          return BigInt(i);\n        };\n        const swaps: Step[] = [];\n        for (const p of paths) {\n          if (getAddress(p.tokens[0]!.address) !== tokenIn || getAddress(p.tokens[p.tokens.length - 1]!.address) !== tokenOut) return refuse(\"the SOR path does not start/end at the requested tokens\");\n          p.pools.forEach((pool, i) => {\n            if (!/^0x[0-9a-fA-F]{64}$/.test(pool)) throw new Error(\"balancer: malformed pool id from the SOR\");\n            swaps.push({poolId: pool as Hex, assetInIndex: indexOf(p.tokens[i]!.address), assetOutIndex: indexOf(p.tokens[i + 1]!.address), amount: i === 0 ? BigInt(p.inputAmountRaw) : 0n, userData: \"0x\"});\n          });\n        }\n        const inIdx = Number(indexOf(tokenIn));\n        const outIdx = Number(indexOf(tokenOut));\n        // The Vault's ETH sentinel: native in/out wraps/unwraps through its WETH.\n        if (nativeIn || nativeOut) {\n          const wethIdx = assets.findIndex((a) => a === getAddress(chain.weth));\n          if (paths.some((p) => p.tokens.slice(1, -1).some((t) => getAddress(t.address) === getAddress(chain.weth)))) return refuse(\"this route passes through the wrapped native — pick the wrapped token instead\");\n          if (wethIdx >= 0) assets[wethIdx] = ZERO as Hex;\n        }\n        const sender = getAddress(params.refundAddress && /^0x[0-9a-fA-F]{40}$/.test(params.refundAddress) ? params.refundAddress : params.destAddress);\n        const recipient = getAddress(params.destAddress);\n        const funds: Funds = {sender, fromInternalBalance: false, recipient, toInternalBalance: false};\n\n        // 3) Price it on-chain — this, not the SOR's number, is the quote.\n        const deltas = await query(chainId, swaps, assets, funds);\n        const paid = deltas[inIdx]!;\n        const out = -deltas[outIdx]!;\n        if (paid !== amountIn) return refuse(`the Vault would take ${paid}, not ${amountIn}`);\n        if (out <= 0n) return refuse(\"the Vault prices this route at zero output\");\n        if (deltas.some((d, i) => i !== inIdx && i !== outIdx && d !== 0n)) return refuse(\"the batch leaves an intermediate balance — refusing\");\n\n        const bps = params.slippageBps ?? slippageDefault;\n        const minOut = (out * BigInt(10_000 - bps)) / 10_000n;\n        if (params.minAmountOut !== undefined && minOut < BigInt(params.minAmountOut)) return refuse(`floor breach (min=${minOut} < floor=${params.minAmountOut})`);\n        const limits = assets.map((_, i) => (i === inIdx ? amountIn : i === outIdx ? -minOut : 0n));\n        const deadline = BigInt(Math.floor(Date.now() / 1000) + deadlineS);\n        const data = encodeFunctionData({abi: VAULT_ABI, functionName: \"batchSwap\", args: [0, swaps, assets, funds, limits, deadline]});\n        const gasLimit = 160_000n + 95_000n * BigInt(swaps.length);\n        return {\n          provider: \"balancer\",\n          intentId: `balancer:${chainId}`,\n          depositAddress: \"\",\n          depositMemo: null,\n          txRequest: {\n            to: BALANCER_V2_VAULT,\n            data,\n            value: nativeIn ? amountIn.toString() : \"0\",\n            chainId,\n            gasLimit: gasLimit.toString(),\n            ...(nativeIn ? {} : {approvalAddress: BALANCER_V2_VAULT}),\n          },\n          sourceAmount: amountIn.toString(),\n          destAmount: out.toString(),\n          minDestAmount: minOut.toString(),\n          feeUsd: 0,\n          etaSeconds: 15,\n          reliability: 0.97,\n          validUntilMs: Date.now() + ttl,\n          // Pool swap fees are inside the Vault-priced output; no fee is added on top.\n          providerData: {paths: String(paths.length), hops: String(swaps.length), minOut: minOut.toString(), poolFee: \"pools\"},\n        };\n      } catch (e) {\n        return refuse(e instanceof Error ? e.message.replace(/^balancer: /, \"\") : String(e));\n      }\n    },\n\n    /** Re-price the exact signed batch right before broadcast; refuse when the pools now pay under the minimum. */\n    async preflightDeposit(quote: Quote, tx: UnsignedTx): Promise<void> {\n      const chainId = Number(quote.intentId.split(\":\")[1]);\n      const minOut = quote.providerData?.minOut;\n      if (!BALANCER_V2_CHAINS[chainId] || !minOut || !tx.data) return;\n      const call = decodeFunctionData({abi: VAULT_ABI, data: tx.data as Hex});\n      if (call.functionName !== \"batchSwap\") throw new Error(\"balancer: the transaction is not a Vault batchSwap\");\n      const [, swaps, assets, funds, limits] = call.args;\n      const outIdx = limits.findIndex((l) => l < 0n);\n      const deltas = await query(chainId, swaps, assets, funds);\n      const out = -deltas[outIdx]!;\n      if (out < BigInt(minOut)) throw new Error(`balancer: price moved — the pools now pay ${out}, under your minimum ${minOut}. Nothing was sent; refresh the quote.`);\n    },\n\n    async buildDeposit(quote: Quote): Promise<UnsignedTx> {\n      const tx = quote.txRequest;\n      if (!tx?.to || !tx.data) throw new Error(\"swap2: Balancer quote has no transaction request\");\n      return {chain: \"\", to: tx.to, value: tx.value ?? \"0\", data: tx.data, ...(tx.chainId !== undefined ? {chainId: tx.chainId} : {}), ...(tx.gasLimit ? {gasLimit: tx.gasLimit} : {}), ...(tx.approvalAddress ? {approvalAddress: tx.approvalAddress} : {})};\n    },\n\n    async trackIntent(ref: IntentRef): Promise<IntentStatus> {\n      if (!ref.sourceTxHash) return {state: \"pending\"};\n      const chainId = Number(ref.intentId.split(\":\")[1]);\n      if (!BALANCER_V2_CHAINS[chainId] || !config.rpcUrls[chainId]?.length) return {state: \"pending\"};\n      try {\n        const receipt = (await rpc(chainId, \"eth_getTransactionReceipt\", [ref.sourceTxHash])) as {status?: string} | null;\n        if (!receipt) return {state: \"pending\"};\n        return receipt.status === \"0x1\" ? {state: \"completed\", destTxHash: ref.sourceTxHash} : {state: \"failed\"};\n      } catch {\n        return {state: \"pending\"};\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAAwD;AACxD,IAAAA,eAA4B;;;ACP5B,kBAA2G;AAE3G,0BAAsB;AACtB,kBAA2C;AAgBpC,IAAM,oBAAoB;AAO1B,IAAM,qBAAmF,OAAO,OAAO;AAAA,EAC5G,GAAG,EAAC,KAAK,WAAW,MAAM,6CAA4C;AAAA,EACtE,IAAI,EAAC,KAAK,YAAY,MAAM,6CAA4C;AAAA,EACxE,KAAK,EAAC,KAAK,UAAU,MAAM,6CAA4C;AAAA,EACvE,KAAK,EAAC,KAAK,WAAW,MAAM,6CAA4C;AAAA,EACxE,KAAK,EAAC,KAAK,SAAS,MAAM,6CAA4C;AAAA,EACtE,MAAM,EAAC,KAAK,QAAQ,MAAM,6CAA4C;AAAA,EACtE,MAAM,EAAC,KAAK,UAAU,MAAM,6CAA4C;AAAA,EACxE,OAAO,EAAC,KAAK,YAAY,MAAM,6CAA4C;AAAA,EAC3E,OAAO,EAAC,KAAK,aAAa,MAAM,6CAA4C;AAC9E,CAAC;AAED,IAAM,YAAY;AAClB,IAAM,QAAQ;AACd,IAAM,gBAAY,sBAAS;AAAA,EACzB,uCAAuC,SAAS,+BAA+B,KAAK;AAAA,EACpF,kCAAkC,SAAS,+BAA+B,KAAK;AAAA,EAC/E;AACF,CAAC;;;ADlCM,IAAM,kBAAkB;AAGxB,IAAM,2BAAgD,oBAAI,IAAI;AAAA,EACnE;AAAA;AAAA,EACA;AAAA;AACF,CAAC;AAEM,SAAS,yBAAyB,IAAa,KAAmD;AACvG,MAAI,KAAC,oBAAM,GAAG,KAAK,KAAK,CAAC,uBAAmB,qBAAO,GAAG,KAAK,CAAC,EAAG,QAAO;AACtE,MAAI,KAAC,6BAAY,IAAI,CAAC,iBAAiB,GAAG,wBAAwB,EAAG,QAAO;AAC5E,aAAO,kCAAiB,IAAI,KAAK,EAAC,UAAU,iBAAiB,UAAU,wBAAiB,4BAAW,GAAG,KAAK,CAAC,IAAI,MAAM,OAAM,CAAC;AAC/H;","names":["import_util"]}

package/dist/activity.d.cts

@@ -0,0 +1,14 @@
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Activity recognition for Balancer v2: `swap` / `batchSwap` on the Vault
+ * (one address on every chain) on a chain the module serves → `swap`,
+ * "Swapped A → B" from the owner's net transfers.
+ */
+
+declare const BALANCER_MODULE = "@anywalletkit/protocol-swap2-balancer";
+/** Vault swap entry points (`viem toFunctionSelector`, 2026-10-14). */
+declare const BALANCER_VAULT_SELECTORS: ReadonlySet<string>;
+declare function describeBalancerActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+
+export { BALANCER_MODULE, BALANCER_VAULT_SELECTORS, describeBalancerActivity };

package/dist/activity.d.ts

@@ -0,0 +1,14 @@
+import { ChainTx, DescribeActivityContext, ActivityItem } from '@anywalletkit/core';
+
+/**
+ * Activity recognition for Balancer v2: `swap` / `batchSwap` on the Vault
+ * (one address on every chain) on a chain the module serves → `swap`,
+ * "Swapped A → B" from the owner's net transfers.
+ */
+
+declare const BALANCER_MODULE = "@anywalletkit/protocol-swap2-balancer";
+/** Vault swap entry points (`viem toFunctionSelector`, 2026-10-14). */
+declare const BALANCER_VAULT_SELECTORS: ReadonlySet<string>;
+declare function describeBalancerActivity(tx: ChainTx, ctx: DescribeActivityContext): ActivityItem | null;
+
+export { BALANCER_MODULE, BALANCER_VAULT_SELECTORS, describeBalancerActivity };

package/dist/activity.js

@@ -0,0 +1,11 @@
+import {
+  BALANCER_MODULE,
+  BALANCER_VAULT_SELECTORS,
+  describeBalancerActivity
+} from "./chunk-TDP5RDX5.js";
+export {
+  BALANCER_MODULE,
+  BALANCER_VAULT_SELECTORS,
+  describeBalancerActivity
+};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

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

package/dist/chunk-IZBZL774.js

@@ -0,0 +1,28 @@
+import {
+  BALANCER_V2_CHAINS,
+  balancerProvider
+} from "./chunk-TDP5RDX5.js";
+
+// src/protocol.ts
+import { SingleProviderSwap2 } from "@anywalletkit/protocol-swap2-core/swap2/single";
+import { evmRef, isEvm } from "@anywalletkit/protocol-swap2-core/util";
+var BalancerSwap2Protocol = class extends SingleProviderSwap2 {
+  provider;
+  _rpcUrls;
+  constructor(account, config) {
+    super(account, config);
+    this.provider = balancerProvider(config);
+    this._rpcUrls = config.rpcUrls ?? {};
+  }
+  chainSupported(caip2) {
+    return isEvm(caip2) && !!BALANCER_V2_CHAINS[evmRef(caip2)] && !!this._rpcUrls[evmRef(caip2)]?.length;
+  }
+  pairSupported(fromChain, toChain) {
+    return fromChain === toChain && this.chainSupported(fromChain);
+  }
+};
+
+export {
+  BalancerSwap2Protocol
+};
+//# sourceMappingURL=chunk-IZBZL774.js.map

package/dist/chunk-IZBZL774.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"sourcesContent":["import {SingleProviderSwap2} from \"@anywalletkit/protocol-swap2-core/swap2/single\";\nimport type {Swap2Account, Swap2EngineConfig} from \"@anywalletkit/protocol-swap2-core/swap2/base\";\nimport {evmRef, isEvm} from \"@anywalletkit/protocol-swap2-core/util\";\nimport {BALANCER_V2_CHAINS, balancerProvider, type BalancerProviderConfig} from \"./provider.js\";\n\nexport interface BalancerSwap2Config extends Swap2EngineConfig, BalancerProviderConfig {}\n\n/** Balancer v2 as a standalone swap2 protocol (same-chain swaps on one account). */\nexport class BalancerSwap2Protocol extends SingleProviderSwap2 {\n  protected readonly provider;\n  private readonly _rpcUrls: BalancerProviderConfig[\"rpcUrls\"];\n  constructor(account: Swap2Account | undefined, config: BalancerSwap2Config) {\n    super(account, config);\n    this.provider = balancerProvider(config);\n    this._rpcUrls = config.rpcUrls ?? {};\n  }\n  protected override chainSupported(caip2: string): boolean {\n    return isEvm(caip2) && !!BALANCER_V2_CHAINS[evmRef(caip2)] && !!this._rpcUrls[evmRef(caip2)]?.length;\n  }\n  protected override pairSupported(fromChain: string, toChain: string): boolean {\n    return fromChain === toChain && this.chainSupported(fromChain);\n  }\n}\n"],"mappings":";;;;;;AAAA,SAAQ,2BAA0B;AAElC,SAAQ,QAAQ,aAAY;AAMrB,IAAM,wBAAN,cAAoC,oBAAoB;AAAA,EAC1C;AAAA,EACF;AAAA,EACjB,YAAY,SAAmC,QAA6B;AAC1E,UAAM,SAAS,MAAM;AACrB,SAAK,WAAW,iBAAiB,MAAM;AACvC,SAAK,WAAW,OAAO,WAAW,CAAC;AAAA,EACrC;AAAA,EACmB,eAAe,OAAwB;AACxD,WAAO,MAAM,KAAK,KAAK,CAAC,CAAC,mBAAmB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,OAAO,KAAK,CAAC,GAAG;AAAA,EAChG;AAAA,EACmB,cAAc,WAAmB,SAA0B;AAC5E,WAAO,cAAc,WAAW,KAAK,eAAe,SAAS;AAAA,EAC/D;AACF;","names":[]}