@aztec/bot 0.47.1

package/README.md

@@ -0,0 +1,3 @@
+# Transactions Bot
+
+Simple bot that connects to a PXE to send txs on a recurring basis.

package/dest/bot.d.ts

@@ -0,0 +1,27 @@
+import { type AztecAddress, type Wallet } from '@aztec/aztec.js';
+import { type PXE } from '@aztec/circuit-types';
+import { type TokenContract } from '@aztec/noir-contracts.js';
+import { type BotConfig } from './config.js';
+export declare class Bot {
+    readonly wallet: Wallet;
+    readonly token: TokenContract;
+    readonly recipient: AztecAddress;
+    readonly config: BotConfig;
+    private log;
+    protected constructor(wallet: Wallet, token: TokenContract, recipient: AztecAddress, config: BotConfig);
+    static create(config: BotConfig, dependencies?: {
+        pxe?: PXE;
+    }): Promise<Bot>;
+    run(): Promise<void>;
+    getBalances(): Promise<{
+        sender: {
+            privateBalance: bigint;
+            publicBalance: bigint;
+        };
+        recipient: {
+            privateBalance: bigint;
+            publicBalance: bigint;
+        };
+    }>;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dest/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAKjB,KAAK,MAAM,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAqB,KAAK,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,qBAAa,GAAG;aAII,MAAM,EAAE,MAAM;aACd,KAAK,EAAE,aAAa;aACpB,SAAS,EAAE,YAAY;aACvB,MAAM,EAAE,SAAS;IANnC,OAAO,CAAC,GAAG,CAAkC;IAE7C,SAAS,aACS,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,SAAS;WAGtB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,GAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAKzE,GAAG;IA0BH,WAAW;;;;;;;;;;CAMzB"}

package/dest/bot.js

@@ -0,0 +1,43 @@
+import { BatchCall, NativeFeePaymentMethod, NoFeePaymentMethod, createDebugLogger, } from '@aztec/aztec.js';
+import { GasSettings } from '@aztec/circuits.js';
+import { times } from '@aztec/foundation/collection';
+import { BotFactory } from './factory.js';
+import { getBalances } from './utils.js';
+const TRANSFER_AMOUNT = 1;
+export class Bot {
+    constructor(wallet, token, recipient, config) {
+        this.wallet = wallet;
+        this.token = token;
+        this.recipient = recipient;
+        this.config = config;
+        this.log = createDebugLogger('aztec:bot');
+    }
+    static async create(config, dependencies = {}) {
+        const { wallet, token, recipient } = await new BotFactory(config, dependencies).setup();
+        return new Bot(wallet, token, recipient, config);
+    }
+    async run() {
+        const { privateTransfersPerTx, publicTransfersPerTx, feePaymentMethod } = this.config;
+        const { token, recipient, wallet } = this;
+        const sender = wallet.getAddress();
+        this.log.verbose(`Sending tx with ${feePaymentMethod} fee with ${privateTransfersPerTx} private and ${publicTransfersPerTx} public transfers`);
+        const calls = [
+            ...times(privateTransfersPerTx, () => token.methods.transfer(recipient, TRANSFER_AMOUNT).request()),
+            ...times(publicTransfersPerTx, () => token.methods.transfer_public(sender, recipient, TRANSFER_AMOUNT, 0).request()),
+        ];
+        const paymentMethod = feePaymentMethod === 'native' ? new NativeFeePaymentMethod(sender) : new NoFeePaymentMethod();
+        const gasSettings = GasSettings.default();
+        const opts = { estimateGas: true, fee: { paymentMethod, gasSettings } };
+        const tx = new BatchCall(wallet, calls).send(opts);
+        this.log.verbose(`Sent tx ${tx.getTxHash()}`);
+        const receipt = await tx.wait();
+        this.log.info(`Tx ${receipt.txHash} mined in block ${receipt.blockNumber}`);
+    }
+    async getBalances() {
+        return {
+            sender: await getBalances(this.token, this.wallet.getAddress()),
+            recipient: await getBalances(this.token, this.recipient),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm90LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2JvdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBRUwsU0FBUyxFQUNULHNCQUFzQixFQUN0QixrQkFBa0IsRUFHbEIsaUJBQWlCLEdBQ2xCLE1BQU0saUJBQWlCLENBQUM7QUFFekIsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ2pELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUlyRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQzFDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFekMsTUFBTSxlQUFlLEdBQUcsQ0FBQyxDQUFDO0FBRTFCLE1BQU0sT0FBTyxHQUFHO0lBR2QsWUFDa0IsTUFBYyxFQUNkLEtBQW9CLEVBQ3BCLFNBQXVCLEVBQ3ZCLE1BQWlCO1FBSGpCLFdBQU0sR0FBTixNQUFNLENBQVE7UUFDZCxVQUFLLEdBQUwsS0FBSyxDQUFlO1FBQ3BCLGNBQVMsR0FBVCxTQUFTLENBQWM7UUFDdkIsV0FBTSxHQUFOLE1BQU0sQ0FBVztRQU4zQixRQUFHLEdBQUcsaUJBQWlCLENBQUMsV0FBVyxDQUFDLENBQUM7SUFPMUMsQ0FBQztJQUVKLE1BQU0sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQWlCLEVBQUUsZUFBOEIsRUFBRTtRQUNyRSxNQUFNLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsR0FBRyxNQUFNLElBQUksVUFBVSxDQUFDLE1BQU0sRUFBRSxZQUFZLENBQUMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUN4RixPQUFPLElBQUksR0FBRyxDQUFDLE1BQU0sRUFBRSxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ25ELENBQUM7SUFFTSxLQUFLLENBQUMsR0FBRztRQUNkLE1BQU0sRUFBRSxxQkFBcUIsRUFBRSxvQkFBb0IsRUFBRSxnQkFBZ0IsRUFBRSxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUM7UUFDdEYsTUFBTSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDO1FBQzFDLE1BQU0sTUFBTSxHQUFHLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUVuQyxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FDZCxtQkFBbUIsZ0JBQWdCLGFBQWEscUJBQXFCLGdCQUFnQixvQkFBb0IsbUJBQW1CLENBQzdILENBQUM7UUFFRixNQUFNLEtBQUssR0FBbUI7WUFDNUIsR0FBRyxLQUFLLENBQUMscUJBQXFCLEVBQUUsR0FBRyxFQUFFLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsU0FBUyxFQUFFLGVBQWUsQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ25HLEdBQUcsS0FBSyxDQUFDLG9CQUFvQixFQUFFLEdBQUcsRUFBRSxDQUNsQyxLQUFLLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxNQUFNLEVBQUUsU0FBUyxFQUFFLGVBQWUsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FDL0U7U0FDRixDQUFDO1FBRUYsTUFBTSxhQUFhLEdBQUcsZ0JBQWdCLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxJQUFJLHNCQUFzQixDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLGtCQUFrQixFQUFFLENBQUM7UUFDcEgsTUFBTSxXQUFXLEdBQUcsV0FBVyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQzFDLE1BQU0sSUFBSSxHQUFzQixFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsR0FBRyxFQUFFLEVBQUUsYUFBYSxFQUFFLFdBQVcsRUFBRSxFQUFFLENBQUM7UUFDM0YsTUFBTSxFQUFFLEdBQUcsSUFBSSxTQUFTLENBQUMsTUFBTSxFQUFFLEtBQUssQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUNuRCxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxXQUFXLEVBQUUsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFFOUMsTUFBTSxPQUFPLEdBQUcsTUFBTSxFQUFFLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDaEMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsTUFBTSxPQUFPLENBQUMsTUFBTSxtQkFBbUIsT0FBTyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUM7SUFDOUUsQ0FBQztJQUVNLEtBQUssQ0FBQyxXQUFXO1FBQ3RCLE9BQU87WUFDTCxNQUFNLEVBQUUsTUFBTSxXQUFXLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxJQUFJLENBQUMsTUFBTSxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQy9ELFNBQVMsRUFBRSxNQUFNLFdBQVcsQ0FBQyxJQUFJLENBQUMsS0FBSyxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUM7U0FDekQsQ0FBQztJQUNKLENBQUM7Q0FDRiJ9

package/dest/config.d.ts

@@ -0,0 +1,24 @@
+import { Fr } from '@aztec/circuits.js';
+export type BotConfig = {
+    /** URL to the PXE for sending txs, or undefined if an in-proc PXE is used. */
+    pxeUrl: string | undefined;
+    /** Signing private key for the sender account. */
+    senderPrivateKey: Fr;
+    /** Encryption secret for a recipient account. */
+    recipientEncryptionSecret: Fr;
+    /** Salt for the token contract deployment. */
+    tokenSalt: Fr;
+    /** Every how many seconds should a new tx be sent. */
+    txIntervalSeconds: number;
+    /** How many private token transfers are executed per tx. */
+    privateTransfersPerTx: number;
+    /** How many public token transfers are executed per tx. */
+    publicTransfersPerTx: number;
+    /** How to handle fee payments. */
+    feePaymentMethod: 'native' | 'none';
+    /** True to not automatically setup or start the bot on initialization. */
+    noStart: boolean;
+};
+export declare function getBotConfigFromEnv(): BotConfig;
+export declare function getBotDefaultConfig(overrides?: Partial<BotConfig>): BotConfig;
+//# sourceMappingURL=config.d.ts.map

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAGxC,MAAM,MAAM,SAAS,GAAG;IACtB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,gBAAgB,EAAE,EAAE,CAAC;IACrB,iDAAiD;IACjD,yBAAyB,EAAE,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,SAAS,EAAE,EAAE,CAAC;IACd,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC;IACpC,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,SAAS,CA4B/C;AAED,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAajF"}

package/dest/config.js

@@ -0,0 +1,36 @@
+import { Fr } from '@aztec/circuits.js';
+import { compact } from '@aztec/foundation/collection';
+export function getBotConfigFromEnv() {
+    const { BOT_FEE_PAYMENT_METHOD, BOT_PRIVATE_KEY, BOT_TOKEN_SALT, BOT_RECIPIENT_ENCRYPTION_SECRET, BOT_TX_INTERVAL_SECONDS, BOT_PRIVATE_TRANSFERS_PER_TX, BOT_PUBLIC_TRANSFERS_PER_TX, BOT_NO_START, } = process.env;
+    if (BOT_FEE_PAYMENT_METHOD && !['native', 'none'].includes(BOT_FEE_PAYMENT_METHOD)) {
+        throw new Error(`Invalid bot fee payment method: ${BOT_FEE_PAYMENT_METHOD}`);
+    }
+    return getBotDefaultConfig({
+        pxeUrl: process.env.BOT_PXE_URL,
+        senderPrivateKey: BOT_PRIVATE_KEY ? Fr.fromString(BOT_PRIVATE_KEY) : undefined,
+        recipientEncryptionSecret: BOT_RECIPIENT_ENCRYPTION_SECRET
+            ? Fr.fromString(BOT_RECIPIENT_ENCRYPTION_SECRET)
+            : undefined,
+        tokenSalt: BOT_TOKEN_SALT ? Fr.fromString(BOT_TOKEN_SALT) : undefined,
+        txIntervalSeconds: BOT_TX_INTERVAL_SECONDS ? parseInt(BOT_TX_INTERVAL_SECONDS) : undefined,
+        privateTransfersPerTx: BOT_PRIVATE_TRANSFERS_PER_TX ? parseInt(BOT_PRIVATE_TRANSFERS_PER_TX) : undefined,
+        publicTransfersPerTx: BOT_PUBLIC_TRANSFERS_PER_TX ? parseInt(BOT_PUBLIC_TRANSFERS_PER_TX) : undefined,
+        feePaymentMethod: BOT_FEE_PAYMENT_METHOD ? BOT_FEE_PAYMENT_METHOD : undefined,
+        noStart: BOT_NO_START ? ['1', 'true'].includes(BOT_NO_START) : undefined,
+    });
+}
+export function getBotDefaultConfig(overrides = {}) {
+    return {
+        pxeUrl: undefined,
+        senderPrivateKey: Fr.random(),
+        recipientEncryptionSecret: Fr.fromString('0xcafecafe'),
+        tokenSalt: Fr.fromString('1'),
+        txIntervalSeconds: 60,
+        privateTransfersPerTx: 1,
+        publicTransfersPerTx: 1,
+        feePaymentMethod: 'none',
+        noStart: false,
+        ...compact(overrides),
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDeEMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBdUJ2RCxNQUFNLFVBQVUsbUJBQW1CO0lBQ2pDLE1BQU0sRUFDSixzQkFBc0IsRUFDdEIsZUFBZSxFQUNmLGNBQWMsRUFDZCwrQkFBK0IsRUFDL0IsdUJBQXVCLEVBQ3ZCLDRCQUE0QixFQUM1QiwyQkFBMkIsRUFDM0IsWUFBWSxHQUNiLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQztJQUNoQixJQUFJLHNCQUFzQixJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsTUFBTSxDQUFDLENBQUMsUUFBUSxDQUFDLHNCQUFzQixDQUFDLEVBQUUsQ0FBQztRQUNuRixNQUFNLElBQUksS0FBSyxDQUFDLG1DQUFtQyxzQkFBc0IsRUFBRSxDQUFDLENBQUM7SUFDL0UsQ0FBQztJQUVELE9BQU8sbUJBQW1CLENBQUM7UUFDekIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsV0FBVztRQUMvQixnQkFBZ0IsRUFBRSxlQUFlLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsZUFBZSxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVM7UUFDOUUseUJBQXlCLEVBQUUsK0JBQStCO1lBQ3hELENBQUMsQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLCtCQUErQixDQUFDO1lBQ2hELENBQUMsQ0FBQyxTQUFTO1FBQ2IsU0FBUyxFQUFFLGNBQWMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLFVBQVUsQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUztRQUNyRSxpQkFBaUIsRUFBRSx1QkFBdUIsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLHVCQUF1QixDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVM7UUFDMUYscUJBQXFCLEVBQUUsNEJBQTRCLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyw0QkFBNEIsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTO1FBQ3hHLG9CQUFvQixFQUFFLDJCQUEyQixDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsMkJBQTJCLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUztRQUNyRyxnQkFBZ0IsRUFBRSxzQkFBc0IsQ0FBQyxDQUFDLENBQUUsc0JBQTRDLENBQUMsQ0FBQyxDQUFDLFNBQVM7UUFDcEcsT0FBTyxFQUFFLFlBQVksQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTO0tBQ3pFLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRCxNQUFNLFVBQVUsbUJBQW1CLENBQUMsWUFBZ0MsRUFBRTtJQUNwRSxPQUFPO1FBQ0wsTUFBTSxFQUFFLFNBQVM7UUFDakIsZ0JBQWdCLEVBQUUsRUFBRSxDQUFDLE1BQU0sRUFBRTtRQUM3Qix5QkFBeUIsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLFlBQVksQ0FBQztRQUN0RCxTQUFTLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUM7UUFDN0IsaUJBQWlCLEVBQUUsRUFBRTtRQUNyQixxQkFBcUIsRUFBRSxDQUFDO1FBQ3hCLG9CQUFvQixFQUFFLENBQUM7UUFDdkIsZ0JBQWdCLEVBQUUsTUFBTTtRQUN4QixPQUFPLEVBQUUsS0FBSztRQUNkLEdBQUcsT0FBTyxDQUFDLFNBQVMsQ0FBQztLQUN0QixDQUFDO0FBQ0osQ0FBQyJ9

package/dest/factory.d.ts

@@ -0,0 +1,42 @@
+import { type PXE } from '@aztec/circuit-types';
+import { TokenContract } from '@aztec/noir-contracts.js/Token';
+import { type BotConfig } from './config.js';
+export declare class BotFactory {
+    private readonly config;
+    private pxe;
+    private log;
+    constructor(config: BotConfig, dependencies?: {
+        pxe?: PXE;
+    });
+    /**
+     * Initializes a new bot by setting up the sender account, registering the recipient,
+     * deploying the token contract, and minting tokens if necessary.
+     */
+    setup(): Promise<{
+        wallet: import("@aztec/aztec.js").AccountWalletWithSecretKey;
+        token: TokenContract;
+        pxe: PXE;
+        recipient: import("@aztec/aztec.js").AztecAddress;
+    }>;
+    /**
+     * Checks if the sender account contract is initialized, and initializes it if necessary.
+     * @returns The sender wallet.
+     */
+    private setupAccount;
+    /**
+     * Registers the recipient for txs in the pxe.
+     */
+    private registerRecipient;
+    /**
+     * 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.
+     */
+    private setupToken;
+    /**
+     * Mints private and public tokens for the sender if their balance is below the minimum.
+     * @param token - Token contract.
+     */
+    private mintTokens;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dest/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,GAAG,CAAkC;gBAEhB,MAAM,EAAE,SAAS,EAAE,YAAY,GAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAO;IAQhF;;;OAGG;IACU,KAAK;;;;;;IAQlB;;;OAGG;YACW,YAAY;IAc1B;;OAEG;YACW,iBAAiB;IAK/B;;;;OAIG;YACW,UAAU;IAaxB;;;OAGG;YACW,UAAU;CAkBzB"}

package/dest/factory.js

@@ -0,0 +1,94 @@
+import { getSchnorrAccount } from '@aztec/accounts/schnorr';
+import { BatchCall, createDebugLogger, createPXEClient } from '@aztec/aztec.js';
+import { Fr, deriveSigningKey } from '@aztec/circuits.js';
+import { TokenContract } from '@aztec/noir-contracts.js/Token';
+import { getBalances } from './utils.js';
+const MINT_BALANCE = 1e12;
+const MIN_BALANCE = 1e3;
+export class BotFactory {
+    constructor(config, dependencies = {}) {
+        this.config = config;
+        this.log = createDebugLogger('aztec:bot');
+        if (!dependencies.pxe && !config.pxeUrl) {
+            throw new Error(`Either a PXE client or a PXE URL must be provided`);
+        }
+        this.pxe = dependencies.pxe ?? createPXEClient(config.pxeUrl);
+    }
+    /**
+     * 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);
+        return { wallet, token, pxe: this.pxe, recipient };
+    }
+    /**
+     * Checks if the sender account contract is initialized, and initializes it if necessary.
+     * @returns The sender wallet.
+     */
+    async setupAccount() {
+        const salt = Fr.ONE;
+        const signingKey = deriveSigningKey(this.config.senderPrivateKey);
+        const account = getSchnorrAccount(this.pxe, this.config.senderPrivateKey, signingKey, salt);
+        const isInit = await this.pxe.isContractInitialized(account.getAddress());
+        if (isInit) {
+            this.log.info(`Account at ${account.getAddress().toString()} already initialized`);
+            return account.register();
+        }
+        else {
+            this.log.info(`Initializing account at ${account.getAddress().toString()}`);
+            return account.waitSetup();
+        }
+    }
+    /**
+     * Registers the recipient for txs in the pxe.
+     */
+    async registerRecipient() {
+        const recipient = await this.pxe.registerAccount(this.config.recipientEncryptionSecret, Fr.ONE);
+        return recipient.address;
+    }
+    /**
+     * 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) {
+        const deploy = TokenContract.deploy(wallet, wallet.getAddress(), 'BotToken', 'BOT', 18);
+        const deployOpts = { contractAddressSalt: this.config.tokenSalt, universalDeploy: true };
+        const address = deploy.getInstance(deployOpts).address;
+        if (await this.pxe.isContractPubliclyDeployed(address)) {
+            this.log.info(`Token at ${address.toString()} already deployed`);
+            return deploy.register();
+        }
+        else {
+            this.log.info(`Deploying token contract at ${address.toString()}`);
+            return deploy.send(deployOpts).deployed();
+        }
+    }
+    /**
+     * 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();
+        const { privateBalance, publicBalance } = await getBalances(token, sender);
+        const calls = [];
+        if (privateBalance < MIN_BALANCE) {
+            this.log.info(`Minting private tokens for ${sender.toString()}`);
+            calls.push(token.methods.privately_mint_private_note(MINT_BALANCE).request());
+        }
+        if (publicBalance < MIN_BALANCE) {
+            this.log.info(`Minting public tokens for ${sender.toString()}`);
+            calls.push(token.methods.mint_public(sender, MINT_BALANCE).request());
+        }
+        if (calls.length === 0) {
+            this.log.info(`Skipping minting as ${sender.toString()} has enough tokens`);
+            return;
+        }
+        await new BatchCall(token.wallet, calls).send().wait();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzVELE9BQU8sRUFBc0IsU0FBUyxFQUFFLGlCQUFpQixFQUFFLGVBQWUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRXBHLE9BQU8sRUFBRSxFQUFFLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUMxRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFHL0QsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV6QyxNQUFNLFlBQVksR0FBRyxJQUFJLENBQUM7QUFDMUIsTUFBTSxXQUFXLEdBQUcsR0FBRyxDQUFDO0FBRXhCLE1BQU0sT0FBTyxVQUFVO0lBSXJCLFlBQTZCLE1BQWlCLEVBQUUsZUFBOEIsRUFBRTtRQUFuRCxXQUFNLEdBQU4sTUFBTSxDQUFXO1FBRnRDLFFBQUcsR0FBRyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUczQyxJQUFJLENBQUMsWUFBWSxDQUFDLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUN4QyxNQUFNLElBQUksS0FBSyxDQUFDLG1EQUFtRCxDQUFDLENBQUM7UUFDdkUsQ0FBQztRQUVELElBQUksQ0FBQyxHQUFHLEdBQUcsWUFBWSxDQUFDLEdBQUcsSUFBSSxlQUFlLENBQUMsTUFBTSxDQUFDLE1BQU8sQ0FBQyxDQUFDO0lBQ2pFLENBQUM7SUFFRDs7O09BR0c7SUFDSSxLQUFLLENBQUMsS0FBSztRQUNoQixNQUFNLFNBQVMsR0FBRyxNQUFNLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO1FBQ2pELE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQ3pDLE1BQU0sS0FB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

package/dest/index.d.ts

@@ -0,0 +1,5 @@
+export { Bot } from './bot.js';
+export { BotRunner } from './runner.js';
+export { BotConfig, getBotConfigFromEnv, getBotDefaultConfig } from './config.js';
+export { createBotRunnerRpcServer } from './rpc.js';
+//# sourceMappingURL=index.d.ts.map

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,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}

package/dest/index.js

@@ -0,0 +1,5 @@
+export { Bot } from './bot.js';
+export { BotRunner } from './runner.js';
+export { getBotConfigFromEnv, getBotDefaultConfig } from './config.js';
+export { createBotRunnerRpcServer } from './rpc.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUMvQixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ3hDLE9BQU8sRUFBYSxtQkFBbUIsRUFBRSxtQkFBbUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNsRixPQUFPLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxVQUFVLENBQUMifQ==

package/dest/rpc.d.ts

@@ -0,0 +1,9 @@
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+import { type BotRunner } from './runner.js';
+/**
+ * Wraps a bot runner with a JSON RPC HTTP server.
+ * @param botRunner - The BotRunner.
+ * @returns An JSON-RPC HTTP server
+ */
+export declare function createBotRunnerRpcServer(botRunner: BotRunner): JsonRpcServer;
+//# sourceMappingURL=rpc.d.ts.map

package/dest/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,iBAE5D"}

package/dest/rpc.js

@@ -0,0 +1,14 @@
+import { TxHash } from '@aztec/circuit-types';
+import { AztecAddress } from '@aztec/foundation/aztec-address';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Fr } from '@aztec/foundation/fields';
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+/**
+ * Wraps a bot runner with a JSON RPC HTTP server.
+ * @param botRunner - The BotRunner.
+ * @returns An JSON-RPC HTTP server
+ */
+export function createBotRunnerRpcServer(botRunner) {
+    return new JsonRpcServer(botRunner, { AztecAddress, EthAddress, Fr, TxHash }, {}, []);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnBjLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3JwYy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDOUMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQy9ELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUMzRCxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBSWxFOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsd0JBQXdCLENBQUMsU0FBb0I7SUFDM0QsT0FBTyxJQUFJLGFBQWEsQ0FBQyxTQUFTLEVBQUUsRUFBRSxZQUFZLEVBQUUsVUFBVSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxDQUFDLENBQUM7QUFDeEYsQ0FBQyJ9

package/dest/runner.d.ts

@@ -0,0 +1,40 @@
+import { type PXE } from '@aztec/aztec.js';
+import { type BotConfig } from './config.js';
+export declare class BotRunner {
+    #private;
+    private config;
+    private log;
+    private interval?;
+    private bot?;
+    private pxe?;
+    private running;
+    constructor(config: BotConfig, dependencies?: {
+        pxe?: PXE;
+    });
+    /** Initializes the bot if needed. Blocks until the bot setup is finished. */
+    setup(): Promise<void>;
+    /**
+     * Initializes the bot if needed and starts sending txs at regular intervals.
+     * Blocks until the bot setup is finished.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops sending txs. Returns once all ongoing txs are finished.
+     */
+    stop(): Promise<void>;
+    /** Returns whether the bot is running. */
+    isRunning(): boolean;
+    /**
+     * Updates the bot config and recreates the bot. Will stop and restart the bot automatically if it was
+     * running when this method was called. Blocks until the new bot is set up.
+     */
+    update(config: BotConfig): Promise<void>;
+    /**
+     * Triggers a single iteration of the bot. Requires the bot to be initialized.
+     * Blocks until the run is finished.
+     */
+    run(): Promise<void>;
+    /** Returns the current configuration for the bot. */
+    getConfig(): BotConfig;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dest/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAqB,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,SAAS;;IAOD,OAAO,CAAC,MAAM;IANjC,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,GAAG,CAAC,CAAe;IAC3B,OAAO,CAAC,GAAG,CAAC,CAAM;IAClB,OAAO,CAAC,OAAO,CAAiC;gBAErB,MAAM,EAAE,SAAS,EAAE,YAAY,GAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAO;IAI9E,6EAA6E;IAChE,KAAK;IAQlB;;;OAGG;IACU,KAAK;IAQlB;;OAEG;IACU,IAAI;IAajB,0CAA0C;IACnC,SAAS;IAIhB;;;OAGG;IACU,MAAM,CAAC,MAAM,EAAE,SAAS;IAcrC;;;OAGG;IACU,GAAG;IAYhB,qDAAqD;IAC9C,SAAS;CAQjB"}

package/dest/runner.js

@@ -0,0 +1,92 @@
+var _BotRunner_instances, _BotRunner_createBot;
+import { __classPrivateFieldGet } from "tslib";
+import { createDebugLogger } from '@aztec/aztec.js';
+import { Bot } from './bot.js';
+export class BotRunner {
+    constructor(config, dependencies = {}) {
+        _BotRunner_instances.add(this);
+        this.config = config;
+        this.log = createDebugLogger('aztec:bot');
+        this.running = new Set();
+        this.pxe = dependencies.pxe;
+    }
+    /** Initializes the bot if needed. Blocks until the bot setup is finished. */
+    async setup() {
+        if (!this.bot) {
+            this.log.verbose(`Setting up bot`);
+            await __classPrivateFieldGet(this, _BotRunner_instances, "m", _BotRunner_createBot).call(this);
+            this.log.info(`Bot set up completed`);
+        }
+    }
+    /**
+     * Initializes the bot if needed and starts sending txs at regular intervals.
+     * Blocks until the bot setup is finished.
+     */
+    async start() {
+        await this.setup();
+        if (!this.interval) {
+            this.log.info(`Starting bot with interval of ${this.config.txIntervalSeconds}s`);
+            this.interval = setInterval(() => this.run(), this.config.txIntervalSeconds * 1000);
+        }
+    }
+    /**
+     * Stops sending txs. Returns once all ongoing txs are finished.
+     */
+    async stop() {
+        if (this.interval) {
+            this.log.verbose(`Stopping bot`);
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+        if (this.running.size > 0) {
+            this.log.verbose(`Waiting for ${this.running.size} running txs to finish`);
+            await Promise.all(this.running);
+        }
+        this.log.info(`Stopped bot`);
+    }
+    /** Returns whether the bot is running. */
+    isRunning() {
+        return !!this.interval;
+    }
+    /**
+     * Updates the bot config and recreates the bot. Will stop and restart the bot automatically if it was
+     * running when this method was called. Blocks until the new bot is set up.
+     */
+    async update(config) {
+        this.log.verbose(`Updating bot config`);
+        const wasRunning = this.isRunning();
+        if (wasRunning) {
+            await this.stop();
+        }
+        this.config = { ...this.config, ...config };
+        await __classPrivateFieldGet(this, _BotRunner_instances, "m", _BotRunner_createBot).call(this);
+        this.log.info(`Bot config updated`);
+        if (wasRunning) {
+            await this.start();
+        }
+    }
+    /**
+     * Triggers a single iteration of the bot. Requires the bot to be initialized.
+     * Blocks until the run is finished.
+     */
+    async run() {
+        if (!this.bot) {
+            throw new Error(`Bot is not initialized`);
+        }
+        this.log.verbose(`Manually triggered bot run`);
+        const bot = await this.bot;
+        const promise = bot.run();
+        this.running.add(promise);
+        await promise;
+        this.running.delete(promise);
+    }
+    /** Returns the current configuration for the bot. */
+    getConfig() {
+        return this.config;
+    }
+}
+_BotRunner_instances = new WeakSet(), _BotRunner_createBot = async function _BotRunner_createBot() {
+    this.bot = Bot.create(this.config, { pxe: this.pxe });
+    await this.bot;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVubmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3J1bm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLE9BQU8sRUFBWSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRTlELE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFHL0IsTUFBTSxPQUFPLFNBQVM7SUFPcEIsWUFBMkIsTUFBaUIsRUFBRSxlQUE4QixFQUFFOztRQUFuRCxXQUFNLEdBQU4sTUFBTSxDQUFXO1FBTnBDLFFBQUcsR0FBRyxpQkFBaUIsQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUlyQyxZQUFPLEdBQXVCLElBQUksR0FBRyxFQUFFLENBQUM7UUFHOUMsSUFBSSxDQUFDLEdBQUcsR0FBRyxZQUFZLENBQUMsR0FBRyxDQUFDO0lBQzlCLENBQUM7SUFFRCw2RUFBNkU7SUFDdEUsS0FBSyxDQUFDLEtBQUs7UUFDaEIsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztZQUNkLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7WUFDbkMsTUFBTSx1QkFBQSxJQUFJLGtEQUFXLE1BQWYsSUFBSSxDQUFhLENBQUM7WUFDeEIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsc0JBQXNCLENBQUMsQ0FBQztRQUN4QyxDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7T0FHRztJQUNJLEtBQUssQ0FBQyxLQUFLO1FBQ2hCLE1BQU0sSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ25CLElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDbkIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsaUNBQWlDLElBQUksQ0FBQyxNQUFNLENBQUMsaUJBQWlCLEdBQUcsQ0FBQyxDQUFDO1lBQ2pGLElBQUksQ0FBQyxRQUFRLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRSxDQUFD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

package/dest/utils.d.ts

@@ -0,0 +1,13 @@
+import { type AztecAddress } from '@aztec/circuits.js';
+import { type TokenContract } from '@aztec/noir-contracts.js/Token';
+/**
+ * Gets the private and public balance of the given token for the given address.
+ * @param token - Token contract.
+ * @param who - Address to get the balance for.
+ * @returns - Private and public token balances as bigints.
+ */
+export declare function getBalances(token: TokenContract, who: AztecAddress): Promise<{
+    privateBalance: bigint;
+    publicBalance: bigint;
+}>;
+//# sourceMappingURL=utils.d.ts.map

package/dest/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5D"}

package/dest/utils.js

@@ -0,0 +1,12 @@
+/**
+ * Gets the private and public balance of the given token for the given address.
+ * @param token - Token contract.
+ * @param who - Address to get the balance for.
+ * @returns - Private and public token balances as bigints.
+ */
+export async function getBalances(token, who) {
+    const privateBalance = await token.methods.balance_of_private(who).simulate();
+    const publicBalance = await token.methods.balance_of_public(who).simulate();
+    return { privateBalance, publicBalance };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0E7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FDL0IsS0FBb0IsRUFDcEIsR0FBaUI7SUFFakIsTUFBTSxjQUFjLEdBQUcsTUFBTSxLQUFLLENBQUMsT0FBTyxDQUFDLGtCQUFrQixDQUFDLEdBQUcsQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDO0lBQzlFLE1BQU0sYUFBYSxHQUFHLE1BQU0sS0FBSyxDQUFDLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsQ0FBQyxRQUFRLEVBQUUsQ0FBQztJQUM1RSxPQUFPLEVBQUUsY0FBYyxFQUFFLGFBQWEsRUFBRSxDQUFDO0FBQzNDLENBQUMifQ==

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@aztec/bot",
+  "version": "0.47.1",
+  "type": "module",
+  "exports": {
+    ".": "./dest/index.js"
+  },
+  "inherits": [
+    "../package.common.json"
+  ],
+  "scripts": {
+    "build": "yarn clean && tsc -b",
+    "build:dev": "tsc -b --watch",
+    "clean": "rm -rf ./dest .tsbuildinfo",
+    "formatting": "run -T prettier --check ./src && run -T eslint ./src",
+    "formatting:fix": "run -T eslint --fix ./src && run -T prettier -w ./src",
+    "bb": "node --no-warnings ./dest/bb/index.js",
+    "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests"
+  },
+  "jest": {
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.[cm]?js$": "$1"
+    },
+    "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
+    "rootDir": "./src",
+    "transform": {
+      "^.+\\.tsx?$": [
+        "@swc/jest",
+        {
+          "jsc": {
+            "parser": {
+              "syntax": "typescript",
+              "decorators": true
+            }
+          }
+        }
+      ]
+    },
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "reporters": [
+      [
+        "default",
+        {
+          "summaryThreshold": 9999
+        }
+      ]
+    ]
+  },
+  "dependencies": {
+    "@aztec/accounts": "0.47.1",
+    "@aztec/aztec.js": "0.47.1",
+    "@aztec/circuit-types": "0.47.1",
+    "@aztec/circuits.js": "0.47.1",
+    "@aztec/entrypoints": "0.47.1",
+    "@aztec/foundation": "0.47.1",
+    "@aztec/noir-contracts.js": "0.47.1",
+    "@aztec/protocol-contracts": "0.47.1",
+    "@aztec/types": "0.47.1",
+    "source-map-support": "^0.5.21",
+    "tslib": "^2.4.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.5.0",
+    "@types/jest": "^29.5.0",
+    "@types/memdown": "^3.0.0",
+    "@types/node": "^18.7.23",
+    "@types/source-map-support": "^0.5.10",
+    "jest": "^29.5.0",
+    "jest-mock-extended": "^3.0.3",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.4"
+  },
+  "files": [
+    "dest",
+    "src",
+    "!*.test.*"
+  ],
+  "types": "./dest/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/bot.ts

@@ -0,0 +1,68 @@
+import {
+  type AztecAddress,
+  BatchCall,
+  NativeFeePaymentMethod,
+  NoFeePaymentMethod,
+  type SendMethodOptions,
+  type Wallet,
+  createDebugLogger,
+} from '@aztec/aztec.js';
+import { type FunctionCall, type PXE } from '@aztec/circuit-types';
+import { GasSettings } from '@aztec/circuits.js';
+import { times } from '@aztec/foundation/collection';
+import { type TokenContract } from '@aztec/noir-contracts.js';
+
+import { type BotConfig } from './config.js';
+import { BotFactory } from './factory.js';
+import { getBalances } from './utils.js';
+
+const TRANSFER_AMOUNT = 1;
+
+export class Bot {
+  private log = createDebugLogger('aztec:bot');
+
+  protected constructor(
+    public readonly wallet: Wallet,
+    public readonly token: TokenContract,
+    public readonly recipient: AztecAddress,
+    public readonly config: BotConfig,
+  ) {}
+
+  static async create(config: BotConfig, dependencies: { pxe?: PXE } = {}): Promise<Bot> {
+    const { wallet, token, recipient } = await new BotFactory(config, dependencies).setup();
+    return new Bot(wallet, token, recipient, config);
+  }
+
+  public async run() {
+    const { privateTransfersPerTx, publicTransfersPerTx, feePaymentMethod } = this.config;
+    const { token, recipient, wallet } = this;
+    const sender = wallet.getAddress();
+
+    this.log.verbose(
+      `Sending tx with ${feePaymentMethod} fee with ${privateTransfersPerTx} private and ${publicTransfersPerTx} public transfers`,
+    );
+
+    const calls: FunctionCall[] = [
+      ...times(privateTransfersPerTx, () => token.methods.transfer(recipient, TRANSFER_AMOUNT).request()),
+      ...times(publicTransfersPerTx, () =>
+        token.methods.transfer_public(sender, recipient, TRANSFER_AMOUNT, 0).request(),
+      ),
+    ];
+
+    const paymentMethod = feePaymentMethod === 'native' ? new NativeFeePaymentMethod(sender) : new NoFeePaymentMethod();
+    const gasSettings = GasSettings.default();
+    const opts: SendMethodOptions = { estimateGas: true, fee: { paymentMethod, gasSettings } };
+    const tx = new BatchCall(wallet, calls).send(opts);
+    this.log.verbose(`Sent tx ${tx.getTxHash()}`);
+
+    const receipt = await tx.wait();
+    this.log.info(`Tx ${receipt.txHash} mined in block ${receipt.blockNumber}`);
+  }
+
+  public async getBalances() {
+    return {
+      sender: await getBalances(this.token, this.wallet.getAddress()),
+      recipient: await getBalances(this.token, this.recipient),
+    };
+  }
+}

package/src/config.ts

@@ -0,0 +1,68 @@
+import { Fr } from '@aztec/circuits.js';
+import { compact } from '@aztec/foundation/collection';
+
+export type BotConfig = {
+  /** URL to the PXE for sending txs, or undefined if an in-proc PXE is used. */
+  pxeUrl: string | undefined;
+  /** Signing private key for the sender account. */
+  senderPrivateKey: Fr;
+  /** Encryption secret for a recipient account. */
+  recipientEncryptionSecret: Fr;
+  /** Salt for the token contract deployment. */
+  tokenSalt: Fr;
+  /** Every how many seconds should a new tx be sent. */
+  txIntervalSeconds: number;
+  /** How many private token transfers are executed per tx. */
+  privateTransfersPerTx: number;
+  /** How many public token transfers are executed per tx. */
+  publicTransfersPerTx: number;
+  /** How to handle fee payments. */
+  feePaymentMethod: 'native' | 'none';
+  /** True to not automatically setup or start the bot on initialization. */
+  noStart: boolean;
+};
+
+export function getBotConfigFromEnv(): BotConfig {
+  const {
+    BOT_FEE_PAYMENT_METHOD,
+    BOT_PRIVATE_KEY,
+    BOT_TOKEN_SALT,
+    BOT_RECIPIENT_ENCRYPTION_SECRET,
+    BOT_TX_INTERVAL_SECONDS,
+    BOT_PRIVATE_TRANSFERS_PER_TX,
+    BOT_PUBLIC_TRANSFERS_PER_TX,
+    BOT_NO_START,
+  } = process.env;
+  if (BOT_FEE_PAYMENT_METHOD && !['native', 'none'].includes(BOT_FEE_PAYMENT_METHOD)) {
+    throw new Error(`Invalid bot fee payment method: ${BOT_FEE_PAYMENT_METHOD}`);
+  }
+
+  return getBotDefaultConfig({
+    pxeUrl: process.env.BOT_PXE_URL,
+    senderPrivateKey: BOT_PRIVATE_KEY ? Fr.fromString(BOT_PRIVATE_KEY) : undefined,
+    recipientEncryptionSecret: BOT_RECIPIENT_ENCRYPTION_SECRET
+      ? Fr.fromString(BOT_RECIPIENT_ENCRYPTION_SECRET)
+      : undefined,
+    tokenSalt: BOT_TOKEN_SALT ? Fr.fromString(BOT_TOKEN_SALT) : undefined,
+    txIntervalSeconds: BOT_TX_INTERVAL_SECONDS ? parseInt(BOT_TX_INTERVAL_SECONDS) : undefined,
+    privateTransfersPerTx: BOT_PRIVATE_TRANSFERS_PER_TX ? parseInt(BOT_PRIVATE_TRANSFERS_PER_TX) : undefined,
+    publicTransfersPerTx: BOT_PUBLIC_TRANSFERS_PER_TX ? parseInt(BOT_PUBLIC_TRANSFERS_PER_TX) : undefined,
+    feePaymentMethod: BOT_FEE_PAYMENT_METHOD ? (BOT_FEE_PAYMENT_METHOD as 'native' | 'none') : undefined,
+    noStart: BOT_NO_START ? ['1', 'true'].includes(BOT_NO_START) : undefined,
+  });
+}
+
+export function getBotDefaultConfig(overrides: Partial<BotConfig> = {}): BotConfig {
+  return {
+    pxeUrl: undefined,
+    senderPrivateKey: Fr.random(),
+    recipientEncryptionSecret: Fr.fromString('0xcafecafe'),
+    tokenSalt: Fr.fromString('1'),
+    txIntervalSeconds: 60,
+    privateTransfersPerTx: 1,
+    publicTransfersPerTx: 1,
+    feePaymentMethod: 'none',
+    noStart: false,
+    ...compact(overrides),
+  };
+}

package/src/factory.ts

@@ -0,0 +1,103 @@
+import { getSchnorrAccount } from '@aztec/accounts/schnorr';
+import { type AccountWallet, BatchCall, createDebugLogger, createPXEClient } from '@aztec/aztec.js';
+import { type FunctionCall, type PXE } from '@aztec/circuit-types';
+import { Fr, deriveSigningKey } from '@aztec/circuits.js';
+import { TokenContract } from '@aztec/noir-contracts.js/Token';
+
+import { type BotConfig } from './config.js';
+import { getBalances } from './utils.js';
+
+const MINT_BALANCE = 1e12;
+const MIN_BALANCE = 1e3;
+
+export class BotFactory {
+  private pxe: PXE;
+  private log = createDebugLogger('aztec:bot');
+
+  constructor(private readonly config: BotConfig, dependencies: { pxe?: PXE } = {}) {
+    if (!dependencies.pxe && !config.pxeUrl) {
+      throw new Error(`Either a PXE client or a PXE URL must be provided`);
+    }
+
+    this.pxe = dependencies.pxe ?? createPXEClient(config.pxeUrl!);
+  }
+
+  /**
+   * Initializes a new bot by setting up the sender account, registering the recipient,
+   * deploying the token contract, and minting tokens if necessary.
+   */
+  public async setup() {
+    const recipient = await this.registerRecipient();
+    const wallet = await this.setupAccount();
+    const token = await this.setupToken(wallet);
+    await this.mintTokens(token);
+    return { wallet, token, pxe: this.pxe, recipient };
+  }
+
+  /**
+   * Checks if the sender account contract is initialized, and initializes it if necessary.
+   * @returns The sender wallet.
+   */
+  private async setupAccount() {
+    const salt = Fr.ONE;
+    const signingKey = deriveSigningKey(this.config.senderPrivateKey);
+    const account = getSchnorrAccount(this.pxe, this.config.senderPrivateKey, signingKey, salt);
+    const isInit = await this.pxe.isContractInitialized(account.getAddress());
+    if (isInit) {
+      this.log.info(`Account at ${account.getAddress().toString()} already initialized`);
+      return account.register();
+    } else {
+      this.log.info(`Initializing account at ${account.getAddress().toString()}`);
+      return account.waitSetup();
+    }
+  }
+
+  /**
+   * Registers the recipient for txs in the pxe.
+   */
+  private async registerRecipient() {
+    const recipient = await this.pxe.registerAccount(this.config.recipientEncryptionSecret, Fr.ONE);
+    return recipient.address;
+  }
+
+  /**
+   * 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.
+   */
+  private async setupToken(wallet: AccountWallet): Promise<TokenContract> {
+    const deploy = TokenContract.deploy(wallet, wallet.getAddress(), 'BotToken', 'BOT', 18);
+    const deployOpts = { contractAddressSalt: this.config.tokenSalt, universalDeploy: true };
+    const address = deploy.getInstance(deployOpts).address;
+    if (await this.pxe.isContractPubliclyDeployed(address)) {
+      this.log.info(`Token at ${address.toString()} already deployed`);
+      return deploy.register();
+    } else {
+      this.log.info(`Deploying token contract at ${address.toString()}`);
+      return deploy.send(deployOpts).deployed();
+    }
+  }
+
+  /**
+   * Mints private and public tokens for the sender if their balance is below the minimum.
+   * @param token - Token contract.
+   */
+  private async mintTokens(token: TokenContract) {
+    const sender = token.wallet.getAddress();
+    const { privateBalance, publicBalance } = await getBalances(token, sender);
+    const calls: FunctionCall[] = [];
+    if (privateBalance < MIN_BALANCE) {
+      this.log.info(`Minting private tokens for ${sender.toString()}`);
+      calls.push(token.methods.privately_mint_private_note(MINT_BALANCE).request());
+    }
+    if (publicBalance < MIN_BALANCE) {
+      this.log.info(`Minting public tokens for ${sender.toString()}`);
+      calls.push(token.methods.mint_public(sender, MINT_BALANCE).request());
+    }
+    if (calls.length === 0) {
+      this.log.info(`Skipping minting as ${sender.toString()} has enough tokens`);
+      return;
+    }
+    await new BatchCall(token.wallet, calls).send().wait();
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { Bot } from './bot.js';
+export { BotRunner } from './runner.js';
+export { BotConfig, getBotConfigFromEnv, getBotDefaultConfig } from './config.js';
+export { createBotRunnerRpcServer } from './rpc.js';

package/src/rpc.ts

@@ -0,0 +1,16 @@
+import { TxHash } from '@aztec/circuit-types';
+import { AztecAddress } from '@aztec/foundation/aztec-address';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Fr } from '@aztec/foundation/fields';
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+
+import { type BotRunner } from './runner.js';
+
+/**
+ * Wraps a bot runner with a JSON RPC HTTP server.
+ * @param botRunner - The BotRunner.
+ * @returns An JSON-RPC HTTP server
+ */
+export function createBotRunnerRpcServer(botRunner: BotRunner) {
+  return new JsonRpcServer(botRunner, { AztecAddress, EthAddress, Fr, TxHash }, {}, []);
+}

package/src/runner.ts

@@ -0,0 +1,102 @@
+import { type PXE, createDebugLogger } from '@aztec/aztec.js';
+
+import { Bot } from './bot.js';
+import { type BotConfig } from './config.js';
+
+export class BotRunner {
+  private log = createDebugLogger('aztec:bot');
+  private interval?: NodeJS.Timeout;
+  private bot?: Promise<Bot>;
+  private pxe?: PXE;
+  private running: Set<Promise<void>> = new Set();
+
+  public constructor(private config: BotConfig, dependencies: { pxe?: PXE } = {}) {
+    this.pxe = dependencies.pxe;
+  }
+
+  /** Initializes the bot if needed. Blocks until the bot setup is finished. */
+  public async setup() {
+    if (!this.bot) {
+      this.log.verbose(`Setting up bot`);
+      await this.#createBot();
+      this.log.info(`Bot set up completed`);
+    }
+  }
+
+  /**
+   * Initializes the bot if needed and starts sending txs at regular intervals.
+   * Blocks until the bot setup is finished.
+   */
+  public async start() {
+    await this.setup();
+    if (!this.interval) {
+      this.log.info(`Starting bot with interval of ${this.config.txIntervalSeconds}s`);
+      this.interval = setInterval(() => this.run(), this.config.txIntervalSeconds * 1000);
+    }
+  }
+
+  /**
+   * Stops sending txs. Returns once all ongoing txs are finished.
+   */
+  public async stop() {
+    if (this.interval) {
+      this.log.verbose(`Stopping bot`);
+      clearInterval(this.interval);
+      this.interval = undefined;
+    }
+    if (this.running.size > 0) {
+      this.log.verbose(`Waiting for ${this.running.size} running txs to finish`);
+      await Promise.all(this.running);
+    }
+    this.log.info(`Stopped bot`);
+  }
+
+  /** Returns whether the bot is running. */
+  public isRunning() {
+    return !!this.interval;
+  }
+
+  /**
+   * Updates the bot config and recreates the bot. Will stop and restart the bot automatically if it was
+   * running when this method was called. Blocks until the new bot is set up.
+   */
+  public async update(config: BotConfig) {
+    this.log.verbose(`Updating bot config`);
+    const wasRunning = this.isRunning();
+    if (wasRunning) {
+      await this.stop();
+    }
+    this.config = { ...this.config, ...config };
+    await this.#createBot();
+    this.log.info(`Bot config updated`);
+    if (wasRunning) {
+      await this.start();
+    }
+  }
+
+  /**
+   * Triggers a single iteration of the bot. Requires the bot to be initialized.
+   * Blocks until the run is finished.
+   */
+  public async run() {
+    if (!this.bot) {
+      throw new Error(`Bot is not initialized`);
+    }
+    this.log.verbose(`Manually triggered bot run`);
+    const bot = await this.bot;
+    const promise = bot.run();
+    this.running.add(promise);
+    await promise;
+    this.running.delete(promise);
+  }
+
+  /** Returns the current configuration for the bot. */
+  public getConfig() {
+    return this.config;
+  }
+
+  async #createBot() {
+    this.bot = Bot.create(this.config, { pxe: this.pxe });
+    await this.bot;
+  }
+}

package/src/utils.ts

@@ -0,0 +1,17 @@
+import { type AztecAddress } from '@aztec/circuits.js';
+import { type TokenContract } from '@aztec/noir-contracts.js/Token';
+
+/**
+ * Gets the private and public balance of the given token for the given address.
+ * @param token - Token contract.
+ * @param who - Address to get the balance for.
+ * @returns - Private and public token balances as bigints.
+ */
+export async function getBalances(
+  token: TokenContract,
+  who: AztecAddress,
+): Promise<{ privateBalance: bigint; publicBalance: bigint }> {
+  const privateBalance = await token.methods.balance_of_private(who).simulate();
+  const publicBalance = await token.methods.balance_of_public(who).simulate();
+  return { privateBalance, publicBalance };
+}