@eco-incorp/sauce 0.99.5 → 0.99.7

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

@@ -0,0 +1,44 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# 0x Protocol (`zerox`)
+
+DEX aggregation protocol powering swaps across the DeFi ecosystem. Exchange Proxy provides a single entry point for token swaps across multiple sources.
+
+| Fact | Value |
+| --- | --- |
+| Category | Aggregators |
+| Family | none |
+| Namespace | `Zerox` on ethereum, optimism, bsc, polygon, base, arbitrum, avalanche |
+| Chains | ethereum, optimism, bsc, polygon, base, arbitrum, avalanche |
+| Document | [zerox.md](../zerox.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Zerox` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's exchangeProxy, `0xDef1C0ded9bec7F1a1670819833240f027b25EfF`.
+  require(Zerox.ExchangeProxy != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | exchangeProxy | `0xDEF1ABE32c034e558Cdd535791643C58a13aCC10` | `Zerox.ExchangeProxy` |
+| [BNB Chain](../../../sauce-chains/references/bsc.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+| [Base](../../../sauce-chains/references/base.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | exchangeProxy | `0xDef1C0ded9bec7F1a1670819833240f027b25EfF` | `Zerox.ExchangeProxy` |
+
+## ABI
+
+### `ExchangeProxyABI`
+
+`import ExchangeProxyABI from "./protocols/zerox/ExchangeProxyABI.json";` Speaks for: exchangeProxy.
+
+- `transformERC20(address inputToken, address outputToken, uint256 inputTokenAmount, uint256 minOutputTokenAmount, (uint32 deploymentNonce, bytes data)[] transformations) payable returns (uint256 outputTokenAmount)`

package/skills/sauce-protocols/references/registry/zksync-bridge.md

@@ -0,0 +1,40 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# zkSync Native Bridge (`zksync-bridge`)
+
+Official zkSync Era bridge via DiamondProxy. Deposits ETH and ERC-20 tokens from Ethereum to zkSync with ZK proof-based finality.
+
+| Fact | Value |
+| --- | --- |
+| Category | Bridges |
+| Family | none |
+| Namespace | `ZksyncBridge` on ethereum, zksync |
+| Chains | ethereum, zksync |
+| Document | [zksync-bridge.md](../zksync-bridge.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `ZksyncBridge` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's diamondProxy, `0x32400084C286CF3E17e7B677ea9583e60a000324`.
+  require(ZksyncBridge.DiamondProxy != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | diamondProxy | `0x32400084C286CF3E17e7B677ea9583e60a000324` | `ZksyncBridge.DiamondProxy` |
+| [zkSync Era](../../../sauce-chains/references/zksync.md) | l2Bridge | `0x11f943b2c77b743AB90f4A0Ae7d5A4e7FCA3E102` | `ZksyncBridge.L2Bridge` |
+
+## ABI
+
+### `ZkSyncDiamondProxyABI`
+
+`import ZkSyncDiamondProxyABI from "./protocols/zksync-bridge/ZkSyncDiamondProxyABI.json";` Speaks for: diamondProxy.
+
+- `requestL2Transaction(address _contractL2, uint256 _l2Value, bytes _calldata, uint256 _l2GasLimit, uint256 _l2GasPerPubdataByteLimit, bytes[] _factoryDeps, address _refundRecipient) payable returns (bytes32 canonicalTxHash)`
+- `l2TransactionBaseCost(uint256 _gasPrice, uint256 _l2GasLimit, uint256 _l2GasPerPubdataByteLimit) view returns (uint256)`

package/{sdk/src/skills → skills/sauce-protocols/references}/renzo.md

@@ -4,20 +4,19 @@ Liquid restaking protocol built on EigenLayer. Deposit ETH or LSTs and receive e
 
 ## Category
 
-restaking | Chains: Ethereum
+restaking | Chains and addresses: [registry/renzo.md](registry/renzo.md)
 
 ## Key Operations
 
 - **depositETH**: Deposit ETH directly to receive ezETH
 - **deposit**: Deposit LST collateral (stETH, etc.) to receive ezETH
 
-## SDK Usage
+## Typed templates for the raw compiler (not for `sauce compile`)
 
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/renzo";
-```
-
-## SauceScript Examples
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ```typescript
 // Deposit ETH for ezETH
@@ -37,24 +36,11 @@ function main(restakeManagerAddress: Address, collateralToken: Address, amount:
 }
 ```
 
-## Key Addresses
-
-| Chain    | Contract       | Address                                      |
-| -------- | -------------- | -------------------------------------------- |
-| Ethereum | ezETH          | `0xbf5495Efe5DB9ce00f80364C8B423567e58d2110` |
-| Ethereum | restakeManager | `0x74a09653A083691711cF8215a6ab074BB4e99ef5` |
-
-## ABI Methods
-
-### RestakeManagerABI
-
-- `deposit(address,uint256)` - Deposit LST collateral for ezETH (not payable). Approve token first
-- `depositETH()` - Deposit ETH (payable) for ezETH. Send ETH as msg.value
-
-### EzETHABI
+## Deployments and ABI
 
-- `balanceOf(address)` - Query ezETH balance
-- `approve(address,uint256)` - Approve ezETH spending
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/renzo.md](registry/renzo.md).
 
 ## Notes
 

