@eco-incorp/sauce 0.99.3 → 0.99.5

package/sdk/src/protocols/wormhole/abis.ts

@@ -28,7 +28,7 @@ export const WormholeTokenBridgeABI = [
       { name: "token", type: "address" },
       { name: "amount", type: "uint256" },
       { name: "recipientChain", type: "uint16" },
-      { name: "recipient", type: "uint256" },
+      { name: "recipient", type: "bytes32" },
       { name: "arbiterFee", type: "uint256" },
       { name: "nonce", type: "uint32" },
     ],
@@ -47,7 +47,7 @@ export const WormholeTokenBridgeABI = [
     stateMutability: "view",
     inputs: [
       { name: "tokenChainId", type: "uint16" },
-      { name: "tokenAddress", type: "uint256" },
+      { name: "tokenAddress", type: "bytes32" },
     ],
     outputs: [{ name: "", type: "address" }],
   },

package/sdk/src/protocols/wormhole/addresses.ts

@@ -1,6 +1,15 @@
 import type { ChainDeployment } from "../../core/types.js";
 
 export const deployments: ChainDeployment[] = [
+  {
+    // Arc (5042) — wormhole-sdk-ts core contracts (Mainnet, "Arc", Wormhole chain id 71). No Token
+    // Bridge is listed for Arc, so tokenBridge is absent. getCode + view-call verified on-chain 2026-09-28 (Arc mainnet, block 23287436): chainId() == 71.
+    chainId: 5042,
+    chainName: "Arc",
+    addresses: {
+      coreBridge: "0xC8aD24fC6063c41cB5C12a8e3851AafC3b3CF027",
+    },
+  },
   {
     chainId: 1,
     chainName: "Ethereum",

package/sdk/src/protocols/zerolend/addresses.ts

@@ -5,7 +5,8 @@ export const deployments: ChainDeployment[] = [
     chainId: 324,
     chainName: "zkSync",
     addresses: {
-      pool: "0x4d9429246EA989C9CeE203B43F6d1D7D83e3B8F8",
+      // zToken.POOL(); the address listed before differed in one digit and had no code.
+      pool: "0x4d9429246EA989C9CeE203B43F6d1C7D83e3B8F8",
     },
   },
 ];

package/sdk/src/protocols/zerox/addresses.ts

@@ -19,7 +19,8 @@ export const deployments: ChainDeployment[] = [
     chainId: 10,
     chainName: "Optimism",
     addresses: {
-      exchangeProxy: "0xDef1C0ded9bec7F1a1670819833240f027b25EfF",
+      // Optimism's Exchange Proxy is a separate deployment; 0xDef1C0de… has no code here.
+      exchangeProxy: "0xDEF1ABE32c034e558Cdd535791643C58a13aCC10",
     },
   },
   {

package/sdk/src/protocols/zksync-bridge/ZkSyncDiamondProxyABI.json

@@ -37,7 +37,7 @@
       "outputs": [
         {
           "name": "canonicalTxHash",
-          "type": "uint256"
+          "type": "bytes32"
         }
       ]
     },

package/sdk/src/protocols/zksync-bridge/abis.ts

@@ -12,7 +12,7 @@ export const ZkSyncDiamondProxyABI = [
       { name: "_factoryDeps", type: "bytes[]" },
       { name: "_refundRecipient", type: "address" },
     ],
-    outputs: [{ name: "canonicalTxHash", type: "uint256" }],
+    outputs: [{ name: "canonicalTxHash", type: "bytes32" }],
   },
   {
     name: "l2TransactionBaseCost",

package/sdk/src/skills/aave-v4.md

@@ -0,0 +1,91 @@
+# Aave V4
+
+Hub-and-spoke lending. Liquidity sits in a Hub; users supply, borrow and repay through Spokes, and each Spoke addresses its assets by reserve id rather than by token address.
+
+## Category
+
+lending | Chains: Ethereum (1), Base (8453), Avalanche (43114), Arc (5042)
+
+## SauceScript Functions
+
+### supply
+
+```typescript
+import { AaveV4SpokeABI as ISpoke } from "./abis";
+
+function main(
+  spokeAddress: Address,
+  reserveId: Uint256,
+  amount: Uint256,
+  onBehalfOf: Address,
+): Uint256 {
+  const spoke = ISpoke.at(spokeAddress);
+  spoke.supply(reserveId, amount, onBehalfOf);
+  return 1;
+}
+```
+
+- `reserveId`: the Spoke's reserve id for the asset. Resolve it with `spoke.getReserveId(hub, hub.getAssetId(token))`
+- The underlying token must be `approve`d to the Spoke first
+
+`withdraw`, `borrow` and `repay` take the same `(reserveId, amount, onBehalfOf)` arguments.
+
+## Deployed Addresses
+
+| Chain     | Contract                | Address                                      |
+| --------- | ----------------------- | -------------------------------------------- |
+| Ethereum  | Core Hub                | `0xCca852Bc40e560adC3b1Cc58CA5b55638ce826c9` |
+| Ethereum  | Plus Hub                | `0x06002e9c4412CB7814a791eA3666D905871E536A` |
+| Ethereum  | Prime Hub               | `0x943827DCA022D0F354a8a8c332dA1e5Eb9f9F931` |
+| Ethereum  | Global Dollar Hub       | `0x62d63197660c080236193CA60b70E49A08E90368` |
+| Ethereum  | Main Spoke              | `0x94e7A5dCbE816e498b89aB752661904E2F56c485` |
+| Ethereum  | Forex Spoke             | `0xD8B93635b8C6d0fF98CbE90b5988E3F2d1Cd9da1` |
+| Ethereum  | Bluechip Spoke          | `0x973a023A77420ba610f06b3858aD991Df6d85A08` |
+| Ethereum  | Ethena Correlated Spoke | `0x58131E79531caB1d52301228d1f7b842F26B9649` |
+| Ethereum  | Ethena Ecosystem Spoke  | `0xba1B3D55D249692b669A164024A838309B7508AF` |
+| Ethereum  | Gold Spoke              | `0x65407b940966954b23dfA3caA5C0702bB42984DC` |
+| Ethereum  | PAXG Gold Spoke         | `0xAD75cE6354f87F3135cE10621d385d8D1e2562C2` |
+| Ethereum  | Lombard BTC Spoke       | `0x7EC68b5695e803e98a21a9A05d744F28b0a7753D` |
+| Ethereum  | USDG Pendle Spoke       | `0x956d8e0A89cfa3744428C4641b5a53B56167a7f9` |
+| Ethereum  | ether.fi E-Spoke        | `0xbF10BDfE177dE0336aFD7fcCF80A904E15386219` |
+| Ethereum  | Kelp E-Spoke            | `0x3131FE68C4722e726fe6B2819ED68e514395B9a4` |
+| Ethereum  | Lido E-Spoke            | `0xe1900480ac69f0B296841Cd01cC37546d92F35Cd` |
+| Ethereum  | USDG Maple E-Spoke      | `0x774b9655413c34809c1f1b16b654465A89EBE989` |
+| Base      | Equities Hub            | `0xa4d5947Eb727A052bae69C593FfC84247EC9864E` |
+| Base      | Mag7 Spoke              | `0x17905Db0e4A3514467539956c084180616AE7B8D` |
+| Avalanche | Core Hub                | `0xd07369fAE4A5BB13c9Ce446B052c7867B1AbDf6e` |
+| Avalanche | Main Spoke              | `0x435272CefF93a1E657E8ABfdf0A13e95900A3a56` |
+| Avalanche | Forex Spoke             | `0x6a37776B5E026dBdF043b4F933c323C84DD1B514` |
+| Avalanche | AVAX Correlated Spoke   | `0x3b517594277c67307CF2d7CBE6FE1D4399B68c41` |
+| Arc       | Core Hub                | `0x17288dfc86205301064577b98B02b81017e6F79C` |
+| Arc       | Main Spoke              | `0xB843bdC3a87A05E77E07Df9FE48928b3A34b134d` |
+| Arc       | Forex Spoke             | `0x4164EBCAF74670aa74C8D4F59de6157c0780F1bB` |
+
+## ABI Reference
+
+### AaveV4SpokeABI
+
+- `supply(uint256 reserveId, uint256 amount, address onBehalfOf) returns (uint256, uint256)`
+- `withdraw(uint256 reserveId, uint256 amount, address onBehalfOf) returns (uint256, uint256)`
+- `borrow(uint256 reserveId, uint256 amount, address onBehalfOf) returns (uint256, uint256)`
+- `repay(uint256 reserveId, uint256 amount, address onBehalfOf) returns (uint256, uint256)`
+- `setUsingAsCollateral(uint256 reserveId, bool usingAsCollateral, address onBehalfOf)`
+- `getReserveId(address hub, uint256 assetId) returns (uint256)` (view)
+- `getReserveCount() returns (uint256)` (view)
+- `getUserSuppliedAssets(uint256 reserveId, address user) returns (uint256)` (view)
+- `getUserTotalDebt(uint256 reserveId, address user) returns (uint256)` (view)
+
+### AaveV4HubABI
+
+- `getAssetId(address underlying) returns (uint256)` (view)
+- `getAssetCount() returns (uint256)` (view)
+- `getAssetLiquidity(uint256 assetId) returns (uint256)` (view)
+- `isUnderlyingListed(address underlying) returns (bool)` (view)
+
+## Notes
+
+- Arc's market lists USDC, EURC, WETH and cirBTC. The Main Spoke carries all four; the Forex Spoke carries USDC and EURC
+- A chain can carry several Hubs, and a Spoke draws on one or more of them: `getReserveId(hub, assetId)` needs the Hub the asset lives in. Base carries only an equities market (tokenized stocks and USDC) with no core hub
+- Each chain also has a Treasury Spoke, which collects fees; it is not a market and is not registered
+- Hub, Spokes and their implementations are upgradeable (EIP-1967) proxies
+- Addresses come from bgd-labs/aave-address-book (`AaveV4Ethereum`, `AaveV4Base`, `AaveV4Avalanche`, `AaveV4Arc`)

package/sdk/src/skills/across.md

@@ -4,13 +4,13 @@ Optimistic cross-chain bridge powered by UMA's optimistic oracle. Uses relayers
 
 ## Category
 
-bridge | Direction: L2-to-L2, L1-to-L2, L2-to-L1 | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), zkSync (324), Linea (59144), Mode (34443), Blast (81457), Scroll (534352)
+bridge | Direction: L2-to-L2, L1-to-L2, L2-to-L1 | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), zkSync (324), Linea (59144), Mode (34443), Blast (81457), Scroll (534352), Arc (5042)
 
 ## SauceScript Functions
 
 ### bridge
 
