# sinistergg/block-id architecture

> Architecture diagram of the GitHub repository sinistergg/block-id, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sinistergg/block-id
- Repository: https://github.com/sinistergg/block-id

## Overview

BLOCKID is an enterprise self-sovereign identity platform for issuing, holding, and verifying verifiable credentials with selective disclosure, blockchain anchoring, and privacy-preserving proofs. The primary workflow runs from issuer credential creation through holder custody to verifier checks and risk evaluation; separate branches cover identity access, admin, mobile wallet, biometrics, and smart wallets. Relationships are limited to those stated in the README or shown by the provided source index and excerpts; unsampled implementation details are not inferred.

Main entry points: [`src/pages/issuer/IssuerDashboard.tsx`](https://github.com/sinistergg/block-id/blob/main/src/pages/issuer/IssuerDashboard.tsx) (Issuer Portal), [`src/pages/holder/HolderWallet.tsx`](https://github.com/sinistergg/block-id/blob/main/src/pages/holder/HolderWallet.tsx) (Holder Wallet), [`src/services/api/verifier.service.ts`](https://github.com/sinistergg/block-id/blob/main/src/services/api/verifier.service.ts) (Verifier Service), [`src/App.tsx`](https://github.com/sinistergg/block-id/blob/main/src/App.tsx) (Web App Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Web Portals"]
  node_issuer["Issuer Portal"]
  node_holder["Holder Wallet<br/>[HolderWallet.tsx]"]
  node_verifier["Verifier Portal"]
  node_verify_view["Verification Workflow<br/>[VerifyView.tsx]"]
  node_admin["Organization Admin<br/>[AdminDashboard.tsx]"]
end

subgraph group_credential["Credential Lifecycle"]
  node_issue["Credential Issuance<br/>[IssueView.tsx]"]
  node_issuer_api["Issuer Service<br/>[issuer.service.ts]"]
  node_holder_api["Holder Service<br/>[holder.service.ts]"]
  node_share["Selective Sharing"]
  node_verifier_api["Verifier Service"]
  node_anchor["Credential Anchoring"]
  node_sbt["Soulbound Tokens<br/>[sbt.service.ts]"]
  node_ipfs["IPFS Storage<br/>[ipfs.service.ts]"]
end

subgraph group_trust["Trust and Privacy"]
  node_policy["Verification Policies<br/>[policy.ts]"]
  node_anomaly["Anomaly Detection<br/>[anomaly.ts]"]
  node_trust_score["Trust Scoring<br/>[trustScore.ts]"]
  node_zkp["ZK Proofs<br/>[zkp.ts]"]
  node_zkp_service["ZK Service<br/>[zkp.service.ts]"]
  node_biometrics["Biometric Anchoring"]
  node_smart_wallet["Smart Wallets"]
end

subgraph group_platform["Identity and Platform"]
  node_auth["Authentication<br/>[useAuth.tsx]"]
  node_supabase[("Supabase Client<br/>[client.ts]")]
  node_functions["Edge Functions<br/>[index.ts]"]
  node_security["Function Security<br/>[security.ts]"]
  node_app_shell["Web App Shell<br/>[App.tsx]"]
  node_ui["UI Components<br/>[button.tsx]"]
  node_toast["Toast State<br/>[use-toast.ts]"]
end

subgraph group_mobile["Mobile Wallet"]
  node_mobile_app["Mobile App<br/>[App.tsx]"]
  node_mobile_login["Mobile Login<br/>[LoginScreen.tsx]"]
  node_mobile_wallet["Mobile Wallet<br/>[WalletScreen.tsx]"]
  node_mobile_api["Mobile API<br/>[api.ts]"]
end

node_issuer_actor(("Credential issuer"))
node_holder_actor(("Credential holder"))
node_verifier_actor(("Credential verifier"))

node_issuer_actor -->|"uses portal"| node_issuer
node_issuer -->|"opens issuance"| node_issue
node_issuer -->|"uses service"| node_issuer_api
node_issue -.->|"issues credential"| node_issuer_api
node_issuer_actor -.->|"anchors credential"| node_anchor
node_issuer -->|"persists content"| node_ipfs
node_issuer -->|"mints badge"| node_sbt
node_holder_actor -->|"uses wallet"| node_holder
node_holder -.->|"loads credentials"| node_holder_api
node_holder -->|"creates share links"| node_share
node_holder -->|"creates privacy proofs"| node_zkp_service
node_zkp_service -->|"uses proof engine"| node_zkp
node_holder -.->|"uses passkeys"| node_biometrics
node_holder -.->|"uses smart wallet"| node_smart_wallet
node_verifier -.->|"opens verification"| node_verify_view
node_verifier_actor -->|"uses portal"| node_verifier
node_verify_view -.->|"submits checks"| node_verifier_api
node_verifier_api -->|"normalizes policy"| node_policy
node_verifier_api -->|"evaluates anomalies"| node_anomaly
node_verifier_api -->|"computes trust"| node_trust_score
node_verifier_api -->|"checks proof"| node_zkp
node_verifier_api -->|"stores verification"| node_supabase
node_issuer -.->|"requires session"| node_auth
node_auth -->|"authenticates"| node_supabase
node_auth -->|"loads profile"| node_supabase
node_issuer_api -.->|"accesses records"| node_supabase
node_functions -->|"checks requests"| node_security
node_admin -->|"manages organization"| node_supabase
node_app_shell -->|"provides auth"| node_auth
node_app_shell -->|"routes portal"| node_issuer
node_app_shell -->|"routes portal"| node_holder
node_app_shell -->|"routes portal"| node_verifier
node_app_shell -->|"routes portal"| node_admin
node_mobile_app -->|"restores session"| node_mobile_api
node_mobile_app -->|"shows signed out"| node_mobile_login
node_mobile_app -->|"shows signed in"| node_mobile_wallet
node_mobile_login -->|"authenticates"| node_mobile_api
node_mobile_wallet -->|"loads wallet"| node_mobile_api
node_issuer -.->|"renders controls"| node_ui
node_issuer -.->|"shows notices"| node_toast

click node_issuer "https://github.com/sinistergg/block-id/blob/main/src/pages/issuer/IssuerDashboard.tsx"
click node_issue "https://github.com/sinistergg/block-id/blob/main/src/pages/issuer/views/IssueView.tsx"
click node_issuer_api "https://github.com/sinistergg/block-id/blob/main/src/services/api/issuer.service.ts"
click node_holder "https://github.com/sinistergg/block-id/blob/main/src/pages/holder/HolderWallet.tsx"
click node_holder_api "https://github.com/sinistergg/block-id/blob/main/src/services/api/holder.service.ts"
click node_share "https://github.com/sinistergg/block-id/blob/main/src/components/ActiveShareLinks.tsx"
click node_verifier "https://github.com/sinistergg/block-id/blob/main/src/pages/verifier/VerifierDashboard.tsx"
click node_verify_view "https://github.com/sinistergg/block-id/blob/main/src/pages/verifier/views/VerifyView.tsx"
click node_verifier_api "https://github.com/sinistergg/block-id/blob/main/src/services/api/verifier.service.ts"
click node_policy "https://github.com/sinistergg/block-id/blob/main/src/lib/verifier/policy.ts"
click node_anomaly "https://github.com/sinistergg/block-id/blob/main/src/lib/ml/anomaly.ts"
click node_trust_score "https://github.com/sinistergg/block-id/blob/main/src/lib/ml/trustScore.ts"
click node_zkp "https://github.com/sinistergg/block-id/blob/main/src/lib/zkp.ts"
click node_zkp_service "https://github.com/sinistergg/block-id/blob/main/src/services/zkp/zkp.service.ts"
click node_anchor "https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/anchoring.service.ts"
click node_sbt "https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/sbt.service.ts"
click node_ipfs "https://github.com/sinistergg/block-id/blob/main/src/services/ipfs/ipfs.service.ts"
click node_biometrics "https://github.com/sinistergg/block-id/blob/main/src/services/biometrics/biometric.service.ts"
click node_smart_wallet "https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/smartWallet.service.ts"
click node_auth "https://github.com/sinistergg/block-id/blob/main/src/hooks/useAuth.tsx"
click node_supabase "https://github.com/sinistergg/block-id/blob/main/src/integrations/supabase/client.ts"
click node_functions "https://github.com/sinistergg/block-id/blob/main/supabase/functions/oid4vci/index.ts"
click node_security "https://github.com/sinistergg/block-id/blob/main/supabase/functions/_shared/security.ts"
click node_admin "https://github.com/sinistergg/block-id/blob/main/src/pages/admin/AdminDashboard.tsx"
click node_app_shell "https://github.com/sinistergg/block-id/blob/main/src/App.tsx"
click node_ui "https://github.com/sinistergg/block-id/blob/main/src/components/ui/button.tsx"
click node_toast "https://github.com/sinistergg/block-id/blob/main/src/hooks/use-toast.ts"
click node_mobile_app "https://github.com/sinistergg/block-id/blob/main/mobile/App.tsx"
click node_mobile_login "https://github.com/sinistergg/block-id/blob/main/mobile/src/screens/LoginScreen.tsx"
click node_mobile_wallet "https://github.com/sinistergg/block-id/blob/main/mobile/src/screens/WalletScreen.tsx"
click node_mobile_api "https://github.com/sinistergg/block-id/blob/main/mobile/src/lib/api.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_issuer,node_holder,node_verifier,node_verify_view,node_admin toneBlue
class node_issue,node_issuer_api,node_holder_api,node_share,node_verifier_api,node_anchor,node_sbt,node_ipfs toneAmber
class node_policy,node_anomaly,node_trust_score,node_zkp,node_zkp_service,node_biometrics,node_smart_wallet toneMint
class node_auth,node_supabase,node_functions,node_security,node_app_shell,node_ui,node_toast toneRose
class node_mobile_app,node_mobile_login,node_mobile_wallet,node_mobile_api,node_issuer_actor,node_holder_actor,node_verifier_actor toneIndigo
```

## Components

### Web Portals

- [Issuer Portal](https://github.com/sinistergg/block-id/blob/main/src/pages/issuer/IssuerDashboard.tsx): `src/pages/issuer/IssuerDashboard.tsx`
- [Holder Wallet](https://github.com/sinistergg/block-id/blob/main/src/pages/holder/HolderWallet.tsx): `src/pages/holder/HolderWallet.tsx`
- [Verifier Portal](https://github.com/sinistergg/block-id/blob/main/src/pages/verifier/VerifierDashboard.tsx): `src/pages/verifier/VerifierDashboard.tsx`
- [Verification Workflow](https://github.com/sinistergg/block-id/blob/main/src/pages/verifier/views/VerifyView.tsx): `src/pages/verifier/views/VerifyView.tsx`
- [Organization Admin](https://github.com/sinistergg/block-id/blob/main/src/pages/admin/AdminDashboard.tsx): `src/pages/admin/AdminDashboard.tsx`

### Credential Lifecycle

- [Credential Issuance](https://github.com/sinistergg/block-id/blob/main/src/pages/issuer/views/IssueView.tsx): `src/pages/issuer/views/IssueView.tsx`
- [Issuer Service](https://github.com/sinistergg/block-id/blob/main/src/services/api/issuer.service.ts): `src/services/api/issuer.service.ts`
- [Holder Service](https://github.com/sinistergg/block-id/blob/main/src/services/api/holder.service.ts): `src/services/api/holder.service.ts`
- [Selective Sharing](https://github.com/sinistergg/block-id/blob/main/src/components/ActiveShareLinks.tsx): `src/components/ActiveShareLinks.tsx`
- [Verifier Service](https://github.com/sinistergg/block-id/blob/main/src/services/api/verifier.service.ts): `src/services/api/verifier.service.ts`
- [Credential Anchoring](https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/anchoring.service.ts): `src/services/blockchain/anchoring.service.ts`
- [Soulbound Tokens](https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/sbt.service.ts): `src/services/blockchain/sbt.service.ts`
- [IPFS Storage](https://github.com/sinistergg/block-id/blob/main/src/services/ipfs/ipfs.service.ts): `src/services/ipfs/ipfs.service.ts`

### Trust and Privacy

- [Verification Policies](https://github.com/sinistergg/block-id/blob/main/src/lib/verifier/policy.ts): `src/lib/verifier/policy.ts`
- [Anomaly Detection](https://github.com/sinistergg/block-id/blob/main/src/lib/ml/anomaly.ts): `src/lib/ml/anomaly.ts`
- [Trust Scoring](https://github.com/sinistergg/block-id/blob/main/src/lib/ml/trustScore.ts): `src/lib/ml/trustScore.ts`
- [ZK Proofs](https://github.com/sinistergg/block-id/blob/main/src/lib/zkp.ts): `src/lib/zkp.ts`
- [ZK Service](https://github.com/sinistergg/block-id/blob/main/src/services/zkp/zkp.service.ts): `src/services/zkp/zkp.service.ts`
- [Biometric Anchoring](https://github.com/sinistergg/block-id/blob/main/src/services/biometrics/biometric.service.ts): `src/services/biometrics/biometric.service.ts`
- [Smart Wallets](https://github.com/sinistergg/block-id/blob/main/src/services/blockchain/smartWallet.service.ts): `src/services/blockchain/smartWallet.service.ts`

### Identity and Platform

- [Authentication](https://github.com/sinistergg/block-id/blob/main/src/hooks/useAuth.tsx): `src/hooks/useAuth.tsx`
- [Supabase Client](https://github.com/sinistergg/block-id/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- [Edge Functions](https://github.com/sinistergg/block-id/blob/main/supabase/functions/oid4vci/index.ts): `supabase/functions/oid4vci/index.ts`
- [Function Security](https://github.com/sinistergg/block-id/blob/main/supabase/functions/_shared/security.ts): `supabase/functions/_shared/security.ts`
- [Web App Shell](https://github.com/sinistergg/block-id/blob/main/src/App.tsx): `src/App.tsx`
- [UI Components](https://github.com/sinistergg/block-id/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Toast State](https://github.com/sinistergg/block-id/blob/main/src/hooks/use-toast.ts): `src/hooks/use-toast.ts`

### Mobile Wallet

- [Mobile App](https://github.com/sinistergg/block-id/blob/main/mobile/App.tsx): `mobile/App.tsx`
- [Mobile Login](https://github.com/sinistergg/block-id/blob/main/mobile/src/screens/LoginScreen.tsx): `mobile/src/screens/LoginScreen.tsx`
- [Mobile Wallet](https://github.com/sinistergg/block-id/blob/main/mobile/src/screens/WalletScreen.tsx): `mobile/src/screens/WalletScreen.tsx`
- [Mobile API](https://github.com/sinistergg/block-id/blob/main/mobile/src/lib/api.ts): `mobile/src/lib/api.ts`

### Other components

- **Credential issuer**
- **Credential holder**
- **Credential verifier**

## Connections

- Credential issuer → Issuer Portal: uses portal
- Issuer Portal → Credential Issuance: opens issuance (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
- Issuer Portal → Issuer Service: uses service (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
- Credential Issuance → Issuer Service: issues credential
- Credential issuer → Credential Anchoring: anchors credential
- Issuer Portal → IPFS Storage: persists content (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
- Issuer Portal → Soulbound Tokens: mints badge (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
- Credential holder → Holder Wallet: uses wallet
- Holder Wallet → Holder Service: loads credentials
- Holder Wallet → Selective Sharing: creates share links
- Holder Wallet → ZK Service: creates privacy proofs
- ZK Service → ZK Proofs: uses proof engine (evidence: `src/services/zkp/zkp.service.ts`)
- Holder Wallet → Biometric Anchoring: uses passkeys
- Holder Wallet → Smart Wallets: uses smart wallet
- Verifier Portal → Verification Workflow: opens verification
- Credential verifier → Verifier Portal: uses portal
- Verification Workflow → Verifier Service: submits checks
- Verifier Service → Verification Policies: normalizes policy (evidence: `src/services/api/verifier.service.ts`)
- Verifier Service → Anomaly Detection: evaluates anomalies (evidence: `src/services/api/verifier.service.ts`)
- Verifier Service → Trust Scoring: computes trust (evidence: `src/services/api/verifier.service.ts`)
- Verifier Service → ZK Proofs: checks proof (evidence: `src/services/api/verifier.service.ts`)
- Verifier Service → Supabase Client: stores verification (evidence: `src/services/api/verifier.service.ts`)
- Issuer Portal → Authentication: requires session (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
- Authentication → Supabase Client: authenticates
- Authentication → Supabase Client: loads profile
- Issuer Service → Supabase Client: accesses records
- Edge Functions → Function Security: checks requests (evidence: `supabase/functions/oid4vci/index.ts`)
- Organization Admin → Supabase Client: manages organization (evidence: `src/pages/admin/AdminDashboard.tsx`)
- Web App Shell → Authentication: provides auth (evidence: `src/App.tsx`)
- Web App Shell → Issuer Portal: routes portal (evidence: `src/App.tsx`)
- Web App Shell → Holder Wallet: routes portal (evidence: `src/App.tsx`)
- Web App Shell → Verifier Portal: routes portal (evidence: `src/App.tsx`)
- Web App Shell → Organization Admin: routes portal (evidence: `src/App.tsx`)
- Mobile App → Mobile API: restores session (evidence: `mobile/App.tsx`)
- Mobile App → Mobile Login: shows signed out (evidence: `mobile/App.tsx`)
- Mobile App → Mobile Wallet: shows signed in (evidence: `mobile/App.tsx`)
- Mobile Login → Mobile API: authenticates (evidence: `mobile/src/screens/LoginScreen.tsx`)
- Mobile Wallet → Mobile API: loads wallet (evidence: `mobile/src/screens/WalletScreen.tsx`)
- Issuer Portal → UI Components: renders controls
- Issuer Portal → Toast State: shows notices (evidence: `src/pages/issuer/IssuerDashboard.tsx`)
