@aztec-labs/ethereum 6.0.0-nightly.20260829

package/dest/contracts/multicall.js

@@ -0,0 +1,266 @@
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { decodeFunctionResult, encodeFunctionData, multicall3Abi } from 'viem';
+import { tryDecodeRevertReason } from '../utils.js';
+export const MULTI_CALL_3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+/**
+ * Thrown by `Multicall3.forward` when the forwarder transaction lands but the receipt reports a
+ * reverted status. This is not expected (aggregate3 uses allowFailure: true), so callers should
+ * treat it as a fatal on-chain failure rather than retrying on a different publisher.
+ */ export class MulticallForwarderRevertedError extends Error {
+    receipt;
+    txState;
+    constructor(receipt, txState){
+        super(`Multicall3 forwarder tx reverted: ${receipt.transactionHash}`), this.receipt = receipt, this.txState = txState;
+        this.name = 'MulticallForwarderRevertedError';
+    }
+}
+/** ABI fragment for aggregate3Value — not included in viem's multicall3Abi. */ export const aggregate3ValueAbi = [
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: 'address',
+                        name: 'target',
+                        type: 'address'
+                    },
+                    {
+                        internalType: 'bool',
+                        name: 'allowFailure',
+                        type: 'bool'
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'value',
+                        type: 'uint256'
+                    },
+                    {
+                        internalType: 'bytes',
+                        name: 'callData',
+                        type: 'bytes'
+                    }
+                ],
+                internalType: 'struct Multicall3.Call3Value[]',
+                name: 'calls',
+                type: 'tuple[]'
+            }
+        ],
+        name: 'aggregate3Value',
+        outputs: [
+            {
+                components: [
+                    {
+                        internalType: 'bool',
+                        name: 'success',
+                        type: 'bool'
+                    },
+                    {
+                        internalType: 'bytes',
+                        name: 'returnData',
+                        type: 'bytes'
+                    }
+                ],
+                internalType: 'struct Multicall3.Result[]',
+                name: 'returnData',
+                type: 'tuple[]'
+            }
+        ],
+        stateMutability: 'payable',
+        type: 'function'
+    }
+];
+export class Multicall3 {
+    /**
+   * Returns true iff Multicall3 bytecode is deployed at MULTI_CALL_3_ADDRESS. An empty result from
+   * a non-existent contract would otherwise silently validate any bundle that uses Multicall3.
+   */ static async hasCode(l1TxUtils) {
+        const code = await l1TxUtils.getCode(EthAddress.fromString(MULTI_CALL_3_ADDRESS));
+        return !!code && code !== '0x';
+    }
+    /**
+   * Simulates an aggregate3 call composed of the given requests via eth_simulateV1 and decodes the
+   * per-entry Result[]. Entries that revert are returned with a decoded revertReason (if the request
+   * provided an abi).
+   *
+   * Use this to pre-validate a bundle before sending it through `Multicall3.forward`. The caller can
+   * drop reverted entries from the bundle and re-simulate with the reduced list to get an accurate
+   * `gasUsed`.
+   */ static async simulateAggregate3(requests, l1TxUtils, opts = {}) {
+        const calldata = encodeFunctionData({
+            abi: multicall3Abi,
+            functionName: 'aggregate3',
+            args: [
+                requests.map((r)=>({
+                        target: r.to,
+                        callData: r.data,
+                        allowFailure: true
+                    }))
+            ]
+        });
+        const stateOverrides = [
+            ...opts.stateOverrides ?? []
+        ];
+        if (opts.fakeSenderBalance !== undefined) {
+            stateOverrides.push({
+                address: l1TxUtils.getSenderAddress().toString(),
+                balance: opts.fakeSenderBalance
+            });
+        }
+        const simResult = await l1TxUtils.simulate({
+            to: MULTI_CALL_3_ADDRESS,
+            data: calldata,
+            gas: opts.gas
+        }, opts.blockOverrides, stateOverrides, multicall3Abi, {
+            fallbackGasEstimate: opts.fallbackGasEstimate
+        });
+        if (simResult.result === '0x') {
+            return {
+                kind: 'fallback',
+                gasUsed: simResult.gasUsed
+            };
+        }
+        const decoded = decodeFunctionResult({
+            abi: multicall3Abi,
+            functionName: 'aggregate3',
+            data: simResult.result
+        });
+        const entries = decoded.map((entry, i)=>{
+            if (entry.success) {
+                return {
+                    success: true,
+                    returnData: entry.returnData
+                };
+            }
+            const abi = requests[i].abi;
+            const revertReason = abi ? tryDecodeRevertReason(entry.returnData, abi) : undefined;
+            return {
+                success: false,
+                returnData: entry.returnData,
+                revertReason
+            };
+        });
+        return {
+            kind: 'decoded',
+            entries,
+            gasUsed: simResult.gasUsed
+        };
+    }
+    /**
+   * Sends a batch of requests through aggregate3. Individual calls may fail (allowFailure: true),
+   * but the top-level multicall is expected to land successfully. Throws if the send fails or if
+   * the receipt reports a reverted status.
+   */ static async forward(requests, l1TxUtils, gasConfig, blobConfig, opts = {}) {
+        if (opts.gasLimitRequired && !gasConfig?.gasLimit) {
+            throw new Error('Multicall gasLimit is required when gasLimitRequired is true');
+        }
+        const args = requests.filter((request)=>request.to !== null).map((r)=>({
+                target: r.to,
+                callData: r.data,
+                allowFailure: true
+            }));
+        const encodedForwarderData = encodeFunctionData({
+            abi: multicall3Abi,
+            functionName: 'aggregate3',
+            args: [
+                args
+            ]
+        });
+        const { receipt, state } = await l1TxUtils.sendAndMonitorTransaction({
+            to: MULTI_CALL_3_ADDRESS,
+            data: encodedForwarderData,
+            abi: multicall3Abi
+        }, gasConfig, blobConfig);
+        // This shouldn't happen. Any failure in individual calls is swallowed by forward since we set
+        // allowFailure to true for all calls, so a reverted status here would indicate a problem with
+        // the Multicall3 contract itself or the forwarder transaction (such as an out-of-gas).
+        if (receipt.status !== 'success') {
+            throw new MulticallForwarderRevertedError(receipt, state);
+        }
+        const stats = await l1TxUtils.getTransactionStats(receipt.transactionHash);
+        return {
+            receipt,
+            stats,
+            multicallData: encodedForwarderData,
+            state
+        };
+    }
+    /** Batch multiple value transfers into a single aggregate3Value call on Multicall3. */ static async forwardValue(calls, l1TxUtils, logger) {
+        const args = calls.map((c)=>({
+                target: c.to,
+                allowFailure: false,
+                value: c.value,
+                callData: '0x'
+            }));
+        const data = encodeFunctionData({
+            abi: aggregate3ValueAbi,
+            functionName: 'aggregate3Value',
+            args: [
+                args
+            ]
+        });
+        const totalValue = calls.reduce((sum, c)=>sum + c.value, 0n);
+        logger.info(`Sending aggregate3Value with ${calls.length} calls`, {
+            totalValue
+        });
+        const { receipt } = await l1TxUtils.sendAndMonitorTransaction({
+            to: MULTI_CALL_3_ADDRESS,
+            data,
+            value: totalValue
+        });
+        if (receipt.status !== 'success') {
+            throw new Error(`aggregate3Value transaction reverted: ${receipt.transactionHash}`);
+        }
+        return {
+            receipt
+        };
+    }
+}
+export async function deployMulticall3(l1Client, logger) {
+    const existing = await l1Client.getCode({
+        address: MULTI_CALL_3_ADDRESS
+    });
+    if (existing && existing !== '0x') {
+        logger.verbose('Multicall3 already deployed', {
+            address: MULTI_CALL_3_ADDRESS
+        });
+        return;
+    }
+    const deployer = '0x05f32b3cc3888453ff71b01135b34ff8e41263f2';
+    const sendEth = await l1Client.sendTransaction({
+        to: deployer,
+        value: 10n ** 17n
+    });
+    logger.info('Sent 0.1 ETH to deployer', {
+        deployer,
+        value: 10n ** 17n
+    });
+    const sendEthReceipt = await l1Client.waitForTransactionReceipt({
+        hash: sendEth
+    });
+    if (sendEthReceipt.status !== 'success') {
+        logger.error('Failed to send ETH to deployer', undefined, {
+            sendEthReceipt
+        });
+        throw new Error('Failed to send ETH to deployer');
+    } else {
+        logger.info('Sent 0.1 ETH to deployer', {
+            deployer,
+            value: 10n ** 17n
+        });
+    }
+    const tx = '0xf90f538085174876e800830f42408080b90f00608060405234801561001057600080fd5b50610ee0806100206000396000f3fe6080604052600436106100f35760003560e01c80634d2301cc1161008a578063a8b0574e11610059578063a8b0574e1461025a578063bce38bd714610275578063c3077fa914610288578063ee82ac5e1461029b57600080fd5b80634d2301cc146101ec57806372425d9d1461022157806382ad56cb1461023457806386d516e81461024757600080fd5b80633408e470116100c65780633408e47014610191578063399542e9146101a45780633e64a696146101c657806342cbb15c146101d957600080fd5b80630f28c97d146100f8578063174dea711461011a578063252dba421461013a57806327e86d6e1461015b575b600080fd5b34801561010457600080fd5b50425b6040519081526020015b60405180910390f35b61012d610128366004610a85565b6102ba565b6040516101119190610bbe565b61014d610148366004610a85565b6104ef565b604051610111929190610bd8565b34801561016757600080fd5b50437fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0140610107565b34801561019d57600080fd5b5046610107565b6101b76101b2366004610c60565b610690565b60405161011193929190610cba565b3480156101d257600080fd5b5048610107565b3480156101e557600080fd5b5043610107565b3480156101f857600080fd5b50610107610207366004610ce2565b73ffffffffffffffffffffffffffffffffffffffff163190565b34801561022d57600080fd5b5044610107565b61012d610242366004610a85565b6106ab565b34801561025357600080fd5b5045610107565b34801561026657600080fd5b50604051418152602001610111565b61012d610283366004610c60565b61085a565b6101b7610296366004610a85565b610a1a565b3480156102a757600080fd5b506101076102b6366004610d18565b4090565b60606000828067ffffffffffffffff8111156102d8576102d8610d31565b60405190808252806020026020018201604052801561031e57816020015b6040805180820190915260008152606060208201528152602001906001900390816102f65790505b5092503660005b8281101561047757600085828151811061034157610341610d60565b6020026020010151905087878381811061035d5761035d610d60565b905060200281019061036f9190610d8f565b6040810135958601959093506103886020850185610ce2565b73ffffffffffffffffffffffffffffffffffffffff16816103ac6060870187610dcd565b6040516103ba929190610e32565b60006040518083038185875af1925050503d80600081146103f7576040519150601f19603f3d011682016040523d82523d6000602084013e6103fc565b606091505b50602080850191909152901515808452908501351761046d577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260846000fd5b5050600101610325565b508234146104e6576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f4d756c746963616c6c333a2076616c7565206d69736d6174636800000000000060448201526064015b60405180910390fd5b50505092915050565b436060828067ffffffffffffffff81111561050c5761050c610d31565b60405190808252806020026020018201604052801561053f57816020015b606081526020019060019003908161052a5790505b5091503660005b8281101561068657600087878381811061056257610562610d60565b90506020028101906105749190610e42565b92506105836020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166105a66020850185610dcd565b6040516105b4929190610e32565b6000604051808303816000865af19150503d80600081146105f1576040519150601f19603f3d011682016040523d82523d6000602084013e6105f6565b606091505b5086848151811061060957610609610d60565b602090810291909101015290508061067d576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b50600101610546565b5050509250929050565b43804060606106a086868661085a565b905093509350939050565b6060818067ffffffffffffffff8111156106c7576106c7610d31565b60405190808252806020026020018201604052801561070d57816020015b6040805180820190915260008152606060208201528152602001906001900390816106e55790505b5091503660005b828110156104e657600084828151811061073057610730610d60565b6020026020010151905086868381811061074c5761074c610d60565b905060200281019061075e9190610e76565b925061076d6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff166107906040850185610dcd565b60405161079e929190610e32565b6000604051808303816000865af19150503d80600081146107db576040519150601f19603f3d011682016040523d82523d6000602084013e6107e0565b606091505b506020808401919091529015158083529084013517610851577f08c379a000000000000000000000000000000000000000000000000000000000600052602060045260176024527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060445260646000fd5b50600101610714565b6060818067ffffffffffffffff81111561087657610876610d31565b6040519080825280602002602001820160405280156108bc57816020015b6040805180820190915260008152606060208201528152602001906001900390816108945790505b5091503660005b82811015610a105760008482815181106108df576108df610d60565b602002602001015190508686838181106108fb576108fb610d60565b905060200281019061090d9190610e42565b925061091c6020840184610ce2565b73ffffffffffffffffffffffffffffffffffffffff1661093f6020850185610dcd565b60405161094d929190610e32565b6000604051808303816000865af19150503d806000811461098a576040519150601f19603f3d011682016040523d82523d6000602084013e61098f565b606091505b506020830152151581528715610a07578051610a07576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601760248201527f4d756c746963616c6c333a2063616c6c206661696c656400000000000000000060448201526064016104dd565b506001016108c3565b5050509392505050565b6000806060610a2b60018686610690565b919790965090945092505050565b60008083601f840112610a4b57600080fd5b50813567ffffffffffffffff811115610a6357600080fd5b6020830191508360208260051b8501011115610a7e57600080fd5b9250929050565b60008060208385031215610a9857600080fd5b823567ffffffffffffffff811115610aaf57600080fd5b610abb85828601610a39565b90969095509350505050565b6000815180845260005b81811015610aed57602081850181015186830182015201610ad1565b81811115610aff576000602083870101525b50601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160200192915050565b600082825180855260208086019550808260051b84010181860160005b84811015610bb1578583037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe001895281518051151584528401516040858501819052610b9d81860183610ac7565b9a86019a9450505090830190600101610b4f565b5090979650505050505050565b602081526000610bd16020830184610b32565b9392505050565b600060408201848352602060408185015281855180845260608601915060608160051b870101935082870160005b82811015610c52577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa0888703018452610c40868351610ac7565b95509284019290840190600101610c06565b509398975050505050505050565b600080600060408486031215610c7557600080fd5b83358015158114610c8557600080fd5b9250602084013567ffffffffffffffff811115610ca157600080fd5b610cad86828701610a39565b9497909650939450505050565b838152826020820152606060408201526000610cd96060830184610b32565b95945050505050565b600060208284031215610cf457600080fd5b813573ffffffffffffffffffffffffffffffffffffffff81168114610bd157600080fd5b600060208284031215610d2a57600080fd5b5035919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff81833603018112610dc357600080fd5b9190910192915050565b60008083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe1843603018112610e0257600080fd5b83018035915067ffffffffffffffff821115610e1d57600080fd5b602001915036819003821315610a7e57600080fd5b8183823760009101908152919050565b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc1833603018112610dc357600080fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa1833603018112610dc357600080fdfea2646970667358221220bb2b5c71a328032f97c676ae39a1ec2148d3e5d6f73d95e9b17910152d61f16264736f6c634300080c00331ca0edce47092c0f398cebf3ffc267f05c8e7076e3b89445e0fe50f6332273d4569ba01b0b9d000e19b24c5869b0fc3b22b0d6fa47cd63316875cbbd577d76e6fde086';
+    const deployTx = await l1Client.sendRawTransaction({
+        serializedTransaction: tx
+    });
+    const deployTxReceipt = await l1Client.waitForTransactionReceipt({
+        hash: deployTx
+    });
+    if (deployTxReceipt.status !== 'success') {
+        logger.error('Failed to deploy Multicall3', undefined, {
+            deployTxReceipt
+        });
+        throw new Error('Failed to deploy Multicall3');
+    } else {
+        logger.info('Deployed Multicall3');
+    }
+}

