@aztec-labs/bot 6.0.0-nightly.20260829

package/dest/config.js

@@ -0,0 +1,241 @@
+import { booleanConfigHelper, floatConfigHelper, getConfigFromMappings, getDefaultConfig, numberConfigHelper, optionalNumberConfigHelper, pickConfigMappings, secretFrConfigHelper, secretStringConfigHelper } from '@aztec-labs/foundation/config';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { getVKTreeRoot } from '@aztec-labs/noir-protocol-circuits-types/vk-tree';
+import { protocolContractsHash } from '@aztec-labs/protocol-contracts';
+import { dataConfigMappings } from '@aztec-labs/stdlib/kv-store';
+import { schemas, zodFor } from '@aztec-labs/stdlib/schemas';
+import { z } from 'zod';
+const BotFollowChain = [
+    'NONE',
+    'PROPOSED',
+    'CHECKPOINTED',
+    'PROVEN'
+];
+const BotMode = [
+    'transfer',
+    'amm',
+    'crosschain'
+];
+export var SupportedTokenContracts = /*#__PURE__*/ function(SupportedTokenContracts) {
+    SupportedTokenContracts["TokenContract"] = "TokenContract";
+    SupportedTokenContracts["PrivateTokenContract"] = "PrivateTokenContract";
+    return SupportedTokenContracts;
+}({});
+export const BotConfigSchema = zodFor()(z.object({
+    nodeUrl: z.string().optional(),
+    nodeAdminUrl: z.string().optional(),
+    l1RpcUrls: z.array(z.string()).optional(),
+    l1Mnemonic: schemas.SecretValue(z.string()).optional(),
+    l1PrivateKey: schemas.SecretValue(z.string()).optional(),
+    l1ToL2MessageTimeoutSeconds: z.number(),
+    senderPrivateKey: schemas.SecretValue(schemas.Fr).optional(),
+    senderSalt: schemas.Fr.optional(),
+    tokenSalt: schemas.Fr,
+    txIntervalSeconds: z.number(),
+    privateTransfersPerTx: z.number().int().nonnegative(),
+    publicTransfersPerTx: z.number().int().nonnegative(),
+    feePaymentMethod: z.literal('fee_juice'),
+    minFeePadding: z.number().nonnegative(),
+    noStart: z.boolean(),
+    txMinedWaitSeconds: z.number(),
+    followChain: z.enum(BotFollowChain),
+    maxPendingTxs: z.number().int().nonnegative(),
+    flushSetupTransactions: z.boolean(),
+    l2GasLimit: z.number().int().nonnegative().optional(),
+    daGasLimit: z.number().int().nonnegative().optional(),
+    contract: z.nativeEnum(SupportedTokenContracts),
+    maxConsecutiveErrors: z.number().int().nonnegative(),
+    stopWhenUnhealthy: z.boolean(),
+    botMode: z.enum(BotMode).default('transfer'),
+    l2ToL1MessagesPerTx: z.number().int().nonnegative().default(1),
+    l1ToL2SeedCount: z.number().int().nonnegative().default(1),
+    dataDirectory: z.string().optional(),
+    dataStoreMapSizeKb: z.number().optional()
+}).transform((config)=>({
+        nodeUrl: undefined,
+        nodeAdminUrl: undefined,
+        l1RpcUrls: undefined,
+        senderSalt: undefined,
+        l2GasLimit: undefined,
+        daGasLimit: undefined,
+        l1Mnemonic: undefined,
+        l1PrivateKey: undefined,
+        senderPrivateKey: undefined,
+        dataStoreMapSizeKb: 1_024 * 1_024,
+        ...config
+    })));
+export const botConfigMappings = {
+    nodeUrl: {
+        env: 'AZTEC_NODE_URL',
+        description: 'The URL to the Aztec node to check for tx pool status.'
+    },
+    nodeAdminUrl: {
+        env: 'AZTEC_NODE_ADMIN_URL',
+        description: 'The URL to the Aztec node admin API to force-flush txs if configured.'
+    },
+    l1RpcUrls: {
+        env: 'ETHEREUM_HOSTS',
+        description: 'URL of the ethereum host.',
+        parseEnv: (val)=>val.split(',').map((url)=>url.trim())
+    },
+    l1Mnemonic: {
+        env: 'BOT_L1_MNEMONIC',
+        description: 'The mnemonic for the account to bridge fee juice from L1.',
+        ...secretStringConfigHelper()
+    },
+    l1PrivateKey: {
+        env: 'BOT_L1_PRIVATE_KEY',
+        description: 'The private key for the account to bridge fee juice from L1.',
+        ...secretStringConfigHelper()
+    },
+    l1ToL2MessageTimeoutSeconds: {
+        env: 'BOT_L1_TO_L2_TIMEOUT_SECONDS',
+        description: 'How long to wait for L1 to L2 messages to become available on L2',
+        ...numberConfigHelper(3600)
+    },
+    senderPrivateKey: {
+        env: 'BOT_PRIVATE_KEY',
+        description: 'Signing private key for the sender account.',
+        ...secretFrConfigHelper()
+    },
+    senderSalt: {
+        env: 'BOT_ACCOUNT_SALT',
+        description: 'The salt to use to deploy the sender account.',
+        parseEnv: (val)=>val ? Fr.fromHexString(val) : undefined
+    },
+    tokenSalt: {
+        env: 'BOT_TOKEN_SALT',
+        description: 'The salt to use to deploy the token contract.',
+        parseEnv: (val)=>Fr.fromHexString(val),
+        defaultValue: Fr.fromHexString('1')
+    },
+    txIntervalSeconds: {
+        env: 'BOT_TX_INTERVAL_SECONDS',
+        description: 'Every how many seconds should a new tx be sent.',
+        ...numberConfigHelper(60)
+    },
+    privateTransfersPerTx: {
+        env: 'BOT_PRIVATE_TRANSFERS_PER_TX',
+        description: 'How many private token transfers are executed per tx.',
+        ...numberConfigHelper(1)
+    },
+    publicTransfersPerTx: {
+        env: 'BOT_PUBLIC_TRANSFERS_PER_TX',
+        description: 'How many public token transfers are executed per tx.',
+        ...numberConfigHelper(1)
+    },
+    feePaymentMethod: {
+        env: 'BOT_FEE_PAYMENT_METHOD',
+        description: 'How to handle fee payments. (Options: fee_juice)',
+        parseEnv: (val)=>val || undefined,
+        defaultValue: 'fee_juice'
+    },
+    minFeePadding: {
+        env: 'BOT_MIN_FEE_PADDING',
+        description: 'How much is the bot willing to overpay vs. the current base fee',
+        ...floatConfigHelper(3)
+    },
+    noStart: {
+        env: 'BOT_NO_START',
+        description: 'True to not automatically setup or start the bot on initialization.',
+        ...booleanConfigHelper()
+    },
+    txMinedWaitSeconds: {
+        env: 'BOT_TX_MINED_WAIT_SECONDS',
+        description: 'How long to wait for a tx to be mined before reporting an error.',
+        ...numberConfigHelper(180)
+    },
+    followChain: {
+        env: 'BOT_FOLLOW_CHAIN',
+        description: 'Which chain the bot follows',
+        defaultValue: 'NONE',
+        parseEnv (val) {
+            const upper = val.toUpperCase();
+            if (upper === 'PENDING') {
+                return 'CHECKPOINTED';
+            }
+            if (!BotFollowChain.includes(upper)) {
+                throw new Error(`Invalid value for BOT_FOLLOW_CHAIN: ${val}`);
+            }
+            return upper;
+        }
+    },
+    maxPendingTxs: {
+        env: 'BOT_MAX_PENDING_TXS',
+        description: "Do not send a tx if the node's tx pool already has this many pending txs.",
+        ...numberConfigHelper(128)
+    },
+    flushSetupTransactions: {
+        env: 'BOT_FLUSH_SETUP_TRANSACTIONS',
+        description: 'Make a request for the sequencer to build a block after each setup transaction.',
+        ...booleanConfigHelper(false)
+    },
+    l2GasLimit: {
+        env: 'BOT_L2_GAS_LIMIT',
+        description: "L2 gas limit for the tx (empty to let the bot's wallet estimate).",
+        ...optionalNumberConfigHelper()
+    },
+    daGasLimit: {
+        env: 'BOT_DA_GAS_LIMIT',
+        description: "DA gas limit for the tx (empty to let the bot's wallet estimate).",
+        ...optionalNumberConfigHelper()
+    },
+    contract: {
+        env: 'BOT_TOKEN_CONTRACT',
+        description: 'Token contract to use',
+        defaultValue: "TokenContract",
+        parseEnv (val) {
+            if (!Object.values(SupportedTokenContracts).includes(val)) {
+                throw new Error(`Invalid value for BOT_TOKEN_CONTRACT: ${val}. Valid values: ${Object.values(SupportedTokenContracts).join(', ')}`);
+            }
+            return val;
+        }
+    },
+    maxConsecutiveErrors: {
+        env: 'BOT_MAX_CONSECUTIVE_ERRORS',
+        description: 'The maximum number of consecutive errors before the bot shuts down',
+        ...numberConfigHelper(0)
+    },
+    stopWhenUnhealthy: {
+        env: 'BOT_STOP_WHEN_UNHEALTHY',
+        description: 'Stops the bot if service becomes unhealthy',
+        ...booleanConfigHelper(false)
+    },
+    botMode: {
+        env: 'BOT_MODE',
+        description: 'Bot mode: transfer, amm, or crosschain',
+        defaultValue: 'transfer',
+        parseEnv (val) {
+            if (!BotMode.includes(val)) {
+                throw new Error(`Invalid value for BOT_MODE: ${val}`);
+            }
+            return val;
+        }
+    },
+    l2ToL1MessagesPerTx: {
+        env: 'BOT_L2_TO_L1_MESSAGES_PER_TX',
+        description: 'Number of L2→L1 messages per tx (crosschain mode)',
+        ...numberConfigHelper(1)
+    },
+    l1ToL2SeedCount: {
+        env: 'BOT_L1_TO_L2_SEED_COUNT',
+        description: 'Max L1→L2 messages to keep in-flight (crosschain mode)',
+        ...numberConfigHelper(1)
+    },
+    ...pickConfigMappings(dataConfigMappings, [
+        'dataStoreMapSizeKb',
+        'dataDirectory'
+    ])
+};
+export function getBotConfigFromEnv() {
+    return getConfigFromMappings(botConfigMappings);
+}
+export function getBotDefaultConfig() {
+    return getDefaultConfig(botConfigMappings);
+}
+export function getVersions() {
+    return {
+        l2ProtocolContractsHash: protocolContractsHash.toString(),
+        l2CircuitsVkTreeRoot: getVKTreeRoot().toString()
+    };
+}

