@eco-incorp/sauce 0.99.6 → 0.99.7

package/skills/sauce-chains/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: sauce-chains
+description: Everything about one chain a Sauce program can run on, generated from the SDK's registries — whether the initial release supports transactions there (Ethereum, Base and Solana; every other chain is a preview chain, compile and simulate only) and how to request one, its id, slug and aliases, kind, native coin, the Sauce engine, Kitchen and Router, whether it takes intents and its CCTP domain, its tokens with addresses, and every protocol deployed there with each contract's address and how a program names it. Covers how a name resolves per --chain, chain-qualified names, what compiling for a chain produces, and confirming that a recorded address has code. Use when the user asks what is on a chain or which chains are supported, needs a token or contract address on a chain, asks whether a chain has a protocol, takes intents or has a CCTP domain, picks a chain, a transaction is refused on a preview chain, or a name fails to compile on one chain but not another.
+---
+
+# Chains
+
+Every chain the SDK knows has a file in [references/](references/index.md):
+[references/index.md](references/index.md) lists them, and `references/<slug>.md` is one chain
+(for example [references/base.md](references/base.md)). All of it is generated from the SDK's
+registries, so it says what the package resolves when a program is compiled for that chain.
+
+## Supported and preview chains
+
+For the initial release, Sauce supports transactions on **Ethereum, Base and Solana** (`ethereum`,
+`base`, `solana`). Every other chain is a **preview chain**: a program compiles for it, and
+`sauce simulate` and the dry runs rehearse it there, but the `sauce` command and the MCP server
+build and send no transaction on it — `sauce tx`, `sauce run`, `sauce pot --deploy`,
+`sauce intent publish` and the intent steps sent there are refused before anything is read or
+signed. The refusal names the supported chains and links that chain's chain-support request.
+[references/index.md](references/index.md) has a Support column, and each chain's file says which
+it is at the top.
+
+To ask for a preview chain, or one the SDK does not know, look for it among the
+[existing chain-support requests](https://github.com/eco-incorp/sauce/issues?q=is%3Aissue+label%3Achain-support)
+and add the use case to it as a comment, or
+[open a request](https://github.com/eco-incorp/sauce/issues/new?template=chain-support.yml) with
+the chain-support form: the chain and its id, what runs there, the protocols and tokens it needs,
+and the expected volume and timing. A preview chain's file links its own request, prefilled.
+
+## When to use
+
+- You need a token's or a contract's address on a chain, or how a program names it there.
+- You are choosing a chain: whether it is supported, which protocols it has, whether it takes
+  intents, its CCTP domain.
+- A transaction was refused on a preview chain: its file links the request to post.
+- A program compiles for one chain and not another: the name is not recorded on the second.
+
+## Quick reference
+
+| In a chain's file | What it gives                                                                                 |
+| ----------------- | --------------------------------------------------------------------------------------------- |
+| The top           | supported, or a preview chain with the link to request it                                     |
+| The facts table   | slug and aliases for `--chain`, chain id, kind, the name a program uses, native coin          |
+| Sauce             | the engine, Kitchen and Router a cook uses (EVM), or the engine and Kitchen programs (Solana) |
+| Intents           | whether it takes intents, its eco-routes contracts and shared intent Pot (`sauce-intents`)    |
+| In a program      | a compiled example of the chain's names                                                       |
+| Tokens            | every token symbol a program can name there, with its address and decimals                    |
+| Protocols         | every recorded deployment, each with how a program names it                                   |
+
+A program compiled with `--chain <slug>` resolves every name to that chain's value: a token symbol
+is that chain's token, a namespace contract that chain's deployment. The same file compiled for
+another chain resolves them there, and fails to compile where a name is not recorded:
+
+```sauce chain=base,arbitrum,ethereum
+function main(recipient: Address, fee: Uint256) {
+  // This chain's tokens: an address where a value is expected, a token where a method is called.
+  const held = USDC.balanceOf(ctx.self());
+  // Any other ERC-20, by address.
+  require(Token(WETH).balanceOf(ctx.self()) >= 0n);
+  // A namespace contract, called with no import.
+  const pool = UniswapV3.Factory.getPool(USDC, WETH, fee);
+  require(pool != 0n, "no USDC/WETH pool at that fee on this chain");
+  // A contract on a named chain, from a program compiled for any chain.
+  require(Ethereum.UniswapV3.Factory != 0n);
+  // The chain the file was compiled for, against the one it runs on.
+  require(ctx.chainId() == chainId, "compiled for another chain");
+  USDC.transfer(recipient, held);
+}
+```
+
+A protocol that is not a namespace on the chain is reached by importing its ABI and binding it to
+the address the chain's file records, as a module constant a define can replace:
+
+```sauce chain=base,arbitrum
+import PancakeSwapV3FactoryABI from "./protocols/pancakeswap-v3/PancakeSwapV3FactoryABI.json";
+
+const PANCAKE_V3_FACTORY = 0n; // the chain's file gives it: --define PANCAKE_V3_FACTORY=<address>
+
+function main(fee: Uint256): Address {
+  require(PANCAKE_V3_FACTORY != 0n, "set PANCAKE_V3_FACTORY");
+  return PancakeSwapV3FactoryABI.at(PANCAKE_V3_FACTORY).getPool(USDC, WETH, fee);
+}
+```
+
+## Decision guidance
+
+| When                          | Look at                                                                                 |
+| ----------------------------- | --------------------------------------------------------------------------------------- |
+| Where a transaction can run   | a supported chain: Ethereum, Base or Solana; elsewhere compile and simulate only        |
+| Which chain has a protocol    | the protocol's registry file in `sauce-protocols`, or the Protocols table of each chain |
+| Whether a program can name it | the "In a program" column: a namespace needs no import, anything else is an ABI import  |
+| Moving value between chains   | "Intents": both chains must take intents (`sauce-intents`); the CCTP domain for USDC    |
+| Token order in a pool         | the token addresses: token0 is the lower one, and the order differs per chain           |
+| Native coin or its ERC-20     | the native coin row: on some chains the coin is also an ERC-20 with other decimals      |
+
+## Workflow
+
+1. Open the chain's file and check that every name the program uses is listed there.
+2. Compile for the chain: `sauce compile <file> --chain <slug>` prints the bytecode, and `--json`
+   adds its size and `main`'s parameters.
+3. The transaction is a cook on your Pot: `to` the Pot, `data` the Pot's `cook(engine, program)`
+   with `main`'s arguments appended to the program, `value` the Kitchen's fee (plus any native the
+   program spends). `sauce tx <file> --chain <slug> --owner <address> --args …` prints it as
+   unsigned JSON, `{ chainId, to, data, value }`, for any wallet or signer to send; `sauce-cli`
+   covers the command that signs and sends it too. On a preview chain `sauce tx` is refused: stop
+   at compiling and simulating, and offer the user the chain-support request the refusal links.
+
+## Common gotchas
+
+- **Recorded is not live.** Every address here is as the registry records it; that is not proof of
+  code on the chain. Before relying on one, confirm it has code: `eth_getCode` on the chain returns
+  more than `0x`, or on Solana `getAccountInfo` returns an executable account. The Sauce release
+  addresses are the same on every EVM chain, and deployed only where the release has been.
+- **A name resolves on the chain where its part runs.** The file's own code and an intent's
+  `.reward(...)` resolve on the chain the file is compiled for; inside an intent's braces, and in
+  its delivery argument, `USDC` and every other chain-supplied name are the destination's
+  (`sauce-intents`).
+- **A chain-qualified name is a contract, not a token.** `Ethereum.UniswapV3.Factory` works from any
+  chain; `Ethereum.USDC` does not: use the token's address.
+- **Solana has no symbols.** The registry names no Solana token: accounts and mints are `main`'s
+  `Account` parameters and defines (`sauce-solana`).
+
+## Verification checklist
+
+- [ ] Every name the program uses is listed in the chain's file, and it compiles with `--chain`.
+- [ ] Every address the program relies on has code on that chain.
+- [ ] Amounts are in the token's decimals, from the chain's Tokens table.
+- [ ] For an intent, both chains take intents.
+- [ ] For a transaction, the chain is supported (Ethereum, Base or Solana); a preview chain is
+      compiled and simulated, and requested through its chain-support issue.
+
+## Example
+
+[examples/chains.sauce.ts](examples/chains.sauce.ts) is one file for every chain: it checks it runs
+on the chain it was compiled for and that the chain's Uniswap V3 factory has a pool, and pays the
+chain's USDC.

package/skills/sauce-chains/examples/chains.sauce.ts

@@ -0,0 +1,25 @@
+// One file for every chain: compiled with `--chain`, each name below resolves to that chain's token
+// or contract, and a chain without one refuses to compile. It checks that it runs on the chain it
+// was compiled for and that the chain's Uniswap V3 factory has a USDC/WETH pool at `fee`, then pays
+// `amount` of the chain's USDC to `recipient`.
+//
+//   sauce tx chains.sauce.ts --chain <chain> --owner <address> --args <recipient> <amount> <fee>
+//
+//   recipient: Address  who is paid
+//   amount: Uint256     how much of the chain's USDC, in its smallest units (6 decimals):
+//                       1000000 is 1 USDC
+//   fee: Uint256        the Uniswap V3 fee tier the pool must exist at, in millionths:
+//                       500 is 0.05%, 3000 is 0.3%
+//
+// On Base, 1 USDC, once a 0.05% USDC/WETH pool is there (the endpoint reads the Kitchen's fee):
+//
+//   sauce tx chains.sauce.ts --chain base --owner <address> --config sauce.config.json \
+//     --args <recipient> 1000000 500
+function main(recipient: Address, amount: Uint256, fee: Uint256) {
+  // `chainId` is the id of the chain the file was compiled for; ctx.chainId() is where it runs.
+  require(ctx.chainId() == chainId, "compiled for another chain");
+  // A namespace contract is called with no import; `USDC` and `WETH` are this chain's tokens.
+  const pool = UniswapV3.Factory.getPool(USDC, WETH, fee);
+  require(pool != 0n, "no USDC/WETH pool at that fee");
+  USDC.transfer(recipient, amount);
+}

package/skills/sauce-chains/references/arbitrum.md

@@ -0,0 +1,158 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Arbitrum One
+
+**Preview chain.** For the initial release, Sauce supports transactions on Ethereum, Base and Solana only.
+On Arbitrum One a program compiles and simulates (`sauce compile`, `sauce simulate`, the dry
+runs), but the `sauce` command and the MCP server build and send no transaction: `sauce tx`,
+`sauce run`, `sauce pot --deploy`, `sauce intent publish` and the intent steps sent here are
+refused, naming the supported chains and how to request this one.
+
+To request Arbitrum One, look for [its existing request](https://github.com/eco-incorp/sauce/issues?q=is%3Aissue+label%3Achain-support+%22Arbitrum+One%22) and add your
+use case to it, or [open one](https://github.com/eco-incorp/sauce/issues/new?template=chain-support.yml&title=Chain+support%3A+Arbitrum+One+%2842161%29&chain=Arbitrum+One&chain-id=42161) with the chain-support issue form.
+
+| Fact | Value |
+| --- | --- |
+| Support | preview: compile and simulate; no transaction is built or sent |
+| Slug (`--chain`) | `arbitrum`; also `arb` |
+| Chain id | 42161 |
+| Kind | EVM |
+| Name in a program | `Arbitrum` |
+| Native coin | ETH (Ether), 18 decimals |
+| Sauce engine | `0x6785455AA479AA99D59357d7c9Fe14cba626F175` |
+| Sauce Kitchen | `0x19845b22989150E6B09dE55a661295Dd9188506b` |
+| Sauce Router | `0x9201aF06536Cb4819cf1F08aE7063c5997D87459` |
+| Intents (eco-routes) | takes intents; Portal `0xEC000769A73b70e16f361a442292500b3BCf4A85` |
+| Intent Executor | `0x8B5D51AF4C4542f241C4e54CFd903CeEd145f082` |
+| Shared intent Pot | `0xDd330394620fBFF4D0AdcfA33B0D7b3622Db15B0`: the Kitchen's `deployPot(<Executor>, 0x0)` creates it, from any account |
+| CCTP domain | 3 |
+
+## In a program
+
+Compiled with `--chain arbitrum`, a program names Arbitrum One's tokens and contracts with no
+import; the same file compiled for another chain resolves each name there, or fails where the
+chain does not have it.
+
+```sauce chain=arbitrum
+function main() {
+  // `USDC` is Arbitrum One's USDC: `0xaf88d065e77c8cC2239327C5EDb3A432268e5831`.
+  const held = USDC.balanceOf(ctx.self());
+  // `Token(address)` is any other ERC-20, and works for a symbol's address too.
+  require(Token(USDC).balanceOf(ctx.self()) == held);
+  // `AaveV3.Pool` is Arbitrum One's pool: `0x794a61358D6845594F94dc1DB02A252b5b4814aD`.
+  require(AaveV3.Pool != 0n);
+  // The same contract, qualified by the chain's name, from a program on any chain.
+  require(Arbitrum.AaveV3.Pool == AaveV3.Pool);
+}
+```
+
+## Tokens
+
+| Symbol | Address | Decimals |
+| --- | --- | --- |
+| `USDC` | `0xaf88d065e77c8cC2239327C5EDb3A432268e5831` | 6 |
+| `WETH` | `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1` | 18 |
+
+## Protocols
+
+Every protocol the registry records here, each contract with how a program names it: its
+namespace contract, or its ABI imported from `./protocols/<slug>/<Export>.json` and bound to the
+address.
+
+| Protocol | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Aave V3](../../sauce-protocols/references/registry/aave-v3.md) | pool | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` | `AaveV3.Pool` |
+| [Aave V3](../../sauce-protocols/references/registry/aave-v3.md) | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` | `AaveV3.PoolAddressesProvider` |
+| [Abracadabra](../../sauce-protocols/references/registry/abracadabra.md) | degenBox | `0x7C8FeF8eA9b1fE46A7689bfb8149341C90431D38` | `Abracadabra.DegenBox` |
+| [Abracadabra](../../sauce-protocols/references/registry/abracadabra.md) | mim | `0xFEa7a6a0B346362BF88A9e4A88416B77a57D6c2A` | `Abracadabra.Mim` |
+| [Across](../../sauce-protocols/references/registry/across.md) | spokePool | `0xe35e9842fceaCA96570B734083f4a58e8F7C5f2A` | `Across.SpokePool` |
+| [Arbitrum Native Bridge](../../sauce-protocols/references/registry/arbitrum-bridge.md) | l2GatewayRouter | `0x5288c571Fd7aD117beA99bF60FE0846C4E84F933` | `ArbitrumBridge.L2GatewayRouter` |
+| [Axelar](../../sauce-protocols/references/registry/axelar.md) | gateway | `0xe432150cce91c13a887f7D836923d5597adD8E31` | `Axelar.Gateway` |
+| [Axelar](../../sauce-protocols/references/registry/axelar.md) | its | `0xB5FB4BE02232B1bBA4dC8f81dc24C26980dE9e3C` | `Axelar.ITS` |
+| [Balancer V2](../../sauce-protocols/references/registry/balancer-v2.md) | vault | `0xBA12222222228d8Ba445958a75a0704d566BF2C8` | `BalancerV2.Vault` |
+| [Beefy Finance](../../sauce-protocols/references/registry/beefy.md) | BIFI | `0x99C409E5f62E4bd2AC142f17caFb6810B8F0BAAE` | `Beefy.BIFI` |
+| [Camelot](../../sauce-protocols/references/registry/camelot.md) | v2Factory | `0x6EcCab422D763aC031210895C81787E87B43A652` | `Camelot.V2Factory` |
+| [Camelot](../../sauce-protocols/references/registry/camelot.md) | v2Router | `0xc873fEcbd354f5A56E00E710B90EF4201db2448d` | `Camelot.V2Router` |
+| [Camelot](../../sauce-protocols/references/registry/camelot.md) | v3Factory | `0x1a3c9B1d2F0529D97f2afC5136Cc23e58f1FD35B` | `Camelot.V3Factory` |
+| [Camelot](../../sauce-protocols/references/registry/camelot.md) | v3SwapRouter | `0x1F721E2E82F6676FCE4eA07A5958cF098D339e18` | `Camelot.V3SwapRouter` |
+| [CCTP](../../sauce-protocols/references/registry/cctp.md) | tokenMessenger | `0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d` | `Cctp.TokenMessenger` |
+| [Celer Network](../../sauce-protocols/references/registry/celer.md) | bridge | `0x1619DE6B6B20eD217a58d00f37B9d47C7663feca` | `Celer.Bridge` |
+| [Chainlink CCIP](../../sauce-protocols/references/registry/chainlink-ccip.md) | router | `0x141fa059441E0ca23ce184B6A78bafD2A517DdE8` | `ChainlinkCcip.Router` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayMinter | `0x2222222d7164433c4C09B0b0D809a9b52C04C205` | `CircleGateway.GatewayMinter` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayWallet | `0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE` | `CircleGateway.GatewayWallet` |
+| [Compound V3](../../sauce-protocols/references/registry/compound-v3.md) | cUSDCv3 | `0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf` | `CompoundV3.CUSDCv3` |
+| [Compound V3](../../sauce-protocols/references/registry/compound-v3.md) | cUSDTv3 | `0x6f7D514bbD4aFf3BcD1140B7344b32f063dEe486` | `CompoundV3.CUSDTv3` |
+| [Connext (Everclear)](../../sauce-protocols/references/registry/connext.md) | everclearSpoke | `0xa05A3380889115bf313f1Db9d5f335157Be4D816` | `Connext.EverclearSpoke` |
+| [CoW Swap](../../sauce-protocols/references/registry/cowswap.md) | gpv2Settlement | `0x9008D19f58AAbD9eD0D60971565AA8510560ab41` | `Cowswap.GPv2Settlement` |
+| [Curve Finance](../../sauce-protocols/references/registry/curve.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [Curve Finance](../../sauce-protocols/references/registry/curve.md) | routerNG | `0x2191718CD32d02B8E60BAdFFeA33E4B5DD9A0A0D` | `Curve.RouterNG` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Fluid](../../sauce-protocols/references/registry/fluid.md) | liquidity | `0x52Aa899454998Be5b000Ad077a46Bbe360F4e497` | `Fluid.Liquidity` |
+| [Gains Network](../../sauce-protocols/references/registry/gains-network.md) | diamond | `0xFF162c694eAA571f685030649814282eA457f169` | `GainsNetwork.Diamond` |
+| [Gains Network](../../sauce-protocols/references/registry/gains-network.md) | gns | `0x18c11FD286C5EC11c3b683Caa813B77f5163A122` | `GainsNetwork.Gns` |
+| [Gelato Network](../../sauce-protocols/references/registry/gelato.md) | automate | `0x2A6C106ae13B558BB9E2Ec64Bd2f1f7BEFF3A5E0` | `Gelato.Automate` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | glp | `0x4277f8F2c384827B5273592FF7CeBd9f2C1ac258` | `GmxV1.Glp` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | positionRouter | `0xb87a436B93fFE9D75c5cFA7bAcFff96430b09868` | `GmxV1.PositionRouter` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | router | `0xaBBc5F99639c9B6bCb58544ddf04EFA6802F4064` | `GmxV1.Router` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | vault | `0x489ee077994B6658eAfA855C308275EAd8097C4A` | `GmxV1.Vault` |
+| [GMX V2](../../sauce-protocols/references/registry/gmx-v2.md) | dataStore | `0xFD70de6b91282D8017aA4E741e9Ae325CAb992d8` | `GmxV2.DataStore` |
+| [GMX V2](../../sauce-protocols/references/registry/gmx-v2.md) | exchangeRouter | `0x7dE39FF2e232A2203196788d37e234cF8F1b83f1` | `GmxV2.ExchangeRouter` |
+| [Hegic](../../sauce-protocols/references/registry/hegic.md) | hegic | `0x431402e8b9dE9aa016C743880e04E517074D8cEC` | `Hegic.Hegic` |
+| [Hegic](../../sauce-protocols/references/registry/hegic.md) | operationalTreasury | `0xec096ea6eB9aa5ea689b0CF00882366E92377371` | `Hegic.OperationalTreasury` |
+| [Hop Protocol](../../sauce-protocols/references/registry/hop.md) | l2AmmWrapper | `0x33ceb27b39d2Bb7D2e61F7564d3Df29344020417` | `Hop.L2AmmWrapper` |
+| [Hyperlane](../../sauce-protocols/references/registry/hyperlane.md) | mailbox | `0x979Ca5202784112f4738403dBec5D0F3B9daabB9` | `Hyperlane.Mailbox` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | elasticFactory | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` | `Kyberswap.ElasticFactory` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | elasticRouter | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` | `Kyberswap.ElasticRouter` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | metaAggregationRouterV2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `Kyberswap.MetaAggregationRouterV2` |
+| [KyberSwap Aggregator](../../sauce-protocols/references/registry/kyberswap-aggregator.md) | metaAggregationRouter | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `KyberswapAggregator.MetaAggregationRouter` |
+| [LayerZero](../../sauce-protocols/references/registry/layerzero.md) | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` | `Layerzero.EndpointV2` |
+| [Level Finance](../../sauce-protocols/references/registry/level-finance.md) | liquidityPool | `0x32B7bF19cb8b95C27E644183837813d4b595dcc6` | `LevelFinance.LiquidityPool` |
+| [Lido](../../sauce-protocols/references/registry/lido.md) | wstETH | `0x5979D7b546E38E414F7E9822514be443A4800529` | `Lido.WstETH` |
+| [LI.FI](../../sauce-protocols/references/registry/lifi.md) | lifiDiamond | `0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE` | `Lifi.LiFiDiamond` |
+| [Maverick](../../sauce-protocols/references/registry/maverick.md) | v2Factory | `0x0A7e848Aca42d879EF06507Fca0E7b33A0a63c1e` | `Maverick.V2Factory` |
+| [Maverick](../../sauce-protocols/references/registry/maverick.md) | v2Router | `0x5c3b380e5Aeec389d1014Da3Eb372FA2C9e0fc76` | `Maverick.V2Router` |
+| [MUX Protocol](../../sauce-protocols/references/registry/mux-protocol.md) | liquidityPool | `0x3e0199792Ce69DC29A0a36146bFa68bd7C8D6633` | `MuxProtocol.LiquidityPool` |
+| [MUX Protocol](../../sauce-protocols/references/registry/mux-protocol.md) | orderBook | `0xa19fD5aB6C8DCffa2A295F78a5Bb4aC543AAF5e3` | `MuxProtocol.OrderBook` |
+| [1inch](../../sauce-protocols/references/registry/oneinch.md) | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` | `Oneinch.AggregationRouterV6` |
+| [OpenOcean](../../sauce-protocols/references/registry/openocean.md) | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` | `Openocean.ExchangeV2` |
+| [PancakeSwap V2](../../sauce-protocols/references/registry/pancakeswap-v2.md) | factory | `0x02a84c1b3BBD7401a5f7fa98a384EBC70bB5749E` | `PancakeswapV2.Factory` |
+| [PancakeSwap V2](../../sauce-protocols/references/registry/pancakeswap-v2.md) | router | `0x8cFe327CEc66d1C090Dd72bd0FF11d690C33a2Eb` | `PancakeswapV2.Router` |
+| [PancakeSwap V3](../../sauce-protocols/references/registry/pancakeswap-v3.md) | factory | `0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865` | `PancakeswapV3.Factory` |
+| [PancakeSwap V3](../../sauce-protocols/references/registry/pancakeswap-v3.md) | nonfungiblePositionManager | `0x46A15B0b27311cedF172AB29E4f4766fbE7F4364` | `PancakeswapV3.NonfungiblePositionManager` |
+| [PancakeSwap V3](../../sauce-protocols/references/registry/pancakeswap-v3.md) | smartRouter | `0x32226588378236Fd0c7c4053999F88aC0e5cAc77` | `PancakeswapV3.SmartRouter` |
+| [ParaSwap](../../sauce-protocols/references/registry/paraswap.md) | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` | `Paraswap.AugustusV5` |
+| [ParaSwap](../../sauce-protocols/references/registry/paraswap.md) | augustusV6 | `0x6A000F20005980200259B80c5102003040001068` | `Paraswap.AugustusV6` |
+| [Pendle](../../sauce-protocols/references/registry/pendle.md) | router | `0x888888888889758F76e7103c6CbF23ABbF58F946` | `Pendle.Router` |
+| [Permit2](../../sauce-protocols/references/registry/permit2.md) | permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` | `Permit2.Permit2` |
+| [Premia](../../sauce-protocols/references/registry/premia.md) | poolFactory | `0xAE4fB6622F25f397587F11638dA8CE88C27b5645` | `Premia.PoolFactory` |
+| [Radiant](../../sauce-protocols/references/registry/radiant.md) | lendingPool | `0xF4B1486DD74D07706052A33d31d7c0AAFD0659E1` | `Radiant.LendingPool` |
+| [Ramses](../../sauce-protocols/references/registry/ramses.md) | router | `0xAAA87963EFeB6f7E0a2711F397663105Acb1805e` | `Ramses.Router` |
+| [Safe](../../sauce-protocols/references/registry/safe.md) | safeL2V130 | `0x3E5c63644E683549055b9Be8653de26E0B4CD36E` | `Safe.SafeL2V130` |
+| [Seaport](../../sauce-protocols/references/registry/seaport.md) | seaportV16 | `0x0000000000000068F116a894984e2DB1123eB395` | `Seaport.SeaportV16` |
+| [Silo](../../sauce-protocols/references/registry/silo.md) | siloRepository | `0x8658047e48CC09161f4152c79155Dac1d710Ff0a` | `Silo.SiloRepository` |
+| [Socket](../../sauce-protocols/references/registry/socket.md) | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` | `Socket.SocketGateway` |
+| [Squid Router](../../sauce-protocols/references/registry/squid.md) | squidRouter | `0xce16F69375520ab01377ce7B88f5BA8C48F8D666` | `Squid.SquidRouter` |
+| [Stargate](../../sauce-protocols/references/registry/stargate.md) | poolNative | `0xA45B5130f36CDcA45667738e2a258AB09f4A5f7F` | `Stargate.PoolNative` |
+| [Stargate](../../sauce-protocols/references/registry/stargate.md) | poolUSDC | `0xe8CDF27AcD73a434D661C84887215F7598e7d0d3` | `Stargate.PoolUSDC` |
+| [Superfluid](../../sauce-protocols/references/registry/superfluid.md) | cfaForwarder | `0xcfA132E353cB4E398080B9700609bb008eceB125` | `Superfluid.CFAForwarder` |
+| [Superfluid](../../sauce-protocols/references/registry/superfluid.md) | host | `0x3E14dC1b13c488a8d5D310918780c983bD5982E7` | `Superfluid.Host` |
+| [SushiSwap V2](../../sauce-protocols/references/registry/sushiswap-v2.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [SushiSwap V2](../../sauce-protocols/references/registry/sushiswap-v2.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Synapse Protocol](../../sauce-protocols/references/registry/synapse.md) | synapseBridge | `0x6F4e8eba4d337f874AB57478AcC2Cb5BacDc19c9` | `Synapse.SynapseBridge` |
+| [Trader Joe](../../sauce-protocols/references/registry/trader-joe.md) | lbFactory | `0xb43120c4745967fa9b93E79C149E66B0f2D6Fe0c` | `TraderJoe.LBFactory` |
+| [Trader Joe](../../sauce-protocols/references/registry/trader-joe.md) | lbRouter | `0x18556da13313f3532c54711497a8fedac273220e` | `TraderJoe.LBRouter` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | factory | `0xf1D7CC64Fb4452F05c498126312eBE29f30Fbcf9` | `UniswapV2.Factory` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | router | `0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24` | `UniswapV2.Router` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | factory | `0x1F98431c8aD98523631AE4a59f267346ea31F984` | `UniswapV3.Factory` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | nonfungiblePositionManager | `0xC36442b4a4522E871399CD717aBDD847Ab11FE88` | `UniswapV3.NonfungiblePositionManager` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | swapRouter | `0xE592427A0AEce92De3Edee1F18E0157C05861564` | `UniswapV3.SwapRouter` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | poolManager | `0x360e68faccca8ca495c1b759fd9eee466db9fb32` | `UniswapV4.PoolManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | positionManager | `0xd88f38f930b7952f2db2432cb002e7abbf3dd869` | `UniswapV4.PositionManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | stateView | `0x76fd297e2d437cd7f76d50f01afe6160f86e9990` | `UniswapV4.StateView` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | universalRouter | `0xa51afafe0263b40edaef0df8781ea9aa03e381a3` | `UniswapV4.UniversalRouter` |
+| [Vertex](../../sauce-protocols/references/registry/vertex.md) | clearinghouse | `0x773bb71b0108b060b76746422ee810bfec9a963d` | `Vertex.Clearinghouse` |
+| [Vertex](../../sauce-protocols/references/registry/vertex.md) | endpoint | `0x73eab16c88b9f38d3f2661c9e5875ec0eeee2965` | `Vertex.Endpoint` |
+| [Wormhole](../../sauce-protocols/references/registry/wormhole.md) | coreBridge | `0xa5f208e072434bC67592E4C49C1B991BA79BCA46` | `Wormhole.CoreBridge` |
+| [Wormhole](../../sauce-protocols/references/registry/wormhole.md) | tokenBridge | `0x0b2402144Bb366A632D14B83F244D2e0e21bD39c` | `Wormhole.TokenBridge` |
+| [0x Protocol](../../sauce-protocols/references/registry/zerox.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |

package/skills/sauce-chains/references/arc.md

@@ -0,0 +1,107 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Arc
+
+**Preview chain.** For the initial release, Sauce supports transactions on Ethereum, Base and Solana only.
+On Arc a program compiles and simulates (`sauce compile`, `sauce simulate`, the dry
+runs), but the `sauce` command and the MCP server build and send no transaction: `sauce tx`,
+`sauce run`, `sauce pot --deploy`, `sauce intent publish` and the intent steps sent here are
+refused, naming the supported chains and how to request this one.
+
+To request Arc, look for [its existing request](https://github.com/eco-incorp/sauce/issues?q=is%3Aissue+label%3Achain-support+%22Arc%22) and add your
+use case to it, or [open one](https://github.com/eco-incorp/sauce/issues/new?template=chain-support.yml&title=Chain+support%3A+Arc+%285042%29&chain=Arc&chain-id=5042) with the chain-support issue form.
+
+| Fact | Value |
+| --- | --- |
+| Support | preview: compile and simulate; no transaction is built or sent |
+| Slug (`--chain`) | `arc`; also `arc-mainnet`, `arc-network` |
+| Chain id | 5042 |
+| Kind | EVM |
+| Name in a program | `Arc` |
+| Native coin | USDC (USDC), 18 decimals; also the ERC-20 `USDC` (6 decimals), one balance |
+| Sauce engine | `0x6785455AA479AA99D59357d7c9Fe14cba626F175` |
+| Sauce Kitchen | `0x19845b22989150E6B09dE55a661295Dd9188506b` |
+| Sauce Router | `0x9201aF06536Cb4819cf1F08aE7063c5997D87459` |
+| Intents (eco-routes) | takes intents; Portal `0xEC000769A73b70e16f361a442292500b3BCf4A85` |
+| Intent Executor | `0x8B5D51AF4C4542f241C4e54CFd903CeEd145f082` |
+| Shared intent Pot | `0xDd330394620fBFF4D0AdcfA33B0D7b3622Db15B0`: the Kitchen's `deployPot(<Executor>, 0x0)` creates it, from any account |
+| CCTP domain | 26 |
+
+## In a program
+
+Compiled with `--chain arc`, a program names Arc's tokens and contracts with no
+import; the same file compiled for another chain resolves each name there, or fails where the
+chain does not have it.
+
+```sauce chain=arc
+function main() {
+  // `EURC` is Arc's EURC: `0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1`.
+  const held = EURC.balanceOf(ctx.self());
+  // `Token(address)` is any other ERC-20, and works for a symbol's address too.
+  require(Token(EURC).balanceOf(ctx.self()) == held);
+  // `AaveV4.CoreHub` is Arc's coreHub: `0x17288dfc86205301064577b98B02b81017e6F79C`.
+  require(AaveV4.CoreHub != 0n);
+  // The same contract, qualified by the chain's name, from a program on any chain.
+  require(Arc.AaveV4.CoreHub == AaveV4.CoreHub);
+}
+```
+
+## Tokens
+
+| Symbol | Address | Decimals |
+| --- | --- | --- |
+| `EURC` | `0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1` | 6 |
+| `USDC` | `0x3600000000000000000000000000000000000000` | 6 |
+| `USYC` | `0x8a5D989Bbb96929F689B0200f435f53dA42bF490` | 6 |
+| `WETH` | `0x128cC466B61f542da60c70e3aA11c10e19B84EDB` | 18 |
+
+## Protocols
+
+Every protocol the registry records here, each contract with how a program names it: its
+namespace contract, or its ABI imported from `./protocols/<slug>/<Export>.json` and bound to the
+address.
+
+| Protocol | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | coreHub | `0x17288dfc86205301064577b98B02b81017e6F79C` | `AaveV4.CoreHub` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | forexSpoke | `0x4164EBCAF74670aa74C8D4F59de6157c0780F1bB` | `AaveV4.ForexSpoke` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | mainSpoke | `0xB843bdC3a87A05E77E07Df9FE48928b3A34b134d` | `AaveV4.MainSpoke` |
+| [Across](../../sauce-protocols/references/registry/across.md) | spokePool | `0x9b4A302A548c7e313c2b74C461db7b84d3074A84` | `Across.SpokePool` |
+| [Aerodrome Slipstream](../../sauce-protocols/references/registry/aerodrome-slipstream.md) | clFactory | `0xb89Df768aF2CFE637ceB352c587Fe8edAf491d03` | `AerodromeSlipstream.CLFactory` |
+| [Aerodrome Slipstream](../../sauce-protocols/references/registry/aerodrome-slipstream.md) | metarouter | `0x7275FA44c67BbA8d921422e600B4ed396209c886` | `AerodromeSlipstream.Metarouter` |
+| [Aerodrome Slipstream](../../sauce-protocols/references/registry/aerodrome-slipstream.md) | nonfungiblePositionManager | `0xc84bB45D43CD25D02b83B4C085eaA4e08da8f473` | `AerodromeSlipstream.NonfungiblePositionManager` |
+| [CCTP](../../sauce-protocols/references/registry/cctp.md) | tokenMessenger | `0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d` | `Cctp.TokenMessenger` |
+| [Chainlink](../../sauce-protocols/references/registry/chainlink.md) | ethUsdFeed | `0x50FCDD99D6762D1C170DC6A9111db944AEE6D364` | `Chainlink.EthUsdFeed` |
+| [Chainlink CCIP](../../sauce-protocols/references/registry/chainlink-ccip.md) | router | `0xB79791184973589c38e114D43Eb8E4588C283A18` | `ChainlinkCcip.Router` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayMinter | `0x2222222d7164433c4C09B0b0D809a9b52C04C205` | `CircleGateway.GatewayMinter` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayWallet | `0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE` | `CircleGateway.GatewayWallet` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Hyperlane](../../sauce-protocols/references/registry/hyperlane.md) | mailbox | `0x7f50C5776722630a0024fAE05fDe8b47571D7B39` | `Hyperlane.Mailbox` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | metaAggregationRouterV2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `Kyberswap.MetaAggregationRouterV2` |
+| [KyberSwap Aggregator](../../sauce-protocols/references/registry/kyberswap-aggregator.md) | metaAggregationRouter | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `KyberswapAggregator.MetaAggregationRouter` |
+| [LayerZero](../../sauce-protocols/references/registry/layerzero.md) | endpointV2 | `0x6F475642a6e85809B1c36Fa62763669b1b48DD5B` | `Layerzero.EndpointV2` |
+| [LI.FI](../../sauce-protocols/references/registry/lifi.md) | lifiDiamond | `0xA4072583658Fae592A3506A42431cb6316a8d40b` | `Lifi.LiFiDiamond` |
+| [Morpho Blue](../../sauce-protocols/references/registry/morpho-blue.md) | morpho | `0x34CD04070dD72b14E241112F6d83812Df5Af7fCD` | `MorphoBlue.Morpho` |
+| [Permit2](../../sauce-protocols/references/registry/permit2.md) | permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` | `Permit2.Permit2` |
+| [Safe](../../sauce-protocols/references/registry/safe.md) | safeL2V130 | `0x3E5c63644E683549055b9Be8653de26E0B4CD36E` | `Safe.SafeL2V130` |
+| [Safe](../../sauce-protocols/references/registry/safe.md) | safeV141 | `0x41675C099F32341bf84BFc5382aF534df5C7461a` | `Safe.SafeV141` |
+| [Seaport](../../sauce-protocols/references/registry/seaport.md) | seaportV16 | `0x0000000000000068F116a894984e2DB1123eB395` | `Seaport.SeaportV16` |
+| [Synthra V3](../../sauce-protocols/references/registry/synthra-v3.md) | factory | `0x6307fc239C7964942c1BfFE51930E55606619c74` | `SynthraV3.Factory` |
+| [Synthra V3](../../sauce-protocols/references/registry/synthra-v3.md) | nonfungiblePositionManager | `0x2743b771659fD9CE13970d7367e7e84AF6a31049` | `SynthraV3.NonfungiblePositionManager` |
+| [Synthra V3](../../sauce-protocols/references/registry/synthra-v3.md) | quoterV2 | `0x9c179A7335B3fc841F59Aa6a62daf6d5c61b65D7` | `SynthraV3.QuoterV2` |
+| [Synthra V3](../../sauce-protocols/references/registry/synthra-v3.md) | swapRouter02 | `0xa50eDe66a573eE5bB37E28AF5789B76aE5FEb828` | `SynthraV3.SwapRouter02` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | factory | `0x89e5DB8B5aA49aA85AC63f691524311AEB649eba` | `UniswapV2.Factory` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | router | `0x1f7d7550B1b028f7571E69A784071F0205FD2EfA` | `UniswapV2.Router` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | factory | `0xf0db7b58379503491d857dB50AC9ece64c653918` | `UniswapV3.Factory` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | nonfungiblePositionManager | `0x39654A85A4C05127f5Fd6ED22CAeC077A0fB1377` | `UniswapV3.NonfungiblePositionManager` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | quoterV2 | `0x7DfD4F31be6814D2906BDE155c3e1B146EAc1468` | `UniswapV3.QuoterV2` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | swapRouter02 | `0x53BF6B0684Ec7eF91e1387Da3D1a1769bC5A6F77` | `UniswapV3.SwapRouter02` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | poolManager | `0x8366a39CC670B4001A1121B8F6A443A643e40951` | `UniswapV4.PoolManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | positionManager | `0x6049c9a0e26405C0985f9E3685C87d0aE917f82B` | `UniswapV4.PositionManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | stateView | `0xF3334192D15450CdD385c8B70e03f9A6bD9E673b` | `UniswapV4.StateView` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | universalRouter | `0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1` | `UniswapV4.UniversalRouter` |
+| [UnitFlow V3](../../sauce-protocols/references/registry/unitflow-v3.md) | factory | `0x5bfBCeb73d39F722B1cB83fD2F11736b28c1Be6d` | `UnitflowV3.Factory` |
+| [UnitFlow V3](../../sauce-protocols/references/registry/unitflow-v3.md) | quoter | `0x5AF6E89F0960Ff375AF84d9911D8153ef6240E34` | `UnitflowV3.Quoter` |
+| [UnitFlow V3](../../sauce-protocols/references/registry/unitflow-v3.md) | router | `0x6fD8351b9596C1F0b2f2479BfA6A171cb3d0f410` | `UnitflowV3.Router` |
+| [Wormhole](../../sauce-protocols/references/registry/wormhole.md) | coreBridge | `0xC8aD24fC6063c41cB5C12a8e3851AafC3b3CF027` | `Wormhole.CoreBridge` |

package/skills/sauce-chains/references/aurora.md

@@ -0,0 +1,33 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Aurora
+
+**Preview chain.** For the initial release, Sauce supports transactions on Ethereum, Base and Solana only.
+On Aurora a program compiles and simulates (`sauce compile`, `sauce simulate`, the dry
+runs), but the `sauce` command and the MCP server build and send no transaction: `sauce tx`,
+`sauce run`, `sauce pot --deploy`, `sauce intent publish` and the intent steps sent here are
+refused, naming the supported chains and how to request this one.
+
+To request Aurora, look for [its existing request](https://github.com/eco-incorp/sauce/issues?q=is%3Aissue+label%3Achain-support+%22Aurora%22) and add your
+use case to it, or [open one](https://github.com/eco-incorp/sauce/issues/new?template=chain-support.yml&title=Chain+support%3A+Aurora+%281313161554%29&chain=Aurora&chain-id=1313161554) with the chain-support issue form.
+
+| Fact | Value |
+| --- | --- |
+| Support | preview: compile and simulate; no transaction is built or sent |
+| Slug (`--chain`) | `aurora` |
+| Chain id | 1313161554 |
+| Kind | EVM |
+| Name in a program | `Aurora` |
+| Native coin | ETH (Ether), 18 decimals |
+| Sauce engine | `0x6785455AA479AA99D59357d7c9Fe14cba626F175` |
+| Sauce Kitchen | `0x19845b22989150E6B09dE55a661295Dd9188506b` |
+| Sauce Router | `0x9201aF06536Cb4819cf1F08aE7063c5997D87459` |
+| Intents (eco-routes) | none recorded |
+
+## Tokens
+
+The registry names no token on this chain: a program uses `Token(<address>)`.
+
+## Protocols
+
+The registry records no protocol deployment on this chain.

package/skills/sauce-chains/references/avalanche.md

@@ -0,0 +1,106 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Avalanche C-Chain
+
+**Preview chain.** For the initial release, Sauce supports transactions on Ethereum, Base and Solana only.
+On Avalanche C-Chain a program compiles and simulates (`sauce compile`, `sauce simulate`, the dry
+runs), but the `sauce` command and the MCP server build and send no transaction: `sauce tx`,
+`sauce run`, `sauce pot --deploy`, `sauce intent publish` and the intent steps sent here are
+refused, naming the supported chains and how to request this one.
+
+To request Avalanche C-Chain, look for [its existing request](https://github.com/eco-incorp/sauce/issues?q=is%3Aissue+label%3Achain-support+%22Avalanche+C-Chain%22) and add your
+use case to it, or [open one](https://github.com/eco-incorp/sauce/issues/new?template=chain-support.yml&title=Chain+support%3A+Avalanche+C-Chain+%2843114%29&chain=Avalanche+C-Chain&chain-id=43114) with the chain-support issue form.
+
+| Fact | Value |
+| --- | --- |
+| Support | preview: compile and simulate; no transaction is built or sent |
+| Slug (`--chain`) | `avalanche`; also `avax` |
+| Chain id | 43114 |
+| Kind | EVM |
+| Name in a program | `Avalanche` |
+| Native coin | AVAX (AVAX), 18 decimals |
+| Sauce engine | `0x6785455AA479AA99D59357d7c9Fe14cba626F175` |
+| Sauce Kitchen | `0x19845b22989150E6B09dE55a661295Dd9188506b` |
+| Sauce Router | `0x9201aF06536Cb4819cf1F08aE7063c5997D87459` |
+| Intents (eco-routes) | none recorded |
+| CCTP domain | 1 |
+
+## In a program
+
+Compiled with `--chain avalanche`, a program names Avalanche C-Chain's tokens and contracts with no
+import; the same file compiled for another chain resolves each name there, or fails where the
+chain does not have it.
+
+```sauce chain=avalanche
+function main() {
+  // `AaveV2.LendingPool` is Avalanche C-Chain's lendingPool: `0x4F01AeD16D97E3aB5ab2B501154DC9bb0F1A5A2C`.
+  require(AaveV2.LendingPool != 0n);
+  // The same contract, qualified by the chain's name, from a program on any chain.
+  require(Avalanche.AaveV2.LendingPool == AaveV2.LendingPool);
+}
+```
+
+## Tokens
+
+The registry names no token on this chain: a program uses `Token(<address>)`.
+
+## Protocols
+
+Every protocol the registry records here, each contract with how a program names it: its
+namespace contract, or its ABI imported from `./protocols/<slug>/<Export>.json` and bound to the
+address.
+
+| Protocol | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Aave V2](../../sauce-protocols/references/registry/aave-v2.md) | lendingPool | `0x4F01AeD16D97E3aB5ab2B501154DC9bb0F1A5A2C` | `AaveV2.LendingPool` |
+| [Aave V3](../../sauce-protocols/references/registry/aave-v3.md) | pool | `0x794a61358D6845594F94dc1DB02A252b5b4814aD` | `AaveV3.Pool` |
+| [Aave V3](../../sauce-protocols/references/registry/aave-v3.md) | poolAddressesProvider | `0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb` | `AaveV3.PoolAddressesProvider` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | avaxCorrelatedSpoke | `0x3b517594277c67307CF2d7CBE6FE1D4399B68c41` | `AaveV4.AvaxCorrelatedSpoke` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | coreHub | `0xd07369fAE4A5BB13c9Ce446B052c7867B1AbDf6e` | `AaveV4.CoreHub` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | forexSpoke | `0x6a37776B5E026dBdF043b4F933c323C84DD1B514` | `AaveV4.ForexSpoke` |
+| [Aave V4](../../sauce-protocols/references/registry/aave-v4.md) | mainSpoke | `0x435272CefF93a1E657E8ABfdf0A13e95900A3a56` | `AaveV4.MainSpoke` |
+| [Axelar](../../sauce-protocols/references/registry/axelar.md) | gateway | `0x5029C0EFf6C34351a0CEc334542cDb22c7928f78` | `Axelar.Gateway` |
+| [Axelar](../../sauce-protocols/references/registry/axelar.md) | its | `0xB5FB4BE02232B1bBA4dC8f81dc24C26980dE9e3C` | `Axelar.ITS` |
+| [Balancer V2](../../sauce-protocols/references/registry/balancer-v2.md) | vault | `0xBA12222222228d8Ba445958a75a0704d566BF2C8` | `BalancerV2.Vault` |
+| [Beefy Finance](../../sauce-protocols/references/registry/beefy.md) | BIFI | `0xd6070ae98b8069de6B494332d1A1a81B6179D960` | `Beefy.BIFI` |
+| [Benqi](../../sauce-protocols/references/registry/benqi.md) | comptroller | `0x486Af39519B4Dc9a7fCcd318217352830E8AD9b4` | `Benqi.Comptroller` |
+| [CCTP](../../sauce-protocols/references/registry/cctp.md) | tokenMessenger | `0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d` | `Cctp.TokenMessenger` |
+| [Celer Network](../../sauce-protocols/references/registry/celer.md) | bridge | `0xef3c714c9425a8F3697A9C969Dc1af30ba82e5d4` | `Celer.Bridge` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayMinter | `0x2222222d7164433c4C09B0b0D809a9b52C04C205` | `CircleGateway.GatewayMinter` |
+| [Circle Gateway](../../sauce-protocols/references/registry/circle-gateway.md) | gatewayWallet | `0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE` | `CircleGateway.GatewayWallet` |
+| [Curve Finance](../../sauce-protocols/references/registry/curve.md) | addressProvider | `0x0000000022D53366457F9d5E68Ec105046FC4383` | `Curve.AddressProvider` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnDestination | `0xE7351Fd770A37282b91D153Ee690B63579D6dd7f` | `Debridge.DlnDestination` |
+| [deBridge](../../sauce-protocols/references/registry/debridge.md) | dlnSource | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | `Debridge.DlnSource` |
+| [Gelato Network](../../sauce-protocols/references/registry/gelato.md) | automate | `0x2A6C106ae13B558BB9E2Ec64Bd2f1f7BEFF3A5E0` | `Gelato.Automate` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | router | `0x5F719c2F1095F7B9fc68a68e35B51194f4b6abe8` | `GmxV1.Router` |
+| [GMX V1](../../sauce-protocols/references/registry/gmx-v1.md) | vault | `0x9ab2De34A33fB459b538c43f251eB825645e8595` | `GmxV1.Vault` |
+| [Hyperlane](../../sauce-protocols/references/registry/hyperlane.md) | mailbox | `0xFf06aFcaABaDDd1fb08371f9ccA15D73D51FeBD6` | `Hyperlane.Mailbox` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | elasticFactory | `0x5F1dddbf348aC2fbe22a163e30F99F9ECE3DD50a` | `Kyberswap.ElasticFactory` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | elasticRouter | `0xC1e7dFE73E1598E3910EF4C7845B68A9Ab6F4c83` | `Kyberswap.ElasticRouter` |
+| [KyberSwap](../../sauce-protocols/references/registry/kyberswap.md) | metaAggregationRouterV2 | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `Kyberswap.MetaAggregationRouterV2` |
+| [KyberSwap Aggregator](../../sauce-protocols/references/registry/kyberswap-aggregator.md) | metaAggregationRouter | `0x6131B5fae19EA4f9D964eAc0408E4408b66337b5` | `KyberswapAggregator.MetaAggregationRouter` |
+| [LayerZero](../../sauce-protocols/references/registry/layerzero.md) | endpointV2 | `0x1a44076050125825900e736c501f859c50fE728c` | `Layerzero.EndpointV2` |
+| [LI.FI](../../sauce-protocols/references/registry/lifi.md) | lifiDiamond | `0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE` | `Lifi.LiFiDiamond` |
+| [1inch](../../sauce-protocols/references/registry/oneinch.md) | aggregationRouterV6 | `0x111111125421cA6dc452d289314280a0f8842A65` | `Oneinch.AggregationRouterV6` |
+| [OpenOcean](../../sauce-protocols/references/registry/openocean.md) | exchangeV2 | `0x6352a56caadC4F1E25CD6c75970Fa768A3304e64` | `Openocean.ExchangeV2` |
+| [ParaSwap](../../sauce-protocols/references/registry/paraswap.md) | augustusV5 | `0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57` | `Paraswap.AugustusV5` |
+| [ParaSwap](../../sauce-protocols/references/registry/paraswap.md) | augustusV6 | `0x6A000F20005980200259B80c5102003040001068` | `Paraswap.AugustusV6` |
+| [Permit2](../../sauce-protocols/references/registry/permit2.md) | permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` | `Permit2.Permit2` |
+| [Socket](../../sauce-protocols/references/registry/socket.md) | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` | `Socket.SocketGateway` |
+| [Squid Router](../../sauce-protocols/references/registry/squid.md) | squidRouter | `0xce16F69375520ab01377ce7B88f5BA8C48F8D666` | `Squid.SquidRouter` |
+| [SushiSwap V2](../../sauce-protocols/references/registry/sushiswap-v2.md) | factory | `0xc35DADB65012eC5796536bD9864eD8773aBc74C4` | `SushiswapV2.Factory` |
+| [SushiSwap V2](../../sauce-protocols/references/registry/sushiswap-v2.md) | router | `0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506` | `SushiswapV2.Router` |
+| [Synapse Protocol](../../sauce-protocols/references/registry/synapse.md) | synapseBridge | `0xC05e61d0E7a63D27546389B7aD62FdFf5A91aACE` | `Synapse.SynapseBridge` |
+| [Trader Joe](../../sauce-protocols/references/registry/trader-joe.md) | lbFactory | `0xb43120c4745967fa9b93E79C149E66B0f2D6Fe0c` | `TraderJoe.LBFactory` |
+| [Trader Joe](../../sauce-protocols/references/registry/trader-joe.md) | lbRouter | `0x18556DA13313f3532c54711497A8FedAC273220E` | `TraderJoe.LBRouter` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | factory | `0x9e5A52f57b3038F1B8EeE45F28b3C1967e22799C` | `UniswapV2.Factory` |
+| [Uniswap V2](../../sauce-protocols/references/registry/uniswap-v2.md) | router | `0x4752ba5dbc23f44d87826276bf6fd6b1c372ad24` | `UniswapV2.Router` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | factory | `0x740b1c1de25031C31FF4fC9A62f554A55cdC1baD` | `UniswapV3.Factory` |
+| [Uniswap V3](../../sauce-protocols/references/registry/uniswap-v3.md) | swapRouter02 | `0xbb00FF08d01D300023C629E8fFfFcb65A5a578cE` | `UniswapV3.SwapRouter02` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | poolManager | `0x06380c0e0912312b5150364b9dc4542ba0dbbc85` | `UniswapV4.PoolManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | positionManager | `0xb74b1f14d2754acfcbbe1a221023a5cf50ab8acd` | `UniswapV4.PositionManager` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | stateView | `0xc3c9e198c735a4b97e3e683f391ccbdd60b69286` | `UniswapV4.StateView` |
+| [Uniswap V4](../../sauce-protocols/references/registry/uniswap-v4.md) | universalRouter | `0x94b75331ae8d42c1b61065089b7d48fe14aa73b7` | `UniswapV4.UniversalRouter` |
+| [Wormhole](../../sauce-protocols/references/registry/wormhole.md) | coreBridge | `0x54a8e5f9c4CbA08F9943965859F6c34eAF03E26c` | `Wormhole.CoreBridge` |
+| [Wormhole](../../sauce-protocols/references/registry/wormhole.md) | tokenBridge | `0x0e082F06FF657D94310cB8cE8B0D9a04541d8052` | `Wormhole.TokenBridge` |
+| [0x Protocol](../../sauce-protocols/references/registry/zerox.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |