@aztec/aztec.js 0.0.0-test.0

package/dest/fee/fee_juice_payment_method_with_claim.js

@@ -0,0 +1,37 @@
+import { Fr } from '@aztec/foundation/fields';
+import { ProtocolContractAddress } from '@aztec/protocol-contracts';
+import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
+import { getFeeJuice } from '../contract/protocol_contracts.js';
+import { FeeJuicePaymentMethod } from './fee_juice_payment_method.js';
+/**
+ * Pay fee directly with Fee Juice claimed on the same tx.
+ */ export class FeeJuicePaymentMethodWithClaim extends FeeJuicePaymentMethod {
+    senderWallet;
+    claim;
+    constructor(senderWallet, claim){
+        super(senderWallet.getAddress()), this.senderWallet = senderWallet, this.claim = claim;
+    }
+    /**
+   * Creates a function call to pay the fee in Fee Juice.
+   * @returns A function call
+   */ async getFunctionCalls() {
+        const canonicalFeeJuice = await getFeeJuice(this.senderWallet);
+        const selector = await FunctionSelector.fromNameAndParameters(canonicalFeeJuice.artifact.functions.find((f)=>f.name === 'claim'));
+        return Promise.resolve([
+            {
+                to: ProtocolContractAddress.FeeJuice,
+                name: 'claim',
+                selector,
+                isStatic: false,
+                args: [
+                    this.senderWallet.getAddress().toField(),
+                    new Fr(this.claim.claimAmount),
+                    this.claim.claimSecret,
+                    new Fr(this.claim.messageLeafIndex)
+                ],
+                returnTypes: [],
+                type: FunctionType.PRIVATE
+            }
+        ]);
+    }
+}

package/dest/fee/fee_payment_method.d.ts

@@ -0,0 +1,22 @@
+import type { FunctionCall } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { GasSettings } from '@aztec/stdlib/gas';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */
+export interface FeePaymentMethod {
+    /** The asset used to pay the fee. */
+    getAsset(): Promise<AztecAddress>;
+    /**
+     * Creates a function call to pay the fee in the given asset.
+     * @param gasSettings - The gas limits and max fees.
+     * @returns The function call to pay the fee.
+     */
+    getFunctionCalls(gasSettings: GasSettings): Promise<FunctionCall[]>;
+    /**
+     * The expected fee payer for this tx.
+     * @param gasSettings - The gas limits and max fees.
+     */
+    getFeePayer(gasSettings: GasSettings): Promise<AztecAddress>;
+}
+//# sourceMappingURL=fee_payment_method.d.ts.map

package/dest/fee/fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/fee_payment_method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE;;;OAGG;IACH,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9D"}

package/dest/fee/fee_payment_method.js

@@ -0,0 +1,3 @@
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */ export { };

package/dest/fee/private_fee_payment_method.d.ts

@@ -0,0 +1,51 @@
+import { type FunctionCall } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { GasSettings } from '@aztec/stdlib/gas';
+import type { Wallet } from '../account/wallet.js';
+import type { FeePaymentMethod } from './fee_payment_method.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */
+export declare class PrivateFeePaymentMethod implements FeePaymentMethod {
+    /**
+     * Address which will hold the fee payment.
+     */
+    private paymentContract;
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    private wallet;
+    /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */
+    private setMaxFeeToOne;
+    private assetPromise;
+    constructor(
+    /**
+     * Address which will hold the fee payment.
+     */
+    paymentContract: AztecAddress, 
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    wallet: Wallet, 
+    /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */
+    setMaxFeeToOne?: boolean);
+    /**
+     * The asset used to pay the fee.
+     * @returns The asset used to pay the fee.
+     */
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    /**
+     * Creates a function call to pay the fee in the given asset.
+     * @param gasSettings - The gas settings.
+     * @returns The function call to pay the fee.
+     */
+    getFunctionCalls(gasSettings: GasSettings): Promise<FunctionCall[]>;
+}
+//# sourceMappingURL=private_fee_payment_method.d.ts.map

