@eco-incorp/sauce 0.99.5 → 0.99.7

package/sdk/src/skills/maker.md

@@ -1,79 +0,0 @@
-# Maker
-
-Decentralized credit protocol behind DAI and USDS stablecoins. Users deposit collateral into Vaults to mint/borrow DAI. Includes the DAI Savings Rate (DSR) via sDAI.
-
-## Category
-
-cdp | Chains: Ethereum
-
-## Key Operations
-
-- **depositToSDAI**: Deposit DAI into Savings DAI vault (ERC-4626)
-- **withdrawFromSDAI**: Withdraw DAI from sDAI vault by asset amount
-- **redeemFromSDAI**: Redeem sDAI shares for DAI
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/maker";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit DAI into sDAI
-import { SavingsDaiABI as ISavingsDai } from "./abis";
-function main(sDAIAddress: Address, amount: Uint256, receiver: Address): Uint256 {
-  const sDAI = ISavingsDai.at(sDAIAddress);
-  return sDAI.deposit(amount, receiver);
-}
-
-// Withdraw DAI from sDAI
-import { SavingsDaiABI as ISavingsDai } from "./abis";
-function main(sDAIAddress: Address, amount: Uint256, receiver: Address, owner: Address): Uint256 {
-  const sDAI = ISavingsDai.at(sDAIAddress);
-  return sDAI.withdraw(amount, receiver, owner);
-}
-
-// Redeem sDAI shares for DAI
-import { SavingsDaiABI as ISavingsDai } from "./abis";
-function main(sDAIAddress: Address, shares: Uint256, receiver: Address, owner: Address): Uint256 {
-  const sDAI = ISavingsDai.at(sDAIAddress);
-  return sDAI.redeem(shares, receiver, owner);
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | dai      | `0x6B175474E89094C44Da98b954EedeAC495271d0F` |
-| Ethereum | usds     | `0xdC035D45d973E3EC169d2276DDab16f1e407384F` |
-| Ethereum | sDAI     | `0x83F20F44975D03b1b09e64809B757c47f942BEeA` |
-| Ethereum | vat      | `0x35D1b3F3D7966A1DFe207aa4514C12a259A0492B` |
-| Ethereum | pot      | `0x197E90f9FAD81970bA7976f33CbD77088E5D7cf7` |
-
-## ABI Methods
-
-### SavingsDaiABI (ERC-4626)
-
-- `deposit(uint256,address)` - Deposit DAI, receive sDAI shares. Params: assets (DAI amount), receiver. Returns shares minted
-- `withdraw(uint256,address,address)` - Withdraw by DAI amount. Params: assets (DAI to withdraw), receiver, owner. Returns shares burned
-- `redeem(uint256,address,address)` - Redeem sDAI shares. Params: shares (sDAI to burn), receiver, owner. Returns assets (DAI received)
-- `convertToShares(uint256)` - Preview DAI to sDAI conversion. Params: assets. Returns shares
-- `convertToAssets(uint256)` - Preview sDAI to DAI conversion. Params: shares. Returns assets
-
-### PotABI (DSR Engine)
-
-- `join(uint256)` - Join DAI savings (internal). Params: wad (DAI amount in 18 decimals)
-- `exit(uint256)` - Exit DAI savings (internal). Params: wad
-- `chi()` - Current accumulated DSR rate (view). Returns rate accumulator (ray, 27 decimals)
-- `dsr()` - Current DSR per-second rate (view). Returns rate (ray)
-
-## Notes
-
-- TVL: $8B+. sDAI is the preferred way to earn DSR yield (ERC-4626 compliant)
-- DSR yield accrues automatically - sDAI appreciates against DAI over time
-- Approve DAI to sDAI contract before depositing
-- Pot is the internal DSR accumulator - chi() tracks the accumulated rate
-- USDS is the rebranded DAI stablecoin

package/sdk/src/skills/mantle-meth.md

@@ -1,60 +0,0 @@
-# Mantle mETH
-
-Mantle's liquid staking token for Ethereum. Stake ETH and receive mETH, a non-rebasing token that accrues staking rewards over time.
-
-## Category
-
-liquid-staking | Chains: Ethereum
-
-## Key Operations
-
-- **stake**: Stake ETH for mETH with minimum output check
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/mantle-meth";
-```
-
-## SauceScript Examples
-
-```typescript
-// Stake ETH for mETH
-import { METHStakingABI as IStaking } from "./abis";
-function main(stakingAddress: Address, minMETHAmount: Uint256): Uint256 {
-  const staking = IStaking.at(stakingAddress);
-  staking.stake(minMETHAmount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | mETH     | `0xd5F7838F5C461fefF7FE49ea5ebaF7728bB0ADfa` |
-| Ethereum | staking  | `0xe3cBd06D7dadB3F4e6557bAb7EdD924CD1489E8f` |
-
-## ABI Methods
-
-### METHStakingABI
-
-The Staking contract (`staking`), not the token.
-
-- `stake(uint256)` - Stake ETH (payable), receive mETH. Param: minMETHAmount for slippage protection
-- `mETHToETH(uint256)` - Convert mETH amount to ETH value
-- `ethToMETH(uint256)` - Convert ETH amount to mETH value
-
-### METHABI
-
-The mETH token (`mETH`).
-
-- `balanceOf(address)` - Query mETH balance
-- `approve(address,uint256)` - Approve mETH spending
-
-## Notes
-
-- TVL: $1.5B+. Non-rebasing token backed by Mantle treasury
-- stake() is payable - send ETH as msg.value
-- minMETHAmount param provides slippage protection
-- Use mETHToETH()/ethToMETH() to preview exchange rates

package/sdk/src/skills/olympus.md

@@ -1,46 +0,0 @@
-# Olympus DAO
-
-Decentralized reserve currency protocol. OHM staking and bonding mechanism with protocol-owned liquidity and treasury management.
-
-## Category
-
-staking | Chains: Ethereum
-
-## Key Operations
-
-- **stake**: Stake OHM tokens
-- **unstake**: Unstake OHM tokens
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/olympus";
-```
-
-## SauceScript Examples
-
-```typescript
-// Stake OHM
-import { StakingABI as IStaking } from "./abis";
-
-function main(stakingAddress: Address, to: Address, amount: Uint256): Uint256 {
-  const staking = IStaking.at(stakingAddress);
-  return staking.stake(to, amount, 1, 1);
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | ohm      | `0x64aa3364F17a4D01c6f1751Fd97C2BD3D7e7f1D5` |
-| Ethereum | staking  | `0xB63cac384247597756545b500253ff8E607a8020` |
-
-## ABI Methods
-
-- `stake(address,uint256,bool,bool)` - Stake OHM
-- `unstake(address,uint256,bool,bool)` - Unstake OHM
-
-## Notes
-
-- Protocol-owned liquidity model. Rebase mechanism for staking rewards.

package/sdk/src/skills/oneinch.md

@@ -1,64 +0,0 @@
-# 1inch
-
-Leading DEX aggregator that finds optimal swap routes across multiple liquidity sources. Supports limit orders and Fusion mode for gasless swaps.
-
-## Category
-
-aggregator | Chains: Ethereum, Arbitrum, Optimism, Base, Polygon, BSC, Avalanche
-
-## Key Operations
-
-- **unoswap**: Single-source optimized swap via AggregationRouter
-- **swap**: Multi-source aggregated swap with custom routing
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/oneinch";
-```
-
-## SauceScript Examples
-
-```typescript
-// Unoswap (single-source swap)
-import { AggregationRouterV6ABI as IAggregationRouterV6 } from "./abis";
-function main(
-  routerAddress: Address,
-  srcToken: Address,
-  amount: Uint256,
-  minReturn: Uint256,
-  dex: Uint256,
-): Uint256 {
-  const router = IAggregationRouterV6.at(routerAddress);
-  return router.unoswap(srcToken, amount, minReturn, dex);
-}
-```
-
-## Key Addresses
-
-| Chain     | Contract            | Address                                      |
-| --------- | ------------------- | -------------------------------------------- |
-| Ethereum  | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| Arbitrum  | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| Optimism  | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| Base      | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| Polygon   | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| BSC       | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-| Avalanche | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` |
-
-## ABI Methods
-
-### AggregationRouterV6ABI
-
-- `swap(address,tuple,bytes)` - Multi-source swap. Params: executor, desc (SwapDescription tuple: srcToken, dstToken, srcReceiver, dstReceiver, amount, minReturnAmount, flags), data (executor calldata). Payable. Returns (returnAmount, spentAmount)
-  - SwapDescription tuple: `{ srcToken, dstToken, srcReceiver, dstReceiver, amount, minReturnAmount, flags }`
-- `unoswap(uint256,uint256,uint256,uint256)` - Single-pool optimized swap. Params: token (source token address as uint256), amount, minReturn, dex (pool address packed with protocol and direction flags). Returns returnAmount
-
-## Notes
-
-- Same contract address across all 7 chains
-- V6 router is the latest version
-- unoswap is gas-efficient for single-pool swaps; swap handles complex multi-hop routes
-- `dex` in unoswap packs the pool address with its protocol and swap-direction flags in the high bits
-- Fusion mode enables gasless swaps via order matching (off-chain, not in ABI)
-- Approve srcToken to aggregationRouterV6 before swapping

package/sdk/src/skills/openocean.md

@@ -1,86 +0,0 @@
-# OpenOcean
-
-Cross-chain DEX aggregator providing optimal swap routing across multiple DEXes and chains.
-
-## Category
-
-aggregator | Chains: Ethereum, Arbitrum, Optimism, BSC, Polygon, Avalanche, Fantom
-
-## Key Operations
-
-- **swap**: Execute aggregated swap via OpenOcean Exchange
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/openocean";
-```
-
-## SauceScript Examples
-
-```typescript
-// Swap via OpenOcean
-import { OpenOceanExchangeV2ABI as IOpenOceanExchange } from "./abis";
-function main(
-  exchangeAddress: Address,
-  caller: Address,
-  srcToken: Address,
-  dstToken: Address,
-  srcReceiver: Address,
-  dstReceiver: Address,
-  amount: Uint256,
-  minReturnAmount: Uint256,
-  guaranteedAmount: Uint256,
-  referrer: Address,
-  calls: { target: Uint256; gasLimit: Uint256; value: Uint256; data: bytes }[],
-): Uint256 {
-  const exchange = IOpenOceanExchange.at(exchangeAddress);
-  return exchange.swap(
-    caller,
-    {
-      srcToken: srcToken,
-      dstToken: dstToken,
-      srcReceiver: srcReceiver,
-      dstReceiver: dstReceiver,
-      amount: amount,
-      minReturnAmount: minReturnAmount,
-      guaranteedAmount: guaranteedAmount,
-      flags: 0,
-      referrer: referrer,
-      permit: 0x00,
-    },
-    calls,
-  );
-}
-```
-
-## Key Addresses
-
-| Chain     | Contract   | Address                                      |
-| --------- | ---------- | -------------------------------------------- |
-| Ethereum  | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| Arbitrum  | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| Optimism  | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| BSC       | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| Polygon   | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| Avalanche | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-| Fantom    | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` |
-
-## ABI Methods
-
-### OpenOceanExchangeV2ABI
-
-- `swap(address,tuple,tuple[])` - Execute aggregated swap. Payable. Params: caller (msg.sender or executor), desc (SwapDescription tuple), calls (CallDescription[]: `(uint256 target, uint256 gasLimit, uint256 value, bytes data)`). Returns returnAmount
-  - SwapDescription tuple: `{ srcToken, dstToken, srcReceiver, dstReceiver, amount, minReturnAmount, guaranteedAmount, flags, referrer, permit }`
-  - `srcReceiver` - address that receives srcToken from caller
-  - `dstReceiver` - address that receives output tokens
-  - `guaranteedAmount` - guaranteed minimum output (can differ from minReturnAmount)
-  - `flags` - swap behavior flags (0 for default)
-  - `permit` - EIP-2612 permit data (0x00 if pre-approved)
-
-## Notes
-
-- TVL: $200M+. Same contract address across all 7 supported chains
-- Route computation via OpenOcean API - calls parameter comes from API response
-- Approve srcToken to exchangeV2 before swapping
-- caller is typically msg.sender; srcReceiver receives tokens from the caller

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

@@ -1,104 +0,0 @@
-# PancakeSwap V3
-
-Concentrated liquidity AMM on BNB Chain and multiple EVM chains. Built on Uniswap V3 architecture with custom fee tiers and farming integration via the SmartRouter.
-
-## Category
-
-dex | Chains: BSC, Ethereum, Arbitrum, Base, Linea
-
-## Key Operations
-
-- **swap**: Exact input single-hop swap with fee tier selection via SmartRouter
-
-## SDK Usage
-
-```typescript
-import {
-  protocolInfo,
-  deployments,
-  sauceFunctions,
-} from "@eco-incorp/sauce/protocols/pancakeswap-v3";
-```
-
-## SauceScript Examples
-
-### swap
-
-```typescript
-import { PancakeSwapV3SmartRouterABI as ISmartRouter } from "./abis";
-
-function main(
-  routerAddress: Address,
-  tokenIn: Address,
-  tokenOut: Address,
-  fee: Uint256,
-  amountIn: Uint256,
-  amountOutMin: Uint256,
-  recipient: Address,
-): Uint256 {
-  const router = ISmartRouter.at(routerAddress);
-  return router.exactInputSingle({
-    tokenIn: tokenIn,
-    tokenOut: tokenOut,
-    fee: fee,
-    recipient: recipient,
-    amountIn: amountIn,
-    amountOutMinimum: amountOutMin,
-    sqrtPriceLimitX96: 0,
-  });
-}
-```
-
-- `routerAddress`: PancakeSwap V3 SmartRouter address for the target chain
-- `tokenIn` / `tokenOut`: Input and output token addresses
-- `fee`: Pool fee tier in hundredths of a bip. Common: `100` (0.01%), `500` (0.05%), `2500` (0.25%), `10000` (1%)
-- `amountIn`: Exact input amount (in wei)
-- `amountOutMin`: Minimum output for slippage protection
-- `recipient`: Address to receive output tokens
-- `sqrtPriceLimitX96`: Set to `0` to accept any price
-- Note: SmartRouter does NOT include a `deadline` param in the struct (unlike Uniswap V3)
-
-## Key Addresses
-
-| Chain    | Contract    | Address                                      |
-| -------- | ----------- | -------------------------------------------- |
-| BSC      | Factory     | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` |
-| BSC      | SmartRouter | `0x13f4EA83D0bd40E75C8222255bc855a974568Dd4` |
-| BSC      | NFPM        | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` |
-| Ethereum | Factory     | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` |
-| Ethereum | SmartRouter | `0x13f4EA83D0bd40E75C8222255bc855a974568Dd4` |
-| Ethereum | NFPM        | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` |
-| Arbitrum | Factory     | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` |
-| Arbitrum | SmartRouter | `0x32226588378236Fd0c7c4053999F88aC0e5cAc77` |
-| Arbitrum | NFPM        | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` |
-| Base     | Factory     | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` |
-| Base     | SmartRouter | `0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86` |
-| Base     | NFPM        | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` |
-| Linea    | Factory     | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` |
-| Linea    | SmartRouter | `0x678Aa4bF4E210cf2166753e054d5b7c31cc7fa86` |
-| Linea    | NFPM        | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` |
-
-## ABI Methods
-
-### PancakeSwapV3SmartRouterABI
-
-- `exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96)) -> uint256 amountOut` - Single-hop swap with exact input amount
-- `exactOutputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96)) -> uint256 amountIn` - Single-hop swap specifying exact output desired
-
-### PancakeSwapV3FactoryABI
-
-- `getPool(address tokenA, address tokenB, uint24 fee) -> address pool` - Look up pool address for token pair and fee tier (view)
-
-### PancakeSwapV3NFPMABI
-
-- `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 concentrated liquidity position NFT
-
-## Notes
-
-- Fee tiers may differ from Uniswap V3; PancakeSwap includes a 2500 (0.25%) tier
-- SmartRouter struct does NOT include `deadline` (unlike Uniswap V3's router)
-- Factory address is the same across all chains; SmartRouter addresses vary
-- NFPM address is consistent across all chains (`0x46A15B...`)
-- Input token must be ERC20-approved to the SmartRouter for swaps
-- Both tokens must be ERC20-approved to the NFPM for minting positions
-- Prefer V3 over V2 for major pairs on BSC for better capital efficiency

package/sdk/src/skills/paraswap.md

@@ -1,67 +0,0 @@
-# ParaSwap
-
-Multi-chain DEX aggregator optimizing swap rates across decentralized exchanges. Supports limit orders and delta algorithm for MEV protection.
-
-## Category
-
-aggregator | Chains: Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, Base
-
-## Key Operations
-
-- **simpleSwap**: Execute a simple single-path swap via Augustus router
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/paraswap";
-```
-
-## SauceScript Examples
-
-```typescript
-// Note: ParaSwap requires off-chain route computation via API before on-chain execution.
-// The simpleSwap function uses complex tuple params populated from API response.
-```
-
-## Key Addresses
-
-| Chain     | Contract   | Address                                      |
-| --------- | ---------- | -------------------------------------------- |
-| Ethereum  | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| Ethereum  | augustusV6 | `0x6A000F20005980200259B80c5102003040001068` |
-| Arbitrum  | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| Arbitrum  | augustusV6 | `0x6A000F20005980200259B80c5102003040001068` |
-| Optimism  | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| Polygon   | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| BSC       | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| Avalanche | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-| Base      | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` |
-
-## ABI Methods
-
-### AugustusV5ABI
-
-- `simpleSwap(tuple)` - Simple single-path swap. Payable. Returns receivedAmount. Tuple params:
-  - `fromToken` (address) - Source token
-  - `toToken` (address) - Destination token
-  - `fromAmount` (uint256) - Input amount
-  - `toAmount` (uint256) - Expected output
-  - `expectedAmount` (uint256) - Expected amount for positive slippage tracking
-  - `callees` (address[]) - DEX contracts to call
-  - `exchangeData` (bytes) - Encoded calldata for each callee
-  - `startIndexes` (uint256[]) - Byte offsets in exchangeData for each callee
-  - `values` (uint256[]) - ETH values for each callee call
-  - `beneficiary` (address) - Recipient of output tokens
-  - `partner` (address) - Partner/referrer address
-  - `feePercent` (uint256) - Fee percentage
-  - `permit` (bytes) - EIP-2612 permit data (empty if pre-approved)
-  - `deadline` (uint256) - Transaction deadline
-  - `uuid` (bytes16) - Unique swap identifier
-
-## Notes
-
-- Augustus V5 and V6 both deployed on all chains
-- Delta algorithm protects against MEV/sandwich attacks
-- Route computation happens off-chain via ParaSwap API - callees/exchangeData come from API
-- Approve srcToken to Augustus contract before swapping
-- V6 is newer but V5 is more widely integrated

package/sdk/src/skills/permit2.md

@@ -1,73 +0,0 @@
-# Permit2
-
-Universal token approval infrastructure by Uniswap. Provides a single approval contract for all DeFi protocols, improving security and UX.
-
-## Category
-
-infrastructure | Chains: Ethereum, Arbitrum, Optimism, Base, Polygon, BSC, Avalanche, Arc
-
-## Key Operations
-
-- **approve**: Set token allowance for a spender via Permit2
-- **transferFrom**: Transfer tokens using a Permit2 allowance
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/permit2";
-```
-
-## SauceScript Examples
-
-```typescript
-// Approve token via Permit2
-import { Permit2ABI as IPermit2 } from "./abis";
-function main(
-  permit2Address: Address,
-  token: Address,
-  spender: Address,
-  amount: Uint256,
-  expiration: Uint256,
-): Uint256 {
-  const permit2 = IPermit2.at(permit2Address);
-  permit2.approve(token, spender, amount, expiration);
-  return 1;
-}
-
-// Transfer tokens using Permit2 allowance
-import { Permit2ABI as IPermit2 } from "./abis";
-function main(
-  permit2Address: Address,
-  from: Address,
-  to: Address,
-  amount: Uint256,
-  token: Address,
-): Uint256 {
-  const permit2 = IPermit2.at(permit2Address);
-  permit2.transferFrom(from, to, amount, token);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain        | Contract | Address                                      |
-| ------------ | -------- | -------------------------------------------- |
-| All 7 chains | permit2  | `0x000000000022D473030F116dDEE9F6B43aC78BA3` |
-
-## ABI Methods
-
-### Permit2ABI
-
-- `approve(address,address,uint160,uint48)` - Set token allowance. Params: token, spender, amount (uint160 max), expiration (uint48 unix timestamp). No return value
-- `transferFrom(address,address,uint160,address)` - Transfer using allowance. Params: from, to, amount (uint160), token. No return value
-- `lockdown(tuple[])` - Revoke all approvals for specified token/spender pairs. Params: approvals (array of {token, spender} tuples). Emergency function to revoke compromised approvals
-
-## Notes
-
-- Same address on all 7 chains (deterministic CREATE2 deployment)
-- Approve once: ERC-20 approve to Permit2, then use Permit2 to manage per-protocol allowances
-- amount is uint160 (not uint256) - max value is type(uint160).max
-- expiration is uint48 unix timestamp - approvals auto-expire for security
-- Uniswap V3/V4, 1inch, and many protocols use Permit2 for token transfers
-- lockdown is an emergency function to batch-revoke compromised approvals

package/sdk/src/skills/perpetual-protocol.md

@@ -1,73 +0,0 @@
-# Perpetual Protocol
-
-Decentralized perpetual futures exchange (Curie v2) on Optimism. Concentrated-liquidity virtual AMM with cross-margin trading.
-
-## Category
-
-perpetuals | Chains: Optimism
-
-## Key Operations
-
-- **deposit**: Deposit collateral into Vault for trading
-- **withdraw**: Withdraw collateral from Vault
-- **openPosition**: Open a leveraged perpetual position
-- **closePosition**: Close an existing perpetual position
-
-## SDK Usage
-
-```typescript
-import {
-  protocolInfo,
-  deployments,
-  sauceFunctions,
-} from "@eco-incorp/sauce/protocols/perpetual-protocol";
-```
-
-## SauceScript Examples
-
-```typescript
-// Deposit collateral
-import { VaultABI as IVault } from "./abis";
-function main(vaultAddress: Address, token: Address, amount: Uint256): Uint256 {
-  const vault = IVault.at(vaultAddress);
-  vault.deposit(token, amount);
-  return 1;
-}
-
-// Withdraw collateral
-import { VaultABI as IVault } from "./abis";
-function main(vaultAddress: Address, token: Address, amount: Uint256): Uint256 {
-  const vault = IVault.at(vaultAddress);
-  vault.withdraw(token, amount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract      | Address                                      |
-| -------- | ------------- | -------------------------------------------- |
-| Optimism | clearingHouse | `0x82ac2CE43e33683c58BE4cDc40975E73aA50f459` |
-| Optimism | vault         | `0xAD7b4C162707E0B2b5f6fdDbD3f8538A5fbA0d60` |
-
-## ABI Methods
-
-### ClearingHouseABI
-
-- `openPosition((address,bool,bool,uint256,uint256,uint256,uint160,bytes32))` - Open leveraged position. One params struct: baseToken (market), isBaseToQuote (true=short, false=long), isExactInput (true=exact input amount), amount (trade amount), oppositeAmountBound (slippage limit), deadline (tx deadline), sqrtPriceLimitX96 (price limit, 0 for none), referralCode. Returns (base, quote)
-- `closePosition((address,uint160,uint256,uint256,bytes32))` - Close position. One params struct: baseToken, sqrtPriceLimitX96 (0 for market), oppositeAmountBound (slippage), deadline, referralCode. Returns (base, quote)
-- `getAccountValue(address)` - Get account value. Params: trader. Returns int256 value
-
-### VaultABI
-
-- `deposit(address,uint256)` - Deposit collateral. Params: token (USDC etc.), amount
-- `withdraw(address,uint256)` - Withdraw collateral. Params: token, amount
-- `getFreeCollateral(address)` - Query available collateral. Params: trader. Returns free collateral amount
-
-## Notes
-
-- Virtual AMM (vAMM) based pricing - no actual liquidity pools
-- Cross-margin trading - all positions share the same collateral
-- isBaseToQuote: true = short (sell base for quote), false = long (buy base with quote)
-- Deposit collateral to Vault first, then trade via ClearingHouse
-- sqrtPriceLimitX96 = 0 means no price limit (market order)