@aztec/aztec.js 0.7.2 → 0.7.4

package/dest/main.js.LICENSE.txt

@@ -0,0 +1,10 @@
+/*!
+ * The buffer module from node.js, for the browser.
+ *
+ * @author   Feross Aboukhadijeh <https://feross.org>
+ * @license  MIT
+ */
+
+/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
+
+/*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */

package/dest/sandbox/index.d.ts

@@ -0,0 +1,167 @@
+import { Fr, GrumpkinScalar } from '@aztec/circuits.js';
+import { AccountWallet, AztecRPC } from '../index.js';
+export declare const INITIAL_SANDBOX_ENCRYPTION_KEYS: GrumpkinScalar[];
+export declare const INITIAL_SANDBOX_SIGNING_KEYS: GrumpkinScalar[];
+export declare const INITIAL_SANDBOX_SALTS: Fr[];
+export declare const INITIAL_SANDBOX_ACCOUNT_CONTRACT_ABI: {
+    name: string;
+    functions: ({
+        name: string;
+        functionType: string;
+        isInternal: boolean;
+        parameters: ({
+            name: string;
+            type: {
+                kind: string;
+                length?: undefined;
+                type?: undefined;
+            };
+            visibility: string;
+        } | {
+            name: string;
+            type: {
+                kind: string;
+                length: number;
+                type: {
+                    kind: string;
+                };
+            };
+            visibility: string;
+        })[];
+        returnTypes: {
+            kind: string;
+            length: number;
+            type: {
+                kind: string;
+            };
+        }[];
+        bytecode: string;
+        verificationKey: string;
+    } | {
+        name: string;
+        functionType: string;
+        isInternal: boolean;
+        parameters: {
+            name: string;
+            type: {
+                kind: string;
+                path: string;
+                fields: ({
+                    name: string;
+                    type: {
+                        kind: string;
+                        length: number;
+                        type: {
+                            kind: string;
+                        };
+                    };
+                } | {
+                    name: string;
+                    type: {
+                        kind: string;
+                        length?: undefined;
+                        type?: undefined;
+                    };
+                })[];
+            };
+            visibility: string;
+        }[];
+        returnTypes: never[];
+        bytecode: string;
+        verificationKey: string;
+    } | {
+        name: string;
+        functionType: string;
+        isInternal: boolean;
+        parameters: {
+            name: string;
+            type: {
+                kind: string;
+            };
+            visibility: string;
+        }[];
+        returnTypes: {
+            kind: string;
+            path: string;
+            fields: ({
+                name: string;
+                type: {
+                    kind: string;
+                    path: string;
+                    fields: {
+                        name: string;
+                        type: {
+                            kind: string;
+                        };
+                    }[];
+                    length?: undefined;
+                    type?: undefined;
+                };
+            } | {
+                name: string;
+                type: {
+                    kind: string;
+                    path?: undefined;
+                    fields?: undefined;
+                    length?: undefined;
+                    type?: undefined;
+                };
+            } | {
+                name: string;
+                type: {
+                    kind: string;
+                    length: number;
+                    type: {
+                        kind: string;
+                        path?: undefined;
+                        fields?: undefined;
+                    };
+                    path?: undefined;
+                    fields?: undefined;
+                };
+            } | {
+                name: string;
+                type: {
+                    kind: string;
+                    length: number;
+                    type: {
+                        kind: string;
+                        path: string;
+                        fields: {
+                            name: string;
+                            type: {
+                                kind: string;
+                            };
+                        }[];
+                    };
+                    path?: undefined;
+                    fields?: undefined;
+                };
+            })[];
+        }[];
+        bytecode: string;
+        verificationKey: string;
+    })[];
+};
+export declare const SANDBOX_URL: string;
+/**
+ * Gets a collection of wallets for the Aztec accounts that are initially stored in the sandbox.
+ * @param aztecRpc - An instance of the Aztec RPC interface.
+ * @returns A set of AccountWallet implementations for each of the initial accounts.
+ */
+export declare function getSandboxAccountsWallets(aztecRpc: AztecRPC): Promise<AccountWallet[]>;
+/**
+ * Deploys the initial set of schnorr signature accounts to the sandbox
+ * @param aztecRpc - An instance of the Aztec RPC interface.
+ * @returns The set of deployed Account objects and associated private encryption keys
+ */
+export declare function deployInitialSandboxAccounts(aztecRpc: AztecRPC): Promise<{
+    account: import("../index.js").AccountManager;
+    privateKey: GrumpkinScalar;
+}[]>;
+/**
+ * Function to wait until the sandbox becomes ready for use.
+ * @param rpc - The rpc client connected to the sandbox.
+ */
+export declare function waitForSandbox(rpc?: AztecRPC): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dest/sandbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAA2C,MAAM,aAAa,CAAC;AAE/F,eAAO,MAAM,+BAA+B,kBAI3C,CAAC;AAEF,eAAO,MAAM,4BAA4B,kBAAkC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,MAA8B,CAAC;AAEjE,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4B,CAAC;AAE9E,eAAO,MAAQ,WAAW,QAA0C,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAMtF;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ;;;KA4BpE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,iBAUlD"}