package/dest/fee/private_fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private_fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/private_fee_payment_method.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAI5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAEvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAEd;;;OAGG;IACH,OAAO,CAAC,cAAc;IAjBxB,OAAO,CAAC,YAAY,CAAsC;;IAGxD;;OAEG;IACK,eAAe,EAAE,YAAY;IAErC;;OAEG;IACK,MAAM,EAAE,MAAM;IAEtB;;;OAGG;IACK,cAAc,UAAQ;IAGhC;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAuCjC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAIpC;;;;OAIG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA+B1E"}

package/dest/fee/private_fee_payment_method.js

@@ -0,0 +1,103 @@
+import { Fr } from '@aztec/foundation/fields';
+import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
+import { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
+import { SignerlessWallet } from '../wallet/signerless_wallet.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */ export class PrivateFeePaymentMethod {
+    paymentContract;
+    wallet;
+    setMaxFeeToOne;
+    assetPromise;
+    constructor(/**
+     * Address which will hold the fee payment.
+     */ paymentContract, /**
+     * An auth witness provider to authorize fee payments
+     */ wallet, /**
+     * If true, the max fee will be set to 1.
+     * TODO(#7694): Remove this param once the lacking feature in TXE is implemented.
+     */ setMaxFeeToOne = false){
+        this.paymentContract = paymentContract;
+        this.wallet = wallet;
+        this.setMaxFeeToOne = setMaxFeeToOne;
+        this.assetPromise = null;
+    }
+    /**
+   * The asset used to pay the fee.
+   * @returns The asset used to pay the fee.
+   */ getAsset() {
+        if (!this.assetPromise) {
+            // We use signer-less wallet because this function could be triggered before the associated account is deployed.
+            const signerlessWallet = new SignerlessWallet(this.wallet);
+            const interaction = new ContractFunctionInteraction(signerlessWallet, this.paymentContract, {
+                name: 'get_accepted_asset',
+                functionType: FunctionType.PRIVATE,
+                isInternal: false,
+                isStatic: false,
+                parameters: [],
+                returnTypes: [
+                    {
+                        kind: 'struct',
+                        path: 'authwit::aztec::protocol_types::address::aztec_address::AztecAddress',
+                        fields: [
+                            {
+                                name: 'inner',
+                                type: {
+                                    kind: 'field'
+                                }
+                            }
+                        ]
+                    }
+                ],
+                errorTypes: {},
+                isInitializer: false
+            }, []);
+            this.assetPromise = interaction.simulate();
+        }
+        return this.assetPromise;
+    }
+    getFeePayer() {
+        return Promise.resolve(this.paymentContract);
+    }
+    /**
+   * Creates a function call to pay the fee in the given asset.
+   * @param gasSettings - The gas settings.
+   * @returns The function call to pay the fee.
+   */ async getFunctionCalls(gasSettings) {
+        // We assume 1:1 exchange rate between fee juice and token. But in reality you would need to convert feeLimit
+        // (maxFee) to be in token denomination.
+        const maxFee = this.setMaxFeeToOne ? Fr.ONE : gasSettings.getFeeLimit();
+        const nonce = Fr.random();
+        await this.wallet.createAuthWit({
+            caller: this.paymentContract,
+            action: {
+                name: 'transfer_to_public',
+                args: [
+                    this.wallet.getAddress().toField(),
+                    this.paymentContract.toField(),
+                    maxFee,
+                    nonce
+                ],
+                selector: await FunctionSelector.fromSignature('transfer_to_public((Field),(Field),u128,Field)'),
+                type: FunctionType.PRIVATE,
+                isStatic: false,
+                to: await this.getAsset(),
+                returnTypes: []
+            }
+        });
+        return [
+            {
+                name: 'fee_entrypoint_private',
+                to: this.paymentContract,
+                selector: await FunctionSelector.fromSignature('fee_entrypoint_private(u128,Field)'),
+                type: FunctionType.PRIVATE,
+                isStatic: false,
+                args: [
+                    maxFee,
+                    nonce
+                ],
+                returnTypes: []
+            }
+        ];
+    }
+}

