@aztec/bot 0.0.1-commit.a89ec08 → 0.0.1-commit.aa0c64f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/factory.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { getInitialTestAccountsData } from '@aztec/accounts/testing';
2
- import { NO_FROM } from '@aztec/aztec.js/account';
2
+ import { deriveSecretKeyFromSigningKey } from '@aztec/accounts/utils';
3
3
  import { AztecAddress } from '@aztec/aztec.js/addresses';
4
4
  import {
5
5
  BatchCall,
@@ -16,21 +16,21 @@ import { deriveKeys } from '@aztec/aztec.js/keys';
16
16
  import { createLogger } from '@aztec/aztec.js/log';
17
17
  import { waitForL1ToL2MessageReady } from '@aztec/aztec.js/messaging';
18
18
  import { waitForTx } from '@aztec/aztec.js/node';
19
- import { ContractInitializationStatus } from '@aztec/aztec.js/wallet';
19
+ import { getFeeJuiceBalance } from '@aztec/aztec.js/utils';
20
20
  import { createEthereumChain } from '@aztec/ethereum/chain';
21
21
  import { createExtendedL1Client } from '@aztec/ethereum/client';
22
22
  import { RollupContract } from '@aztec/ethereum/contracts';
23
23
  import type { ExtendedViemWalletClient } from '@aztec/ethereum/types';
24
24
  import { Fr } from '@aztec/foundation/curves/bn254';
25
+ import { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
25
26
  import { EthAddress } from '@aztec/foundation/eth-address';
26
- import { Timer } from '@aztec/foundation/timer';
27
27
  import { AMMContract } from '@aztec/noir-contracts.js/AMM';
28
28
  import { PrivateTokenContract } from '@aztec/noir-contracts.js/PrivateToken';
29
29
  import { TokenContract } from '@aztec/noir-contracts.js/Token';
30
30
  import { TestContract } from '@aztec/noir-test-contracts.js/Test';
31
+ import type { BlockTag } from '@aztec/stdlib/block';
31
32
  import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
32
33
  import type { AztecNode, AztecNodeAdmin } from '@aztec/stdlib/interfaces/client';
33
- import { deriveSigningKey } from '@aztec/stdlib/keys';
34
34
  import { EmbeddedWallet } from '@aztec/wallets/embedded';
35
35
 
36
36
  import { type BotConfig, SupportedTokenContracts } from './config.js';
@@ -40,16 +40,23 @@ import { getBalances, getPrivateBalance, isStandardTokenContract } from './utils
40
40
 
41
41
  const MINT_BALANCE = 1e12;
42
42
  const MIN_BALANCE = 1e3;
43
+ const FEE_JUICE_TOP_UP_THRESHOLD = 100n * 10n ** 18n;
43
44
 
44
45
  export class BotFactory {
45
46
  private log = createLogger('bot');
46
47
 
48
+ /** Number of in-flight withNoMinTxsPerBlock calls; see that method for why they are counted. */
49
+ private noMinTxsPerBlockDepth = 0;
50
+ /** Set by the first withNoMinTxsPerBlock entrant; resolves to the minTxsPerBlock value to restore. */
51
+ private savedMinTxsPerBlock?: Promise<{ minTxsPerBlock?: number }>;
52
+
47
53
  constructor(
48
54
  private readonly config: BotConfig,
49
55
  private readonly wallet: EmbeddedWallet,
50
56
  private readonly store: BotStore,
51
57
  private readonly aztecNode: AztecNode,
52
58
  private readonly aztecNodeAdmin?: AztecNodeAdmin,
59
+ private readonly syncChainTip?: BlockTag,
53
60
  ) {
54
61
  // Set fee padding on the wallet so that all transactions during setup
55
62
  // (token deploy, minting, etc.) use the configured padding, not the default.
@@ -68,7 +75,9 @@ export class BotFactory {
68
75
  recipient: AztecAddress;
69
76
  }> {
70
77
  const defaultAccountAddress = await this.setupAccount();
71
- const recipient = (await this.wallet.createSchnorrAccount(Fr.random(), Fr.random())).address;
78
+ const recipient = (await this.wallet.createSchnorrAccount(Fr.random(), Fr.random(), GrumpkinScalar.random()))
79
+ .address;
80
+ await this.ensureFeeJuiceBalance(defaultAccountAddress);
72
81
  const token = await this.setupToken(defaultAccountAddress);
73
82
  await this.mintTokens(token, defaultAccountAddress);
74
83
  return { wallet: this.wallet, defaultAccountAddress, token, node: this.aztecNode, recipient };
@@ -83,23 +92,36 @@ export class BotFactory {
83
92
  node: AztecNode;
84
93
  }> {
85
94
  const defaultAccountAddress = await this.setupAccount();
86
- const token0 = await this.setupTokenContract(defaultAccountAddress, this.config.tokenSalt, 'BotToken0', 'BOT0');
87
- const token1 = await this.setupTokenContract(defaultAccountAddress, this.config.tokenSalt, 'BotToken1', 'BOT1');
88
- const liquidityToken = await this.setupTokenContract(
89
- defaultAccountAddress,
90
- this.config.tokenSalt,
91
- 'BotLPToken',
92
- 'BOTLP',
93
- );
94
- const amm = await this.setupAmmContract(
95
- defaultAccountAddress,
96
- this.config.tokenSalt,
97
- token0,
98
- token1,
99
- liquidityToken,
100
- );
95
+ await this.ensureFeeJuiceBalance(defaultAccountAddress);
96
+
97
+ const salt = this.config.tokenSalt;
98
+
99
+ // token0, token1 and the LP token are independent contracts with no shared state, so deploy them
100
+ // concurrently rather than one slot at a time.
101
+ const [token0, token1, liquidityToken] = await Promise.all([
102
+ this.setupTokenContract(defaultAccountAddress, salt, 'BotToken0', 'BOT0'),
103
+ this.setupTokenContract(defaultAccountAddress, salt, 'BotToken1', 'BOT1'),
104
+ this.setupTokenContract(defaultAccountAddress, salt, 'BotLPToken', 'BOTLP'),
105
+ ]);
101
106
 
102
- await this.fundAmm(defaultAccountAddress, defaultAccountAddress, amm, token0, token1, liquidityToken);
107
+ const ammDeploy = AMMContract.deploy(this.wallet, token0.address, token1.address, liquidityToken.address, {
108
+ salt,
109
+ universalDeploy: true,
110
+ });
111
+ const ammAddress = (await ammDeploy.getInstance()).address;
112
+
113
+ // The AMM constructor only stores the (already-derived) token addresses, and set_minter only records
114
+ // the AMM address on the LP token: neither reads the other's on-chain state, so the AMM deploy, the
115
+ // LP-minter grant, and the token0/token1 mints are mutually independent and run concurrently.
116
+ const [amm] = await Promise.all([
117
+ this.deployAmmContract(defaultAccountAddress, ammDeploy),
118
+ this.grantLpTokenMinter(defaultAccountAddress, liquidityToken, ammAddress),
119
+ this.mintAmmLiquidity(defaultAccountAddress, token0, token1),
120
+ ]);
121
+
122
+ // add_liquidity spends the minted token0/token1 balances and mints LP tokens, so it must follow both
123
+ // the mints and the minter grant, and target the deployed AMM.
124
+ await this.addAmmLiquidity(defaultAccountAddress, defaultAccountAddress, amm, token0, token1, liquidityToken);
103
125
  this.log.info(`AMM initialized and funded`);
104
126
 
105
127
  return { wallet: this.wallet, defaultAccountAddress, amm, token0, token1, node: this.aztecNode };
@@ -118,6 +140,7 @@ export class BotFactory {
118
140
  rollupVersion: bigint;
119
141
  }> {
120
142
  const defaultAccountAddress = await this.setupAccount();
143
+ await this.ensureFeeJuiceBalance(defaultAccountAddress);
121
144
 
122
145
  // Create L1 client (same pattern as bridgeL1FeeJuice)
123
146
  const l1RpcUrls = this.config.l1RpcUrls;
@@ -136,25 +159,32 @@ export class BotFactory {
136
159
  const rollupContract = new RollupContract(l1Client, l1ContractAddresses.rollupAddress.toString());
137
160
  const rollupVersion = await rollupContract.getVersion();
138
161
 
139
- // Deploy TestContract
140
- const contract = await this.setupTestContract(defaultAccountAddress);
162
+ // Derive the TestContract address up front (deterministic from the salt). Seeding L1→L2 messages only
163
+ // needs the L2 recipient address — the messages are queued on L1 and don't require the L2 contract to
164
+ // exist yet (they're consumed later, after setup completes) — so the deploy (an L2 tx paying from the
165
+ // standing balance funded above) and the L1 seeding run concurrently.
166
+ const testContractDeploy = TestContract.deploy(this.wallet, {
167
+ salt: this.config.tokenSalt,
168
+ universalDeploy: true,
169
+ });
170
+ const contractAddress = (await testContractDeploy.getInstance()).address;
141
171
 
142
172
  // Recover any pending messages from store (clean up stale ones first)
143
173
  await this.store.cleanupOldPendingMessages();
144
174
  const pendingMessages = await this.store.getUnconsumedL1ToL2Messages();
145
175
 
146
- // Seed initial L1→L2 messages if pipeline is empty
176
+ // Seed initial L1→L2 messages if pipeline is empty. The seeds are sent one at a time: they share the
177
+ // bot's L1 account, so concurrent sends would race on the L1 nonce.
147
178
  const seedCount = Math.max(0, this.config.l1ToL2SeedCount - pendingMessages.length);
148
- for (let i = 0; i < seedCount; i++) {
149
- await seedL1ToL2Message(
150
- l1Client,
151
- EthAddress.fromString(l1ContractAddresses.inboxAddress.toString()),
152
- contract.address,
153
- rollupVersion,
154
- this.store,
155
- this.log,
156
- );
157
- }
179
+ const inboxAddress = EthAddress.fromString(l1ContractAddresses.inboxAddress.toString());
180
+ const [contract] = await Promise.all([
181
+ this.deployTestContract(defaultAccountAddress, testContractDeploy),
182
+ (async () => {
183
+ for (let i = 0; i < seedCount; i++) {
184
+ await seedL1ToL2Message(l1Client, inboxAddress, contractAddress, rollupVersion, this.store, this.log);
185
+ }
186
+ })(),
187
+ ]);
158
188
 
159
189
  // Block until at least one message is ready
160
190
  const allMessages = await this.store.getUnconsumedL1ToL2Messages();
@@ -163,6 +193,7 @@ export class BotFactory {
163
193
  const firstMsg = allMessages[0];
164
194
  await waitForL1ToL2MessageReady(this.aztecNode, Fr.fromHexString(firstMsg.msgHash), {
165
195
  timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
196
+ chainTip: this.syncChainTip,
166
197
  });
167
198
  this.log.info(`First L1→L2 message is ready`);
168
199
  }
@@ -177,14 +208,8 @@ export class BotFactory {
177
208
  };
178
209
  }
179
210
 
180
- private async setupTestContract(deployer: AztecAddress): Promise<TestContract> {
181
- const deployOpts: DeployOptions = {
182
- from: deployer,
183
- contractAddressSalt: this.config.tokenSalt,
184
- universalDeploy: true,
185
- };
186
- const deploy = TestContract.deploy(this.wallet);
187
- const instance = await this.registerOrDeployContract('TestContract', deploy, deployOpts);
211
+ private async deployTestContract(deployer: AztecAddress, deploy: DeployMethod<TestContract>): Promise<TestContract> {
212
+ const instance = await this.registerOrDeployContract('TestContract', deploy, { from: deployer });
188
213
  return TestContract.at(instance.address, this.wallet);
189
214
  }
190
215
 
@@ -203,48 +228,16 @@ export class BotFactory {
203
228
  }
204
229
  }
205
230
 
206
- private async setupAccountWithPrivateKey(secret: Fr) {
207
- const salt = this.config.senderSalt ?? Fr.ONE;
208
- const signingKey = deriveSigningKey(secret);
209
- const accountManager = await this.wallet.createSchnorrAccount(secret, salt, signingKey);
210
- const metadata = await this.wallet.getContractMetadata(accountManager.address);
211
- if (metadata.initializationStatus === ContractInitializationStatus.INITIALIZED) {
212
- this.log.info(`Account at ${accountManager.address.toString()} already initialized`);
213
- const timer = new Timer();
214
- const address = accountManager.address;
215
- this.log.info(`Account at ${address} registered. duration=${timer.ms()}`);
216
- await this.store.deleteBridgeClaim(address);
217
- return address;
218
- } else {
219
- const address = accountManager.address;
220
- this.log.info(`Deploying account at ${address}`);
221
-
222
- const claim = await this.getOrCreateBridgeClaim(address);
223
-
224
- const paymentMethod = new FeeJuicePaymentMethodWithClaim(accountManager.address, claim);
225
- const deployMethod = await accountManager.getDeployMethod();
226
-
227
- await this.withNoMinTxsPerBlock(async () => {
228
- const { txHash } = await deployMethod.send({
229
- from: NO_FROM,
230
- fee: { paymentMethod },
231
- wait: NO_WAIT,
232
- });
233
- this.log.info(`Sent tx for account deployment with hash ${txHash.toString()}`);
234
- return waitForTx(this.aztecNode, txHash, { timeout: this.config.txMinedWaitSeconds });
235
- });
236
- this.log.info(`Account deployed at ${address}`);
237
-
238
- // Clean up the consumed bridge claim
239
- await this.store.deleteBridgeClaim(address);
240
-
241
- return accountManager.address;
242
- }
243
- }
244
-
231
+ /**
232
+ * Keyless fallback for tests and local dev: reuses the first genesis test account, whose address is
233
+ * pre-funded with fee juice via `initialFundedAccounts`. The test accounts are initializerless, so this
234
+ * must create an initializerless account for the address to match the funded one. Production bots set a
235
+ * sender private key and fund the resulting initializerless account from L1 instead; see
236
+ * setupAccountWithPrivateKey.
237
+ */
245
238
  private async setupTestAccount() {
246
239
  const [initialAccountData] = await getInitialTestAccountsData();
247
- const accountManager = await this.wallet.createSchnorrAccount(
240
+ const accountManager = await this.wallet.createSchnorrInitializerlessAccount(
248
241
  initialAccountData.secret,
249
242
  initialAccountData.salt,
250
243
  initialAccountData.signingKey,
@@ -252,35 +245,45 @@ export class BotFactory {
252
245
  return accountManager.address;
253
246
  }
254
247
 
248
+ private async setupAccountWithPrivateKey(privateKey: Fr) {
249
+ const salt = this.config.senderSalt ?? Fr.ONE;
250
+ const signingKey = GrumpkinScalar.fromBuffer(privateKey.toBuffer());
251
+ const secret = await deriveSecretKeyFromSigningKey(signingKey);
252
+ const accountManager = await this.wallet.createSchnorrInitializerlessAccount(secret, salt, signingKey);
253
+ return accountManager.address;
254
+ }
255
+
255
256
  /**
256
257
  * Checks if the token contract is deployed and deploys it if necessary.
257
- * @param wallet - Wallet to deploy the token contract from.
258
- * @returns The TokenContract instance.
258
+ * Uses a bridge claim for deploy when balance is below threshold to avoid failing before refuel.
259
+ * @param sender - Aztec address to deploy the token contract from.
260
+ * @param existingToken - Optional token instance when called from setupTokenWithOptionalEarlyRefuel.
261
+ * @returns The TokenContract or PrivateTokenContract instance.
259
262
  */
260
263
  private async setupToken(sender: AztecAddress): Promise<TokenContract | PrivateTokenContract> {
261
264
  let deploy: DeployMethod<TokenContract | PrivateTokenContract>;
262
- let tokenInstance: ContractInstanceWithAddress | undefined;
263
- const deployOpts: DeployOptions = {
264
- from: sender,
265
- contractAddressSalt: this.config.tokenSalt,
266
- universalDeploy: true,
267
- };
265
+ const salt = this.config.tokenSalt;
266
+ const deployOpts: DeployOptions = { from: sender };
268
267
  let token: TokenContract | PrivateTokenContract;
269
268
  if (this.config.contract === SupportedTokenContracts.TokenContract) {
270
- deploy = TokenContract.deploy(this.wallet, sender, 'BotToken', 'BOT', 18);
271
- tokenInstance = await deploy.getInstance(deployOpts);
272
- token = TokenContract.at(tokenInstance.address, this.wallet);
269
+ deploy = TokenContract.deploy(this.wallet, sender, 'BotToken', 'BOT', 18, { salt, universalDeploy: true });
270
+ const instance = await deploy.getInstance();
271
+ token = TokenContract.at(instance.address, this.wallet);
273
272
  } else if (this.config.contract === SupportedTokenContracts.PrivateTokenContract) {
274
273
  // Generate keys for the contract since PrivateToken uses SinglePrivateMutable which requires keys
275
274
  const tokenSecretKey = Fr.random();
276
275
  const tokenPublicKeys = (await deriveKeys(tokenSecretKey)).publicKeys;
277
- deploy = PrivateTokenContract.deployWithPublicKeys(tokenPublicKeys, this.wallet, MINT_BALANCE, sender);
276
+ deploy = PrivateTokenContract.deploy(this.wallet, MINT_BALANCE, sender, {
277
+ salt,
278
+ universalDeploy: true,
279
+ publicKeys: tokenPublicKeys,
280
+ });
278
281
  deployOpts.skipInstancePublication = true;
279
282
  deployOpts.skipClassPublication = true;
280
283
  deployOpts.skipInitialization = false;
281
284
 
282
285
  // Register the contract with the secret key before deployment
283
- tokenInstance = await deploy.getInstance(deployOpts);
286
+ const tokenInstance = await deploy.getInstance();
284
287
  token = PrivateTokenContract.at(tokenInstance.address, this.wallet);
285
288
  await this.wallet.registerContract(tokenInstance, PrivateTokenContract.artifact, tokenSecretKey);
286
289
  // The contract constructor initializes private storage vars that need the contract's own nullifier key.
@@ -289,20 +292,7 @@ export class BotFactory {
289
292
  throw new Error(`Unsupported token contract type: ${this.config.contract}`);
290
293
  }
291
294
 
292
- const address = tokenInstance?.address ?? (await deploy.getInstance(deployOpts)).address;
293
- const metadata = await this.wallet.getContractMetadata(address);
294
- if (metadata.isContractPublished) {
295
- this.log.info(`Token at ${address.toString()} already deployed`);
296
- await deploy.register();
297
- } else {
298
- this.log.info(`Deploying token contract at ${address.toString()}`);
299
- const { txHash } = await deploy.send({ ...deployOpts, wait: NO_WAIT });
300
- this.log.info(`Sent tx for token setup with hash ${txHash.toString()}`);
301
- await this.withNoMinTxsPerBlock(async () => {
302
- await waitForTx(this.aztecNode, txHash, { timeout: this.config.txMinedWaitSeconds });
303
- return token;
304
- });
305
- }
295
+ await this.registerOrDeployContract('token', deploy, deployOpts);
306
296
  return token;
307
297
  }
308
298
 
@@ -313,40 +303,48 @@ export class BotFactory {
313
303
  */
314
304
  private async setupTokenContract(
315
305
  deployer: AztecAddress,
316
- contractAddressSalt: Fr,
306
+ salt: Fr,
317
307
  name: string,
318
308
  ticker: string,
319
309
  decimals = 18,
320
310
  ): Promise<TokenContract> {
321
- const deployOpts: DeployOptions = { from: deployer, contractAddressSalt, universalDeploy: true };
322
- const deploy = TokenContract.deploy(this.wallet, deployer, name, ticker, decimals);
311
+ const deployOpts: DeployOptions = { from: deployer };
312
+ const deploy = TokenContract.deploy(this.wallet, deployer, name, ticker, decimals, { salt, universalDeploy: true });
323
313
  const instance = await this.registerOrDeployContract('Token - ' + name, deploy, deployOpts);
324
314
  return TokenContract.at(instance.address, this.wallet);
325
315
  }
326
316
 
327
- private async setupAmmContract(
328
- deployer: AztecAddress,
329
- contractAddressSalt: Fr,
330
- token0: TokenContract,
331
- token1: TokenContract,
332
- lpToken: TokenContract,
333
- ): Promise<AMMContract> {
334
- const deployOpts: DeployOptions = { from: deployer, contractAddressSalt, universalDeploy: true };
335
- const deploy = AMMContract.deploy(this.wallet, token0.address, token1.address, lpToken.address);
336
- const instance = await this.registerOrDeployContract('AMM', deploy, deployOpts);
317
+ private async deployAmmContract(deployer: AztecAddress, deploy: DeployMethod<AMMContract>): Promise<AMMContract> {
318
+ const instance = await this.registerOrDeployContract('AMM', deploy, { from: deployer });
337
319
  const amm = AMMContract.at(instance.address, this.wallet);
338
-
339
320
  this.log.info(`AMM deployed at ${amm.address}`);
340
- const { receipt: minterReceipt } = await lpToken.methods
341
- .set_minter(amm.address, true)
342
- .send({ from: deployer, wait: { timeout: this.config.txMinedWaitSeconds } });
343
- this.log.info(`Set LP token minter to AMM txHash=${minterReceipt.txHash.toString()}`);
344
- this.log.info(`Liquidity token initialized`);
345
-
346
321
  return amm;
347
322
  }
348
323
 
349
- private async fundAmm(
324
+ /** Grants the AMM minting rights over the LP token. set_minter only records the address, so it does not
325
+ * require the AMM contract to be deployed first. */
326
+ private async grantLpTokenMinter(deployer: AztecAddress, lpToken: TokenContract, amm: AztecAddress): Promise<void> {
327
+ const { receipt } = await lpToken.methods.set_minter(amm, true).send({
328
+ from: deployer,
329
+ wait: { timeout: this.config.txMinedWaitSeconds },
330
+ });
331
+ this.log.info(`Set LP token minter to AMM txHash=${receipt.txHash.toString()}`);
332
+ }
333
+
334
+ private async mintAmmLiquidity(minter: AztecAddress, token0: TokenContract, token1: TokenContract): Promise<void> {
335
+ this.log.info(`Minting ${MINT_BALANCE} tokens of each BotToken0 and BotToken1 for ${minter}`);
336
+ const mintBatch = new BatchCall(this.wallet, [
337
+ token0.methods.mint_to_private(minter, MINT_BALANCE),
338
+ token1.methods.mint_to_private(minter, MINT_BALANCE),
339
+ ]);
340
+ const { receipt } = await mintBatch.send({
341
+ from: minter,
342
+ wait: { timeout: this.config.txMinedWaitSeconds },
343
+ });
344
+ this.log.info(`Sent mint tx: ${receipt.txHash.toString()}`);
345
+ }
346
+
347
+ private async addAmmLiquidity(
350
348
  defaultAccountAddress: AztecAddress,
351
349
  liquidityProvider: AztecAddress,
352
350
  amm: AMMContract,
@@ -354,22 +352,6 @@ export class BotFactory {
354
352
  token1: TokenContract,
355
353
  lpToken: TokenContract,
356
354
  ): Promise<void> {
357
- const getPrivateBalances = () =>
358
- Promise.all([
359
- token0.methods
360
- .balance_of_private(liquidityProvider)
361
- .simulate({ from: liquidityProvider })
362
- .then(r => r.result),
363
- token1.methods
364
- .balance_of_private(liquidityProvider)
365
- .simulate({ from: liquidityProvider })
366
- .then(r => r.result),
367
- lpToken.methods
368
- .balance_of_private(liquidityProvider)
369
- .simulate({ from: liquidityProvider })
370
- .then(r => r.result),
371
- ]);
372
-
373
355
  const authwitNonce = Fr.random();
374
356
 
375
357
  // keep some tokens for swapping
@@ -378,12 +360,6 @@ export class BotFactory {
378
360
  const amount1Max = MINT_BALANCE / 2;
379
361
  const amount1Min = MINT_BALANCE / 4;
380
362
 
381
- const [t0Bal, t1Bal, lpBal] = await getPrivateBalances();
382
-
383
- this.log.info(
384
- `Minting ${MINT_BALANCE} tokens of each BotToken0 and BotToken1. Current private balances of ${liquidityProvider}: token0=${t0Bal}, token1=${t1Bal}, lp=${lpBal}`,
385
- );
386
-
387
363
  // Add authwitnesses for the transfers in AMM::add_liquidity function
388
364
  const token0Authwit = await this.wallet.createAuthWit(defaultAccountAddress, {
389
365
  caller: amm.address,
@@ -408,14 +384,7 @@ export class BotFactory {
408
384
  .getFunctionCall(),
409
385
  });
410
386
 
411
- const { receipt: mintReceipt } = await new BatchCall(this.wallet, [
412
- token0.methods.mint_to_private(liquidityProvider, MINT_BALANCE),
413
- token1.methods.mint_to_private(liquidityProvider, MINT_BALANCE),
414
- ]).send({ from: liquidityProvider, wait: { timeout: this.config.txMinedWaitSeconds } });
415
-
416
- this.log.info(`Sent mint tx: ${mintReceipt.txHash.toString()}`);
417
-
418
- const { receipt: addLiquidityReceipt } = await amm.methods
387
+ const { receipt } = await amm.methods
419
388
  .add_liquidity(amount0Max, amount1Max, amount0Min, amount1Min, authwitNonce)
420
389
  .send({
421
390
  from: liquidityProvider,
@@ -423,12 +392,25 @@ export class BotFactory {
423
392
  wait: { timeout: this.config.txMinedWaitSeconds },
424
393
  });
425
394
 
426
- this.log.info(`Sent tx to add liquidity to the AMM: ${addLiquidityReceipt.txHash.toString()}`);
395
+ this.log.info(`Sent tx to add liquidity to the AMM: ${receipt.txHash.toString()}`);
427
396
  this.log.info(`Liquidity added`);
428
397
 
429
- const [newT0Bal, newT1Bal, newLPBal] = await getPrivateBalances();
398
+ const [t0Bal, t1Bal, lpBal] = await Promise.all([
399
+ token0.methods
400
+ .balance_of_private(liquidityProvider)
401
+ .simulate({ from: liquidityProvider })
402
+ .then(r => r.result),
403
+ token1.methods
404
+ .balance_of_private(liquidityProvider)
405
+ .simulate({ from: liquidityProvider })
406
+ .then(r => r.result),
407
+ lpToken.methods
408
+ .balance_of_private(liquidityProvider)
409
+ .simulate({ from: liquidityProvider })
410
+ .then(r => r.result),
411
+ ]);
430
412
  this.log.info(
431
- `Updated private balances of ${defaultAccountAddress} after minting and funding AMM: token0=${newT0Bal}, token1=${newT1Bal}, lp=${newLPBal}`,
413
+ `Updated private balances of ${defaultAccountAddress} after minting and funding AMM: token0=${t0Bal}, token1=${t1Bal}, lp=${lpBal}`,
432
414
  );
433
415
  }
434
416
 
@@ -437,27 +419,75 @@ export class BotFactory {
437
419
  deploy: DeployMethod<T>,
438
420
  deployOpts: DeployOptions,
439
421
  ): Promise<ContractInstanceWithAddress> {
440
- const instance = await deploy.getInstance(deployOpts);
422
+ const instance = await deploy.getInstance();
441
423
  const address = instance.address;
442
424
  const metadata = await this.wallet.getContractMetadata(address);
443
425
  if (metadata.isContractPublished) {
444
426
  this.log.info(`Contract ${name} at ${address.toString()} already deployed`);
445
427
  await deploy.register();
446
- } else {
447
- this.log.info(`Deploying contract ${name} at ${address.toString()}`);
448
- await this.withNoMinTxsPerBlock(async () => {
449
- const { txHash } = await deploy.send({ ...deployOpts, wait: NO_WAIT });
450
- this.log.info(`Sent contract ${name} setup tx with hash ${txHash.toString()}`);
451
- return waitForTx(this.aztecNode, txHash, { timeout: this.config.txMinedWaitSeconds });
452
- });
428
+ return instance;
453
429
  }
430
+
431
+ // Setup always runs ensureFeeJuiceBalance before any deploy, so the account pays from its standing
432
+ // balance here. No manual gas estimation: the embedded wallet simulates before sending and derives
433
+ // the gas limits and padded maxFeesPerGas itself.
434
+ this.log.info(`Deploying contract ${name} at ${address.toString()}`);
435
+ await this.withNoMinTxsPerBlock(async () => {
436
+ const { txHash } = await deploy.send({ ...deployOpts, wait: NO_WAIT });
437
+ this.log.info(`Sent contract ${name} deploy tx ${txHash.toString()}`);
438
+ return waitForTx(this.aztecNode, txHash, { timeout: this.config.txMinedWaitSeconds });
439
+ });
440
+
454
441
  return instance;
455
442
  }
456
443
 
444
+ /** True when the config allows bridging fee juice from L1 (fee_juice mode, an L1 RPC, and an L1 key). */
445
+ private isL1BridgingConfigured(): boolean {
446
+ const mnemonicOrPrivateKey = this.config.l1PrivateKey?.getValue() ?? this.config.l1Mnemonic?.getValue();
447
+ return this.config.feePaymentMethod === 'fee_juice' && !!this.config.l1RpcUrls?.length && !!mnemonicOrPrivateKey;
448
+ }
449
+
457
450
  /**
458
- * Mints private and public tokens for the sender if their balance is below the minimum.
459
- * @param token - Token contract.
451
+ * Ensures the account holds enough fee juice before any other setup step. The account starts empty
452
+ * (initializerless accounts have no deployment tx) and the runtime loop pays fees from this balance and
453
+ * never refuels itself, so every flow funds the account up front. Bridges claims from L1 and consumes
454
+ * each with a claim-only tx until the balance clears the threshold, working from a zero (fresh run) or
455
+ * drained (restart) balance. Each bridge mints a fixed amount well above the threshold, so this is a
456
+ * single bridge in practice. No-op when L1 bridging is not configured or the balance is already above
457
+ * the threshold.
460
458
  */
459
+ private async ensureFeeJuiceBalance(account: AztecAddress): Promise<void> {
460
+ if (!this.isL1BridgingConfigured()) {
461
+ return;
462
+ }
463
+
464
+ let balance = await getFeeJuiceBalance(account, this.aztecNode);
465
+ if (balance >= FEE_JUICE_TOP_UP_THRESHOLD) {
466
+ this.log.info(`Fee juice balance ${balance} above threshold ${FEE_JUICE_TOP_UP_THRESHOLD}, skipping top-up`);
467
+ return;
468
+ }
469
+
470
+ this.log.info(`Fee juice balance ${balance} below threshold ${FEE_JUICE_TOP_UP_THRESHOLD}, bridging from L1`);
471
+
472
+ while (balance < FEE_JUICE_TOP_UP_THRESHOLD) {
473
+ // Persist the claim before consuming it: if the top-up tx fails or the bot crashes mid-loop, the
474
+ // next run reuses the pending claim instead of bridging again (and wasting the bridged funds).
475
+ const claim = await this.getOrCreateBridgeClaim(account);
476
+ const paymentMethod = new FeeJuicePaymentMethodWithClaim(account, claim);
477
+
478
+ await this.withNoMinTxsPerBlock(async () => {
479
+ const executionPayload = await paymentMethod.getExecutionPayload();
480
+ const { txHash } = await this.wallet.sendTx(executionPayload, { from: account, wait: NO_WAIT });
481
+ this.log.info(`Sent fee juice top-up tx ${txHash.toString()}`);
482
+ return waitForTx(this.aztecNode, txHash, { timeout: this.config.txMinedWaitSeconds });
483
+ });
484
+ await this.store.deleteBridgeClaim(account);
485
+ balance = await getFeeJuiceBalance(account, this.aztecNode);
486
+ this.log.info(`Fee juice balance after top-up: ${balance}`);
487
+ }
488
+ this.log.info(`Fee juice top-up complete for ${account.toString()}`);
489
+ }
490
+
461
491
  private async mintTokens(token: TokenContract | PrivateTokenContract, minter: AztecAddress) {
462
492
  const isStandardToken = isStandardTokenContract(token);
463
493
  let privateBalance = 0n;
@@ -490,8 +520,9 @@ export class BotFactory {
490
520
 
491
521
  // PrivateToken's mint accesses contract-level private storage vars (admin, total_supply).
492
522
  const additionalScopes = isStandardToken ? undefined : [token.address];
523
+ const mintBatch = new BatchCall(token.wallet, calls);
493
524
  await this.withNoMinTxsPerBlock(async () => {
494
- const { txHash } = await new BatchCall(token.wallet, calls).send({
525
+ const { txHash } = await mintBatch.send({
495
526
  from: minter,
496
527
  additionalScopes,
497
528
  wait: NO_WAIT,
@@ -502,22 +533,20 @@ export class BotFactory {
502
533
  }
503
534
 
504
535
  /**
505
- * Gets or creates a bridge claim for the recipient.
506
- * Checks if a claim already exists in the store and reuses it if valid.
507
- * Only creates a new bridge if fee juice balance is below threshold.
536
+ * Returns a usable bridge claim for the recipient, reusing a persisted one when its L1→L2 message is
537
+ * still available (resuming a top-up that failed or crashed before the claim was consumed) and bridging
538
+ * a fresh claim otherwise. The caller deletes the claim from the store once it has been consumed.
508
539
  */
509
540
  private async getOrCreateBridgeClaim(recipient: AztecAddress): Promise<L2AmountClaim> {
510
- // Check if we have an existing claim in the store
511
541
  const existingClaim = await this.store.getBridgeClaim(recipient);
512
542
  if (existingClaim) {
513
543
  this.log.info(`Found existing bridge claim for ${recipient.toString()}, checking validity...`);
514
-
515
- // Check if the message is ready on L2
516
544
  try {
517
545
  const messageHash = Fr.fromHexString(existingClaim.claim.messageHash);
518
546
  await this.withNoMinTxsPerBlock(() =>
519
547
  waitForL1ToL2MessageReady(this.aztecNode, messageHash, {
520
548
  timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
549
+ chainTip: this.syncChainTip,
521
550
  }),
522
551
  );
523
552
  return existingClaim.claim;
@@ -529,7 +558,6 @@ export class BotFactory {
529
558
 
530
559
  const claim = await this.bridgeL1FeeJuice(recipient);
531
560
  await this.store.saveBridgeClaim(recipient, claim);
532
-
533
561
  return claim;
534
562
  }
535
563
 
@@ -556,6 +584,7 @@ export class BotFactory {
556
584
  await this.withNoMinTxsPerBlock(() =>
557
585
  waitForL1ToL2MessageReady(this.aztecNode, Fr.fromHexString(claim.messageHash), {
558
586
  timeoutSeconds: this.config.l1ToL2MessageTimeoutSeconds,
587
+ chainTip: this.syncChainTip,
559
588
  }),
560
589
  );
561
590
 
@@ -564,19 +593,36 @@ export class BotFactory {
564
593
  return claim as L2AmountClaim;
565
594
  }
566
595
 
567
- private async withNoMinTxsPerBlock<T>(fn: () => Promise<T>): Promise<T> {
596
+ protected async withNoMinTxsPerBlock<T>(fn: () => Promise<T>): Promise<T> {
568
597
  if (!this.aztecNodeAdmin || !this.config.flushSetupTransactions) {
569
598
  this.log.verbose(`No node admin client or flushing not requested (not setting minTxsPerBlock to 0)`);
570
599
  return fn();
571
600
  }
572
- const { minTxsPerBlock } = await this.aztecNodeAdmin.getConfig();
573
- this.log.warn(`Setting sequencer minTxsPerBlock to 0 from ${minTxsPerBlock} to flush setup transactions`);
574
- await this.aztecNodeAdmin.setConfig({ minTxsPerBlock: 0 });
601
+ const aztecNodeAdmin = this.aztecNodeAdmin;
602
+ // Setup steps run concurrently, so this wrapper can be re-entered while another call is in flight.
603
+ // Reference-count the entrants: the first saves the current value and zeroes it, the last restores it.
604
+ // A naive save/zero/restore per call could interleave, with a late entrant reading the already-zeroed
605
+ // value and "restoring" 0 at the end.
606
+ if (this.noMinTxsPerBlockDepth++ === 0) {
607
+ this.savedMinTxsPerBlock = (async () => {
608
+ const { minTxsPerBlock } = await aztecNodeAdmin.getConfig();
609
+ this.log.warn(`Setting sequencer minTxsPerBlock to 0 from ${minTxsPerBlock} to flush setup transactions`);
610
+ await aztecNodeAdmin.setConfig({ minTxsPerBlock: 0 });
611
+ return { minTxsPerBlock };
612
+ })();
613
+ }
575
614
  try {
615
+ await this.savedMinTxsPerBlock;
576
616
  return await fn();
577
617
  } finally {
578
- this.log.warn(`Restoring sequencer minTxsPerBlock to ${minTxsPerBlock}`);
579
- await this.aztecNodeAdmin.setConfig({ minTxsPerBlock });
618
+ if (--this.noMinTxsPerBlockDepth === 0) {
619
+ // If saving/zeroing itself failed there is nothing to restore.
620
+ const saved = await this.savedMinTxsPerBlock!.catch(() => undefined);
621
+ if (saved) {
622
+ this.log.warn(`Restoring sequencer minTxsPerBlock to ${saved.minTxsPerBlock}`);
623
+ await aztecNodeAdmin.setConfig({ minTxsPerBlock: saved.minTxsPerBlock });
624
+ }
625
+ }
580
626
  }
581
627
  }
582
628
  }