@eco-incorp/sauce 0.99.5 → 0.99.7

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

@@ -1,202 +0,0 @@
-# Uniswap V3
-
-Concentrated liquidity AMM allowing LPs to allocate capital within custom price ranges for higher capital efficiency. Supports multiple fee tiers per pair and NFT-based liquidity positions.
-
-## Category
-
-dex | Chains: Ethereum, Arbitrum, Optimism, Polygon, Base, BSC, Avalanche, Celo, Arc
-
-## Key Operations
-
-- **swap**: Swap tokens using exact input (single-hop or multi-hop via encoded path)
-- **addLiquidity**: Mint a new concentrated liquidity position as an NFT within a tick range
-- **removeLiquidity**: Decrease liquidity from an existing NFT position
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/uniswap-v3";
-```
-
-## SauceScript Examples
-
-### swap
-
-```typescript
-import { UniswapV3SwapRouterABI as ISwapRouter } from "./abis";
-
-function main(
-  routerAddress: Address,
-  tokenIn: Address,
-  tokenOut: Address,
-  fee: Uint256,
-  amountIn: Uint256,
-  amountOutMin: Uint256,
-  recipient: Address,
-): Uint256 {
-  const router = ISwapRouter.at(routerAddress);
-  return router.exactInputSingle({
-    tokenIn: tokenIn,
-    tokenOut: tokenOut,
-    fee: fee,
-    recipient: recipient,
-    deadline: 99999999999,
-    amountIn: amountIn,
-    amountOutMinimum: amountOutMin,
-    sqrtPriceLimitX96: 0,
-  });
-}
-```
-
-- `routerAddress`: Uniswap V3 SwapRouter address for the target chain. This `swap` uses SwapRouter's params (with `deadline`); chains that only have SwapRouter02 (Base, BSC, Avalanche, Celo, Monad) need `UniswapV3SwapRouter02ABI`, whose params have no `deadline`
-- `tokenIn` / `tokenOut`: Input and output token addresses
-- `fee`: Pool fee tier in hundredths of a bip. Common values: `500` (0.05%), `3000` (0.3%), `10000` (1%)
-- `amountIn`: Exact amount of input token (in wei)
-- `amountOutMin`: Minimum output for slippage protection
-- `recipient`: Address to receive output tokens
-- `sqrtPriceLimitX96`: Set to `0` to accept any price (no limit)
-
-### addLiquidity (mint position)
-
-```typescript
-import { UniswapV3NonfungiblePositionManagerABI as INonfungiblePositionManager } from "./abis";
-
-function main(
-  nfpmAddress: Address,
-  token0: Address,
-  token1: Address,
-  fee: Uint256,
-  tickLower: Uint256,
-  tickUpper: Uint256,
-  amount0Desired: Uint256,
-  amount1Desired: Uint256,
-  amount0Min: Uint256,
-  amount1Min: Uint256,
-  recipient: Address,
-): { tokenId: Uint256; liquidity: Uint256; amount0: Uint256; amount1: Uint256 } {
-  const nfpm = INonfungiblePositionManager.at(nfpmAddress);
-  return nfpm.mint({
-    token0: token0,
-    token1: token1,
-    fee: fee,
-    tickLower: tickLower,
-    tickUpper: tickUpper,
-    amount0Desired: amount0Desired,
-    amount1Desired: amount1Desired,
-    amount0Min: amount0Min,
-    amount1Min: amount1Min,
-    recipient: recipient,
-    deadline: 99999999999,
-  });
-}
-```
-
-- `nfpmAddress`: NonfungiblePositionManager contract address
-- `token0` / `token1`: Pair tokens sorted by address (token0 < token1)
-- `fee`: Pool fee tier (500, 3000, or 10000)
-- `tickLower` / `tickUpper`: Price range boundaries as tick values. Ticks must be multiples of the pool's tick spacing (10 for 0.05%, 60 for 0.3%, 200 for 1%)
-- `amount0Desired` / `amount1Desired`: Target deposit amounts
-- `amount0Min` / `amount1Min`: Minimum deposit amounts (slippage protection)
-- Both tokens must be approved to the NonfungiblePositionManager
-
-### removeLiquidity (decrease liquidity)
-
-```typescript
-import { UniswapV3NonfungiblePositionManagerABI as INonfungiblePositionManager } from "./abis";
-
-function main(
-  nfpmAddress: Address,
-  tokenId: Uint256,
-  liquidity: Uint256,
-  amount0Min: Uint256,
-  amount1Min: Uint256,
-): { amount0: Uint256; amount1: Uint256 } {
-  const nfpm = INonfungiblePositionManager.at(nfpmAddress);
-  return nfpm.decreaseLiquidity({
-    tokenId: tokenId,
-    liquidity: liquidity,
-    amount0Min: amount0Min,
-    amount1Min: amount1Min,
-    deadline: 99999999999,
-  });
-}
-```
-
-- `tokenId`: NFT ID of the liquidity position
-- `liquidity`: Amount of liquidity to remove (not token amounts)
-- `amount0Min` / `amount1Min`: Minimum tokens to receive (slippage protection)
-- After decreasing liquidity, call `collect` to actually withdraw the tokens
-
-## Key Addresses
-
-| Chain     | Contract     | Address                                      |
-| --------- | ------------ | -------------------------------------------- |
-| Ethereum  | Factory      | `0x1F98431c8aD98523631AE4a59f267346ea31F984` |
-| Ethereum  | SwapRouter   | `0xE592427A0AEce92De3Edee1F18E0157C05861564` |
-| Ethereum  | SwapRouter02 | `0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45` |
-| Ethereum  | QuoterV2     | `0x61fFE014bA17989E743c5F6cB21bF9697530B21e` |
-| Ethereum  | NFPM         | `0xC36442b4a4522E871399CD717aBDD847Ab11FE88` |
-| Arbitrum  | Factory      | `0x1F98431c8aD98523631AE4a59f267346ea31F984` |
-| Arbitrum  | SwapRouter   | `0xE592427A0AEce92De3Edee1F18E0157C05861564` |
-| Arbitrum  | NFPM         | `0xC36442b4a4522E871399CD717aBDD847Ab11FE88` |
-| Optimism  | Factory      | `0x1F98431c8aD98523631AE4a59f267346ea31F984` |
-| Optimism  | SwapRouter   | `0xE592427A0AEce92De3Edee1F18E0157C05861564` |
-| Optimism  | NFPM         | `0xC36442b4a4522E871399CD717aBDD847Ab11FE88` |
-| Polygon   | Factory      | `0x1F98431c8aD98523631AE4a59f267346ea31F984` |
-| Polygon   | SwapRouter   | `0xE592427A0AEce92De3Edee1F18E0157C05861564` |
-| Polygon   | NFPM         | `0xC36442b4a4522E871399CD717aBDD847Ab11FE88` |
-| Base      | Factory      | `0x33128a8fC17869897dcE68Ed026d694621f6FDfD` |
-| Base      | SwapRouter02 | `0x2626664c2603336E57B271c5C0b26F421741e481` |
-| Base      | NFPM         | `0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1` |
-| BSC       | Factory      | `0xdB1d10011AD0Ff90774D0C6Bb92e5C5c8b4461F7` |
-| BSC       | SwapRouter02 | `0xB971eF87ede563556b2ED4b1C0b0019111Dd85d2` |
-| Avalanche | Factory      | `0x740b1c1de25031C31FF4fC9A62f554A55cdC1baD` |
-| Avalanche | SwapRouter02 | `0xbb00FF08d01D300023C629E8fFfFcb65A5a578cE` |
-| Celo      | Factory      | `0xAfE208a311B21f13EF87E33A90049fC17A7acDEc` |
-| Celo      | SwapRouter02 | `0x5615CDAb10dc425a742d643d949a7F474C01abc4` |
-
-## ABI Methods
-
-### UniswapV3SwapRouterABI
-
-- `exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96)) -> uint256 amountOut` - Single-hop swap with exact input amount
-- `exactInput(tuple(bytes path, address recipient, uint256 deadline, uint256 amountIn, uint256 amountOutMinimum)) -> uint256 amountOut` - Multi-hop swap with exact input via encoded path (tokenA+fee+tokenB+fee+tokenC)
-- `exactOutputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96)) -> uint256 amountIn` - Single-hop swap specifying exact output desired
-- `exactOutput(tuple(bytes path, address recipient, uint256 deadline, uint256 amountOut, uint256 amountInMaximum)) -> uint256 amountIn` - Multi-hop swap specifying exact output desired
-
-### UniswapV3SwapRouter02ABI
-
-SwapRouter02's params structs drop `deadline` (wrap the call in a deadline check if needed).
-
-- `exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96)) -> uint256 amountOut`
-- `exactInput(tuple(bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum)) -> uint256 amountOut`
-- `exactOutputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96)) -> uint256 amountIn`
-- `exactOutput(tuple(bytes path, address recipient, uint256 amountOut, uint256 amountInMaximum)) -> uint256 amountIn`
-
-### UniswapV3NonfungiblePositionManagerABI
-
-- `mint(tuple(address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, address recipient, uint256 deadline)) -> (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)` - Create new liquidity position NFT
-- `increaseLiquidity(tuple(uint256 tokenId, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, uint256 deadline)) -> (uint128 liquidity, uint256 amount0, uint256 amount1)` - Add more liquidity to existing position
-- `decreaseLiquidity(tuple(uint256 tokenId, uint128 liquidity, uint256 amount0Min, uint256 amount1Min, uint256 deadline)) -> (uint256 amount0, uint256 amount1)` - Remove liquidity from position (tokens stay in contract until collected)
-- `collect(tuple(uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max)) -> (uint256 amount0, uint256 amount1)` - Withdraw accumulated fees and removed liquidity tokens
-
-### UniswapV3FactoryABI
-
-- `getPool(address tokenA, address tokenB, uint24 fee) -> address pool` - Look up pool address for token pair and fee tier (view)
-- `createPool(address tokenA, address tokenB, uint24 fee) -> address pool` - Deploy a new pool
-
-### UniswapV3QuoterV2ABI
-
-- `quoteExactInputSingle(tuple(address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96)) -> (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)` - Simulate a swap to get expected output. Not a view: it reverts internally to measure, so call it off-chain (eth_call)
-
-## Notes
-
-- Fee tiers: `100` (0.01%, stablecoins), `500` (0.05%, correlated pairs), `3000` (0.3%, standard), `10000` (1%, exotic)
-- Token order matters: `token0` must be the lower address. Sort before calling mint
-- Tick spacing varies by fee tier: 1 (0.01%), 10 (0.05%), 60 (0.3%), 200 (1%)
-- After `decreaseLiquidity`, tokens sit in the position until `collect` is called
-- For multi-hop swaps via `exactInput`, the `path` is ABI-encoded as `tokenIn + fee + tokenMiddle + fee + tokenOut`
-- Input token must be ERC20-approved to the SwapRouter for swaps
-- Both tokens must be ERC20-approved to the NFPM for minting positions
-- Prefer V3 over V2 for major pairs to benefit from concentrated liquidity and lower effective slippage
-- On Arc (5042) `WETH9()` on SwapRouter02 and the position manager is a stub that always reverts with `UnsupportedProtocolError()`, so `unwrapWETH9`, `refundETH` and native-value swaps revert. Trade USDC's ERC-20 `0x3600000000000000000000000000000000000000`; Arc's native coin is USDC and it has no canonical wrapped native

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

@@ -1,125 +0,0 @@
-# Uniswap V4
-
-Singleton AMM with hooks architecture enabling custom pool logic, flash accounting, and native ETH support. All pools share a single PoolManager contract for gas savings on multi-hop swaps.
-
-## Category
-
-dex | Chains: Ethereum, Arbitrum, Optimism, Base, Polygon, BSC, Avalanche, Blast, Arc
-
-## Key Operations
-
-- **swap**: Execute a swap through the UniversalRouter using command-based encoding
-- **addLiquidity**: Modify liquidity positions through the PositionManager
-- **removeLiquidity**: Decrease or remove liquidity positions through the PositionManager
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/uniswap-v4";
-```
-
-## SauceScript Examples
-
-### swap
-
-```typescript
-import { UniswapV4UniversalRouterABI as IUniversalRouter } from "./abis";
-
-function main(routerAddress: Address, commands: bytes, inputs: bytes[]): Uint256 {
-  const router = IUniversalRouter.at(routerAddress);
-  router.execute(commands, inputs, 99999999999);
-  return 1;
-}
-```
-
-- `routerAddress`: UniversalRouter address for the target chain
-- `commands`: Encoded bytes of command IDs defining the sequence of operations (each byte = one command)
-- `inputs`: Encoded bytes array of ABI-encoded parameters for each command
-- Commands and inputs must be pre-encoded off-chain; the router decodes and executes sequentially
-
-### addLiquidity
-
-```typescript
-import { UniswapV4PositionManagerABI as IPositionManager } from "./abis";
-
-function main(positionManagerAddress: Address, unlockData: bytes): Uint256 {
-  const pm = IPositionManager.at(positionManagerAddress);
-  pm.modifyLiquidities(unlockData, 99999999999);
-  return 1;
-}
-```
-
-- `positionManagerAddress`: PositionManager address for the target chain
-- `unlockData`: ABI-encoded liquidity modification data including pool key, tick range, and amounts
-- Data must be pre-encoded off-chain with the position parameters
-
-### removeLiquidity
-
-```typescript
-import { UniswapV4PositionManagerABI as IPositionManager } from "./abis";
-
-function main(positionManagerAddress: Address, unlockData: bytes): Uint256 {
-  const pm = IPositionManager.at(positionManagerAddress);
-  pm.modifyLiquidities(unlockData, 99999999999);
-  return 1;
-}
-```
-
-- Same interface as addLiquidity but with negative liquidityDelta in the encoded data
-
-## Key Addresses
-
-| Chain     | Contract        | Address                                      |
-| --------- | --------------- | -------------------------------------------- |
-| Ethereum  | PoolManager     | `0x000000000004444c5dc75cB358380D2e3dE08A90` |
-| Ethereum  | UniversalRouter | `0x66a9893cc07d91d95644aedd05d03f95e1dba8af` |
-| Ethereum  | PositionManager | `0xbd216513d74c8cf14cf4747e6aaa6420ff64ee9e` |
-| Arbitrum  | PoolManager     | `0x360e68faccca8ca495c1b759fd9eee466db9fb32` |
-| Arbitrum  | UniversalRouter | `0xa51afafe0263b40edaef0df8781ea9aa03e381a3` |
-| Arbitrum  | PositionManager | `0xd88f38f930b7952f2db2432cb002e7abbf3dd869` |
-| Optimism  | PoolManager     | `0x9a13f98cb987694c9f086b1f5eb990eea8264ec3` |
-| Optimism  | UniversalRouter | `0x851116d9223fabed8e56c0e6b8ad0c31d98b3507` |
-| Optimism  | PositionManager | `0x3c3ea4b57a46241e54610e5f022e5c45859a1017` |
-| Base      | PoolManager     | `0x498581ff718922c3f8e6a244956af099b2652b2b` |
-| Base      | UniversalRouter | `0x6ff5693b99212da76ad316178a184ab56d299b43` |
-| Base      | PositionManager | `0x7c5f5a4bbd8fd63184577525326123b519429bdc` |
-| Polygon   | PoolManager     | `0x67366782805870060151383f4bbff9dab53e5cd6` |
-| Polygon   | UniversalRouter | `0x1095692a6237d83c6a72f3f5efedb9a670c49223` |
-| Polygon   | PositionManager | `0x1ec2ebf4f37e7363fdfe3551602425af0b3ceef9` |
-| BSC       | PoolManager     | `0x28e2ea090877bf75740558f6bfb36a5ffee9e9df` |
-| BSC       | UniversalRouter | `0x1906c1d672b88cd1b9ac7593301ca990f94eae07` |
-| BSC       | PositionManager | `0x7a4a5c919ae2541aed11041a1aeee68f1287f95b` |
-| Avalanche | PoolManager     | `0x06380c0e0912312b5150364b9dc4542ba0dbbc85` |
-| Avalanche | UniversalRouter | `0x94b75331ae8d42c1b61065089b7d48fe14aa73b7` |
-| Avalanche | PositionManager | `0xb74b1f14d2754acfcbbe1a221023a5cf50ab8acd` |
-| Blast     | PoolManager     | `0x1631559198a9e474033433b2958dabc135ab6446` |
-
-## ABI Methods
-
-### UniswapV4PoolManagerABI
-
-- `initialize(tuple(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks), uint160 sqrtPriceX96) -> int24 tick` - Create and initialize a new pool with a starting price
-- `swap(tuple(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks), tuple(bool zeroForOne, int256 amountSpecified, uint160 sqrtPriceLimitX96), bytes hookData) -> int256 delta` - Low-level swap (typically called through UniversalRouter, not directly)
-- `modifyLiquidity(tuple(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks), tuple(int24 tickLower, int24 tickUpper, int256 liquidityDelta, bytes32 salt), bytes hookData) -> (int256 delta, int256 feeDelta)` - Low-level liquidity modification
-
-### UniswapV4UniversalRouterABI
-
-- `execute(bytes commands, bytes[] inputs, uint256 deadline)` - Execute a batch of commands (swap, settle, take, etc.) in sequence
-- `execute(bytes commands, bytes[] inputs)` - The same, with no deadline
-
-### UniswapV4PositionManagerABI
-
-- `modifyLiquidities(bytes unlockData, uint256 deadline)` - Modify one or more liquidity positions in a single transaction
-
-## Notes
-
-- V4 uses a singleton architecture: ALL pools live in a single PoolManager contract, saving gas on multi-hop swaps
-- Hooks: each pool can attach a custom hooks contract that intercepts before/after swap and liquidity events
-- Pool key: `(currency0, currency1, fee, tickSpacing, hooks)` uniquely identifies a pool
-- `currency0` = address(0) means native ETH; V4 supports native ETH directly (no WETH wrapping needed)
-- `zeroForOne`: true = swap currency0 for currency1; false = swap currency1 for currency0
-- `amountSpecified`: positive = exact input; negative = exact output
-- Flash accounting: V4 uses transient storage for balance tracking within a transaction, settling at the end
-- Commands/inputs for the UniversalRouter must be constructed off-chain; this is more complex than V3 but more powerful
-- V4 is the newest Uniswap version; use it for advanced pool logic (custom hooks) or when gas efficiency on multi-hop matters most
-- On Arc (5042) the PositionManager's `WETH9()` is a stub that always reverts with `UnsupportedProtocolError()`. Arc's native coin is USDC at 18 decimals, so a pool keyed on `address(0)` is native USDC, a different currency from the 6-decimal ERC-20 `0x3600000000000000000000000000000000000000` over the same balance

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

