@eco-incorp/sauce 0.99.4 → 0.99.6

package/sdk/src/skills/index.md

@@ -27,46 +27,50 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 
 ## Protocol Registry
 
-### DEX (26 protocols)
-
-| Slug             | Name           | Chains                                      | Key Operations                                                   |
-| ---------------- | -------------- | ------------------------------------------- | ---------------------------------------------------------------- |
-| `uniswap-v2`     | Uniswap V2     | ETH, ARB, OP, BASE, BSC, AVAX, POLY, BLAST  | swap, addLiquidity, removeLiquidity                              |
-| `uniswap-v3`     | Uniswap V3     | ETH, ARB, OP, BASE, BSC, AVAX, POLY, CELO   | swap (exactInputSingle), addLiquidity (mint), removeLiquidity    |
-| `uniswap-v4`     | Uniswap V4     | ETH, ARB, OP, BASE, BSC, AVAX, POLY, BLAST  | swap (UniversalRouter), modifyLiquidities                        |
-| `sushiswap-v2`   | SushiSwap V2   | ETH, ARB, POLY, BSC, AVAX, FTM, OP          | swap, addLiquidity, removeLiquidity                              |
-| `curve`          | Curve Finance  | ETH, ARB, OP, BASE, POLY, AVAX, FTM, GNOSIS | exchange (by index), add_liquidity, remove_liquidity             |
-| `balancer-v2`    | Balancer V2    | ETH, POLY, ARB, OP, GNOSIS, AVAX, BASE, BSC | swap (Vault), joinPool, exitPool, flashLoan                      |
-| `pancakeswap-v2` | PancakeSwap V2 | BSC, ETH, ARB, BASE, LINEA, opBNB           | swap, addLiquidity, removeLiquidity                              |
-| `pancakeswap-v3` | PancakeSwap V3 | BSC, ETH, ARB, BASE, LINEA                  | swap (exactInputSingle)                                          |
-| `velodrome`      | Velodrome      | OP                                          | swap (stable/volatile routes), addLiquidity, removeLiquidity     |
-| `aerodrome`      | Aerodrome      | BASE                                        | swap (stable/volatile routes), addLiquidity, removeLiquidity     |
-| `camelot`        | Camelot        | ARB                                         | swapV2, swapV3 (exactInputSingle), addLiquidity, removeLiquidity |
-| `trader-joe`     | Trader Joe     | AVAX, ARB, BSC                              | swap (Liquidity Book path)                                       |
-| `kyberswap`      | KyberSwap      | ETH, ARB, OP, POLY, BSC, AVAX, BASE         | swap (Elastic + Meta Aggregation)                                |
-| `quickswap`      | QuickSwap      | POLY                                        | swapV2, swapV3, addLiquidity, removeLiquidity                    |
-| `maverick`       | Maverick       | ETH, ARB, BASE                              | swap (exactInputSingle with pool+tokenAIn)                       |
-| `ambient`        | Ambient        | ETH, SCROLL                                 | swap (CrocSwapDex)                                               |
-| `dodo`           | DODO           | ETH, BSC                                    | swap (dodoSwapV2TokenToToken)                                    |
-| `syncswap`       | SyncSwap       | zkSync                                      | swap (path-based with encoded data)                              |
-| `baseswap`       | BaseSwap       | BASE                                        | swap, addLiquidity, removeLiquidity                              |
-| `thruster`       | Thruster       | BLAST                                       | swap (exactInputSingle)                                          |
-| `spookyswap`     | SpookySwap     | FTM                                         | swap, addLiquidity, removeLiquidity                              |
-| `thena`          | Thena          | BSC                                         | swap (stable/volatile routes)                                    |
-| `ramses`         | Ramses         | ARB                                         | swap (stable/volatile routes)                                    |
-| `fenix`          | Fenix          | BLAST                                       | swap (stable/volatile routes)                                    |
-| `lynex`          | Lynex          | LINEA                                       | swap (stable/volatile routes)                                    |
-| `kim`            | Kim            | MODE                                        | swap (stable/volatile routes)                                    |
-
-### Lending (16 protocols)
+### DEX (29 protocols)
+
+| Slug                   | Name                 | Chains                                          | Key Operations                                                   |
+| ---------------------- | -------------------- | ----------------------------------------------- | ---------------------------------------------------------------- |
+| `uniswap-v2`           | Uniswap V2           | ETH, ARB, OP, BASE, BSC, AVAX, POLY, BLAST, ARC | swap, addLiquidity, removeLiquidity                              |
+| `uniswap-v3`           | Uniswap V3           | ETH, ARB, OP, BASE, BSC, AVAX, POLY, CELO, ARC  | swap (exactInputSingle), addLiquidity (mint), removeLiquidity    |
+| `uniswap-v4`           | Uniswap V4           | ETH, ARB, OP, BASE, BSC, AVAX, POLY, BLAST, ARC | swap (UniversalRouter), modifyLiquidities                        |
+| `sushiswap-v2`         | SushiSwap V2         | ETH, ARB, POLY, BSC, AVAX, FTM, OP              | swap, addLiquidity, removeLiquidity                              |
+| `curve`                | Curve Finance        | ETH, ARB, OP, BASE, POLY, AVAX, FTM, GNOSIS     | exchange (by index), add_liquidity, remove_liquidity             |
+| `balancer-v2`          | Balancer V2          | ETH, POLY, ARB, OP, GNOSIS, AVAX, BASE, BSC     | swap (Vault), joinPool, exitPool, flashLoan                      |
+| `pancakeswap-v2`       | PancakeSwap V2       | BSC, ETH, ARB, BASE, LINEA, opBNB               | swap, addLiquidity, removeLiquidity                              |
+| `pancakeswap-v3`       | PancakeSwap V3       | BSC, ETH, ARB, BASE, LINEA                      | swap (exactInputSingle)                                          |
+| `velodrome`            | Velodrome            | OP                                              | swap (stable/volatile routes), addLiquidity, removeLiquidity     |
+| `aerodrome`            | Aerodrome            | BASE                                            | swap (stable/volatile routes), addLiquidity, removeLiquidity     |
+| `camelot`              | Camelot              | ARB                                             | swapV2, swapV3 (exactInputSingle), addLiquidity, removeLiquidity |
+| `trader-joe`           | Trader Joe           | AVAX, ARB, BSC                                  | swap (Liquidity Book path)                                       |
+| `kyberswap`            | KyberSwap            | ETH, ARB, OP, POLY, BSC, AVAX, BASE, ARC        | swap (Elastic + Meta Aggregation)                                |
+| `quickswap`            | QuickSwap            | POLY                                            | swapV2, swapV3, addLiquidity, removeLiquidity                    |
+| `maverick`             | Maverick             | ETH, ARB, BASE                                  | swap (exactInputSingle with pool+tokenAIn)                       |
+| `ambient`              | Ambient              | ETH, SCROLL                                     | swap (CrocSwapDex)                                               |
+| `dodo`                 | DODO                 | ETH, BSC                                        | swap (dodoSwapV2TokenToToken)                                    |
+| `syncswap`             | SyncSwap             | zkSync                                          | swap (path-based with encoded data)                              |
+| `baseswap`             | BaseSwap             | BASE                                            | swap, addLiquidity, removeLiquidity                              |
+| `thruster`             | Thruster             | BLAST                                           | swap (exactInputSingle)                                          |
+| `spookyswap`           | SpookySwap           | FTM                                             | swap, addLiquidity, removeLiquidity                              |
+| `thena`                | Thena                | BSC                                             | swap (stable/volatile routes)                                    |
+| `ramses`               | Ramses               | ARB                                             | swap (stable/volatile routes)                                    |
+| `fenix`                | Fenix                | BLAST                                           | swap (stable/volatile routes)                                    |
+| `lynex`                | Lynex                | LINEA                                           | swap (stable/volatile routes)                                    |
+| `kim`                  | Kim                  | MODE                                            | swap (token path, Camelot-style router)                          |
+| `synthra-v3`           | Synthra V3           | ARC                                             | swap (SwapRouter02 exactInputSingle)                             |
+| `unitflow-v3`          | UnitFlow V3          | ARC                                             | swap (exactInputSingle with deadline)                            |
+| `aerodrome-slipstream` | Aerodrome Slipstream | BASE, ARC                                       | getPool (tick-spacing keyed CL pools)                            |
+
+### Lending (17 protocols)
 
 | Slug          | Name        | Chains                                                          | Key Operations                                                 |
 | ------------- | ----------- | --------------------------------------------------------------- | -------------------------------------------------------------- |
 | `aave-v3`     | Aave V3     | ETH, POLY, ARB, OP, AVAX, BASE, BSC, SCROLL, FTM, GNOSIS, METIS | supply, withdraw, borrow, repay, flashLoanSimple               |
 | `aave-v2`     | Aave V2     | ETH, POLY, AVAX                                                 | deposit, withdraw, borrow, repay                               |
