hooperben · hooperben · Jan 19, 2026 · Dec 11, 2025 · Dec 11, 2025 · Dec 11, 2025
diff --git a/.github/workflows/pinata-upload.yml b/.github/workflows/pinata-upload.yml
@@ -22,7 +22,7 @@ jobs:
         run: |
           curl -L https://raw.githubusercontent.com/noir-lang/noirup/refs/heads/main/install | bash
           export PATH="$HOME/.nargo/bin:$PATH"
-          noirup --version 1.0.0-beta.15
+          noirup --version 1.0.0-beta.16
           echo "$HOME/.nargo/bin" >> $GITHUB_PATH
 
       - name: Install bb (Barretenberg)
@@ -43,7 +43,7 @@ jobs:
         env:
           VITE_GITHUB_ACTION_BUILD_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
           VITE_DOMAIN: ${{ github.ref == 'refs/heads/main' && 'https://commbank.eth.limo' || 'https://dev.commbank.eth.limo' }}
-          VITE_DEFAULT_CHAIN_ID: ${{ github.ref == 'refs/heads/main' && '1' || '11155111' }}
+          VITE_DEFAULT_CHAIN_ID: ${{ github.ref == 'refs/heads/main' && '1' || '421614' }}
         run: |
           export PNPM_HOME="$HOME/.local/share/pnpm"
           export PATH="$PNPM_HOME:$PATH"

diff --git a/.github/workflows/test-client-v2-build.yml b/.github/workflows/test-client-v2-build.yml
@@ -21,7 +21,7 @@ jobs:
         run: |
           curl -L https://raw.githubusercontent.com/noir-lang/noirup/refs/heads/main/install | bash
           export PATH="$HOME/.nargo/bin:$PATH"
-          noirup --version 1.0.0-beta.15
+          noirup --version 1.0.0-beta.16
           echo "$HOME/.nargo/bin" >> $GITHUB_PATH
 
       - name: Install bb (Barretenberg)

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -20,7 +20,7 @@ CommBank.eth is a privacy-enabled DeFi platform that facilitates private transfe
 
 ## Monorepo Structure
 
-This is a Bun workspace monorepo with the following packages:
+This is a pnpm workspace monorepo with the following packages:
 
 ### `client/` - Next.js Frontend (Primary)
 
@@ -79,7 +79,7 @@ This is a Bun workspace monorepo with the following packages:
 
 ### `circuits/` - Zero-Knowledge Circuits (Noir)
 
-- **Tech Stack:** Noir language v1.0.0-beta.15
+- **Tech Stack:** Noir language v1.0.0-beta.16
 - **Purpose:** ZK-SNARK circuit definitions for private operations
 - **Circuits:**
   - `deposit/` - Prove deposit commitment without revealing amount