@@ -1,62 +0,0 @@
-# UnitFlow V3
-
-Concentrated-liquidity AMM on Arc, forked from Uniswap V3 with native USDC in place of WETH9.
-
-## Category
-
-dex | Chains: Arc (5042)
-
-## SauceScript Functions
-
-### swap
-
-Exact-input single-hop swap through UnitFlowV3Router.
-
-```typescript
-import { UnitFlowV3RouterABI as IRouter } from "./abis";
-
-function main(
-  routerAddress: Address,
-  tokenIn: Address,
-  tokenOut: Address,
-  fee: Uint256,
-  amountIn: Uint256,
-  amountOutMin: Uint256,
-  recipient: Address,
-  deadline: Uint256,
-): Uint256 {
-  const router = IRouter.at(routerAddress);
-  return router.exactInputSingle({
-    tokenIn: tokenIn,
-    tokenOut: tokenOut,
-    fee: fee,
-    recipient: recipient,
-    deadline: deadline,
-    amountIn: amountIn,
-    amountOutMinimum: amountOutMin,
-    sqrtPriceLimitX96: 0,
-  });
-}
-```
-
-- The router has Uniswap V3 SwapRouter's shape: its params include `deadline`
-- `tokenIn` must be `approve`d to the router
-
-## Deployed Addresses
-
-| Chain | Contract          | Address                                      |
-| ----- | ----------------- | -------------------------------------------- |
-| Arc   | UnitFlowV3Factory | `0x5bfBCeb73d39F722B1cB83fD2F11736b28c1Be6d` |
-| Arc   | UnitFlowV3Router  | `0x6fD8351b9596C1F0b2f2479BfA6A171cb3d0f410` |
-| Arc   | Quoter            | `0x5AF6E89F0960Ff375AF84d9911D8153ef6240E34` |
-
-## ABI Reference
-
-- `UnitFlowV3FactoryABI`: `getPool(address tokenA, address tokenB, uint24 fee) returns (address)`, `feeAmountTickSpacing(uint24 fee) returns (int24)`
-- `UnitFlowV3RouterABI`: `exactInputSingle(ExactInputSingleParams) returns (uint256 amountOut)`, `factory() returns (address)`
-- `UnitFlowV3QuoterABI`: `quoteExactInputSingle(address tokenIn, address tokenOut, uint24 fee, uint256 amountIn, uint160 sqrtPriceLimitX96) returns (uint256 amountOut)`; call it with `eth_call`
-
-## Notes
-
-- Pools call back `unitFlowV3SwapCallback`, not `uniswapV3SwapCallback`, so a contract that swaps against a pool directly must implement the renamed callback
-- The GitHub README lists testnet addresses; these mainnet addresses are the defaults in UnitFlow's own app build