+| `aave-v4`     | Aave V4     | ETH, BASE, AVAX, ARC                                            | supply, withdraw, borrow, repay (Spoke, by reserve id)         |
 | `compound-v3` | Compound V3 | ETH, ARB, BASE, POLY, OP, SCROLL                                | supply, withdraw (Comet per base asset)                        |
 | `compound-v2` | Compound V2 | ETH                                                             | mint, redeemUnderlying, borrow, repayBorrow (cToken)           |
-| `morpho-blue` | Morpho Blue | ETH, BASE                                                       | supply, withdraw, borrow, repay, supplyCollateral              |
+| `morpho-blue` | Morpho Blue | ETH, BASE, ARC                                                  | supply, withdraw, borrow, repay, supplyCollateral              |
 | `spark`       | Spark       | ETH                                                             | supply, withdraw, borrow, repay (Aave V3 fork, MakerDAO)       |
 | `euler-v2`    | Euler V2    | ETH                                                             | deposit, withdraw, borrow, repay (ERC-4626 vaults + EVC)       |
 | `fluid`       | Fluid       | ETH, ARB                                                        | deposit, withdraw, borrow, repay (unified liquidity)           |
@@ -76,35 +80,36 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 | `venus`       | Venus       | BSC                                                             | mint, redeemUnderlying, borrow, repayBorrow (Compound V2 fork) |
 | `seamless`    | Seamless    | BASE                                                            | supply, withdraw, borrow, repay (Aave V3 fork + ILMs)          |
 | `silo`        | Silo        | ETH, ARB                                                        | deposit, withdraw, borrow, repay (isolated Silos)              |
