@eco-incorp/sauce 0.99.6 → 0.99.8

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)

package/sdk/src/skills/pyth.md

@@ -1,58 +0,0 @@
-# Pyth Network
-
-High-fidelity oracle network providing low-latency price feeds from institutional sources. Uses pull-based model for efficient on-chain price updates.
-
-## Category
-
-oracle | Chains: Ethereum
-
-## Key Operations
-
-- **getPrice**: Read price from Pyth oracle by price feed ID
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/pyth";
-```
-
-## SauceScript Examples
-
-```typescript
-// Get price by feed ID
-import { PythOracleABI as IPythOracle } from "./abis";
-function main(
-  oracleAddress: Address,
-  priceId: Uint256,
-): { price: Uint256; conf: Uint256; expo: Uint256; publishTime: Uint256 } {
-  const oracle = IPythOracle.at(oracleAddress);
-  return oracle.getPrice(priceId);
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract | Address                                      |
-| -------- | -------- | -------------------------------------------- |
-| Ethereum | oracle   | `0x4305FB66699C3B2702D4d05CF36551390A4c69C6` |
-
-## ABI Methods
-
-### PythOracleABI
-
-- `getPrice(bytes32)` - Get price for a feed ID. Params: id (bytes32 price feed identifier). Returns Price tuple: (price int64, conf uint64, expo int32, publishTime uint256)
-  - `price` - Latest price value
-  - `conf` - Confidence interval (uncertainty)
-  - `expo` - Price exponent (e.g. -8 means divide by 10^8)
-  - `publishTime` - When price was published
-- `updatePriceFeeds(bytes[])` - Submit price updates on-chain. Payable (requires update fee). Params: updateData (Pyth price update VAAs from Hermes API)
-- `getUpdateFee(bytes[])` - Get fee required for price update. Params: updateData. Returns feeAmount in wei
-
-## Notes
-
-- Pull-based oracle: users must call updatePriceFeeds before reading prices
-- Sub-second latency from institutional market data providers
-- Actual price = price * 10^expo (e.g. price=12345, expo=-2 means $123.45)
-- Price feed IDs are bytes32 - see Pyth docs for specific feed IDs per asset
-- updatePriceFeeds requires sending ETH to pay the update fee (use getUpdateFee to check)
-- Get price update data from Pyth Hermes API off-chain, then submit on-chain

package/sdk/src/skills/reflexer.md

@@ -1,73 +0,0 @@
-# Reflexer
-
-Non-pegged stablecoin protocol issuing RAI. Uses a PID controller to dampen RAI price volatility against ETH collateral.
-
-## Category
-
-cdp | Chains: Ethereum
-
-## Key Operations
-
-- **exitRai**: Exit RAI from the system (withdraw RAI tokens)
-- **joinRai**: Join RAI into the system (deposit RAI tokens)
-
-## SDK Usage
-
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/reflexer";
-```
-
-## SauceScript Examples
-
-```typescript
-// Exit RAI from system
-import { CoinJoinABI as ICoinJoin } from "./abis";
-function main(coinJoinAddress: Address, account: Address, amount: Uint256): Uint256 {
-  const coinJoin = ICoinJoin.at(coinJoinAddress);
-  coinJoin.exit(account, amount);
-  return 1;
-}
-
-// Join RAI into system
-import { CoinJoinABI as ICoinJoin } from "./abis";
-function main(coinJoinAddress: Address, account: Address, amount: Uint256): Uint256 {
-  const coinJoin = ICoinJoin.at(coinJoinAddress);
-  coinJoin.join(account, amount);
-  return 1;
-}
-```
-
-## Key Addresses
-
-| Chain    | Contract   | Address                                      |
-| -------- | ---------- | -------------------------------------------- |
-| Ethereum | rai        | `0x03ab458634910AaD20eF5f1C8ee96F1D6ac54919` |
-| Ethereum | safeEngine | `0xCC88a9d330da1133Df3A7bD823B95e52511A6962` |
-| Ethereum | ethJoin    | `0x2D3cD7b81c93f188F3CB8aD87c8Acc73d6226e3a` |
-| Ethereum | coinJoin   | `0x0A5653CCa4DB1B6E265F47CAf6969e64f1CFdC45` |
-
-## ABI Methods
-
-### SAFEEngineABI
-
-- `modifySAFECollateralization(bytes32,address,address,address,int256,int256)` - Modify SAFE position. Params: collateralType (bytes32 identifier), safe (SAFE owner), collateralSource, debtDestination, deltaCollateral (positive=add, negative=remove), deltaDebt (positive=borrow, negative=repay)
-- `safes(bytes32,address)` - Query SAFE position. Params: collateralType, safe address. Returns (lockedCollateral, generatedDebt)
-
-### CoinJoinABI
-
-- `join(address,uint256)` - Join RAI into system (deposit). Params: account, wad (RAI amount, 18 decimals)
-- `exit(address,uint256)` - Exit RAI from system (withdraw). Params: account, wad
-
-### ETHJoinABI
-
-- `join(address account, uint256 wad)` - Join WETH as collateral (the `ethJoin` deployment is a CollateralJoin for WETH; approve WETH first)
-- `exit(address,uint256)` - Exit ETH collateral. Params: account, wad (ETH amount)
-
-## Notes
-
-- RAI is non-pegged, floating around $3 - NOT a $1 stablecoin
-- PID controller adjusts the redemption rate to dampen RAI price volatility
-- Inspired by MakerDAO but with a non-pegged design philosophy
-- SAFEs (similar to MakerDAO Vaults) hold ETH collateral backing RAI debt
-- coinJoin converts between internal system debt units and external RAI ERC-20
-- ethJoin converts between ETH and internal collateral accounting