package/dest/fee/public_fee_payment_method.d.ts

@@ -0,0 +1,41 @@
+import type { FunctionCall } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { GasSettings } from '@aztec/stdlib/gas';
+import type { AccountWallet } from '../wallet/account_wallet.js';
+import type { FeePaymentMethod } from './fee_payment_method.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */
+export declare class PublicFeePaymentMethod implements FeePaymentMethod {
+    /**
+     * Address which will hold the fee payment.
+     */
+    protected paymentContract: AztecAddress;
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    protected wallet: AccountWallet;
+    private assetPromise;
+    constructor(
+    /**
+     * Address which will hold the fee payment.
+     */
+    paymentContract: AztecAddress, 
+    /**
+     * An auth witness provider to authorize fee payments
+     */
+    wallet: AccountWallet);
+    /**
+     * The asset used to pay the fee.
+     * @returns The asset used to pay the fee.
+     */
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    /**
+     * Creates a function call to pay the fee in the given asset.
+     * @param gasSettings - The gas settings.
+     * @returns The function call to pay the fee.
+     */
+    getFunctionCalls(gasSettings: GasSettings): Promise<FunctionCall[]>;
+}
+//# sourceMappingURL=public_fee_payment_method.d.ts.map

package/dest/fee/public_fee_payment_method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_fee_payment_method.d.ts","sourceRoot":"","sources":["../../src/fee/public_fee_payment_method.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAI3D;;OAEG;IACH,SAAS,CAAC,eAAe,EAAE,YAAY;IACvC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa;IAVjC,OAAO,CAAC,YAAY,CAAsC;;IAGxD;;OAEG;IACO,eAAe,EAAE,YAAY;IACvC;;OAEG;IACO,MAAM,EAAE,aAAa;IAGjC;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAuCjC,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAIpC;;;;OAIG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAiC1E"}

package/dest/fee/public_fee_payment_method.js

