@eco-incorp/sauce 0.99.6 → 0.99.7

package/sdk/dist/swap/types.js

@@ -1,106 +0,0 @@
-/**
- * `@eco-incorp/sauce`'s `swap` module — E4.1, the universal swap adapter.
- *
- * Types + pool-type registry for lowering a chain-agnostic swap SPEC into a `ISauceRouter.swap`
- * call. See `sdk/src/swap/index.ts` for the module-level overview and the E3 composition example.
- */
-/**
- * `SwapPoolType` — pinned verbatim from the engine's `IRouter.sol` `enum SwapPoolType`, whose own
- * doc says values are APPEND-ONLY (the enum rides `SwapParams.poolType` as `uint8`, so reordering
- * breaks the ABI of every compiled recipe). Only 0..8 are dispatchable through the unified
- * `swap()` entry point — see {@link UndispatchablePoolType} for 9/10.
- */
-export const SwapPoolType = {
-    UniV2: 0,
-    UniV3: 1,
-    UniV4: 2,
-    Curve: 3,
-    BalancerV2: 4,
-    DODOV2: 5,
-    TraderJoeLB: 6,
-    MaverickV2: 7,
-    WOOFi: 8,
-};
-/**
- * Pool types that exist on the engine's `SwapPoolType` enum but are NOT dispatchable through the
- * unified `swap()` — `Router.sol`'s `swap()` dispatch chain covers only 0..8 and falls through to
- * `revert SwapFailed()` for anything else. PancakeInfinity's CL/Bin pools need their own
- * `swapInfinityCL`/`swapInfinityBin` entry points (a different, 6-field `InfinityPoolKey` that
- * `SwapParams` cannot carry) — out of scope for this first cut. Exported so the value is nameable;
- * {@link toSwapParams} throws when handed one of these, pointing at this follow-up.
- */
-export const UndispatchablePoolType = {
-    PancakeInfinityCL: 9,
-    PancakeInfinityBin: 10,
-};
-const CALLBACK_VENUES = new Set([
-    SwapPoolType.UniV3,
-    SwapPoolType.UniV4,
-    SwapPoolType.MaverickV2,
-]);
-const CALLBACK_FREE_VENUES = new Set([
-    SwapPoolType.UniV2,
-    SwapPoolType.Curve,
-    SwapPoolType.BalancerV2,
-    SwapPoolType.DODOV2,
-    SwapPoolType.TraderJoeLB,
-    SwapPoolType.WOOFi,
-]);
-/**
- * True for the three pool types `Router.sol` (`~279-283`) allows a non-empty `callback` for — the
- * pool re-enters the contract mid-swap to pull input, so servicing it requires the router's
- * compiled code. NOT the same partition as {@link isCallbackFree}: MaverickV2 is callback-driven
- * yet its handler still takes `abs(amountSpecified)` (see `amountSpecifiedFor`).
- */
-export function isCallbackVenue(poolType) {
-    return CALLBACK_VENUES.has(poolType);
-}
-/**
- * True for the pool types whose swap logic is callback-free (`Router.sol` reads reserves / calls a
- * plain `pool.swap(...)`) and so MAY, as a follow-up, be replicated as direct
- * `transfer` + `pool.swap` SauceScript instead of going through the Router. This module always
- * routes through the unified `swap()` regardless — see `sdk/src/swap/index.ts`'s scope notes.
- */
-export function isCallbackFree(poolType) {
-    return CALLBACK_FREE_VENUES.has(poolType);
-}
-/**
- * True for the pool types where `SwapParams.poolKey` is actually consulted by the engine:
- * UniV4 (all 5 fields, via `V4SwapParams`) and, less obviously, UniV2 (`Router.sol#_swapV2` reads
- * `poolKey.fee` as the pair's LP fee in ppm — `0` defaults to 3000 / 0.30%, `>= 1_000_000` reverts).
- * Every other pool type ignores `poolKey` entirely.
- */
-export function usesPoolKey(poolType) {
-    return poolType === SwapPoolType.UniV4 || poolType === SwapPoolType.UniV2;
-}
-/** All-zero `poolKey`, used for any pool type that doesn't consult it (see {@link usesPoolKey}). */
-export const ZERO_POOL_KEY = {
-    currency0: 0n,
-    currency1: 0n,
-    fee: 0n,
-    tickSpacing: 0n,
-    hooks: 0n,
-};
-/** `SwapParams`'s top-level field names, in exact ABI-declaration order (pinned against the
- *  vendored `ISauceRouter.json` artifact in `sdk/test/swap.test.ts`). */
-export const SWAP_PARAMS_FIELDS = [
-    "poolType",
-    "pool",
-    "poolKey",
-    "tokenIn",
-    "tokenOut",
-    "amountSpecified",
-    "sqrtPriceLimitX96",
-    "payer",
-    "recipient",
-    "callback",
-];
-/** `SwapParams.poolKey`'s field names, in exact ABI-declaration order. */
-export const POOL_KEY_FIELDS = [
-    "currency0",
-    "currency1",
-    "fee",
-    "tickSpacing",
-    "hooks",
-];
-//# sourceMappingURL=types.js.map

