@anywalletkit/protocol-swap2-balancer 0.3.5 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/dist/activity.cjs +25 -22
  2. package/dist/activity.cjs.map +1 -1
  3. package/dist/activity.js +1 -1
  4. package/dist/{chunk-JFRZJ6N5.js → chunk-AENUP77U.js} +2 -2
  5. package/dist/{chunk-YF3UW4GH.js → chunk-XFRLZ25H.js} +75 -57
  6. package/dist/chunk-XFRLZ25H.js.map +1 -0
  7. package/dist/index.cjs +74 -56
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.js +2 -2
  10. package/dist/protocol.cjs +74 -56
  11. package/dist/protocol.cjs.map +1 -1
  12. package/dist/protocol.js +2 -2
  13. package/dist/provider.cjs +74 -56
  14. package/dist/provider.cjs.map +1 -1
  15. package/dist/provider.d.cts +1 -1
  16. package/dist/provider.d.ts +1 -1
  17. package/dist/provider.js +1 -1
  18. package/package.json +6 -6
  19. package/dist/chunk-YF3UW4GH.js.map +0 -1
  20. /package/dist/{chunk-JFRZJ6N5.js.map → chunk-AENUP77U.js.map} +0 -0
package/dist/chunk-XFRLZ25H.js.map ADDED
@@ -0,0 +1 @@
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 type {RemotePins} from \"@anywalletkit/protocol-swap2-core/types\";\nimport {decodeFunctionData, decodeFunctionResult, encodeFunctionData, getAddress, parseAbi, type Hex} from \"viem\";\nimport {describeBalancerActivity} from \"./activity.js\";\nimport {evmRef, isEvm, timeoutSignal, sourceAssetOf} from \"@anywalletkit/protocol-swap2-core/util\";\nimport {httpRefusal, refusal, refusalNotes, refusalOf, withReason, type Swap2RefusalInfo, type Swap2RefusalReason} from \"@anywalletkit/protocol-swap2-core/errors\";\nimport type {Asset, CrossChainProvider, IntentRef, IntentStatus, Quote, QuoteParams, UnsignedTx} from \"@anywalletkit/protocol-swap2-core/types\";\nimport {bigintToNumber} from \"@anywalletkit/core\";\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/** Most pool hops one batch may carry: the SOR's splits are a handful; a batch past this is refused at quote and at preflight. */\nexport const BALANCER_MAX_SWAPS = 16;\n/** The reasons of the texts {@link balancerVerifyQuote} returned, for `balancerPins.reasonOf`. */\nconst notes = refusalNotes();\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) {\n const error = new Error(`HTTP ${res.status}`);\n const info = httpRefusal(res.status, res.headers?.get?.(\"retry-after\"));\n throw info ? withReason(error, info) : error;\n }\n const body = (await res.json()) as {result?: unknown; error?: {code?: unknown; message?: string}};\n if (body.error) throw Object.assign(new Error(body.error.message ?? \"rpc error\"), {rpc: true, rpcCode: body.error.code});\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 // Every endpoint failed: the last one's own classification (a 429, a rejected key), else unavailable.\n throw withReason(new Error(`balancer: no RPC answered on chain ${chainId} (${lastErr instanceof Error ? lastErr.message : String(lastErr)})`), refusalOf(lastErr) ?? \"upstream_unavailable\");\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 refusal(\"vault_mismatch\", `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 /**\n * Vault.queryBatchSwap on chain: the asset deltas this exact batch would produce. A JSON-RPC error that says the\n * call reverted (code 3, Nethermind's -32015, a \"revert\" message) is the Vault reverting the batch\n * (`simulation_failed`); any other JSON-RPC error (\"header not found\", \"missing trie node\", a limit, an internal\n * error) and an answer that does not decode are the node's (`upstream_unavailable`).\n */\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 let raw: Hex;\n try {\n raw = (await rpc(chainId, \"eth_call\", [{to: BALANCER_V2_VAULT, data}, \"latest\"])) as Hex;\n } catch (e) {\n if (!(e instanceof Error) || !(e as {rpc?: boolean}).rpc) throw e;\n const code = (e as {rpcCode?: unknown}).rpcCode;\n throw withReason(e, code === 3 || code === -32015 || /revert/i.test(e.message) ? \"simulation_failed\" : \"upstream_unavailable\");\n }\n try {\n return decodeFunctionResult({abi: VAULT_ABI, functionName: \"queryBatchSwap\", data: raw});\n } catch (e) {\n throw e instanceof Error ? withReason(e, \"upstream_unavailable\") : e;\n }\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, info?: Swap2RefusalReason | Swap2RefusalInfo): null => {\n params.onRefusal?.(`balancer: ${why}`, typeof info === \"string\" ? {reason: info} : info);\n return null;\n };\n if (params.flex) return refuse(\"amount-flexible deposits are not supported\", \"unsupported_pair\");\n if (params.sourceChain !== params.destChain) return refuse(\"same-chain swaps only\", \"unsupported_pair\");\n const chainId = chainIdOf(params.sourceChain);\n if (chainId === null) return refuse(`no Balancer v2 Vault or RPC for ${params.sourceChain}`, \"unsupported_pair\");\n const chain = BALANCER_V2_CHAINS[chainId]!;\n const src = sourceAssetOf(params);\n if (!src) return refuse(`unknown source token ${params.sourceToken}`, \"unsupported_pair\");\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\", \"unsupported_pair\");\n if (!/^0x[0-9a-fA-F]{40}$/.test(params.destAddress)) return refuse(\"recipient must be an EVM address\", \"recipient_mismatch\");\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\", \"unsupported_pair\");\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 // 429 / 401 / 403 / 408 / 425 / 5xx by status; another 4xx says nothing without the body (a 404 is a misconfigured apiUrl).\n if (!res.ok) return refuse(`SOR answered HTTP ${res.status}`, httpRefusal(res.status, res.headers?.get?.(\"retry-after\")));\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\"}`, \"upstream_unavailable\");\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\", \"no_route\");\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\", \"price_check_failed\");\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\", \"policy_refused\");\n p.pools.forEach((pool, i) => {\n if (!/^0x[0-9a-fA-F]{64}$/.test(pool)) throw refusal(\"upstream_unavailable\", \"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 if (swaps.length > BALANCER_MAX_SWAPS) return refuse(`the SOR route has ${swaps.length} pool hops, more than ${BALANCER_MAX_SWAPS}`, \"policy_refused\");\n const inIdx = bigintToNumber(indexOf(tokenIn));\n const outIdx = bigintToNumber(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\", \"unsupported_pair\");\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}`, \"price_check_failed\");\n if (out <= 0n) return refuse(\"the Vault prices this route at zero output\", \"amount_too_small\");\n if (deltas.some((d, i) => i !== inIdx && i !== outIdx && d !== 0n)) return refuse(\"the batch leaves an intermediate balance — refusing\", \"policy_refused\");\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})`, \"price_check_failed\");\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 // Classified where thrown (the Vault check, the node, a revert); anything else is the SOR or the node\n // answering in another shape, or the network — never the caller's own abort.\n return refuse(e instanceof Error ? e.message.replace(/^balancer: /, \"\") : String(e), refusalOf(e) ?? (signal?.aborted ? undefined : \"upstream_unavailable\"));\n }\n },\n\n /**\n * Re-price the exact signed batch right before broadcast; refuse when the pools now pay under the minimum.\n * Only the quote's own batch is decoded and priced: behind a backend, `tx` is the client's and only the\n * quote is sealed, so a client's batch (any size, any pools) never reaches the decoder or the RPC\n * (scan 2026-10-27 modules, F24).\n */\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 quoted = quote.txRequest?.data;\n if (!quoted || tx.data.length !== quoted.length || tx.data.toLowerCase() !== quoted.toLowerCase()) {\n throw refusal(\"policy_refused\", \"balancer: the transaction is not the quoted batch. Nothing was sent; refresh the quote.\");\n }\n const call = decodeFunctionData({abi: VAULT_ABI, data: quoted as Hex});\n if (call.functionName !== \"batchSwap\") throw refusal(\"policy_refused\", \"balancer: the transaction is not a Vault batchSwap\");\n const [, swaps, assets, funds, limits] = call.args;\n if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) throw refusal(\"policy_refused\", `balancer: the batch has ${swaps.length} pool hops, not 1–${BALANCER_MAX_SWAPS}`);\n if (swaps.some((step) => step.userData !== \"0x\")) throw refusal(\"policy_refused\", \"balancer: the batch carries pool userData this module never sends\");\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 refusal(\"price_check_failed\", `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 refusal(\"policy_refused\", \"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\n/**\n * The batch a Balancer quote's Vault call makes, opened on the client against the app's own request (scan 2026-10-28,\n * F2): only `batchSwap` of kind GIVEN_IN on the Vault, with no internal balances and no pool `userData`, at most\n * {@link BALANCER_MAX_SWAPS} hops; funds taken from the sender the provider names (the refund address, else the\n * recipient) and paid to the recipient; every swap that brings in an amount sells the source token (the Vault's ETH\n * sentinel for a native input), the amounts adding up to exactly the input; one hop delivers the destination token;\n * and the limits allow paying exactly the input and receiving at least the quote's minimum, nothing of anything else.\n * `manageUserBalance`, `swap`, `setRelayerApproval` and every other Vault call are refused. The reason it fails, or null.\n */\nexport function balancerVerifyQuote(params: QuoteParams, quote: Quote): string | null {\n const id = /^eip155:[0-9]+$/.test(params.sourceChain) ? Number(params.sourceChain.slice(7)) : NaN;\n const chain = Object.prototype.hasOwnProperty.call(BALANCER_V2_CHAINS, id) ? BALANCER_V2_CHAINS[id] : undefined;\n if (!chain || params.destChain !== params.sourceChain) return notes.note(\"not a same-chain swap on a Balancer v2 chain\", \"unsupported_pair\");\n const tx = quote.txRequest;\n if (!tx?.data || !tx.to || tx.serializedTx !== undefined) return notes.note(\"the quote carries no Vault call\", \"policy_refused\");\n if (getAddress(tx.to) !== BALANCER_V2_VAULT) return notes.note(`the call targets ${tx.to}, not the Vault`, \"vault_mismatch\");\n const src = sourceAssetOf(params);\n if (!src) return notes.note(`unknown source token ${params.sourceToken}`, \"unsupported_pair\");\n const nativeIn = !src.contract;\n const nativeOut = /^0x0+$/.test(params.destToken);\n let tokenIn: Hex, tokenOut: Hex, sender: Hex, recipient: Hex, amountIn: bigint, minOut: bigint;\n try {\n tokenIn = getAddress(nativeIn ? ZERO : src.contract!);\n tokenOut = getAddress(nativeOut ? ZERO : params.destToken);\n recipient = getAddress(params.destAddress);\n sender = getAddress(params.refundAddress && /^0x[0-9a-fA-F]{40}$/.test(params.refundAddress) ? params.refundAddress : params.destAddress);\n amountIn = BigInt(params.amountIn);\n minOut = BigInt(quote.minDestAmount);\n } catch {\n return \"the request does not name EVM tokens, a recipient and amounts\";\n }\n if (nativeIn ? BigInt(tx.value ?? \"0\") !== amountIn || tx.approvalAddress !== undefined\n : BigInt(tx.value ?? \"0\") !== 0n || !tx.approvalAddress || getAddress(tx.approvalAddress) !== BALANCER_V2_VAULT) {\n return notes.note(nativeIn ? \"a native input is paid as exactly the input in value, with no approval\" : \"a token input attaches no value and approves the Vault\", \"policy_refused\");\n }\n let call: ReturnType<typeof decodeFunctionData<typeof VAULT_ABI>>;\n try { call = decodeFunctionData({abi: VAULT_ABI, data: tx.data as Hex}); } catch { return notes.note(\"the Vault call is not batchSwap\", \"policy_refused\"); }\n if (call.functionName !== \"batchSwap\") return notes.note(`${call.functionName} is not batchSwap`, \"policy_refused\");\n const [kind, swaps, assets, funds, limits] = call.args;\n if (kind !== 0) return notes.note(\"the batch is not GIVEN_IN\", \"policy_refused\");\n if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) return notes.note(`the batch has ${swaps.length} pool hops, not 1–${BALANCER_MAX_SWAPS}`, \"policy_refused\");\n if (funds.fromInternalBalance || funds.toInternalBalance) return notes.note(\"the batch uses Vault internal balances\", \"policy_refused\");\n // One text for two checks: paying another recipient is recipient_mismatch; debiting another account only is a batch shape this module never signs.\n if (getAddress(funds.sender) !== sender || getAddress(funds.recipient) !== recipient) return notes.note(`the batch takes from ${funds.sender} and pays ${funds.recipient}, not this account and the recipient`, getAddress(funds.recipient) !== recipient ? \"recipient_mismatch\" : \"policy_refused\");\n const list = assets.map((a) => getAddress(a));\n if (new Set(list).size !== list.length) return notes.note(\"the batch names an asset twice\", \"policy_refused\");\n if ((nativeIn || nativeOut) && list.includes(getAddress(chain.weth))) return notes.note(\"a native swap passes through the wrapped native\", \"policy_refused\");\n const inIdx = list.indexOf(tokenIn);\n const outIdx = list.indexOf(tokenOut);\n if (inIdx < 0 || outIdx < 0 || inIdx === outIdx) return notes.note(\"the batch does not trade the requested tokens\", \"policy_refused\");\n if (limits.length !== list.length || limits.some((l, i) => l !== (i === inIdx ? amountIn : i === outIdx ? -minOut : 0n))) {\n return notes.note(\"the limits are not exactly the input in and the quote's minimum out\", \"price_check_failed\");\n }\n let given = 0n;\n for (const step of swaps) {\n if (step.userData !== \"0x\") return notes.note(\"the batch carries pool userData this module never sends\", \"policy_refused\");\n if (step.assetInIndex >= BigInt(list.length) || step.assetOutIndex >= BigInt(list.length) || step.assetInIndex === step.assetOutIndex) return notes.note(\"a hop names no valid asset pair\", \"policy_refused\");\n if (step.amount > 0n) {\n if (step.assetInIndex !== BigInt(inIdx)) return notes.note(\"a hop brings in an amount of another asset than the input\", \"policy_refused\");\n given += step.amount;\n }\n }\n if (given !== amountIn) return notes.note(`the hops sell ${given}, not the ${amountIn} input`, \"price_check_failed\");\n if (!swaps.some((step) => step.assetOutIndex === BigInt(outIdx))) return notes.note(\"no hop delivers the destination token\", \"policy_refused\");\n if (call.args[5] <= BigInt(Math.floor(Date.now() / 1000))) return notes.note(\"the batch deadline has passed\", \"quote_expired\");\n return null;\n}\n\n/**\n * The Balancer V2 Vault a swap calls and approves on the chains this provider serves, and {@link balancerVerifyQuote}\n * — the app's pins for `remoteProvider({name: \"balancer\", baseUrl, ...balancerPins})` (scan 2026-10-27 modules,\n * F8/F16; scan 2026-10-28, F2). `reasonOf` classifies the texts `balancerVerifyQuote` returned.\n */\nexport const balancerPins: RemotePins = Object.freeze({\n callTargets: (chain: string): readonly string[] => balancerVaultFor(chain),\n spenders: (chain: string): readonly string[] => balancerVaultFor(chain),\n verifyQuote: balancerVerifyQuote,\n reasonOf: (refusal: string) => notes.reasonOf(refusal),\n});\nfunction balancerVaultFor(chain: string): readonly string[] {\n const id = /^eip155:[0-9]+$/.test(chain) ? Number(chain.slice(7)) : NaN;\n return Object.prototype.hasOwnProperty.call(BALANCER_V2_CHAINS, id) ? [BALANCER_V2_VAULT] : [];\n}\n"],"mappings":"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","names":["evmRef","isEvm","refusal","isEvm","evmRef"]}
package/dist/index.cjs CHANGED
@@ -55,6 +55,7 @@ function describeBalancerActivity(tx, ctx) {
55
55
 
56
56
  // src/provider.ts
57
57
  var import_util2 = require("@anywalletkit/protocol-swap2-core/util");
58
+ var import_errors = require("@anywalletkit/protocol-swap2-core/errors");
58
59
  var import_core = require("@anywalletkit/core");
59
60
  var ZERO = "0x0000000000000000000000000000000000000000";
60
61
  var BALANCER_V2_VAULT = "0xBA12222222228d8Ba445958a75a0704d566BF2C8";
@@ -63,6 +64,7 @@ var DEFAULT_SLIPPAGE_BPS = 50;
63
64
  var DEFAULT_TTL_MS = 3e5;
64
65
  var DEFAULT_DEADLINE_S = 600;
65
66
  var BALANCER_MAX_SWAPS = 16;
67
+ var notes = (0, import_errors.refusalNotes)();
66
68
  var BALANCER_V2_CHAINS = Object.freeze({
67
69
  1: { api: "MAINNET", weth: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" },
68
70
  10: { api: "OPTIMISM", weth: "0x4200000000000000000000000000000000000006" },
@@ -103,16 +105,20 @@ function balancerProvider(config) {
103
105
  for (const url of config.rpcUrls[chainId] ?? []) {
104
106
  try {
105
107
  const res = await fetch(url, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }), signal: (0, import_util2.timeoutSignal)(12e3) });
106
- if (!res.ok) throw new Error(`HTTP ${res.status}`);
108
+ if (!res.ok) {
109
+ const error = new Error(`HTTP ${res.status}`);
110
+ const info = (0, import_errors.httpRefusal)(res.status, res.headers?.get?.("retry-after"));
111
+ throw info ? (0, import_errors.withReason)(error, info) : error;
112
+ }
107
113
  const body = await res.json();
108
- if (body.error) throw Object.assign(new Error(body.error.message ?? "rpc error"), { rpc: true });
114
+ if (body.error) throw Object.assign(new Error(body.error.message ?? "rpc error"), { rpc: true, rpcCode: body.error.code });
109
115
  return body.result ?? null;
110
116
  } catch (e) {
111
117
  if (e.rpc) throw e;
112
118
  lastErr = e;
113
119
  }
114
120
  }
115
- throw new Error(`balancer: no RPC answered on chain ${chainId} (${lastErr instanceof Error ? lastErr.message : String(lastErr)})`);
121
+ throw (0, import_errors.withReason)(new Error(`balancer: no RPC answered on chain ${chainId} (${lastErr instanceof Error ? lastErr.message : String(lastErr)})`), (0, import_errors.refusalOf)(lastErr) ?? "upstream_unavailable");
116
122
  }
117
123
  function verify(chainId) {
118
124
  let p = verified.get(chainId);
@@ -120,7 +126,7 @@ function balancerProvider(config) {
120
126
  p = (async () => {
121
127
  const raw = await rpc(chainId, "eth_call", [{ to: BALANCER_V2_VAULT, data: (0, import_viem.encodeFunctionData)({ abi: VAULT_ABI, functionName: "WETH" }) }, "latest"]);
122
128
  const weth = (0, import_viem.decodeFunctionResult)({ abi: VAULT_ABI, functionName: "WETH", data: raw });
123
- if ((0, import_viem.getAddress)(weth) !== (0, import_viem.getAddress)(BALANCER_V2_CHAINS[chainId].weth)) throw new Error(`balancer: the Vault on chain ${chainId} is not the pinned deployment \u2014 refusing`);
129
+ if ((0, import_viem.getAddress)(weth) !== (0, import_viem.getAddress)(BALANCER_V2_CHAINS[chainId].weth)) throw (0, import_errors.refusal)("vault_mismatch", `balancer: the Vault on chain ${chainId} is not the pinned deployment \u2014 refusing`);
124
130
  })();
125
131
  p.catch(() => verified.delete(chainId));
126
132
  verified.set(chainId, p);
@@ -129,8 +135,19 @@ function balancerProvider(config) {
129
135
  }
130
136
  async function query(chainId, swaps, assets, funds) {
131
137
  const data = (0, import_viem.encodeFunctionData)({ abi: VAULT_ABI, functionName: "queryBatchSwap", args: [0, swaps, assets, funds] });
132
- const raw = await rpc(chainId, "eth_call", [{ to: BALANCER_V2_VAULT, data }, "latest"]);
133
- return (0, import_viem.decodeFunctionResult)({ abi: VAULT_ABI, functionName: "queryBatchSwap", data: raw });
138
+ let raw;
139
+ try {
140
+ raw = await rpc(chainId, "eth_call", [{ to: BALANCER_V2_VAULT, data }, "latest"]);
141
+ } catch (e) {
142
+ if (!(e instanceof Error) || !e.rpc) throw e;
143
+ const code = e.rpcCode;
144
+ throw (0, import_errors.withReason)(e, code === 3 || code === -32015 || /revert/i.test(e.message) ? "simulation_failed" : "upstream_unavailable");
145
+ }
146
+ try {
147
+ return (0, import_viem.decodeFunctionResult)({ abi: VAULT_ABI, functionName: "queryBatchSwap", data: raw });
148
+ } catch (e) {
149
+ throw e instanceof Error ? (0, import_errors.withReason)(e, "upstream_unavailable") : e;
150
+ }
134
151
  }
135
152
  return {
136
153
  name: "balancer",
@@ -141,21 +158,21 @@ function balancerProvider(config) {
141
158
  supportsChainPair: (from, to) => from === to && chainIdOf(from) !== null,
142
159
  supportsRoute: (from, to) => from.chain === to.chain && chainIdOf(from.chain) !== null,
143
160
  async getQuote(params, signal) {
144
- const refuse = (why) => {
145
- params.onRefusal?.(`balancer: ${why}`);
161
+ const refuse = (why, info) => {
162
+ params.onRefusal?.(`balancer: ${why}`, typeof info === "string" ? { reason: info } : info);
146
163
  return null;
147
164
  };
148
- if (params.flex) return refuse("amount-flexible deposits are not supported");
149
- if (params.sourceChain !== params.destChain) return refuse("same-chain swaps only");
165
+ if (params.flex) return refuse("amount-flexible deposits are not supported", "unsupported_pair");
166
+ if (params.sourceChain !== params.destChain) return refuse("same-chain swaps only", "unsupported_pair");
150
167
  const chainId = chainIdOf(params.sourceChain);
151
- if (chainId === null) return refuse(`no Balancer v2 Vault or RPC for ${params.sourceChain}`);
168
+ if (chainId === null) return refuse(`no Balancer v2 Vault or RPC for ${params.sourceChain}`, "unsupported_pair");
152
169
  const chain = BALANCER_V2_CHAINS[chainId];
153
170
  const src = (0, import_util2.sourceAssetOf)(params);
154
- if (!src) return refuse(`unknown source token ${params.sourceToken}`);
171
+ if (!src) return refuse(`unknown source token ${params.sourceToken}`, "unsupported_pair");
155
172
  const nativeIn = !src.contract;
156
173
  const nativeOut = /^0x0+$/.test(params.destToken);
157
- if (!nativeOut && !/^0x[0-9a-fA-F]{40}$/.test(params.destToken)) return refuse("destination token must be an EVM address");
158
- if (!/^0x[0-9a-fA-F]{40}$/.test(params.destAddress)) return refuse("recipient must be an EVM address");
174
+ if (!nativeOut && !/^0x[0-9a-fA-F]{40}$/.test(params.destToken)) return refuse("destination token must be an EVM address", "unsupported_pair");
175
+ if (!/^0x[0-9a-fA-F]{40}$/.test(params.destAddress)) return refuse("recipient must be an EVM address", "recipient_mismatch");
159
176
  let amountIn;
160
177
  try {
161
178
  amountIn = BigInt(params.amountIn);
@@ -165,7 +182,7 @@ function balancerProvider(config) {
165
182
  if (amountIn <= 0n) return refuse("amount must be positive");
166
183
  const tokenIn = (0, import_viem.getAddress)(nativeIn ? chain.weth : src.contract);
167
184
  const tokenOut = (0, import_viem.getAddress)(nativeOut ? chain.weth : params.destToken);
168
- if (tokenIn === tokenOut) return refuse(nativeIn || nativeOut ? "that is a wrap/unwrap, not a swap" : "same token in and out");
185
+ if (tokenIn === tokenOut) return refuse(nativeIn || nativeOut ? "that is a wrap/unwrap, not a swap" : "same token in and out", "unsupported_pair");
169
186
  try {
170
187
  await verify(chainId);
171
188
  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 } } }`;
@@ -175,14 +192,14 @@ function balancerProvider(config) {
175
192
  body: JSON.stringify({ query: query_ }),
176
193
  signal: signal ?? (0, import_util2.timeoutSignal)(12e3)
177
194
  });
178
- if (!res.ok) return refuse(`SOR answered HTTP ${res.status}`);
195
+ if (!res.ok) return refuse(`SOR answered HTTP ${res.status}`, (0, import_errors.httpRefusal)(res.status, res.headers?.get?.("retry-after")));
179
196
  const body = await res.json();
180
197
  const paths = body.data?.sorGetSwapPaths?.paths ?? [];
181
- if (body.errors?.length) return refuse(`SOR: ${body.errors[0]?.message?.slice(0, 120) ?? "error"}`);
198
+ if (body.errors?.length) return refuse(`SOR: ${body.errors[0]?.message?.slice(0, 120) ?? "error"}`, "upstream_unavailable");
182
199
  if (!paths.length || paths.some((p) => p.protocolVersion !== 2 || p.pools.length === 0 || p.tokens.length !== p.pools.length + 1)) {
183
- return refuse("no Balancer v2 pool route for this pair and amount");
200
+ return refuse("no Balancer v2 pool route for this pair and amount", "no_route");
184
201
  }
185
- if (paths.reduce((s, p) => s + BigInt(p.inputAmountRaw), 0n) !== amountIn) return refuse("the SOR split does not add up to the amount");
202
+ if (paths.reduce((s, p) => s + BigInt(p.inputAmountRaw), 0n) !== amountIn) return refuse("the SOR split does not add up to the amount", "price_check_failed");
186
203
  const assets = [];
187
204
  const indexOf = (a) => {
188
205
  const addr = (0, import_viem.getAddress)(a);
@@ -192,18 +209,18 @@ function balancerProvider(config) {
192
209
  };
193
210
  const swaps = [];
194
211
  for (const p of paths) {
195
- if ((0, import_viem.getAddress)(p.tokens[0].address) !== tokenIn || (0, import_viem.getAddress)(p.tokens[p.tokens.length - 1].address) !== tokenOut) return refuse("the SOR path does not start/end at the requested tokens");
212
+ if ((0, import_viem.getAddress)(p.tokens[0].address) !== tokenIn || (0, import_viem.getAddress)(p.tokens[p.tokens.length - 1].address) !== tokenOut) return refuse("the SOR path does not start/end at the requested tokens", "policy_refused");
196
213
  p.pools.forEach((pool, i) => {
197
- if (!/^0x[0-9a-fA-F]{64}$/.test(pool)) throw new Error("balancer: malformed pool id from the SOR");
214
+ if (!/^0x[0-9a-fA-F]{64}$/.test(pool)) throw (0, import_errors.refusal)("upstream_unavailable", "balancer: malformed pool id from the SOR");
198
215
  swaps.push({ poolId: pool, assetInIndex: indexOf(p.tokens[i].address), assetOutIndex: indexOf(p.tokens[i + 1].address), amount: i === 0 ? BigInt(p.inputAmountRaw) : 0n, userData: "0x" });
199
216
  });
200
217
  }
201
- if (swaps.length > BALANCER_MAX_SWAPS) return refuse(`the SOR route has ${swaps.length} pool hops, more than ${BALANCER_MAX_SWAPS}`);
218
+ if (swaps.length > BALANCER_MAX_SWAPS) return refuse(`the SOR route has ${swaps.length} pool hops, more than ${BALANCER_MAX_SWAPS}`, "policy_refused");
202
219
  const inIdx = (0, import_core.bigintToNumber)(indexOf(tokenIn));
203
220
  const outIdx = (0, import_core.bigintToNumber)(indexOf(tokenOut));
204
221
  if (nativeIn || nativeOut) {
205
222
  const wethIdx = assets.findIndex((a) => a === (0, import_viem.getAddress)(chain.weth));
206
- if (paths.some((p) => p.tokens.slice(1, -1).some((t) => (0, import_viem.getAddress)(t.address) === (0, import_viem.getAddress)(chain.weth)))) return refuse("this route passes through the wrapped native \u2014 pick the wrapped token instead");
223
+ if (paths.some((p) => p.tokens.slice(1, -1).some((t) => (0, import_viem.getAddress)(t.address) === (0, import_viem.getAddress)(chain.weth)))) return refuse("this route passes through the wrapped native \u2014 pick the wrapped token instead", "unsupported_pair");
207
224
  if (wethIdx >= 0) assets[wethIdx] = ZERO;
208
225
  }
209
226
  const sender = (0, import_viem.getAddress)(params.refundAddress && /^0x[0-9a-fA-F]{40}$/.test(params.refundAddress) ? params.refundAddress : params.destAddress);
@@ -212,12 +229,12 @@ function balancerProvider(config) {
212
229
  const deltas = await query(chainId, swaps, assets, funds);
213
230
  const paid = deltas[inIdx];
214
231
  const out = -deltas[outIdx];
215
- if (paid !== amountIn) return refuse(`the Vault would take ${paid}, not ${amountIn}`);
216
- if (out <= 0n) return refuse("the Vault prices this route at zero output");
217
- if (deltas.some((d, i) => i !== inIdx && i !== outIdx && d !== 0n)) return refuse("the batch leaves an intermediate balance \u2014 refusing");
232
+ if (paid !== amountIn) return refuse(`the Vault would take ${paid}, not ${amountIn}`, "price_check_failed");
233
+ if (out <= 0n) return refuse("the Vault prices this route at zero output", "amount_too_small");
234
+ if (deltas.some((d, i) => i !== inIdx && i !== outIdx && d !== 0n)) return refuse("the batch leaves an intermediate balance \u2014 refusing", "policy_refused");
218
235
  const bps = params.slippageBps ?? slippageDefault;
219
236
  const minOut = out * BigInt(1e4 - bps) / 10000n;
220
- if (params.minAmountOut !== void 0 && minOut < BigInt(params.minAmountOut)) return refuse(`floor breach (min=${minOut} < floor=${params.minAmountOut})`);
237
+ if (params.minAmountOut !== void 0 && minOut < BigInt(params.minAmountOut)) return refuse(`floor breach (min=${minOut} < floor=${params.minAmountOut})`, "price_check_failed");
221
238
  const limits = assets.map((_, i) => i === inIdx ? amountIn : i === outIdx ? -minOut : 0n);
222
239
  const deadline = BigInt(Math.floor(Date.now() / 1e3) + deadlineS);
223
240
  const data = (0, import_viem.encodeFunctionData)({ abi: VAULT_ABI, functionName: "batchSwap", args: [0, swaps, assets, funds, limits, deadline] });
@@ -246,7 +263,7 @@ function balancerProvider(config) {
246
263
  providerData: { paths: String(paths.length), hops: String(swaps.length), minOut: minOut.toString(), poolFee: "pools" }
247
264
  };
248
265
  } catch (e) {
249
- return refuse(e instanceof Error ? e.message.replace(/^balancer: /, "") : String(e));
266
+ return refuse(e instanceof Error ? e.message.replace(/^balancer: /, "") : String(e), (0, import_errors.refusalOf)(e) ?? (signal?.aborted ? void 0 : "upstream_unavailable"));
250
267
  }
251
268
  },
252
269
  /**
@@ -261,21 +278,21 @@ function balancerProvider(config) {
261
278
  if (!BALANCER_V2_CHAINS[chainId] || !minOut || !tx.data) return;
262
279
  const quoted = quote.txRequest?.data;
263
280
  if (!quoted || tx.data.length !== quoted.length || tx.data.toLowerCase() !== quoted.toLowerCase()) {
264
- throw new Error("balancer: the transaction is not the quoted batch. Nothing was sent; refresh the quote.");
281
+ throw (0, import_errors.refusal)("policy_refused", "balancer: the transaction is not the quoted batch. Nothing was sent; refresh the quote.");
265
282
  }
266
283
  const call = (0, import_viem.decodeFunctionData)({ abi: VAULT_ABI, data: quoted });
267
- if (call.functionName !== "batchSwap") throw new Error("balancer: the transaction is not a Vault batchSwap");
284
+ if (call.functionName !== "batchSwap") throw (0, import_errors.refusal)("policy_refused", "balancer: the transaction is not a Vault batchSwap");
268
285
  const [, swaps, assets, funds, limits] = call.args;
269
- if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) throw new Error(`balancer: the batch has ${swaps.length} pool hops, not 1\u2013${BALANCER_MAX_SWAPS}`);
270
- if (swaps.some((step) => step.userData !== "0x")) throw new Error("balancer: the batch carries pool userData this module never sends");
286
+ if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) throw (0, import_errors.refusal)("policy_refused", `balancer: the batch has ${swaps.length} pool hops, not 1\u2013${BALANCER_MAX_SWAPS}`);
287
+ if (swaps.some((step) => step.userData !== "0x")) throw (0, import_errors.refusal)("policy_refused", "balancer: the batch carries pool userData this module never sends");
271
288
  const outIdx = limits.findIndex((l) => l < 0n);
272
289
  const deltas = await query(chainId, swaps, assets, funds);
273
290
  const out = -deltas[outIdx];
274
- if (out < BigInt(minOut)) throw new Error(`balancer: price moved \u2014 the pools now pay ${out}, under your minimum ${minOut}. Nothing was sent; refresh the quote.`);
291
+ if (out < BigInt(minOut)) throw (0, import_errors.refusal)("price_check_failed", `balancer: price moved \u2014 the pools now pay ${out}, under your minimum ${minOut}. Nothing was sent; refresh the quote.`);
275
292
  },
276
293
  async buildDeposit(quote) {
277
294
  const tx = quote.txRequest;
278
- if (!tx?.to || !tx.data) throw new Error("swap2: Balancer quote has no transaction request");
295
+ if (!tx?.to || !tx.data) throw (0, import_errors.refusal)("policy_refused", "swap2: Balancer quote has no transaction request");
279
296
  return { chain: "", to: tx.to, value: tx.value ?? "0", data: tx.data, ...tx.chainId !== void 0 ? { chainId: tx.chainId } : {}, ...tx.gasLimit ? { gasLimit: tx.gasLimit } : {}, ...tx.approvalAddress ? { approvalAddress: tx.approvalAddress } : {} };
280
297
  },
281
298
  async trackIntent(ref) {
@@ -295,12 +312,12 @@ function balancerProvider(config) {
295
312
  function balancerVerifyQuote(params, quote) {
296
313
  const id = /^eip155:[0-9]+$/.test(params.sourceChain) ? Number(params.sourceChain.slice(7)) : NaN;
297
314
  const chain = Object.prototype.hasOwnProperty.call(BALANCER_V2_CHAINS, id) ? BALANCER_V2_CHAINS[id] : void 0;
298
- if (!chain || params.destChain !== params.sourceChain) return "not a same-chain swap on a Balancer v2 chain";
315
+ if (!chain || params.destChain !== params.sourceChain) return notes.note("not a same-chain swap on a Balancer v2 chain", "unsupported_pair");
299
316
  const tx = quote.txRequest;
300
- if (!tx?.data || !tx.to || tx.serializedTx !== void 0) return "the quote carries no Vault call";
301
- if ((0, import_viem.getAddress)(tx.to) !== BALANCER_V2_VAULT) return `the call targets ${tx.to}, not the Vault`;
317
+ if (!tx?.data || !tx.to || tx.serializedTx !== void 0) return notes.note("the quote carries no Vault call", "policy_refused");
318
+ if ((0, import_viem.getAddress)(tx.to) !== BALANCER_V2_VAULT) return notes.note(`the call targets ${tx.to}, not the Vault`, "vault_mismatch");
302
319
  const src = (0, import_util2.sourceAssetOf)(params);
303
- if (!src) return `unknown source token ${params.sourceToken}`;
320
+ if (!src) return notes.note(`unknown source token ${params.sourceToken}`, "unsupported_pair");
304
321
  const nativeIn = !src.contract;
305
322
  const nativeOut = /^0x0+$/.test(params.destToken);
306
323
  let tokenIn, tokenOut, sender, recipient, amountIn, minOut;
@@ -315,47 +332,48 @@ function balancerVerifyQuote(params, quote) {
315
332
  return "the request does not name EVM tokens, a recipient and amounts";
316
333
  }
317
334
  if (nativeIn ? BigInt(tx.value ?? "0") !== amountIn || tx.approvalAddress !== void 0 : BigInt(tx.value ?? "0") !== 0n || !tx.approvalAddress || (0, import_viem.getAddress)(tx.approvalAddress) !== BALANCER_V2_VAULT) {
318
- return nativeIn ? "a native input is paid as exactly the input in value, with no approval" : "a token input attaches no value and approves the Vault";
335
+ return notes.note(nativeIn ? "a native input is paid as exactly the input in value, with no approval" : "a token input attaches no value and approves the Vault", "policy_refused");
319
336
  }
320
337
  let call;
321
338
  try {
322
339
  call = (0, import_viem.decodeFunctionData)({ abi: VAULT_ABI, data: tx.data });
323
340
  } catch {
324
- return "the Vault call is not batchSwap";
341
+ return notes.note("the Vault call is not batchSwap", "policy_refused");
325
342
  }
326
- if (call.functionName !== "batchSwap") return `${call.functionName} is not batchSwap`;
343
+ if (call.functionName !== "batchSwap") return notes.note(`${call.functionName} is not batchSwap`, "policy_refused");
327
344
  const [kind, swaps, assets, funds, limits] = call.args;
328
- if (kind !== 0) return "the batch is not GIVEN_IN";
329
- if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) return `the batch has ${swaps.length} pool hops, not 1\u2013${BALANCER_MAX_SWAPS}`;
330
- if (funds.fromInternalBalance || funds.toInternalBalance) return "the batch uses Vault internal balances";
331
- if ((0, import_viem.getAddress)(funds.sender) !== sender || (0, import_viem.getAddress)(funds.recipient) !== recipient) return `the batch takes from ${funds.sender} and pays ${funds.recipient}, not this account and the recipient`;
345
+ if (kind !== 0) return notes.note("the batch is not GIVEN_IN", "policy_refused");
346
+ if (swaps.length === 0 || swaps.length > BALANCER_MAX_SWAPS) return notes.note(`the batch has ${swaps.length} pool hops, not 1\u2013${BALANCER_MAX_SWAPS}`, "policy_refused");
347
+ if (funds.fromInternalBalance || funds.toInternalBalance) return notes.note("the batch uses Vault internal balances", "policy_refused");
348
+ if ((0, import_viem.getAddress)(funds.sender) !== sender || (0, import_viem.getAddress)(funds.recipient) !== recipient) return notes.note(`the batch takes from ${funds.sender} and pays ${funds.recipient}, not this account and the recipient`, (0, import_viem.getAddress)(funds.recipient) !== recipient ? "recipient_mismatch" : "policy_refused");
332
349
  const list = assets.map((a) => (0, import_viem.getAddress)(a));
333
- if (new Set(list).size !== list.length) return "the batch names an asset twice";
334
- if ((nativeIn || nativeOut) && list.includes((0, import_viem.getAddress)(chain.weth))) return "a native swap passes through the wrapped native";
350
+ if (new Set(list).size !== list.length) return notes.note("the batch names an asset twice", "policy_refused");
351
+ if ((nativeIn || nativeOut) && list.includes((0, import_viem.getAddress)(chain.weth))) return notes.note("a native swap passes through the wrapped native", "policy_refused");
335
352
  const inIdx = list.indexOf(tokenIn);
336
353
  const outIdx = list.indexOf(tokenOut);
337
- if (inIdx < 0 || outIdx < 0 || inIdx === outIdx) return "the batch does not trade the requested tokens";
354
+ if (inIdx < 0 || outIdx < 0 || inIdx === outIdx) return notes.note("the batch does not trade the requested tokens", "policy_refused");
338
355
  if (limits.length !== list.length || limits.some((l, i) => l !== (i === inIdx ? amountIn : i === outIdx ? -minOut : 0n))) {
339
- return "the limits are not exactly the input in and the quote's minimum out";
356
+ return notes.note("the limits are not exactly the input in and the quote's minimum out", "price_check_failed");
340
357
  }
341
358
  let given = 0n;
342
359
  for (const step of swaps) {
343
- if (step.userData !== "0x") return "the batch carries pool userData this module never sends";
344
- if (step.assetInIndex >= BigInt(list.length) || step.assetOutIndex >= BigInt(list.length) || step.assetInIndex === step.assetOutIndex) return "a hop names no valid asset pair";
360
+ if (step.userData !== "0x") return notes.note("the batch carries pool userData this module never sends", "policy_refused");
361
+ if (step.assetInIndex >= BigInt(list.length) || step.assetOutIndex >= BigInt(list.length) || step.assetInIndex === step.assetOutIndex) return notes.note("a hop names no valid asset pair", "policy_refused");
345
362
  if (step.amount > 0n) {
346
- if (step.assetInIndex !== BigInt(inIdx)) return "a hop brings in an amount of another asset than the input";
363
+ if (step.assetInIndex !== BigInt(inIdx)) return notes.note("a hop brings in an amount of another asset than the input", "policy_refused");
347
364
  given += step.amount;
348
365
  }
349
366
  }
350
- if (given !== amountIn) return `the hops sell ${given}, not the ${amountIn} input`;
351
- if (!swaps.some((step) => step.assetOutIndex === BigInt(outIdx))) return "no hop delivers the destination token";
352
- if (call.args[5] <= BigInt(Math.floor(Date.now() / 1e3))) return "the batch deadline has passed";
367
+ if (given !== amountIn) return notes.note(`the hops sell ${given}, not the ${amountIn} input`, "price_check_failed");
368
+ if (!swaps.some((step) => step.assetOutIndex === BigInt(outIdx))) return notes.note("no hop delivers the destination token", "policy_refused");
369
+ if (call.args[5] <= BigInt(Math.floor(Date.now() / 1e3))) return notes.note("the batch deadline has passed", "quote_expired");
353
370
  return null;
354
371
  }
355
372
  var balancerPins = Object.freeze({
356
373
  callTargets: (chain) => balancerVaultFor(chain),
357
374
  spenders: (chain) => balancerVaultFor(chain),
358
- verifyQuote: balancerVerifyQuote
375
+ verifyQuote: balancerVerifyQuote,
376
+ reasonOf: (refusal2) => notes.reasonOf(refusal2)
359
377
  });
360
378
  function balancerVaultFor(chain) {
361
379
  const id = /^eip155:[0-9]+$/.test(chain) ? Number(chain.slice(7)) : NaN;