@aztec/cli 0.17.0 → 0.77.0-testnet-ignition.17

package/dest/cmds/pxe/get_block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_block.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_block.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI3D,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,iBAInH"}

package/dest/cmds/pxe/get_block.js

@@ -0,0 +1,9 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+import { inspectBlock } from '../../utils/inspect.js';
+export async function getBlock(rpcUrl, maybeBlockNumber, debugLogger, log) {
+    const client = await createCompatibleClient(rpcUrl, debugLogger);
+    const blockNumber = maybeBlockNumber ?? await client.getBlockNumber();
+    await inspectBlock(client, blockNumber, log, {
+        showTxs: true
+    });
+}

package/dest/cmds/pxe/get_contract_data.d.ts

@@ -0,0 +1,4 @@
+import type { AztecAddress } from '@aztec/aztec.js';
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getContractData(rpcUrl: string, contractAddress: AztecAddress, includeBytecode: boolean, debugLogger: Logger, log: LogFn): Promise<void>;
+//# sourceMappingURL=get_contract_data.d.ts.map

package/dest/cmds/pxe/get_contract_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_contract_data.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_contract_data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,YAAY,EAC7B,eAAe,EAAE,OAAO,EACxB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,KAAK,iBAyCX"}

package/dest/cmds/pxe/get_contract_data.js

@@ -0,0 +1,31 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+export async function getContractData(rpcUrl, contractAddress, includeBytecode, debugLogger, log) {
+    const client = await createCompatibleClient(rpcUrl, debugLogger);
+    const { contractInstance: instance, isContractInitialized: isInitialized, isContractPubliclyDeployed: isPubliclyDeployed } = await client.getContractMetadata(contractAddress);
+    const contractClass = includeBytecode && instance && (await client.getContractClassMetadata(instance?.currentContractClassId)).contractClass;
+    const isPrivatelyDeployed = !!instance;
+    const initStr = isInitialized ? 'initialized' : 'not initialized';
+    const addrStr = contractAddress.toString();
+    if (isPubliclyDeployed && isPrivatelyDeployed) {
+        log(`Contract is ${initStr} and publicly deployed at ${addrStr}`);
+    } else if (isPrivatelyDeployed) {
+        log(`Contract is ${initStr} and registered in the local pxe at ${addrStr} but not publicly deployed`);
+    } else if (isPubliclyDeployed) {
+        log(`Contract is ${initStr} and publicly deployed at ${addrStr} but not registered in the local pxe`);
+    } else if (isInitialized) {
+        log(`Contract is initialized but not publicly deployed nor registered in the local pxe at ${addrStr}`);
+    } else {
+        log(`No contract found at ${addrStr}`);
+    }
+    if (instance) {
+        log(``);
+        Object.entries(instance).forEach(([key, value])=>{
+            const capitalized = key.charAt(0).toUpperCase() + key.slice(1);
+            log(`${capitalized}: ${value.toString()}`);
+        });
+        if (contractClass) {
+            log(`\nBytecode: ${contractClass.packedBytecode.toString('base64')}`);
+        }
+        log('');
+    }
+}

package/dest/cmds/pxe/get_current_base_fee.d.ts

@@ -0,0 +1,3 @@
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getCurrentBaseFee(rpcUrl: string, debugLogger: Logger, log: LogFn): Promise<void>;
+//# sourceMappingURL=get_current_base_fee.d.ts.map

package/dest/cmds/pxe/get_current_base_fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_current_base_fee.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_current_base_fee.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,iBAItF"}

package/dest/cmds/pxe/get_current_base_fee.js

@@ -0,0 +1,7 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+export async function getCurrentBaseFee(rpcUrl, debugLogger, log) {
+    const client = await createCompatibleClient(rpcUrl, debugLogger);
+    const fees = await client.getCurrentBaseFees();
+    log(`Current fees: ${jsonStringify(fees)}`);
+}

package/dest/cmds/pxe/get_l1_to_l2_message_witness.d.ts

@@ -0,0 +1,4 @@
+import { type AztecAddress, type Fr } from '@aztec/aztec.js';
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getL1ToL2MessageWitness(rpcUrl: string, contractAddress: AztecAddress, messageHash: Fr, secret: Fr, debugLogger: Logger, log: LogFn): Promise<void>;
+//# sourceMappingURL=get_l1_to_l2_message_witness.d.ts.map