package/dest/cross_chain_bot.d.ts

@@ -0,0 +1,56 @@
+/**
+ * CrossChainBot exercises L2->L1 and L1->L2 messaging.
+ *
+ *   createAndSendTx                          onTxMined
+ *   ──────────────────────────────────────   ──────────────────────────────
+ *
+ *   1. SEED (fire-and-forget)                3. VERIFY L2->L1
+ *      if store has fewer pending messages       Query getTxEffect, confirm
+ *      than seedCount and no seed is              the expected L2->L1 messages
+ *      in-flight:                                appeared in tx effects.
+ *        * kick off L1 inbox tx
+ *        * store msg on completion
+ *
+ *   2. BUILD & SEND BATCH
+ *      Always:
+ *        N x create_l2_to_l1_message
+ *            (random content, fixed
+ *             L1 recipient)
+ *      If a ready L1->L2 msg exists:
+ *        1 x consume_message_from_
+ *            arbitrary_sender_public
+ *        delete consumed msg from store
+ *      Send batch tx (no wait)
+ *
+ */
+import { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { TxHash, TxReceipt } from '@aztec-labs/aztec.js/tx';
+import type { ExtendedViemWalletClient } from '@aztec-labs/ethereum/types';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import type { TestContract } from '@aztec-labs/noir-test-contracts.js/Test';
+import type { BlockTag } from '@aztec-labs/stdlib/block';
+import type { AztecNode, AztecNodeAdmin } from '@aztec-labs/stdlib/interfaces/client';
+import type { EmbeddedWallet } from '@aztec-labs/wallets/embedded';
+import { BaseBot } from './base_bot.js';
+import type { BotConfig } from './config.js';
+import type { BotStore } from './store/index.js';
+/** Bot that exercises both L2→L1 and L1→L2 cross-chain messaging. */
+export declare class CrossChainBot extends BaseBot {
+    private readonly contract;
+    private readonly l1Client;
+    private readonly l1Recipient;
+    private readonly inboxAddress;
+    private readonly rollupVersion;
+    private readonly store;
+    private readonly syncChainTip?;
+    private l2ToL1Sent;
+    private l1ToL2Consumed;
+    private pendingSeedPromise;
+    protected constructor(node: AztecNode, wallet: EmbeddedWallet, defaultAccountAddress: AztecAddress, contract: TestContract, l1Client: ExtendedViemWalletClient, l1Recipient: EthAddress, inboxAddress: EthAddress, rollupVersion: bigint, store: BotStore, config: BotConfig, syncChainTip?: "checkpointed" | "finalized" | "latest" | "proposed" | "proven" | undefined);
+    static create(config: BotConfig, wallet: EmbeddedWallet, aztecNode: AztecNode, aztecNodeAdmin: AztecNodeAdmin | undefined, store: BotStore, syncChainTip?: BlockTag): Promise<CrossChainBot>;
+    protected createAndSendTx(logCtx: object): Promise<TxHash>;
+    protected onTxMined(receipt: TxReceipt, logCtx: object): Promise<void>;
+    private getReadyL1ToL2Message;
+    private seedNewL1ToL2Message;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3Jvc3NfY2hhaW5fYm90LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY3Jvc3NfY2hhaW5fYm90LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F3Qkc7QUFDSCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFHOUQsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFM0UsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLG9DQUFvQyxDQUFDO0FBQ2hFLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLHlDQUF5QyxDQUFDO0FBQzVFLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxjQUFjLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQztBQUN0RixPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUVuRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUc3QyxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQXdCLE1BQU0sa0JBQWtCLENBQUM7QUFLdkUseUVBQXFFO0FBQ3JFLHFCQUFhLGFBQWMsU0FBUSxPQUFPO0lBU3RDLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUTtJQUN6QixPQUFPLENBQUMsUUFBUSxDQUFDLFFBQVE7SUFDekIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxXQUFXO0lBQzVCLE9BQU8sQ0FBQyxRQUFRLENBQUMsWUFBWTtJQUM3QixPQUFPLENBQUMsUUFBUSxDQUFDLGFBQWE7SUFDOUIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxLQUFLO0lBRXRCLE9BQU8sQ0FBQyxRQUFRLENBQUMsWUFBWSxDQUFDO0lBZmhDLE9BQU8sQ0FBQyxVQUFVLENBQUs7SUFDdkIsT0FBTyxDQUFDLGNBQWMsQ0FBSztJQUMzQixPQUFPLENBQUMsa0JBQWtCLENBQTRCO0lBRXRELFNBQVMsYUFDUCxJQUFJLEVBQUUsU0FBUyxFQUNmLE1BQU0sRUFBRSxjQUFjLEVBQ3RCLHFCQUFxQixFQUFFLFlBQVksRUFDbEIsUUFBUSxFQUFFLFlBQVksRUFDdEIsUUFBUSxFQUFFLHdCQUF3QixFQUNsQyxXQUFXLEVBQUUsVUFBVSxFQUN2QixZQUFZLEVBQUUsVUFBVSxFQUN4QixhQUFhLEVBQUUsTUFBTSxFQUNyQixLQUFLLEVBQUUsUUFBUSxFQUNoQyxNQUFNLEVBQUUsU0FBUyxFQUNBLFlBQVksQ0FBQyw2RUFBVSxFQUd6QztJQUVELE9BQWEsTUFBTSxDQUNqQixNQUFNLEVBQUUsU0FBUyxFQUNqQixNQUFNLEVBQUUsY0FBYyxFQUN0QixTQUFTLEVBQUUsU0FBUyxFQUNwQixjQUFjLEVBQUUsY0FBYyxHQUFHLFNBQVMsRUFDMUMsS0FBSyxFQUFFLFFBQVEsRUFDZixZQUFZLENBQUMsRUFBRSxRQUFRLEdBQ3RCLE9BQU8sQ0FBQyxhQUFhLENBQUMsQ0FzQnhCO0lBRUQsVUFBZ0IsZUFBZSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQWlEL0Q7SUFFRCxVQUF5QixTQUFTLENBQUMsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0F3QnBGO1lBR2EscUJBQXFCO1lBb0JyQixvQkFBb0I7Q0FVbkMifQ==

package/dest/cross_chain_bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross_chain_bot.d.ts","sourceRoot":"","sources":["../src/cross_chain_bot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,kBAAkB,CAAC;AAKvE,yEAAqE;AACrE,qBAAa,aAAc,SAAQ,OAAO;IAStC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAfhC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAA4B;IAEtD,SAAS,aACP,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,cAAc,EACtB,qBAAqB,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,wBAAwB,EAClC,WAAW,EAAE,UAAU,EACvB,YAAY,EAAE,UAAU,EACxB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,EAChC,MAAM,EAAE,SAAS,EACA,YAAY,CAAC,6EAAU,EAGzC;IAED,OAAa,MAAM,CACjB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,KAAK,EAAE,QAAQ,EACf,YAAY,CAAC,EAAE,QAAQ,GACtB,OAAO,CAAC,aAAa,CAAC,CAsBxB;IAED,UAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiD/D;IAED,UAAyB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBpF;YAGa,qBAAqB;YAoBrB,oBAAoB;CAUnC"}

package/dest/cross_chain_bot.js

@@ -0,0 +1,138 @@
+/**
+ * CrossChainBot exercises L2->L1 and L1->L2 messaging.
+ *
+ *   createAndSendTx                          onTxMined
+ *   ──────────────────────────────────────   ──────────────────────────────
+ *
+ *   1. SEED (fire-and-forget)                3. VERIFY L2->L1
+ *      if store has fewer pending messages       Query getTxEffect, confirm
+ *      than seedCount and no seed is              the expected L2->L1 messages
+ *      in-flight:                                appeared in tx effects.
+ *        * kick off L1 inbox tx
+ *        * store msg on completion
+ *
+ *   2. BUILD & SEND BATCH
+ *      Always:
+ *        N x create_l2_to_l1_message
+ *            (random content, fixed
+ *             L1 recipient)
+ *      If a ready L1->L2 msg exists:
+ *        1 x consume_message_from_
+ *            arbitrary_sender_public
+ *        delete consumed msg from store
+ *      Send batch tx (no wait)
+ *
+ */ import { BatchCall, NO_WAIT } from '@aztec-labs/aztec.js/contracts';
+import { isL1ToL2MessageReady } from '@aztec-labs/aztec.js/messaging';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { BaseBot } from './base_bot.js';
+import { BotFactory } from './factory.js';
+import { seedL1ToL2Message } from './l1_to_l2_seeding.js';
+/** Stale message threshold: messages older than this are removed. */ const STALE_MESSAGE_THRESHOLD_MS = 2 * 60 * 60 * 1000; // 2 hours
+/** Bot that exercises both L2→L1 and L1→L2 cross-chain messaging. */ export class CrossChainBot extends BaseBot {
+    contract;
+    l1Client;
+    l1Recipient;
+    inboxAddress;
+    rollupVersion;
+    store;
+    syncChainTip;
+    l2ToL1Sent;
+    l1ToL2Consumed;
+    pendingSeedPromise;
+    constructor(node, wallet, defaultAccountAddress, contract, l1Client, l1Recipient, inboxAddress, rollupVersion, store, config, syncChainTip){
+        super(node, wallet, defaultAccountAddress, config), this.contract = contract, this.l1Client = l1Client, this.l1Recipient = l1Recipient, this.inboxAddress = inboxAddress, this.rollupVersion = rollupVersion, this.store = store, this.syncChainTip = syncChainTip, this.l2ToL1Sent = 0, this.l1ToL2Consumed = 0;
+    }
+    static async create(config, wallet, aztecNode, aztecNodeAdmin, store, syncChainTip) {
+        if (config.followChain === 'NONE') {
+            throw new Error(`CrossChainBot requires followChain to be set (got NONE)`);
+        }
+        const factory = new BotFactory(config, wallet, store, aztecNode, aztecNodeAdmin, syncChainTip);
+        const { defaultAccountAddress, contract, l1Client, rollupVersion } = await factory.setupCrossChain();
+        const l1Recipient = EthAddress.fromString(l1Client.account.address);
+        const { l1ContractAddresses } = await aztecNode.getNodeInfo();
+        const inboxAddress = EthAddress.fromString(l1ContractAddresses.inboxAddress.toString());
+        return new CrossChainBot(aztecNode, wallet, defaultAccountAddress, contract, l1Client, l1Recipient, inboxAddress, rollupVersion, store, config, syncChainTip);
+    }
+    async createAndSendTx(logCtx) {
+        const pendingMessages = await this.store.getUnconsumedL1ToL2Messages();
+        // Send an L1→L2 message if we're below the threshold and not already seeding one
+        if (pendingMessages.length < this.config.l1ToL2SeedCount && !this.pendingSeedPromise) {
+            this.pendingSeedPromise = this.seedNewL1ToL2Message().catch((err)=>this.log.warn(`Failed to seed L1→L2 message: ${err}`, logCtx)).finally(()=>{
+                this.pendingSeedPromise = undefined;
+            });
+        }
+        // Build batch: always L2→L1, optionally consume L1→L2
+        const calls = [];
+        // L2→L1: create messages with random content
+        for(let i = 0; i < this.config.l2ToL1MessagesPerTx; i++){
+            calls.push(this.contract.methods.create_l2_to_l1_message_arbitrary_recipient_public(Fr.random(), this.l1Recipient));
+        }
+        // L1→L2: consume oldest ready message if available
+        const readyMsg = await this.getReadyL1ToL2Message(pendingMessages);
+        if (readyMsg) {
+            calls.push(this.contract.methods.consume_message_from_arbitrary_sender_public(Fr.fromHexString(readyMsg.content), Fr.fromHexString(readyMsg.secret), EthAddress.fromString(readyMsg.sender), new Fr(BigInt(readyMsg.globalLeafIndex))));
+            // Delete consumed message immediately so it works with FOLLOW_CHAIN=NONE
+            await this.store.deleteL1ToL2Message(readyMsg.msgHash);
+            this.l1ToL2Consumed++;
+        } else {
+            this.log.warn(`No ready L1→L2 message to consume`, {
+                ...logCtx,
+                pendingCount: pendingMessages.length
+            });
+        }
+        const batch = new BatchCall(this.wallet, calls);
+        const opts = this.getSendMethodOpts();
+        this.log.verbose(`Sending cross-chain batch with ${calls.length} calls`, logCtx);
+        const { txHash } = await batch.send({
+            ...opts,
+            wait: NO_WAIT
+        });
+        return txHash;
+    }
+    async onTxMined(receipt, logCtx) {
+        // Verify L2→L1 messages appeared in this tx's effects
+        const minedReceipt = await this.node.getTxReceipt(receipt.txHash, {
+            includeTxEffect: true
+        });
+        const l2ToL1MsgsRaw = minedReceipt.txEffect?.l2ToL1Msgs;
+        if (l2ToL1MsgsRaw) {
+            const l2ToL1Msgs = l2ToL1MsgsRaw.filter((m)=>!m.isZero());
+            if (l2ToL1Msgs.length >= this.config.l2ToL1MessagesPerTx) {
+                this.l2ToL1Sent += l2ToL1Msgs.length;
+            } else {
+                this.log.error(`Expected ${this.config.l2ToL1MessagesPerTx} L2→L1 messages but found ${l2ToL1Msgs.length}`, {
+                    ...logCtx,
+                    blockNumber: receipt.blockNumber,
+                    txHash: receipt.txHash.toString()
+                });
+            }
+        }
+        const pendingCount = (await this.store.getUnconsumedL1ToL2Messages()).length;
+        this.log.info(`CrossChainBot txs mined`, {
+            ...logCtx,
+            l2ToL1Sent: this.l2ToL1Sent,
+            l1ToL2Consumed: this.l1ToL2Consumed,
+            l1ToL2Pending: pendingCount
+        });
+    }
+    /** Finds the oldest pending message that is ready for consumption. */ async getReadyL1ToL2Message(pendingMessages) {
+        const now = Date.now();
+        for (const msg of pendingMessages){
+            const ready = await isL1ToL2MessageReady(this.node, Fr.fromHexString(msg.msgHash), this.syncChainTip);
+            if (ready) {
+                return msg;
+            }
+            // Time-based stale detection: if the message is old and still not ready, remove it
+            if (now - msg.timestamp > STALE_MESSAGE_THRESHOLD_MS) {
+                await this.store.deleteL1ToL2Message(msg.msgHash);
+                this.log.warn(`Removed stale L1→L2 message ${msg.msgHash}`);
+            }
+        }
+        return undefined;
+    }
+    /** Seeds a new L1→L2 message on L1 and stores it. */ async seedNewL1ToL2Message() {
+        await seedL1ToL2Message(this.l1Client, this.inboxAddress, this.contract.address, this.rollupVersion, this.store, this.log);
+    }
+}

package/dest/factory.d.ts

@@ -0,0 +1,74 @@
+import { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { ExtendedViemWalletClient } from '@aztec-labs/ethereum/types';
+import { AMMContract } from '@aztec-labs/noir-contracts.js/AMM';
+import { PrivateTokenContract } from '@aztec-labs/noir-contracts.js/PrivateToken';
+import { TokenContract } from '@aztec-labs/noir-contracts.js/Token';
+import { TestContract } from '@aztec-labs/noir-test-contracts.js/Test';
+import type { AztecNode, AztecNodeAdmin } from '@aztec-labs/stdlib/interfaces/client';
+import { EmbeddedWallet } from '@aztec-labs/wallets/embedded';
+import { type BotConfig } from './config.js';
+import type { BotStore } from './store/index.js';
+export declare class BotFactory {
+    private readonly config;
+    private readonly wallet;
+    private readonly store;
+    private readonly aztecNode;
+    private readonly aztecNodeAdmin?;
+    private readonly syncChainTip?;
+    private log;
+    /** Number of in-flight withNoMinTxsPerBlock calls; see that method for why they are counted. */
+    private noMinTxsPerBlockDepth;
+    /** Set by the first withNoMinTxsPerBlock entrant; resolves to the minTxsPerBlock value to restore. */
+    private savedMinTxsPerBlock?;
+    constructor(config: BotConfig, wallet: EmbeddedWallet, store: BotStore, aztecNode: AztecNode, aztecNodeAdmin?: AztecNodeAdmin | undefined, syncChainTip?: "checkpointed" | "finalized" | "latest" | "proposed" | "proven" | undefined);
+    /**
+     * Initializes a new bot by setting up the sender account, registering the recipient,
+     * deploying the token contract, and minting tokens if necessary.
+     */
+    setup(): Promise<{
+        wallet: EmbeddedWallet;
+        defaultAccountAddress: AztecAddress;
+        token: TokenContract | PrivateTokenContract;
+        node: AztecNode;
+        recipient: AztecAddress;
+    }>;
+    setupAmm(): Promise<{
+        wallet: EmbeddedWallet;
+        defaultAccountAddress: AztecAddress;
+        amm: AMMContract;
+        token0: TokenContract;
+        token1: TokenContract;
+        node: AztecNode;
+    }>;
+    /**
+     * Initializes the cross-chain bot by deploying TestContract, creating an L1 client,
+     * seeding initial L1→L2 messages, and waiting for the first to be ready.
+     */
+    setupCrossChain(): Promise<{
+        wallet: EmbeddedWallet;
+        defaultAccountAddress: AztecAddress;
+        contract: TestContract;
+        node: AztecNode;
+        l1Client: ExtendedViemWalletClient;
+        rollupVersion: bigint;
+    }>;
+    private deployTestContract;
+    private setupAccount;
+    private setupTestAccount;
+    private setupAccountWithPrivateKey;
+    private setupToken;
+    private setupTokenContract;
+    private deployAmmContract;
+    private grantLpTokenMinter;
+    private mintAmmLiquidity;
+    private addAmmLiquidity;
+    private registerOrDeployContract;
+    /** True when the config allows bridging fee juice from L1 (fee_juice mode, an L1 RPC, and an L1 key). */
+    private isL1BridgingConfigured;
+    private ensureFeeJuiceBalance;
+    private mintTokens;
+    private getOrCreateBridgeClaim;
+    private bridgeL1FeeJuice;
+    protected withNoMinTxsPerBlock<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBb0I5RCxPQUFPLEtBQUssRUFBRSx3QkFBd0IsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBSTNFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUNoRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw0Q0FBNEMsQ0FBQztBQUNsRixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDcEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHlDQUF5QyxDQUFDO0FBR3ZFLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxjQUFjLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQztBQUN0RixPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFOUQsT0FBTyxFQUFFLEtBQUssU0FBUyxFQUEyQixNQUFNLGFBQWEsQ0FBQztBQUV0RSxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQU9qRCxxQkFBYSxVQUFVO0lBU25CLE9BQU8sQ0FBQyxRQUFRLENBQUMsTUFBTTtJQUN2QixPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU07SUFDdkIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxLQUFLO0lBQ3RCLE9BQU8sQ0FBQyxRQUFRLENBQUMsU0FBUztJQUMxQixPQUFPLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBQztJQUNoQyxPQUFPLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQztJQWJoQyxPQUFPLENBQUMsR0FBRyxDQUF1QjtJQUVsQyxnR0FBZ0c7SUFDaEcsT0FBTyxDQUFDLHFCQUFxQixDQUFLO0lBQ2xDLHNHQUFzRztJQUN0RyxPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0FBdUM7SUFFbkUsWUFDbUIsTUFBTSxFQUFFLFNBQVMsRUFDakIsTUFBTSxFQUFFLGNBQWMsRUFDdEIsS0FBSyxFQUFFLFFBQVEsRUFDZixTQUFTLEVBQUUsU0FBUyxFQUNwQixjQUFjLENBQUMsNEJBQWdCLEVBQy9CLFlBQVksQ0FBQyw2RUFBVSxFQUt6QztJQUVEOzs7T0FHRztJQUNVLEtBQUssSUFBSSxPQUFPLENBQUM7UUFDNUIsTUFBTSxFQUFFLGNBQWMsQ0FBQztRQUN2QixxQkFBcUIsRUFBRSxZQUFZLENBQUM7UUFDcEMsS0FBSyxFQUFFLGFBQWEsR0FBRyxvQkFBb0IsQ0FBQztRQUM1QyxJQUFJLEVBQUUsU0FBUyxDQUFDO1FBQ2hCLFNBQVMsRUFBRSxZQUFZLENBQUM7S0FDekIsQ0FBQyxDQVFEO0lBRVksUUFBUSxJQUFJLE9BQU8sQ0FBQztRQUMvQixNQUFNLEVBQUUsY0FBYyxDQUFDO1FBQ3ZCLHFCQUFxQixFQUFFLFlBQVksQ0FBQztRQUNwQyxHQUFHLEVBQUUsV0FBVyxDQUFDO1FBQ2pCLE1BQU0sRUFBRSxhQUFhLENBQUM7UUFDdEIsTUFBTSxFQUFFLGFBQWEsQ0FBQztRQUN0QixJQUFJLEVBQUUsU0FBUyxDQUFDO0tBQ2pCLENBQUMsQ0FtQ0Q7SUFFRDs7O09BR0c7SUFDVSxlQUFlLElBQUksT0FBTyxDQUFDO1FBQ3RDLE1BQU0sRUFBRSxjQUFjLENBQUM7UUFDdkIscUJBQXFCLEVBQUUsWUFBWSxDQUFDO1FBQ3BDLFFBQVEsRUFBRSxZQUFZLENBQUM7UUFDdkIsSUFBSSxFQUFFLFNBQVMsQ0FBQztRQUNoQixRQUFRLEVBQUUsd0JBQXdCLENBQUM7UUFDbkMsYUFBYSxFQUFFLE1BQU0sQ0FBQztLQUN2QixDQUFDLENBb0VEO1lBRWEsa0JBQWtCO1lBU2xCLFlBQVk7WUFrQlosZ0JBQWdCO1lBVWhCLDBCQUEwQjtZQWUxQixVQUFVO1lBeUNWLGtCQUFrQjtZQWFsQixpQkFBaUI7WUFTakIsa0JBQWtCO1lBUWxCLGdCQUFnQjtZQWFoQixlQUFlO1lBc0VmLHdCQUF3QjtJQTJCdEMseUdBQXlHO0lBQ3pHLE9BQU8sQ0FBQyxzQkFBc0I7WUFjaEIscUJBQXFCO1lBZ0NyQixVQUFVO1lBaURWLHNCQUFzQjtZQXdCdEIsZ0JBQWdCO0lBZ0M5QixVQUFnQixvQkFBb0IsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLE1BQU0sT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0ErQnhFO0NBQ0YifQ==

package/dest/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAoB9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAI3E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,KAAK,SAAS,EAA2B,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD,qBAAa,UAAU;IASnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAbhC,OAAO,CAAC,GAAG,CAAuB;IAElC,gGAAgG;IAChG,OAAO,CAAC,qBAAqB,CAAK;IAClC,sGAAsG;IACtG,OAAO,CAAC,mBAAmB,CAAC,CAAuC;IAEnE,YACmB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,SAAS,EACpB,cAAc,CAAC,4BAAgB,EAC/B,YAAY,CAAC,6EAAU,EAKzC;IAED;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC;QAC5B,MAAM,EAAE,cAAc,CAAC;QACvB,qBAAqB,EAAE,YAAY,CAAC;QACpC,KAAK,EAAE,aAAa,GAAG,oBAAoB,CAAC;QAC5C,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,YAAY,CAAC;KACzB,CAAC,CAQD;IAEY,QAAQ,IAAI,OAAO,CAAC;QAC/B,MAAM,EAAE,cAAc,CAAC;QACvB,qBAAqB,EAAE,YAAY,CAAC;QACpC,GAAG,EAAE,WAAW,CAAC;QACjB,MAAM,EAAE,aAAa,CAAC;QACtB,MAAM,EAAE,aAAa,CAAC;QACtB,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC,CAmCD;IAED;;;OAGG;IACU,eAAe,IAAI,OAAO,CAAC;QACtC,MAAM,EAAE,cAAc,CAAC;QACvB,qBAAqB,EAAE,YAAY,CAAC;QACpC,QAAQ,EAAE,YAAY,CAAC;QACvB,IAAI,EAAE,SAAS,CAAC;QAChB,QAAQ,EAAE,wBAAwB,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAoED;YAEa,kBAAkB;YASlB,YAAY;YAkBZ,gBAAgB;YAUhB,0BAA0B;YAe1B,UAAU;YAyCV,kBAAkB;YAalB,iBAAiB;YASjB,kBAAkB;YAQlB,gBAAgB;YAahB,eAAe;YAsEf,wBAAwB;IA2BtC,yGAAyG;IACzG,OAAO,CAAC,sBAAsB;YAchB,qBAAqB;YAgCrB,UAAU;YAiDV,sBAAsB;YAwBtB,gBAAgB;IAgC9B,UAAgB,oBAAoB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA+BxE;CACF"}