How polybase/payy works
Payy is a privacy-preserving, Ethereum-compatible ZK rollup. Its principal transaction path is a client preparing privacy proofs and interacting with the rollup, with aggregation and node services supporting rollup operation; the README identifies Ethereum contracts and the prover as core services. The tree also shows a wallet onboarding vault, payment-link frontend, and network explorer. Some core Rust implementations are not in the supplied tree, so subsystem paths and relationships not demonstrated by excerpts or README are left broad or unconnected.
Main entry points: main.rs Aggregator entry · client.ts Payy client · node Rollup node · App.tsx Privacy vault
Components 16
Client and wallet
- Payy client
app/packages/payy-client/src/client.ts - Bridge access
app/packages/payy-client/src/bridge.ts - Privacy cryptography
app/packages/payy-client/src/crypto.ts - Link utilities
app/packages/payy-client/src/links.ts
Web applications
- Privacy vault
app/packages/privacy-vault/src/App.tsx - Wallet authentication
app/packages/privacy-vault/src/features/auth/useWalletAuth.ts - Payment links
app/packages/link/src/app - Network explorer
app/packages/network/src/app
Rollup services
- Aggregator entry
pkg/aggregator-cli/src/main.rs - Aggregator config
pkg/aggregator-cli/src/config.rs - Aggregation runtime
pkg/aggregator-cli/src/runner.rs - Rollup node
pkg/node
Ethereum and proofs
- Proof generation
pkg/prover - Ethereum contracts
eth - Ethereum
Other components
- Wallet user
Connections 13
- Wallet user → Privacy vault: uses
app/packages/privacy-vault/src/App.tsx - Privacy vault → Wallet authentication: authenticates
app/packages/privacy-vault/src/App.tsx - Payy client → Privacy cryptography: computes proofs
app/packages/payy-client/src/client.ts - Payy client → Bridge access: reads bridge
app/packages/payy-client/src/client.ts - Payy client → Link utilities: uses link helpers
app/packages/payy-client/src/client.ts - Aggregator entry → Aggregator config: loads config
pkg/aggregator-cli/src/main.rs - Aggregator entry → Aggregation runtime: starts runtime
pkg/aggregator-cli/src/main.rs - Aggregator entry → Rollup node: connects to node
pkg/aggregator-cli/src/main.rs - Aggregator entry → Ethereum contracts: loads rollup contract
pkg/aggregator-cli/src/main.rs - Payy client → Proof generation: requests proofs
- Rollup node → Proof generation: uses proving service
- Ethereum contracts → Ethereum: verifies transitions
README.md - Aggregator entry → Rollup node: aggregates rollup
README.md