@eco-incorp/sauce 0.99.6 → 0.99.8

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

@@ -0,0 +1,47 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Stader (`stader`)
+
+Multi-chain liquid staking protocol. ETHx is Stader's liquid staking token for Ethereum.
+
+| Fact | Value |
+| --- | --- |
+| Category | Liquid staking |
+| Family | none |
+| Namespace | `Stader` on ethereum |
+| Chains | ethereum |
+| Document | [stader.md](../stader.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Stader` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's ETHx, `0xA35b1B31Ce002FBF2058D22F30f95D405200A15b`.
+  require(Stader.ETHx != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | ETHx | `0xA35b1B31Ce002FBF2058D22F30f95D405200A15b` | `Stader.ETHx` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | stakePoolManager | `0xcf5EA1b38380f6aF39068375516Daf40Ed70D299` | `Stader.StakePoolManager` |
+
+## ABI
+
+### `ETHxABI`
+
+`import ETHxABI from "./protocols/stader/ETHxABI.json";` Speaks for: ETHx.
+
+- `balanceOf(address account) view returns (uint256)`
+- `approve(address spender, uint256 amount) returns (bool)`
+
+### `StakePoolManagerABI`
+
+`import StakePoolManagerABI from "./protocols/stader/StakePoolManagerABI.json";` Speaks for: stakePoolManager.
+
+- `deposit(address _receiver) payable returns (uint256)`
+- `getExchangeRate() view returns (uint256)`

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

@@ -0,0 +1,45 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Stargate (`stargate`)
+
+Omnichain liquidity transport protocol built on LayerZero. Provides native asset bridging with unified liquidity pools.
+
+| Fact | Value |
+| --- | --- |
+| Category | Bridges |
+| Family | none |
+| Namespace | `Stargate` on ethereum, base, arbitrum |
+| Chains | ethereum, base, arbitrum |
+| Document | [stargate.md](../stargate.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Stargate` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's poolNative, `0x77b2043768d28E9C9aB44E1aBfC95944bcE57931`.
+  require(Stargate.PoolNative != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | poolNative | `0x77b2043768d28E9C9aB44E1aBfC95944bcE57931` | `Stargate.PoolNative` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | poolUSDC | `0xc026395860Db2d07ee33e05fE50ed7bD583189C7` | `Stargate.PoolUSDC` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | poolUSDT | `0x933597a323Eb81cAe705C5bC29985172fd5A3973` | `Stargate.PoolUSDT` |
+| [Base](../../../sauce-chains/references/base.md) | poolNative | `0xdc181Bd607330aeeBEF6ea62e03e5e1Fb4B6F7C7` | `Stargate.PoolNative` |
+| [Base](../../../sauce-chains/references/base.md) | poolUSDC | `0x27a16dc786820B16E5c9028b75B99F6f604b5d26` | `Stargate.PoolUSDC` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | poolNative | `0xA45B5130f36CDcA45667738e2a258AB09f4A5f7F` | `Stargate.PoolNative` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | poolUSDC | `0xe8CDF27AcD73a434D661C84887215F7598e7d0d3` | `Stargate.PoolUSDC` |
+
+## ABI
+
+### `StargatePoolABI`
+
+`import StargatePoolABI from "./protocols/stargate/StargatePoolABI.json";` Speaks for: poolNative, poolUSDC, poolUSDT.
+
+- `send((uint32 dstEid, bytes32 to, uint256 amountLD, uint256 minAmountLD, bytes extraOptions, bytes composeMsg, bytes oftCmd) _sendParam, (uint256 nativeFee, uint256 lzTokenFee) _fee, address _refundAddress) payable returns ((bytes32 guid, uint64 nonce, (uint256 nativeFee, uint256 lzTokenFee) fee) msgReceipt, (uint256 amountSentLD, uint256 amountReceivedLD) oftReceipt)`
+- `quoteOFT((uint32 dstEid, bytes32 to, uint256 amountLD, uint256 minAmountLD, bytes extraOptions, bytes composeMsg, bytes oftCmd) _sendParam) view returns ((uint256 minAmountLD, uint256 maxAmountLD) oftLimit, (int256 feeAmountLD, string description)[] oftFeeDetails, (uint256 amountSentLD, uint256 amountReceivedLD) oftReceipt)`

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

@@ -0,0 +1,49 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Superfluid (`superfluid`)
+
+Protocol for real-time finance enabling continuous token streams (per-second payments), distributions, and composable Super Tokens.
+
+| Fact | Value |
+| --- | --- |
+| Category | Payments and streaming |
+| Family | none |
+| Namespace | `Superfluid` on ethereum, optimism, polygon, base, arbitrum |
+| Chains | ethereum, optimism, polygon, base, arbitrum |
+| Document | [superfluid.md](../superfluid.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Superfluid` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's cfaForwarder, `0xcfA132E353cB4E398080B9700609bb008eceB125`.
+  require(Superfluid.CFAForwarder != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+| [Base](../../../sauce-chains/references/base.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Base](../../../sauce-chains/references/base.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+
+## ABI
+
+### `CFAForwarderABI`
+
+`import CFAForwarderABI from "./protocols/superfluid/CFAForwarderABI.json";` Speaks for: cfaForwarder.
+
+- `createFlow(address token, address sender, address receiver, int96 flowrate, bytes userData) returns (bool)`
+- `updateFlow(address token, address sender, address receiver, int96 flowrate, bytes userData) returns (bool)`
+- `deleteFlow(address token, address sender, address receiver, bytes userData) returns (bool)`

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

@@ -0,0 +1,71 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# SushiSwap V2 (`sushiswap-v2`)
+
+Community-driven fork of Uniswap V2 with additional yield farming features and multi-chain deployment.
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | `Sushiswap`: `sushiswap-v2` |
+| Namespace | `SushiswapV2` on ethereum, optimism, bsc, polygon, fantom, arbitrum, avalanche |
+| Chains | ethereum, optimism, bsc, polygon, fantom, arbitrum, avalanche |
+| Document | [sushiswap-v2.md](../sushiswap-v2.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `SushiswapV2` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's factory, `0xC0AEe478e3658e2610c5F7A4A2E1777cE9e4f2Ac`.
+  require(SushiswapV2.Factory != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | factory | `0xC0AEe478e3658e2610c5F7A4A2E1777cE9e4f2Ac` | `SushiswapV2.Factory` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | router | `0xd9e1cE17f2641f24aE83637ab66a2cca9C378B9F` | `SushiswapV2.Router` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | factory | `0xFbc12984689e5f15626Bad03Ad60160Fe98B303C` | `SushiswapV2.Factory` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | router | `0x2ABf469074dc0b54d793850807E6eb5Faf2625b1` | `SushiswapV2.Router` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Fantom](../../../sauce-chains/references/fantom.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [Fantom](../../../sauce-chains/references/fantom.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+
+## ABI
+
+### `SushiSwapV2FactoryABI`
+
+`import SushiSwapV2FactoryABI from "./protocols/sushiswap-v2/SushiSwapV2FactoryABI.json";` Speaks for: factory.
+
+- `getPair(address tokenA, address tokenB) view returns (address pair)`
+- `createPair(address tokenA, address tokenB) returns (address pair)`
+
+### `SushiSwapV2PairABI`
+
+`import SushiSwapV2PairABI from "./protocols/sushiswap-v2/SushiSwapV2PairABI.json";`
+
+- `getReserves() view returns (uint112 _reserve0, uint112 _reserve1, uint32 _blockTimestampLast)`
+- `token0() view returns (address)`
+- `token1() view returns (address)`
+- `swap(uint256 amount0Out, uint256 amount1Out, address to, bytes data)`
+
+### `SushiSwapV2RouterABI`
+
+`import SushiSwapV2RouterABI from "./protocols/sushiswap-v2/SushiSwapV2RouterABI.json";` Speaks for: router.
+
+- `swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline) returns (uint256[] amounts)`
+- `swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] path, address to, uint256 deadline) returns (uint256[] amounts)`
+- `addLiquidity(address tokenA, address tokenB, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB, uint256 liquidity)`
+- `removeLiquidity(address tokenA, address tokenB, uint256 liquidity, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB)`
+- `getAmountsOut(uint256 amountIn, address[] path) view returns (uint256[] amounts)`

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

@@ -0,0 +1,49 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Swell (`swell`)
+
+Liquid staking and restaking protocol for Ethereum. Offers swETH for liquid staking and rswETH for liquid restaking.
+
+| Fact | Value |
+| --- | --- |
+| Category | Liquid staking |
+| Family | none |
+| Namespace | `Swell` on ethereum |
+| Chains | ethereum |
+| Document | [swell.md](../swell.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Swell` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's rswETH, `0xFAe103DC9cf190eD75350761e95403b7b8aFa6c0`.
+  require(Swell.RswETH != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | rswETH | `0xFAe103DC9cf190eD75350761e95403b7b8aFa6c0` | `Swell.RswETH` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | swETH | `0xf951E335afb289353dc249e82926178EaC7DEd78` | `Swell.SwETH` |
+
+## ABI
+
+### `RswETHABI`
+
+`import RswETHABI from "./protocols/swell/RswETHABI.json";` Speaks for: rswETH.
+
+- `deposit() payable`
+- `rswETHToETHRate() view returns (uint256)`
+- `balanceOf(address account) view returns (uint256)`
+
+### `SwETHABI`
+
+`import SwETHABI from "./protocols/swell/SwETHABI.json";` Speaks for: swETH.
+
+- `deposit() payable`
+- `swETHToETHRate() view returns (uint256)`
+- `balanceOf(address account) view returns (uint256)`

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

@@ -0,0 +1,46 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Synapse Protocol (`synapse`)
+
+Cross-chain bridge and DEX with multi-chain AMM pools. Supports token swaps and bridging via SynapseBridge and CCTP router.
+
+| Fact | Value |
+| --- | --- |
+| Category | Bridges |
+| Family | none |
+| Namespace | `Synapse` on ethereum, optimism, polygon, base, arbitrum, avalanche |
+| Chains | ethereum, optimism, polygon, base, arbitrum, avalanche |
+| Document | [synapse.md](../synapse.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Synapse` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's cctpRouter, `0x12715a66773BD9C54534a01aBF01d05F6B4Bd35E`.
+  require(Synapse.CctpRouter != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | cctpRouter | `0x12715a66773BD9C54534a01aBF01d05F6B4Bd35E` | `Synapse.CctpRouter` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | synapseBridge | `0x2796317b0fF8538F253012862c06787Adfb8cEB6` | `Synapse.SynapseBridge` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | synapseBridge | `0xAf41a65F786339e7911F4acDAD6BD49426F2Dc6b` | `Synapse.SynapseBridge` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | synapseBridge | `0x8F5BBB2BB8c2Ee94639E55d5F41de9b4839C1280` | `Synapse.SynapseBridge` |
+| [Base](../../../sauce-chains/references/base.md) | synapseBridge | `0xf07d1C752fAb503E47FEF309bf14fbDD3E867089` | `Synapse.SynapseBridge` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | synapseBridge | `0x6F4e8eba4d337f874AB57478AcC2Cb5BacDc19c9` | `Synapse.SynapseBridge` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | synapseBridge | `0xC05e61d0E7a63D27546389B7aD62FdFf5A91aACE` | `Synapse.SynapseBridge` |
+
+## ABI
+
+### `SynapseBridgeABI`
+
+`import SynapseBridgeABI from "./protocols/synapse/SynapseBridgeABI.json";` Speaks for: synapseBridge.
+
+- `deposit(address to, uint256 chainId, address token, uint256 amount)`
+- `depositAndSwap(address to, uint256 chainId, address token, uint256 amount, uint8 tokenIndexFrom, uint8 tokenIndexTo, uint256 minDy, uint256 deadline)`
+- `redeem(address to, uint256 chainId, address token, uint256 amount)`

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

@@ -0,0 +1,38 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# SyncSwap (`syncswap`)
+
+The leading DEX on zkSync Era with optimized gas efficiency. Supports classic constant product and stable pools with native account abstraction.
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | none |
+| Namespace | `Syncswap` on zksync |
+| Chains | zksync |
+| Document | [syncswap.md](../syncswap.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On zkSync Era, `Syncswap` is a namespace: its contracts need no import.
+
+```sauce chain=zksync
+function main() {
+  // zkSync Era's router, `0x2da10A1e27bF85cEdD8FFb1AbBe97e53391C0295`.
+  require(Syncswap.Router != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [zkSync Era](../../../sauce-chains/references/zksync.md) | router | `0x2da10A1e27bF85cEdD8FFb1AbBe97e53391C0295` | `Syncswap.Router` |
+
+## ABI
+
+### `SyncSwapRouterABI`
+
+`import SyncSwapRouterABI from "./protocols/syncswap/SyncSwapRouterABI.json";` Speaks for: router.
+
+- `swap(((address pool, bytes data, address callback, bytes callbackData)[] steps, address tokenIn, uint256 amountIn)[] paths, uint256 amountOutMin, uint256 deadline) payable returns ((address token, uint256 amount) amountOut)`

package/skills/sauce-protocols/references/registry/synthetix-v3.md

@@ -0,0 +1,48 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Synthetix V3 (`synthetix-v3`)
+
+Modular liquidity protocol powering perpetual futures and synthetic assets on Base and Optimism. Provides liquidity infrastructure for derivative protocols.
+
+| Fact | Value |
+| --- | --- |
+| Category | Synthetics |
+| Family | `Synthetix`: `synthetix-v3` |
+| Namespace | `SynthetixV3` on base |
+| Chains | base |
+| Document | [synthetix-v3.md](../synthetix-v3.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Base, `SynthetixV3` is a namespace: its contracts need no import.
+
+```sauce chain=base
+function main() {
+  // Base's coreProxy, `0x32C222A9A159782aFD7529c87FA34b96CA72C696`.
+  require(SynthetixV3.CoreProxy != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Base](../../../sauce-chains/references/base.md) | coreProxy | `0x32C222A9A159782aFD7529c87FA34b96CA72C696` | `SynthetixV3.CoreProxy` |
+| [Base](../../../sauce-chains/references/base.md) | perpsMarketProxy | `0x0A2AF931eFFd34b81ebcc57E3d3c9B1E1dE1C9Ce` | `SynthetixV3.PerpsMarketProxy` |
+
+## ABI
+
+### `CoreProxyABI`
+
+`import CoreProxyABI from "./protocols/synthetix-v3/CoreProxyABI.json";` Speaks for: coreProxy.
+
+- `deposit(uint128 accountId, address collateralType, uint256 tokenAmount)`
+- `withdraw(uint128 accountId, address collateralType, uint256 tokenAmount)`
+- `delegateCollateral(uint128 accountId, uint128 poolId, address collateralType, uint256 amount, uint256 leverage)`
+
+### `PerpsMarketProxyABI`
+
+`import PerpsMarketProxyABI from "./protocols/synthetix-v3/PerpsMarketProxyABI.json";` Speaks for: perpsMarketProxy.
+
+- `commitOrder((uint128 marketId, uint128 accountId, int128 sizeDelta, uint128 settlementStrategyId, uint256 acceptablePrice, bytes32 trackingCode, address referrer) commitment) returns ((uint256 commitmentTime, (uint128 marketId, uint128 accountId, int128 sizeDelta, uint128 settlementStrategyId, uint256 acceptablePrice, bytes32 trackingCode, address referrer) request) retOrder, uint256 fees)`
+- `modifyCollateral(uint128 accountId, uint128 collateralId, int256 amountDelta)`

package/skills/sauce-protocols/references/registry/synthra-v3.md

@@ -0,0 +1,77 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Synthra V3 (`synthra-v3`)
+
+Concentrated-liquidity spot DEX on Arc and Robinhood Chain: a Uniswap V3 fork whose pool callbacks are renamed (synthraV3SwapCallback / synthraV3MintCallback).
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | `Synthra`: `synthra-v3` |
+| Namespace | `SynthraV3` on arc |
+| Chains | arc |
+| Document | [synthra-v3.md](../synthra-v3.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Arc, `SynthraV3` is a namespace: its contracts need no import.
+
+```sauce chain=arc
+function main() {
+  // Arc's factory, `0x6307fc239C7964942c1BfFE51930E55606619c74`.
+  require(SynthraV3.Factory != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Arc](../../../sauce-chains/references/arc.md) | factory | `0x6307fc239C7964942c1BfFE51930E55606619c74` | `SynthraV3.Factory` |
+| [Arc](../../../sauce-chains/references/arc.md) | nonfungiblePositionManager | `0x2743b771659fD9CE13970d7367e7e84AF6a31049` | `SynthraV3.NonfungiblePositionManager` |
+| [Arc](../../../sauce-chains/references/arc.md) | quoterV2 | `0x9c179A7335B3fc841F59Aa6a62daf6d5c61b65D7` | `SynthraV3.QuoterV2` |
+| [Arc](../../../sauce-chains/references/arc.md) | swapRouter02 | `0xa50eDe66a573eE5bB37E28AF5789B76aE5FEb828` | `SynthraV3.SwapRouter02` |
+
+## ABI
+
+### `SynthraV3FactoryABI`
+
+`import SynthraV3FactoryABI from "./protocols/synthra-v3/SynthraV3FactoryABI.json";` Speaks for: factory.
+
+- `getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)`
+- `createPool(address tokenA, address tokenB, uint24 fee) returns (address pool)`
+
+### `SynthraV3NonfungiblePositionManagerABI`
+
+`import SynthraV3NonfungiblePositionManagerABI from "./protocols/synthra-v3/SynthraV3NonfungiblePositionManagerABI.json";` Speaks for: nonfungiblePositionManager.
+
+- `mint((address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, address recipient, uint256 deadline) params) payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)`
+- `increaseLiquidity((uint256 tokenId, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint128 liquidity, uint256 amount0, uint256 amount1)`
+- `decreaseLiquidity((uint256 tokenId, uint128 liquidity, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint256 amount0, uint256 amount1)`
+- `collect((uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max) params) payable returns (uint256 amount0, uint256 amount1)`
+
+### `SynthraV3PoolABI`
+
+`import SynthraV3PoolABI from "./protocols/synthra-v3/SynthraV3PoolABI.json";`
+
+- `slot0() view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)`
+- `liquidity() view returns (uint128)`
+- `fee() view returns (uint24)`
+- `tickSpacing() view returns (int24)`
+- `token0() view returns (address)`
+- `token1() view returns (address)`
+
+### `SynthraV3QuoterV2ABI`
+
+`import SynthraV3QuoterV2ABI from "./protocols/synthra-v3/SynthraV3QuoterV2ABI.json";` Speaks for: quoterV2.
+
+- `quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)`
+
+### `SynthraV3SwapRouter02ABI`
+
+`import SynthraV3SwapRouter02ABI from "./protocols/synthra-v3/SynthraV3SwapRouter02ABI.json";` Speaks for: swapRouter02.
+
+- `exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountOut)`
+- `exactInput((bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum) params) payable returns (uint256 amountOut)`
+- `exactOutputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountIn)`
+- `exactOutput((bytes path, address recipient, uint256 amountOut, uint256 amountInMaximum) params) payable returns (uint256 amountIn)`

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

@@ -0,0 +1,51 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Thales (`thales`)
+
+Positional markets protocol built on Synthetix offering binary options, speed markets, and sports markets on Optimism.
+
+| Fact | Value |
+| --- | --- |
+| Category | Options |
+| Family | none |
+| Namespace | `Thales` on optimism |
+| Chains | optimism |
+| Document | [thales.md](../thales.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Optimism, `Thales` is a namespace: its contracts need no import.
+
+```sauce chain=optimism
+function main() {
+  // Optimism's speedMarketsAMM, `0xE16B8a01490835EC1e76bAbbB3Cadd8921b32001`.
+  require(Thales.SpeedMarketsAMM != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Optimism](../../../sauce-chains/references/optimism.md) | speedMarketsAMM | `0xE16B8a01490835EC1e76bAbbB3Cadd8921b32001` | `Thales.SpeedMarketsAMM` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | thalesAMM | `0x278B5A44397c9D8E52743fEdec263c4760dc1A1A` | `Thales.ThalesAMM` |
+
+## ABI
+
+### `PositionalMarketABI`
+
+`import PositionalMarketABI from "./protocols/thales/PositionalMarketABI.json";`
+
+- `exerciseOptions() returns (uint256)`
+
+### `SpeedMarketsAMMABI`
+
+`import SpeedMarketsAMMABI from "./protocols/thales/SpeedMarketsAMMABI.json";` Speaks for: speedMarketsAMM.
+
+- `createNewMarket((address user, bytes32 asset, uint64 strikeTime, uint64 delta, int64 strikePrice, uint64 strikePricePublishTime, uint8 oracleSource, uint8 direction, address collateral, uint256 collateralAmount, address referrer, uint256 skewImpact) params) returns (address marketAddress)`
+
+### `ThalesAMMABI`
+
+`import ThalesAMMABI from "./protocols/thales/ThalesAMMABI.json";` Speaks for: thalesAMM.
+
+- `buyFromAMM(address market, uint8 position, uint256 amount, uint256 expectedPayout, uint256 additionalSlippage) returns (uint256)`

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

@@ -0,0 +1,39 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Thena (`thena`)
+
+BSC-native liquidity layer with ve(3,3) tokenomics. Solidly-fork supporting both volatile and stable AMM pools with gauge voting.
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | none |
+| Namespace | `Thena` on bsc |
+| Chains | bsc |
+| Document | [thena.md](../thena.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On BNB Chain, `Thena` is a namespace: its contracts need no import.
+
+```sauce chain=bsc
+function main() {
+  // BNB Chain's routerV2, `0xd4ae6eCA985340Dd434D38F470aCCce4DC78D109`.
+  require(Thena.RouterV2 != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | routerV2 | `0xd4ae6eCA985340Dd434D38F470aCCce4DC78D109` | `Thena.RouterV2` |
+
+## ABI
+
+### `ThenaRouterABI`
+
+`import ThenaRouterABI from "./protocols/thena/ThenaRouterABI.json";` Speaks for: routerV2.
+
+- `swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, (address from, address to, bool stable)[] routes, address to, uint256 deadline) returns (uint256[] amounts)`
+- `addLiquidity(address tokenA, address tokenB, bool stable, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline) returns (uint256 amountA, uint256 amountB, uint256 liquidity)`

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

@@ -0,0 +1,38 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Thruster (`thruster`)
+
+Blast-native DEX with concentrated liquidity (V3) pools. Optimized for Blast's native yield and gas rebate features.
+
+| Fact | Value |
+| --- | --- |
+| Category | DEX |
+| Family | none |
+| Namespace | `Thruster` on blast |
+| Chains | blast |
+| Document | [thruster.md](../thruster.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Blast, `Thruster` is a namespace: its contracts need no import.
+
+```sauce chain=blast
+function main() {
+  // Blast's v3SwapRouter, `0x337827814155ECBf24D20231fCA4444F530c0555`.
+  require(Thruster.V3SwapRouter != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Blast](../../../sauce-chains/references/blast.md) | v3SwapRouter | `0x337827814155ECBf24D20231fCA4444F530c0555` | `Thruster.V3SwapRouter` |
+
+## ABI
+
+### `ThrusterV3SwapRouterABI`
+
+`import ThrusterV3SwapRouterABI from "./protocols/thruster/ThrusterV3SwapRouterABI.json";` Speaks for: v3SwapRouter.
+
+- `exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountOut)`

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

@@ -0,0 +1,45 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Tokemak (`tokemak`)
+
+Liquidity routing protocol with Autopilot Autopools that automatically deploy and rebalance liquidity across DeFi destinations.
+
+| Fact | Value |
+| --- | --- |
+| Category | Yield and vaults |
+| Family | none |
+| Namespace | `Tokemak` on ethereum |
+| Chains | ethereum |
+| Document | [tokemak.md](../tokemak.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Tokemak` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's autopoolRegistry, `0x7E5828a3A6Ae75426d739E798140513A2E2964E4`.
+  require(Tokemak.AutopoolRegistry != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | autopoolRegistry | `0x7E5828a3A6Ae75426d739E798140513A2E2964E4` | `Tokemak.AutopoolRegistry` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | systemRegistry | `0x2218F90A98b0C070676f249EF44834686dAa4285` | `Tokemak.SystemRegistry` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | toke | `0x2e9d63788249371f1DFC918a52f8d799F4a38C94` | `Tokemak.Toke` |
+
+## ABI
+
+### `AutopoolABI`
+
+`import AutopoolABI from "./protocols/tokemak/AutopoolABI.json";`
+
+- `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)`
+- `totalAssets() view returns (uint256)`
+- `convertToShares(uint256 assets) view returns (uint256)`
+- `convertToAssets(uint256 shares) view returns (uint256)`