package/dest/cmds/pxe/get_l1_to_l2_message_witness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_l1_to_l2_message_witness.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_l1_to_l2_message_witness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,EAAE,EAA0B,MAAM,iBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,YAAY,EAC7B,WAAW,EAAE,EAAE,EACf,MAAM,EAAE,EAAE,EACV,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,KAAK,iBAeX"}

package/dest/cmds/pxe/get_l1_to_l2_message_witness.js

@@ -0,0 +1,11 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+export async function getL1ToL2MessageWitness(rpcUrl, contractAddress, messageHash, secret, debugLogger, log) {
+    const client = await createCompatibleClient(rpcUrl, debugLogger);
+    const messageWitness = await client.getL1ToL2MembershipWitness(contractAddress, messageHash, secret);
+    log(messageWitness === undefined ? `
+    L1 to L2 Message not found.
+    ` : `
+    L1 to L2 message index: ${messageWitness[0]}
+    L1 to L2 message sibling path: ${messageWitness[1]}
+    `);
+}

package/dest/cmds/pxe/get_logs.d.ts

@@ -0,0 +1,4 @@
+import type { AztecAddress, LogId, TxHash } from '@aztec/aztec.js';
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getLogs(txHash: TxHash, fromBlock: number, toBlock: number, afterLog: LogId, contractAddress: AztecAddress, rpcUrl: string, follow: boolean, debugLogger: Logger, log: LogFn): Promise<void>;
+//# sourceMappingURL=get_logs.d.ts.map

package/dest/cmds/pxe/get_logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_logs.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG3D,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,KAAK,EACf,eAAe,EAAE,YAAY,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,KAAK,iBAmDX"}

package/dest/cmds/pxe/get_logs.js

@@ -0,0 +1,51 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+import { sleep } from '@aztec/foundation/sleep';
+export async function getLogs(txHash, fromBlock, toBlock, afterLog, contractAddress, rpcUrl, follow, debugLogger, log) {
+    const pxe = await createCompatibleClient(rpcUrl, debugLogger);
+    if (follow) {
+        if (txHash) {
+            throw Error('Cannot use --follow with --tx-hash');
+        }
+        if (toBlock) {
+            throw Error('Cannot use --follow with --to-block');
+        }
+    }
+    const filter = {
+        txHash,
+        fromBlock,
+        toBlock,
+        afterLog,
+        contractAddress
+    };
+    const fetchLogs = async ()=>{
+        const response = await pxe.getPublicLogs(filter);
+        const logs = response.logs;
+        if (!logs.length) {
+            const filterOptions = Object.entries(filter).filter(([, value])=>value !== undefined).map(([key, value])=>`${key}: ${value}`).join(', ');
+            if (!follow) {
+                log(`No logs found for filter: {${filterOptions}}`);
+            }
+        } else {
+            if (!follow && !filter.afterLog) {
+                log('Logs found: \n');
+            }
+            logs.forEach((publicLog)=>log(publicLog.toHumanReadable()));
+            // Set the continuation parameter for the following requests
+            filter.afterLog = logs[logs.length - 1].id;
+        }
+        return response.maxLogsHit;
+    };
+    if (follow) {
+        log('Fetching logs...');
+        while(true){
+            const maxLogsHit = await fetchLogs();
+            if (!maxLogsHit) {
+                await sleep(1000);
+            }
+        }
+    } else {
+        while(await fetchLogs()){
+        // Keep fetching logs until we reach the end.
+        }
+    }
+}

package/dest/cmds/pxe/get_node_info.d.ts

@@ -0,0 +1,3 @@
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getNodeInfo(rpcUrl: string, pxeRequest: boolean, debugLogger: Logger, json: boolean, log: LogFn, logJson: (output: any) => void): Promise<void>;
+//# sourceMappingURL=get_node_info.d.ts.map

package/dest/cmds/pxe/get_node_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_node_info.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_node_info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,iBA6D/B"}

package/dest/cmds/pxe/get_node_info.js