@@ -124,58 +124,56 @@ This is a Bun workspace monorepo with the following packages:
 
 ```bash
 # Install all dependencies
-bun install
+pnpm install
 
 # Format all code
-bun run format
+pnpm run format
 
 # Check formatting
-bun run format:check
+pnpm run format:check
 
 # Lint all code
-bun run lint
+pnpm run lint
 
 # Fix lint errors
-bun run lint:fix
+pnpm run lint:fix
 
 # Start development (runs client by default)
-bun run dev
+pnpm run dev
 
 # Build client
-bun run build
+pnpm run build
 
 # Build contracts and generate verifiers
-bun run build-contracts
+pnpm run build-contracts
 ```
 
 ### Client (Next.js)
 
 ```bash
 cd client
-bun run dev      # Start dev server on localhost:3000
-bun run build    # Production build
-bun run start    # Run production build
-bun run lint     # Next.js linting
+pnpm run dev      # Start dev server on localhost:3000
+pnpm run build    # Production build
+pnpm run start    # Run production build
+pnpm run lint     # Next.js linting
 ```
 
 ### client (Vite + React Router)
 
 ```bash
 cd client
-bun run dev      # Start Vite dev server
-bun run build    # Build with TypeScript + Vite
-bun run preview  # Preview production build
-bun run lint     # ESLint check
+pnpm run dev      # Start Vite dev server
+pnpm run build    # Build with TypeScript + Vite
+pnpm run preview  # Preview production build
+pnpm run lint     # ESLint check
 ```
 
 ### Contracts
 
 ```bash
 cd contracts
-bun run build                # Build verifiers from circuits (primary build command)
-bun run build-bb            # Compile Noir circuits to bytecode
-bun run build-ipfs          # Build and upload to IPFS
-bun run deploy              # Deploy contracts (ts-node scripts/deploy.ts)
+pnpm run build                # Build verifiers from circuits (primary build command)
+pnpm run build-bb            # Compile Noir circuits to bytecode
 
 # Testing
 npx hardhat test            # Run all tests
@@ -278,7 +276,7 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 - **Config:** `eslint.config.mjs` at root (modern flat config)
 - **Rules:** TypeScript + Prettier plugin integration
 - **Ignored Paths:** node_modules, dist, build, .next, out
-- **Run:** `bun run lint` and `bun run lint:fix`
+- **Run:** `pnpm run lint` and `pnpm run lint:fix`
 
 ### Prettier Configuration
 
@@ -289,7 +287,7 @@ const proof = await deposit.depositNoir.generateProof(inputs);
   - Single quotes: false (use double quotes)
   - Print width: 80 characters
   - Tab width: 2 spaces
-- **Run:** `bun run format` and `bun run format:check`
+- **Run:** `pnpm run format` and `pnpm run format:check`
 
 ### TypeScript Configuration
 
@@ -387,7 +385,7 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 
 ### Circuits
 
-- **Language:** Noir v1.0.0-beta.15
+- **Language:** Noir v1.0.0-beta.16
 - **Dependencies:** Poseidon (noir-lang/poseidon)
 - **Proving:** Aztec Barretenberg backend via bb.js
 
@@ -402,7 +400,7 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 - `PRIVATE_KEY` - Deployment account key
 - `DEMO_MNEMONIC_ALICE` - Test wallet mnemonic
 
-**Auto-loaded by Bun:** Use environment variables directly; Bun loads `.env` automatically
+**Loading ENV:** Use dotenv or configure your shell to load `.env` files
 
 ## Testing Overview
 
@@ -437,8 +435,8 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 ### Running client Locally
 
 1. `cd client`
-2. `bun install` (if dependencies changed)
-3. `bun run dev` - Opens at http://localhost:5173
+2. `pnpm install` (if dependencies changed)
+3. `pnpm run dev` - Opens at http://localhost:5173
 4. Changes auto-reload (Vite HMR)
 
 ### Debugging Proofs
@@ -451,14 +449,14 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 ### Deploying to Testnets
 
 1. Ensure proper ENV variables are set
-2. Verify circuit artifacts are built (`bun run build-contracts`)
+2. Verify circuit artifacts are built (`pnpm run build-contracts`)
 3. Run: `npx hardhat run scripts/deploy.ts --network <network-name>`
 4. Network names: hardhat, mainnet, arbitrumOne, base
 
 ### Working with Shared Package
 
 - Always import as `shared-package/*` (not relative paths)
-- Changes to shared require re-running `bun install` in dependent packages
+- Changes to shared require re-running `pnpm install` in dependent packages
 - Shared uses workspace:\* to link to contracts package
 
 ## Notable Design Decisions
@@ -468,7 +466,7 @@ const proof = await deposit.depositNoir.generateProof(inputs);
 3. **Encrypted Notes:** Notes encrypted with user's public key, enabling note passing without on-chain storage
 4. **Two Keys:** Signing key (public key) and owning key (poseidon hash) allow efficient ZK proofs vs on-chain encryption
 5. **TypeChain Integration:** Type-safe contract ABIs prevent runtime errors during tests
-6. **Bun Runtime:** Faster compilation and bundling for TS/TSX; better dev experience than Node.js
+6. **pnpm Workspaces:** Efficient disk space usage with symlinked node_modules; strict dependency resolution
 
 ## Known Limitations & WIPs
 

diff --git a/README.md b/README.md
@@ -1,13 +1,14 @@
 # commbank.eth
 
-### the bank you don't have to trust
+### open source, privacy enhancing financial technologies
 
 ## Components
 
-- `client*/`: the commbank.eth web app (currently 2 versions)
-- `contracts/`: the EVM smart contracts required to facilitate private transfers
-- `circuits/`: an implementation of a Multi Asset Shield Pool with `poseidon2` as the merkle tree hash function
-- `indexer/`: the indexer that makes the merkle tree data available easier
+- `client/`: the commbank.eth web app deployed to `https://commbank.eth.limo`
+- `contracts/`: the EVM smart contracts required to facilitate Private Unstoppable Money
+- `circuits/`: Private Unstoppable Money Zero Knowledge circuits
+- `indexer/`: a data indexer used to cache Private Unstoppable Money transactions more efficiently
+- `relayer/`: an expressJS based backend that forwards RPC requests and works as a transaction relayer
 
 ## Development
 

diff --git a/circuits/deposit/Nargo.toml b/circuits/deposit/Nargo.toml
@@ -5,3 +5,4 @@ authors = [""]
 
 [dependencies]
 poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