package/sdk/src/skills/vertex.md

@@ -1,55 +0,0 @@
-# Vertex
-
-Vertically integrated DEX combining spot, perpetuals, and money markets with an off-chain sequencer for sub-second order matching on Arbitrum.
-
-## Category
-
-perpetuals | Chains: Arbitrum
-
-## Key Operations
-
-- **depositCollateral**: Deposit collateral into Vertex endpoint
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/vertex";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit collateral
-import { EndpointABI as IEndpoint } from "./abis";
-function main(endpointAddress: Address, productId: Uint256, amount: Uint256): Uint256 {
-  const endpoint = IEndpoint.at(endpointAddress);
-  endpoint.depositCollateral(0x000000000000000000000000, productId, amount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract      | Address                                      |
-| -------- | ------------- | -------------------------------------------- |
-| Arbitrum | endpoint      | `0x73eab16c88b9f38d3f2661c9e5875ec0eeee2965` |
-| Arbitrum | clearinghouse | `0x773bb71b0108b060b76746422ee810bfec9a963d` |
-
-## ABI Methods
-
-### EndpointABI
-
-- `depositCollateral(bytes12,uint32,uint128)` - Deposit collateral. Params: subaccountName (bytes12), productId (uint32), amount (uint128)
-- `submitSlowModeTransaction(bytes)` - Submit slow-mode tx (fallback when sequencer is down)
-
-### ClearinghouseABI
-
-- `withdrawCollateral((bytes32 sender, uint32 productId, uint128 amount, uint64 nonce))` - Apply a sequenced WithdrawCollateral transaction; users submit withdrawals through the Endpoint's `submitSlowModeTransaction`
-
-## Notes
-
-- TVL: $100M+. Off-chain sequencer for sub-second order matching
-- Uses subaccount system (bytes12 identifier) for position isolation
-- productId identifies the market (spot or perp)
-- Most trading happens off-chain via sequencer - on-chain methods are for deposits/withdrawals
-- Approve collateral token to endpoint before depositing

package/sdk/src/skills/wormhole.md

@@ -1,76 +0,0 @@
-# Wormhole
-
-Generic cross-chain messaging protocol with guardian-based attestation. Supports token bridging and arbitrary message passing across 30+ chains.
-
-## Category
-
-cross-chain messaging + bridge | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), Avalanche (43114), Arc (5042)
-
-## SauceScript Functions
-
-### bridgeTokens
-
-Transfer tokens cross-chain via the Wormhole TokenBridge.
-
-```typescript
-import { WormholeTokenBridgeABI as ITokenBridge } from "./abis";
-
-function main(
-  tokenBridgeAddress: Address,
-  token: Address,
-  amount: Uint256,
-  recipientChain: Uint256,
-  recipient: Uint256,
-): Uint256 {
-  const bridge = ITokenBridge.at(tokenBridgeAddress);
-  return bridge.transferTokens(token, amount, recipientChain, recipient, 0, 0);
-}
-```
-
-- `token`: ERC-20 token to bridge
-- `recipientChain`: Wormhole chain ID (NOT EVM chain ID). E.g. Ethereum=2, Arbitrum=23, Base=30
-- `recipient`: Destination address as bytes32 (left-padded)
-- `arbiterFee`: Fee for relayer (set to 0 for self-redemption)
-- `nonce`: Unique identifier (set to 0)
-- Requires ERC-20 approval to the TokenBridge
-- Requires native token for Wormhole message fee (sent as msg.value, use `coreBridge.messageFee()` to query)
-
-## Deployed Addresses
-
-| Chain     | Contract    | Address                                      |
-| --------- | ----------- | -------------------------------------------- |
-| Ethereum  | coreBridge  | `0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B` |
-| Ethereum  | tokenBridge | `0x3ee18B2214AFF97000D974cf647E7C347E8fa585` |
-| Arbitrum  | coreBridge  | `0xa5f208e072434bC67592E4C49C1B991BA79BCA46` |
-| Arbitrum  | tokenBridge | `0x0b2402144Bb366A632D14B83F244D2e0e21bD39c` |
-| Optimism  | coreBridge  | `0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722` |
-| Optimism  | tokenBridge | `0x1D68124e65faFC907325e3EDbF8c4d84499DAa8b` |
-| Base      | coreBridge  | `0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6` |
-| Base      | tokenBridge | `0x8d2de8d2f73F1F4cAB472AC9A881C9b123C79627` |
-| Polygon   | coreBridge  | `0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7` |
-| Polygon   | tokenBridge | `0x5a58505a96D1dbf8dF91cB21B54419FC36e93fdE` |
-| Avalanche | coreBridge  | `0x54a8e5f9c4CbA08F9943965859F6c34eAF03E26c` |
-| Avalanche | tokenBridge | `0x0e082F06FF657D94310cB8cE8B0D9a04541d8052` |
-
-## ABI Reference
-
-### WormholeCoreBridgeABI
-
-- `publishMessage(uint32 nonce, bytes payload, uint8 consistencyLevel) returns (uint64 sequence)` [payable] - Publish arbitrary message for guardian attestation
-- `messageFee() returns (uint256)` - Get current message fee (view)
-
-### WormholeTokenBridgeABI
-
-- `transferTokens(address token, uint256 amount, uint16 recipientChain, bytes32 recipient, uint256 arbiterFee, uint32 nonce) returns (uint64 sequence)` [payable] - Bridge tokens to destination chain. Returns sequence number for tracking
-- `completeTransfer(bytes encodedVm)` - Complete transfer on destination by submitting signed VAA (Verified Action Approval)
-- `wrappedAsset(uint16 tokenChainId, bytes32 tokenAddress) returns (address)` - Look up wrapped asset address on current chain (view)
-
-## Notes
-
-- Uses Wormhole chain IDs (NOT EVM chain IDs). E.g. Ethereum=2, BSC=4, Polygon=5, Avalanche=6, Arbitrum=23, Optimism=24, Base=30
-- Two-step process: (1) `transferTokens` on source, (2) `completeTransfer` on destination with signed VAA
-- If `arbiterFee` > 0, any relayer can submit the VAA and earn the fee. Otherwise, recipient must self-redeem
-- Bridged tokens are wrapped versions (e.g. "Wormhole-wrapped USDC") unless using CCTP integration
-- 19 guardians must reach 2/3+1 consensus for message finality (typically 1-15 minutes)
-- Query `messageFee()` on CoreBridge to know how much native token to attach
-- TVL: $3B+. Audited

package/sdk/src/skills/zerox.md

@@ -1,51 +0,0 @@
-# 0x Protocol
-
-DEX aggregation protocol powering swaps across the DeFi ecosystem. Exchange Proxy provides a single entry point for token swaps across multiple sources.
-
-## Category
-
-aggregator | Chains: Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, Base
-
-## Key Operations
-
-- **transformERC20**: Execute a token swap via the Exchange Proxy transformer pipeline
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/zerox";
-```
-
-## SauceScript Examples
-
-```typescript
-// Note: 0x requires off-chain route computation via 0x API before on-chain execution.
-// The transformERC20 function uses transformations array populated from API response.
-```
-
-## Key Addresses
-
-| Chain     | Contract      | Address                                      |
-| --------- | ------------- | -------------------------------------------- |
-| Ethereum  | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-| Arbitrum  | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-| Optimism  | exchangeProxy | `0xDEF1ABE32c034e558Cdd535791643C58a13aCC10` |
-| Polygon   | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-| BSC       | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-| Avalanche | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-| Base      | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` |
-
-## ABI Methods
-
-### ExchangeProxyABI
-
-- `transformERC20(address,address,uint256,uint256,tuple[])` - Execute token swap via transformer pipeline. Payable. Params: inputToken, outputToken, inputTokenAmount, minOutputTokenAmount, transformations (array of Transformation tuples). Returns outputTokenAmount
-  - Transformation tuple: `{ deploymentNonce (uint32), data (bytes) }` - Each transformation specifies a deployed transformer and its calldata
-
-## Notes
-
-- Same Exchange Proxy address across all 7 chains
-- Uses transformer pipeline architecture - each swap is a sequence of transformations
-- Route computation happens via 0x API - transformations array comes from API response
-- Approve inputToken to exchangeProxy before swapping
-- 0x API provides the optimal route, slippage protection, and transformer calldata