@@ -0,0 +1,61 @@
+import { createAztecNodeClient, createCompatibleClient } from '@aztec/aztec.js';
+export async function getNodeInfo(rpcUrl, pxeRequest, debugLogger, json, log, logJson) {
+    let client;
+    if (pxeRequest) {
+        client = await createCompatibleClient(rpcUrl, debugLogger);
+    } else {
+        client = createAztecNodeClient(rpcUrl);
+    }
+    const info = await client.getNodeInfo();
+    if (json) {
+        logJson({
+            nodeVersion: info.nodeVersion,
+            l1ChainId: info.l1ChainId,
+            protocolVersion: info.protocolVersion,
+            enr: info.enr,
+            l1ContractAddresses: {
+                rollup: info.l1ContractAddresses.rollupAddress.toString(),
+                registry: info.l1ContractAddresses.registryAddress.toString(),
+                inbox: info.l1ContractAddresses.inboxAddress.toString(),
+                outbox: info.l1ContractAddresses.outboxAddress.toString(),
+                feeJuice: info.l1ContractAddresses.feeJuiceAddress.toString(),
+                stakingAsset: info.l1ContractAddresses.stakingAssetAddress.toString(),
+                feeJuicePortal: info.l1ContractAddresses.feeJuicePortalAddress.toString(),
+                coinIssuer: info.l1ContractAddresses.coinIssuerAddress.toString(),
+                rewardDistributor: info.l1ContractAddresses.rewardDistributorAddress.toString(),
+                governanceProposer: info.l1ContractAddresses.governanceProposerAddress.toString(),
+                governance: info.l1ContractAddresses.governanceAddress.toString(),
+                slashFactory: info.l1ContractAddresses.slashFactoryAddress?.toString()
+            },
+            protocolContractAddresses: {
+                classRegisterer: info.protocolContractAddresses.classRegisterer.toString(),
+                feeJuice: info.protocolContractAddresses.feeJuice.toString(),
+                instanceDeployer: info.protocolContractAddresses.instanceDeployer.toString(),
+                multiCallEntrypoint: info.protocolContractAddresses.multiCallEntrypoint.toString()
+            }
+        });
+    } else {
+        log(`Node Version: ${info.nodeVersion}`);
+        log(`Chain Id: ${info.l1ChainId}`);
+        log(`Protocol Version: ${info.protocolVersion}`);
+        log(`Node ENR: ${info.enr}`);
+        log(`L1 Contract Addresses:`);
+        log(` Rollup Address: ${info.l1ContractAddresses.rollupAddress.toString()}`);
+        log(` Registry Address: ${info.l1ContractAddresses.registryAddress.toString()}`);
+        log(` L1 -> L2 Inbox Address: ${info.l1ContractAddresses.inboxAddress.toString()}`);
+        log(` L2 -> L1 Outbox Address: ${info.l1ContractAddresses.outboxAddress.toString()}`);
+        log(` Fee Juice Address: ${info.l1ContractAddresses.feeJuiceAddress.toString()}`);
+        log(` Staking Asset Address: ${info.l1ContractAddresses.stakingAssetAddress.toString()}`);
+        log(` Fee Juice Portal Address: ${info.l1ContractAddresses.feeJuicePortalAddress.toString()}`);
+        log(` CoinIssuer Address: ${info.l1ContractAddresses.coinIssuerAddress.toString()}`);
+        log(` RewardDistributor Address: ${info.l1ContractAddresses.rewardDistributorAddress.toString()}`);
+        log(` GovernanceProposer Address: ${info.l1ContractAddresses.governanceProposerAddress.toString()}`);
+        log(` Governance Address: ${info.l1ContractAddresses.governanceAddress.toString()}`);
+        log(` SlashFactory Address: ${info.l1ContractAddresses.slashFactoryAddress?.toString()}`);
+        log(`L2 Contract Addresses:`);
+        log(` Class Registerer: ${info.protocolContractAddresses.classRegisterer.toString()}`);
+        log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
+        log(` Instance Deployer: ${info.protocolContractAddresses.instanceDeployer.toString()}`);
+        log(` MultiCall: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
+    }
+}

package/dest/cmds/pxe/get_pxe_info.d.ts

@@ -0,0 +1,3 @@
+import type { LogFn, Logger } from '@aztec/foundation/log';
+export declare function getPXEInfo(rpcUrl: string, debugLogger: Logger, log: LogFn): Promise<void>;
+//# sourceMappingURL=get_pxe_info.d.ts.map

package/dest/cmds/pxe/get_pxe_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_pxe_info.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/get_pxe_info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,iBAS/E"}

package/dest/cmds/pxe/get_pxe_info.js

@@ -0,0 +1,11 @@
+import { createCompatibleClient } from '@aztec/aztec.js';
+export async function getPXEInfo(rpcUrl, debugLogger, log) {
+    const client = await createCompatibleClient(rpcUrl, debugLogger);
+    const info = await client.getPXEInfo();
+    log(`PXE Version: ${info.pxeVersion}`);
+    log(`Protocol Contract Addresses:`);
+    log(` Class Registerer: ${info.protocolContractAddresses.classRegisterer.toString()}`);
+    log(` Fee Juice: ${info.protocolContractAddresses.feeJuice.toString()}`);
+    log(` Instance Deployer: ${info.protocolContractAddresses.instanceDeployer.toString()}`);
+    log(` Multi Call Entrypoint: ${info.protocolContractAddresses.multiCallEntrypoint.toString()}`);
+}

package/dest/cmds/pxe/index.d.ts

@@ -0,0 +1,4 @@
+import type { LogFn, Logger } from '@aztec/foundation/log';
+import type { Command } from 'commander';
+export declare function injectCommands(program: Command, log: LogFn, debugLogger: Logger): Command;
+//# sourceMappingURL=index.d.ts.map

package/dest/cmds/pxe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmds/pxe/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAqJ/E"}

package/dest/cmds/pxe/index.js

@@ -0,0 +1,55 @@
+import { Fr } from '@aztec/foundation/fields';
+import { logJson, makePxeOption, parseAztecAddress, parseEthereumAddress, parseField, parseFieldFromHexString, parseOptionalAztecAddress, parseOptionalInteger, parseOptionalLogId, parseOptionalTxHash, parsePublicKey, pxeOption } from '../../utils/commands.js';
+export function injectCommands(program, log, debugLogger) {
+    program.command('add-contract').description('Adds an existing contract to the PXE. This is useful if you have deployed a contract outside of the PXE and want to use it with the PXE.').requiredOption('-c, --contract-artifact <fileLocation>', "A compiled Aztec.nr contract's ABI in JSON format or name of a contract ABI exported by @aztec/noir-contracts.js").requiredOption('-ca, --contract-address <address>', 'Aztec address of the contract.', parseAztecAddress).requiredOption('--init-hash <init hash>', 'Initialization hash', parseFieldFromHexString).option('--salt <salt>', 'Optional deployment salt', parseFieldFromHexString).option('-p, --public-key <public key>', 'Optional public key for this contract', parsePublicKey).option('--portal-address <address>', 'Optional address to a portal contract on L1', parseEthereumAddress).option('--deployer-address <address>', 'Optional address of the contract deployer', parseAztecAddress).addOption(pxeOption).action(async (options)=>{
+        const { addContract } = await import('./add_contract.js');
+        await addContract(options.rpcUrl, options.contractArtifact, options.contractAddress, options.initHash, options.salt ?? Fr.ZERO, options.publicKey, options.deployerAddress, debugLogger, log);
+    });
+    program.command('get-block').description('Gets info for a given block or latest.').argument('[blockNumber]', 'Block height', parseOptionalInteger).addOption(pxeOption).action(async (blockNumber, options)=>{
+        const { getBlock } = await import('./get_block.js');
+        await getBlock(options.rpcUrl, blockNumber, debugLogger, log);
+    });
+    program.command('get-current-base-fee').description('Gets the current base fee.').addOption(pxeOption).action(async (options)=>{
+        const { getCurrentBaseFee } = await import('./get_current_base_fee.js');
+        await getCurrentBaseFee(options.rpcUrl, debugLogger, log);
+    });
+    program.command('get-contract-data').description('Gets information about the Aztec contract deployed at the specified address.').argument('<contractAddress>', 'Aztec address of the contract.', parseAztecAddress).addOption(pxeOption).option('-b, --include-bytecode <boolean>', "Include the contract's public function bytecode, if any.", false).action(async (contractAddress, options)=>{
+        const { getContractData } = await import('./get_contract_data.js');
+        await getContractData(options.rpcUrl, contractAddress, options.includeBytecode, debugLogger, log);
+    });
+    program.command('get-logs').description('Gets all the public logs from an intersection of all the filter params.').option('-tx, --tx-hash <txHash>', 'A transaction hash to get the receipt for.', parseOptionalTxHash).option('-fb, --from-block <blockNum>', 'Initial block number for getting logs (defaults to 1).', parseOptionalInteger).option('-tb, --to-block <blockNum>', 'Up to which block to fetch logs (defaults to latest).', parseOptionalInteger).option('-al --after-log <logId>', 'ID of a log after which to fetch the logs.', parseOptionalLogId).option('-ca, --contract-address <address>', 'Contract address to filter logs by.', parseOptionalAztecAddress).addOption(pxeOption).option('--follow', 'If set, will keep polling for new logs until interrupted.').action(async ({ txHash, fromBlock, toBlock, afterLog, contractAddress, rpcUrl, follow })=>{
+        const { getLogs } = await import('./get_logs.js');
+        await getLogs(txHash, fromBlock, toBlock, afterLog, contractAddress, rpcUrl, follow, debugLogger, log);
+    });
+    program.command('get-accounts').description('Gets all the Aztec accounts stored in the PXE.').addOption(pxeOption).option('--json', 'Emit output as json').action(async (options)=>{
+        const { getAccounts } = await import('./get_accounts.js');
+        await getAccounts(options.rpcUrl, options.json, debugLogger, log, logJson(log));
+    });
+    program.command('get-account').description('Gets an account given its Aztec address.').argument('<address>', 'The Aztec address to get account for', parseAztecAddress).addOption(pxeOption).action(async (address, options)=>{
+        const { getAccount } = await import('./get_account.js');
+        await getAccount(address, options.rpcUrl, debugLogger, log);
+    });
+    program.command('block-number').description('Gets the current Aztec L2 block number.').addOption(pxeOption).action(async (options)=>{
+        const { blockNumber } = await import('./block_number.js');
+        await blockNumber(options.rpcUrl, debugLogger, log);
+    });
+    program.command('get-l1-to-l2-message-witness').description('Gets a L1 to L2 message witness.').requiredOption('-ca, --contract-address <address>', 'Aztec address of the contract.', parseAztecAddress).requiredOption('--message-hash <messageHash>', 'The L1 to L2 message hash.', parseField).requiredOption('--secret <secret>', 'The secret used to claim the L1 to L2 message', parseField).addOption(pxeOption).action(async ({ contractAddress, messageHash, secret, rpcUrl })=>{
+        const { getL1ToL2MessageWitness } = await import('./get_l1_to_l2_message_witness.js');
+        await getL1ToL2MessageWitness(rpcUrl, contractAddress, messageHash, secret, debugLogger, log);
+    });
+    program.command('get-node-info').description('Gets the information of an Aztec node from a PXE or directly from an Aztec node.').option('--node-url <string>', 'URL of the node.').option('--json', 'Emit output as json').addOption(makePxeOption(false)).action(async (options)=>{
+        const { getNodeInfo } = await import('./get_node_info.js');
+        let url;
+        if (options.nodeUrl) {
+            url = options.nodeUrl;
+        } else {
+            url = options.rpcUrl;
+        }
+        await getNodeInfo(url, !options.nodeUrl, debugLogger, options.json, log, logJson(log));
+    });
+    program.command('get-pxe-info').description('Gets the information of a PXE at a URL.').addOption(pxeOption).action(async (options)=>{
+        const { getPXEInfo } = await import('./get_pxe_info.js');
+        await getPXEInfo(options.rpcUrl, debugLogger, log);
+    });
+    return program;
+}

package/dest/utils/aztec.d.ts

@@ -0,0 +1,68 @@
+import type { EthAddress, PXE } from '@aztec/aztec.js';
+import { type ContractArtifact, type FunctionArtifact } from '@aztec/aztec.js/abi';
+import type { DeployL1ContractsReturnType, L1ContractsConfig, RollupContract } from '@aztec/ethereum';
+import type { Fr } from '@aztec/foundation/fields';
+import type { LogFn, Logger } from '@aztec/foundation/log';
+import type { NoirPackageConfig } from '@aztec/foundation/noir';
+/**
+ * Helper to get an ABI function or throw error if it doesn't exist.
+ * @param artifact - Contract's build artifact in JSON format.
+ * @param fnName - Function name to be found.
+ * @returns The function's ABI.
+ */
+export declare function getFunctionArtifact(artifact: ContractArtifact, fnName: string): FunctionArtifact;
+/**
+ * Function to execute the 'deployRollupContracts' command.
+ * @param rpcUrls - The RPC URL of the ethereum node.
+ * @param chainId - The chain ID of the L1 host.
+ * @param privateKey - The private key to be used in contract deployment.
+ * @param mnemonic - The mnemonic to be used in contract deployment.
+ */
+export declare function deployAztecContracts(rpcUrls: string[], chainId: number, privateKey: string | undefined, mnemonic: string, mnemonicIndex: number, salt: number | undefined, initialValidators: EthAddress[], genesisArchiveRoot: Fr, genesisBlockHash: Fr, config: L1ContractsConfig, debugLogger: Logger): Promise<DeployL1ContractsReturnType>;
+export declare function deployNewRollupContracts(registryAddress: EthAddress, rpcUrls: string[], chainId: number, privateKey: string | undefined, mnemonic: string, mnemonicIndex: number, salt: number | undefined, initialValidators: EthAddress[], genesisArchiveRoot: Fr, genesisBlockHash: Fr, config: L1ContractsConfig, logger: Logger): Promise<{
+    payloadAddress: EthAddress;
+    rollup: RollupContract;
+}>;
+/**
+ * Gets all contracts available in \@aztec/noir-contracts.js.
+ * @returns The contract names.
+ */
+export declare function getExampleContractNames(): Promise<string[]>;
+/**
+ * Reads a file and converts it to an Aztec Contract ABI.
+ * @param fileDir - The directory of the compiled contract ABI.
+ * @returns The parsed contract artifact.
+ */
+export declare function getContractArtifact(fileDir: string, log: LogFn): Promise<ContractArtifact>;
+/**
+ * Performs necessary checks, conversions & operations to call a contract fn from the CLI.
+ * @param contractFile - Directory of the compiled contract ABI.
+ * @param functionName - Name of the function to be called.
+ * @param _functionArgs - Arguments to call the function with.
+ * @param log - Logger instance that will output to the CLI
+ * @returns Formatted contract address, function arguments and caller's aztec address.
+ */
+export declare function prepTx(contractFile: string, functionName: string, _functionArgs: string[], log: LogFn): Promise<{
+    functionArgs: any[];
+    contractArtifact: ContractArtifact;
+    isPrivate: boolean;
+}>;
+/**
+ * Removes the leading 0x from a hex string. If no leading 0x is found the string is returned unchanged.
+ * @param hex - A hex string
+ * @returns A new string with leading 0x removed
+ */
+export declare const stripLeadingHex: (hex: string) => string;
+/**
+ * Pretty prints Nargo.toml contents to a string
+ * @param config - Nargo.toml contents
+ * @returns The Nargo.toml contents as a string
+ */
+export declare function prettyPrintNargoToml(config: NoirPackageConfig): string;
+/**
+ * Checks that Private eXecution Environment (PXE) version matches the expected one by this CLI. Throws if not.
+ * @param pxe - PXE client.
+ * @param expectedVersionRange - Expected version by CLI.
+ */
+export declare function checkServerVersion(pxe: PXE, expectedVersionRange: string): Promise<void>;
+//# sourceMappingURL=aztec.d.ts.map

package/dest/utils/aztec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aztec.d.ts","sourceRoot":"","sources":["../../src/utils/aztec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAwB,MAAM,qBAAqB,CAAC;AACzG,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAUhE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAMhG;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,kBAAkB,EAAE,EAAE,EACtB,gBAAgB,EAAE,EAAE,EACpB,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,CAAC,CA4BtC;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,UAAU,EAC3B,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,kBAAkB,EAAE,EAAE,EACtB,gBAAgB,EAAE,EAAE,EACpB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,cAAc,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CA6BjE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAKjE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,6BA4BpE;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK;;;;GAO3G;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAS,MAAM,WAK1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAUtE;AAKD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,iBAyB9E"}

package/dest/utils/aztec.js

@@ -0,0 +1,173 @@
+import { loadContractArtifact } from '@aztec/aztec.js/abi';
+import { ProtocolContractAddress, protocolContractTreeRoot } from '@aztec/protocol-contracts';
+import { FunctionType } from '@aztec/stdlib/abi';
+import TOML from '@iarna/toml';
+import { readFile } from 'fs/promises';
+import { gtr, ltr, satisfies, valid } from 'semver';
+import { encodeArgs } from './encoding.js';
+/**
+ * Helper to get an ABI function or throw error if it doesn't exist.
+ * @param artifact - Contract's build artifact in JSON format.
+ * @param fnName - Function name to be found.
+ * @returns The function's ABI.
+ */ export function getFunctionArtifact(artifact, fnName) {
+    const fn = artifact.functions.find(({ name })=>name === fnName);
+    if (!fn) {
+        throw Error(`Function ${fnName} not found in contract ABI.`);
+    }
+    return fn;
+}
+/**
+ * Function to execute the 'deployRollupContracts' command.
+ * @param rpcUrls - The RPC URL of the ethereum node.
+ * @param chainId - The chain ID of the L1 host.
+ * @param privateKey - The private key to be used in contract deployment.
+ * @param mnemonic - The mnemonic to be used in contract deployment.
+ */ export async function deployAztecContracts(rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, initialValidators, genesisArchiveRoot, genesisBlockHash, config, debugLogger) {
+    const { createEthereumChain, deployL1Contracts } = await import('@aztec/ethereum');
+    const { mnemonicToAccount, privateKeyToAccount } = await import('viem/accounts');
+    const account = !privateKey ? mnemonicToAccount(mnemonic, {
+        addressIndex: mnemonicIndex
+    }) : privateKeyToAccount(`${privateKey.startsWith('0x') ? '' : '0x'}${privateKey}`);
+    const chain = createEthereumChain(rpcUrls, chainId);
+    const { getVKTreeRoot } = await import('@aztec/noir-protocol-circuits-types/vk-tree');
+    return await deployL1Contracts(chain.rpcUrls, account, chain.chainInfo, debugLogger, {
+        l2FeeJuiceAddress: ProtocolContractAddress.FeeJuice.toField(),
+        vkTreeRoot: getVKTreeRoot(),
+        protocolContractTreeRoot,
+        genesisArchiveRoot,
+        genesisBlockHash,
+        salt,
+        initialValidators,
+        ...config
+    }, config);
+}
+export async function deployNewRollupContracts(registryAddress, rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, initialValidators, genesisArchiveRoot, genesisBlockHash, config, logger) {
+    const { createEthereumChain, deployRollupAndPeriphery, createL1Clients } = await import('@aztec/ethereum');
+    const { mnemonicToAccount, privateKeyToAccount } = await import('viem/accounts');
+    const { getVKTreeRoot } = await import('@aztec/noir-protocol-circuits-types/vk-tree');
+    const account = !privateKey ? mnemonicToAccount(mnemonic, {
+        addressIndex: mnemonicIndex
+    }) : privateKeyToAccount(`${privateKey.startsWith('0x') ? '' : '0x'}${privateKey}`);
+    const chain = createEthereumChain(rpcUrls, chainId);
+    const clients = createL1Clients(rpcUrls, account, chain.chainInfo, mnemonicIndex);
+    const { payloadAddress, rollup } = await deployRollupAndPeriphery(clients, {
+        salt,
+        vkTreeRoot: getVKTreeRoot(),
+        protocolContractTreeRoot,
+        l2FeeJuiceAddress: ProtocolContractAddress.FeeJuice.toField(),
+        genesisArchiveRoot,
+        genesisBlockHash,
+        initialValidators,
+        ...config
+    }, registryAddress, logger, config);
+    return {
+        payloadAddress,
+        rollup
+    };
+}
+/**
+ * Gets all contracts available in \@aztec/noir-contracts.js.
+ * @returns The contract names.
+ */ export async function getExampleContractNames() {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore - Importing noir-contracts.js even in devDeps results in a circular dependency error. Need to ignore because this line doesn't cause an error in a dev environment
+    const { ContractNames } = await import('@aztec/noir-contracts.js');
+    return ContractNames;
+}
+/**
+ * Reads a file and converts it to an Aztec Contract ABI.
+ * @param fileDir - The directory of the compiled contract ABI.
+ * @returns The parsed contract artifact.
+ */ export async function getContractArtifact(fileDir, log) {
+    // first check if it's a noir-contracts example
+    const allNames = await getExampleContractNames();
+    const contractName = fileDir.replace(/Contract(Artifact)?$/, '');
+    if (allNames.includes(contractName)) {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore - Importing noir-contracts.js even in devDeps results in a circular dependency error. Need to ignore because this line doesn't cause an error in a dev environment
+        const imported = await import(`@aztec/noir-contracts.js/${contractName}`);
+        const artifact = imported[`${contractName}ContractArtifact`];
+        if (!artifact) {
+            throw Error(`Could not import ${contractName}ContractArtifact from @aztec/noir-contracts.js/${contractName}`);
+        }
+        return artifact;
+    }
+    let contents;
+    try {
+        contents = await readFile(fileDir, 'utf8');
+    } catch  {
+        throw Error(`Contract ${fileDir} not found`);
+    }
+    try {
+        return loadContractArtifact(JSON.parse(contents));
+    } catch (err) {
+        log('Invalid file used. Please try again.');
+        throw err;
+    }
+}
+/**
+ * Performs necessary checks, conversions & operations to call a contract fn from the CLI.
+ * @param contractFile - Directory of the compiled contract ABI.
+ * @param functionName - Name of the function to be called.
+ * @param _functionArgs - Arguments to call the function with.
+ * @param log - Logger instance that will output to the CLI
+ * @returns Formatted contract address, function arguments and caller's aztec address.
+ */ export async function prepTx(contractFile, functionName, _functionArgs, log) {
+    const contractArtifact = await getContractArtifact(contractFile, log);
+    const functionArtifact = getFunctionArtifact(contractArtifact, functionName);
+    const functionArgs = encodeArgs(_functionArgs, functionArtifact.parameters);
+    const isPrivate = functionArtifact.functionType === FunctionType.PRIVATE;
+    return {
+        functionArgs,
+        contractArtifact,
+        isPrivate
+    };
+}
+/**
+ * Removes the leading 0x from a hex string. If no leading 0x is found the string is returned unchanged.
+ * @param hex - A hex string
+ * @returns A new string with leading 0x removed
+ */ export const stripLeadingHex = (hex)=>{
+    if (hex.length > 2 && hex.startsWith('0x')) {
+        return hex.substring(2);
+    }
+    return hex;
+};
+/**
+ * Pretty prints Nargo.toml contents to a string
+ * @param config - Nargo.toml contents
+ * @returns The Nargo.toml contents as a string
+ */ export function prettyPrintNargoToml(config) {
+    const withoutDependencies = Object.fromEntries(Object.entries(config).filter(([key])=>key !== 'dependencies'));
+    const partialToml = TOML.stringify(withoutDependencies);
+    const dependenciesToml = Object.entries(config.dependencies).map(([name, dep])=>{
+        const depToml = TOML.stringify.value(dep);
+        return `${name} = ${depToml}`;
+    });
+    return partialToml + '\n[dependencies]\n' + dependenciesToml.join('\n') + '\n';
+}
+/** Mismatch between server and client versions. */ class VersionMismatchError extends Error {
+}
+/**
+ * Checks that Private eXecution Environment (PXE) version matches the expected one by this CLI. Throws if not.
+ * @param pxe - PXE client.
+ * @param expectedVersionRange - Expected version by CLI.
+ */ export async function checkServerVersion(pxe, expectedVersionRange) {
+    const serverName = 'Aztec Node';
+    const { nodeVersion } = await pxe.getNodeInfo();
+    if (!nodeVersion) {
+        throw new VersionMismatchError(`Couldn't determine ${serverName} version. You may run into issues.`);
+    }
+    if (!nodeVersion || !valid(nodeVersion)) {
+        throw new VersionMismatchError(`Missing or invalid version identifier for ${serverName} (${nodeVersion ?? 'empty'}).`);
+    } else if (!satisfies(nodeVersion, expectedVersionRange)) {
+        if (gtr(nodeVersion, expectedVersionRange)) {
+            throw new VersionMismatchError(`${serverName} is running version ${nodeVersion} which is newer than the expected by this CLI (${expectedVersionRange}). Consider upgrading your CLI to a newer version.`);
+        } else if (ltr(nodeVersion, expectedVersionRange)) {
+            throw new VersionMismatchError(`${serverName} is running version ${nodeVersion} which is older than the expected by this CLI (${expectedVersionRange}). Consider upgrading your ${serverName} to a newer version.`);
+        } else {
+            throw new VersionMismatchError(`${serverName} is running version ${nodeVersion} which does not match the expected by this CLI (${expectedVersionRange}).`);
+        }
+    }
+}