-Deposit tokens into SpokePool for cross-chain transfer. Uses the legacy `deposit` function.
+Deposit tokens into the SpokePool for a cross-chain transfer, through `depositV3`.
 
 ```typescript
 import { AcrossSpokePoolABI as ISpokePool } from "./abis";
@@ -18,21 +18,39 @@ import { AcrossSpokePoolABI as ISpokePool } from "./abis";
 function main(
   spokePoolAddress: Address,
   token: Address,
+  outputToken: Address,
   amount: Uint256,
+  outputAmount: Uint256,
   destinationChainId: Uint256,
   recipient: Address,
+  quoteTimestamp: Uint256,
+  fillDeadline: Uint256,
 ): Uint256 {
   const spokePool = ISpokePool.at(spokePoolAddress);
-  spokePool.deposit(recipient, token, amount, destinationChainId, 0, 0, ctx.msgSender(), 0);
+  spokePool.depositV3(
+    ctx.msgSender(),
+    recipient,
+    token,
+    outputToken,
+    amount,
+    outputAmount,
+    destinationChainId,
+    0x0000000000000000000000000000000000000000,
+    quoteTimestamp,
+    fillDeadline,
+    0,
+    "",
+  );
   return 1;
 }
 ```
 
-- `token`: ERC-20 token to bridge (must be supported by Across)
-- `destinationChainId`: EVM chain ID of destination chain
+- `token` / `outputToken`: ERC-20 to bridge, and the token the recipient receives on the destination
+- `outputAmount`: amount the relayer delivers (input minus the quoted fees)
+- `quoteTimestamp`: the quote's timestamp; the SpokePool rejects one outside its `depositQuoteTimeBuffer`
+- `fillDeadline`: unix time after which the deposit can no longer be filled
 - `recipient`: Address to receive tokens on destination chain
 - Requires ERC-20 approval to the SpokePool
