How nnovida/verakey works
VeraKey is a passkey-authorized wallet system for creating app-specific, unlinkable USDG accounts and signing in to websites. A user enters through the web app, creates or selects an account, and authorizes payments or account changes with a browser-generated proof; the server relays eligible transactions to Arbitrum. The product also supports popup sign-in, recovery, consent-based account-link disclosures, and a validator for modular accounts. The graph preserves those documented capabilities, but several page and SDK implementations were not sampled, so some documented subsystem links are dashed and unverified.
Main entry points: App.tsx Web routes · client.ts Wallet client · lib.rs Wallet account · index.ts HTTP API
Components 30
Web application
- Web routes
client/src/App.tsx - Product home
client/src/pages/Home.tsx - Accounts UI
client/src/pages/app/Accounts.tsx - Policy controls
client/src/pages/app/Policy.tsx - Recovery UI
client/src/pages/app/Recovery.tsx - Payment flow
client/src/pages/app/Pay.tsx - Link disclosure
client/src/pages/app/Disclose.tsx - Sign-in verifier
client/src/pages/app/Verify.tsx - Wallet state
client/src/state/VeraKeyProvider.tsx - Action timeline
client/src/pages/app/useAuthorizedAction.ts
Passkey SDK
- Wallet client
packages/sdk/src/client.ts - Passkey operations
packages/sdk/src/webauthn.ts - Proof generation
packages/sdk/src/prover.ts - Contract ABI
packages/sdk/src/abi.ts
Relaying service
- Network configuration
server/config.ts - HTTP API
server/index.ts - Request limits
server/rate-limit.ts - Transaction relayer
server/relayer.ts - API contracts
shared/api.ts
On-chain accounts
- Account factory
contracts/stylus/factory/src/lib.rs - Wallet account
contracts/stylus/account/src/lib.rs - Action rules
contracts/stylus/core/src/action.rs
Identity integrations
- Connect protocol
packages/sdk/src/connect.ts - Sign-in proofs
packages/sdk/src/signin.ts - Website verification
packages/sdk/src/server.ts - ERC-7579 validator
packages/sdk/src/validator.ts
Other components
- Wallet user
- Relying website
- Arbitrum network
- Passkey browser
Connections 32
- Wallet user → Web routes: opens
client/src/App.tsx - Web routes → Product home: routes to
client/src/App.tsx - Web routes → Accounts UI: routes to
client/src/App.tsx - Web routes → Payment flow: routes to
client/src/App.tsx - Web routes → Policy controls: routes to
client/src/App.tsx - Web routes → Recovery UI: routes to
client/src/App.tsx - Web routes → Link disclosure: routes to
client/src/App.tsx - Web routes → Sign-in verifier: routes to
client/src/App.tsx - Web routes → Wallet state: provides state
client/src/App.tsx - Accounts UI → Wallet client: uses
client/src/pages/app/Accounts.tsx - Action timeline → Wallet client: reports proof state
client/src/pages/app/useAuthorizedAction.ts - Wallet state → Wallet client: uses
- Wallet client → Passkey operations: requests assertions
packages/sdk/src/client.ts - Wallet client → Proof generation: generates proofs
packages/sdk/src/client.ts - Wallet client → Contract ABI: encodes contract calls
packages/sdk/src/client.ts - Passkey browser → Passkey operations: performs passkey
- Wallet client → Transaction relayer: submits actions
packages/sdk/src/client.ts - Connect protocol → Sign-in proofs: supports sign-in
- Relying website → Website verification: verifies sign-in
- Website verification → Sign-in proofs: verifies proofs
packages/sdk/src/server.ts - HTTP API → Network configuration: loads settings
server/index.ts - HTTP API → Request limits: throttles requests
server/index.ts - HTTP API → Transaction relayer: handles relay
server/index.ts - HTTP API → API contracts: uses API types
server/index.ts - Transaction relayer → Contract ABI: validates calls
server/relayer.ts - Transaction relayer → Arbitrum network: submits transactions
- Wallet user → Wallet account: authorizes actions
- Account factory → Wallet account: clones implementation
- Wallet account → Action rules: applies action rules
- Wallet account → Arbitrum network: records account state
- Link disclosure → Wallet client: proves consent
- ERC-7579 validator → Wallet account: validates proofs