package/dest/sandbox/index.js

@@ -0,0 +1,69 @@
+import { Fr, GrumpkinScalar } from '@aztec/circuits.js';
+import { sleep } from '@aztec/foundation/sleep';
+import zip from 'lodash.zip';
+import SchnorrAccountContractAbi from '../abis/schnorr_account_contract.json' assert { type: 'json' };
+import { createAztecRpcClient, getSchnorrAccount } from '../index.js';
+export const INITIAL_SANDBOX_ENCRYPTION_KEYS = [
+    GrumpkinScalar.fromString('2153536ff6628eee01cf4024889ff977a18d9fa61d0e414422f7681cf085c281'),
+    GrumpkinScalar.fromString('aebd1b4be76efa44f5ee655c20bf9ea60f7ae44b9a7fd1fd9f189c7a0b0cdae'),
+    GrumpkinScalar.fromString('0f6addf0da06c33293df974a565b03d1ab096090d907d98055a8b7f4954e120c'),
+];
+export const INITIAL_SANDBOX_SIGNING_KEYS = INITIAL_SANDBOX_ENCRYPTION_KEYS;
+export const INITIAL_SANDBOX_SALTS = [Fr.ZERO, Fr.ZERO, Fr.ZERO];
+export const INITIAL_SANDBOX_ACCOUNT_CONTRACT_ABI = SchnorrAccountContractAbi;
+export const { SANDBOX_URL = 'http://localhost:8080' } = process.env;
+/**
+ * Gets a collection of wallets for the Aztec accounts that are initially stored in the sandbox.
+ * @param aztecRpc - An instance of the Aztec RPC interface.
+ * @returns A set of AccountWallet implementations for each of the initial accounts.
+ */
+export function getSandboxAccountsWallets(aztecRpc) {
+    return Promise.all(zip(INITIAL_SANDBOX_ENCRYPTION_KEYS, INITIAL_SANDBOX_SIGNING_KEYS, INITIAL_SANDBOX_SALTS).map(([encryptionKey, signingKey, salt]) => getSchnorrAccount(aztecRpc, encryptionKey, signingKey, salt).getWallet()));
+}
+/**
+ * Deploys the initial set of schnorr signature accounts to the sandbox
+ * @param aztecRpc - An instance of the Aztec RPC interface.
+ * @returns The set of deployed Account objects and associated private encryption keys
+ */
+export async function deployInitialSandboxAccounts(aztecRpc) {
+    const accounts = INITIAL_SANDBOX_ENCRYPTION_KEYS.map((privateKey, i) => {
+        const account = getSchnorrAccount(aztecRpc, privateKey, INITIAL_SANDBOX_SIGNING_KEYS[i], INITIAL_SANDBOX_SALTS[i]);
+        return {
+            account,
+            privateKey,
+        };
+    });
+    // Attempt to get as much parallelism as possible
+    const deployMethods = await Promise.all(accounts.map(async (x) => {
+        const deployMethod = await x.account.getDeployMethod();
+        await deployMethod.create({ contractAddressSalt: x.account.salt });
+        await deployMethod.simulate({});
+        return deployMethod;
+    }));
+    // Send tx together to try and get them in the same rollup
+    const sentTxs = deployMethods.map(dm => {
+        return dm.send();
+    });
+    await Promise.all(sentTxs.map(async (tx, i) => {
+        const wallet = await accounts[i].account.getWallet();
+        return tx.wait({ wallet });
+    }));
+    return accounts;
+}
+/**
+ * Function to wait until the sandbox becomes ready for use.
+ * @param rpc - The rpc client connected to the sandbox.
+ */
+export async function waitForSandbox(rpc) {
+    rpc = rpc ?? createAztecRpcClient(SANDBOX_URL);
+    while (true) {
+        try {
+            await rpc.getNodeInfo();
+            break;
+        }
+        catch (err) {
+            await sleep(1000);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2FuZGJveC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLGNBQWMsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ3hELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVoRCxPQUFPLEdBQUcsTUFBTSxZQUFZLENBQUM7QUFFN0IsT0FBTyx5QkFBeUIsTUFBTSx1Q0FBdUMsQ0FBQyxTQUFTLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztBQUN0RyxPQUFPLEVBQTJCLG9CQUFvQixFQUFFLGlCQUFpQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRS9GLE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHO0lBQzdDLGNBQWMsQ0FBQyxVQUFVLENBQUMsa0VBQWtFLENBQUM7SUFDN0YsY0FBYyxDQUFDLFVBQVUsQ0FBQyxpRUFBaUUsQ0FBQztJQUM1RixjQUFjLENBQUMsVUFBVSxDQUFDLGtFQUFrRSxDQUFDO0NBQzlGLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBRywrQkFBK0IsQ0FBQztBQUU1RSxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUFDLEVBQUUsQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLElBQUksRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLENBQUM7QUFFakUsTUFBTSxDQUFDLE1BQU0sb0NBQW9DLEdBQUcseUJBQXlCLENBQUM7QUFFOUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxXQUFXLEdBQUcsdUJBQXVCLEVBQUUsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDO0FBRXJFOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUseUJBQXlCLENBQUMsUUFBa0I7SUFDMUQsT0FBTyxPQUFPLENBQUMsR0FBRyxDQUNoQixHQUFHLENBQUMsK0JBQStCLEVBQUUsNEJBQTRCLEVBQUUscUJBQXFCLENBQUMsQ0FBQyxHQUFHLENBQzNGLENBQUMsQ0FBQyxhQUFhLEVBQUUsVUFBVSxFQUFFLElBQUksQ0FBQyxFQUFFLEVBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxRQUFRLEVBQUUsYUFBYyxFQUFFLFVBQVcsRUFBRSxJQUFJLENBQUMsQ0FBQyxTQUFTLEVBQUUsQ0FDbEgsQ0FDRixDQUFDO0FBQ0osQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLDRCQUE0QixDQUFDLFFBQWtCO0lBQ25FLE1BQU0sUUFBUSxHQUFHLCtCQUErQixDQUFDLEdBQUcsQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDLEVBQUUsRUFBRTtRQUNyRSxNQUFNLE9BQU8sR0FBRyxpQkFBaUIsQ0FBQyxRQUFRLEVBQUUsVUFBVSxFQUFFLDRCQUE0QixDQUFDLENBQUMsQ0FBQyxFQUFFLHFCQUFxQixDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDbkgsT0FBTztZQUNMLE9BQU87WUFDUCxVQUFVO1NBQ1gsQ0FBQztJQUNKLENBQUMsQ0FBQyxDQUFDO0lBQ0gsaURBQWlEO0lBQ2pELE1BQU0sYUFBYSxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FDckMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUMsQ0FBQyxFQUFDLEVBQUU7UUFDckIsTUFBTSxZQUFZLEdBQUcsTUFBTSxDQUFDLENBQUMsT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDO1FBQ3ZELE1BQU0sWUFBWSxDQUFDLE1BQU0sQ0FBQyxFQUFFLG1CQUFtQixFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUNuRSxNQUFNLFlBQVksQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDaEMsT0FBTyxZQUFZLENBQUM7SUFDdEIsQ0FBQyxDQUFDLENBQ0gsQ0FBQztJQUNGLDBEQUEwRDtJQUMxRCxNQUFNLE9BQU8sR0FBRyxhQUFhLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxFQUFFO1FBQ3JDLE9BQU8sRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ25CLENBQUMsQ0FBQyxDQUFDO0lBQ0gsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUNmLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUUsRUFBRSxDQUFDLEVBQUUsRUFBRTtRQUMxQixNQUFNLE1BQU0sR0FBRyxNQUFNLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUM7UUFDckQsT0FBTyxFQUFFLENBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUM3QixDQUFDLENBQUMsQ0FDSCxDQUFDO0lBQ0YsT0FBTyxRQUFRLENBQUM7QUFDbEIsQ0FBQztBQUVEOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsY0FBYyxDQUFDLEdBQWM7SUFDakQsR0FBRyxHQUFHLEdBQUcsSUFBSSxvQkFBb0IsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUMvQyxPQUFPLElBQUksRUFBRTtRQUNYLElBQUk7WUFDRixNQUFNLEdBQUcsQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUN4QixNQUFNO1NBQ1A7UUFBQyxPQUFPLEdBQUcsRUFBRTtZQUNaLE1BQU0sS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO1NBQ25CO0tBQ0Y7QUFDSCxDQUFDIn0=

package/dest/utils/abi_types.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Fr } from '@aztec/circuits.js';
+/** Any type that can be converted into a field for a contract call. */
+export type FieldLike = Fr | Buffer | bigint | number | {
+    toField: () => Fr;
+};
+//# sourceMappingURL=abi_types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abi_types.d.ts","sourceRoot":"","sources":["../../src/utils/abi_types.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAExC,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG;IAA2B,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC"}

package/dest/utils/abi_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWJpX3R5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2FiaV90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dest/utils/account.d.ts

@@ -0,0 +1,23 @@
+import { CompleteAddress } from '@aztec/circuits.js';
+import { AztecRPC } from '@aztec/types';
+import { AccountWallet } from '../wallet/account_wallet.js';
+/**
+ * Deploys and registers a new account using random private keys and returns the associated wallet. Useful for testing.
+ * @param rpc - RPC client.
+ * @returns - A wallet for a fresh account.
+ */
+export declare function createAccount(rpc: AztecRPC): Promise<AccountWallet>;
+/**
+ * Creates a random address and registers it as a recipient on the RPC server. Useful for testing.
+ * @param rpc - RPC client.
+ * @returns Complete address of the registered recipient.
+ */
+export declare function createRecipient(rpc: AztecRPC): Promise<CompleteAddress>;
+/**
+ * Creates a given number of random accounts using the Schnorr account wallet.
+ * @param rpc - RPC interface.
+ * @param numberOfAccounts - How many accounts to create.
+ * @returns The created account wallets.
+ */
+export declare function createAccounts(rpc: AztecRPC, numberOfAccounts?: number): Promise<AccountWallet[]>;
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/utils/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAI7E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,gBAAgB,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAclG"}

package/dest/utils/account.js

@@ -0,0 +1,40 @@
+import { CompleteAddress, GrumpkinScalar } from '@aztec/circuits.js';
+import { getSchnorrAccount } from '../index.js';
+/**
+ * Deploys and registers a new account using random private keys and returns the associated wallet. Useful for testing.
+ * @param rpc - RPC client.
+ * @returns - A wallet for a fresh account.
+ */
+export function createAccount(rpc) {
+    return getSchnorrAccount(rpc, GrumpkinScalar.random(), GrumpkinScalar.random()).waitDeploy();
+}
+/**
+ * Creates a random address and registers it as a recipient on the RPC server. Useful for testing.
+ * @param rpc - RPC client.
+ * @returns Complete address of the registered recipient.
+ */
+export async function createRecipient(rpc) {
+    const completeAddress = await CompleteAddress.random();
+    await rpc.registerRecipient(completeAddress);
+    return completeAddress;
+}
+/**
+ * Creates a given number of random accounts using the Schnorr account wallet.
+ * @param rpc - RPC interface.
+ * @param numberOfAccounts - How many accounts to create.
+ * @returns The created account wallets.
+ */
+export async function createAccounts(rpc, numberOfAccounts = 1) {
+    const accounts = [];
+    // Prepare deployments
+    for (let i = 0; i < numberOfAccounts; ++i) {
+        const account = getSchnorrAccount(rpc, GrumpkinScalar.random(), GrumpkinScalar.random());
+        await account.getDeployMethod().then(d => d.simulate({ contractAddressSalt: account.salt }));
+        accounts.push(account);
+    }
+    // Send them and await them to be mined
+    const txs = await Promise.all(accounts.map(account => account.deploy()));
+    await Promise.all(txs.map(tx => tx.wait({ interval: 0.1 })));
+    return Promise.all(accounts.map(account => account.getWallet()));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy91dGlscy9hY2NvdW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFHckUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBR2hEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUFDLEdBQWE7SUFDekMsT0FBTyxpQkFBaUIsQ0FBQyxHQUFHLEVBQUUsY0FBYyxDQUFDLE1BQU0sRUFBRSxFQUFFLGNBQWMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDO0FBQy9GLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxlQUFlLENBQUMsR0FBYTtJQUNqRCxNQUFNLGVBQWUsR0FBRyxNQUFNLGVBQWUsQ0FBQyxNQUFNLEVBQUUsQ0FBQztJQUN2RCxNQUFNLEdBQUcsQ0FBQyxpQkFBaUIsQ0FBQyxlQUFlLENBQUMsQ0FBQztJQUM3QyxPQUFPLGVBQWUsQ0FBQztBQUN6QixDQUFDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGNBQWMsQ0FBQyxHQUFhLEVBQUUsZ0JBQWdCLEdBQUcsQ0FBQztJQUN0RSxNQUFNLFFBQVEsR0FBRyxFQUFFLENBQUM7SUFFcEIsc0JBQXNCO0lBQ3RCLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxnQkFBZ0IsRUFBRSxFQUFFLENBQUMsRUFBRTtRQUN6QyxNQUFNLE9BQU8sR0FBRyxpQkFBaUIsQ0FBQyxHQUFHLEVBQUUsY0FBYyxDQUFDLE1BQU0sRUFBRSxFQUFFLGNBQWMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO1FBQ3pGLE1BQU0sT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsRUFBRSxtQkFBbUIsRUFBRSxPQUFPLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQzdGLFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7S0FDeEI7SUFFRCx1Q0FBdUM7SUFDdkMsTUFBTSxHQUFHLEdBQUcsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ3pFLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxFQUFFLFFBQVEsRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM3RCxPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDbkUsQ0FBQyJ9

package/dest/utils/cheat_codes.d.ts

@@ -0,0 +1,199 @@
+import { AztecAddress, CircuitsWasm, EthAddress, Fr } from '@aztec/circuits.js';
+import { AztecRPC, NotePreimage } from '@aztec/types';
+/**
+ * A class that provides utility functions for interacting with the chain.
+ */
+export declare class CheatCodes {
+    /**
+     * The cheat codes for ethereum (L1).
+     */
+    eth: EthCheatCodes;
+    /**
+     * The cheat codes for aztec.
+     */
+    aztec: AztecCheatCodes;
+    constructor(
+    /**
+     * The cheat codes for ethereum (L1).
+     */
+    eth: EthCheatCodes, 
+    /**
+     * The cheat codes for aztec.
+     */
+    aztec: AztecCheatCodes);
+    static create(rpcUrl: string, aztecRpc: AztecRPC): Promise<CheatCodes>;
+}
+/**
+ * A class that provides utility functions for interacting with ethereum (L1).
+ */
+export declare class EthCheatCodes {
+    /**
+     * The RPC client to use for interacting with the chain
+     */
+    rpcUrl: string;
+    /**
+     * The logger to use for the eth cheatcodes
+     */
+    logger: import("@aztec/foundation/log").DebugLogger;
+    constructor(
+    /**
+     * The RPC client to use for interacting with the chain
+     */
+    rpcUrl: string, 
+    /**
+     * The logger to use for the eth cheatcodes
+     */
+    logger?: import("@aztec/foundation/log").DebugLogger);
+    rpcCall(method: string, params: any[]): Promise<any>;
+    /**
+     * Get the current blocknumber
+     * @returns The current block number
+     */
+    blockNumber(): Promise<number>;
+    /**
+     * Get the current chainId
+     * @returns The current chainId
+     */
+    chainId(): Promise<number>;
+    /**
+     * Get the current timestamp
+     * @returns The current timestamp
+     */
+    timestamp(): Promise<number>;
+    /**
+     * Advance the chain by a number of blocks
+     * @param numberOfBlocks - The number of blocks to mine
+     * @returns The current chainId
+     */
+    mine(numberOfBlocks?: number): Promise<void>;
+    /**
+     * Set the next block timestamp
+     * @param timestamp - The timestamp to set the next block to
+     */
+    setNextBlockTimestamp(timestamp: number): Promise<void>;
+    /**
+     * Dumps the current chain state to a file.
+     * @param fileName - The file name to dump state into
+     */
+    dumpChainState(fileName: string): Promise<void>;
+    /**
+     * Loads the chain state from a file.
+     * @param fileName - The file name to load state from
+     */
+    loadChainState(fileName: string): Promise<void>;
+    /**
+     * Load the value at a storage slot of a contract address on eth
+     * @param contract - The contract address
+     * @param slot - The storage slot
+     * @returns - The value at the storage slot
+     */
+    load(contract: EthAddress, slot: bigint): Promise<bigint>;
+    /**
+     * Set the value at a storage slot of a contract address on eth
+     * @param contract - The contract address
+     * @param slot - The storage slot
+     * @param value - The value to set the storage slot to
+     */
+    store(contract: EthAddress, slot: bigint, value: bigint): Promise<void>;
+    /**
+     * Computes the slot value for a given map and key.
+     * @param baseSlot - The base slot of the map (specified in Aztec.nr contract)
+     * @param key - The key to lookup in the map
+     * @returns The storage slot of the value in the map
+     */
+    keccak256(baseSlot: bigint, key: bigint): bigint;
+    /**
+     * Send transactions impersonating an externally owned account or contract.
+     * @param who - The address to impersonate
+     */
+    startImpersonating(who: EthAddress): Promise<void>;
+    /**
+     * Stop impersonating an account that you are currently impersonating.
+     * @param who - The address to stop impersonating
+     */
+    stopImpersonating(who: EthAddress): Promise<void>;
+    /**
+     * Set the bytecode for a contract
+     * @param contract - The contract address
+     * @param bytecode - The bytecode to set
+     */
+    etch(contract: EthAddress, bytecode: `0x${string}`): Promise<void>;
+    /**
+     * Get the bytecode for a contract
+     * @param contract - The contract address
+     * @returns The bytecode for the contract
+     */
+    getBytecode(contract: EthAddress): Promise<`0x${string}`>;
+}
+/**
+ * A class that provides utility functions for interacting with the aztec chain.
+ */
+export declare class AztecCheatCodes {
+    /**
+     * The RPC client to use for interacting with the chain
+     */
+    aztecRpc: AztecRPC;
+    /**
+     * The circuits wasm module used for pedersen hashing
+     */
+    wasm: CircuitsWasm;
+    /**
+     * The eth cheat codes.
+     */
+    eth: EthCheatCodes;
+    /**
+     * The logger to use for the aztec cheatcodes
+     */
+    logger: import("@aztec/foundation/log").DebugLogger;
+    constructor(
+    /**
+     * The RPC client to use for interacting with the chain
+     */
+    aztecRpc: AztecRPC, 
+    /**
+     * The circuits wasm module used for pedersen hashing
+     */
+    wasm: CircuitsWasm, 
+    /**
+     * The eth cheat codes.
+     */
+    eth: EthCheatCodes, 
+    /**
+     * The logger to use for the aztec cheatcodes
+     */
+    logger?: import("@aztec/foundation/log").DebugLogger);
+    /**
+     * Computes the slot value for a given map and key.
+     * @param baseSlot - The base slot of the map (specified in Aztec.nr contract)
+     * @param key - The key to lookup in the map
+     * @returns The storage slot of the value in the map
+     */
+    computeSlotInMap(baseSlot: Fr | bigint, key: Fr | bigint | AztecAddress): Fr;
+    /**
+     * Get the current blocknumber
+     * @returns The current block number
+     */
+    blockNumber(): Promise<number>;
+    /**
+     * Set time of the next execution on aztec.
+     * It also modifies time on eth for next execution and stores this time as the last rollup block on the rollup contract.
+     * @param to - The timestamp to set the next block to (must be greater than current time)
+     */
+    warp(to: number): Promise<void>;
+    /**
+     * Loads the value stored at the given slot in the public storage of the given contract.
+     * @param who - The address of the contract
+     * @param slot - The storage slot to lookup
+     * @returns The value stored at the given slot
+     */
+    loadPublic(who: AztecAddress, slot: Fr | bigint): Promise<Fr>;
+    /**
+     * Loads the value stored at the given slot in the private storage of the given contract.
+     * @param contract - The address of the contract
+     * @param owner - The owner for whom the notes are encrypted
+     * @param slot - The storage slot to lookup
+     * @returns The notes stored at the given slot
+     */
+    loadPrivate(owner: AztecAddress, contract: AztecAddress, slot: Fr | bigint): Promise<NotePreimage[]>;
+}
+//# sourceMappingURL=cheat_codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cheat_codes.d.ts","sourceRoot":"","sources":["../../src/utils/cheat_codes.ts"],"names":[],"mappings":"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"}