offchain payments

README.md

@@ -97,8 +97,41 @@ This will:
 - Deploy the ProofOfPassword contract
 - Generate a `deployed-addresses.json` file with contract addresses
 
-#### 4. Start the Development Server
+#### 4. Deploy the Subscription FPC
+
+GregoSwap uses a [SubscriptionFPC](https://github.com/Thunkar/gregojuice) (Fee Payment
+Contract) to sponsor user transactions: the drip, the swap, and the offchain send all
+run for free from the user's perspective, with the FPC paying gas in Fee Juice. 
+
+If you are testing on a local network, you will need to bootstrap FPC infrastructure.
+
+After the base contracts are in place, you can deploy and configure the FPC with:
+
+```bash
+yarn deploy:fpc:local
+```
+
+This single command does everything needed to bring the FPC online against the local
+sandbox:
+
+- Deploys a fresh `SubscriptionFPC` with generated keys
+- Bridges fee juice from L1 (Anvil) to the FPC's L2 address so it can actually pay gas
+- Calls `sign_up` on the FPC for each sponsored function declared in
+  `scripts/deploy-subscription-fpc.ts` (currently: `PoP.check_password_and_mint`,
+  `AMM.swap_tokens_for_exact_tokens_from`, and
+  `Token.transfer_in_private_deliver_offchain` on both token contracts)
+- Claims the L1→L2 message on behalf of the FPC so its balance is usable
+- Writes the FPC address, secret key, and function-selector map into
+  `src/config/networks/local.json` under `subscriptionFPC`
+
+The script is idempotent over the underlying config: re-running it deploys a new FPC
+and overwrites the `subscriptionFPC` block. You can use a different config file via
+`NETWORK_CONFIG_PATH`.
+
+Note this is not needed to test on Testnet's or Mainnet's, since there the SubscriptionFPC infrastructure is already set up.
+
+#### 5. Start the Development Server
 
 ```bash
-yarn serve
+yarn dev
 ```

contracts/Nargo.toml

@@ -1,5 +1,6 @@
 [workspace]
 members = [
     "proof_of_password",
-    "amm"
+    "amm",
+    "token"
 ]

contracts/amm/Nargo.toml

@@ -5,5 +5,5 @@ type = "contract"
 
 [dependencies]
 aztec = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/aztec" }
-token = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/noir-contracts/contracts/app/token_contract" }
+token = { path = "../token" }
 uint_note = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/uint-note" }

contracts/proof_of_password/Nargo.toml

@@ -5,6 +5,6 @@ authors = [""]
 
 [dependencies]
 aztec = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/aztec" }
-token = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/noir-contracts/contracts/app/token_contract" } 
+token = { path = "../token" }
 poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
-compressed_string = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/compressed-string"  }
+compressed_string = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/compressed-string"  }

contracts/token/Nargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "token_contract"
+authors = [""]
+type = "contract"
+
+[dependencies]
+aztec = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/aztec" }
+uint_note = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/uint-note" }
+compressed_string = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/compressed-string" }
+balance_set = { git = "https://github.com/AztecProtocol/aztec-packages/", tag = "v4.2.0-nightly.20260412", directory = "noir-projects/aztec-nr/balance-set" }