@eco-incorp/sauce 0.99.6 → 0.99.8

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

@@ -0,0 +1,59 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Wormhole (`wormhole`)
+
+Generic cross-chain messaging protocol with guardian-based attestation. Supports token bridging and arbitrary message passing across 30+ chains.
+
+| Fact | Value |
+| --- | --- |
+| Category | Cross-chain messaging |
+| Family | none |
+| Namespace | `Wormhole` on ethereum, optimism, polygon, arc, base, arbitrum, avalanche |
+| Chains | ethereum, optimism, polygon, arc, base, arbitrum, avalanche |
+| Document | [wormhole.md](../wormhole.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `Wormhole` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's coreBridge, `0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B`.
+  require(Wormhole.CoreBridge != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | coreBridge | `0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B` | `Wormhole.CoreBridge` |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | tokenBridge | `0x3ee18B2214AFF97000D974cf647E7C347E8fa585` | `Wormhole.TokenBridge` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | coreBridge | `0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722` | `Wormhole.CoreBridge` |
+| [Optimism](../../../sauce-chains/references/optimism.md) | tokenBridge | `0x1D68124e65faFC907325e3EDbF8c4d84499DAa8b` | `Wormhole.TokenBridge` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | coreBridge | `0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7` | `Wormhole.CoreBridge` |
+| [Polygon](../../../sauce-chains/references/polygon.md) | tokenBridge | `0x5a58505a96D1dbf8dF91cB21B54419FC36e93fdE` | `Wormhole.TokenBridge` |
+| [Arc](../../../sauce-chains/references/arc.md) | coreBridge | `0xC8aD24fC6063c41cB5C12a8e3851AafC3b3CF027` | `Wormhole.CoreBridge` |
+| [Base](../../../sauce-chains/references/base.md) | coreBridge | `0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6` | `Wormhole.CoreBridge` |
+| [Base](../../../sauce-chains/references/base.md) | tokenBridge | `0x8d2de8d2f73F1F4cAB472AC9A881C9b123C79627` | `Wormhole.TokenBridge` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | coreBridge | `0xa5f208e072434bC67592E4C49C1B991BA79BCA46` | `Wormhole.CoreBridge` |
+| [Arbitrum One](../../../sauce-chains/references/arbitrum.md) | tokenBridge | `0x0b2402144Bb366A632D14B83F244D2e0e21bD39c` | `Wormhole.TokenBridge` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | coreBridge | `0x54a8e5f9c4CbA08F9943965859F6c34eAF03E26c` | `Wormhole.CoreBridge` |
+| [Avalanche C-Chain](../../../sauce-chains/references/avalanche.md) | tokenBridge | `0x0e082F06FF657D94310cB8cE8B0D9a04541d8052` | `Wormhole.TokenBridge` |
+
+## ABI
+
+### `WormholeCoreBridgeABI`
+
+`import WormholeCoreBridgeABI from "./protocols/wormhole/WormholeCoreBridgeABI.json";` Speaks for: coreBridge.
+
+- `publishMessage(uint32 nonce, bytes payload, uint8 consistencyLevel) payable returns (uint64 sequence)`
+- `messageFee() view returns (uint256)`
+
+### `WormholeTokenBridgeABI`
+
+`import WormholeTokenBridgeABI from "./protocols/wormhole/WormholeTokenBridgeABI.json";` Speaks for: tokenBridge.
+
+- `transferTokens(address token, uint256 amount, uint16 recipientChain, bytes32 recipient, uint256 arbiterFee, uint32 nonce) payable returns (uint64 sequence)`
+- `completeTransfer(bytes encodedVm)`
+- `wrappedAsset(uint16 tokenChainId, bytes32 tokenAddress) view returns (address)`

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

@@ -0,0 +1,46 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# Yearn V3 (`yearn-v3`)
+
+Yield aggregator protocol. V3 vaults follow ERC-4626 standard for automated yield optimization strategies.
+
+| Fact | Value |
+| --- | --- |
+| Category | Yield and vaults |
+| Family | `Yearn`: `yearn-v3` |
+| Namespace | `YearnV3` on ethereum |
+| Chains | ethereum |
+| Document | [yearn-v3.md](../yearn-v3.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On Ethereum, `YearnV3` is a namespace: its contracts need no import.
+
+```sauce chain=ethereum
+function main() {
+  // Ethereum's vaultFactory, `0x770D0d1Fb036483Ed4AbB6d53c1C89fb277D812F`.
+  require(YearnV3.VaultFactory != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [Ethereum](../../../sauce-chains/references/ethereum.md) | vaultFactory | `0x770D0d1Fb036483Ed4AbB6d53c1C89fb277D812F` | `YearnV3.VaultFactory` |
+
+## ABI
+
+### `YearnV3VaultABI`
+
+`import YearnV3VaultABI from "./protocols/yearn-v3/YearnV3VaultABI.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)`
+- `convertToShares(uint256 assets) view returns (uint256)`
+- `convertToAssets(uint256 shares) view returns (uint256)`
+- `totalAssets() view returns (uint256)`
+- `pricePerShare() view returns (uint256)`
+- `balanceOf(address account) view returns (uint256)`
+- `approve(address spender, uint256 amount) returns (bool)`

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

@@ -0,0 +1,41 @@
+<!-- Generated from the SDK's registries. Do not edit. -->
+
+# ZeroLend (`zerolend`)
+
+Leading lending protocol on zkSync Era. Aave V3 fork optimized for zero-knowledge rollups with low transaction costs.
+
+| Fact | Value |
+| --- | --- |
+| Category | Lending |
+| Family | none |
+| Namespace | `Zerolend` on zksync |
+| Chains | zksync |
+| Document | [zerolend.md](../zerolend.md): what it is for, how to choose it, its pitfalls |
+
+## In a program
+
+On zkSync Era, `Zerolend` is a namespace: its contracts need no import.
+
+```sauce chain=zksync
+function main() {
+  // zkSync Era's pool, `0x4d9429246EA989C9CeE203B43F6d1C7D83e3B8F8`.
+  require(Zerolend.Pool != 0n);
+}
+```
+
+## Deployments
+
+| Chain | Contract | Address | In a program |
+| --- | --- | --- | --- |
+| [zkSync Era](../../../sauce-chains/references/zksync.md) | pool | `0x4d9429246EA989C9CeE203B43F6d1C7D83e3B8F8` | `Zerolend.Pool` |
+
+## ABI
+
+### `ZeroLendPoolABI`
+
+`import ZeroLendPoolABI from "./protocols/zerolend/ZeroLendPoolABI.json";` Speaks for: pool.
+
+- `supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode)`
+- `withdraw(address asset, uint256 amount, address to) returns (uint256)`
+- `borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf)`
+- `repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf) returns (uint256)`

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