@wonderland/aztec-fee-payment 0.0.0 → 4.1.0-rc.4

package/LICENSE

@@ -1,6 +1,21 @@
 MIT License
 
-Copyright (c) 2025
+Copyright (c) 2025 Wonderland
+
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction...
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,128 @@
-# Package Placeholder
+# Aztec Fee Payment Contracts
 
-Reserved package name. Actual code will be published in a later version.
+A Fee Payment Contract (FPC) for Aztec that enables transaction fee sponsorship via bridged FeeJuice.
+
+## Overview
+
+| Contract | Description | Auth model |
+|----------|-------------|-----------|
+| **BridgedFPC** | Fully private. Users bridge FeeJuice from L1; the bridge claim converts to internal wFJ balance for fee sponsorship. | Cryptographic bridge proof (no owner, no agent) |
+
+## Project Structure
+
+```
+├── src/
+│   ├── artifacts/                   # Generated contract bindings
+│   ├── nr/                          # Noir smart contracts
+│   │   ├── counter_contract/        # Test utility contract
+│   │   └── bridged_contract/        # BridgedFPC
+│   └── ts/                          # TypeScript package
+│       ├── fee-payment-methods/     # Fee payment method classes
+│       ├── utils/                   # Utilities (gas, deploy)
+│       └── test/                    # Integration tests
+├── target/                          # Compiled contract artifacts
+├── benchmarks/                      # Performance benchmarks
+└── docs/                            # Product requirements
+```
+
+## Setup
+
+### Prerequisites
+
+- [Aztec Sandbox](https://docs.aztec.network/getting_started) v3.0.0 or later
+- Node.js 22+
+- Yarn 1.22+
+
+### Installation
+
+```bash
+yarn install
+```
+
+### Compile Contracts
+
+```bash
+# Full rebuild: compile Noir + generate TS bindings
+yarn ccc
+
+# Or step by step
+aztec compile
+aztec codegen target --outdir src/artifacts
+```
+
+## Testing
+
+Start the Aztec sandbox:
+
+```bash
+aztec start --local-network
+```
+
+Run all tests:
+
+```bash
+yarn test        # Noir unit tests + JS integration tests
+yarn test:nr     # Noir unit tests only
+yarn test:js     # JS integration tests only
+```
+
+## External Usage
+
+See [src/ts/README.md](src/ts/README.md) for detailed documentation on using the published NPM package.
+
+```bash
+yarn add @defi-wonderland/aztec-fee-payment
+```
+
+### BridgedFPC
+
+Fully private; no owner and no off-chain agent. Users bridge FeeJuice from L1 to the FPC address, then call `mint` to convert the bridge claim into private wFJ balance.
+
+```typescript
+import {
+  BridgedFPCContract,
+  FPCFeePaymentMethod,
+  BridgedMintAndPayFeePaymentMethod,
+  registerBridgedContract,
+} from '@defi-wonderland/aztec-fee-payment';
+
+// Register the BridgedFPC — no deployment transaction needed (fully private contract)
+const fpc = await registerBridgedContract(wallet);
+
+// --- L1: deposit to FeeJuicePortal with a claimer-bound secretHash ---
+// secretHash = computeSecretHash(poseidon2([salt, claimerAddress], DOM_SEP))
+// FeeJuicePortal.depositToAztecPublic(_to=fpc.address, _amount, secretHash)
+
+// --- L2: two-step flow ---
+// Step 1: claim FeeJuice on L2 (emits FeeJuice nullifier)
+await feeJuice.methods.claim(fpc.address, amount, secret, leafIndex).send();
+
+// Step 2: mint internal wFJ balance by proving the bridge claim
+await fpc.methods.mint(amount, salt, leafIndex).send();
+
+// User sponsors a transaction from their internal balance
+await myContract.methods.doSomething()
+  .send({ fee: { paymentMethod: new FPCFeePaymentMethod(fpc.address) } });
+
+// --- Cold-start: claim + mint + pay fee in one transaction ---
+await myContract.methods.doSomething()
+  .send({
+    fee: {
+      paymentMethod: new BridgedMintAndPayFeePaymentMethod(
+        fpc.address, amount, secret, salt, leafIndex,
+      ),
+    },
+  });
+```
+
+## Benchmarks
+
+```bash
+yarn benchmark
+```
+
+Benchmarks are defined in `Nargo.toml` under `[benchmark]` and run against a live local network. Each contract has its own benchmark file in `benchmarks/`.
+
+## License
+
+MIT

package/dist/src/artifacts/BridgedFPC.d.ts

@@ -0,0 +1,67 @@
+import { AztecAddress } from '@aztec/aztec.js/addresses';
+import { type AztecAddressLike, type ContractArtifact, type FieldLike } from '@aztec/aztec.js/abi';
+import { ContractBase, ContractFunctionInteraction, type ContractMethod, type ContractStorageLayout, DeployMethod } from '@aztec/aztec.js/contracts';
+import { PublicKeys } from '@aztec/aztec.js/keys';
+import type { Wallet } from '@aztec/aztec.js/wallet';
+export declare const BridgedFPCContractArtifact: ContractArtifact;
+/**
+ * Type-safe interface for contract BridgedFPC;
+ */
+export declare class BridgedFPCContract extends ContractBase {
+    private constructor();
+    /**
+     * Creates a contract instance.
+     * @param address - The deployed contract's address.
+     * @param wallet - The wallet to use when interacting with the contract.
+     * @returns A new Contract instance.
+     */
+    static at(address: AztecAddress, wallet: Wallet): BridgedFPCContract;
+    /**
+     * Creates a tx to deploy a new instance of this contract.
+     */
+    static deploy(wallet: Wallet): DeployMethod<BridgedFPCContract>;
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified public keys hash to derive the address.
+     */
+    static deployWithPublicKeys(publicKeys: PublicKeys, wallet: Wallet): DeployMethod<BridgedFPCContract>;
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified constructor method.
+     */
+    static deployWithOpts<M extends keyof BridgedFPCContract['methods']>(opts: {
+        publicKeys?: PublicKeys;
+        method?: M;
+        wallet: Wallet;
+    }, ...args: Parameters<BridgedFPCContract['methods'][M]>): DeployMethod<BridgedFPCContract>;
+    /**
+     * Returns this contract's artifact.
+     */
+    static get artifact(): ContractArtifact;
+    /**
+     * Returns this contract's artifact with public bytecode.
+     */
+    static get artifactForPublic(): ContractArtifact;
+    static get storage(): ContractStorageLayout<'balances'>;
+    /** Type-safe wrappers for the public methods exposed by the contract. */
+    methods: {
+        /** balance_of(account: struct) */
+        balance_of: ((account: AztecAddressLike) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** mint(amount: integer, salt: field, leaf_index: field) */
+        mint: ((amount: (bigint | number), salt: FieldLike, leaf_index: FieldLike) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** mint_and_pay_fee(amount: integer, salt: field, leaf_index: field) */
+        mint_and_pay_fee: ((amount: (bigint | number), salt: FieldLike, leaf_index: FieldLike) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** pay_fee() */
+        pay_fee: (() => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** process_message(message_ciphertext: struct, message_context: struct) */
+        process_message: ((message_ciphertext: FieldLike[], message_context: {
+            tx_hash: FieldLike;
+            unique_note_hashes_in_tx: FieldLike[];
+            first_nullifier_in_tx: FieldLike;
+            recipient: AztecAddressLike;
+        }) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** public_dispatch(selector: field) */
+        public_dispatch: ((selector: FieldLike) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** sync_state() */
+        sync_state: (() => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+    };
+}
+//# sourceMappingURL=BridgedFPC.d.ts.map

package/dist/src/artifacts/BridgedFPC.d.ts.map

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

package/dist/src/artifacts/BridgedFPC.js

@@ -0,0 +1,62 @@
+/* Autogenerated file, do not edit! */
+import { loadContractArtifact, loadContractArtifactForPublic } from '@aztec/aztec.js/abi';
+import { Contract, ContractBase, DeployMethod } from '@aztec/aztec.js/contracts';
+import { Fr } from '@aztec/aztec.js/fields';
+import { PublicKeys } from '@aztec/aztec.js/keys';
+import BridgedFPCContractArtifactJson from '../../target/bridged_contract-BridgedFPC.json' with { type: 'json' };
+export const BridgedFPCContractArtifact = loadContractArtifact(BridgedFPCContractArtifactJson);
+/**
+ * Type-safe interface for contract BridgedFPC;
+ */
+export class BridgedFPCContract extends ContractBase {
+    constructor(address, wallet) {
+        super(address, BridgedFPCContractArtifact, wallet);
+    }
+    /**
+     * Creates a contract instance.
+     * @param address - The deployed contract's address.
+     * @param wallet - The wallet to use when interacting with the contract.
+     * @returns A new Contract instance.
+     */
+    static at(address, wallet) {
+        return Contract.at(address, BridgedFPCContract.artifact, wallet);
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract.
+     */
+    static deploy(wallet) {
+        return new DeployMethod(PublicKeys.default(), wallet, BridgedFPCContractArtifact, (instance, wallet) => BridgedFPCContract.at(instance.address, wallet), Array.from(arguments).slice(1));
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified public keys hash to derive the address.
+     */
+    static deployWithPublicKeys(publicKeys, wallet) {
+        return new DeployMethod(publicKeys, wallet, BridgedFPCContractArtifact, (instance, wallet) => BridgedFPCContract.at(instance.address, wallet), Array.from(arguments).slice(2));
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified constructor method.
+     */
+    static deployWithOpts(opts, ...args) {
+        return new DeployMethod(opts.publicKeys ?? PublicKeys.default(), opts.wallet, BridgedFPCContractArtifact, (instance, wallet) => BridgedFPCContract.at(instance.address, wallet), Array.from(arguments).slice(1), opts.method ?? 'constructor');
+    }
+    /**
+     * Returns this contract's artifact.
+     */
+    static get artifact() {
+        return BridgedFPCContractArtifact;
+    }
+    /**
+     * Returns this contract's artifact with public bytecode.
+     */
+    static get artifactForPublic() {
+        return loadContractArtifactForPublic(BridgedFPCContractArtifactJson);
+    }
+    static get storage() {
+        return {
+            balances: {
+                slot: new Fr(1n),
+            }
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQnJpZGdlZEZQQy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcnRpZmFjdHMvQnJpZGdlZEZQQy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxzQ0FBc0M7QUFJdEMsT0FBTyxFQUE0SixvQkFBb0IsRUFBRSw2QkFBNkIsRUFBb0YsTUFBTSxxQkFBcUIsQ0FBQztBQUN0VSxPQUFPLEVBQUUsUUFBUSxFQUFFLFlBQVksRUFBZ0YsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFFL0osT0FBTyxFQUFFLEVBQUUsRUFBUyxNQUFNLHdCQUF3QixDQUFDO0FBQ25ELE9BQU8sRUFBa0IsVUFBVSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFFbEUsT0FBTyw4QkFBOEIsTUFBTSwrQ0FBK0MsQ0FBQyxPQUFPLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztBQUNqSCxNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyxvQkFBb0IsQ0FBQyw4QkFBc0QsQ0FBQyxDQUFDO0FBSXZIOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFtQixTQUFRLFlBQVk7SUFFbEQsWUFDRSxPQUFxQixFQUNyQixNQUFjO1FBRWQsS0FBSyxDQUFDLE9BQU8sRUFBRSwwQkFBMEIsRUFBRSxNQUFNLENBQUMsQ0FBQztJQUNyRCxDQUFDO0lBSUQ7Ozs7O09BS0c7SUFDSSxNQUFNLENBQUMsRUFBRSxDQUNkLE9BQXFCLEVBQ3JCLE1BQWM7UUFFZCxPQUFPLFFBQVEsQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLGtCQUFrQixDQUFDLFFBQVEsRUFBRSxNQUFNLENBQXVCLENBQUM7SUFDekYsQ0FBQztJQUdEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFjO1FBQ2pDLE9BQU8sSUFBSSxZQUFZLENBQXFCLFVBQVUsQ0FBQyxPQUFPLEVBQUUsRUFBRSxNQUFNLEVBQUUsMEJBQTBCLEVBQUUsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxrQkFBa0IsQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQy9NLENBQUM7SUFFRDs7T0FFRztJQUNJLE1BQU0sQ0FBQyxvQkFBb0IsQ0FBQyxVQUFzQixFQUFFLE1BQWM7UUFDdkUsT0FBTyxJQUFJLFlBQVksQ0FBcUIsVUFBVSxFQUFFLE1BQU0sRUFBRSwwQkFBMEIsRUFBRSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDLGtCQUFrQixDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsT0FBTyxFQUFFLE1BQU0sQ0FBQyxFQUFFLEtBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDck0sQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLGNBQWMsQ0FDMUIsSUFBNkQsRUFDN0QsR0FBRyxJQUFrRDtRQUVyRCxPQUFPLElBQUksWUFBWSxDQUNyQixJQUFJLENBQUMsVUFBVSxJQUFJLFVBQVUsQ0FBQyxPQUFPLEVBQUUsRUFDdkMsSUFBSSxDQUFDLE1BQU0sRUFDWCwwQkFBMEIsRUFDMUIsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxrQkFBa0IsQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsRUFDckUsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQzlCLElBQUksQ0FBQyxNQUFNLElBQUksYUFBYSxDQUM3QixDQUFDO0lBQ0osQ0FBQztJQUlEOztPQUVHO0lBQ0ksTUFBTSxLQUFLLFFBQVE7UUFDeEIsT0FBTywwQkFBMEIsQ0FBQztJQUNwQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLEtBQUssaUJBQWlCO1FBQ2pDLE9BQU8sNkJBQTZCLENBQUMsOEJBQXNELENBQUMsQ0FBQztJQUMvRixDQUFDO0lBR00sTUFBTSxLQUFLLE9BQU87UUFDckIsT0FBTztZQUNMLFFBQVEsRUFBRTtnQkFDWixJQUFJLEVBQUUsSUFBSSxFQUFFLENBQUMsRUFBRSxDQUFDO2FBQ2pCO1NBQ3VDLENBQUM7SUFDekMsQ0FBQztDQTZCSiJ9

package/dist/src/artifacts/Counter.d.ts

@@ -0,0 +1,63 @@
+import { AztecAddress } from '@aztec/aztec.js/addresses';
+import { type AztecAddressLike, type ContractArtifact, type FieldLike } from '@aztec/aztec.js/abi';
+import { ContractBase, ContractFunctionInteraction, type ContractMethod, type ContractStorageLayout, DeployMethod } from '@aztec/aztec.js/contracts';
+import { PublicKeys } from '@aztec/aztec.js/keys';
+import type { Wallet } from '@aztec/aztec.js/wallet';
+export declare const CounterContractArtifact: ContractArtifact;
+/**
+ * Type-safe interface for contract Counter;
+ */
+export declare class CounterContract extends ContractBase {
+    private constructor();
+    /**
+     * Creates a contract instance.
+     * @param address - The deployed contract's address.
+     * @param wallet - The wallet to use when interacting with the contract.
+     * @returns A new Contract instance.
+     */
+    static at(address: AztecAddress, wallet: Wallet): CounterContract;
+    /**
+     * Creates a tx to deploy a new instance of this contract.
+     */
+    static deploy(wallet: Wallet): DeployMethod<CounterContract>;
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified public keys hash to derive the address.
+     */
+    static deployWithPublicKeys(publicKeys: PublicKeys, wallet: Wallet): DeployMethod<CounterContract>;
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified constructor method.
+     */
+    static deployWithOpts<M extends keyof CounterContract['methods']>(opts: {
+        publicKeys?: PublicKeys;
+        method?: M;
+        wallet: Wallet;
+    }, ...args: Parameters<CounterContract['methods'][M]>): DeployMethod<CounterContract>;
+    /**
+     * Returns this contract's artifact.
+     */
+    static get artifact(): ContractArtifact;
+    /**
+     * Returns this contract's artifact with public bytecode.
+     */
+    static get artifactForPublic(): ContractArtifact;
+    static get storage(): ContractStorageLayout<'counter'>;
+    /** Type-safe wrappers for the public methods exposed by the contract. */
+    methods: {
+        /** get_counter() */
+        get_counter: (() => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** increment() */
+        increment: (() => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** process_message(message_ciphertext: struct, message_context: struct) */
+        process_message: ((message_ciphertext: FieldLike[], message_context: {
+            tx_hash: FieldLike;
+            unique_note_hashes_in_tx: FieldLike[];
+            first_nullifier_in_tx: FieldLike;
+            recipient: AztecAddressLike;
+        }) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** public_dispatch(selector: field) */
+        public_dispatch: ((selector: FieldLike) => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+        /** sync_state() */
+        sync_state: (() => ContractFunctionInteraction) & Pick<ContractMethod, 'selector'>;
+    };
+}
+//# sourceMappingURL=Counter.d.ts.map

package/dist/src/artifacts/Counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Counter.d.ts","sourceRoot":"","sources":["../../../src/artifacts/Counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAmB,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAqD,KAAK,SAAS,EAAoK,MAAM,qBAAqB,CAAC;AACtU,OAAO,EAAY,YAAY,EAAE,2BAA2B,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG/J,OAAO,EAAkB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,eAAO,MAAM,uBAAuB,kBAA4E,CAAC;AAIjH;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAE/C,OAAO;IASP;;;;;OAKG;WACW,EAAE,CACd,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,GACb,eAAe;IAKlB;;OAEG;WACW,MAAM,CAAC,MAAM,EAAE,MAAM;IAInC;;OAEG;WACW,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAIzE;;OAEG;WACW,cAAc,CAAC,CAAC,SAAS,MAAM,eAAe,CAAC,SAAS,CAAC,EACrE,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC7D,GAAG,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAcpD;;OAEG;IACH,WAAkB,QAAQ,IAAI,gBAAgB,CAE7C;IAED;;OAEG;IACH,WAAkB,iBAAiB,IAAI,gBAAgB,CAEtD;IAGD,WAAkB,OAAO,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAM1D;IAGH,yEAAyE;IAC1D,OAAO,EAAE;QAEtB,oBAAoB;QACpB,WAAW,EAAE,CAAC,MAAM,2BAA2B,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAEpF,kBAAkB;QAClB,SAAS,EAAE,CAAC,MAAM,2BAA2B,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAElF,2EAA2E;QAC3E,eAAe,EAAE,CAAC,CAAC,kBAAkB,EAAE,SAAS,EAAE,EAAE,eAAe,EAAE;YAAE,OAAO,EAAE,SAAS,CAAC;YAAC,wBAAwB,EAAE,SAAS,EAAE,CAAC;YAAC,qBAAqB,EAAE,SAAS,CAAC;YAAC,SAAS,EAAE,gBAAgB,CAAA;SAAE,KAAK,2BAA2B,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAEtQ,uCAAuC;QACvC,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,KAAK,2BAA2B,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAE3G,mBAAmB;QACnB,UAAU,EAAE,CAAC,MAAM,2BAA2B,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;KACpF,CAAC;CAGH"}

package/dist/src/artifacts/Counter.js

@@ -0,0 +1,62 @@
+/* Autogenerated file, do not edit! */
+import { loadContractArtifact, loadContractArtifactForPublic } from '@aztec/aztec.js/abi';
+import { Contract, ContractBase, DeployMethod } from '@aztec/aztec.js/contracts';
+import { Fr } from '@aztec/aztec.js/fields';
+import { PublicKeys } from '@aztec/aztec.js/keys';
+import CounterContractArtifactJson from '../../target/counter_contract-Counter.json' with { type: 'json' };
+export const CounterContractArtifact = loadContractArtifact(CounterContractArtifactJson);
+/**
+ * Type-safe interface for contract Counter;
+ */
+export class CounterContract extends ContractBase {
+    constructor(address, wallet) {
+        super(address, CounterContractArtifact, wallet);
+    }
+    /**
+     * Creates a contract instance.
+     * @param address - The deployed contract's address.
+     * @param wallet - The wallet to use when interacting with the contract.
+     * @returns A new Contract instance.
+     */
+    static at(address, wallet) {
+        return Contract.at(address, CounterContract.artifact, wallet);
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract.
+     */
+    static deploy(wallet) {
+        return new DeployMethod(PublicKeys.default(), wallet, CounterContractArtifact, (instance, wallet) => CounterContract.at(instance.address, wallet), Array.from(arguments).slice(1));
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified public keys hash to derive the address.
+     */
+    static deployWithPublicKeys(publicKeys, wallet) {
+        return new DeployMethod(publicKeys, wallet, CounterContractArtifact, (instance, wallet) => CounterContract.at(instance.address, wallet), Array.from(arguments).slice(2));
+    }
+    /**
+     * Creates a tx to deploy a new instance of this contract using the specified constructor method.
+     */
+    static deployWithOpts(opts, ...args) {
+        return new DeployMethod(opts.publicKeys ?? PublicKeys.default(), opts.wallet, CounterContractArtifact, (instance, wallet) => CounterContract.at(instance.address, wallet), Array.from(arguments).slice(1), opts.method ?? 'constructor');
+    }
+    /**
+     * Returns this contract's artifact.
+     */
+    static get artifact() {
+        return CounterContractArtifact;
+    }
+    /**
+     * Returns this contract's artifact with public bytecode.
+     */
+    static get artifactForPublic() {
+        return loadContractArtifactForPublic(CounterContractArtifactJson);
+    }
+    static get storage() {
+        return {
+            counter: {
+                slot: new Fr(1n),
+            }
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ291bnRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcnRpZmFjdHMvQ291bnRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxzQ0FBc0M7QUFJdEMsT0FBTyxFQUE0SixvQkFBb0IsRUFBRSw2QkFBNkIsRUFBb0YsTUFBTSxxQkFBcUIsQ0FBQztBQUN0VSxPQUFPLEVBQUUsUUFBUSxFQUFFLFlBQVksRUFBZ0YsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFFL0osT0FBTyxFQUFFLEVBQUUsRUFBUyxNQUFNLHdCQUF3QixDQUFDO0FBQ25ELE9BQU8sRUFBa0IsVUFBVSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFFbEUsT0FBTywyQkFBMkIsTUFBTSw0Q0FBNEMsQ0FBQyxPQUFPLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztBQUMzRyxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyxvQkFBb0IsQ0FBQywyQkFBbUQsQ0FBQyxDQUFDO0FBSWpIOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGVBQWdCLFNBQVEsWUFBWTtJQUUvQyxZQUNFLE9BQXFCLEVBQ3JCLE1BQWM7UUFFZCxLQUFLLENBQUMsT0FBTyxFQUFFLHVCQUF1QixFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ2xELENBQUM7SUFJRDs7Ozs7T0FLRztJQUNJLE1BQU0sQ0FBQyxFQUFFLENBQ2QsT0FBcUIsRUFDckIsTUFBYztRQUVkLE9BQU8sUUFBUSxDQUFDLEVBQUUsQ0FBQyxPQUFPLEVBQUUsZUFBZSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQW9CLENBQUM7SUFDbkYsQ0FBQztJQUdEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFjO1FBQ2pDLE9BQU8sSUFBSSxZQUFZLENBQWtCLFVBQVUsQ0FBQyxPQUFPLEVBQUUsRUFBRSxNQUFNLEVBQUUsdUJBQXVCLEVBQUUsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxlQUFlLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN0TSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLENBQUMsb0JBQW9CLENBQUMsVUFBc0IsRUFBRSxNQUFjO1FBQ3ZFLE9BQU8sSUFBSSxZQUFZLENBQWtCLFVBQVUsRUFBRSxNQUFNLEVBQUUsdUJBQXVCLEVBQUUsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLEVBQUUsQ0FBQyxlQUFlLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM1TCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLENBQUMsY0FBYyxDQUMxQixJQUE2RCxFQUM3RCxHQUFHLElBQStDO1FBRWxELE9BQU8sSUFBSSxZQUFZLENBQ3JCLElBQUksQ0FBQyxVQUFVLElBQUksVUFBVSxDQUFDLE9BQU8sRUFBRSxFQUN2QyxJQUFJLENBQUMsTUFBTSxFQUNYLHVCQUF1QixFQUN2QixDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsRUFBRSxDQUFDLGVBQWUsQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsRUFDbEUsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQzlCLElBQUksQ0FBQyxNQUFNLElBQUksYUFBYSxDQUM3QixDQUFDO0lBQ0osQ0FBQztJQUlEOztPQUVHO0lBQ0ksTUFBTSxLQUFLLFFBQVE7UUFDeEIsT0FBTyx1QkFBdUIsQ0FBQztJQUNqQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLEtBQUssaUJBQWlCO1FBQ2pDLE9BQU8sNkJBQTZCLENBQUMsMkJBQW1ELENBQUMsQ0FBQztJQUM1RixDQUFDO0lBR00sTUFBTSxLQUFLLE9BQU87UUFDckIsT0FBTztZQUNMLE9BQU8sRUFBRTtnQkFDWCxJQUFJLEVBQUUsSUFBSSxFQUFFLENBQUMsRUFBRSxDQUFDO2FBQ2pCO1NBQ3NDLENBQUM7SUFDeEMsQ0FBQztDQXVCSiJ9

package/dist/src/ts/artifactRegistry.d.ts

@@ -0,0 +1,46 @@
+import type { NoirCompiledContract } from "@aztec/aztec.js/abi";
+export type ArtifactRegistryUploadResponse = {
+    success: true;
+    filename?: string;
+    classId?: string;
+    contractName?: string;
+    functionCount?: number;
+    [key: string]: unknown;
+} | {
+    success: false;
+    error?: string;
+    message?: string;
+    [key: string]: unknown;
+};
+export declare function getArtifactRegistryBaseUrl(): string;
+export declare function shouldUploadArtifacts(): boolean;
+export declare function isStrictUpload(): boolean;
+export declare function uploadArtifactToRegistry(params: {
+    artifact: unknown;
+    filename: string;
+    registryBaseUrl?: string;
+}): Promise<ArtifactRegistryUploadResponse>;
+export declare function uploadArtifactFileToRegistry(params: {
+    artifactPath: string;
+    filename?: string;
+    registryBaseUrl?: string;
+}): Promise<ArtifactRegistryUploadResponse>;
+export declare function maybeUploadArtifactToRegistry(params: {
+    artifact: unknown;
+    filename: string;
+    registryBaseUrl?: string;
+}): Promise<ArtifactRegistryUploadResponse | null>;
+export declare function fetchArtifactFromRegistry(params: {
+    classId: string;
+    registryBaseUrl?: string;
+}): Promise<unknown>;
+/**
+ * Loads an artifact from the registry with fallback to local file.
+ * Tries registry first if classId is provided, then falls back to local file.
+ */
+export declare function loadArtifactWithRegistryFallback(params: {
+    classId?: string;
+    localPath: string;
+    registryBaseUrl?: string;
+}): Promise<NoirCompiledContract>;
+//# sourceMappingURL=artifactRegistry.d.ts.map

package/dist/src/ts/artifactRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactRegistry.d.ts","sourceRoot":"","sources":["../../../src/ts/artifactRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,MAAM,8BAA8B,GACtC;IACE,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAMN,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAsC1C;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAU1C;AAED,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAejD;AAED,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmChC"}

package/dist/src/ts/artifactRegistry.js

@@ -0,0 +1,128 @@
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+}
+export function getArtifactRegistryBaseUrl() {
+    return (process.env.AZTEC_ARTIFACT_REGISTRY_URL ??
+        "https://devnet.aztec-registry.xyz/");
+}
+export function shouldUploadArtifacts() {
+    const v = process.env.AZTEC_ARTIFACT_REGISTRY_UPLOAD ?? "";
+    return v === "1" || v.toLowerCase() === "true";
+}
+export function isStrictUpload() {
+    const v = process.env.AZTEC_ARTIFACT_REGISTRY_STRICT ?? "";
+    return v === "1" || v.toLowerCase() === "true";
+}
+export async function uploadArtifactToRegistry(params) {
+    const base = normalizeBaseUrl(params.registryBaseUrl ?? getArtifactRegistryBaseUrl());
+    const uploadUrl = new URL("api/upload", base).toString();
+    const body = new FormData();
+    const payload = JSON.stringify(params.artifact);
+    body.set("file", new Blob([payload], { type: "application/json" }), params.filename);
+    const res = await fetch(uploadUrl, { method: "POST", body });
+    // The registry commonly returns JSON even on 409; treat duplicates as non-fatal by default.
+    const text = await res.text();
+    const parsed = text ? safeJsonParse(text) : { success: res.ok };
+    if (res.ok) {
+        return isRegistryResponseObject(parsed)
+            ? parsed
+            : { success: true };
+    }
+    // Duplicate artifact (already uploaded) should not break deploys unless strict mode is enabled.
+    if (res.status === 409) {
+        return isRegistryResponseObject(parsed)
+            ? { ...parsed, success: true }
+            : { success: true, message: "Artifact already exists in registry" };
+    }
+    const msg = typeof parsed === "object" && parsed
+        ? JSON.stringify(parsed)
+        : text || `HTTP ${res.status} ${res.statusText}`;
+    throw new Error(`Artifact registry upload failed (${res.status}): ${msg}`);
+}
+export async function uploadArtifactFileToRegistry(params) {
+    const buf = await readFile(params.artifactPath, "utf8");
+    const artifact = JSON.parse(buf);
+    const filename = params.filename ?? params.artifactPath.split("/").pop() ?? "artifact.json";
+    return await uploadArtifactToRegistry({
+        artifact,
+        filename,
+        registryBaseUrl: params.registryBaseUrl,
+    });
+}
+export async function maybeUploadArtifactToRegistry(params) {
+    if (!shouldUploadArtifacts())
+        return null;
+    try {
+        const resp = await uploadArtifactToRegistry(params);
+        return resp;
+    }
+    catch (err) {
+        if (isStrictUpload())
+            throw err;
+        // Best-effort upload; do not fail deployments by default.
+        console.warn(`[artifact-registry] Upload failed (continuing): ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+export async function fetchArtifactFromRegistry(params) {
+    const base = normalizeBaseUrl(params.registryBaseUrl ?? getArtifactRegistryBaseUrl());
+    const fetchUrl = new URL(`api/artifacts/${params.classId}`, base).toString();
+    const res = await fetch(fetchUrl, { method: "GET" });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error(`Artifact not found in registry: ${params.classId}`);
+        }
+        throw new Error(`Failed to fetch artifact from registry (${res.status}): ${res.statusText}`);
+    }
+    const text = await res.text();
+    return safeJsonParse(text);
+}
+/**
+ * Loads an artifact from the registry with fallback to local file.
+ * Tries registry first if classId is provided, then falls back to local file.
+ */
+export async function loadArtifactWithRegistryFallback(params) {
+    // Try registry first if classId is provided
+    if (params.classId) {
+        try {
+            const artifact = await fetchArtifactFromRegistry({
+                classId: params.classId,
+                registryBaseUrl: params.registryBaseUrl,
+            });
+            return artifact;
+        }
+        catch (error) {
+            // Fall through to local file if registry fetch fails
+            console.warn(`Failed to fetch artifact from registry, using local file: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Fallback to local file
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const localArtifactPath = join(__dirname, "../../..", params.localPath);
+    if (!existsSync(localArtifactPath)) {
+        throw new Error(`Artifact not found at local path: ${localArtifactPath}. ` +
+            (params.classId
+                ? `Registry fetch also failed for classId: ${params.classId}`
+                : "No classId provided for registry fetch."));
+    }
+    const buf = await readFile(localArtifactPath, "utf8");
+    return JSON.parse(buf);
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function isRegistryResponseObject(value) {
+    return typeof value === "object" && value !== null && "success" in value;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJ0aWZhY3RSZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90cy9hcnRpZmFjdFJlZ2lzdHJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3JDLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDakMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBbUJwQyxTQUFTLGdCQUFnQixDQUFDLE9BQWU7SUFDdkMsT0FBTyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsT0FBTyxHQUFHLENBQUM7QUFDekQsQ0FBQztBQUVELE1BQU0sVUFBVSwwQkFBMEI7SUFDeEMsT0FBTyxDQUNMLE9BQU8sQ0FBQyxHQUFHLENBQUMsMkJBQTJCO1FBQ3ZDLG9DQUFvQyxDQUNyQyxDQUFDO0FBQ0osQ0FBQztBQUVELE1BQU0sVUFBVSxxQkFBcUI7SUFDbkMsTUFBTSxDQUFDLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyw4QkFBOEIsSUFBSSxFQUFFLENBQUM7SUFDM0QsT0FBTyxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUMsQ0FBQyxXQUFXLEVBQUUsS0FBSyxNQUFNLENBQUM7QUFDakQsQ0FBQztBQUVELE1BQU0sVUFBVSxjQUFjO0lBQzVCLE1BQU0sQ0FBQyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsOEJBQThCLElBQUksRUFBRSxDQUFDO0lBQzNELE9BQU8sQ0FBQyxLQUFLLEdBQUcsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLEtBQUssTUFBTSxDQUFDO0FBQ2pELENBQUM7QUFFRCxN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

package/dist/src/ts/fee-payment-methods/bridged.d.ts

@@ -0,0 +1,34 @@
+import type { FeePaymentMethod } from "@aztec/aztec.js/fee";
+import { AztecAddress } from "@aztec/stdlib/aztec-address";
+import type { GasSettings } from "@aztec/stdlib/gas";
+import { ExecutionPayload } from "@aztec/stdlib/tx";
+import { Fr } from "@aztec/foundation/curves/bn254";
+/**
+ * Fee payment method for BridgedFPC that bundles FeeJuice.claim +
+ * mint_and_pay_fee in a single transaction setup phase.
+ *
+ * Enables cold-start fee sponsorship directly from a L1 bridge deposit,
+ * with no prior `mint` call needed. The caller's wallet only needs to
+ * have done the L1 deposit; the L2 claim and wFJ credit happen atomically here.
+ *
+ * The payment calls (in order):
+ *   1. FeeJuice.claim(fpcAddress, amount, secret, leafIndex)
+ *      - Consumes the L1→L2 message; emits the FeeJuice nullifier.
+ *   2. BridgedFPC.mint_and_pay_fee(amount, salt, leafIndex)
+ *      - Asserts the FeeJuice nullifier exists (pending from step 1).
+ *      - Credits (amount - max_gas_cost) to msg_sender.
+ *      - Sets BridgedFPC as fee payer and ends setup.
+ */
+export declare class BridgedMintAndPayFeePaymentMethod implements FeePaymentMethod {
+    private readonly fpcAddress;
+    private readonly amount;
+    private readonly secret;
+    private readonly salt;
+    private readonly leafIndex;
+    constructor(fpcAddress: AztecAddress, amount: bigint, secret: Fr, salt: Fr, leafIndex: Fr);
+    getAsset(): Promise<AztecAddress>;
+    getFeePayer(): Promise<AztecAddress>;
+    getExecutionPayload(): Promise<ExecutionPayload>;
+    getGasSettings(): GasSettings | undefined;
+}
+//# sourceMappingURL=bridged.d.ts.map