@eco-incorp/sauce 0.99.5 → 0.99.7

package/sdk/src/skills/harvest.md

@@ -1,49 +0,0 @@
-# Harvest Finance
-
-Yield farming protocol that automatically compounds rewards across DeFi strategies via Vault+Strategy pattern.
-
-## Category
-
-yield | Chains: Ethereum
-
-## Key Operations
-
-- **deposit**: Deposit tokens into Harvest vault
-- **withdraw**: Withdraw tokens from vault
-- **getPricePerFullShare**: Query vault share price
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/harvest";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit into Harvest vault
-import { VaultABI as IVault } from "./abis";
-
-function main(vaultAddress: Address, amount: Uint256): Uint256 {
-  const vault = IVault.at(vaultAddress);
-  vault.deposit(amount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract   | Address                                      |
-| -------- | ---------- | -------------------------------------------- |
-| Ethereum | controller | `0x222412af183BCeAdEFd72e4Cb1b71f1889953b1C` |
-| Ethereum | farm       | `0xa0246c9032bC3A600820415aE600c6388619A14D` |
-
-## ABI Methods
-
-- `deposit(uint256) returns (uint256)` - Deposit tokens
-- `withdraw(uint256) returns (uint256)` - Withdraw shares
-- `getPricePerFullShare()` - Get share price
-
-## Notes
-
-- FARM token for governance. Auto-compounds strategy rewards.

package/sdk/src/skills/index.md

@@ -1,299 +0,0 @@
-# Sauce SDK Protocol Index
-
-Master reference for all protocols in the Sauce SDK. Use this to find the right protocol for any DeFi operation.
-
-## SDK Usage
-
-```typescript
-// Import specific protocol
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/{slug}";
-
-// Query the registry
-import {
-  getProtocol,
-  listProtocols,
-  getProtocolsByCategory,
-  getProtocolsByChain,
-} from "@eco-incorp/sauce/protocols";
-
-const aave = getProtocol("aave-v3"); // Single protocol by slug
-const dexes = getProtocolsByCategory("dex"); // All DEXes
-const baseProt = getProtocolsByChain(8453); // All protocols on Base
-```
-
-Each protocol module exports: `protocolInfo`, `deployments`, `abis`, and SauceScript functions.
-
----
-
-## Protocol Registry
-
-### 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, 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)           |
-| `radiant`     | Radiant     | ARB                                                             | deposit, withdraw, borrow, repay (Aave V2 fork)                |
-| `moonwell`    | Moonwell    | BASE                                                            | mint, redeemUnderlying, borrow, repayBorrow (Compound V2 fork) |
-| `benqi`       | Benqi       | AVAX                                                            | mint, redeemUnderlying, borrow, repayBorrow (Compound V2 fork) |
-| `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                                                          | supply, redeemUnderlying, borrow, repayBorrow (via Core)       |
-| `zerolend`    | ZeroLend    | zkSync                                                          | supply, withdraw, borrow, repay (Aave V3 fork)                 |
-
-### 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)
-
-| Slug          | Name           | Category       | Token        | Key Operations                        |
-| ------------- | -------------- | -------------- | ------------ | ------------------------------------- |
-| `lido`        | Lido           | liquid-staking | stETH/wstETH | submit (stake ETH), wrap/unwrap       |
-| `rocket-pool` | Rocket Pool    | liquid-staking | rETH         | deposit (stake ETH)                   |
-| `cbeth`       | Coinbase cbETH | liquid-staking | cbETH        | wrap/unwrap                           |
-| `frax-ether`  | Frax Ether     | liquid-staking | sfrxETH      | deposit, withdraw                     |
-| `swell`       | Swell          | liquid-staking | swETH/rswETH | deposit                               |
-| `stader`      | Stader         | liquid-staking | ETHx         | deposit                               |
-| `mantle-meth` | Mantle mETH    | liquid-staking | mETH         | stake                                 |
-| `eigenlayer`  | EigenLayer     | restaking      | -            | depositIntoStrategy, queueWithdrawals |
-| `etherfi`     | ether.fi       | restaking      | eETH/weETH   | deposit, wrap                         |
-| `renzo`       | Renzo          | restaking      | ezETH        | deposit                               |
-| `kelp`        | Kelp DAO       | restaking      | rsETH        | depositAsset                          |
-| `puffer`      | Puffer Finance | restaking      | pufETH       | deposit                               |
-
-### Yield & Vaults (10 protocols)
-
-| Slug        | Name             | Chains                   | Key Operations                           |
-| ----------- | ---------------- | ------------------------ | ---------------------------------------- |
-| `pendle`    | Pendle           | ETH, ARB, OP, BSC        | swapExactTokenForPt, swapExactTokenForYt |
-| `convex`    | Convex Finance   | ETH                      | deposit, withdraw (Curve LP boosting)    |
-| `yearn-v3`  | Yearn V3         | ETH, ARB, BASE, POLY     | deposit, withdraw (ERC-4626 vaults)      |
-| `beefy`     | Beefy Finance    | Multi-chain              | deposit, withdraw (auto-compounding)     |
-| `arrakis`   | Arrakis Finance  | ETH, POLY, OP, ARB, BASE | deposit, withdraw (Uni V3 LP management) |
-| `gamma`     | Gamma Strategies | Multi-chain              | deposit, withdraw (concentrated LP)      |
-| `harvest`   | Harvest Finance  | ETH                      | deposit, withdraw (auto-compounding)     |
-| `sommelier` | Sommelier        | ETH                      | deposit, withdraw (ERC-4626 Cellars)     |
-| `olympus`   | Olympus DAO      | ETH                      | stake, unstake (OHM)                     |
-| `tokemak`   | Tokemak          | ETH                      | deposit, withdraw (Autopools)            |
-
-### Derivatives (13 protocols)
-
-| Slug                 | Name               | Category   | Chains    | Key Operations                            |
-| -------------------- | ------------------ | ---------- | --------- | ----------------------------------------- |
-| `gmx-v1`             | GMX V1             | perpetuals | ARB, AVAX | swap, increasePosition, decreasePosition  |
-| `gmx-v2`             | GMX V2             | perpetuals | ARB       | createOrder (GM markets)                  |
-| `synthetix-v3`       | Synthetix V3       | synthetics | BASE, OP  | delegateCollateral, mintUsd               |
-| `gains-network`      | Gains Network      | perpetuals | ARB, POLY | openTrade, closeTrade (up to 1000x forex) |
-| `vertex`             | Vertex             | perpetuals | ARB       | placeOrder (spot+perps+money markets)     |
-| `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       | 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)           |
-| `aevo`               | Aevo               | options    | Aevo L2   | deposit (off-chain orderbook)             |
-
-### Aggregators (6 protocols)
-
-| Slug                   | Name          | Chains                              | Key Operations                       |
-| ---------------------- | ------------- | ----------------------------------- | ------------------------------------ |
-| `oneinch`              | 1inch         | ETH, ARB, OP, BASE, BSC, AVAX, POLY | swap (optimal routing), limitOrder   |
-| `paraswap`             | ParaSwap      | ETH, ARB, OP, BASE, BSC, AVAX, POLY | swap (multiSwap, megaSwap)           |
-| `zerox`                | 0x Protocol   | ETH, ARB, OP, BASE, BSC, AVAX, POLY | transformERC20                       |
-| `cowswap`              | CoW Swap      | ETH, GNOSIS, ARB                    | swap (batch auction, MEV protection) |
-| `openocean`            | OpenOcean     | Multi-chain                         | swap (cross-chain routing)           |
-| `kyberswap-aggregator` | KyberSwap Agg | Multi-chain                         | swap (meta aggregation)              |
-
-### CDPs & Stablecoins (10 protocols)
-
-| Slug          | Name         | Stablecoin  | Key Operations                                 |
-| ------------- | ------------ | ----------- | ---------------------------------------------- |
-| `maker`       | Maker        | DAI/USDS    | open vault, draw DAI, deposit sDAI             |
-| `liquity-v1`  | Liquity V1   | LUSD        | openTrove, closeTrove (interest-free, 110% CR) |
-| `liquity-v2`  | Liquity V2   | BOLD        | openTrove (user-set rates, multi-collateral)   |
-| `ethena`      | Ethena       | USDe/sUSDe  | mint USDe, stake as sUSDe                      |
-| `gho`         | GHO          | GHO         | borrow GHO via Aave V3 collateral              |
-| `frax`        | Frax Finance | FRAX        | mint/redeem FRAX, stake sFRAX                  |
-| `crvusd`      | crvUSD       | crvUSD      | create_loan, repay (LLAMMA soft liquidations)  |
-| `reflexer`    | Reflexer     | RAI         | openSafe, generateDebt (non-pegged)            |
-| `abracadabra` | Abracadabra  | MIM         | borrow MIM via Cauldrons                       |
-| `alchemix`    | Alchemix     | alUSD/alETH | deposit, borrow (self-repaying loans)          |
-
-### Oracles (2 protocols)
-
-| Slug        | Name         | Key Operations                                          |
-| ----------- | ------------ | ------------------------------------------------------- |
-| `chainlink` | Chainlink    | latestRoundData (price feeds), requestRandomWords (VRF) |
-| `pyth`      | Pyth Network | updatePriceFeeds, getPrice (pull-based oracle)          |
-
-### Standards (2 protocols)
-
-| Slug      | Name     | Category       | Key Operations                                                       |
-| --------- | -------- | -------------- | -------------------------------------------------------------------- |
-| `erc3156` | ERC-3156 | infrastructure | flashLoan, flashFee, maxFlashLoan (standard flash loan interface)    |
-| `erc4626` | ERC-4626 | yield          | deposit, mint, withdraw, redeem (standard tokenized vault interface) |
-
-### Infrastructure (7 protocols)
-
-| Slug        | Name          | Key Operations                                                        |
-| ----------- | ------------- | --------------------------------------------------------------------- |
-| `erc20`     | ERC-20        | transfer, approve, transferFrom, balanceOf (standard token interface) |
-| `permit2`   | Permit2       | permit, transferFrom (universal token approvals)                      |
-| `safe`      | Safe (Gnosis) | execTransaction (multi-sig wallet)                                    |
-| `ens`       | ENS           | setAddr, resolve (name resolution)                                    |
-| `seaport`   | Seaport       | fulfillOrder (NFT marketplace)                                        |
-| `gelato`    | Gelato        | createTask (smart contract automation)                                |
-| `instadapp` | Instadapp     | flashLoan, getRoutes (flash loan aggregator)                          |
-
-### Payments & Streaming (2 protocols)
-
-| Slug         | Name       | Key Operations                                 |
-| ------------ | ---------- | ---------------------------------------------- |
-| `sablier`    | Sablier    | createWithDurations (token streaming, vesting) |
-| `superfluid` | Superfluid | createFlow (real-time per-second payments)     |
-
----
-
-## Quick Reference by Operation
-
-### "I need to swap tokens"
-
-1. **Single DEX**: Use the chain's dominant DEX (Uniswap V3 on ETH, Aerodrome on BASE, Velodrome on OP, Camelot on ARB)
-2. **Best price**: Use an aggregator (`oneinch`, `paraswap`, `cowswap`, `zerox`)
-3. **Stablecoin swap**: Use `curve` for lowest slippage between pegged assets
-4. **Cross-chain swap**: Use `lifi`, `squid`, or `socket` for bridge+swap in one tx
-
-### "I need to lend/borrow"
-
-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)
-
-### "I need to bridge tokens"
-
-1. **Fast**: `across` (relayer-based, minutes), `stargate` (LayerZero, minutes)
-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"
-
-1. **Liquid staking**: `lido` (stETH, largest), `rocket-pool` (rETH, decentralized), `cbeth` (Coinbase)
-2. **Restaking**: `eigenlayer` (restake LSTs), `etherfi` (eETH), `renzo` (ezETH), `kelp` (rsETH)
-
-### "I need yield optimization"
-
-1. **Yield trading**: `pendle` (split PT/YT, trade future yield)
-2. **Auto-compounding**: `beefy` (multi-chain), `yearn-v3` (ETH), `convex` (Curve LP)
-3. **LP management**: `arrakis`, `gamma` (automated Uni V3 positions)
-
-### "I need to trade perpetuals/options"
-
-1. **Perps**: `gmx-v2` (ARB), `gains-network` (up to 1000x), `vertex` (orderbook)
-2. **Options**: `premia` (AMM), `aevo` (orderbook), `hegic` (simplified)
-
-### "I need a stablecoin/CDP"
-
-1. **Overcollateralized**: `maker` (DAI), `liquity-v1` (LUSD, interest-free), `crvusd` (soft liquidations)
-2. **Synthetic dollar**: `ethena` (USDe, delta-neutral), `frax` (FRAX)
-3. **Self-repaying**: `alchemix` (alUSD/alETH)
-
----
-
-## 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                                                                                   |
-| Arc       | 5042     | uniswap-v3, uniswap-v4, aave-v4, morpho-blue, circle-gateway, synthra-v3, unitflow-v3 |
-
----
-
-## Per-Protocol Skill Files
-
-Detailed skill files with SauceScript examples, contract addresses, and ABI signatures are at:
-`@eco-incorp/sauce/skills/{slug}.md` (or `sdk/src/skills/{slug}.md` in the repo)
-
-Load the specific protocol file when you need full implementation details.

