@aztec/bot 0.0.0-test.1 → 0.0.1-commit.017a351

package/dest/factory.js

@@ -1,229 +1,634 @@
-import { getSchnorrAccount } from '@aztec/accounts/schnorr';
-import { getDeployedTestAccountsWallets, getInitialTestAccounts } from '@aztec/accounts/testing';
-import { BatchCall, FeeJuicePaymentMethodWithClaim, L1FeeJuicePortalManager, createLogger, createPXEClient, retryUntil } from '@aztec/aztec.js';
-import { createEthereumChain, createL1Clients } from '@aztec/ethereum';
-import { Fr } from '@aztec/foundation/fields';
-import { EasyPrivateTokenContract } from '@aztec/noir-contracts.js/EasyPrivateToken';
+import { getInitialTestAccountsData } from '@aztec/accounts/testing';
+import { NO_FROM } from '@aztec/aztec.js/account';
+import { BatchCall, NO_WAIT } from '@aztec/aztec.js/contracts';
+import { L1FeeJuicePortalManager } from '@aztec/aztec.js/ethereum';
+import { FeeJuicePaymentMethodWithClaim } from '@aztec/aztec.js/fee';
+import { deriveKeys } from '@aztec/aztec.js/keys';
+import { createLogger } from '@aztec/aztec.js/log';
+import { waitForL1ToL2MessageReady } from '@aztec/aztec.js/messaging';
+import { waitForTx } from '@aztec/aztec.js/node';
+import { getFeeJuiceBalance } from '@aztec/aztec.js/utils';
+import { ContractInitializationStatus } from '@aztec/aztec.js/wallet';
+import { createEthereumChain } from '@aztec/ethereum/chain';
+import { createExtendedL1Client } from '@aztec/ethereum/client';
+import { RollupContract } from '@aztec/ethereum/contracts';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Timer } from '@aztec/foundation/timer';
+import { AMMContract } from '@aztec/noir-contracts.js/AMM';
+import { PrivateTokenContract } from '@aztec/noir-contracts.js/PrivateToken';
 import { TokenContract } from '@aztec/noir-contracts.js/Token';
+import { TestContract } from '@aztec/noir-test-contracts.js/Test';
+import { GasFees, GasSettings, ManaUsageEstimate } from '@aztec/stdlib/gas';
 import { deriveSigningKey } from '@aztec/stdlib/keys';