+pum_lib = { path = '../pum_lib' }
diff --git a/circuits/deposit/src/main.nr b/circuits/deposit/src/main.nr
@@ -1,11 +1,4 @@
-use poseidon;
-
-fn calculate_leaf(asset_id: Field, asset_amount: Field, owner: Field, secret: Field) -> Field {
-    let leaf_hash =
-        poseidon::poseidon2::Poseidon2::hash([asset_id, asset_amount, owner, secret], 4);
-
-    leaf_hash
-}
+use pum_lib;
 
 fn main(
     hash: pub Field,
@@ -14,7 +7,7 @@ fn main(
     owner: Field,
     secret: Field,
 ) {
-    let reconstructed_leaf = calculate_leaf(asset_id, asset_amount, owner, secret);
+    let reconstructed_leaf = pum_lib::calculate_leaf(asset_id, asset_amount, owner, secret);
 
     assert(reconstructed_leaf == hash);
 }

diff --git a/circuits/warp/Nargo.toml → circuits/pum_lib/Nargo.toml b/circuits/warp/Nargo.toml → circuits/pum_lib/Nargo.toml
@@ -1,7 +1,7 @@
 [package]
-name = "warp"
-type = "bin"
+name = "pum_lib"
 authors = [""]
+type = "lib"
 
 [dependencies]
 poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
diff --git a/circuits/pum_lib/src/lib.nr b/circuits/pum_lib/src/lib.nr
@@ -0,0 +1,48 @@
+use poseidon;
+use poseidon::poseidon2;
+
+global HEIGHT: u32 = 12;
+
+pub fn calculate_leaf(asset_id: Field, asset_amount: Field, owner: Field, secret: Field) -> Field {
+    let leaf_hash =
+        poseidon::poseidon2::Poseidon2::hash([asset_id, asset_amount, owner, secret], 4);
+
+    leaf_hash
+}
+
+pub fn compute_merkle_root(
+    leaf: Field,
+    path: [Field; HEIGHT - 1],
+    path_indices: [Field; HEIGHT - 1],
+) -> Field {
+    let mut current = leaf;
+    for i in 0..HEIGHT - 1 {
+        let path_bit = path_indices[i];
+        let (hash_left, hash_right) = if path_bit == 0 {
+            (path[i], current)
+        } else {
+            (current, path[i])
+        };
+        current = poseidon2::Poseidon2::hash([hash_left, hash_right], 2);
+    }
+    current
+}
+
+pub fn compute_nullifier(
+    leaf_index: Field,
+    owner: Field,
+    secret: Field,
+    asset_id: Field,
+    asset_amount: Field,
+) -> Field {
+    poseidon2::Poseidon2::hash([leaf_index, owner, secret, asset_id, asset_amount], 5)
+}
+
+pub fn reconstruct_leaf(
+    asset_id: Field,
+    asset_amount: Field,
+    owner: Field,
+    secret: Field,
+) -> Field {
+    poseidon2::Poseidon2::hash([asset_id, asset_amount, owner, secret], 4)
+}
diff --git a/circuits/transfer/Nargo.toml b/circuits/transfer/Nargo.toml
@@ -5,3 +5,4 @@ authors = [""]
 
 [dependencies]
 poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
+pum_lib = { path = '../pum_lib' }
diff --git a/circuits/transfer/src/main.nr b/circuits/transfer/src/main.nr
@@ -1,10 +1,10 @@
-global HEIGHT: u32 = 12;
-global NOTE_COUNT: u32 = 3;
-
 use poseidon::poseidon2::{self, Poseidon2Hasher};
-
+use pum_lib::{self, compute_merkle_root, compute_nullifier, reconstruct_leaf};
 use std::{collections::map::HashMap, hash::BuildHasherDefault};
 
+global HEIGHT: u32 = 12;
+global NOTE_COUNT: u32 = 3;
+
 struct InputNote {
     asset_id: Field,
     asset_amount: Field,
@@ -23,38 +23,6 @@ struct OutputNote {
     asset_amount: Field,
 }
 
-fn compute_merkle_root(
-    leaf: Field,
-    path: [Field; HEIGHT - 1],
-    path_indices: [Field; HEIGHT - 1],
-) -> Field {
-    let mut current = leaf;
-    for i in 0..HEIGHT - 1 {
-        let path_bit = path_indices[i];
-        let (hash_left, hash_right) = if path_bit == 0 {
-            (path[i], current)
-        } else {
-            (current, path[i])
-        };
-        current = poseidon2::Poseidon2::hash([hash_left, hash_right], 2);
-    }
-    current
-}
-
-fn compute_nullifier(
-    leaf_index: Field,
-    owner: Field,
-    secret: Field,
-    asset_id: Field,
-    asset_amount: Field,
-) -> Field {
-    poseidon2::Poseidon2::hash([leaf_index, owner, secret, asset_id, asset_amount], 5)
-}
-
-fn reconstruct_leaf(asset_id: Field, asset_amount: Field, owner: Field, secret: Field) -> Field {
-    poseidon2::Poseidon2::hash([asset_id, asset_amount, owner, secret], 4)
-}
-
 fn main(
     root: pub Field,
     input_notes: [InputNote; NOTE_COUNT],

diff --git a/circuits/transfer_external/Nargo.toml b/circuits/transfer_external/Nargo.toml
@@ -0,0 +1,8 @@
+[package]
+name = "transfer_external"
+type = "bin"
+authors = [""]
+
+[dependencies]
+poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
+pum_lib = { path = '../pum_lib' }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -5,3 +5,4 @@ authors = [""]

		[dependencies]
		poseidon = { tag = "v0.1.1", git = "https://github.com/noir-lang/poseidon" }
		pum_lib = { path = '../pum_lib' }