package/{sdk/src/skills → skills/sauce-protocols/references}/rocket-pool.md

@@ -4,20 +4,19 @@ Decentralised Ethereum liquid staking protocol. Stake ETH and receive rETH, a no
 
 ## Category
 
-liquid-staking | Chains: Ethereum
+liquid-staking | Chains and addresses: [registry/rocket-pool.md](registry/rocket-pool.md)
 
 ## Key Operations
 
 - **deposit**: Stake ETH and receive rETH
 - **burn**: Burn rETH to redeem ETH (subject to pool liquidity)
 
-## SDK Usage
+## Typed templates for the raw compiler (not for `sauce compile`)
 
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/rocket-pool";
-```
-
-## SauceScript Examples
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ```typescript
 // Deposit ETH for rETH
@@ -37,26 +36,11 @@ function main(rethAddress: Address, amount: Uint256): Uint256 {
 }
 ```
 
-## Key Addresses
-
-| Chain    | Contract          | Address                                      |
-| -------- | ----------------- | -------------------------------------------- |
-| Ethereum | rETH              | `0xae78736Cd615f374D3085123A210448E74Fc6393` |
-| Ethereum | rocketDepositPool | `0xDD3f50F8A6CafbE9b31a427582963f465E745AF8` |
-
-## ABI Methods
-
-### RocketDepositPoolABI
-
-- `deposit()` - Stake ETH (payable), receive rETH. Send ETH as msg.value
-
-### RETHABI
+## Deployments and ABI
 
-- `getExchangeRate()` - Current rETH/ETH exchange rate (18 decimals)
-- `getRethValue(uint256)` - Convert ETH amount to rETH equivalent
-- `getEthValue(uint256)` - Convert rETH amount to ETH equivalent
-- `burn(uint256)` - Burn rETH to receive ETH. May fail if insufficient deposit pool liquidity
-- `balanceOf(address)` - Query rETH balance
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/rocket-pool.md](registry/rocket-pool.md).
 
 ## Notes
 

package/{sdk/src/skills → skills/sauce-protocols/references}/sablier.md

@@ -4,7 +4,7 @@ Token streaming protocol for continuous payments. Supports linear, cliff, and dy
 
 ## Category
 
-payments | Chains: Ethereum
+payments | Chains and addresses: [registry/sablier.md](registry/sablier.md)
 
 ## Key Operations
 
@@ -12,13 +12,12 @@ payments | Chains: Ethereum
 - **cancelStream**: Cancel a stream and return remaining tokens to sender
 - **createWithDurations**: Create a new linear stream with cliff and total duration
 
-## SDK Usage
+## Typed templates for the raw compiler (not for `sauce compile`)
 
-```typescript
-import { protocolInfo, deployments, sauceFunctions } from "@eco-incorp/sauce/protocols/sablier";
-```
-
-## SauceScript Examples
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ```typescript
 // Withdraw from stream