-| `layerbank`   | LayerBank   | SCROLL                                                          | mint, redeemUnderlying, borrow, repayBorrow (Compound V2 fork) |
+| `layerbank`   | LayerBank   | SCROLL                                                          | supply, redeemUnderlying, borrow, repayBorrow (via Core)       |
 | `zerolend`    | ZeroLend    | zkSync                                                          | supply, withdraw, borrow, repay (Aave V3 fork)                 |
 
-### Bridges (22 protocols)
-
-| Slug              | Name                | Type                         | Key Operations                              |
-| ----------------- | ------------------- | ---------------------------- | ------------------------------------------- |
-| `stargate`        | Stargate            | Omnichain bridge (LayerZero) | swap (native asset bridging)                |
-| `across`          | Across              | Optimistic bridge (UMA)      | deposit (fast relayer fills)                |
-| `hop`             | Hop Protocol        | Rollup bridge                | sendToL2, swapAndSend                       |
-| `synapse`         | Synapse             | Multi-chain bridge + DEX     | bridge, bridgeAndSwap                       |
-| `celer`           | Celer Network       | SGN bridge                   | send (cross-chain transfer)                 |
-| `connext`         | Connext (Everclear) | Intent-based bridge          | xcall (cross-chain transfer)                |
-| `debridge`        | deBridge            | DLN bridge                   | send (cross-chain with market makers)       |
-| `lifi`            | LI.FI               | Bridge + DEX aggregator      | swapAndBridge                               |
-| `socket`          | Socket              | Bridge aggregator            | bridge (optimal route selection)            |
-| `squid`           | Squid Router        | Cross-chain router (Axelar)  | route (one-click cross-chain)               |
-| `layerzero`       | LayerZero           | Messaging protocol           | send (OFT, arbitrary messages)              |
-| `wormhole`        | Wormhole            | Messaging protocol           | transferTokens                              |
-| `axelar`          | Axelar              | Messaging protocol           | callContract, sendToken                     |
-| `chainlink-ccip`  | Chainlink CCIP      | Messaging protocol           | ccipSend                                    |
-| `hyperlane`       | Hyperlane           | Messaging protocol           | dispatch                                    |
-| `arbitrum-bridge` | Arbitrum Bridge     | Native L2 bridge             | depositETH, deposit (7-day withdrawal)      |
-| `optimism-bridge` | Optimism Bridge     | Native L2 bridge             | depositETH, depositERC20 (7-day withdrawal) |
-| `base-bridge`     | Base Bridge         | Native L2 bridge             | depositETH, depositERC20 (7-day withdrawal) |
-| `polygon-bridge`  | Polygon Bridge      | Native bridge                | depositEtherFor, depositFor                 |
-| `scroll-bridge`   | Scroll Bridge       | Native zkEVM bridge          | depositETH, depositERC20 (ZK finality)      |
-| `linea-bridge`    | Linea Bridge        | Native zkEVM bridge          | sendMessage (ZK finality)                   |
-| `zksync-bridge`   | zkSync Bridge       | Native zkEVM bridge          | requestL2Transaction (ZK finality)          |
+### Bridges (23 protocols)
+
+| Slug              | Name                | Type                          | Key Operations                              |
+| ----------------- | ------------------- | ----------------------------- | ------------------------------------------- |
+| `stargate`        | Stargate            | Omnichain bridge (LayerZero)  | swap (native asset bridging)                |
+| `across`          | Across              | Optimistic bridge (UMA)       | deposit (fast relayer fills)                |
+| `hop`             | Hop Protocol        | Rollup bridge                 | sendToL2, swapAndSend                       |
+| `synapse`         | Synapse             | Multi-chain bridge + DEX      | bridge, bridgeAndSwap                       |
+| `celer`           | Celer Network       | SGN bridge                    | send (cross-chain transfer)                 |
+| `connext`         | Connext (Everclear) | Intent-based bridge           | newIntent (cross-chain transfer)            |
+| `debridge`        | deBridge            | DLN bridge                    | send (cross-chain with market makers)       |
+| `lifi`            | LI.FI               | Bridge + DEX aggregator       | swapAndBridge                               |
+| `socket`          | Socket              | Bridge aggregator             | bridge (optimal route selection)            |
+| `squid`           | Squid Router        | Cross-chain router (Axelar)   | route (one-click cross-chain)               |
+| `layerzero`       | LayerZero           | Messaging protocol            | send (OFT, arbitrary messages)              |
+| `wormhole`        | Wormhole            | Messaging protocol            | transferTokens                              |
+| `axelar`          | Axelar              | Messaging protocol            | callContract, sendToken                     |
+| `chainlink-ccip`  | Chainlink CCIP      | Messaging protocol            | ccipSend                                    |
+| `hyperlane`       | Hyperlane           | Messaging protocol            | dispatch                                    |
+| `circle-gateway`  | Circle Gateway      | Chain-abstracted USDC balance | deposit, gatewayMint                        |
+| `arbitrum-bridge` | Arbitrum Bridge     | Native L2 bridge              | depositETH, deposit (7-day withdrawal)      |
+| `optimism-bridge` | Optimism Bridge     | Native L2 bridge              | depositETH, depositERC20 (7-day withdrawal) |
+| `base-bridge`     | Base Bridge         | Native L2 bridge              | depositETH, depositERC20 (7-day withdrawal) |
+| `polygon-bridge`  | Polygon Bridge      | Native bridge                 | depositEtherFor, depositFor                 |
+| `scroll-bridge`   | Scroll Bridge       | Native zkEVM bridge           | depositETH, depositERC20 (ZK finality)      |
+| `linea-bridge`    | Linea Bridge        | Native zkEVM bridge           | sendMessage (ZK finality)                   |
+| `zksync-bridge`   | zkSync Bridge       | Native zkEVM bridge           | requestL2Transaction (ZK finality)          |
 
 ### Liquid Staking & Restaking (12 protocols)
 
