@aztec-labs/bot 6.0.0-nightly.20260829

package/dest/factory.js

@@ -0,0 +1,532 @@
+import { getInitialTestAccountsData } from '@aztec-labs/accounts/testing';
+import { deriveSecretKeyFromSigningKey } from '@aztec-labs/accounts/utils';
+import { BatchCall, NO_WAIT } from '@aztec-labs/aztec.js/contracts';
+import { L1FeeJuicePortalManager } from '@aztec-labs/aztec.js/ethereum';
+import { FeeJuicePaymentMethodWithClaim } from '@aztec-labs/aztec.js/fee';
+import { deriveKeys } from '@aztec-labs/aztec.js/keys';
+import { createLogger } from '@aztec-labs/aztec.js/log';
+import { waitForL1ToL2MessageReady } from '@aztec-labs/aztec.js/messaging';
+import { waitForTx } from '@aztec-labs/aztec.js/node';
+import { getFeeJuiceBalance } from '@aztec-labs/aztec.js/utils';
+import { createEthereumChain } from '@aztec-labs/ethereum/chain';
+import { createExtendedL1Client } from '@aztec-labs/ethereum/client';
+import { RollupContract } from '@aztec-labs/ethereum/contracts';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { GrumpkinScalar } from '@aztec-labs/foundation/curves/grumpkin';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+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 { SupportedTokenContracts } from './config.js';
+import { seedL1ToL2Message } from './l1_to_l2_seeding.js';
+import { getBalances, getPrivateBalance, isStandardTokenContract } from './utils.js';
+const MINT_BALANCE = 1e12;
+const MIN_BALANCE = 1e3;
+const FEE_JUICE_TOP_UP_THRESHOLD = 100n * 10n ** 18n;
+export class BotFactory {
+    config;
+    wallet;
+    store;
+    aztecNode;
+    aztecNodeAdmin;
+    syncChainTip;
+    log;
+    /** Number of in-flight withNoMinTxsPerBlock calls; see that method for why they are counted. */ noMinTxsPerBlockDepth;
+    /** Set by the first withNoMinTxsPerBlock entrant; resolves to the minTxsPerBlock value to restore. */ savedMinTxsPerBlock;
+    constructor(config, wallet, store, aztecNode, aztecNodeAdmin, syncChainTip){
+        this.config = config;
+        this.wallet = wallet;
+        this.store = store;
+        this.aztecNode = aztecNode;
+        this.aztecNodeAdmin = aztecNodeAdmin;
+        this.syncChainTip = syncChainTip;
+        this.log = createLogger('bot');
+        this.noMinTxsPerBlockDepth = 0;
+        // Set fee padding on the wallet so that all transactions during setup
+        // (token deploy, minting, etc.) use the configured padding, not the default.
+        this.wallet.setMinFeePadding(config.minFeePadding);
+    }
+    /**
+   * Initializes a new bot by setting up the sender account, registering the recipient,
+   * deploying the token contract, and minting tokens if necessary.
+   */ async setup() {
+        const defaultAccountAddress = await this.setupAccount();
+        const recipient = (await this.wallet.createSchnorrAccount(Fr.random(), Fr.random(), GrumpkinScalar.random())).address;
+        await this.ensureFeeJuiceBalance(defaultAccountAddress);
+        const token = await this.setupToken(defaultAccountAddress);
+        await this.mintTokens(token, defaultAccountAddress);
+        return {
+            wallet: this.wallet,
+            defaultAccountAddress,
+            token,
+            node: this.aztecNode,
+            recipient
+        };
+    }
+    async setupAmm() {
+        const defaultAccountAddress = await this.setupAccount();
+        await this.ensureFeeJuiceBalance(defaultAccountAddress);
+        const salt = this.config.tokenSalt;
+        // token0, token1 and the LP token are independent contracts with no shared state, so deploy them
+        // concurrently rather than one slot at a time.
+        const [token0, token1, liquidityToken] = await Promise.all([
+            this.setupTokenContract(defaultAccountAddress, salt, 'BotToken0', 'BOT0'),
+            this.setupTokenContract(defaultAccountAddress, salt, 'BotToken1', 'BOT1'),
+            this.setupTokenContract(defaultAccountAddress, salt, 'BotLPToken', 'BOTLP')
+        ]);
+        const ammDeploy = AMMContract.deploy(this.wallet, token0.address, token1.address, liquidityToken.address, {
+            salt,
+            universalDeploy: true
+        });
+        const ammAddress = (await ammDeploy.getInstance()).address;
+        // The AMM constructor only stores the (already-derived) token addresses, and set_minter only records
+        // the AMM address on the LP token: neither reads the other's on-chain state, so the AMM deploy, the
+        // LP-minter grant, and the token0/token1 mints are mutually independent and run concurrently.
+        const [amm] = await Promise.all([
+            this.deployAmmContract(defaultAccountAddress, ammDeploy),
+            this.grantLpTokenMinter(defaultAccountAddress, liquidityToken, ammAddress),
+            this.mintAmmLiquidity(defaultAccountAddress, token0, token1)
+        ]);
+        // add_liquidity spends the minted token0/token1 balances and mints LP tokens, so it must follow both
+        // the mints and the minter grant, and target the deployed AMM.
+        await this.addAmmLiquidity(defaultAccountAddress, defaultAccountAddress, amm, token0, token1, liquidityToken);
+        this.log.info(`AMM initialized and funded`);
+        return {
+            wallet: this.wallet,
+            defaultAccountAddress,
+            amm,
+            token0,
+            token1,
+            node: this.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.
+   */ async setupCrossChain() {
+        const defaultAccountAddress = await this.setupAccount();
+        await this.ensureFeeJuiceBalance(defaultAccountAddress);
+        // Create L1 client (same pattern as bridgeL1FeeJuice)
+        const l1RpcUrls = this.config.l1RpcUrls;
+        if (!l1RpcUrls?.length) {
+            throw new Error('L1 RPC URLs required for cross-chain bot');
+        }
+        const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
+        if (!mnemonicOrPrivateKey) {
+            throw new Error('L1 mnemonic or private key required for cross-chain bot');
+        }
+        const { l1ChainId, l1ContractAddresses } = await this.aztecNode.getNodeInfo();
+        const chain = createEthereumChain(l1RpcUrls, l1ChainId);
+        const l1Client = createExtendedL1Client(chain.rpcUrls, mnemonicOrPrivateKey, chain.chainInfo);
+        // Fetch Rollup version (needed for Inbox L2Actor struct)
+        const rollupContract = new RollupContract(l1Client, l1ContractAddresses.rollupAddress.toString());
+        const rollupVersion = await rollupContract.getVersion();
+        // Derive the TestContract address up front (deterministic from the salt). Seeding L1→L2 messages only
+        // needs the L2 recipient address — the messages are queued on L1 and don't require the L2 contract to
+        // exist yet (they're consumed later, after setup completes) — so the deploy (an L2 tx paying from the
+        // standing balance funded above) and the L1 seeding run concurrently.
+        const testContractDeploy = TestContract.deploy(this.wallet, {
+            salt: this.config.tokenSalt,
+            universalDeploy: true
+        });
+        const contractAddress = (await testContractDeploy.getInstance()).address;
+        // Recover any pending messages from store (clean up stale ones first)
+        await this.store.cleanupOldPendingMessages();
+        const pendingMessages = await this.store.getUnconsumedL1ToL2Messages();
+        // Seed initial L1→L2 messages if pipeline is empty. The seeds are sent one at a time: they share the
+        // bot's L1 account, so concurrent sends would race on the L1 nonce.
+        const seedCount = Math.max(0, this.config.l1ToL2SeedCount - pendingMessages.length);
+        const inboxAddress = EthAddress.fromString(l1ContractAddresses.inboxAddress.toString());
+        const [contract] = await Promise.all([
+            this.deployTestContract(defaultAccountAddress, testContractDeploy),
+            (async ()=>{
+                for(let i = 0; i < seedCount; i++){
+                    await seedL1ToL2Message(l1Client, inboxAddress, contractAddress, rollupVersion, this.store, this.log);
+                }
+            })()
+        ]);
+        // Block until at least one message is ready
+        const allMessages = await this.store.getUnconsumedL1ToL2Messages();
+        if (allMessages.length > 0) {
+            this.log.info(`Waiting for first L1→L2 message to be ready...`);
+            const firstMsg = allMessages[0];
+            await waitForL1ToL2MessageReady(this.aztecNode, Fr.fromHexString(firstMsg.msgHash), {
+                timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
+                chainTip: this.syncChainTip
+            });
+            this.log.info(`First L1→L2 message is ready`);
+        }
+        return {
+            wallet: this.wallet,
+            defaultAccountAddress,
+            contract,
+            node: this.aztecNode,
+            l1Client,
+            rollupVersion
+        };
+    }
+    async deployTestContract(deployer, deploy) {
+        const instance = await this.registerOrDeployContract('TestContract', deploy, {
+            from: deployer
+        });
+        return TestContract.at(instance.address, this.wallet);
+    }
+    /**
+   * Checks if the sender account contract is initialized, and initializes it if necessary.
+   * @returns The sender wallet.
+   */ async setupAccount() {
+        const privateKey = this.config.senderPrivateKey?.getValue();
+        if (privateKey) {
+            this.log.info(`Setting up account with provided private key`);
+            return await this.setupAccountWithPrivateKey(privateKey);
+        } else {
+            this.log.info(`Setting up test account`);
+            return await this.setupTestAccount();
+        }
+    }
+    /**
+   * Keyless fallback for tests and local dev: reuses the first genesis test account, whose address is
+   * pre-funded with fee juice via `initialFundedAccounts`. The test accounts are initializerless, so this
+   * must create an initializerless account for the address to match the funded one. Production bots set a
+   * sender private key and fund the resulting initializerless account from L1 instead; see
+   * setupAccountWithPrivateKey.
+   */ async setupTestAccount() {
+        const [initialAccountData] = await getInitialTestAccountsData();
+        const accountManager = await this.wallet.createSchnorrInitializerlessAccount(initialAccountData.secret, initialAccountData.salt, initialAccountData.signingKey);
+        return accountManager.address;
+    }
+    async setupAccountWithPrivateKey(privateKey) {
+        const salt = this.config.senderSalt ?? Fr.ONE;
+        const signingKey = GrumpkinScalar.fromBuffer(privateKey.toBuffer());
+        const secret = await deriveSecretKeyFromSigningKey(signingKey);
+        const accountManager = await this.wallet.createSchnorrInitializerlessAccount(secret, salt, signingKey);
+        return accountManager.address;
+    }
+    /**
+   * Checks if the token contract is deployed and deploys it if necessary.
+   * Uses a bridge claim for deploy when balance is below threshold to avoid failing before refuel.
+   * @param sender - Aztec address to deploy the token contract from.
+   * @param existingToken - Optional token instance when called from setupTokenWithOptionalEarlyRefuel.
+   * @returns The TokenContract or PrivateTokenContract instance.
+   */ async setupToken(sender) {
+        let deploy;
+        const salt = this.config.tokenSalt;
+        const deployOpts = {
+            from: sender
+        };
+        let token;
+        if (this.config.contract === SupportedTokenContracts.TokenContract) {
+            deploy = TokenContract.deploy(this.wallet, sender, 'BotToken', 'BOT', 18, {
+                salt,
+                universalDeploy: true
+            });
+            const instance = await deploy.getInstance();
+            token = TokenContract.at(instance.address, this.wallet);
+        } else if (this.config.contract === SupportedTokenContracts.PrivateTokenContract) {
+            // Generate keys for the contract since PrivateToken uses SinglePrivateMutable which requires keys
+            const tokenSecretKey = Fr.random();
+            const tokenPublicKeys = (await deriveKeys(tokenSecretKey)).publicKeys;
+            deploy = PrivateTokenContract.deploy(this.wallet, MINT_BALANCE, sender, {
+                salt,
+                universalDeploy: true,
+                publicKeys: tokenPublicKeys
+            });
+            deployOpts.skipInstancePublication = true;
+            deployOpts.skipClassPublication = true;
+            deployOpts.skipInitialization = false;
+            // Register the contract with the secret key before deployment
+            const tokenInstance = await deploy.getInstance();
+            token = PrivateTokenContract.at(tokenInstance.address, this.wallet);
+            await this.wallet.registerContract(tokenInstance, PrivateTokenContract.artifact, tokenSecretKey);
+            // The contract constructor initializes private storage vars that need the contract's own nullifier key.
+            deployOpts.additionalScopes = [
+                tokenInstance.address
+            ];
+        } else {
+            throw new Error(`Unsupported token contract type: ${this.config.contract}`);
+        }
+        await this.registerOrDeployContract('token', deploy, deployOpts);
+        return token;
+    }
+    /**
+   * Checks if the token contract is deployed and deploys it if necessary.
+   * @param wallet - Wallet to deploy the token contract from.
+   * @returns The TokenContract instance.
+   */ async setupTokenContract(deployer, salt, name, ticker, decimals = 18) {
+        const deployOpts = {
+            from: deployer
+        };
+        const deploy = TokenContract.deploy(this.wallet, deployer, name, ticker, decimals, {
+            salt,
+            universalDeploy: true
+        });
+        const instance = await this.registerOrDeployContract('Token - ' + name, deploy, deployOpts);
+        return TokenContract.at(instance.address, this.wallet);
+    }
+    async deployAmmContract(deployer, deploy) {
+        const instance = await this.registerOrDeployContract('AMM', deploy, {
+            from: deployer
+        });
+        const amm = AMMContract.at(instance.address, this.wallet);
+        this.log.info(`AMM deployed at ${amm.address}`);
+        return amm;
+    }
+    /** Grants the AMM minting rights over the LP token. set_minter only records the address, so it does not
+   * require the AMM contract to be deployed first. */ async grantLpTokenMinter(deployer, lpToken, amm) {
+        const { receipt } = await lpToken.methods.set_minter(amm, true).send({
+            from: deployer,
+            wait: {
+                timeout: this.config.txMinedWaitSeconds
+            }
+        });
+        this.log.info(`Set LP token minter to AMM txHash=${receipt.txHash.toString()}`);
+    }
+    async mintAmmLiquidity(minter, token0, token1) {
+        this.log.info(`Minting ${MINT_BALANCE} tokens of each BotToken0 and BotToken1 for ${minter}`);
+        const mintBatch = new BatchCall(this.wallet, [
+            token0.methods.mint_to_private(minter, MINT_BALANCE),
+            token1.methods.mint_to_private(minter, MINT_BALANCE)
+        ]);
+        const { receipt } = await mintBatch.send({
+            from: minter,
+            wait: {
+                timeout: this.config.txMinedWaitSeconds
+            }
+        });
+        this.log.info(`Sent mint tx: ${receipt.txHash.toString()}`);
+    }
+    async addAmmLiquidity(defaultAccountAddress, liquidityProvider, amm, token0, token1, lpToken) {
+        const authwitNonce = Fr.random();
+        // keep some tokens for swapping
+        const amount0Max = MINT_BALANCE / 2;
+        const amount0Min = MINT_BALANCE / 4;
+        const amount1Max = MINT_BALANCE / 2;
+        const amount1Min = MINT_BALANCE / 4;
+        // Add authwitnesses for the transfers in AMM::add_liquidity function
+        const token0Authwit = await this.wallet.createAuthWit(defaultAccountAddress, {
+            caller: amm.address,
+            call: await token0.methods.transfer_to_public_and_prepare_private_balance_increase(liquidityProvider, amm.address, amount0Max, authwitNonce).getFunctionCall()
+        });
+        const token1Authwit = await this.wallet.createAuthWit(defaultAccountAddress, {
+            caller: amm.address,
+            call: await token1.methods.transfer_to_public_and_prepare_private_balance_increase(liquidityProvider, amm.address, amount1Max, authwitNonce).getFunctionCall()
+        });
+        const { receipt } = await amm.methods.add_liquidity(amount0Max, amount1Max, amount0Min, amount1Min, authwitNonce).send({
+            from: liquidityProvider,
+            authWitnesses: [
+                token0Authwit,
+                token1Authwit
+            ],
+            wait: {
+                timeout: this.config.txMinedWaitSeconds
+            }
+        });
+        this.log.info(`Sent tx to add liquidity to the AMM: ${receipt.txHash.toString()}`);
+        this.log.info(`Liquidity added`);
+        const [t0Bal, t1Bal, lpBal] = await Promise.all([
+            token0.methods.balance_of_private(liquidityProvider).simulate({
+                from: liquidityProvider
+            }).then((r)=>r.result),
+            token1.methods.balance_of_private(liquidityProvider).simulate({
+                from: liquidityProvider
+            }).then((r)=>r.result),
+            lpToken.methods.balance_of_private(liquidityProvider).simulate({
+                from: liquidityProvider
+            }).then((r)=>r.result)
+        ]);
+        this.log.info(`Updated private balances of ${defaultAccountAddress} after minting and funding AMM: token0=${t0Bal}, token1=${t1Bal}, lp=${lpBal}`);
+    }
+    async registerOrDeployContract(name, deploy, deployOpts) {
+        const instance = await deploy.getInstance();
+        const address = instance.address;
+        const metadata = await this.wallet.getContractMetadata(address);
+        if (metadata.isContractPublished) {
+            this.log.info(`Contract ${name} at ${address.toString()} already deployed`);
+            await deploy.register();
+            return instance;
+        }
+        // Setup always runs ensureFeeJuiceBalance before any deploy, so the account pays from its standing
+        // balance here. No manual gas estimation: the embedded wallet simulates before sending and derives
+        // the gas limits and padded maxFeesPerGas itself.
+        this.log.info(`Deploying contract ${name} at ${address.toString()}`);
+        await this.withNoMinTxsPerBlock(async ()=>{
+            const { txHash } = await deploy.send({
+                ...deployOpts,
+                wait: NO_WAIT
+            });
+            this.log.info(`Sent contract ${name} deploy tx ${txHash.toString()}`);
+            return waitForTx(this.aztecNode, txHash, {
+                timeout: this.config.txMinedWaitSeconds
+            });
+        });
+        return instance;
+    }
+    /** True when the config allows bridging fee juice from L1 (fee_juice mode, an L1 RPC, and an L1 key). */ isL1BridgingConfigured() {
+        const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
+        return this.config.feePaymentMethod === 'fee_juice' && !!this.config.l1RpcUrls?.length && !!mnemonicOrPrivateKey;
+    }
+    /**
+   * Ensures the account holds enough fee juice before any other setup step. The account starts empty
+   * (initializerless accounts have no deployment tx) and the runtime loop pays fees from this balance and
+   * never refuels itself, so every flow funds the account up front. Bridges claims from L1 and consumes
+   * each with a claim-only tx until the balance clears the threshold, working from a zero (fresh run) or
+   * drained (restart) balance. Each bridge mints a fixed amount well above the threshold, so this is a
+   * single bridge in practice. No-op when L1 bridging is not configured or the balance is already above
+   * the threshold.
+   */ async ensureFeeJuiceBalance(account) {
+        if (!this.isL1BridgingConfigured()) {
+            return;
+        }
+        let balance = await getFeeJuiceBalance(account, this.aztecNode);
+        if (balance >= FEE_JUICE_TOP_UP_THRESHOLD) {
+            this.log.info(`Fee juice balance ${balance} above threshold ${FEE_JUICE_TOP_UP_THRESHOLD}, skipping top-up`);
+            return;
+        }
+        this.log.info(`Fee juice balance ${balance} below threshold ${FEE_JUICE_TOP_UP_THRESHOLD}, bridging from L1`);
+        while(balance < FEE_JUICE_TOP_UP_THRESHOLD){
+            // Persist the claim before consuming it: if the top-up tx fails or the bot crashes mid-loop, the
+            // next run reuses the pending claim instead of bridging again (and wasting the bridged funds).
+            const claim = await this.getOrCreateBridgeClaim(account);
+            const paymentMethod = new FeeJuicePaymentMethodWithClaim(account, claim);
+            await this.withNoMinTxsPerBlock(async ()=>{
+                const executionPayload = await paymentMethod.getExecutionPayload();
+                const { txHash } = await this.wallet.sendTx(executionPayload, {
+                    from: account,
+                    wait: NO_WAIT
+                });
+                this.log.info(`Sent fee juice top-up tx ${txHash.toString()}`);
+                return waitForTx(this.aztecNode, txHash, {
+                    timeout: this.config.txMinedWaitSeconds
+                });
+            });
+            await this.store.deleteBridgeClaim(account);
+            balance = await getFeeJuiceBalance(account, this.aztecNode);
+            this.log.info(`Fee juice balance after top-up: ${balance}`);
+        }
+        this.log.info(`Fee juice top-up complete for ${account.toString()}`);
+    }
+    async mintTokens(token, minter) {
+        const isStandardToken = isStandardTokenContract(token);
+        let privateBalance = 0n;
+        let publicBalance = 0n;
+        if (isStandardToken) {
+            ({ privateBalance, publicBalance } = await getBalances(token, minter));
+        } else {
+            privateBalance = await getPrivateBalance(token, minter);
+        }
+        const calls = [];
+        if (privateBalance < MIN_BALANCE) {
+            this.log.info(`Minting private tokens for ${minter.toString()}`);
+            calls.push(isStandardToken ? token.methods.mint_to_private(minter, MINT_BALANCE) : token.methods.mint(MINT_BALANCE, minter));
+        }
+        if (isStandardToken && publicBalance < MIN_BALANCE) {
+            this.log.info(`Minting public tokens for ${minter.toString()}`);
+            calls.push(token.methods.mint_to_public(minter, MINT_BALANCE));
+        }
+        if (calls.length === 0) {
+            this.log.info(`Skipping minting as ${minter.toString()} has enough tokens`);
+            return;
+        }
+        // PrivateToken's mint accesses contract-level private storage vars (admin, total_supply).
+        const additionalScopes = isStandardToken ? undefined : [
+            token.address
+        ];
+        const mintBatch = new BatchCall(token.wallet, calls);
+        await this.withNoMinTxsPerBlock(async ()=>{
+            const { txHash } = await mintBatch.send({
+                from: minter,
+                additionalScopes,
+                wait: NO_WAIT
+            });
+            this.log.info(`Sent token mint tx with hash ${txHash.toString()}`);
+            return waitForTx(this.aztecNode, txHash, {
+                timeout: this.config.txMinedWaitSeconds
+            });
+        });
+    }
+    /**
+   * Returns a usable bridge claim for the recipient, reusing a persisted one when its L1→L2 message is
+   * still available (resuming a top-up that failed or crashed before the claim was consumed) and bridging
+   * a fresh claim otherwise. The caller deletes the claim from the store once it has been consumed.
+   */ async getOrCreateBridgeClaim(recipient) {
+        const existingClaim = await this.store.getBridgeClaim(recipient);
+        if (existingClaim) {
+            this.log.info(`Found existing bridge claim for ${recipient.toString()}, checking validity...`);
+            try {
+                const messageHash = Fr.fromHexString(existingClaim.claim.messageHash);
+                await this.withNoMinTxsPerBlock(()=>waitForL1ToL2MessageReady(this.aztecNode, messageHash, {
+                        timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
+                        chainTip: this.syncChainTip
+                    }));
+                return existingClaim.claim;
+            } catch (err) {
+                this.log.warn(`Failed to verify existing claim, creating new one: ${err}`);
+                await this.store.deleteBridgeClaim(recipient);
+            }
+        }
+        const claim = await this.bridgeL1FeeJuice(recipient);
+        await this.store.saveBridgeClaim(recipient, claim);
+        return claim;
+    }
+    async bridgeL1FeeJuice(recipient) {
+        const l1RpcUrls = this.config.l1RpcUrls;
+        if (!l1RpcUrls?.length) {
+            throw new Error('L1 Rpc url is required to bridge the fee juice to fund the deployment of the account.');
+        }
+        const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
+        if (!mnemonicOrPrivateKey) {
+            throw new Error('Either a mnemonic or private key of an L1 account is required to bridge the fee juice to fund the deployment of the account.');
+        }
+        const { l1ChainId } = await this.aztecNode.getNodeInfo();
+        const chain = createEthereumChain(l1RpcUrls, l1ChainId);
+        const extendedClient = createExtendedL1Client(chain.rpcUrls, mnemonicOrPrivateKey, chain.chainInfo);
+        const portal = await L1FeeJuicePortalManager.new(this.aztecNode, extendedClient, this.log);
+        const mintAmount = await portal.getTokenManager().getMintAmount();
+        const claim = await portal.bridgeTokensPublic(recipient, mintAmount, true);
+        await this.withNoMinTxsPerBlock(()=>waitForL1ToL2MessageReady(this.aztecNode, Fr.fromHexString(claim.messageHash), {
+                timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
+                chainTip: this.syncChainTip
+            }));
+        this.log.info(`Created a claim for ${mintAmount} L1 fee juice to ${recipient}.`, claim);
+        return claim;
+    }
+    async withNoMinTxsPerBlock(fn) {
+        if (!this.aztecNodeAdmin || !this.config.flushSetupTransactions) {
+            this.log.verbose(`No node admin client or flushing not requested (not setting minTxsPerBlock to 0)`);
+            return fn();
+        }
+        const aztecNodeAdmin = this.aztecNodeAdmin;
+        // Setup steps run concurrently, so this wrapper can be re-entered while another call is in flight.
+        // Reference-count the entrants: the first saves the current value and zeroes it, the last restores it.
+        // A naive save/zero/restore per call could interleave, with a late entrant reading the already-zeroed
+        // value and "restoring" 0 at the end.
+        if (this.noMinTxsPerBlockDepth++ === 0) {
+            this.savedMinTxsPerBlock = (async ()=>{
+                const { minTxsPerBlock } = await aztecNodeAdmin.getConfig();
+                this.log.warn(`Setting sequencer minTxsPerBlock to 0 from ${minTxsPerBlock} to flush setup transactions`);
+                await aztecNodeAdmin.setConfig({
+                    minTxsPerBlock: 0
+                });
+                return {
+                    minTxsPerBlock
+                };
+            })();
+        }
+        try {
+            await this.savedMinTxsPerBlock;
+            return await fn();
+        } finally{
+            if (--this.noMinTxsPerBlockDepth === 0) {
+                // If saving/zeroing itself failed there is nothing to restore.
+                const saved = await this.savedMinTxsPerBlock.catch(()=>undefined);
+                if (saved) {
+                    this.log.warn(`Restoring sequencer minTxsPerBlock to ${saved.minTxsPerBlock}`);
+                    await aztecNodeAdmin.setConfig({
+                        minTxsPerBlock: saved.minTxsPerBlock
+                    });
+                }
+            }
+        }
+    }
+}

package/dest/index.d.ts

@@ -0,0 +1,9 @@
+export { Bot } from './bot.js';
+export { AmmBot } from './amm_bot.js';
+export { CrossChainBot } from './cross_chain_bot.js';
+export { BotRunner } from './runner.js';
+export { BotStore } from './store/bot_store.js';
+export { type BotConfig, getBotConfigFromEnv, getBotDefaultConfig, botConfigMappings, SupportedTokenContracts, } from './config.js';
+export { getBotRunnerApiHandler } from './rpc.js';
+export * from './interface.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQy9CLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDdEMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ3JELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDeEMsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ2hELE9BQU8sRUFDTCxLQUFLLFNBQVMsRUFDZCxtQkFBbUIsRUFDbkIsbUJBQW1CLEVBQ25CLGlCQUFpQixFQUNqQix1QkFBdUIsR0FDeEIsTUFBTSxhQUFhLENBQUM7QUFDckIsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ2xELGNBQWMsZ0JBQWdCLENBQUMifQ==

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,KAAK,SAAS,EACd,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,cAAc,gBAAgB,CAAC"}

package/dest/index.js

@@ -0,0 +1,8 @@
+export { Bot } from './bot.js';
+export { AmmBot } from './amm_bot.js';
+export { CrossChainBot } from './cross_chain_bot.js';
+export { BotRunner } from './runner.js';
+export { BotStore } from './store/bot_store.js';
+export { getBotConfigFromEnv, getBotDefaultConfig, botConfigMappings, SupportedTokenContracts } from './config.js';
+export { getBotRunnerApiHandler } from './rpc.js';
+export * from './interface.js';

package/dest/interface.d.ts

@@ -0,0 +1,19 @@
+import { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import type { ApiSchemaFor } from '@aztec-labs/stdlib/schemas';
+import { z } from 'zod';
+import { type BotConfig } from './config.js';
+export declare const BotInfoSchema: z.ZodObject<{
+    botAddress: import("@aztec-labs/stdlib/schemas").ZodFor<AztecAddress>;
+}, z.core.$strip>;
+export type BotInfo = z.infer<typeof BotInfoSchema>;
+export interface BotRunnerApi {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    run(): Promise<void>;
+    setup(): Promise<void>;
+    getConfig(): Promise<BotConfig>;
+    getInfo(): Promise<BotInfo>;
+    update(config: BotConfig): Promise<void>;
+}
+export declare const BotRunnerApiSchema: ApiSchemaFor<BotRunnerApi>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW50ZXJmYWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM5RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFBRSxLQUFLLFNBQVMsRUFBbUIsTUFBTSxhQUFhLENBQUM7QUFFOUQsZUFBTyxNQUFNLGFBQWE7O2lCQUV4QixDQUFDO0FBRUgsTUFBTSxNQUFNLE9BQU8sR0FBRyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sYUFBYSxDQUFDLENBQUM7QUFFcEQsTUFBTSxXQUFXLFlBQVk7SUFDM0IsS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN2QixJQUFJLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3RCLEdBQUcsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDckIsS0FBSyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN2QixTQUFTLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQ2hDLE9BQU8sSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDNUIsTUFBTSxDQUFDLE1BQU0sRUFBRSxTQUFTLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0NBQzFDO0FBRUQsZUFBTyxNQUFNLGtCQUFrQixFQUFFLFlBQVksQ0FBQyxZQUFZLENBUXpELENBQUMifQ==

package/dest/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,aAAa,CAAC;AAE9D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,YAAY,CAQzD,CAAC"}

package/dest/interface.js

@@ -0,0 +1,38 @@
+import { AztecAddress } from '@aztec-labs/aztec.js/addresses';
+import { z } from 'zod';
+import { BotConfigSchema } from './config.js';
+export const BotInfoSchema = z.object({
+    botAddress: AztecAddress.schema
+});
+export const BotRunnerApiSchema = {
+    start: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    stop: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    run: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    setup: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    getInfo: z.function({
+        input: z.tuple([]),
+        output: BotInfoSchema
+    }),
+    getConfig: z.function({
+        input: z.tuple([]),
+        output: BotConfigSchema
+    }),
+    update: z.function({
+        input: z.tuple([
+            BotConfigSchema
+        ]),
+        output: z.void()
+    })
+};

package/dest/l1_to_l2_seeding.d.ts

@@ -0,0 +1,8 @@
+import type { ExtendedViemWalletClient } from '@aztec-labs/ethereum/types';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import type { Logger } from '@aztec-labs/foundation/log';
+import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
+import type { BotStore, PendingL1ToL2Message } from './store/index.js';
+/** Sends an L1→L2 message via the Inbox contract and stores it. */
+export declare function seedL1ToL2Message(l1Client: ExtendedViemWalletClient, inboxAddress: EthAddress, l2Recipient: AztecAddress, rollupVersion: bigint, store: BotStore, log: Logger): Promise<PendingL1ToL2Message>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfdG9fbDJfc2VlZGluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2wxX3RvX2wyX3NlZWRpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUczRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0NBQW9DLENBQUM7QUFDaEUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFHckUsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLG9CQUFvQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFdkUscUVBQW1FO0FBQ25FLHdCQUFzQixpQkFBaUIsQ0FDckMsUUFBUSxFQUFFLHdCQUF3QixFQUNsQyxZQUFZLEVBQUUsVUFBVSxFQUN4QixXQUFXLEVBQUUsWUFBWSxFQUN6QixhQUFhLEVBQUUsTUFBTSxFQUNyQixLQUFLLEVBQUUsUUFBUSxFQUNmLEdBQUcsRUFBRSxNQUFNLEdBQ1YsT0FBTyxDQUFDLG9CQUFvQixDQUFDLENBeUQvQiJ9

package/dest/l1_to_l2_seeding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_to_l2_seeding.d.ts","sourceRoot":"","sources":["../src/l1_to_l2_seeding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,qEAAmE;AACnE,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,wBAAwB,EAClC,YAAY,EAAE,UAAU,EACxB,WAAW,EAAE,YAAY,EACzB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC,CAyD/B"}