@eco-incorp/sauce 0.99.6 → 0.99.8

package/skills/sauce-protocols/references/registry/curve.md

@@ -0,0 +1,81 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Curve Finance (`curve`)
+
+StableSwap AMM optimized for low-slippage swaps between pegged assets (stablecoins, wrapped tokens).
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | none |
+| Namespace | `Curve` on ethereum, optimism, gnosis, polygon, fantom, base, arbitrum, avalanche |
+| Chains | ethereum, optimism, gnosis, polygon, fantom, base, arbitrum, avalanche |
+| Document | [curve.md](../curve.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Curve` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's addressProvider, `0x0000000022D53366457F9d5E68Ec105046FC4383`.
+  require(Curve.AddressProvider != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | crvToken | `0xD533a949740bb3306d119CC777fa900bA034cd52` | `Curve.CrvToken` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | routerNG | `0x16C6521Dff6baB339122a0FE25a9116693265353` | `Curve.RouterNG` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | threePool | `0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7` | `Curve.ThreePool` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | routerNG | `0x0DCDED3545D565bA3B19E683431381007245d983` | `Curve.RouterNG` |
+| [Gnosis](../../../sauce-chains/references/gnosis.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Fantom](../../../sauce-chains/references/fantom.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Base](../../../sauce-chains/references/base.md) | routerNG | `0x4f37A9d177470499A2dD084621020b023fcffc1F` | `Curve.RouterNG` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | routerNG | `0x2191718CD32d02B8E60BAdFFeA33E4B5DD9A0A0D` | `Curve.RouterNG` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+
+## ABI
+
+### `CurveAddressProviderABI`
+
+`import CurveAddressProviderABI from "./protocols/curve/CurveAddressProviderABI.json";` Speaks for: addressProvider.
+
+- `get_registry() view returns (address)`
+- `get_address(uint256 _id) view returns (address)`
+
+### `CurveRouterNGABI`
+
+`import CurveRouterNGABI from "./protocols/curve/CurveRouterNGABI.json";` Speaks for: routerNG.
+
+- `exchange(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, uint256 _expected, address[5] _pools) payable returns (uint256)`
+- `exchange(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, uint256 _min_dy, address[5] _pools, address _receiver) payable returns (uint256)`
+- `get_dy(address[11] _route, uint256[5][5] _swap_params, uint256 _amount, address[5] _pools) view returns (uint256)`
+
+### `CurveStableSwapABI`
+
+`import CurveStableSwapABI from "./protocols/curve/CurveStableSwapABI.json";`
+
+- `exchange(int128 i, int128 j, uint256 dx, uint256 min_dy) returns (uint256)`
+- `exchange_underlying(int128 i, int128 j, uint256 dx, uint256 min_dy) returns (uint256)`
+- `add_liquidity(uint256[] amounts, uint256 min_mint_amount) returns (uint256)`
+- `remove_liquidity(uint256 _amount, uint256[] min_amounts) returns (uint256[])`
+- `remove_liquidity_one_coin(uint256 _token_amount, int128 i, uint256 min_amount) returns (uint256)`
+- `get_dy(int128 i, int128 j, uint256 dx) view returns (uint256)`
+- `get_virtual_price() view returns (uint256)`
+
+### `CurveThreePoolABI`
+
+`import CurveThreePoolABI from "./protocols/curve/CurveThreePoolABI.json";` Speaks for: threePool.
+
+- `exchange(int128 i, int128 j, uint256 dx, uint256 min_dy)`
+- `add_liquidity(uint256[3] amounts, uint256 min_mint_amount)`
+- `remove_liquidity(uint256 _amount, uint256[3] min_amounts)`
+- `remove_liquidity_one_coin(uint256 _token_amount, int128 i, uint256 min_amount)`
+- `get_dy(int128 i, int128 j, uint256 dx) view returns (uint256)`
+- `get_virtual_price() view returns (uint256)`

package/skills/sauce-protocols/references/registry/debridge.md

@@ -0,0 +1,59 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# deBridge (`debridge`)
+
+Cross-chain trading infrastructure with DLN (DeBridge Liquidity Network). Supports limit orders and market makers for cross-chain swaps.
+
+| Fact | Value |
+| --- | --- |
+| Category | Bridges |
+| Family | none |
+| Namespace | `Debridge` on ethereum, optimism, bsc, polygon, arc, base, arbitrum, avalanche |
+| Chains | ethereum, optimism, bsc, polygon, arc, base, arbitrum, avalanche |
+| Document | [debridge.md](../debridge.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Debridge` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's dlnDestination, `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f`.
+  require(Debridge.DlnDestination != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Arc](../../../sauce-chains/references/arc.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Arc](../../../sauce-chains/references/arc.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Base](../../../sauce-chains/references/base.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Base](../../../sauce-chains/references/base.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+
+## ABI
+
+### `DlnDestinationABI`
+
+`import DlnDestinationABI from "./protocols/debridge/DlnDestinationABI.json";` Speaks for: dlnDestination.
+
+- `fulfillOrder((uint64 makerOrderNonce, bytes makerSrc, uint256 giveChainId, bytes giveTokenAddress, uint256 giveAmount, uint256 takeChainId, bytes takeTokenAddress, uint256 takeAmount, bytes receiverDst, bytes givePatchAuthoritySrc, bytes orderAuthorityAddressDst, bytes allowedTakerDst, bytes allowedCancelBeneficiarySrc, bytes externalCall) _order, uint256 _fulFillAmount, bytes32 _orderId, bytes _permitEnvelope, address _unlockAuthority) payable`
+
+### `DlnSourceABI`
+
+`import DlnSourceABI from "./protocols/debridge/DlnSourceABI.json";` Speaks for: dlnSource.
+
+- `createOrder((address giveTokenAddress, uint256 giveAmount, bytes takeTokenAddress, uint256 takeAmount, uint256 takeChainId, bytes receiverDst, address givePatchAuthoritySrc, bytes orderAuthorityAddressDst, bytes allowedTakerDst, bytes externalCall, bytes allowedCancelBeneficiarySrc) _orderCreation, bytes _affiliateFee, uint32 _referralCode, bytes _permitEnvelope) payable returns (bytes32 orderId)`

package/skills/sauce-protocols/references/registry/dodo.md

@@ -0,0 +1,39 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# DODO (`dodo`)
+
+Proactive market maker (PMM) DEX with capital-efficient liquidity provision. Features single-token LP, customizable price curves, and smart routing.
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | none |
+| Namespace | `Dodo` on ethereum, bsc |
+| Chains | ethereum, bsc |
+| Document | [dodo.md](../dodo.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Dodo` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's dodoV2Proxy, `0xa356867fDCeA8e71AEaf87805808803806231FDc`.
+  require(Dodo.DODOV2Proxy != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | dodoV2Proxy | `0xa356867fDCeA8e71AEaf87805808803806231FDc` | `Dodo.DODOV2Proxy` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | dodoV2Proxy | `0x8F8Dd7DB1bDA5eD3da8C9dAf3bFA471c12d58486` | `Dodo.DODOV2Proxy` |
+
+## ABI
+
+### `DODOV2ProxyABI`
+
+`import DODOV2ProxyABI from "./protocols/dodo/DODOV2ProxyABI.json";` Speaks for: dodoV2Proxy.
+
+- `dodoSwapV2TokenToToken(address fromToken, address toToken, uint256 fromTokenAmount, uint256 minReturnAmount, address[] dodoPairs, uint256 directions, bool isIncentive, uint256 deadLine) returns (uint256 returnAmount)`

package/skills/sauce-protocols/references/registry/eco-routes.md

@@ -0,0 +1,65 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Eco Routes (`eco-routes`)
+
+Eco's cross-chain intent protocol. A Portal publishes an intent, escrows its reward in a per-intent vault, and pays a solver who fulfills the route on the destination chain; a prover carries the proof of that fulfillment back. This is the layer Sauce intents are built on.
+
+| Fact | Value |
+| --- | --- |
+| Category | Infrastructure and standards |
+| Family | none |
+| Namespace | `EcoRoutes` on ethereum, optimism, unichain, polygon, monad, ronin, arc, base, plasma, arbitrum |
+| Chains | none recorded |
+| Document | none |
+
+## In a program
+
+The registry records no deployment: `PortalABI` is an interface, bound to an address the
+program is given.
+
+```sauce chain=ethereum
+import PortalABI from "./protocols/eco-routes/PortalABI.json";
+
+const TARGET = 0n; // the contract's address, as a define
+
+function main() {
+  const target = PortalABI.at(TARGET);
+}
+```
+
+## ABI
+
+### `PortalABI`
+
+`import PortalABI from "./protocols/eco-routes/PortalABI.json";` Speaks for: Portal.
+
+- `publish(uint64 destination, bytes route, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward) returns (bytes32 intentHash, address vault)`
+- `publishAndFund(uint64 destination, bytes route, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward, bool allowPartial) payable returns (bytes32 intentHash, address vault)`
+- `fund(uint64 destination, bytes32 routeHash, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward, bool allowPartial) payable returns (bytes32 intentHash)`
+- `fulfill(bytes32 intentHash, (bytes32 salt, uint64 deadline, address portal, uint256 nativeAmount, (address token, uint256 amount)[] tokens, (address target, bytes data, uint256 value)[] calls) route, bytes32 rewardHash, bytes32 claimant) payable returns (bytes[])`
+- `getIntentHash(uint64 destination, bytes route, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward) pure returns (bytes32 intentHash, bytes32 routeHash, bytes32 rewardHash)`
+- `intentVaultAddress(uint64 destination, bytes route, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward) view returns (address)`
+- `isIntentFunded(uint64 destination, bytes route, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward) view returns (bool)`
+- `getRewardStatus(bytes32 intentHash) view returns (uint8)`
+- `executor() view returns (address)`
+- `claimants(bytes32 intentHash) view returns (bytes32)`
+- `fulfillAndProve(bytes32 intentHash, (bytes32 salt, uint64 deadline, address portal, uint256 nativeAmount, (address token, uint256 amount)[] tokens, (address target, bytes data, uint256 value)[] calls) route, bytes32 rewardHash, bytes32 claimant, address prover, uint64 sourceChainDomainID, bytes data) payable returns (bytes[])`
+- `prove(address prover, uint64 sourceChainDomainID, bytes32[] intentHashes, bytes data) payable`
+- `withdraw(uint64 destination, bytes32 routeHash, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward)`
+- `batchWithdraw(uint64[] destinations, bytes32[] routeHashes, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens)[] rewards)`
+- `refund(uint64 destination, bytes32 routeHash, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward)`
+- `refundTo(uint64 destination, bytes32 routeHash, (uint64 deadline, address creator, address prover, uint256 nativeAmount, (address token, uint256 amount)[] tokens) reward, address refundee)`
+- `cancel(bytes32 intentHash, (bytes32 salt, uint64 deadline, address portal, uint256 nativeAmount, (address token, uint256 amount)[] tokens, (address target, bytes data, uint256 value)[] calls) route, bytes32 rewardHash)`
+- `cancelAndProve(bytes32 intentHash, (bytes32 salt, uint64 deadline, address portal, uint256 nativeAmount, (address token, uint256 amount)[] tokens, (address target, bytes data, uint256 value)[] calls) route, bytes32 rewardHash, address prover, uint64 sourceChainDomainID, bytes data) payable`
+- `version() pure returns (string)`
+
+### `ProverABI`
+
+`import ProverABI from "./protocols/eco-routes/ProverABI.json";` Speaks for: HyperProver, MetaProver, PolymerProver, LayerZeroProver.
+
+- `provenIntents(bytes32 intentHash) view returns ((address claimant, uint64 destination))`
+- `getProofType() pure returns (string)`
+- `version() pure returns (string)`
+- `PORTAL() view returns (address)`
+- `isWhitelisted(bytes32 addr) view returns (bool)`
+- `fetchFee(uint64 domainID, bytes encodedProofs, bytes data) view returns (uint256)`

package/skills/sauce-protocols/references/registry/eigenlayer.md

@@ -0,0 +1,58 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# EigenLayer (`eigenlayer`)
+
+Restaking protocol that enables staked ETH to secure additional protocols. Deposit LSTs into strategies to earn restaking rewards.
+
+| Fact | Value |
+| --- | --- |
+| Category | Restaking |
+| Family | none |
+| Namespace | `Eigenlayer` on ethereum |
+| Chains | ethereum |
+| Document | [eigenlayer.md](../eigenlayer.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Eigenlayer` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's cbETHStrategy, `0x54945180dB7943c0ed0FEE7EdaB2Bd24620256bc`.
+  require(Eigenlayer.CbETHStrategy != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | cbETHStrategy | `0x54945180dB7943c0ed0FEE7EdaB2Bd24620256bc` | `Eigenlayer.CbETHStrategy` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | delegationManager | `0x39053D51B77DC0d36036Fc1fCc8Cb819df8Ef37A` | `Eigenlayer.DelegationManager` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | rETHStrategy | `0x1BeE69b7dFFfA4E2d53C2a2Df135C388AD25dCD2` | `Eigenlayer.RETHStrategy` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | stETHStrategy | `0x93c4b944D05dfe6df7645A86cd2206016c51564D` | `Eigenlayer.StETHStrategy` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | strategyManager | `0x858646372CC42E1A627fcE94aa7A7033e7CF075A` | `Eigenlayer.StrategyManager` |
+
+## ABI
+
+### `DelegationManagerABI`
+
+`import DelegationManagerABI from "./protocols/eigenlayer/DelegationManagerABI.json";` Speaks for: delegationManager.
+
+- `delegateTo(address operator, (bytes signature, uint256 expiry) approverSignatureAndExpiry, bytes32 approverSalt)`
+- `undelegate(address staker) returns (bytes32[] withdrawalRoots)`
+- `isDelegated(address staker) view returns (bool)`
+
+### `StrategyABI`
+
+`import StrategyABI from "./protocols/eigenlayer/StrategyABI.json";` Speaks for: stETHStrategy, rETHStrategy, cbETHStrategy.
+
+- `sharesToUnderlyingView(uint256 amountShares) view returns (uint256)`
+- `underlyingToSharesView(uint256 amountUnderlying) view returns (uint256)`
+
+### `StrategyManagerABI`
+
+`import StrategyManagerABI from "./protocols/eigenlayer/StrategyManagerABI.json";` Speaks for: strategyManager.
+
+- `depositIntoStrategy(address strategy, address token, uint256 amount) returns (uint256 shares)`
+- `stakerDepositShares(address staker, address strategy) view returns (uint256 shares)`

package/skills/sauce-protocols/references/registry/ens.md

@@ -0,0 +1,49 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ENS (`ens`)
+
+Ethereum Name Service - the decentralized naming system for wallets, websites, and resources. Maps human-readable names to Ethereum addresses.
+
+| Fact | Value |
+| --- | --- |
+| Category | Infrastructure and standards |
+| Family | none |
+| Namespace | `Ens` on ethereum |
+| Chains | ethereum |
+| Document | [ens.md](../ens.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Ens` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's baseRegistrar, `0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85`.
+  require(Ens.BaseRegistrar != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | baseRegistrar | `0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85` | `Ens.BaseRegistrar` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | registry | `0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e` | `Ens.Registry` |
+
+## ABI
+
+### `BaseRegistrarABI`
+
+`import BaseRegistrarABI from "./protocols/ens/BaseRegistrarABI.json";` Speaks for: baseRegistrar.
+
+- `nameExpires(uint256 id) view returns (uint256)`
+- `reclaim(uint256 id, address owner)`
+
+### `ENSRegistryABI`
+
+`import ENSRegistryABI from "./protocols/ens/ENSRegistryABI.json";` Speaks for: registry.
+
+- `owner(bytes32 node) view returns (address)`
+- `resolver(bytes32 node) view returns (address)`
+- `setOwner(bytes32 node, address owner)`
+- `setResolver(bytes32 node, address resolver)`

package/skills/sauce-protocols/references/registry/erc20.md

@@ -0,0 +1,44 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ERC20 (`erc20`)
+
+The ERC-20 token standard interface. Defines the common API for fungible tokens on EVM chains: transfer, approve, transferFrom, balanceOf, allowance, totalSupply, name, symbol, decimals.
+
+| Fact | Value |
+| --- | --- |
+| Category | Infrastructure and standards |
+| Family | none |
+| Namespace | none: import its ABI |
+| Chains | none recorded |
+| Document | [erc20.md](../erc20.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+The registry records no deployment: `ERC20ABI` is an interface, bound to an address the
+program is given.
+
+```sauce chain=ethereum
+import ERC20ABI from "./protocols/erc20/ERC20ABI.json";
+
+const TARGET = 0n; // the contract's address, as a define
+
+function main() {
+  const target = ERC20ABI.at(TARGET);
+}
+```
+
+## ABI
+
+### `ERC20ABI`
+
+`import ERC20ABI from "./protocols/erc20/ERC20ABI.json";`
+
+- `transfer(address to, uint256 amount) returns (bool)`
+- `approve(address spender, uint256 amount) returns (bool)`
+- `transferFrom(address from, address to, uint256 amount) returns (bool)`
+- `balanceOf(address account) view returns (uint256)`
+- `allowance(address owner, address spender) view returns (uint256)`
+- `totalSupply() view returns (uint256)`
+- `name() view returns (string)`
+- `symbol() view returns (string)`
+- `decimals() view returns (uint8)`

package/skills/sauce-protocols/references/registry/erc3156.md

@@ -0,0 +1,38 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ERC-3156 (`erc3156`)
+
+Standard interface for flash loans defined in EIP-3156. Provides flashLoan, flashFee, and maxFlashLoan functions that any conforming lender can implement.
+
+| Fact | Value |
+| --- | --- |
+| Category | Infrastructure and standards |
+| Family | none |
+| Namespace | none: import its ABI |
+| Chains | none recorded |
+| Document | [erc3156.md](../erc3156.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+The registry records no deployment: `FlashLenderABI` is an interface, bound to an address the
+program is given.
+
+```sauce chain=ethereum
+import FlashLenderABI from "./protocols/erc3156/FlashLenderABI.json";
+
+const TARGET = 0n; // the contract's address, as a define
+
+function main() {
+  const target = FlashLenderABI.at(TARGET);
+}
+```
+
+## ABI
+
+### `FlashLenderABI`
+
+`import FlashLenderABI from "./protocols/erc3156/FlashLenderABI.json";`
+
+- `flashLoan(address receiver, address token, uint256 amount, bytes data) returns (bool)`
+- `flashFee(address token, uint256 amount) view returns (uint256)`
+- `maxFlashLoan(address token) view returns (uint256)`

package/skills/sauce-protocols/references/registry/erc4626.md

@@ -0,0 +1,51 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ERC-4626 (`erc4626`)
+
+Standard interface for tokenized vaults (EIP-4626). Provides deposit, withdraw, mint, redeem and preview functions that any conforming vault implements.
+
+| Fact | Value |
+| --- | --- |
+| Category | Infrastructure and standards |
+| Family | none |
+| Namespace | none: import its ABI |
+| Chains | none recorded |
+| Document | [erc4626.md](../erc4626.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+The registry records no deployment: `VaultABI` is an interface, bound to an address the
+program is given.
+
+```sauce chain=ethereum
+import VaultABI from "./protocols/erc4626/VaultABI.json";
+
+const TARGET = 0n; // the contract's address, as a define
+
+function main() {
+  const target = VaultABI.at(TARGET);
+}
+```
+
+## ABI
+
+### `VaultABI`
+
+`import VaultABI from "./protocols/erc4626/VaultABI.json";`
+
+- `deposit(uint256 assets, address receiver) returns (uint256 shares)`
+- `mint(uint256 shares, address receiver) returns (uint256 assets)`
+- `withdraw(uint256 assets, address receiver, address owner) returns (uint256 shares)`
+- `redeem(uint256 shares, address receiver, address owner) returns (uint256 assets)`
+- `totalAssets() view returns (uint256)`
+- `convertToShares(uint256 assets) view returns (uint256)`
+- `convertToAssets(uint256 shares) view returns (uint256)`
+- `previewDeposit(uint256 assets) view returns (uint256)`
+- `previewMint(uint256 shares) view returns (uint256)`
+- `previewWithdraw(uint256 assets) view returns (uint256)`
+- `previewRedeem(uint256 shares) view returns (uint256)`
+- `maxDeposit(address receiver) view returns (uint256)`
+- `maxMint(address receiver) view returns (uint256)`
+- `maxWithdraw(address owner) view returns (uint256)`
+- `maxRedeem(address owner) view returns (uint256)`
+- `asset() view returns (address)`

package/skills/sauce-protocols/references/registry/ethena.md

@@ -0,0 +1,50 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Ethena (`ethena`)
+
+Synthetic dollar protocol providing USDe, a crypto-native dollar backed by delta-neutral positions. sUSDe offers yield from staking and funding rates.
+
+| Fact | Value |
+| --- | --- |
+| Category | CDPs and stablecoins |
+| Family | none |
+| Namespace | `Ethena` on ethereum |
+| Chains | ethereum |
+| Document | [ethena.md](../ethena.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Ethena` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's susde, `0x9D39A5DE30e57443BfF2A8307A4256c8797A3497`.
+  require(Ethena.Susde != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | susde | `0x9D39A5DE30e57443BfF2A8307A4256c8797A3497` | `Ethena.Susde` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | usde | `0x4c9EDD5852cd905f086C759E8383e09bff1e68b3` | `Ethena.USDe` |
+
+## ABI
+
+### `StakedUSDeABI`
+
+`import StakedUSDeABI from "./protocols/ethena/StakedUSDeABI.json";` Speaks for: susde.
+
+- `deposit(uint256 assets, address receiver) returns (uint256 shares)`
+- `withdraw(uint256 assets, address receiver, address owner) returns (uint256 shares)`
+- `redeem(uint256 shares, address receiver, address owner) returns (uint256 assets)`
+- `cooldownAssets(uint256 assets) returns (uint256 shares)`
+- `cooldownShares(uint256 shares) returns (uint256 assets)`
+- `unstake(address receiver)`
+
+### `USDeABI`
+
+`import USDeABI from "./protocols/ethena/USDeABI.json";` Speaks for: usde.
+
+- `approve(address spender, uint256 amount) returns (bool)`

package/skills/sauce-protocols/references/registry/etherfi.md

@@ -0,0 +1,57 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ether.fi (`etherfi`)
+
+Decentralized, non-custodial liquid restaking protocol. Stake ETH to receive eETH, or wrap it as weETH for DeFi composability.
+
+| Fact | Value |
+| --- | --- |
+| Category | Restaking |
+| Family | none |
+| Namespace | `Etherfi` on ethereum |
+| Chains | ethereum |
+| Document | [etherfi.md](../etherfi.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Etherfi` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's eETH, `0x35fA164735182de50811E8e2E824cFb9B6118ac2`.
+  require(Etherfi.EETH != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | eETH | `0x35fA164735182de50811E8e2E824cFb9B6118ac2` | `Etherfi.EETH` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | liquidityPool | `0x308861A430be4cce5502d0A12724771Fc6DaF216` | `Etherfi.LiquidityPool` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | weETH | `0xCd5fE23C85820F7B72D0926FC9b05b43E359b7ee` | `Etherfi.WeETH` |
+
+## ABI
+
+### `EETHABI`
+
+`import EETHABI from "./protocols/etherfi/EETHABI.json";` Speaks for: eETH.
+
+- `balanceOf(address account) view returns (uint256)`
+- `approve(address spender, uint256 amount) returns (bool)`
+
+### `LiquidityPoolABI`
+
+`import LiquidityPoolABI from "./protocols/etherfi/LiquidityPoolABI.json";` Speaks for: liquidityPool.
+
+- `deposit() payable returns (uint256)`
+
+### `WeETHABI`
+
+`import WeETHABI from "./protocols/etherfi/WeETHABI.json";` Speaks for: weETH.
+
+- `wrap(uint256 _eETHAmount) returns (uint256)`
+- `unwrap(uint256 _weETHAmount) returns (uint256)`
+- `getEETHByWeETH(uint256 _weETHAmount) view returns (uint256)`
+- `getWeETHByeETH(uint256 _eETHAmount) view returns (uint256)`
+- `balanceOf(address account) view returns (uint256)`

package/skills/sauce-protocols/references/registry/euler-v2.md

@@ -0,0 +1,49 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Euler V2 (`euler-v2`)
+
+Modular lending platform built on the Ethereum Vault Connector (EVC). Supports permissionless vault creation with customizable risk parameters.
+
+| Fact | Value |
+| --- | --- |
+| Category | Lending |
+| Family | `Euler`: `euler-v2` |
+| Namespace | `EulerV2` on ethereum |
+| Chains | ethereum |
+| Document | [euler-v2.md](../euler-v2.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `EulerV2` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's ethereumVaultConnector, `0x0C9a3dd6b8F28529d72d7f9cE918D493519EE383`.
+  require(EulerV2.EthereumVaultConnector != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | ethereumVaultConnector | `0x0C9a3dd6b8F28529d72d7f9cE918D493519EE383` | `EulerV2.EthereumVaultConnector` |
+
+## ABI
+
+### `EVCABI`
+
+`import EVCABI from "./protocols/euler-v2/EVCABI.json";` Speaks for: ethereumVaultConnector.
+
+- `enableCollateral(address account, address vault) payable`
+- `enableController(address account, address vault) payable`
+
+### `EVaultABI`
+
+`import EVaultABI from "./protocols/euler-v2/EVaultABI.json";`
+
+- `deposit(uint256 amount, address receiver) returns (uint256 shares)`
+- `withdraw(uint256 amount, address receiver, address owner) returns (uint256 shares)`
+- `borrow(uint256 amount, address receiver) returns (uint256 shares)`
+- `repay(uint256 amount, address receiver) returns (uint256 shares)`
+- `redeem(uint256 shares, address receiver, address owner) returns (uint256 amount)`