How kashyapanand21/arguschain works
ArgusChain manages classified engineering files through wallet-based identity, contract-enforced permissions, encrypted file storage, and auditable decisions. The principal workflow is sign-in, asset discovery and permission resolution, then an authorized content read or export; classified grants can enter an approval workflow. The browser signs state changes, while the backend authenticates, evaluates requests, serves encrypted files, and records decisions. Contract responsibilities and several product capabilities are documented in the README; backend and frontend wiring beyond the sampled files is shown only where supported.
Main entry points: index.ts HTTP API · chain.ts Chain Client · assets.ts Asset Service · session.tsx Wallet Session
Components 26
Browser Console
- App Router
frontend/src/main.tsx - Wallet Session
frontend/src/lib/session.tsx - File Explorer
frontend/src/pages/Explorer.tsx - Asset Detail
frontend/src/pages/AssetDetail.tsx - Proposals
frontend/src/pages/RiskAndProposals.tsx - Administration
frontend/src/pages/Admin.tsx
Backend Services
- HTTP API
backend/src/index.ts - SIWE Authentication
backend/src/controllers/auth.ts - JWT Guard
backend/src/middleware/auth.ts - Asset Service
backend/src/controllers/assets.ts - Permission Resolver
backend/src/pdp.ts - Risk Scoring
backend/src/risk.ts - Decision Audit
backend/src/audit.ts - Chain Client
backend/src/chain.ts - File Encryption
backend/src/storage.ts
On-chain Authority
- Identity Credential
contracts/ArgusIdentity.sol - DID Registry
contracts/identity/EthereumDIDRegistry.sol - Role Registry
contracts/RoleRegistry.sol - Asset Registry
contracts/AssetNFT.sol - Access Rules
contracts/AccessRegistry.sol - Grant Workflow
contracts/GrantWorkflow.sol - Audit Anchor
contracts/AuditAnchor.sol
Stored Data
- Decision Database
backend/prisma/schema.prisma - Encrypted Files
backend/src/storage.ts
Other components
- User
- Wallet
Connections 29
- User → App Router: uses
- App Router → Wallet Session: provides session
- Wallet Session → Wallet: requests signature
- Wallet Session → HTTP API: requests nonce, verifies
- File Explorer → HTTP API: lists assets
- Asset Detail → HTTP API: requests details, content
- Proposals → HTTP API: requests proposals
- Administration → HTTP API: requests administration
- Wallet → Identity Credential: signs state changes
- HTTP API → SIWE Authentication: dispatches auth
- HTTP API → Asset Service: dispatches assets
- HTTP API → Decision Audit: dispatches audit
- HTTP API → JWT Guard: guards protected routes
- SIWE Authentication → Chain Client: reads identity, roles
- Asset Service → Permission Resolver: checks permissions
- Asset Service → Chain Client: reads asset state
- Asset Service → File Encryption: stores, decrypts files
- Asset Service → Risk Scoring: scores requests
- Asset Service → Decision Audit: records decisions
- Decision Audit → Decision Database: reads, writes log
- File Encryption → Encrypted Files: writes, reads ciphertext
- Chain Client → Identity Credential: reads
- Chain Client → DID Registry: reads
- Chain Client → Role Registry: reads
- Chain Client → Asset Registry: reads
- Chain Client → Access Rules: resolves access
- Wallet → Grant Workflow: submits proposals
- Wallet → Asset Registry: mints assets
- Audit Anchor → Decision Database: anchors roots