4.3.2 PXP-101 - Balance Pass

Purpose

Allow a user to prove they meet an off-chain balance threshold without revealing:

• wallet address,

• exact holdings.

On-chain contracts (Mainnet)

• BalanceAccessPass: 0x8333b589ad3A8A5fCe735631e8EDf693C6AE0472

• Verifier: 0x34448D78DC8eA25AA6D8eeA46A61e963C1D3C982

On-chain interface (conceptual)

• currentRoot() → uint256

• requiredThreshold() → uint256

• proveAndConsume(proof, pubSignals) where pubSignals = [root, nullifierHash]

• Event:

  • AccessGranted(address caller, bytes32 nullifier, uint256 root)

PXP-101 Proof semantics

• The user proves membership/eligibility under the root and a threshold condition.

• The nullifier ensures single-use semantics (or scoped usage depending on the design).

PXP-101 schema (with integrator)

User (private inputs) -> proof generation -> submit on-chain
   -> Contract verifies -> emits AccessGranted(caller, nullifier, root)
      -> Integrator listens to event OR checks nullifier -> grants access

Integration patterns (PXP-101)

• Off-chain gating (backend): listen to events and grant access

• On-chain gating: consume nullifier as one-time ticket

• SDK-based gating: simplest programmatic integration