package/sdk/dist/swap/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,KAAK,EAAE,CAAC;CACA,CAAC;AAIX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB,EAAE,CAAC;IACpB,kBAAkB,EAAE,EAAE;CACd,CAAC;AAKX,MAAM,eAAe,GAA8B,IAAI,GAAG,CAAC;IACzD,YAAY,CAAC,KAAK;IAClB,YAAY,CAAC,KAAK;IAClB,YAAY,CAAC,UAAU;CACxB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAA8B,IAAI,GAAG,CAAC;IAC9D,YAAY,CAAC,KAAK;IAClB,YAAY,CAAC,KAAK;IAClB,YAAY,CAAC,UAAU;IACvB,YAAY,CAAC,MAAM;IACnB,YAAY,CAAC,WAAW;IACxB,YAAY,CAAC,KAAK;CACnB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAsB;IACpD,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,OAAO,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAsB;IAChD,OAAO,QAAQ,KAAK,YAAY,CAAC,KAAK,IAAI,QAAQ,KAAK,YAAY,CAAC,KAAK,CAAC;AAC5E,CAAC;AAmCD,oGAAoG;AACpG,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,GAAG,EAAE,EAAE;IACP,WAAW,EAAE,EAAE;IACf,KAAK,EAAE,EAAE;CACV,CAAC;AAsEF;yEACyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAkC;IAC/D,UAAU;IACV,MAAM;IACN,SAAS;IACT,SAAS;IACT,UAAU;IACV,iBAAiB;IACjB,mBAAmB;IACnB,OAAO;IACP,WAAW;IACX,UAAU;CACX,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAA+B;IACzD,WAAW;IACX,WAAW;IACX,KAAK;IACL,aAAa;IACb,OAAO;CACR,CAAC"}

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