@@ -43,27 +42,11 @@ function main(lockupLinearAddress: Address, streamId: Uint256): Uint256 {
 }
 ```
 
-## Key Addresses
-
-| Chain    | Contract     | Address                                      |
-| -------- | ------------ | -------------------------------------------- |
-| Ethereum | lockupLinear | `0xAFb979d9afAd1aD27C5eFf4E27226E3AB9e5dCC9` |
-
-## ABI Methods
-
-### LockupLinearABI
+## Deployments and ABI
 
-- `createWithDurations(tuple)` - Create linear stream. Returns streamId. Params tuple:
-  - `sender` (address) - Who funds the stream
-  - `recipient` (address) - Who receives tokens
-  - `totalAmount` (uint128) - Total tokens to stream
-  - `asset` (address) - ERC-20 token to stream
-  - `cancelable` (bool) - Whether sender can cancel
-  - `transferable` (bool) - Whether stream NFT is transferable
-  - `durations` (tuple) - `{ cliff (uint40), total (uint40) }` in seconds
-  - `broker` (tuple) - `{ account (address), fee (uint256) }` - referral fee
-- `withdraw(uint256,address,uint128)` - Withdraw accrued tokens. Params: streamId, to (recipient), amount (tokens to withdraw, uint128)
-- `cancel(uint256)` - Cancel stream. Params: streamId. Returns unstreamed tokens to sender, accrued to recipient
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/sablier.md](registry/sablier.md).
 
 ## Notes
 

package/skills/sauce-protocols/references/safe.md

@@ -0,0 +1,42 @@
+# Safe
+
+The most trusted multi-signature smart contract wallet, securing billions in digital assets. Supports programmable account abstraction and modular security.
+
+## Category
+
+infrastructure | Chains and addresses: [registry/safe.md](registry/safe.md)
+
+## Key Operations
+
+- **getThreshold**: Query the signing threshold of a Safe multisig
+- **execTransaction**: Execute a transaction with collected signatures
+
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
+
+```typescript
+// Get Safe threshold
+import { SafeABI as ISafe } from "./abis";
+function main(safeAddress: Address): Uint256 {
+  const safe = ISafe.at(safeAddress);
+  return safe.getThreshold();
+}
+```
+
+## Deployments and ABI
+
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/safe.md](registry/safe.md).
+
+## Notes
+
+- Secures $100B+ in assets across DeFi
+- safeV141 is for Ethereum L1; safeL2V130 is the L2-optimized version (emits events for cheaper indexing)
+- operation: 0 = CALL (normal), 1 = DELEGATECALL (execute in Safe context)
+- signatures are sorted by owner address, packed as 65 bytes each (r, s, v)
+- Modular: supports Guards (pre/post checks), Modules (extend functionality), and Fallback handlers

package/{sdk/src/skills → skills/sauce-protocols/references}/scroll-bridge.md

@@ -4,9 +4,14 @@ Official Scroll zkEVM bridge via L1ScrollMessenger and L1GatewayRouter. Deposits
 
 ## Category
 
-native L2 bridge | Direction: L1 to L2 (Ethereum to Scroll) | Chains: Ethereum (1), Scroll (534352)
+native L2 bridge | Direction: L1 to L2 (Ethereum to Scroll) | Chains and addresses: [registry/scroll-bridge.md](registry/scroll-bridge.md)
 
-## SauceScript Functions
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ### depositETH
 
@@ -51,25 +56,11 @@ function main(
 - Requires ERC-20 approval to the L1GatewayRouter
 - Requires ETH as msg.value for L2 gas fees
 
-## Deployed Addresses
-
-| Chain    | Contract          | Address                                      |
-| -------- | ----------------- | -------------------------------------------- |
-| Ethereum | l1ScrollMessenger | `0x6774Bcbd5ceCeF1336b5300fb5186a12DDD8b367` |
-| Ethereum | l1GatewayRouter   | `0xF8B1378579659D8F7EE5f3C929c2f3E332E41Fd6` |
-| Scroll   | l2ScrollMessenger | `0x781e90f1c8Fc4611c9b7497C3B47F99Ef6969CbC` |
-| Scroll   | l2GatewayRouter   | `0x4C0926FF5252A435FD19e10ED15e5a249Ba19d79` |
-
-## ABI Reference
-
-### ScrollL1GatewayRouterABI
-
-- `depositETH(uint256 _amount, uint256 _gasLimit)` [payable] - Deposit ETH to your own address on Scroll
-- `depositERC20(address _token, uint256 _amount, uint256 _gasLimit)` [payable] - Deposit ERC-20 tokens to your own address on Scroll
-
-### ScrollL1MessengerABI
+## Deployments and ABI
 
-- `sendMessage(address to, uint256 value, bytes message, uint256 gasLimit)` [payable] - Send arbitrary message from L1 to L2 (low-level messaging)
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/scroll-bridge.md](registry/scroll-bridge.md).
 
 ## Notes
 

package/{sdk/src/skills → skills/sauce-protocols/references}/seamless.md

@@ -4,9 +4,14 @@ Native lending and borrowing protocol on Base. Aave V3 fork with integrated leve
 
 ## Category
 
-lending | Chains: Base (8453)
+lending | Chains and addresses: [registry/seamless.md](registry/seamless.md)
 
-## SauceScript Functions
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ### supply
 
@@ -85,21 +90,11 @@ function main(
 - `amount`: Use `type(uint256).max` to repay full debt
 - Requires ERC-20 approval to the Pool
 
-## Deployed Addresses
-
-| Chain | Contract              | Address                                      |
-| ----- | --------------------- | -------------------------------------------- |
-| Base  | pool                  | `0x8F44Fd754285aa6A2b8B9B97739B79746e0475a7` |
-| Base  | poolAddressesProvider | `0x0E02EB705be564c2bF0067928A8f8DD89a82B26E` |
-
-## ABI Reference
-
-### SeamlessPoolABI
+## Deployments and ABI
 
-- `supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode)` - Supply asset to earn interest
-- `withdraw(address asset, uint256 amount, address to) returns (uint256)` - Withdraw supplied asset
-- `borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf)` - Borrow against collateral
-- `repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf) returns (uint256)` - Repay debt
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/seamless.md](registry/seamless.md).
 
 ## Notes
 

package/skills/sauce-protocols/references/seaport.md

@@ -0,0 +1,38 @@
+# Seaport
+
+OpenSea's decentralized NFT marketplace protocol supporting flexible order types including English and Dutch auctions, collection offers, and trait-based offers.
+
+## Category
+
+nft-marketplace | Chains and addresses: [registry/seaport.md](registry/seaport.md)
+
+## Key Operations
+
+- **fulfillBasicOrder**: Fulfill a basic NFT buy/sell order
+- **cancel**: Cancel pending orders
+
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
+
+```typescript
+// Note: Seaport orders require off-chain signature creation via seaport-js SDK.
+// On-chain fulfillment uses the signed order parameters.
+```
+
+## Deployments and ABI
+
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/seaport.md](registry/seaport.md).
+
+## Notes
+
+- Same address across all 5 chains
+- Zone-based access control for order restrictions
+- Conduits are approved transfer proxies - conduitKey=bytes32(0) for default
+- basicOrderType encodes: ERC-721/1155 + ETH/ERC-20 payment + buy/sell direction
+- Orders are signed off-chain, fulfilled on-chain - use seaport-js SDK for order creation

package/{sdk/src/skills → skills/sauce-protocols/references}/silo.md

@@ -4,9 +4,14 @@ Permissionless lending protocol with isolated risk markets (Silos). Each Silo is
 
 ## Category
 
-lending | Chains: Ethereum (1), Arbitrum (42161)
+lending | Chains and addresses: [registry/silo.md](registry/silo.md)
 
-## SauceScript Functions
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ### deposit
 
@@ -76,25 +81,11 @@ function main(siloAddress: Address, asset: Address, amount: Uint256): Uint256 {
 
 - Requires ERC-20 approval to the Silo
 
-## Deployed Addresses
-
-| Chain    | Contract       | Address                                      |
-| -------- | -------------- | -------------------------------------------- |
-| Ethereum | siloRepository | `0xbACBBefda6fD1FbF5a2d6A79916F4B6124eD2D49` |
-| Arbitrum | siloRepository | `0x8658047e48CC09161f4152c79155Dac1d710Ff0a` |
-
-## ABI Reference
-
-### SiloABI
-
-- `deposit(address asset, uint256 amount, bool collateralOnly) returns (uint256 collateralAmount, uint256 collateralShare)` - Deposit asset into Silo
-- `withdraw(address asset, uint256 amount, bool collateralOnly) returns (uint256 withdrawnAmount, uint256 withdrawnShare)` - Withdraw deposited asset
-- `borrow(address asset, uint256 amount) returns (uint256 debtAmount, uint256 debtShare)` - Borrow asset against collateral
-- `repay(address asset, uint256 amount) returns (uint256 repaidAmount, uint256 repaidShare)` - Repay borrowed debt
-
-### SiloRepositoryABI
+## Deployments and ABI
 
-- `getSilo(address asset) returns (address silo)` - Look up Silo address for a given asset (view)
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/silo.md](registry/silo.md).
 
 ## Notes
 

package/{sdk/src/skills → skills/sauce-protocols/references}/socket.md

@@ -4,9 +4,14 @@ Cross-chain bridge aggregator that finds optimal routes across multiple bridges
 
 ## Category
 
-bridge aggregator | Direction: any-to-any | Chains: Ethereum (1), Arbitrum (42161), Optimism (10), Base (8453), Polygon (137), BSC (56), Avalanche (43114)
+bridge aggregator | Direction: any-to-any | Chains and addresses: [registry/socket.md](registry/socket.md)
 
-## SauceScript Functions
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ### bridge
 
@@ -27,23 +32,11 @@ function main(gatewayAddress: Address, routeId: Uint256, bridgeData: bytes): Uin
 - Socket requires off-chain route computation via their API before on-chain execution
 - Requires ERC-20 approval to the Socket Gateway
 
-## Deployed Addresses
-
-| Chain     | Contract      | Address                                      |
-| --------- | ------------- | -------------------------------------------- |
-| Ethereum  | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| Arbitrum  | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| Optimism  | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| Base      | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| Polygon   | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| BSC       | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-| Avalanche | socketGateway | `0x3a23F943181408EAC424116Af7b7790c94Cb97a5` |
-
-## ABI Reference
-
-### SocketGatewayABI
+## Deployments and ABI
 
-- `executeRoute(uint32 routeId, bytes routeData) returns (bytes result)` [payable] - Execute a route (bridge, swap, or combined). Returns result data
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/socket.md](registry/socket.md).
 
 ## Notes
 

package/skills/sauce-protocols/references/sommelier.md

@@ -0,0 +1,40 @@
+# Sommelier
+
+ERC-4626 strategy vaults (Cellars) managed by off-chain strategists via Cosmos validators. Automated DeFi portfolio management.
+
+## Category
+
+yield | Chains and addresses: [registry/sommelier.md](registry/sommelier.md)
+
+## Key Operations
+
+- **deposit**: Deposit assets into Cellar vault
+- **withdraw**: Withdraw assets from Cellar
+- **redeem**: Redeem Cellar shares
+
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
+
+```typescript
+// Deposit into Sommelier Cellar
+import { CellarABI as ICellar } from "./abis";
+
+function main(cellarAddress: Address, assets: Uint256, receiver: Address): Uint256 {
+  const cellar = ICellar.at(cellarAddress);
+  return cellar.deposit(assets, receiver);
+}
+```
+
+## Deployments and ABI
+
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/sommelier.md](registry/sommelier.md).
+
+## Notes
+
+- Cellars are ERC-4626 vaults. Strategies managed off-chain via Cosmos governance.

package/{sdk/src/skills → skills/sauce-protocols/references}/spark.md

@@ -4,9 +4,14 @@ Aave V3 fork operated by MakerDAO/Sky ecosystem. Offers competitive rates on DAI
 
 ## Category
 
-lending | Chains: Ethereum (1)
+lending | Chains and addresses: [registry/spark.md](registry/spark.md)
 
-## SauceScript Functions
+## Typed templates for the raw compiler (not for `sauce compile`)
+
+These import the protocol's ABI from `./abis`, the way the registry compiles them with the raw
+compiler; `sauce compile` has no such module. In a program for a chain, name the contract by its
+namespace, or import its ABI from `./protocols/<slug>/<Export>.json` as the registry file at the
+top of this document shows, and write SauceScript's values (`~0n`, not `type(uint256).max`).
 
 ### supply
 
@@ -87,21 +92,11 @@ function main(
 - `amount`: Use `type(uint256).max` to repay full debt
 - Requires ERC-20 approval to the Pool
 
-## Deployed Addresses
-
-| Chain    | Contract              | Address                                      |
-| -------- | --------------------- | -------------------------------------------- |
-| Ethereum | pool                  | `0xC13e21B648A5Ee794902342038FF3aDAB66BE987` |
-| Ethereum | poolAddressesProvider | `0x02C3eA4e34C0cBd694D2adFa2c690EECbC1793eE` |
-
-## ABI Reference
-
-### SparkPoolABI
+## Deployments and ABI
 
-- `supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode)` - Supply asset to earn interest
-- `withdraw(address asset, uint256 amount, address to) returns (uint256)` - Withdraw supplied asset
-- `borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf)` - Borrow against collateral
-- `repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf) returns (uint256)` - Repay debt
+The registry's addresses per chain, how a program names each contract there (a namespace, or
+an ABI import bound to the address), and the ABI functions are generated in
+[registry/spark.md](registry/spark.md).
 
 ## Notes