-- Note: `depositV3` is the current recommended method (see ABI below)
 
 ## Deployed Addresses
 
@@ -54,19 +72,19 @@ function main(
 
 ### AcrossSpokePoolABI
 
-- `depositV3(address depositor, address recipient, address inputToken, address outputToken, uint256 inputAmount, uint256 outputAmount, uint256 destinationChainId, address exclusiveRelayer, uint32 quoteTimestamp, uint32 fillDeadline, uint32 exclusivityDeadline, bytes message)` [payable] - Current recommended deposit method. Supports cross-chain swaps (inputToken != outputToken), exclusive relayer, and arbitrary message passing
-- `deposit(address recipient, address originToken, uint256 amount, uint256 destinationChainId, int64 relayerFeePct, uint32 quoteTimestamp, bytes message, uint256 maxCount)` [payable] - Legacy deposit method (deprecated, use depositV3)
+- `depositV3(address depositor, address recipient, address inputToken, address outputToken, uint256 inputAmount, uint256 outputAmount, uint256 destinationChainId, address exclusiveRelayer, uint32 quoteTimestamp, uint32 fillDeadline, uint32 exclusivityParameter, bytes message)` [payable] - EVM-address deposit. Supports cross-chain swaps (inputToken != outputToken), exclusive relayer, and arbitrary message passing
+- `deposit(bytes32 depositor, bytes32 recipient, bytes32 inputToken, bytes32 outputToken, uint256 inputAmount, uint256 outputAmount, uint256 destinationChainId, bytes32 exclusiveRelayer, uint32 quoteTimestamp, uint32 fillDeadline, uint32 exclusivityParameter, bytes message)` [payable] - The same deposit with every address as `bytes32`, so it can name non-EVM recipients and tokens. The legacy address-typed `deposit` no longer exists on the deployed SpokePools
 
 ### AcrossHubPoolABI
 
-- `liquidityUtilizationCurrent(address l1Token) returns (uint256)` - Get current utilization rate (view)
+- `liquidityUtilizationCurrent(address l1Token) returns (uint256)` - Get current utilization rate. Not a view: it syncs pool balances first
 - `pooledTokens(address l1Token) returns (address lpToken, bool isEnabled, uint32 lastLpFeeUpdate, int256 utilizedReserves, uint256 liquidReserves, uint256 undistributedLpFees)` - Get pool token info (view)
 
 ## Notes
 
 - Fast fills: relayers fill deposits on destination within minutes, then claim reimbursement via optimistic oracle
 - Finality: deposit confirmation on source chain, fill within 1-10 minutes typically
-- `depositV3` is recommended over legacy `deposit` -- supports output token specification and exclusive relayers
 - Requires ERC-20 approval to the SpokePool address on source chain
 - HubPool on Ethereum only -- SpokePools on all supported L2s
 - TVL: $500M+. Audited
+- On Arc (5042) the SpokePool's `wrappedNativeToken()` is the zero address, so deposit ERC-20s (USDC is `0x3600000000000000000000000000000000000000`), not native value

package/sdk/src/skills/aerodrome-slipstream.md

@@ -0,0 +1,57 @@
+# Aerodrome Slipstream
+
+Aerodrome's concentrated-liquidity pools (Uniswap V3-style, keyed by tick spacing rather than fee), on Base and, as Aero Lite, on Arc.
+
+## Category
+
+dex | Chains: Base (8453), Arc (5042)
+
+## SauceScript Functions
+
+### getPool
+
+```typescript
+import { SlipstreamCLFactoryABI as ICLFactory } from "./abis";
+
+function main(
+  factoryAddress: Address,
+  tokenA: Address,
+  tokenB: Address,
+  tickSpacing: Uint256,
+): Address {
+  const factory = ICLFactory.at(factoryAddress);
+  return factory.getPool(tokenA, tokenB, tickSpacing);
+}
+```
+
+- Pools are keyed by `(tokenA, tokenB, tickSpacing)`. `tickSpacingToFee(tickSpacing)` gives a spacing's default fee
+- On Base, ask the factory of the generation the pool was created in: a pool exists under one CLFactory only (the WETH/USDC tick-spacing-100 pool is under the initial one)
+
+## Deployed Addresses
+
+| Chain | Contract                                | Address                                      |
+| ----- | --------------------------------------- | -------------------------------------------- |
+| Base  | CLFactory (initial)                     | `0x5e7BB104d84c7CB9B682AaC2F3d509f5F406809A` |
+| Base  | NonfungiblePositionManager (initial)    | `0x827922686190790b37229fd06084350E74485b72` |
+| Base  | CLFactory (Gauge Caps)                  | `0xaDe65c38CD4849aDBA595a4323a8C7DdfE89716a` |
+| Base  | NonfungiblePositionManager (Gauge Caps) | `0xa990C6a764b73BF43cee5Bb40339c3322FB9D55F` |
+| Base  | CLFactory (Gauges V3)                   | `0xf8f2eB4940CFE7d13603DDDD87f123820Fc061Ef` |
+| Base  | NonfungiblePositionManager (Gauges V3)  | `0xe1f8cd9AC4e4A65F54f38a5CdAfCA44f6dD68b53` |
+| Arc   | CLFactory                               | `0xb89Df768aF2CFE637ceB352c587Fe8edAf491d03` |
+| Arc   | NonfungiblePositionManager              | `0xc84bB45D43CD25D02b83B4C085eaA4e08da8f473` |
+| Arc   | Metarouter                              | `0x7275FA44c67BbA8d921422e600B4ed396209c886` |
+
+The Base roles are `clFactory`/`nonfungiblePositionManager` (initial), `clFactoryGaugeCaps`/`nonfungiblePositionManagerGaugeCaps` and `clFactoryGaugesV3`/`nonfungiblePositionManagerGaugesV3`.
+
+## ABI Reference
+
+- `SlipstreamCLFactoryABI`: `getPool(address,address,int24) returns (address)`, `allPoolsLength() returns (uint256)`, `tickSpacingToFee(int24) returns (uint24)`
+- `SlipstreamPositionManagerABI`: `factory() returns (address)`, `positions(uint256)`
+- `AeroMetarouterABI`: `execute(bytes commands, bytes[] inputs, uint256 deadline)` - Aero's command-encoded router
+
+## Notes
+
+- Base's addresses are from the aerodrome-finance/slipstream README. Three generations are live there, and new gauges deploy from Gauges V3. Base has no Metarouter
+- The `aerodrome` module carries Aerodrome's basic (stable/volatile) pools on Base; this one carries only Slipstream. Velodrome's Slipstream on Optimism and the Superchain is not in either
+- Aero publishes no address table for Arc. Each address here is Sourcify-verified from the dromos-labs/metadex-public codebase, and the position manager reports `factory() == CLFactory`
+- No voter or gauges are deployed on Arc yet, so pools there earn swap fees only

package/sdk/src/skills/aerodrome.md

@@ -149,3 +149,4 @@ function main(
 - The dominant DEX on Base by TVL and volume; preferred for most Base swaps
 - LP tokens can be staked in gauges for AERO emissions
 - Routes include both `stable` flag and `factory` address per hop
+- This module is the basic (stable/volatile) pools only. Aerodrome's concentrated-liquidity Slipstream pools are the `aerodrome-slipstream` module

package/sdk/src/skills/aevo.md

@@ -21,9 +21,15 @@ import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/pro
 ```typescript
 // Deposit ERC-20 into Aevo
 import { DepositContractABI as IDeposit } from "./abis";
-function main(depositAddress: Address, token: Address, amount: Uint256): Uint256 {
+function main(
+  depositAddress: Address,
+  token: Address,
+  l2Token: Address,
+  amount: Uint256,
+  minGasLimit: Uint256,
+): Uint256 {
   const deposit = IDeposit.at(depositAddress);
-  deposit.depositERC20(token, amount);
+  deposit.depositERC20(token, l2Token, amount, minGasLimit, "");
   return 1;
 }
 ```
@@ -38,8 +44,10 @@ function main(depositAddress: Address, token: Address, amount: Uint256): Uint256
 
 ### DepositContractABI
 
-- `depositERC20(address,uint256)` - Deposit ERC-20 tokens to Aevo L2. Params: token (ERC-20 address), amount (deposit amount). Approve token to depositContract first
-- `depositETH()` - Deposit ETH to Aevo L2. Payable (send ETH as msg.value)
+The deposit contract is Aevo's OP Stack `L1StandardBridge`, so these are the standard bridge entry points.
+
+- `depositERC20(address l1Token, address l2Token, uint256 amount, uint32 minGasLimit, bytes extraData)` - Deposit ERC-20 tokens to Aevo L2. `l2Token` is the token's Aevo L2 counterpart; `minGasLimit` is the L2 execution gas. Approve token to depositContract first
+- `depositETH(uint32 minGasLimit, bytes extraData)` - Deposit ETH to Aevo L2. Payable (send ETH as msg.value)
 
 ## Notes
 

package/sdk/src/skills/ambient.md

@@ -38,7 +38,7 @@ function main(
 }
 ```
 
-- `dexAddress`: CrocSwapDex contract address (same on both chains: `0xAaAaAAAaA24eEeb8d57D431224f73832bC34f688`)
+- `dexAddress`: CrocSwapDex contract address (`0xAaAaAAAaA24eEeb8d57D431224f73832bC34f688` on Ethereum, `0xaaaaAAAACB71BF2C8CaE522EA5fa455571A74106` on Scroll)
 - `base`: Base token address (lower address of the pair by convention)
 - `quote`: Quote token address (higher address of the pair)
 - `poolIdx`: Pool index identifying the pool type (e.g., `420` for standard pools on Ethereum)
@@ -53,7 +53,7 @@ function main(
 | Chain    | Contract    | Address                                      |
 | -------- | ----------- | -------------------------------------------- |
 | Ethereum | CrocSwapDex | `0xAaAaAAAaA24eEeb8d57D431224f73832bC34f688` |
-| Scroll   | CrocSwapDex | `0xAaAaAAAaA24eEeb8d57D431224f73832bC34f688` |
+| Scroll   | CrocSwapDex | `0xaaaaAAAACB71BF2C8CaE522EA5fa455571A74106` |
 
 ## ABI Methods
 

package/sdk/src/skills/arrakis.md

@@ -45,14 +45,13 @@ function main(
 
 ### ArrakisRouterABI
 
-- `addLiquidity(tuple)` - Add liquidity. Tuple: (amount0Max, amount1Max, amount0Min, amount1Min, amountSharesMin, vault, receiver, gauge). Returns (amount0, amount1, sharesReceived)
-- `removeLiquidity(tuple)` - Remove liquidity. Tuple: (burnAmount, amount0Min, amount1Min, vault, receiver, gauge). Returns (amount0, amount1)
+- `addLiquidity(tuple)` [payable] - Add liquidity. Tuple: (amount0Max, amount1Max, amount0Min, amount1Min, amountSharesMin, vault, receiver, gauge). Returns (amount0, amount1, sharesReceived)
+- `removeLiquidity(tuple)` - Remove liquidity. Tuple: (burnAmount, amount0Min, amount1Min, vault, receiver, gauge, receiveETH). Returns (amount0, amount1)
 
 ### ArrakisVaultABI
 
 - `totalSupply()` - Total vault shares outstanding
 - `balanceOf(address)` - Query vault share balance
-- `totalUnderlying()` - Total (amount0, amount1) managed by vault
 - `token0()` - First token address
 - `token1()` - Second token address
 
@@ -63,3 +62,4 @@ function main(
 - Approve both token0 and token1 to the router before adding liquidity
 - Vault shares represent proportional ownership of the managed position
 - gauge param can be zero address if not staking in a gauge
+- The vault itself does not report its underlying amounts; ArrakisV2Helper's `totalUnderlying(vault)` does

package/sdk/src/skills/cbeth.md

@@ -48,8 +48,8 @@ function main(cbethAddress: Address, spender: Address, amount: Uint256): Uint256
 
 ### CbETHABI
 
-- `mint(uint256)` - Mint cbETH (restricted to Coinbase)
-- `exchangeRate()` - Current cbETH/ETH exchange rate
+- `mint(address to, uint256 amount) returns (bool)` - Mint cbETH (restricted to Coinbase's minters)
+- `exchangeRate()` - Current cbETH/ETH exchange rate (Ethereum only; Base cbETH is a bridged token without it)
 - `balanceOf(address)` - Query cbETH balance
 - `approve(address,uint256)` - Approve spender
 - `transfer(address,uint256)` - Transfer cbETH

package/sdk/src/skills/chainlink-ccip.md

@@ -4,7 +4,7 @@ Cross-Chain Interoperability Protocol by Chainlink. Enterprise-grade cross-chain
 
 ## Category
 
-cross-chain messaging + token transfer | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137)
+cross-chain messaging + token transfer | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), Arc (5042)
 
 ## SauceScript Functions
 
@@ -55,7 +55,7 @@ function main(
 
 ### CCIPRouterABI
 
-- `ccipSend(uint64 destinationChainSelector, EVM2AnyMessage message) returns (uint256 messageId)` [payable] - Send cross-chain message and/or tokens. Returns message ID for tracking
+- `ccipSend(uint64 destinationChainSelector, EVM2AnyMessage message) returns (bytes32 messageId)` [payable] - Send cross-chain message and/or tokens. Returns message ID for tracking
 - `getFee(uint64 destinationChainSelector, EVM2AnyMessage message) returns (uint256 fee)` - Estimate fee for a CCIP message before sending (view)
 - `isChainSupported(uint64 chainSelector) returns (bool)` - Check if a destination chain selector is supported (view)
 
@@ -72,3 +72,4 @@ EVMTokenAmount tuple: `(address token, uint256 amount)`
 - Finality: typically 5-20 minutes depending on source chain finality
 - Rate limits apply per lane (source-destination pair)
 - TVL: $1B+. Audited
+- On Arc (5042) a native-paid fee is USDC at 18 decimals, from the same balance as the USDC ERC-20 `0x3600…0000`. The router's `getWrappedNative()` is `0x8DFa585699CB46ca2a5fA649700f09839B4b8743` (`CCIP_USDC`, a WETH9-style wrapper over native USDC), CCIP's own fee token rather than a canonical wrapped native

package/sdk/src/skills/chainlink.md

@@ -4,7 +4,7 @@ Industry-standard decentralized oracle network providing price feeds, VRF random
 
 ## Category
 
-oracle | Chains: Ethereum
+oracle | Chains: Ethereum, Arc
 
 ## Key Operations
 

package/sdk/src/skills/circle-gateway.md

@@ -0,0 +1,98 @@
+# Circle Gateway
+
+Circle's chain-abstracted USDC balance. Deposit USDC into the GatewayWallet on one chain, then mint it on another chain through the GatewayMinter with a Circle-signed attestation.
+
+## Category
+
+cross-chain | Chains: Ethereum (1), Optimism (10), Polygon (137), Unichain (130), Sonic (146), Sei (1329), Base (8453), Arbitrum (42161), Avalanche (43114), Arc (5042)
+
+## SauceScript Functions
+
+### deposit
+
+Deposit a supported token (USDC) into the caller's Gateway balance.
+
+```typescript
+import { GatewayWalletABI as IGatewayWallet } from "./abis";
+
+function main(walletAddress: Address, token: Address, amount: Uint256): Uint256 {
+  const wallet = IGatewayWallet.at(walletAddress);
+  wallet.deposit(token, amount);
+  return 1;
+}
+```
+
+- `token`: must satisfy `isTokenSupported(token)`: the chain's native (Circle-issued) USDC, which on Arc is USDC's ERC-20 interface `0x3600000000000000000000000000000000000000`
+- `amount`: token units (6 decimals for USDC), never Arc's 18-decimal native units
+- The depositor must first `approve` the GatewayWallet for `amount`
+
+### availableBalance
+
+Read the balance a depositor can spend through Gateway.
+
+```typescript
+import { GatewayWalletABI as IGatewayWallet } from "./abis";
+
+function main(walletAddress: Address, token: Address, depositor: Address): Uint256 {
+  const wallet = IGatewayWallet.at(walletAddress);
+  return wallet.availableBalance(token, depositor);
+}
+```
+
+### gatewayMint
+
+Mint on the destination chain from an attestation Circle's Gateway API returned.
+
+```typescript
+import { GatewayMinterABI as IGatewayMinter } from "./abis";
+
+function main(minterAddress: Address, attestationPayload: bytes, signature: bytes): Uint256 {
+  const minter = IGatewayMinter.at(minterAddress);
+  minter.gatewayMint(attestationPayload, signature);
+  return 1;
+}
+```
+
+## Deployed Addresses
+
+| Chain             | Contract      | Address                                      |
+| ----------------- | ------------- | -------------------------------------------- |
+| Every chain above | GatewayWallet | `0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE` |
+| Every chain above | GatewayMinter | `0x2222222d7164433c4C09B0b0D809a9b52C04C205` |
+
+| Chain     | Circle domain |
+| --------- | ------------- |
+| Ethereum  | 0             |
+| Avalanche | 1             |
+| Optimism  | 2             |
+| Arbitrum  | 3             |
+| Base      | 6             |
+| Polygon   | 7             |
+| Unichain  | 10            |
+| Sonic     | 13            |
+| Sei       | 16            |
+| Arc       | 26            |
+
+## ABI Reference
+
+### GatewayWalletABI
+
+- `deposit(address token, uint256 value)` - Deposit into the caller's own Gateway balance
+- `depositFor(address token, address depositor, uint256 value)` - Deposit into another depositor's balance
+- `totalBalance(address token, address depositor) returns (uint256)` - Available plus withdrawing (view)
+- `availableBalance(address token, address depositor) returns (uint256)` - Spendable balance (view)
+- `isTokenSupported(address token) returns (bool)` (view)
+- `domain() returns (uint32)` - This chain's Circle domain, as in the table above (view)
+
+### GatewayMinterABI
+
+- `gatewayMint(bytes attestationPayload, bytes signature)` - Mint from a Circle-signed attestation
+- `isTokenSupported(address token) returns (bool)` (view)
+- `domain() returns (uint32)` (view)
+
+## Notes
+
+- Gateway uses Circle domain ids, the same ids as CCTP (Arc is 26), not EVM chain ids
+- Spending a Gateway balance on another chain is off-chain first: sign a burn intent, submit it to Circle's Gateway API, then call `gatewayMint` with the returned attestation
+- Both contracts are upgradeable (EIP-1967) proxies. Arc's Minter runs a different, smaller implementation from the other chains' that dispatches the same functions
+- Circle also runs Gateway on HyperEVM (domain 19) and World Chain (14), which are not SDK chains. It has no Solana mainnet deployment

package/sdk/src/skills/compound-v2.md

@@ -91,8 +91,8 @@ function main(cTokenAddress: Address, amount: Uint256): Uint256 {
 - `redeemUnderlying(uint256 redeemAmount) returns (uint256)` - Redeem for exact underlying amount
 - `borrow(uint256 borrowAmount) returns (uint256)` - Borrow underlying tokens
 - `repayBorrow(uint256 repayAmount) returns (uint256)` - Repay borrow debt
-- `balanceOfUnderlying(address owner) returns (uint256)` - Get underlying balance including accrued interest (view)
-- `borrowBalanceCurrent(address account) returns (uint256)` - Get current borrow balance with interest (view)
+- `balanceOfUnderlying(address owner) returns (uint256)` - Get underlying balance including accrued interest. Not a view: it accrues interest first, so it cannot be STATICCALLed
+- `borrowBalanceCurrent(address account) returns (uint256)` - Get current borrow balance with interest. Not a view: it accrues interest first
 
 ### ComptrollerABI
 

package/sdk/src/skills/connext.md

@@ -4,7 +4,7 @@ Cross-chain liquidity protocol rebranded as Everclear. Uses intents and a cleari
 
 ## Category
 
-bridge | Direction: any-to-any (L2-to-L2, L1-to-L2, L2-to-L1) | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137)
+bridge | Direction: any-to-any (L2-to-L2, L1-to-L2, L2-to-L1) | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453)
 
 ## SauceScript Functions
 
@@ -22,18 +22,20 @@ function main(
   inputAsset: Address,
   outputAsset: Address,
   amount: Uint256,
+  amountOutMin: Uint256,
 ): Uint256 {
   const spoke = IEverclearSpoke.at(spokeAddress);
-  return spoke.newIntent(
+  const created = spoke.newIntent(
     destinations,
     recipient,
     inputAsset,
     outputAsset,
     amount,
-    300,
+    amountOutMin,
     86400,
-    0x00,
+    "",
   );
+  return created.intentId;
 }
 ```
 
@@ -41,7 +43,7 @@ function main(
 - `recipient`: Address to receive tokens on destination
 - `inputAsset`: Token to send on source chain
 - `outputAsset`: Token to receive on destination chain (can differ from input for cross-chain swaps)
-- `maxFee`: Maximum fee in basis points (300 = 3%)
+- `amountOutMin`: Minimum amount the recipient must receive
 - `ttl`: Time-to-live in seconds (86400 = 24 hours). Intent expires if unfilled
 - Requires ERC-20 approval to the EverclearSpoke
 
@@ -53,13 +55,12 @@ function main(
 | Arbitrum | everclearSpoke | `0xa05A3380889115bf313f1Db9d5f335157Be4D816` |
 | Optimism | everclearSpoke | `0xa05A3380889115bf313f1Db9d5f335157Be4D816` |
 | Base     | everclearSpoke | `0xa05A3380889115bf313f1Db9d5f335157Be4D816` |
-| Polygon  | everclearSpoke | `0xa05A3380889115bf313f1Db9d5f335157Be4D816` |
 
 ## ABI Reference
 
 ### EverclearSpokeABI
 
-- `newIntent(uint32[] destinations, address to, address inputAsset, address outputAsset, uint256 amount, uint24 maxFee, uint48 ttl, bytes data) returns (uint256 intentId)` [payable] - Create a cross-chain transfer intent. Solvers compete to fill the intent on the destination chain
+- `newIntent(uint32[] destinations, address receiver, address inputAsset, address outputAsset, uint256 amount, uint256 amountOutMin, uint48 ttl, bytes data) returns (bytes32 intentId, Intent intent)` - Create a cross-chain transfer intent. Solvers compete to fill the intent on the destination chain. A `bytes32`-typed overload takes non-EVM receivers and assets
 
 ## Notes
 

package/sdk/src/skills/curve.md

@@ -42,7 +42,8 @@ function main(
 - `j`: Index of the output token within the pool (0-based)
 - `amountIn`: Exact amount of input token (in wei)
 - `minAmountOut`: Minimum output for slippage protection
-- Token indices vary per pool (e.g., 3pool: 0=DAI, 1=USDC, 2=USDT)
+- Token indices vary per pool
+- For StableSwap-NG pools. 3pool's `exchange` returns nothing, so reading back a `uint256` reverts there: use `CurveThreePoolABI` for 3pool
 
 ### addLiquidity
 
@@ -94,17 +95,31 @@ function main(poolAddress: Address, amount: Uint256, minAmounts: Uint256[]): Uin
 
 ### CurveStableSwapABI
 
+The StableSwap-NG pool interface (plain and meta pools). Classic pools such as 3pool have their own shape: see `CurveThreePoolABI` below.
+
 - `exchange(int128 i, int128 j, uint256 dx, uint256 min_dy) -> uint256` - Swap between two tokens in the pool by index
-- `exchange_underlying(int128 i, int128 j, uint256 dx, uint256 min_dy) -> uint256` - Swap between underlying tokens (for metapools/lending pools)
+- `exchange_underlying(int128 i, int128 j, uint256 dx, uint256 min_dy) -> uint256` - Swap between underlying tokens (metapools only)
 - `add_liquidity(uint256[] amounts, uint256 min_mint_amount) -> uint256` - Deposit tokens and receive LP tokens (can be imbalanced)
 - `remove_liquidity(uint256 _amount, uint256[] min_amounts) -> uint256[]` - Burn LP tokens and withdraw all tokens proportionally
 - `remove_liquidity_one_coin(uint256 _token_amount, int128 i, uint256 min_amount) -> uint256` - Burn LP tokens and withdraw as a single token
 - `get_dy(int128 i, int128 j, uint256 dx) -> uint256` - Quote: estimate output for a given input (view)
 - `get_virtual_price() -> uint256` - Get the virtual price of the LP token (view, useful for pricing)
 
+### CurveThreePoolABI
+
+3pool (`threePool` in the addresses), a classic StableSwap pool. Its liquidity arrays are fixed-size, and its state-changing functions return nothing: read amounts as balance changes.
+
+- `exchange(int128 i, int128 j, uint256 dx, uint256 min_dy)` - Swap between two of DAI(0), USDC(1), USDT(2)
+- `add_liquidity(uint256[3] amounts, uint256 min_mint_amount)` - Deposit tokens and receive 3CRV
+- `remove_liquidity(uint256 _amount, uint256[3] min_amounts)` - Burn 3CRV and withdraw all three tokens proportionally
+- `remove_liquidity_one_coin(uint256 _token_amount, int128 i, uint256 min_amount)` - Burn 3CRV and withdraw one token
+- `get_dy(int128 i, int128 j, uint256 dx) -> uint256` - Quote (view)
+- `get_virtual_price() -> uint256` - Virtual price of 3CRV (view)
+
 ### CurveRouterNGABI
 
 - `exchange(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, uint256 _expected, address[5] _pools) -> uint256` - Multi-pool routed swap for optimal execution
+- `exchange(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, uint256 _min_dy, address[5] _pools, address _receiver) -> uint256` - The same routed swap, paying `_receiver` instead of the caller
 - `get_dy(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, address[5] _pools) -> uint256` - Quote routed swap output (view)
 
 ### CurveAddressProviderABI