@@ -0,0 +1,97 @@
+import { Fr } from '@aztec/foundation/fields';
+import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
+import { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
+import { SignerlessWallet } from '../wallet/signerless_wallet.js';
+/**
+ * Holds information about how the fee for a transaction is to be paid.
+ */ export class PublicFeePaymentMethod {
+    paymentContract;
+    wallet;
+    assetPromise;
+    constructor(/**
+     * Address which will hold the fee payment.
+     */ paymentContract, /**
+     * An auth witness provider to authorize fee payments
+     */ wallet){
+        this.paymentContract = paymentContract;
+        this.wallet = wallet;
+        this.assetPromise = null;
+    }
+    /**
+   * The asset used to pay the fee.
+   * @returns The asset used to pay the fee.
+   */ getAsset() {
+        if (!this.assetPromise) {
+            // We use signer-less wallet because this function could be triggered before the associated account is deployed.
+            const signerlessWallet = new SignerlessWallet(this.wallet);
+            const interaction = new ContractFunctionInteraction(signerlessWallet, this.paymentContract, {
+                name: 'get_accepted_asset',
+                functionType: FunctionType.PRIVATE,
+                isInternal: false,
+                isStatic: false,
+                parameters: [],
+                returnTypes: [
+                    {
+                        kind: 'struct',
+                        path: 'authwit::aztec::protocol_types::address::aztec_address::AztecAddress',
+                        fields: [
+                            {
+                                name: 'inner',
+                                type: {
+                                    kind: 'field'
+                                }
+                            }
+                        ]
+                    }
+                ],
+                errorTypes: {},
+                isInitializer: false
+            }, []);
+            this.assetPromise = interaction.simulate();
+        }
+        return this.assetPromise;
+    }
+    getFeePayer() {
+        return Promise.resolve(this.paymentContract);
+    }
+    /**
+   * Creates a function call to pay the fee in the given asset.
+   * @param gasSettings - The gas settings.
+   * @returns The function call to pay the fee.
+   */ async getFunctionCalls(gasSettings) {
+        const nonce = Fr.random();
+        const maxFee = gasSettings.getFeeLimit();
+        const setPublicAuthWitInteraction = await this.wallet.setPublicAuthWit({
+            caller: this.paymentContract,
+            action: {
+                name: 'transfer_in_public',
+                args: [
+                    this.wallet.getAddress().toField(),
+                    this.paymentContract.toField(),
+                    maxFee,
+                    nonce
+                ],
+                selector: await FunctionSelector.fromSignature('transfer_in_public((Field),(Field),u128,Field)'),
+                type: FunctionType.PUBLIC,
+                isStatic: false,
+                to: await this.getAsset(),
+                returnTypes: []
+            }
+        }, true);
+        return [
+            await setPublicAuthWitInteraction.request(),
+            {
+                name: 'fee_entrypoint_public',
+                to: this.paymentContract,
+                selector: await FunctionSelector.fromSignature('fee_entrypoint_public(u128,Field)'),
+                type: FunctionType.PRIVATE,
+                isStatic: false,
+                args: [
+                    maxFee,
+                    nonce
+                ],
+                returnTypes: []
+            }
+        ];
+    }
+}

package/dest/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * This is our public api.
+ * Do NOT "export * from ..." here.
+ * Everything here should be explicit, to ensure we can clearly see everything we're exposing to the world.
+ * If it's exposed, people will use it, and then we can't remove/change the api without breaking client code.
+ * At the time of writing we overexpose things that should only be internal.
+ *
+ * TODO: Review and narrow scope of public api.
+ * We should also consider exposing subsections of the api via package.json exports, like we do with foundation.
+ * This can allow consumers to import much smaller parts of the library to incur less overhead.
+ * It will also allow web bundlers do perform intelligent chunking of bundles etc.
+ * Some work as been done on this within the api folder, providing the alternative import style of e.g.:
+ * ```typescript
+ *   import { TxHash } from '@aztec.js/tx_hash'
+ *   import { type ContractArtifact, type FunctionArtifact, FunctionSelector } from '@aztec/aztec.js/abi';
+ *   import { AztecAddress } from '@aztec/aztec.js/addresses';
+ *   import { EthAddress } from '@aztec/aztec.js/eth_address';
+ * ```
+ *
+ * TODO: Ultimately reimplement this mega exporter by mega exporting a granular api (then deprecate it).
+ */
+export { ContractDeployer } from './deployment/index.js';
+export { NoteSelector } from '@aztec/stdlib/abi';
+export { createCompatibleClient, createPXEClient } from './rpc_clients/index.js';
+export { type DeployAccountOptions } from './account_manager/index.js';
+export { AccountWallet, AccountWalletWithSecretKey, SignerlessWallet } from './wallet/index.js';
+export { EthAddress } from '@aztec/foundation/eth-address';
+export { Fq, Fr, Point, GrumpkinScalar } from '@aztec/foundation/fields';
+export { SiblingPath } from '@aztec/foundation/trees';
+export { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
+export { type PartialAddress, type ContractClassWithId, type ContractInstanceWithAddress, getContractClassFromArtifact, getContractInstanceFromDeployParams, type NodeInfo, } from '@aztec/stdlib/contract';
+export { MerkleTreeId, merkleTreeIds } from '@aztec/stdlib/trees';
+export { type PublicKey, PublicKeys } from '@aztec/stdlib/keys';
+export { computeSecretHash } from '@aztec/stdlib/hash';
+export { computeAppNullifierSecretKey, deriveKeys, deriveMasterIncomingViewingSecretKey, deriveMasterNullifierSecretKey, } from '@aztec/stdlib/keys';
+export { AuthWitness } from '@aztec/stdlib/auth-witness';
+export { getTimestampRangeForEpoch } from '@aztec/stdlib/epoch-helpers';
+export { FunctionCall } from '@aztec/stdlib/abi';
+export { Tx, TxExecutionRequest, TxHash, TxReceipt, TxStatus, Capsule, HashedValues, GlobalVariables, } from '@aztec/stdlib/tx';
+export { Body, L2Block } from '@aztec/stdlib/block';
+export { L1NotePayload, LogId, type LogFilter, EncryptedLogPayload } from '@aztec/stdlib/logs';
+export { L1EventPayload, EventMetadata } from '@aztec/stdlib/event';
+export { L1ToL2Message, L2Actor, L1Actor } from '@aztec/stdlib/messaging';
+export { UniqueNote, ExtendedNote, Comparator, Note } from '@aztec/stdlib/note';
+export { type PXE, EventType } from '@aztec/stdlib/interfaces/client';
+export { ProtocolContractAddress } from '@aztec/protocol-contracts';
+export { decodeFromAbi, encodeArguments, type AbiType } from '@aztec/stdlib/abi';
+export { toBigIntBE } from '@aztec/foundation/bigint-buffer';
+export { sha256, Grumpkin, Schnorr } from '@aztec/foundation/crypto';
+export { makeFetch } from '@aztec/foundation/json-rpc/client';
+export { retry, retryUntil } from '@aztec/foundation/retry';
+export { to2Fields, toBigInt } from '@aztec/foundation/serialize';
+export { sleep } from '@aztec/foundation/sleep';
+export { elapsed } from '@aztec/foundation/timer';
+export { type FieldsOf } from '@aztec/foundation/types';
+export { fileURLToPath } from '@aztec/foundation/url';
+export * from './api/abi.js';
+export * from './api/account.js';
+export * from './api/addresses.js';
+export * from './api/cheat_codes.js';
+export * from './api/ethereum/index.js';
+export * from './api/fee.js';
+export * from './api/log.js';
+export * from './contract/index.js';
+export * from './utils/index.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":"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"}

package/dest/index.js

@@ -0,0 +1,69 @@
+/**
+ * This is our public api.
+ * Do NOT "export * from ..." here.
+ * Everything here should be explicit, to ensure we can clearly see everything we're exposing to the world.
+ * If it's exposed, people will use it, and then we can't remove/change the api without breaking client code.
+ * At the time of writing we overexpose things that should only be internal.
+ *
+ * TODO: Review and narrow scope of public api.
+ * We should also consider exposing subsections of the api via package.json exports, like we do with foundation.
+ * This can allow consumers to import much smaller parts of the library to incur less overhead.
+ * It will also allow web bundlers do perform intelligent chunking of bundles etc.
+ * Some work as been done on this within the api folder, providing the alternative import style of e.g.:
+ * ```typescript
+ *   import { TxHash } from '@aztec.js/tx_hash'
+ *   import { type ContractArtifact, type FunctionArtifact, FunctionSelector } from '@aztec/aztec.js/abi';
+ *   import { AztecAddress } from '@aztec/aztec.js/addresses';
+ *   import { EthAddress } from '@aztec/aztec.js/eth_address';
+ * ```
+ *
+ * TODO: Ultimately reimplement this mega exporter by mega exporting a granular api (then deprecate it).
+ */ export { ContractDeployer } from './deployment/index.js';
+export { NoteSelector } from '@aztec/stdlib/abi';
+export { createCompatibleClient, createPXEClient } from './rpc_clients/index.js';
+export { AccountWallet, AccountWalletWithSecretKey, SignerlessWallet } from './wallet/index.js';
+export { EthAddress } from '@aztec/foundation/eth-address';
+export { Fq, Fr, Point, GrumpkinScalar } from '@aztec/foundation/fields';
+export { SiblingPath } from '@aztec/foundation/trees';
+export { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
+export { getContractClassFromArtifact, getContractInstanceFromDeployParams } from '@aztec/stdlib/contract';
+export { MerkleTreeId, merkleTreeIds } from '@aztec/stdlib/trees';
+export { PublicKeys } from '@aztec/stdlib/keys';
+export { computeSecretHash } from '@aztec/stdlib/hash';
+export { computeAppNullifierSecretKey, deriveKeys, deriveMasterIncomingViewingSecretKey, deriveMasterNullifierSecretKey } from '@aztec/stdlib/keys';
+export { AuthWitness } from '@aztec/stdlib/auth-witness';
+export { getTimestampRangeForEpoch } from '@aztec/stdlib/epoch-helpers';
+export { FunctionCall } from '@aztec/stdlib/abi';
+export { Tx, TxExecutionRequest, TxHash, TxReceipt, TxStatus, Capsule, HashedValues, GlobalVariables } from '@aztec/stdlib/tx';
+export { Body, L2Block } from '@aztec/stdlib/block';
+export { L1NotePayload, LogId, EncryptedLogPayload } from '@aztec/stdlib/logs';
+export { L1EventPayload, EventMetadata } from '@aztec/stdlib/event';
+export { L1ToL2Message, L2Actor, L1Actor } from '@aztec/stdlib/messaging';
+export { UniqueNote, ExtendedNote, Comparator, Note } from '@aztec/stdlib/note';
+export { EventType } from '@aztec/stdlib/interfaces/client';
+export { ProtocolContractAddress } from '@aztec/protocol-contracts';
+// TODO: These kinds of things have no place on our public api.
+// External devs will almost certainly have their own methods of doing these things.
+// If we want to use them in our own "aztec.js consuming code", import them from foundation as needed.
+export { decodeFromAbi, encodeArguments } from '@aztec/stdlib/abi';
+export { toBigIntBE } from '@aztec/foundation/bigint-buffer';
+export { sha256, Grumpkin, Schnorr } from '@aztec/foundation/crypto';
+export { makeFetch } from '@aztec/foundation/json-rpc/client';
+export { retry, retryUntil } from '@aztec/foundation/retry';
+export { to2Fields, toBigInt } from '@aztec/foundation/serialize';
+export { sleep } from '@aztec/foundation/sleep';
+export { elapsed } from '@aztec/foundation/timer';
+export { fileURLToPath } from '@aztec/foundation/url';
+// Start of section that exports public api via granular api.
+// Here you *can* do `export *` as the granular api defacto exports things explicitly.
+// This entire index file will be deprecated at some point after we're satisfied.
+export * from './api/abi.js';
+export * from './api/account.js';
+export * from './api/addresses.js';
+export * from './api/cheat_codes.js';
+export * from './api/ethereum/index.js';
+export * from './api/fee.js';
+export * from './api/log.js';
+// Granular export, even if not in the api folder
+export * from './contract/index.js';
+export * from './utils/index.js';

package/dest/rpc_clients/index.d.ts

@@ -0,0 +1,3 @@
+export * from './pxe_client.js';
+export * from './node/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc_clients/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dest/rpc_clients/index.js

@@ -0,0 +1,2 @@
+export * from './pxe_client.js';
+export * from './node/index.js';

package/dest/rpc_clients/node/index.d.ts

@@ -0,0 +1,12 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { PXE } from '@aztec/stdlib/interfaces/client';
+import type { ComponentsVersions } from '@aztec/stdlib/versioning';
+/**
+ * Creates a PXE client with a given set of retries on non-server errors.
+ * Checks that PXE matches the expected version, and warns if not.
+ * @param rpcUrl - URL of the RPC server wrapping the PXE.
+ * @param _logger - Debug logger to warn version incompatibilities.
+ * @returns A PXE client.
+ */
+export declare function createCompatibleClient(rpcUrl: string, logger?: Logger, versions?: Partial<ComponentsVersions>): Promise<PXE>;
+//# sourceMappingURL=index.d.ts.map

package/dest/rpc_clients/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rpc_clients/node/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA+CnE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAA2C,EACnD,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACzC,OAAO,CAAC,GAAG,CAAC,CAcd"}

package/dest/rpc_clients/node/index.js

@@ -0,0 +1,78 @@
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+import { createLogger } from '@aztec/foundation/log';
+import { NoRetryError, makeBackoff, retry } from '@aztec/foundation/retry';
+import { Axios } from 'axios';
+import { inspect } from 'util';
+import { createPXEClient } from '../pxe_client.js';
+/**
+ * A fetch implementation using axios.
+ * @param host - The URL of the host.
+ * @param rpcMethod - The RPC method to call.
+ * @param body - The body of the request.
+ * @param useApiEndpoints - Whether to use the API endpoints or inject the method in the body.
+ * @returns The response data.
+ */ async function axiosFetch(host, rpcMethod, body, useApiEndpoints) {
+    const request = new Axios({
+        headers: {
+            'content-type': 'application/json'
+        },
+        transformRequest: [
+            (data)=>jsonStringify(data)
+        ],
+        transformResponse: [
+            (data)=>JSON.parse(data)
+        ]
+    });
+    const [url, content] = useApiEndpoints ? [
+        `${host}/${rpcMethod}`,
+        body
+    ] : [
+        host,
+        {
+            ...body,
+            method: rpcMethod
+        }
+    ];
+    const resp = await request.post(url, content).catch((error)=>{
+        if (error.response) {
+            return error.response;
+        }
+        const errorMessage = `Error fetching from host ${host} with method ${rpcMethod}: ${inspect(error)}`;
+        throw new Error(errorMessage);
+    });
+    const isOK = resp.status >= 200 && resp.status < 300;
+    if (isOK) {
+        const headers = {
+            get: (header)=>typeof resp.headers.get === 'function' ? resp.headers.get(header)?.toString() : undefined
+        };
+        return {
+            response: resp.data,
+            headers
+        };
+    } else {
+        const errorMessage = `Error ${resp.status} from json-rpc server ${host} on ${rpcMethod}: ${resp.data.error.message}`;
+        if (resp.status >= 400 && resp.status < 500) {
+            throw new NoRetryError(errorMessage);
+        } else {
+            throw new Error(errorMessage);
+        }
+    }
+}
+/**
+ * Creates a PXE client with a given set of retries on non-server errors.
+ * Checks that PXE matches the expected version, and warns if not.
+ * @param rpcUrl - URL of the RPC server wrapping the PXE.
+ * @param _logger - Debug logger to warn version incompatibilities.
+ * @returns A PXE client.
+ */ export function createCompatibleClient(rpcUrl, logger = createLogger('aztecjs:pxe_client'), versions = {}) {
+    // Use axios due to timeout issues with fetch when proving TXs.
+    const fetch = async (host, rpcMethod, body, useApiEndpoints)=>{
+        return await retry(()=>axiosFetch(host, rpcMethod, body, useApiEndpoints), `JsonRpcClient request ${rpcMethod} to ${host}`, makeBackoff([
+            1,
+            2,
+            3
+        ]), logger, false);
+    };
+    const pxe = createPXEClient(rpcUrl, versions, fetch);
+    return Promise.resolve(pxe);
+}

package/dest/rpc_clients/pxe_client.d.ts

@@ -0,0 +1,10 @@
+import { type PXE } from '@aztec/stdlib/interfaces/client';
+import { type ComponentsVersions } from '@aztec/stdlib/versioning';
+/**
+ * Creates a JSON-RPC client to remotely talk to PXE.
+ * @param url - The URL of the PXE.
+ * @param fetch - The fetch implementation to use.
+ * @returns A JSON-RPC client of PXE.
+ */
+export declare function createPXEClient(url: string, versions?: Partial<ComponentsVersions>, fetch?: typeof import("@aztec/foundation/json-rpc/client").defaultFetch): PXE;
+//# sourceMappingURL=pxe_client.d.ts.map

package/dest/rpc_clients/pxe_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pxe_client.d.ts","sourceRoot":"","sources":["../../src/rpc_clients/pxe_client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,GAAG,EAAa,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,0BAA0B,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,kEAA8B,GAClC,GAAG,CASL"}