-import { makeTracedFetch } from '@aztec/telemetry-client';
-import { SupportedTokenContracts, getVersions } from './config.js';
+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;
+const FEE_JUICE_TOP_UP_TARGET = 10_000n * 10n ** 18n;
 export class BotFactory {
     config;
-    pxe;
-    node;
+    wallet;
+    store;
+    aztecNode;
+    aztecNodeAdmin;
     log;
-    constructor(config, dependencies = {}){
+    constructor(config, wallet, store, aztecNode, aztecNodeAdmin){
         this.config = config;
+        this.wallet = wallet;
+        this.store = store;
+        this.aztecNode = aztecNode;
+        this.aztecNodeAdmin = aztecNodeAdmin;
         this.log = createLogger('bot');
-        if (config.flushSetupTransactions && !dependencies.node) {
-            throw new Error(`Either a node client or node url must be provided if transaction flushing is requested`);
-        }
-        if (config.senderPrivateKey && !dependencies.node) {
-            throw new Error(`Either a node client or node url must be provided for bridging L1 fee juice to deploy an account with private key`);
-        }
-        if (!dependencies.pxe && !config.pxeUrl) {
-            throw new Error(`Either a PXE client or a PXE URL must be provided`);
-        }
-        this.node = dependencies.node;
-        if (dependencies.pxe) {
-            this.log.info(`Using local PXE`);
-            this.pxe = dependencies.pxe;
-            return;
-        }
-        this.log.info(`Using remote PXE at ${config.pxeUrl}`);
-        this.pxe = createPXEClient(config.pxeUrl, getVersions(), makeTracedFetch([
-            1,
-            2,
-            3
-        ], false));
+        // 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 recipient = await this.registerRecipient();
-        const wallet = await this.setupAccount();
-        const token = await this.setupToken(wallet);
-        await this.mintTokens(token);
+        const defaultAccountAddress = await this.setupAccount();
+        const recipient = (await this.wallet.createSchnorrAccount(Fr.random(), Fr.random())).address;
+        const token = await this.setupTokenWithOptionalEarlyRefuel(defaultAccountAddress);
+        await this.ensureFeeJuiceBalance(defaultAccountAddress, token);
+        await this.mintTokens(token, defaultAccountAddress);
         return {
-            wallet,
+            wallet: this.wallet,
+            defaultAccountAddress,
             token,
-            pxe: this.pxe,
+            node: this.aztecNode,
             recipient
         };
     }
+    async setupAmm() {
+        const defaultAccountAddress = await this.setupAccount();
+        const token0 = await this.setupTokenContractWithOptionalEarlyRefuel(defaultAccountAddress, this.config.tokenSalt, 'BotToken0', 'BOT0');
+        await this.ensureFeeJuiceBalance(defaultAccountAddress, token0);
+        const token1 = await this.setupTokenContract(defaultAccountAddress, this.config.tokenSalt, 'BotToken1', 'BOT1');
+        const liquidityToken = await this.setupTokenContract(defaultAccountAddress, this.config.tokenSalt, 'BotLPToken', 'BOTLP');
+        const amm = await this.setupAmmContract(defaultAccountAddress, this.config.tokenSalt, token0, token1, liquidityToken);
+        await this.fundAmm(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();
+        // 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();
+        // Deploy TestContract
+        const contract = await this.setupTestContract(defaultAccountAddress);
+        // 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
+        const seedCount = Math.max(0, this.config.l1ToL2SeedCount - pendingMessages.length);
+        for(let i = 0; i < seedCount; i++){
+            await seedL1ToL2Message(l1Client, EthAddress.fromString(l1ContractAddresses.inboxAddress.toString()), contract.address, 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
+            });
+            this.log.info(`First L1→L2 message is ready`);
+        }
+        return {
+            wallet: this.wallet,
+            defaultAccountAddress,
+            contract,
+            node: this.aztecNode,
+            l1Client,
+            rollupVersion
+        };
+    }
+    async setupTestContract(deployer) {
+        const deployOpts = {
+            from: deployer
+        };
+        const deploy = TestContract.deploy(this.wallet, {
+            salt: this.config.tokenSalt,
+            universalDeploy: true
+        });
+        const instance = await this.registerOrDeployContract('TestContract', deploy, deployOpts);
+        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() {
-        if (this.config.senderPrivateKey) {
-            return await this.setupAccountWithPrivateKey(this.config.senderPrivateKey);
+        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();
         }
     }
-    async setupAccountWithPrivateKey(privateKey) {
-        const salt = Fr.ONE;
-        const signingKey = deriveSigningKey(privateKey);
-        const account = await getSchnorrAccount(this.pxe, privateKey, signingKey, salt);
-        const isInit = (await this.pxe.getContractMetadata(account.getAddress())).isContractInitialized;
-        if (isInit) {
-            this.log.info(`Account at ${account.getAddress().toString()} already initialized`);
-            const wallet = await account.register();
-            return wallet;
+    async setupAccountWithPrivateKey(secret) {
+        const salt = this.config.senderSalt ?? Fr.ONE;
+        const signingKey = deriveSigningKey(secret);
+        const accountManager = await this.wallet.createSchnorrAccount(secret, salt, signingKey);
+        const metadata = await this.wallet.getContractMetadata(accountManager.address);
+        if (metadata.initializationStatus === ContractInitializationStatus.INITIALIZED) {
+            this.log.info(`Account at ${accountManager.address.toString()} already initialized`);
+            const timer = new Timer();
+            const address = accountManager.address;
+            this.log.info(`Account at ${address} registered. duration=${timer.ms()}`);
+            await this.store.deleteBridgeClaim(address);
+            return address;
         } else {
-            const address = account.getAddress();
+            const address = accountManager.address;
             this.log.info(`Deploying account at ${address}`);
-            const claim = await this.bridgeL1FeeJuice(address, 10n ** 22n);
-            const wallet = await account.getWallet();
-            const paymentMethod = new FeeJuicePaymentMethodWithClaim(wallet, claim);
-            const sentTx = account.deploy({
-                fee: {
-                    paymentMethod
-                }
-            });
-            const txHash = await sentTx.getTxHash();
-            this.log.info(`Sent tx with hash ${txHash.toString()}`);
-            await this.tryFlushTxs();
-            this.log.verbose('Waiting for account deployment to settle');
-            await sentTx.wait({
-                timeout: this.config.txMinedWaitSeconds
+            const claim = await this.getOrCreateBridgeClaim(address);
+            const paymentMethod = new FeeJuicePaymentMethodWithClaim(accountManager.address, claim);
+            const deployMethod = await accountManager.getDeployMethod();
+            await this.withNoMinTxsPerBlock(async ()=>{
+                const { txHash } = await deployMethod.send({
+                    from: NO_FROM,
+                    fee: {
+                        paymentMethod
+                    },
+                    wait: NO_WAIT
+                });
+                this.log.info(`Sent tx for account deployment with hash ${txHash.toString()}`);
+                return waitForTx(this.aztecNode, txHash, {
+                    timeout: this.config.txMinedWaitSeconds
+                });
             });
             this.log.info(`Account deployed at ${address}`);
-            return wallet;
+            // Clean up the consumed bridge claim
+            await this.store.deleteBridgeClaim(address);
+            return accountManager.address;
         }
     }
     async setupTestAccount() {
-        let [wallet] = await getDeployedTestAccountsWallets(this.pxe);
-        if (wallet) {
-            this.log.info(`Using funded test account: ${wallet.getAddress()}`);
-        } else {
-            this.log.info('Registering funded test account');
-            const [account] = await getInitialTestAccounts();
-            const manager = await getSchnorrAccount(this.pxe, account.secret, account.signingKey, account.salt);
-            wallet = await manager.register();
-            this.log.info(`Funded test account registered: ${wallet.getAddress()}`);
+        const [initialAccountData] = await getInitialTestAccountsData();
+        const accountManager = await this.wallet.createSchnorrAccount(initialAccountData.secret, initialAccountData.salt, initialAccountData.signingKey);
+        return accountManager.address;
+    }
+    /**
+   * Setup token and refuel first: if the token already exists (restart scenario),
+   * run ensureFeeJuiceBalance before any step that might need fee juice. When deploying,
+   * use a bridge claim if balance is below threshold.
+   */ async setupTokenWithOptionalEarlyRefuel(sender) {
+        const token = await this.getTokenInstance(sender);
+        const address = token.address;
+        const metadata = await this.wallet.getContractMetadata(address);
+        if (metadata.isContractPublished) {
+            this.log.info(`Token at ${address.toString()} already deployed, refueling before setup`);
+            await this.ensureFeeJuiceBalance(sender, token);
         }
-        return wallet;
+        return this.setupToken(sender);
     }
     /**
-   * Registers the recipient for txs in the pxe.
-   */ async registerRecipient() {
-        const recipient = await this.pxe.registerAccount(this.config.recipientEncryptionSecret, Fr.ONE);
-        return recipient.address;
+   * Setup token0 for AMM with refuel-first behaviour when token already exists.
+   */ async setupTokenContractWithOptionalEarlyRefuel(deployer, salt, name, ticker, decimals = 18) {
+        const deploy = TokenContract.deploy(this.wallet, deployer, name, ticker, decimals, {
+            salt,
+            universalDeploy: true
+        });
+        const instance = await deploy.getInstance();
+        const metadata = await this.wallet.getContractMetadata(instance.address);
+        if (metadata.isContractPublished) {
+            this.log.info(`Token ${name} at ${instance.address.toString()} already deployed, refueling before setup`);
+            const token = TokenContract.at(instance.address, this.wallet);
+            await this.ensureFeeJuiceBalance(deployer, token);
+        }
+        return this.setupTokenContract(deployer, salt, name, ticker, decimals);
+    }
+    async getTokenInstance(sender) {
+        const salt = this.config.tokenSalt;
+        if (this.config.contract === SupportedTokenContracts.TokenContract) {
+            const deploy = TokenContract.deploy(this.wallet, sender, 'BotToken', 'BOT', 18, {
+                salt,
+                universalDeploy: true
+            });
+            const instance = await deploy.getInstance();
+            return TokenContract.at(instance.address, this.wallet);
+        }
+        if (this.config.contract === SupportedTokenContracts.PrivateTokenContract) {
+            const tokenSecretKey = Fr.random();
+            const tokenPublicKeys = (await deriveKeys(tokenSecretKey)).publicKeys;
+            const deploy = PrivateTokenContract.deploy(this.wallet, MINT_BALANCE, sender, {
+                salt,
+                universalDeploy: true,
+                publicKeys: tokenPublicKeys
+            });
+            const instance = await deploy.getInstance();
+            return PrivateTokenContract.at(instance.address, this.wallet);
+        }
+        throw new Error(`Unsupported token contract type: ${this.config.contract}`);
     }
     /**
    * 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 setupToken(wallet) {
+   * 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 = {
-            contractAddressSalt: this.config.tokenSalt,
-            universalDeploy: true
+            from: sender
         };
+        let token;
         if (this.config.contract === SupportedTokenContracts.TokenContract) {
-            deploy = TokenContract.deploy(wallet, wallet.getAddress(), 'BotToken', 'BOT', 18);
-        } else if (this.config.contract === SupportedTokenContracts.EasyPrivateTokenContract) {
-            deploy = EasyPrivateTokenContract.deploy(wallet, MINT_BALANCE, wallet.getAddress());
-            deployOpts.skipPublicDeployment = true;
-            deployOpts.skipClassRegistration = true;
+            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;
-            deployOpts.skipPublicSimulation = true;
+            // 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}`);
         }
-        const address = (await deploy.getInstance(deployOpts)).address;
-        if ((await this.pxe.getContractMetadata(address)).isContractPubliclyDeployed) {
-            this.log.info(`Token at ${address.toString()} already deployed`);
-            return deploy.register();
-        } else {
-            this.log.info(`Deploying token contract at ${address.toString()}`);
-            const sentTx = deploy.send(deployOpts);
-            const txHash = await sentTx.getTxHash();
-            this.log.info(`Sent tx with hash ${txHash.toString()}`);
-            await this.tryFlushTxs();
-            this.log.verbose('Waiting for token setup to settle');
-            return sentTx.deployed({
+        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 setupAmmContract(deployer, salt, token0, token1, lpToken) {
+        const deployOpts = {
+            from: deployer
+        };
+        const deploy = AMMContract.deploy(this.wallet, token0.address, token1.address, lpToken.address, {
+            salt,
+            universalDeploy: true
+        });
+        const instance = await this.registerOrDeployContract('AMM', deploy, deployOpts);
+        const amm = AMMContract.at(instance.address, this.wallet);
+        this.log.info(`AMM deployed at ${amm.address}`);
+        const setMinterInteraction = lpToken.methods.set_minter(amm.address, true);
+        const { receipt: minterReceipt } = await setMinterInteraction.send({
+            from: deployer,
+            wait: {
                 timeout: this.config.txMinedWaitSeconds
-            });
+            }
+        });
+        this.log.info(`Set LP token minter to AMM txHash=${minterReceipt.txHash.toString()}`);
+        this.log.info(`Liquidity token initialized`);
+        return amm;
+    }
+    async fundAmm(defaultAccountAddress, liquidityProvider, amm, token0, token1, lpToken) {
+        const getPrivateBalances = ()=>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)
+            ]);
+        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;
+        const [t0Bal, t1Bal, lpBal] = await getPrivateBalances();
+        this.log.info(`Minting ${MINT_BALANCE} tokens of each BotToken0 and BotToken1. Current private balances of ${liquidityProvider}: token0=${t0Bal}, token1=${t1Bal}, lp=${lpBal}`);
+        // 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 mintBatch = new BatchCall(this.wallet, [
+            token0.methods.mint_to_private(liquidityProvider, MINT_BALANCE),
+            token1.methods.mint_to_private(liquidityProvider, MINT_BALANCE)
+        ]);
+        const { receipt: mintReceipt } = await mintBatch.send({
+            from: liquidityProvider,
+            wait: {
+                timeout: this.config.txMinedWaitSeconds
+            }
+        });
+        this.log.info(`Sent mint tx: ${mintReceipt.txHash.toString()}`);
+        const addLiquidityInteraction = amm.methods.add_liquidity(amount0Max, amount1Max, amount0Min, amount1Min, authwitNonce);
+        const { receipt: addLiquidityReceipt } = await addLiquidityInteraction.send({
+            from: liquidityProvider,
+            authWitnesses: [
+                token0Authwit,
+                token1Authwit
+            ],
+            wait: {
+                timeout: this.config.txMinedWaitSeconds
+            }
+        });
+        this.log.info(`Sent tx to add liquidity to the AMM: ${addLiquidityReceipt.txHash.toString()}`);
+        this.log.info(`Liquidity added`);
+        const [newT0Bal, newT1Bal, newLPBal] = await getPrivateBalances();
+        this.log.info(`Updated private balances of ${defaultAccountAddress} after minting and funding AMM: token0=${newT0Bal}, token1=${newT1Bal}, lp=${newLPBal}`);
+    }
+    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();
+        } else {
+            const sender = deployOpts.from === NO_FROM ? undefined : deployOpts.from;
+            const balance = sender ? await getFeeJuiceBalance(sender, this.aztecNode) : 0n;
+            const useClaim = sender && balance < FEE_JUICE_TOP_UP_THRESHOLD && this.config.feePaymentMethod === 'fee_juice' && !!this.config.l1RpcUrls?.length;
+            const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
+            if (useClaim && mnemonicOrPrivateKey) {
+                const claim = await this.getOrCreateBridgeClaim(sender);
+                const paymentMethod = new FeeJuicePaymentMethodWithClaim(sender, claim);
+                const { estimatedGas } = await deploy.simulate({
+                    ...deployOpts,
+                    fee: {
+                        estimateGas: true,
+                        paymentMethod
+                    }
+                });
+                const maxFeesPerGas = (await this.getMinFees()).mul(1 + this.config.minFeePadding);
+                const gasSettings = GasSettings.from({
+                    ...estimatedGas,
+                    maxFeesPerGas,
+                    maxPriorityFeesPerGas: GasFees.empty()
+                });
+                await this.withNoMinTxsPerBlock(async ()=>{
+                    const { txHash } = await deploy.send({
+                        ...deployOpts,
+                        fee: {
+                            gasSettings,
+                            paymentMethod
+                        },
+                        wait: NO_WAIT
+                    });
+                    this.log.info(`Sent contract ${name} deploy tx ${txHash.toString()} (using bridge claim, balance was ${balance})`);
+                    return waitForTx(this.aztecNode, txHash, {
+                        timeout: this.config.txMinedWaitSeconds
+                    });
+                });
+                await this.store.deleteBridgeClaim(sender);
+            } else {
+                const { estimatedGas } = await deploy.simulate({
+                    ...deployOpts,
+                    fee: {
+                        estimateGas: true
+                    }
+                });
+                this.log.info(`Deploying contract ${name} at ${address.toString()}`, {
+                    estimatedGas
+                });
+                await this.withNoMinTxsPerBlock(async ()=>{
+                    const { txHash } = await deploy.send({
+                        ...deployOpts,
+                        fee: {
+                            gasSettings: estimatedGas
+                        },
+                        wait: NO_WAIT
+                    });
+                    this.log.info(`Sent contract ${name} setup tx with hash ${txHash.toString()}`);
+                    return waitForTx(this.aztecNode, txHash, {
+                        timeout: this.config.txMinedWaitSeconds
+                    });
+                });
+            }
         }
+        return instance;
     }
     /**
    * Mints private and public tokens for the sender if their balance is below the minimum.
    * @param token - Token contract.
-   */ async mintTokens(token) {
-        const sender = token.wallet.getAddress();
+   */ /**
+   * Ensures the account has sufficient fee juice by bridging from L1 if balance is below threshold.
+   * Bridges repeatedly until balance reaches the target (10k FJ).
+   * Used on startup/restart to top up when the account has run out after previous runs.
+   */ async ensureFeeJuiceBalance(account, token) {
+        const { feePaymentMethod, l1RpcUrls } = this.config;
+        if (feePaymentMethod !== 'fee_juice' || !l1RpcUrls?.length) {
+            return;
+        }
+        const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
+        if (!mnemonicOrPrivateKey) {
+            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 until ${FEE_JUICE_TOP_UP_TARGET}`);
+        const maxFeesPerGas = (await this.getMinFees()).mul(1 + this.config.minFeePadding);
+        const minimalInteraction = isStandardTokenContract(token) ? token.methods.transfer_in_public(account, account, 0n, 0) : token.methods.transfer(0n, account, account);
+        while(balance < FEE_JUICE_TOP_UP_TARGET){
+            const claim = await this.bridgeL1FeeJuice(account);
+            const paymentMethod = new FeeJuicePaymentMethodWithClaim(account, claim);
+            const { estimatedGas } = await minimalInteraction.simulate({
+                from: account,
+                fee: {
+                    estimateGas: true,
+                    paymentMethod
+                }
+            });
+            const gasSettings = GasSettings.from({
+                ...estimatedGas,
+                maxFeesPerGas,
+                maxPriorityFeesPerGas: GasFees.empty()
+            });
+            await this.withNoMinTxsPerBlock(async ()=>{
+                const { txHash } = await minimalInteraction.send({
+                    from: account,
+                    fee: {
+                        gasSettings,
+                        paymentMethod
+                    },
+                    wait: NO_WAIT
+                });
+                this.log.info(`Sent fee juice top-up tx ${txHash.toString()}`);
+                return waitForTx(this.aztecNode, txHash, {
+                    timeout: this.config.txMinedWaitSeconds
+                });
+            });
+            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, sender));
+            ({ privateBalance, publicBalance } = await getBalances(token, minter));
         } else {
-            privateBalance = await getPrivateBalance(token, sender);
+            privateBalance = await getPrivateBalance(token, minter);
         }
         const calls = [];
         if (privateBalance < MIN_BALANCE) {
-            this.log.info(`Minting private tokens for ${sender.toString()}`);
-            const from = sender; // we are setting from to sender here because we need a sender to calculate the tag
-            calls.push(isStandardToken ? await token.methods.mint_to_private(from, sender, MINT_BALANCE).request() : await token.methods.mint(MINT_BALANCE, sender).request());
+            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 ${sender.toString()}`);
-            calls.push(await token.methods.mint_to_public(sender, MINT_BALANCE).request());
+            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 ${sender.toString()} has enough tokens`);
+            this.log.info(`Skipping minting as ${minter.toString()} has enough tokens`);
             return;
         }
-        const sentTx = new BatchCall(token.wallet, calls).send();
-        const txHash = await sentTx.getTxHash();
-        this.log.info(`Sent tx with hash ${txHash.toString()}`);
-        await this.tryFlushTxs();
-        this.log.verbose('Waiting for token mint to settle');
-        await sentTx.wait({
-            timeout: this.config.txMinedWaitSeconds
+        // 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
+            });
         });
     }
-    async bridgeL1FeeJuice(recipient, amount) {
+    /**
+   * Gets or creates a bridge claim for the recipient.
+   * Checks if a claim already exists in the store and reuses it if valid.
+   * Only creates a new bridge if fee juice balance is below threshold.
+   */ async getOrCreateBridgeClaim(recipient) {
+        // Check if we have an existing claim in the store
+        const existingClaim = await this.store.getBridgeClaim(recipient);
+        if (existingClaim) {
+            this.log.info(`Found existing bridge claim for ${recipient.toString()}, checking validity...`);
+            // Check if the message is ready on L2
+            try {
+                const messageHash = Fr.fromHexString(existingClaim.claim.messageHash);
+                await this.withNoMinTxsPerBlock(()=>waitForL1ToL2MessageReady(this.aztecNode, messageHash, {
+                        timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds
+                    }));
+                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 || this.config.l1Mnemonic;
+        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.pxe.getNodeInfo();
+        const { l1ChainId } = await this.aztecNode.getNodeInfo();
         const chain = createEthereumChain(l1RpcUrls, l1ChainId);
-        const { publicClient, walletClient } = createL1Clients(chain.rpcUrls, mnemonicOrPrivateKey, chain.chainInfo);
-        const portal = await L1FeeJuicePortalManager.new(this.pxe, publicClient, walletClient, this.log);
-        const claim = await portal.bridgeTokensPublic(recipient, amount, true);
-        const isSynced = async ()=>await this.pxe.isL1ToL2MessageSynced(Fr.fromHexString(claim.messageHash));
-        await retryUntil(isSynced, `message ${claim.messageHash} sync`, 24, 1);
-        this.log.info(`Created a claim for ${amount} L1 fee juice to ${recipient}.`, claim);
-        // Progress by 2 L2 blocks so that the l1ToL2Message added above will be available to use on L2.
-        await this.advanceL2Block();
-        await this.advanceL2Block();
+        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
+            }));
+        this.log.info(`Created a claim for ${mintAmount} L1 fee juice to ${recipient}.`, claim);
         return claim;
     }
-    async advanceL2Block() {
-        const initialBlockNumber = await this.node.getBlockNumber();
-        await this.tryFlushTxs();
-        await retryUntil(async ()=>await this.node.getBlockNumber() >= initialBlockNumber + 1);
-    }
-    async tryFlushTxs() {
-        if (this.config.flushSetupTransactions) {
-            this.log.verbose('Flushing transactions');
-            try {
-                await this.node.flushTxs();
-            } catch (err) {
-                this.log.error(`Failed to flush transactions: ${err}`);
+    /** Returns worst-case min fees across predicted slots, with fallback to current min fees. */ async getMinFees() {
+        try {
+            const predicted = await this.aztecNode.getPredictedMinFees(ManaUsageEstimate.Limit);
+            if (predicted.length === 0) {
+                return this.aztecNode.getCurrentMinFees();
             }
+            return predicted.reduce((worst, fees)=>fees.feePerL2Gas > worst.feePerL2Gas ? fees : worst);
+        } catch  {
+            return this.aztecNode.getCurrentMinFees();
+        }
+    }
+    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 { minTxsPerBlock } = await this.aztecNodeAdmin.getConfig();
+        this.log.warn(`Setting sequencer minTxsPerBlock to 0 from ${minTxsPerBlock} to flush setup transactions`);
+        await this.aztecNodeAdmin.setConfig({
+            minTxsPerBlock: 0
+        });
+        try {
+            return await fn();
+        } finally{
+            this.log.warn(`Restoring sequencer minTxsPerBlock to ${minTxsPerBlock}`);
+            await this.aztecNodeAdmin.setConfig({
+                minTxsPerBlock
+            });
         }
     }
 }