@@ -1,134 +0,0 @@
-# Aave V3
-
-Non-custodial liquidity protocol for earning interest on deposits and borrowing assets. The most widely deployed lending protocol in DeFi.
-
-## Category
-
-lending | Chains: Ethereum (1), Polygon (137), Arbitrum (42161), Optimism (10), Avalanche (43114), Base (8453), BSC (56), Scroll (534352), Fantom (250), Gnosis (100), Metis (1088)
-
-## SauceScript Functions
-
-### supply
-
-Supply assets to earn interest. Mints aTokens to the supplier.
-
-```typescript
-import { PoolABI as IPool } from "./abis";
-
-function main(poolAddress: Address, asset: Address, amount: Uint256, onBehalfOf: Address): Uint256 {
-  const pool = IPool.at(poolAddress);
-  pool.supply(asset, amount, onBehalfOf, 0);
-  return 1;
-}
-```
-
-- `poolAddress`: Pool contract for the target chain
-- `asset`: ERC-20 token address to supply
-- `amount`: Amount in token's native decimals. Use `type(uint256).max` for entire balance
-- `onBehalfOf`: Address that receives aTokens (use msg.sender for self)
-- Requires ERC-20 approval to the Pool before calling
-
-### withdraw
-
-Withdraw supplied assets by burning aTokens.
-
-```typescript
-import { PoolABI as IPool } from "./abis";
-
-function main(poolAddress: Address, asset: Address, amount: Uint256, to: Address): Uint256 {
-  const pool = IPool.at(poolAddress);
-  return pool.withdraw(asset, amount, to);
-}
-```
-
-- `amount`: Use `type(uint256).max` to withdraw entire balance
-- Returns the actual withdrawn amount
-
-### borrow
-
-Borrow assets against supplied collateral.
-
-```typescript
-import { PoolABI as IPool } from "./abis";
-
-function main(
-  poolAddress: Address,
-  asset: Address,
-  amount: Uint256,
-  interestRateMode: Uint256,
-  onBehalfOf: Address,
-): Uint256 {
-  const pool = IPool.at(poolAddress);
-  pool.borrow(asset, amount, interestRateMode, 0, onBehalfOf);
-  return 1;
-}
-```
-
-- `interestRateMode`: 1 = stable (being phased out), 2 = variable. Use 2 for variable rate
-- Must have sufficient collateral supplied first
-
-### repay
-
-Repay borrowed assets to reduce debt.
-
-```typescript
-import { PoolABI as IPool } from "./abis";
-
-function main(
-  poolAddress: Address,
-  asset: Address,
-  amount: Uint256,
-  interestRateMode: Uint256,
-  onBehalfOf: Address,
-): Uint256 {
-  const pool = IPool.at(poolAddress);
-  return pool.repay(asset, amount, interestRateMode, onBehalfOf);
-}
-```
-
-- `interestRateMode`: Must match the debt type (1 = stable, 2 = variable)
-- `amount`: Use `type(uint256).max` to repay entire debt
-- Requires ERC-20 approval to the Pool
-
-## Deployed Addresses
-
-| Chain     | Contract              | Address                                      |
-| --------- | --------------------- | -------------------------------------------- |
-| Ethereum  | pool                  | `0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2` |
-| Ethereum  | poolAddressesProvider | `0x2f39d218133AFaB8F2B819B1066c7E434Ad94E9e` |
-| Polygon   | pool                  | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` |
-| Polygon   | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` |
-| Arbitrum  | pool                  | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` |
-| Arbitrum  | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` |
-| Optimism  | pool                  | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` |
-| Optimism  | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` |
-| Avalanche | pool                  | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` |
-| Avalanche | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` |
-| Base      | pool                  | `0xA238Dd80C259a72e81d7e4664a9801593F98d1c5` |
-| Base      | poolAddressesProvider | `0xe20fCBdBfFC4Dd138cE8b2E6FBb6CB49777ad64D` |
-| BSC       | pool                  | `0x6807dc923806fE8Fd134338EABCA509979a7e0cB` |
-| Scroll    | pool                  | `0x11fCfe756c05AD438e312a7fd934381537D3cFfe` |
-| Fantom    | pool                  | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` |
-| Gnosis    | pool                  | `0xb50201558B00496A145fE76f7424749556E326D8` |
-| Metis     | pool                  | `0x90df02551bB792286e8D4f13E0e357b4Bf1D6a57` |
-
-## ABI Reference
-
-### PoolABI
-
-- `supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode)` - Supply asset to earn interest
-- `withdraw(address asset, uint256 amount, address to) returns (uint256)` - Withdraw supplied asset
-- `borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf)` - Borrow against collateral
-- `repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf) returns (uint256)` - Repay borrowed debt
-- `flashLoanSimple(address receiverAddress, address asset, uint256 amount, bytes params, uint16 referralCode)` - Single-asset flash loan (receiver must implement IFlashLoanSimpleReceiver)
-- `liquidationCall(address collateralAsset, address debtAsset, address user, uint256 debtToCover, bool receiveAToken)` - Liquidate undercollateralized position (healthFactor < 1e18)
-- `getUserAccountData(address user) returns (uint256 totalCollateralBase, uint256 totalDebtBase, uint256 availableBorrowsBase, uint256 currentLiquidationThreshold, uint256 ltv, uint256 healthFactor)` - Get account health data (view)
-
-## Notes
-
-- interestRateMode: 1 = stable (deprecated on most markets), 2 = variable
-- referralCode is always 0 (referral program inactive)
-- V3 introduced efficiency mode (eMode) for correlated assets, isolation mode for new assets, and siloed borrowing
-- All supply/repay operations require prior ERC-20 approval to the Pool address
-- healthFactor < 1e18 means position is liquidatable
-- TVL: $40B+. Audited

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

@@ -1,91 +0,0 @@
-# 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/abracadabra.md

@@ -1,93 +0,0 @@
-# Abracadabra
-
-Lending protocol that lets users borrow MIM stablecoin against yield-bearing collateral via isolated Cauldron markets built on DegenBox.
-
-## Category
-
-cdp | Chains: Ethereum, Arbitrum
-
-## Key Operations
-
-- **borrow**: Borrow MIM from a Cauldron
-- **repay**: Repay MIM debt
-- **addCollateral**: Add collateral to a Cauldron position
-- **removeCollateral**: Remove collateral from a Cauldron position
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/abracadabra";
-```
-
-## SauceScript Examples
-
-```typescript
-// Borrow MIM from Cauldron
-import { CauldronABI as ICauldron } from "./abis";
-function main(
-  cauldronAddress: Address,
-  to: Address,
-  amount: Uint256,
-): { part: Uint256; share: Uint256 } {
-  const cauldron = ICauldron.at(cauldronAddress);
-  return cauldron.borrow(to, amount);
-}
-
-// Repay MIM debt
-import { CauldronABI as ICauldron } from "./abis";
-function main(cauldronAddress: Address, to: Address, part: Uint256): Uint256 {
-  const cauldron = ICauldron.at(cauldronAddress);
-  return cauldron.repay(to, 0, part);
-}
-
-// Add collateral
-import { CauldronABI as ICauldron } from "./abis";
-function main(cauldronAddress: Address, to: Address, share: Uint256): Uint256 {
-  const cauldron = ICauldron.at(cauldronAddress);
-  cauldron.addCollateral(to, 0, share);
-  return 1;
-}
-
-// Remove collateral
-import { CauldronABI as ICauldron } from "./abis";
-function main(cauldronAddress: Address, to: Address, share: Uint256): Uint256 {
-  const cauldron = ICauldron.at(cauldronAddress);
-  cauldron.removeCollateral(to, share);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | degenBox | `0xd96f48665a1410C0cd669A88898ecA36B9Fc2cce` |
-| Ethereum | mim      | `0x99D8a9C45b2ecA8864373A26D1459e3Dff1e17F3` |
-| Arbitrum | degenBox | `0x7C8FeF8eA9b1fE46A7689bfb8149341C90431D38` |
-| Arbitrum | mim      | `0xFEa7a6a0B346362BF88A9e4A88416B77a57D6c2A` |
-
-## ABI Methods
-
-### CauldronABI
-
-- `borrow(address,uint256)` - Borrow MIM. Params: to (recipient), amount (MIM to borrow). Returns (part, share) - part is debt units, share is DegenBox shares
-- `repay(address,bool,uint256)` - Repay MIM debt. Params: to (whose debt to repay), skim (true=use DegenBox balance), part (debt part to repay). Returns amount repaid
-- `addCollateral(address,bool,uint256)` - Add collateral. Params: to (position owner), skim (true=use DegenBox balance), share (collateral shares to add)
-- `removeCollateral(address,uint256)` - Remove collateral. Params: to (recipient), share (collateral shares to remove)
-- `userCollateralShare(address)` - Query user's collateral. Params: user. Returns share amount
-- `userBorrowPart(address)` - Query user's debt. Params: user. Returns borrow part
-
-### DegenBoxABI
-
-- `deposit(address,address,address,uint256,uint256)` - Deposit tokens into DegenBox. Payable. Params: token, from, to, amount (0 if using share), share (0 if using amount). Returns (amountOut, shareOut)
-- `withdraw(address,address,address,uint256,uint256)` - Withdraw from DegenBox. Params: token, from, to, amount (0 if using share), share (0 if using amount). Returns (amountOut, shareOut)
-- `balanceOf(address,address)` - Query balance. Params: token, user. Returns share amount
-
-## Notes
-
-- Isolated Cauldron markets - each has specific collateral type and risk parameters
-- DegenBox is the underlying vault that holds all assets (BentoBox fork)
-- Amounts use "part" (debt accounting) and "share" (DegenBox shares) - not raw token amounts
-- skim=false means transfer tokens from caller; skim=true means use tokens already in DegenBox
-- Deposit collateral to DegenBox first, then addCollateral to a Cauldron
-- Common collateral: sSPELL, yv tokens, LP tokens, yield-bearing assets

package/sdk/src/skills/across.md

@@ -1,90 +0,0 @@
-# Across
-
-Optimistic cross-chain bridge powered by UMA's optimistic oracle. Uses relayers for fast fills and canonical bridges for settlement.
-
-## 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), Arc (5042)
-
-## SauceScript Functions
-
-### bridge
-
-Deposit tokens into the SpokePool for a cross-chain transfer, through `depositV3`.
-
-```typescript
-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.depositV3(
-    ctx.msgSender(),
-    recipient,
-    token,
-    outputToken,
-    amount,
-    outputAmount,
-    destinationChainId,
-    0x0000000000000000000000000000000000000000,
-    quoteTimestamp,
-    fillDeadline,
-    0,
-    "",
-  );
-  return 1;
-}
-```
-
-- `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
-
-## Deployed Addresses
-
-| Chain    | Contract  | Address                                      |
-| -------- | --------- | -------------------------------------------- |
-| Ethereum | hubPool   | `0xc186fA914353c44b2E33eBE05f21846F1048bEda` |
-| Ethereum | spokePool | `0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5` |
-| Arbitrum | spokePool | `0xe35e9842fceaCA96570B734083f4a58e8F7C5f2A` |
-| Optimism | spokePool | `0x6f26Bf09B1C792e3228e5467807a900A503c0281` |
-| Base     | spokePool | `0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64` |
-| Polygon  | spokePool | `0x9295ee1d8C5b022Be115A2AD3c30C72E34e7F096` |
-| zkSync   | spokePool | `0xE0B015E54d54fc84a6cB9B666099c46adE9335FF` |
-| Linea    | spokePool | `0x7E63A5f1a8F0B4d0934B2f2327DAED3F6bb2ee75` |
-| Mode     | spokePool | `0x3baD7AD0728f9917d1Bf08af5782dCbD516cDd96` |
-| Blast    | spokePool | `0x2D509190Ed0172ba588407D4c2df918F955Cc6E1` |
-| Scroll   | spokePool | `0x3baD7AD0728f9917d1Bf08af5782dCbD516cDd96` |
-
-## ABI Reference
-
-### AcrossSpokePoolABI
-
-- `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. 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
-- 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

@@ -1,57 +0,0 @@
-# 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/aevo.md

@@ -1,58 +0,0 @@
-# Aevo
-
-High-performance options and perpetuals exchange built on a custom OP Stack rollup. Off-chain orderbook with on-chain settlement.
-
-## Category
-
-options | Chains: Ethereum (deposits)
-
-## Key Operations
-
-- **depositERC20**: Deposit ERC-20 tokens into Aevo L2 for trading
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/aevo";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit ERC-20 into Aevo
-import { DepositContractABI as IDeposit } from "./abis";
-function main(
-  depositAddress: Address,
-  token: Address,
-  l2Token: Address,
-  amount: Uint256,
-  minGasLimit: Uint256,
-): Uint256 {
-  const deposit = IDeposit.at(depositAddress);
-  deposit.depositERC20(token, l2Token, amount, minGasLimit, "");
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract        | Address                                      |
-| -------- | --------------- | -------------------------------------------- |
-| Ethereum | depositContract | `0x4082C9647c098a6493Fb499EaE63b5ce3259C574` |
-
-## ABI Methods
-
-### DepositContractABI
-
-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
-
-- Custom OP Stack rollup with off-chain orderbook for sub-second matching
-- Supports options and perpetual futures trading
-- Deposits are on Ethereum L1, trading happens on Aevo L2
-- Withdrawals processed by the rollup bridge (takes ~7 days for L2 to L1)
-- Approve ERC-20 tokens to depositContract before calling depositERC20