@aztec/ethereum 0.0.0-test.0

package/README.md

@@ -0,0 +1,3 @@
+# Ethereum
+
+This package provides configuration and code for common chain operations such as contract deployment etc.

package/dest/chain.d.ts

@@ -0,0 +1,25 @@
+import type { Chain } from 'viem';
+/**
+ * Interface containing the connection and chain properties to interact with a blockchain.
+ */
+export interface EthereumChain {
+    /**
+     * An instance of the viem chain data.
+     */
+    chainInfo: Chain;
+    /**
+     * The list of actual urls to be used.
+     */
+    rpcUrls: string[];
+}
+/**
+ * Helper function to create an instance of Aztec Chain from an rpc url and chain id.
+ * @param rpcUrls - The rpc url of the chain or a chain identifier (e.g. 'http://localhost:8545')
+ * @param chainId - The chain id of the chain or a chain identifier (e.g. 1337)
+ */
+export declare function createEthereumChain(rpcUrls: string[], _chainId: number | string): EthereumChain;
+/**
+ * Helper function to determine if a chain id is an instance of Anvil
+ */
+export declare function isAnvilTestChain(_chainId: number | string): boolean;
+//# sourceMappingURL=chain.d.ts.map

package/dest/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAKlC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CA+B/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CASnE"}

package/dest/chain.js

@@ -0,0 +1,53 @@
+import { foundry } from 'viem/chains';
+import { AZTEC_TEST_CHAIN_ID } from './constants.js';
+/**
+ * Helper function to create an instance of Aztec Chain from an rpc url and chain id.
+ * @param rpcUrls - The rpc url of the chain or a chain identifier (e.g. 'http://localhost:8545')
+ * @param chainId - The chain id of the chain or a chain identifier (e.g. 1337)
+ */ export function createEthereumChain(rpcUrls, _chainId) {
+    let chainId;
+    if (typeof _chainId === 'string') {
+        chainId = +_chainId;
+    } else {
+        chainId = _chainId;
+    }
+    if (chainId) {
+        return {
+            chainInfo: {
+                id: chainId,
+                name: 'Ethereum',
+                rpcUrls: {
+                    default: {
+                        http: rpcUrls
+                    }
+                },
+                nativeCurrency: {
+                    decimals: 18,
+                    name: 'Ether',
+                    symbol: 'ETH'
+                }
+            },
+            rpcUrls
+        };
+    } else {
+        return {
+            chainInfo: foundry,
+            rpcUrls
+        };
+    }
+}
+/**
+ * Helper function to determine if a chain id is an instance of Anvil
+ */ export function isAnvilTestChain(_chainId) {
+    let chainId;
+    if (typeof _chainId === 'string') {
+        chainId = +_chainId;
+    } else {
+        chainId = _chainId;
+    }
+    const testChains = [
+        foundry.id,
+        AZTEC_TEST_CHAIN_ID
+    ];
+    return testChains.includes(chainId);
+}

package/dest/client.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from '@aztec/foundation/log';
+import type { ViemPublicClient } from './types.js';
+type Config = {
+    /** The RPC Url of the ethereum host. */
+    l1RpcUrls: string[];
+    /** The chain ID of the ethereum host. */
+    l1ChainId: number;
+    /** The polling interval viem uses in ms */
+    viemPollingIntervalMS?: number;
+};
+/** Returns a viem public client given the L1 config. */
+export declare function getPublicClient(config: Config): ViemPublicClient;
+/** Returns a viem public client after waiting for the L1 RPC node to become available. */
+export declare function waitForPublicClient(config: Config, logger?: Logger): Promise<ViemPublicClient>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dest/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,KAAK,MAAM,GAAG;IACZ,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAIF,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAOhE;AAED,0FAA0F;AAC1F,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIpG"}

package/dest/client.js