@@ -150,7 +155,7 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 | `level-finance`      | Level Finance      | perpetuals | BSC, ARB  | addLiquidity, openPosition                |
 | `perpetual-protocol` | Perpetual Protocol | perpetuals | OP        | openPosition (vAMM)                       |
 | `mux-protocol`       | MUX Protocol       | perpetuals | ARB       | openPosition (aggregated)                 |
-| `premia`             | Premia             | options    | ARB, ETH  | purchase (options AMM)                    |
+| `premia`             | Premia             | options    | ARB       | exercise, settle (v3 option pools)        |
 | `hegic`              | Hegic              | options    | ARB       | createHedge (ETH/BTC options)             |
 | `opyn`               | Opyn               | options    | ETH       | openVault (Squeeth power perps)           |
 | `thales`             | Thales             | options    | OP        | buyFromAMM (positional markets)           |
@@ -228,7 +233,7 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 
 ### "I need to lend/borrow"
 
-1. **Multi-chain**: `aave-v3` (most chains), `compound-v3` (major chains)
+1. **Multi-chain**: `aave-v3` (most chains), `compound-v3` (major chains), `aave-v4` (hub-and-spoke: ETH, BASE, AVAX, ARC)
 2. **Ethereum-only**: `morpho-blue` (gas-efficient), `spark` (best DAI rates), `euler-v2` (modular)
 3. **Chain-specific**: `moonwell` (Base), `benqi` (Avalanche), `venus` (BSC), `zerolend` (zkSync)
 4. **Isolated risk**: `silo` (pair-based isolation), `morpho-blue` (market-level isolation)
@@ -239,6 +244,7 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 2. **Cheapest**: Native bridges (`arbitrum-bridge`, `optimism-bridge`, `base-bridge`) but 7-day withdrawals
 3. **Best route**: `lifi`, `socket`, or `squid` (bridge aggregators)
 4. **Arbitrary messages**: `layerzero`, `wormhole`, `axelar`, `chainlink-ccip`, `hyperlane`
+5. **USDC across chains**: `circle-gateway` (one USDC balance, minted on the destination by Circle attestation)
 
 ### "I need to stake ETH"
 
@@ -266,21 +272,22 @@ Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceSc
 
 ## Chain Coverage
 
-| Chain     | Chain ID | Top Protocols                                                     |
-| --------- | -------- | ----------------------------------------------------------------- |
-| Ethereum  | 1        | uniswap-v3, aave-v3, curve, balancer-v2, lido, maker, morpho-blue |
-| Arbitrum  | 42161    | uniswap-v3, aave-v3, gmx-v2, camelot, radiant, silo               |
-| Base      | 8453     | aerodrome, uniswap-v3, aave-v3, compound-v3, moonwell, seamless   |
-| Optimism  | 10       | velodrome, uniswap-v3, aave-v3, synthetix-v3, thales              |
-| Polygon   | 137      | quickswap, aave-v3, uniswap-v3, compound-v3, balancer-v2          |
-| BSC       | 56       | pancakeswap-v2, venus, thena, pancakeswap-v3, dodo                |
-| Avalanche | 43114    | trader-joe, aave-v3, benqi, curve, sushiswap-v2                   |
-| Blast     | 81457    | thruster, fenix, uniswap-v4                                       |
-| zkSync    | 324      | syncswap, zerolend                                                |
-| Scroll    | 534352   | ambient, layerbank, aave-v3                                       |
-| Fantom    | 250      | spookyswap, sushiswap-v2, aave-v3                                 |
-| Linea     | 59144    | lynex, pancakeswap-v3                                             |
-| Mode      | 34443    | kim                                                               |
+| Chain     | Chain ID | Top Protocols                                                                         |
+| --------- | -------- | ------------------------------------------------------------------------------------- |
+| Ethereum  | 1        | uniswap-v3, aave-v3, curve, balancer-v2, lido, maker, morpho-blue                     |
+| Arbitrum  | 42161    | uniswap-v3, aave-v3, gmx-v2, camelot, radiant, silo                                   |
+| Base      | 8453     | aerodrome, uniswap-v3, aave-v3, compound-v3, moonwell, seamless                       |
+| Optimism  | 10       | velodrome, uniswap-v3, aave-v3, synthetix-v3, thales                                  |
+| Polygon   | 137      | quickswap, aave-v3, uniswap-v3, compound-v3, balancer-v2                              |
+| BSC       | 56       | pancakeswap-v2, venus, thena, pancakeswap-v3, dodo                                    |
+| Avalanche | 43114    | trader-joe, aave-v3, benqi, curve, sushiswap-v2                                       |
+| Blast     | 81457    | thruster, fenix, uniswap-v4                                                           |
+| zkSync    | 324      | syncswap, zerolend                                                                    |
+| Scroll    | 534352   | ambient, layerbank, aave-v3                                                           |
+| Fantom    | 250      | spookyswap, sushiswap-v2, aave-v3                                                     |
+| Linea     | 59144    | lynex, pancakeswap-v3                                                                 |
+| Mode      | 34443    | kim                                                                                   |
+| Arc       | 5042     | uniswap-v3, uniswap-v4, aave-v4, morpho-blue, circle-gateway, synthra-v3, unitflow-v3 |
 
 ---
 