package/sdk/src/skills/kelp.md

@@ -1,60 +0,0 @@
-# Kelp DAO
-
-Liquid restaking protocol built on EigenLayer. Deposit LSTs (stETH, ETHx, etc.) and receive rsETH, a non-rebasing liquid restaked token.
-
-## Category
-
-restaking | Chains: Ethereum
-
-## Key Operations
-
-- **depositAsset**: Deposit LST to receive rsETH
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/kelp";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit LST for rsETH
-import { LRTDepositPoolABI as ILRTDepositPool } from "./abis";
-function main(
-  depositPoolAddress: Address,
-  asset: Address,
-  depositAmount: Uint256,
-  minRSETHAmountExpected: Uint256,
-): Uint256 {
-  const pool = ILRTDepositPool.at(depositPoolAddress);
-  pool.depositAsset(asset, depositAmount, minRSETHAmountExpected, "");
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract       | Address                                      |
-| -------- | -------------- | -------------------------------------------- |
-| Ethereum | rsETH          | `0xA1290d69c65A6Fe4DF752f95823fae25cB99e5A7` |
-| Ethereum | lrtDepositPool | `0x036676389e48133B63a802f8635AD39E752D375D` |
-
-## ABI Methods
-
-### LRTDepositPoolABI
-
-- `depositAsset(address,uint256,uint256,string)` - Deposit LST for rsETH. Params: asset address, deposit amount, minimum rsETH expected, referral string (pass empty "")
-- `getRsETHAmountToMint(address,uint256)` - Preview rsETH amount for a given LST deposit
-
-### RsETHABI
-
-- `balanceOf(address)` - Query rsETH balance
-- `approve(address,uint256)` - Approve rsETH spending
-
-## Notes
-
-- TVL: $2B+. Accepts stETH, ETHx, and other LSTs
-- Approve the LST to lrtDepositPool before depositing
-- minRSETHAmountExpected provides slippage protection
-- Use getRsETHAmountToMint() to preview output before depositing

package/sdk/src/skills/kyberswap.md

@@ -1,100 +0,0 @@
-# KyberSwap
-
-Multi-chain DEX with concentrated liquidity protocol (KyberSwap Elastic) and a meta-aggregation router that routes across multiple DEXes for best execution. Features dynamic fees and anti-sniping protection.
-
-## Category
-
-dex | Chains: Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, Base, Arc
-
-## Key Operations
-
-- **swap**: Exact input single swap via Elastic Router (concentrated liquidity)
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/kyberswap";
-```
-
-## SauceScript Examples
-
-### swap
-
-```typescript
-import { KyberSwapElasticRouterABI as IElasticRouter } from "./abis";
-
-function main(
-  routerAddress: Address,
-  tokenIn: Address,
-  tokenOut: Address,
-  fee: Uint256,
-  amountIn: Uint256,
-  amountOutMin: Uint256,
-  recipient: Address,
-): Uint256 {
-  const router = IElasticRouter.at(routerAddress);
-  return router.swapExactInputSingle({
-    tokenIn: tokenIn,
-    tokenOut: tokenOut,
-    fee: fee,
-    recipient: recipient,
-    deadline: 99999999999,
-    amountIn: amountIn,
-    minAmountOut: amountOutMin,
-    limitSqrtP: 0,
-  });
-}
-```
-
-- `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)
-- `amountOutMin`: Minimum output for slippage protection (named `minAmountOut` not `amountOutMinimum`)
-- `recipient`: Address to receive output tokens
-- `limitSqrtP`: Price limit (set to `0` for no limit; named `limitSqrtP` not `sqrtPriceLimitX96`)
-
-## Key Addresses
-
-| Chain     | Contract           | Address                                      |
-| --------- | ------------------ | -------------------------------------------- |
-| Ethereum  | Elastic Factory    | `0xC7a590291e07B9fe9E64b86c58fD8fC764308C4A` |
-| Ethereum  | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| Ethereum  | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Arbitrum  | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| Arbitrum  | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| Arbitrum  | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Optimism  | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| Optimism  | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| Optimism  | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Polygon   | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| Polygon   | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| Polygon   | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| BSC       | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| BSC       | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| BSC       | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Avalanche | Elastic Factory    | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` |
-| Avalanche | Elastic Router     | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` |
-| Avalanche | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Base      | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-| Arc       | Meta Agg Router V2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` |
-
-## ABI Methods
-
-### KyberSwapElasticRouterABI
-
-- `swapExactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountIn, uint256 minAmountOut, uint160 limitSqrtP)) -> uint256 amountOut` - Single-hop exact input swap via Elastic pools
-
-### KyberSwapMetaAggregationRouterABI
-
-- `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`)
-- 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/liquity-v2.md

@@ -1,59 +0,0 @@
-# Liquity V2
-
-Next generation of Liquity protocol with user-set interest rates, multi-collateral support, and the BOLD stablecoin.
-
-## Category
-
-cdp | Chains: Ethereum
-
-## Key Operations
-
-- **transfer**: Transfer BOLD tokens
-- **approve**: Approve BOLD token spender
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/liquity-v2";
-```
-
-## SauceScript Examples
-
-```typescript
-// Transfer BOLD
-import { BoldTokenABI as IBoldToken } from "./abis";
-function main(boldAddress: Address, to: Address, amount: Uint256): Uint256 {
-  const bold = IBoldToken.at(boldAddress);
-  bold.transfer(to, amount);
-  return 1;
-}
-
-// Approve BOLD spender
-import { BoldTokenABI as IBoldToken } from "./abis";
-function main(boldAddress: Address, spender: Address, amount: Uint256): Uint256 {
-  const bold = IBoldToken.at(boldAddress);
-  bold.approve(spender, amount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | bold     | `0x6440f144b7e50D6a8439336510312d2F54beB01D` |
-
-## ABI Methods
-
-### BoldTokenABI
-
-- `transfer(address,uint256)` - Transfer BOLD tokens. Params: to, amount. Returns bool
-- `approve(address,uint256)` - Approve spender. Params: spender, amount. Returns bool
-- `balanceOf(address)` - Query balance. Params: account. Returns uint256
-
-## Notes
-
-- User-set interest rates - borrowers choose their own rate (higher rate = lower liquidation risk)
-- Multi-collateral: ETH, wstETH, rETH, and other LSTs
-- BOLD is fully redeemable 1:1 for collateral at any time
-- Successor to Liquity V1 with improved capital efficiency

package/sdk/src/skills/loader.ts

@@ -1,46 +0,0 @@
-// The skill documents are embedded at build time (`embedded/skills.generated.ts`), so this module
-// reads no filesystem and works in a browser. The `.md` files under `src/skills/` remain the source
-// of truth, and still ship in the package for readers who want the files themselves.
-import { SKILL_DOCUMENTS } from "../embedded/skills.generated.js";
-
-const INDEX = "index";
-
-/**
- * Load the master protocol index skill file.
- * Returns markdown content with all protocols, categories, operations, and chain coverage.
- */
-export function getProtocolIndex(): string {
-  const index = SKILL_DOCUMENTS[INDEX];
-  if (index === undefined) throw new Error("the protocol skill index is not embedded");
-
-  return index;
-}
-
-/**
- * Load a specific protocol's skill file by slug.
- * Returns markdown describing the protocol, its operations,
- * SauceScript examples, contract addresses, and ABI methods.
- *
- * The slug is matched against `listSkillSlugs()`, so it can only name a skill this package ships;
- * anything else surfaces as the same not-found error.
- */
-export function getProtocolSkill(slug: string): string {
-  if (!listSkillSlugs().includes(slug)) throw unknownSlug(slug);
-
-  return SKILL_DOCUMENTS[slug]!;
-}
-
-/**
- * List all available protocol skill slugs.
- */
-export function listSkillSlugs(): string[] {
-  return Object.keys(SKILL_DOCUMENTS)
-    .filter((slug) => slug !== INDEX)
-    .sort();
-}
-
-function unknownSlug(slug: string): Error {
-  return new Error(
-    `No skill file found for protocol "${slug}". Check listSkillSlugs() for valid slugs.`,
-  );
-}