@@ -0,0 +1,31 @@
+import { retryUntil } from '@aztec/foundation/retry';
+import { createPublicClient, fallback, http } from 'viem';
+import { createEthereumChain } from './chain.js';
+// TODO: Use these methods to abstract the creation of viem clients.
+/** Returns a viem public client given the L1 config. */ export function getPublicClient(config) {
+    const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
+    return createPublicClient({
+        chain: chain.chainInfo,
+        transport: fallback(config.l1RpcUrls.map((url)=>http(url))),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+}
+/** Returns a viem public client after waiting for the L1 RPC node to become available. */ export async function waitForPublicClient(config, logger) {
+    const client = getPublicClient(config);
+    await waitForRpc(client, config, logger);
+    return client;
+}
+async function waitForRpc(client, config, logger) {
+    const l1ChainId = await retryUntil(async ()=>{
+        let chainId = 0;
+        try {
+            chainId = await client.getChainId();
+        } catch (err) {
+            logger?.warn(`Failed to connect to Ethereum node at ${config.l1RpcUrls.join(', ')}. Retrying...`);
+        }
+        return chainId;
+    }, `L1 RPC url at ${config.l1RpcUrls.join(', ')}`, 600, 1);
+    if (l1ChainId !== config.l1ChainId) {
+        throw new Error(`Ethereum node at ${config.l1RpcUrls.join(', ')} has chain ID ${l1ChainId} but expected ${config.l1ChainId}`);
+    }
+}

package/dest/config.d.ts

@@ -0,0 +1,39 @@
+import { type ConfigMappingsType } from '@aztec/foundation/config';
+import { type L1TxUtilsConfig } from './l1_tx_utils.js';
+export type L1ContractsConfig = {
+    /** How many seconds an L1 slot lasts. */
+    ethereumSlotDuration: number;
+    /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */
+    aztecSlotDuration: number;
+    /** How many L2 slots an epoch lasts. */
+    aztecEpochDuration: number;
+    /** The target validator committee size. */
+    aztecTargetCommitteeSize: number;
+    /** The number of L2 slots that we can wait for a proof of an epoch to be produced. */
+    aztecProofSubmissionWindow: number;
+    /** The minimum stake for a validator. */
+    minimumStake: bigint;
+    /** The slashing quorum */
+    slashingQuorum: number;
+    /** The slashing round size */
+    slashingRoundSize: number;
+    /** Governance proposing quorum */
+    governanceProposerQuorum: number;
+    /** Governance proposing round size */
+    governanceProposerRoundSize: number;
+} & L1TxUtilsConfig;
+export declare const DefaultL1ContractsConfig: {
+    ethereumSlotDuration: number;
+    aztecSlotDuration: number;
+    aztecEpochDuration: number;
+    aztecTargetCommitteeSize: number;
+    aztecProofSubmissionWindow: number;
+    minimumStake: bigint;
+    slashingQuorum: number;
+    slashingRoundSize: number;
+    governanceProposerQuorum: number;
+    governanceProposerRoundSize: number;
+};
+export declare const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig>;
+export declare function getL1ContractsConfigEnvVars(): L1ContractsConfig;
+//# sourceMappingURL=config.d.ts.map

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,kBAAkB,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,wBAAwB,EAAE,MAAM,CAAC;IACjC,sFAAsF;IACtF,0BAA0B,EAAE,MAAM,CAAC;IACnC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,sCAAsC;IACtC,2BAA2B,EAAE,MAAM,CAAC;CACrC,GAAG,eAAe,CAAC;AAEpB,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAWR,CAAC;AAE9B,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,iBAAiB,CAqD3E,CAAC;AAEF,wBAAgB,2BAA2B,IAAI,iBAAiB,CAE/D"}

package/dest/config.js

@@ -0,0 +1,70 @@
+import { bigintConfigHelper, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
+import { l1TxUtilsConfigMappings } from './l1_tx_utils.js';
+export const DefaultL1ContractsConfig = {
+    ethereumSlotDuration: 12,
+    aztecSlotDuration: 24,
+    aztecEpochDuration: 16,
+    aztecTargetCommitteeSize: 48,
+    aztecProofSubmissionWindow: 31,
+    minimumStake: BigInt(100e18),
+    slashingQuorum: 6,
+    slashingRoundSize: 10,
+    governanceProposerQuorum: 6,
+    governanceProposerRoundSize: 10
+};
+export const l1ContractsConfigMappings = {
+    ethereumSlotDuration: {
+        env: 'ETHEREUM_SLOT_DURATION',
+        description: 'How many seconds an L1 slot lasts.',
+        ...numberConfigHelper(DefaultL1ContractsConfig.ethereumSlotDuration)
+    },
+    aztecSlotDuration: {
+        env: 'AZTEC_SLOT_DURATION',
+        description: 'How many seconds an L2 slots lasts (must be multiple of ethereum slot duration).',
+        ...numberConfigHelper(DefaultL1ContractsConfig.aztecSlotDuration)
+    },
+    aztecEpochDuration: {
+        env: 'AZTEC_EPOCH_DURATION',
+        description: `How many L2 slots an epoch lasts (maximum AZTEC_MAX_EPOCH_DURATION).`,
+        ...numberConfigHelper(DefaultL1ContractsConfig.aztecEpochDuration)
+    },
+    aztecTargetCommitteeSize: {
+        env: 'AZTEC_TARGET_COMMITTEE_SIZE',
+        description: 'The target validator committee size.',
+        ...numberConfigHelper(DefaultL1ContractsConfig.aztecTargetCommitteeSize)
+    },
+    aztecProofSubmissionWindow: {
+        env: 'AZTEC_PROOF_SUBMISSION_WINDOW',
+        description: 'The number of L2 slots that a proof for an epoch can be submitted in, starting from the beginning of the epoch.',
+        ...numberConfigHelper(DefaultL1ContractsConfig.aztecProofSubmissionWindow)
+    },
+    minimumStake: {
+        env: 'AZTEC_MINIMUM_STAKE',
+        description: 'The minimum stake for a validator.',
+        ...bigintConfigHelper(DefaultL1ContractsConfig.minimumStake)
+    },
+    slashingQuorum: {
+        env: 'AZTEC_SLASHING_QUORUM',
+        description: 'The slashing quorum',
+        ...numberConfigHelper(DefaultL1ContractsConfig.slashingQuorum)
+    },
+    slashingRoundSize: {
+        env: 'AZTEC_SLASHING_ROUND_SIZE',
+        description: 'The slashing round size',
+        ...numberConfigHelper(DefaultL1ContractsConfig.slashingRoundSize)
+    },
+    governanceProposerQuorum: {
+        env: 'AZTEC_GOVERNANCE_PROPOSER_QUORUM',
+        description: 'The governance proposing quorum',
+        ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerQuorum)
+    },
+    governanceProposerRoundSize: {
+        env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
+        description: 'The governance proposing round size',
+        ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerRoundSize)
+    },
+    ...l1TxUtilsConfigMappings
+};
+export function getL1ContractsConfigEnvVars() {
+    return getConfigFromMappings(l1ContractsConfigMappings);
+}

package/dest/constants.d.ts

@@ -0,0 +1,4 @@
+import type { Hex } from 'viem';
+export declare const NULL_KEY: Hex;
+export declare const AZTEC_TEST_CHAIN_ID = 677692;
+//# sourceMappingURL=constants.d.ts.map

package/dest/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,eAAO,MAAM,QAAQ,EAAE,GAA+E,CAAC;AACvG,eAAO,MAAM,mBAAmB,SAAS,CAAC"}

package/dest/constants.js

@@ -0,0 +1,2 @@
+export const NULL_KEY = `0x${'0000000000000000000000000000000000000000000000000000000000000000'}`;
+export const AZTEC_TEST_CHAIN_ID = 677692;

package/dest/contracts/empire_base.d.ts

@@ -0,0 +1,13 @@
+import { type Hex } from 'viem';
+import type { L1TxRequest } from '../l1_tx_utils.js';
+export interface IEmpireBase {
+    getRoundInfo(rollupAddress: Hex, round: bigint): Promise<{
+        lastVote: bigint;
+        leader: Hex;
+        executed: boolean;
+    }>;
+    computeRound(slot: bigint): Promise<bigint>;
+    createVoteRequest(payload: Hex): L1TxRequest;
+}
+export declare function encodeVote(payload: Hex): Hex;
+//# sourceMappingURL=empire_base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"empire_base.d.ts","sourceRoot":"","sources":["../../src/contracts/empire_base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,GAAG,EAAsB,MAAM,MAAM,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/G,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,WAAW,CAAC;CAC9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAM5C"}

package/dest/contracts/empire_base.js

@@ -0,0 +1,11 @@
+import { EmpireBaseAbi } from '@aztec/l1-artifacts/EmpireBaseAbi';
+import { encodeFunctionData } from 'viem';
+export function encodeVote(payload) {
+    return encodeFunctionData({
+        abi: EmpireBaseAbi,
+        functionName: 'vote',
+        args: [
+            payload
+        ]
+    });
+}

package/dest/contracts/fee_juice.d.ts

@@ -0,0 +1,15 @@
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { type Hex } from 'viem';
+import type { L1Clients } from '../types.js';
+export declare class FeeJuiceContract {
+    readonly publicClient: L1Clients['publicClient'];
+    readonly walletClient: L1Clients['walletClient'] | undefined;
+    private readonly publicFeeJuice;
+    private readonly walletFeeJuice;
+    constructor(address: Hex, publicClient: L1Clients['publicClient'], walletClient: L1Clients['walletClient'] | undefined);
+    get address(): EthAddress;
+    private assertWalletFeeJuice;
+    mint(to: Hex, amount: bigint): Promise<void>;
+    approve(spender: Hex, amount: bigint): Promise<void>;
+}
+//# sourceMappingURL=fee_juice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fee_juice.d.ts","sourceRoot":"","sources":["../../src/contracts/fee_juice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAA8B,KAAK,GAAG,EAAe,MAAM,MAAM,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,gBAAgB;aAMT,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC;aACvC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,SAAS;IANrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuE;IACtG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmF;gBAGhH,OAAO,EAAE,GAAG,EACI,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,EACvC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,SAAS;IAMrE,IAAW,OAAO,eAEjB;IAED,OAAO,CAAC,oBAAoB;IAOf,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;IAM5B,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;CAKlD"}

package/dest/contracts/fee_juice.js

@@ -0,0 +1,52 @@
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { TestERC20Abi as FeeJuiceAbi } from '@aztec/l1-artifacts';
+import { getContract } from 'viem';
+export class FeeJuiceContract {
+    publicClient;
+    walletClient;
+    publicFeeJuice;
+    walletFeeJuice;
+    constructor(address, publicClient, walletClient){
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.publicFeeJuice = getContract({
+            address,
+            abi: FeeJuiceAbi,
+            client: publicClient
+        });
+        this.walletFeeJuice = walletClient ? getContract({
+            address,
+            abi: FeeJuiceAbi,
+            client: walletClient
+        }) : undefined;
+    }
+    get address() {
+        return EthAddress.fromString(this.publicFeeJuice.address);
+    }
+    assertWalletFeeJuice() {
+        if (!this.walletFeeJuice) {
+            throw new Error('Wallet client is required for this operation');
+        }
+        return this.walletFeeJuice;
+    }
+    async mint(to, amount) {
+        const walletFeeJuice = this.assertWalletFeeJuice();
+        const tx = await walletFeeJuice.write.mint([
+            to,
+            amount
+        ]);
+        await this.publicClient.waitForTransactionReceipt({
+            hash: tx
+        });
+    }
+    async approve(spender, amount) {
+        const walletFeeJuice = this.assertWalletFeeJuice();
+        const tx = await walletFeeJuice.write.approve([
+            spender,
+            amount
+        ]);
+        await this.publicClient.waitForTransactionReceipt({
+            hash: tx
+        });
+    }
+}

package/dest/contracts/forwarder.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from '@aztec/foundation/log';
+import { type Hex } from 'viem';
+import type { L1BlobInputs, L1GasConfig, L1TxRequest, L1TxUtils } from '../l1_tx_utils.js';
+import type { L1Clients, ViemPublicClient, ViemWalletClient } from '../types.js';
+export declare class ForwarderContract {
+    readonly client: L1Clients['publicClient'];
+    readonly rollupAddress: Hex;
+    private readonly forwarder;
+    constructor(client: L1Clients['publicClient'], address: Hex, rollupAddress: Hex);
+    static create(owner: Hex, walletClient: ViemWalletClient, publicClient: ViemPublicClient, logger: Logger, rollupAddress: Hex): Promise<ForwarderContract>;
+    getAddress(): `0x${string}`;
+    forward(requests: L1TxRequest[], l1TxUtils: L1TxUtils, gasConfig: L1GasConfig | undefined, blobConfig: L1BlobInputs | undefined, logger: Logger): Promise<{
+        receipt: import("viem").TransactionReceipt;
+        gasPrice: import("../l1_tx_utils.js").GasPrice;
+        stats: import("../l1_tx_utils.js").TransactionStats | undefined;
+        errorMsg?: undefined;
+    } | {
+        receipt: import("viem").TransactionReceipt;
+        gasPrice: import("../l1_tx_utils.js").GasPrice;
+        errorMsg: string | undefined;
+        stats?: undefined;
+    }>;
+}
+//# sourceMappingURL=forwarder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.d.ts","sourceRoot":"","sources":["../../src/contracts/forwarder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAGL,KAAK,GAAG,EAGT,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGjF,qBAAa,iBAAiB;aAGA,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC;aAAgC,aAAa,EAAE,GAAG;IAF/G,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+D;gBAE7D,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,GAAG,EAAkB,aAAa,EAAE,GAAG;WAIlG,MAAM,CACjB,KAAK,EAAE,GAAG,EACV,YAAY,EAAE,gBAAgB,EAC9B,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG;IAwBb,UAAU;IAIJ,OAAO,CAClB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,WAAW,GAAG,SAAS,EAClC,UAAU,EAAE,YAAY,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM;;;;;;;;;;;CAqEjB"}

package/dest/contracts/forwarder.js

@@ -0,0 +1,101 @@
+import { toHex } from '@aztec/foundation/bigint-buffer';
+import { ForwarderAbi, ForwarderBytecode } from '@aztec/l1-artifacts';
+import { encodeFunctionData, getContract } from 'viem';
+import { deployL1Contract } from '../deploy_l1_contracts.js';
+import { RollupContract } from './rollup.js';
+export class ForwarderContract {
+    client;
+    rollupAddress;
+    forwarder;
+    constructor(client, address, rollupAddress){
+        this.client = client;
+        this.rollupAddress = rollupAddress;
+        this.forwarder = getContract({
+            address,
+            abi: ForwarderAbi,
+            client
+        });
+    }
+    static async create(owner, walletClient, publicClient, logger, rollupAddress) {
+        logger.info('Deploying forwarder contract');
+        const { address, txHash } = await deployL1Contract(walletClient, publicClient, ForwarderAbi, ForwarderBytecode, [
+            owner
+        ], owner, undefined, logger);
+        if (txHash) {
+            await publicClient.waitForTransactionReceipt({
+                hash: txHash
+            });
+        }
+        logger.info(`Forwarder contract deployed at ${address} with owner ${owner}`);
+        return new ForwarderContract(publicClient, address.toString(), rollupAddress);
+    }
+    getAddress() {
+        return this.forwarder.address;
+    }
+    async forward(requests, l1TxUtils, gasConfig, blobConfig, logger) {
+        requests = requests.filter((request)=>request.to !== null);
+        const toArgs = requests.map((request)=>request.to);
+        const dataArgs = requests.map((request)=>request.data);
+        const forwarderFunctionData = {
+            abi: ForwarderAbi,
+            functionName: 'forward',
+            args: [
+                toArgs,
+                dataArgs
+            ]
+        };
+        const encodedForwarderData = encodeFunctionData(forwarderFunctionData);
+        const { receipt, gasPrice } = await l1TxUtils.sendAndMonitorTransaction({
+            to: this.forwarder.address,
+            data: encodedForwarderData
+        }, gasConfig, blobConfig);
+        if (receipt.status === 'success') {
+            const stats = await l1TxUtils.getTransactionStats(receipt.transactionHash);
+            return {
+                receipt,
+                gasPrice,
+                stats
+            };
+        } else {
+            logger.error('Forwarder transaction failed', undefined, {
+                receipt
+            });
+            const args = {
+                ...forwarderFunctionData,
+                address: this.forwarder.address
+            };
+            let errorMsg;
+            if (blobConfig) {
+                const maxFeePerBlobGas = blobConfig.maxFeePerBlobGas ?? gasPrice.maxFeePerBlobGas;
+                if (maxFeePerBlobGas === undefined) {
+                    errorMsg = 'maxFeePerBlobGas is required to get the error message';
+                } else {
+                    logger.debug('Trying to get error from reverted tx with blob config');
+                    errorMsg = await l1TxUtils.tryGetErrorFromRevertedTx(encodedForwarderData, args, {
+                        blobs: blobConfig.blobs,
+                        kzg: blobConfig.kzg,
+                        maxFeePerBlobGas
+                    }, [
+                        {
+                            address: this.rollupAddress,
+                            stateDiff: [
+                                {
+                                    slot: toHex(RollupContract.checkBlobStorageSlot, true),
+                                    value: toHex(0n, true)
+                                }
+                            ]
+                        }
+                    ]);
+                }
+            } else {
+                logger.debug('Trying to get error from reverted tx without blob config');
+                errorMsg = await l1TxUtils.tryGetErrorFromRevertedTx(encodedForwarderData, args, undefined, []);
+            }
+            return {
+                receipt,
+                gasPrice,
+                errorMsg
+            };
+        }
+    }
+}

package/dest/contracts/governance.d.ts

@@ -0,0 +1,79 @@
+import { EthAddress } from '@aztec/foundation/eth-address';
+import type { Logger } from '@aztec/foundation/log';
+import { type Hex } from 'viem';
+import type { L1ContractAddresses } from '../l1_contract_addresses.js';
+import type { ViemPublicClient, ViemWalletClient } from '../types.js';
+import { GovernanceProposerContract } from './governance_proposer.js';
+export type L1GovernanceContractAddresses = Pick<L1ContractAddresses, 'governanceAddress' | 'rollupAddress' | 'registryAddress' | 'governanceProposerAddress'>;
+export declare enum ProposalState {
+    Pending = 0,
+    Active = 1,
+    Queued = 2,
+    Executable = 3,
+    Rejected = 4,
+    Executed = 5,
+    Dropped = 6,
+    Expired = 7
+}
+export declare class GovernanceContract {
+    readonly publicClient: ViemPublicClient;
+    readonly walletClient: ViemWalletClient | undefined;
+    private readonly publicGovernance;
+    private readonly walletGovernance;
+    constructor(address: Hex, publicClient: ViemPublicClient, walletClient: ViemWalletClient | undefined);
+    get address(): EthAddress;
+    getProposer(): Promise<GovernanceProposerContract>;
+    getGovernanceAddresses(): Promise<L1GovernanceContractAddresses>;
+    getProposal(proposalId: bigint): Promise<{
+        config: {
+            proposeConfig: {
+                lockDelay: bigint;
+                lockAmount: bigint;
+            };
+            votingDelay: bigint;
+            votingDuration: bigint;
+            executionDelay: bigint;
+            gracePeriod: bigint;
+            quorum: bigint;
+            voteDifferential: bigint;
+            minimumVotes: bigint;
+        };
+        state: number;
+        payload: `0x${string}`;
+        governanceProposer: `0x${string}`;
+        creation: bigint;
+        summedBallot: {
+            yea: bigint;
+            nea: bigint;
+        };
+    }>;
+    getProposalState(proposalId: bigint): Promise<ProposalState>;
+    private assertWalletGovernance;
+    deposit(onBehalfOf: Hex, amount: bigint): Promise<void>;
+    proposeWithLock({ payloadAddress, withdrawAddress, }: {
+        payloadAddress: Hex;
+        withdrawAddress: Hex;
+    }): Promise<number>;
+    awaitProposalActive({ proposalId, logger }: {
+        proposalId: bigint;
+        logger: Logger;
+    }): Promise<void>;
+    awaitProposalExecutable({ proposalId, logger }: {
+        proposalId: bigint;
+        logger: Logger;
+    }): Promise<void>;
+    getPower(): Promise<bigint>;
+    vote({ proposalId, voteAmount, inFavor, retries, logger, }: {
+        proposalId: bigint;
+        voteAmount: bigint | undefined;
+        inFavor: boolean;
+        retries: number;
+        logger: Logger;
+    }): Promise<void>;
+    executeProposal({ proposalId, retries, logger, }: {
+        proposalId: bigint;
+        retries: number;
+        logger: Logger;
+    }): Promise<void>;
+}
+//# sourceMappingURL=governance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/contracts/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,OAAO,EAGL,KAAK,GAAG,EAGT,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,mBAAmB,EACnB,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,2BAA2B,CACxF,CAAC;AAGF,oBAAY,aAAa;IACvB,OAAO,IAAA;IACP,MAAM,IAAA;IACN,MAAM,IAAA;IACN,UAAU,IAAA;IACV,QAAQ,IAAA;IACR,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,OAAO,IAAA;CACR;AAED,qBAAa,kBAAkB;aAMX,YAAY,EAAE,gBAAgB;aAC9B,YAAY,EAAE,gBAAgB,GAAG,SAAS;IAN5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgE;IACjG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4E;gBAG3G,OAAO,EAAE,GAAG,EACI,YAAY,EAAE,gBAAgB,EAC9B,YAAY,EAAE,gBAAgB,GAAG,SAAS;IAQ5D,IAAW,OAAO,eAEjB;IAEY,WAAW;IAKX,sBAAsB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IActE,WAAW,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;IAIxB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQzE,OAAO,CAAC,sBAAsB;IAOjB,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;IAMvC,eAAe,CAAC,EAC3B,cAAc,EACd,eAAe,GAChB,EAAE;QACD,cAAc,EAAE,GAAG,CAAC;QACpB,eAAe,EAAE,GAAG,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYN,mBAAmB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAsBlF,uBAAuB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IA2BtF,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAM3B,IAAI,CAAC,EAChB,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAY,EACZ,MAAM,GACP,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB;IAkDY,eAAe,CAAC,EAC3B,UAAU,EACV,OAAY,EACZ,MAAM,GACP,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB;CA2CF"}