package/sdk/src/skills/kim.md

@@ -1,6 +1,6 @@
 # Kim
 
-Mode-native DEX with Solidly-style routing supporting both stable and volatile pool types. The primary trading venue on Mode Network with farming incentives.
+Mode-native DEX. Its V2 router is a Camelot fork: swaps take a plain token path and a referrer, and support fee-on-transfer tokens. The primary trading venue on Mode Network with farming incentives.
 
 ## Category
 
@@ -8,7 +8,7 @@ dex | Chains: Mode
 
 ## Key Operations
 
-- **swap**: Swap tokens with route-based routing specifying stable or volatile pool type
+- **swap**: Swap tokens along a token path
 
 ## SDK Usage
 
@@ -27,30 +27,29 @@ function main(
   routerAddress: Address,
   tokenIn: Address,
   tokenOut: Address,
-  stable: bool,
   amountIn: Uint256,
   amountOutMin: Uint256,
   recipient: Address,
-): Uint256[] {
+): Uint256 {
   const router = IRouter.at(routerAddress);
-  return router.swapExactTokensForTokens(
+  router.swapExactTokensForTokensSupportingFeeOnTransferTokens(
     amountIn,
     amountOutMin,
-    [{ from: tokenIn, to: tokenOut, stable: stable }],
+    [tokenIn, tokenOut],
     recipient,
+    0x0000000000000000000000000000000000000000,
     99999999999,
   );
+  return 1;
 }
 ```
 
 - `routerAddress`: Kim Router on Mode (`0x5D61c537393cf21893BE619E36fC94cd73C77DD3`)
-- `tokenIn` / `tokenOut`: Input and output token addresses
-- `stable`: `true` for stable pools (pegged assets), `false` for volatile pools (uncorrelated)
+- `tokenIn` / `tokenOut`: Input and output token addresses; a longer path swaps through intermediate tokens
 - `amountIn`: Exact input amount (in wei)
 - `amountOutMin`: Minimum output for slippage protection
 - `recipient`: Address to receive output tokens
-- Routes support multi-hop: `[{from: A, to: B, stable: false}, {from: B, to: C, stable: true}]`
-- Note: Kim routes do NOT include a `factory` field (unlike Velodrome/Aerodrome)
+- The swap returns nothing: measure the output as the recipient's balance change
 
 ## Key Addresses
 
@@ -62,13 +61,11 @@ function main(
 
 ### KimRouterABI
 
-- `swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, tuple[](address from, address to, bool stable) routes, address to, uint256 deadline) -> uint256[] amounts` - Swap with route tuples specifying pool type per hop
-- `addLiquidity(address tokenA, address tokenB, bool stable, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) -> (uint256 amountA, uint256 amountB, uint256 liquidity)` - Add liquidity to a stable or volatile pool
+- `swapExactTokensForTokensSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, address referrer, uint256 deadline)` - Swap along a token path. `referrer` may be the zero address
+- `addLiquidity(address tokenA, address tokenB, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) -> (uint256 amountA, uint256 amountB, uint256 liquidity)` - Add liquidity to a pair
 
 ## Notes
 
-- Solidly-fork routes contain `{from, to, stable}` tuples (NO `factory` field)
-- Two pool types: `stable=true` for correlated assets, `stable=false` for uncorrelated
 - Mode-only deployment; the dominant DEX on Mode Network
 - Mode Network features native yield sharing via Sequencer Fee Sharing (SFS)
 - LP tokens can be staked for farming rewards

package/sdk/src/skills/kyberswap-aggregator.md

@@ -4,7 +4,7 @@ Meta aggregator that routes through multiple aggregators and DEXes for optimal s
 
 ## Category
 
-aggregator | Chains: Ethereum, Arbitrum, BSC, Polygon, Optimism, Avalanche, Base, Fantom, Linea, Scroll, zkSync
+aggregator | Chains: Ethereum, Arbitrum, BSC, Polygon, Optimism, Avalanche, Base, Fantom, Linea, Scroll, zkSync, Arc
 
 ## Key Operations
 
@@ -64,7 +64,8 @@ function main(
 
 | Chain         | Contract              | Address                                      |
 | ------------- | --------------------- | -------------------------------------------- |
-| All 11 chains | metaAggregationRouter | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
+| 11 EVM chains | metaAggregationRouter | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
+| zkSync        | metaAggregationRouter | `0x3F95eF3f2eAca871858dbE20A93c01daF6C2e923` |
 
 ## ABI Methods
 
@@ -87,7 +88,8 @@ function main(
 
 ## Notes
 
-- TVL: $500M+. Same address on all 11 chains
+- TVL: $500M+. Same address on 11 of its 12 chains; zkSync's differs
 - Meta-aggregates across 1inch, 0x, ParaSwap, and other aggregators
 - Route computation via KyberSwap API - callTarget/targetData come from API response
 - Approve srcToken to metaAggregationRouter before swapping
+- On Arc (5042) the router at this address is a smaller build than Ethereum's (13724 vs 18652 bytes, a different owner, no `swapGeneric`/whitelist functions). Its `swap` has the same selector, struct and outputs (Blockscout-verified `MetaAggregationRouterV2`), and Kyber's Arc API builds calldata that decodes under this ABI. Native input uses the `0xEeee…EEeE` sentinel with `msg.value` in Arc's 18-decimal native USDC; Kyber's own routes use the ERC-20 `0x3600…0000` with 6-decimal amounts

package/sdk/src/skills/kyberswap.md

@@ -4,7 +4,7 @@ Multi-chain DEX with concentrated liquidity protocol (KyberSwap Elastic) and a m
 
 ## Category
 
-dex | Chains: Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, Base
+dex | Chains: Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, Base, Arc
 
 ## Key Operations
 
@@ -46,7 +46,7 @@ function main(
 }
 ```
 