package/dest/contracts/outbox.d.ts

@@ -0,0 +1,64 @@
+import { OutboxAbi } from '@aztec/l1-artifacts/OutboxAbi';
+import type { EpochNumber } from '@aztec-labs/foundation/branded-types';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type GetContractReturnType, type Hex } from 'viem';
+import type { DeployAztecL1ContractsReturnType } from '../deploy_aztec_l1_contracts.js';
+import type { L1ReaderConfig } from '../l1_reader.js';
+import { type ViemClient } from '../types.js';
+export type ViemL1Actor = {
+    actor: Hex;
+    chainId: bigint;
+};
+export type ViemL2Actor = {
+    actor: Hex;
+    version: bigint;
+};
+export type ViemL2ToL1Msg = {
+    sender: ViemL2Actor;
+    recipient: ViemL1Actor;
+    content: Hex;
+};
+export declare class OutboxContract {
+    readonly client: ViemClient;
+    private readonly outbox;
+    static getFromL1ContractsValues(deployL1ContractsValues: DeployAztecL1ContractsReturnType): OutboxContract;
+    static getFromConfig(config: L1ReaderConfig): OutboxContract;
+    /**
+     * Storage slot of `epochs[epoch].roots[numCheckpointsInEpoch - 1]` in the Outbox contract.
+     *
+     * The Outbox lays out storage as `mapping(Epoch => EpochData) internal epochs` at base slot 0
+     * (ROLLUP and VERSION are immutable and do not occupy slots). For a mapping at slot `b`, the
+     * value for key `k` begins at `keccak256(abi.encode(k, b))`. `EpochData` starts with a fixed-
+     * size `bytes32[MAX_CHECKPOINTS_PER_EPOCH] roots` array, so `roots[i]` sits at the EpochData's
+     * base slot plus `i`. `numCheckpointsInEpoch` is 1-indexed (matches `Outbox.insert`/`consume`).
+     */
+    static getEpochRootStorageSlot(epoch: EpochNumber, numCheckpointsInEpoch: number): bigint;
+    constructor(client: ViemClient, address: Hex | EthAddress);
+    get address(): `0x${string}`;
+    getContract(): GetContractReturnType<typeof OutboxAbi, ViemClient>;
+    hasMessageBeenConsumedAtEpoch(epoch: EpochNumber, leafId: bigint): Promise<boolean>;
+    getRootData(epoch: EpochNumber, numCheckpointsInEpoch: number): Promise<`0x${string}`>;
+    /**
+     * Returns every root stored for `epoch`. Slot `i` of the returned array holds the root inserted
+     * for `numCheckpointsInEpoch = i + 1`, or `Fr.ZERO` if no proof of that depth has been inserted
+     * yet. The array length is always `MAX_CHECKPOINTS_PER_EPOCH`.
+     *
+     * @param opts - Optional viem read options. Pass `blockNumber` to pin the read to a specific L1
+     *   block, which is important for callers that want a consistent snapshot across multiple reads
+     *   (e.g. the archiver's outbox-trees resolver, which pins to the node's synced L1 block).
+     */
+    getRoots(epoch: EpochNumber, opts?: {
+        blockNumber?: bigint;
+    }): Promise<Fr[]>;
+    consume(message: ViemL2ToL1Msg, epoch: EpochNumber, numCheckpointsInEpoch: number, leafIndex: bigint, path: Hex[]): Promise<`0x${string}`>;
+    getMessageConsumedEvents(l1BlockHash: Hex): Promise<{
+        epoch: bigint;
+        root: Hex;
+        messageHash: Hex;
+        leafId: bigint;
+        numCheckpointsInEpoch: bigint;
+    }[]>;
+    private assertWallet;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3V0Ym94LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29udHJhY3RzL291dGJveC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFMUQsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sc0NBQXNDLENBQUM7QUFDeEUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQ3pELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUNoRSxPQUFPLEVBQUUsS0FBSyxxQkFBcUIsRUFBRSxLQUFLLEdBQUcsRUFBNEQsTUFBTSxNQUFNLENBQUM7QUFHdEgsT0FBTyxLQUFLLEVBQUUsZ0NBQWdDLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUN4RixPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUN0RCxPQUFPLEVBQWlDLEtBQUssVUFBVSxFQUFvQixNQUFNLGFBQWEsQ0FBQztBQUUvRixNQUFNLE1BQU0sV0FBVyxHQUFHO0lBQ3hCLEtBQUssRUFBRSxHQUFHLENBQUM7SUFDWCxPQUFPLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFFRixNQUFNLE1BQU0sV0FBVyxHQUFHO0lBQ3hCLEtBQUssRUFBRSxHQUFHLENBQUM7SUFDWCxPQUFPLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFFRixNQUFNLE1BQU0sYUFBYSxHQUFHO0lBQzFCLE1BQU0sRUFBRSxXQUFXLENBQUM7SUFDcEIsU0FBUyxFQUFFLFdBQVcsQ0FBQztJQUN2QixPQUFPLEVBQUUsR0FBRyxDQUFDO0NBQ2QsQ0FBQztBQUVGLHFCQUFhLGNBQWM7YUFrQ1AsTUFBTSxFQUFFLFVBQVU7SUFqQ3BDLE9BQU8sQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFzRDtJQUU3RSxNQUFNLENBQUMsd0JBQXdCLENBQUMsdUJBQXVCLEVBQUUsZ0NBQWdDLGtCQU14RjtJQUVELE1BQU0sQ0FBQyxhQUFhLENBQUMsTUFBTSxFQUFFLGNBQWMsa0JBSTFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSCxNQUFNLENBQUMsdUJBQXVCLENBQUMsS0FBSyxFQUFFLFdBQVcsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLFVBSy9FO0lBRUQsWUFDa0IsTUFBTSxFQUFFLFVBQVUsRUFDbEMsT0FBTyxFQUFFLEdBQUcsR0FBRyxVQUFVLEVBTTFCO0lBRUQsSUFBVyxPQUFPLGtCQUVqQjtJQUVNLFdBQVcsSUFBSSxxQkFBcUIsQ0FBQyxPQUFPLFNBQVMsRUFBRSxVQUFVLENBQUMsQ0FFeEU7SUFFTSw2QkFBNkIsQ0FBQyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUV0RTtJQUVNLFdBQVcsQ0FBQyxLQUFLLEVBQUUsV0FBVyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sMEJBRW5FO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDVSxRQUFRLENBQUMsS0FBSyxFQUFFLFdBQVcsRUFBRSxJQUFJLENBQUMsRUFBRTtRQUFFLFdBQVcsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEdBQUcsT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBR3hGO0lBRU0sT0FBTyxDQUNaLE9BQU8sRUFBRSxhQUFhLEVBQ3RCLEtBQUssRUFBRSxXQUFXLEVBQ2xCLHFCQUFxQixFQUFFLE1BQU0sRUFDN0IsU0FBUyxFQUFFLE1BQU0sRUFDakIsSUFBSSxFQUFFLEdBQUcsRUFBRSwwQkFJWjtJQUVZLHdCQUF3QixDQUNuQyxXQUFXLEVBQUUsR0FBRyxHQUNmLE9BQU8sQ0FBQztRQUFFLEtBQUssRUFBRSxNQUFNLENBQUM7UUFBQyxJQUFJLEVBQUUsR0FBRyxDQUFDO1FBQUMsV0FBVyxFQUFFLEdBQUcsQ0FBQztRQUFDLE1BQU0sRUFBRSxNQUFNLENBQUM7UUFBQyxxQkFBcUIsRUFBRSxNQUFNLENBQUE7S0FBRSxFQUFFLENBQUMsQ0FTMUc7SUFFRCxPQUFPLENBQUMsWUFBWTtDQU1yQiJ9

package/dest/contracts/outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/contracts/outbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,GAAG,EAA4D,MAAM,MAAM,CAAC;AAGtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAiC,KAAK,UAAU,EAAoB,MAAM,aAAa,CAAC;AAE/F,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,GAAG,CAAC;CACd,CAAC;AAEF,qBAAa,cAAc;aAkCP,MAAM,EAAE,UAAU;IAjCpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAE7E,MAAM,CAAC,wBAAwB,CAAC,uBAAuB,EAAE,gCAAgC,kBAMxF;IAED,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,cAAc,kBAI1C;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAK/E;IAED,YACkB,MAAM,EAAE,UAAU,EAClC,OAAO,EAAE,GAAG,GAAG,UAAU,EAM1B;IAED,IAAW,OAAO,kBAEjB;IAEM,WAAW,IAAI,qBAAqB,CAAC,OAAO,SAAS,EAAE,UAAU,CAAC,CAExE;IAEM,6BAA6B,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,oBAEtE;IAEM,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,0BAEnE;IAED;;;;;;;;OAQG;IACU,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAGxF;IAEM,OAAO,CACZ,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,WAAW,EAClB,qBAAqB,EAAE,MAAM,EAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,GAAG,EAAE,0BAIZ;IAEY,wBAAwB,CACnC,WAAW,EAAE,GAAG,GACf,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAS1G;IAED,OAAO,CAAC,YAAY;CAMrB"}

package/dest/contracts/outbox.js

@@ -0,0 +1,113 @@
+import { OutboxAbi } from '@aztec/l1-artifacts/OutboxAbi';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { encodeAbiParameters, getContract, hexToBigInt, keccak256 } from 'viem';
+import { getPublicClient } from '../client.js';
+import { isExtendedClient } from '../types.js';
+export class OutboxContract {
+    client;
+    outbox;
+    static getFromL1ContractsValues(deployL1ContractsValues) {
+        const { l1Client, l1ContractAddresses: { outboxAddress } } = deployL1ContractsValues;
+        return new OutboxContract(l1Client, outboxAddress.toString());
+    }
+    static getFromConfig(config) {
+        const client = getPublicClient(config);
+        const address = config.outboxAddress.toString();
+        return new OutboxContract(client, address);
+    }
+    /**
+   * Storage slot of `epochs[epoch].roots[numCheckpointsInEpoch - 1]` in the Outbox contract.
+   *
+   * The Outbox lays out storage as `mapping(Epoch => EpochData) internal epochs` at base slot 0
+   * (ROLLUP and VERSION are immutable and do not occupy slots). For a mapping at slot `b`, the
+   * value for key `k` begins at `keccak256(abi.encode(k, b))`. `EpochData` starts with a fixed-
+   * size `bytes32[MAX_CHECKPOINTS_PER_EPOCH] roots` array, so `roots[i]` sits at the EpochData's
+   * base slot plus `i`. `numCheckpointsInEpoch` is 1-indexed (matches `Outbox.insert`/`consume`).
+   */ static getEpochRootStorageSlot(epoch, numCheckpointsInEpoch) {
+        const epochDataSlot = hexToBigInt(keccak256(encodeAbiParameters([
+            {
+                type: 'uint256'
+            },
+            {
+                type: 'uint256'
+            }
+        ], [
+            BigInt(epoch),
+            0n
+        ])));
+        return epochDataSlot + BigInt(numCheckpointsInEpoch - 1);
+    }
+    constructor(client, address){
+        this.client = client;
+        if (address instanceof EthAddress) {
+            address = address.toString();
+        }
+        this.outbox = getContract({
+            address,
+            abi: OutboxAbi,
+            client
+        });
+    }
+    get address() {
+        return this.outbox.address;
+    }
+    getContract() {
+        return this.outbox;
+    }
+    hasMessageBeenConsumedAtEpoch(epoch, leafId) {
+        return this.outbox.read.hasMessageBeenConsumedAtEpoch([
+            BigInt(epoch),
+            leafId
+        ]);
+    }
+    getRootData(epoch, numCheckpointsInEpoch) {
+        return this.outbox.read.getRootData([
+            BigInt(epoch),
+            BigInt(numCheckpointsInEpoch)
+        ]);
+    }
+    /**
+   * Returns every root stored for `epoch`. Slot `i` of the returned array holds the root inserted
+   * for `numCheckpointsInEpoch = i + 1`, or `Fr.ZERO` if no proof of that depth has been inserted
+   * yet. The array length is always `MAX_CHECKPOINTS_PER_EPOCH`.
+   *
+   * @param opts - Optional viem read options. Pass `blockNumber` to pin the read to a specific L1
+   *   block, which is important for callers that want a consistent snapshot across multiple reads
+   *   (e.g. the archiver's outbox-trees resolver, which pins to the node's synced L1 block).
+   */ async getRoots(epoch, opts) {
+        const raw = await this.outbox.read.getRoots([
+            BigInt(epoch)
+        ], opts);
+        return raw.map((hex)=>Fr.fromString(hex));
+    }
+    consume(message, epoch, numCheckpointsInEpoch, leafIndex, path) {
+        const wallet = this.assertWallet();
+        return wallet.write.consume([
+            message,
+            BigInt(epoch),
+            BigInt(numCheckpointsInEpoch),
+            leafIndex,
+            path
+        ]);
+    }
+    async getMessageConsumedEvents(l1BlockHash) {
+        const events = await this.outbox.getEvents.MessageConsumed({}, {
+            blockHash: l1BlockHash,
+            strict: true
+        });
+        return events.map((event)=>({
+                epoch: event.args.epoch,
+                root: event.args.root,
+                messageHash: event.args.messageHash,
+                leafId: event.args.leafId,
+                numCheckpointsInEpoch: event.args.numCheckpointsInEpoch
+            }));
+    }
+    assertWallet() {
+        if (!isExtendedClient(this.client)) {
+            throw new Error('Wallet client is required for this operation');
+        }
+        return this.outbox;
+    }
+}

package/dest/contracts/registry.d.ts

@@ -0,0 +1,31 @@
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type Hex } from 'viem';
+import type { L1ContractAddresses } from '../l1_contract_addresses.js';
+import type { ViemClient } from '../types.js';
+export declare class RegistryContract {
+    readonly client: ViemClient;
+    address: EthAddress;
+    private readonly log;
+    private readonly registry;
+    constructor(client: ViemClient, address: Hex | EthAddress);
+    getOwner(): Promise<EthAddress>;
+    /**
+     * Returns the address of the rollup for a given version.
+     * @param version - The version of the rollup. 'canonical' can be used to get the canonical address (i.e. the latest version).
+     * @returns The address of the rollup. If the rollup is not set for this version, throws an error.
+     */
+    getRollupAddress(version: number | bigint | 'canonical'): Promise<EthAddress>;
+    /**
+     * Returns the canonical address of the rollup.
+     * @returns The canonical address of the rollup. If the rollup is not set, throws an error.
+     */
+    getCanonicalAddress(): Promise<EthAddress>;
+    getGovernanceAddresses(): Promise<Pick<L1ContractAddresses, 'governanceProposerAddress' | 'governanceAddress'>>;
+    static collectAddresses(client: ViemClient, registryAddress: Hex | EthAddress, rollupVersion: number | bigint | 'canonical'): Promise<L1ContractAddresses>;
+    getNumberOfVersions(): Promise<number>;
+    getRollupVersions(): Promise<bigint[]>;
+    getRewardDistributor(): Promise<EthAddress>;
+    /** Returns the L1 timestamp at which the given rollup was registered via addRollup(). */
+    getCanonicalRollupRegistrationTimestamp(rollupAddress: EthAddress, fromBlock?: bigint): Promise<bigint | undefined>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVnaXN0cnkuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdHMvcmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLG9DQUFvQyxDQUFDO0FBRWhFLE9BQU8sRUFBOEIsS0FBSyxHQUFHLEVBQTJCLE1BQU0sTUFBTSxDQUFDO0FBRXJGLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDdkUsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBSTlDLHFCQUFhLGdCQUFnQjthQU9ULE1BQU0sRUFBRSxVQUFVO0lBTjdCLE9BQU8sRUFBRSxVQUFVLENBQUM7SUFFM0IsT0FBTyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQStDO0lBQ25FLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUF3RDtJQUVqRixZQUNrQixNQUFNLEVBQUUsVUFBVSxFQUNsQyxPQUFPLEVBQUUsR0FBRyxHQUFHLFVBQVUsRUFPMUI7SUFFWSxRQUFRLElBQUksT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUUzQztJQUVEOzs7O09BSUc7SUFDVSxnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxXQUFXLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQXNCekY7SUFFRDs7O09BR0c7SUFDVSxtQkFBbUIsSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLENBRXREO0lBRVksc0JBQXNCLElBQUksT0FBTyxDQUM1QyxJQUFJLENBQUMsbUJBQW1CLEVBQUUsMkJBQTJCLEdBQUcsbUJBQW1CLENBQUMsQ0FDN0UsQ0FRQTtJQUVELE9BQW9CLGdCQUFnQixDQUNsQyxNQUFNLEVBQUUsVUFBVSxFQUNsQixlQUFlLEVBQUUsR0FBRyxHQUFHLFVBQVUsRUFDakMsYUFBYSxFQUFFLE1BQU0sR0FBRyxNQUFNLEdBQUcsV0FBVyxHQUMzQyxPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0F1QjlCO0lBRVksbUJBQW1CLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUdsRDtJQUVZLGlCQUFpQixJQUFJLE9BQU8sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQVNsRDtJQUVZLG9CQUFvQixJQUFJLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FFdkQ7SUFFRCx5RkFBeUY7SUFDNUUsdUNBQXVDLENBQ2xELGFBQWEsRUFBRSxVQUFVLEVBQ3pCLFNBQVMsQ0FBQyxFQUFFLE1BQU0sR0FDakIsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0F3QjdCO0NBQ0YifQ==

package/dest/contracts/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/contracts/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAA8B,KAAK,GAAG,EAA2B,MAAM,MAAM,CAAC;AAErF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,qBAAa,gBAAgB;aAOT,MAAM,EAAE,UAAU;IAN7B,OAAO,EAAE,UAAU,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwD;IAEjF,YACkB,MAAM,EAAE,UAAU,EAClC,OAAO,EAAE,GAAG,GAAG,UAAU,EAO1B;IAEY,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAE3C;IAED;;;;OAIG;IACU,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBzF;IAED;;;OAGG;IACU,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEtD;IAEY,sBAAsB,IAAI,OAAO,CAC5C,IAAI,CAAC,mBAAmB,EAAE,2BAA2B,GAAG,mBAAmB,CAAC,CAC7E,CAQA;IAED,OAAoB,gBAAgB,CAClC,MAAM,EAAE,UAAU,EAClB,eAAe,EAAE,GAAG,GAAG,UAAU,EACjC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;IAEY,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGlD;IAEY,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CASlD;IAEY,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEvD;IAED,yFAAyF;IAC5E,uCAAuC,CAClD,aAAa,EAAE,UAAU,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B;CACF"}

package/dest/contracts/registry.js

@@ -0,0 +1,142 @@
+import { RegistryAbi } from '@aztec/l1-artifacts/RegistryAbi';
+import { TestERC20Abi } from '@aztec/l1-artifacts/TestERC20Abi';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { createLogger } from '@aztec-labs/foundation/log';
+import { getAbiItem, getContract } from 'viem';
+import { ReadOnlyGovernanceContract } from './governance.js';
+import { RollupContract } from './rollup.js';
+export class RegistryContract {
+    client;
+    address;
+    log;
+    registry;
+    constructor(client, address){
+        this.client = client;
+        this.log = createLogger('ethereum:contracts:registry');
+        if (address instanceof EthAddress) {
+            address = address.toString();
+        }
+        this.address = EthAddress.fromString(address);
+        this.registry = getContract({
+            address,
+            abi: RegistryAbi,
+            client
+        });
+    }
+    async getOwner() {
+        return EthAddress.fromString(await this.registry.read.owner());
+    }
+    /**
+   * Returns the address of the rollup for a given version.
+   * @param version - The version of the rollup. 'canonical' can be used to get the canonical address (i.e. the latest version).
+   * @returns The address of the rollup. If the rollup is not set for this version, throws an error.
+   */ async getRollupAddress(version) {
+        if (version === 'canonical') {
+            return this.getCanonicalAddress();
+        }
+        if (typeof version === 'number') {
+            version = BigInt(version);
+        }
+        try {
+            return EthAddress.fromString(await this.registry.read.getRollup([
+                version
+            ]));
+        } catch  {
+            this.log.warn(`Failed fetching rollup address for version ${version}. Retrying as index.`);
+        }
+        try {
+            const actualVersion = await this.registry.read.getVersion([
+                version
+            ]);
+            const rollupAddress = await this.registry.read.getRollup([
+                actualVersion
+            ]);
+            return EthAddress.fromString(rollupAddress);
+        } catch  {
+            throw new Error('Rollup address is undefined');
+        }
+    }
+    /**
+   * Returns the canonical address of the rollup.
+   * @returns The canonical address of the rollup. If the rollup is not set, throws an error.
+   */ async getCanonicalAddress() {
+        return EthAddress.fromString(await this.registry.read.getCanonicalRollup());
+    }
+    async getGovernanceAddresses() {
+        const governanceAddress = await this.registry.read.getGovernance();
+        const governance = new ReadOnlyGovernanceContract(governanceAddress, this.client);
+        const governanceProposerAddress = await governance.getGovernanceProposerAddress();
+        return {
+            governanceAddress: governance.address,
+            governanceProposerAddress: governanceProposerAddress
+        };
+    }
+    static async collectAddresses(client, registryAddress, rollupVersion) {
+        const registry = new RegistryContract(client, registryAddress);
+        const governanceAddresses = await registry.getGovernanceAddresses();
+        const rollupAddress = await registry.getRollupAddress(rollupVersion);
+        if (rollupAddress === undefined) {
+            throw new Error('Rollup address is undefined');
+        }
+        const rollup = new RollupContract(client, rollupAddress);
+        const addresses = await rollup.getRollupAddresses();
+        const feeAsset = getContract({
+            address: addresses.feeJuiceAddress.toString(),
+            abi: TestERC20Abi,
+            client
+        });
+        const coinIssuer = await feeAsset.read.owner();
+        return {
+            registryAddress: registry.address,
+            ...governanceAddresses,
+            ...addresses,
+            coinIssuerAddress: EthAddress.fromString(coinIssuer)
+        };
+    }
+    async getNumberOfVersions() {
+        const version = await this.registry.read.numberOfVersions();
+        return Number(version);
+    }
+    async getRollupVersions() {
+        const count = await this.getNumberOfVersions();
+        const versions = [];
+        for(let i = 0; i < count; i++){
+            versions.push(await this.registry.read.getVersion([
+                BigInt(i)
+            ]));
+        }
+        return versions;
+    }
+    async getRewardDistributor() {
+        return EthAddress.fromString(await this.registry.read.getRewardDistributor());
+    }
+    /** Returns the L1 timestamp at which the given rollup was registered via addRollup(). */ async getCanonicalRollupRegistrationTimestamp(rollupAddress, fromBlock) {
+        const event = getAbiItem({
+            abi: RegistryAbi,
+            name: 'CanonicalRollupUpdated'
+        });
+        const start = fromBlock ?? 0n;
+        const latestBlock = await this.client.getBlockNumber();
+        const chunkSize = 1_000n;
+        for(let from = start; from <= latestBlock; from += chunkSize){
+            const to = from + chunkSize - 1n > latestBlock ? latestBlock : from + chunkSize - 1n;
+            const logs = await this.client.getLogs({
+                address: this.address.toString(),
+                fromBlock: from,
+                toBlock: to,
+                strict: true,
+                event,
+                args: {
+                    instance: rollupAddress.toString()
+                }
+            });
+            if (logs.length > 0) {
+                const block = await this.client.getBlock({
+                    blockNumber: logs[0].blockNumber
+                });
+                return block.timestamp;
+            }
+        }
+        return undefined;
+    }
+}