-- `routerAddress`: KyberSwap Elastic Router address (same on most chains: `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83`)
+- `routerAddress`: KyberSwap Elastic Router address (`0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` on every listed chain except Base, which has no Elastic deployment here)
 - `tokenIn` / `tokenOut`: Input and output token addresses
 - `fee`: Pool fee tier (similar to Uniswap V3 but with KyberSwap's own tiers)
 - `amountIn`: Exact input amount (in wei)
@@ -76,9 +76,8 @@ function main(
 | Avalanche | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
 | Avalanche | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
 | Avalanche | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Base      | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| Base      | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
 | Base      | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
+| Arc       | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
 
 ## ABI Methods
 
@@ -88,13 +87,14 @@ function main(
 
 ### KyberSwapMetaAggregationRouterABI
 
-- `swap(tuple(address callTo, address approveTarget, address tokenIn, address tokenOut, uint256 amountIn, uint256 minAmountOut, address recipient, bytes data)) -> (uint256 returnAmount, uint256 gasUsed)` - Execute a swap via the meta-aggregation router (routes across multiple DEXes for best price)
+- `swap(tuple(address callTarget, address approveTarget, bytes targetData, tuple(address srcToken, address dstToken, address[] srcReceivers, uint256[] srcAmounts, address[] feeReceivers, uint256[] feeAmounts, address dstReceiver, uint256 amount, uint256 minReturnAmount, uint256 flags, bytes permit) desc, bytes clientData)) -> (uint256 returnAmount, uint256 gasUsed)` - Execute a swap via the meta-aggregation router (routes across multiple DEXes for best price). The execution struct comes from the KyberSwap API
 
 ## Notes
 
 - Elastic Router naming differs from Uniswap V3: `minAmountOut` (not `amountOutMinimum`), `limitSqrtP` (not `sqrtPriceLimitX96`)
-- Elastic Router and Meta Agg Router addresses are consistent across all 7 chains
+- The Elastic Router address is the same on its 6 chains, and the Meta Agg Router address on all 8
 - Meta Aggregation Router routes across multiple DEXes (not just KyberSwap pools) for best execution price
 - The `data` field in the Meta Agg Router swap must be pre-encoded from KyberSwap's API
 - Input token must be ERC20-approved to the Elastic Router for direct swaps
 - For Meta Agg swaps, approve to the `approveTarget` address returned by the API
+- On Arc (5042) only the Meta Aggregation Router is deployed (no Elastic), and it is a smaller build than Ethereum's at the same address: 13724 vs 18652 bytes, a different owner, and no `swapGeneric`/whitelist functions. Its `swap` has the same selector, struct and outputs (Blockscout-verified `MetaAggregationRouterV2`), and Kyber's Arc API builds calldata that decodes under this ABI. Native input uses the `0xEeee…EEeE` sentinel with `msg.value` in Arc's 18-decimal native USDC; Kyber's own routes use the ERC-20 `0x3600…0000` with 6-decimal amounts

package/sdk/src/skills/layerbank.md

@@ -1,6 +1,6 @@
 # LayerBank
 
-Leading lending protocol on Scroll. Compound V2 fork optimized for L2 rollups with low gas costs.
+Leading lending protocol on Scroll. Compound-style markets (lTokens), but every user action goes through the Core contract, which names the market.
 
 ## Category
 
@@ -10,59 +10,61 @@ lending | Chains: Scroll (534352)
 
 ### supply
 
-Supply assets by minting lTokens. Exchange rate grows as interest accrues.
+Supply underlying to a market through Core; Core mints the lTokens to the caller.
 
 ```typescript
-import { LTokenABI as ILToken } from "./abis";
+import { LayerBankCoreABI as ICore } from "./abis";
 
-function main(lTokenAddress: Address, amount: Uint256): Uint256 {
-  const lToken = ILToken.at(lTokenAddress);
-  return lToken.mint(amount);
+function main(coreAddress: Address, lTokenAddress: Address, amount: Uint256): Uint256 {
+  const core = ICore.at(coreAddress);
+  return core.supply(lTokenAddress, amount);
 }
 ```
 
 - `lTokenAddress`: The lToken market contract (each asset has its own lToken)
-- Returns 0 on success, error code on failure
+- Returns the lTokens minted
 - Requires ERC-20 approval of underlying to the lToken
 
 ### withdraw
 
-Withdraw underlying assets by specifying the exact amount.
+Redeem an exact amount of underlying.
 
 ```typescript
-import { LTokenABI as ILToken } from "./abis";
+import { LayerBankCoreABI as ICore } from "./abis";
 
-function main(lTokenAddress: Address, amount: Uint256): Uint256 {
-  const lToken = ILToken.at(lTokenAddress);
-  return lToken.redeemUnderlying(amount);
+function main(coreAddress: Address, lTokenAddress: Address, amount: Uint256): Uint256 {
+  const core = ICore.at(coreAddress);
+  return core.redeemUnderlying(lTokenAddress, amount);
 }
 ```
 
 ### borrow
 
-Borrow assets against lToken collateral. Must call enterMarkets first.
+Borrow from a market against entered collateral.
 
 ```typescript
-import { LTokenABI as ILToken } from "./abis";
+import { LayerBankCoreABI as ICore } from "./abis";
 
-function main(lTokenAddress: Address, amount: Uint256): Uint256 {
-  const lToken = ILToken.at(lTokenAddress);
-  return lToken.borrow(amount);
+function main(coreAddress: Address, lTokenAddress: Address, amount: Uint256): Uint256 {
+  const core = ICore.at(coreAddress);
+  core.borrow(lTokenAddress, amount);
+  return 1;
 }
 ```
 
-- Must enable collateral via `LayerBankCore.enterMarkets([lTokenAddress])` first
+- Must enable collateral via `core.enterMarkets([lTokenAddress])` first
 
 ### repay
 
 Repay borrowed assets.
 
 ```typescript
-import { LTokenABI as ILToken } from "./abis";
+import { LayerBankCoreABI as ICore } from "./abis";
 
-function main(lTokenAddress: Address, amount: Uint256): Uint256 {
-  const lToken = ILToken.at(lTokenAddress);
-  return lToken.repayBorrow(amount);
+function main(coreAddress: Address, lTokenAddress: Address, amount: Uint256): Uint256 {
+  const core = ICore.at(coreAddress);
+  core.repayBorrow(lTokenAddress, amount);
+  return 1;
 }
 ```
 
@@ -72,26 +74,30 @@ function main(lTokenAddress: Address, amount: Uint256): Uint256 {
 
 | Chain  | Contract | Address                                      |
 | ------ | -------- | -------------------------------------------- |
-| Scroll | core     | `0x009a0b7C38B542208936F1179151CD08E2943833` |
+| Scroll | core     | `0xEC53c830f4444a8A56455c6836b5D2aA794289Aa` |
 
 ## ABI Reference
 
-### LTokenABI
+### LayerBankCoreABI
 
-- `mint(uint256 mintAmount) returns (uint256)` - Supply underlying, receive lTokens
-- `redeem(uint256 redeemTokens) returns (uint256)` - Redeem lTokens for underlying
-- `redeemUnderlying(uint256 redeemAmount) returns (uint256)` - Redeem exact underlying amount
-- `borrow(uint256 borrowAmount) returns (uint256)` - Borrow underlying
-- `repayBorrow(uint256 repayAmount) returns (uint256)` - Repay borrow debt
+- `enterMarkets(address[] lTokens)` - Enable lTokens as collateral
+- `exitMarket(address lToken)` - Remove lToken from collateral
+- `supply(address lToken, uint256 uAmount) returns (uint256)` [payable] - Supply underlying, receive lTokens
+- `redeemToken(address lToken, uint256 lAmount) returns (uint256)` - Redeem lTokens for underlying
+- `redeemUnderlying(address lToken, uint256 uAmount) returns (uint256)` - Redeem an exact underlying amount
+- `borrow(address lToken, uint256 amount)` - Borrow underlying
+- `repayBorrow(address lToken, uint256 amount)` [payable] - Repay borrow debt
 
-### LayerBankCoreABI
+### LTokenABI (read side)
 
-- `enterMarkets(address[] lTokens) returns (uint256[])` - Enable lTokens as collateral
-- `exitMarket(address lToken) returns (uint256)` - Remove lToken from collateral
+- `balanceOf(address account) returns (uint256)` - lToken balance
+- `underlyingBalanceOf(address account) returns (uint256)` - Underlying value of the balance
+- `borrowBalanceOf(address account) returns (uint256)` - Outstanding borrow
+- `exchangeRate() returns (uint256)` - lToken/underlying exchange rate
+- `underlying() returns (address)` - The market's underlying token
 
 ## Notes
 
-- Same interface as Compound V2 (forked codebase)
-- Must call `enterMarkets` on Core contract before borrowing against any market
-- Return values: 0 = success, non-zero = error code
+- Unlike Compound V2, the lToken's own supply/borrow/redeem functions are callable only by Core
+- Must call `enterMarkets` on Core before borrowing against any market
 - Scroll-only deployment. TVL: $200M+. Audited

package/sdk/src/skills/layerzero.md

@@ -4,7 +4,7 @@ Omnichain interoperability protocol enabling cross-chain messaging. Powers OFT t
 
 ## Category
 
-cross-chain messaging | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), BSC (56), Avalanche (43114), zkSync (324), Linea (59144), Scroll (534352)
+cross-chain messaging | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), BSC (56), Avalanche (43114), zkSync (324), Linea (59144), Scroll (534352), Arc (5042)
 
 ## SauceScript Functions
 
@@ -47,7 +47,7 @@ function main(
 | Polygon   | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` |
 | BSC       | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` |
 | Avalanche | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` |
-| zkSync    | endpointV2 | `0xd07C30aF3Ff30D96BDc9c6044958230Eb5b32e1D` |
+| zkSync    | endpointV2 | `0xd07C30aF3Ff30D96BDc9c6044958230Eb797DDBF` |
 | Linea     | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` |
 | Scroll    | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` |
 
@@ -70,3 +70,4 @@ MessagingFee tuple: `(uint256 nativeFee, uint256 lzTokenFee)`
 - Finality: depends on DVN (Decentralized Verifier Network) configuration, typically 1-5 minutes
 - Powers Stargate V2, OFT tokens, and many cross-chain dApps
 - TVL: $5B+ (across protocols built on LayerZero). Audited
+- On Arc (5042, eid 30417) the messaging fee `msg.value` is native USDC at 18 decimals, from the same balance as the USDC ERC-20 `0x3600…0000`

package/sdk/src/skills/level-finance.md

@@ -32,9 +32,10 @@ function main(
   token: Address,
   amountIn: Uint256,
   minLpAmount: Uint256,
+  to: Address,
 ): Uint256 {
   const pool = ILiquidityPool.at(poolAddress);
-  pool.addLiquidity(tranche, token, amountIn, minLpAmount);
+  pool.addLiquidity(tranche, token, amountIn, minLpAmount, to);
   return 1;
 }
 
@@ -46,9 +47,10 @@ function main(
   tokenOut: Address,
   lpAmount: Uint256,
   minOut: Uint256,
+  to: Address,
 ): Uint256 {
   const pool = ILiquidityPool.at(poolAddress);
-  pool.removeLiquidity(tranche, tokenOut, lpAmount, minOut);
+  pool.removeLiquidity(tranche, tokenOut, lpAmount, minOut, to);
   return 1;
 }
 ```
@@ -64,8 +66,8 @@ function main(
 
 ### LiquidityPoolABI
 
-- `addLiquidity(address,address,uint256,uint256)` - Add liquidity. Params: tranche address, token, amountIn, minLpAmount
-- `removeLiquidity(address,address,uint256,uint256)` - Remove liquidity. Params: tranche, tokenOut, lpAmount, minOut
+- `addLiquidity(address,address,uint256,uint256,address)` - Add liquidity. Params: tranche address, token, amountIn, minLpAmount, to (receives the LP tokens)
+- `removeLiquidity(address,address,uint256,uint256,address)` - Remove liquidity. Params: tranche, tokenOut, lpAmount, minOut, to (receives tokenOut)
 - `swap(address,address,uint256,address,bytes)` - Swap tokens. Params: tokenIn, tokenOut, minOut, to, extradata
 
 ## Notes

package/sdk/src/skills/lido.md

@@ -45,11 +45,11 @@ function main(wstethAddress: Address, amount: Uint256): Uint256 {
 
 ## Key Addresses
 
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | stETH    | `0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84` |
-| Ethereum | wstETH   | `0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0` |
-| Arbitrum | wstETH   | `0x5979D7b546E38E414F7E9822514be443A4800529` |
+| Chain    | Contract | Address                                                                                      |
+| -------- | -------- | -------------------------------------------------------------------------------------------- |
+| Ethereum | stETH    | `0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84`                                                 |
+| Ethereum | wstETH   | `0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0`                                                 |
+| Arbitrum | wstETH   | `0x5979D7b546E38E414F7E9822514be443A4800529` (bridged token: transfers only, no wrap/unwrap) |
 
 ## ABI Methods