1  # F006-scanner.component.cspec
  2  
  3  metadata:
  4    id: F006
  5    name: scanner
  6    version: 1.1.0
  7    domain: frontend
  8    stability: high_change
  9    updated: 2026-01-15
 10    cascade_priority: 50
 11    roles:
 12      primary: [Dev]
 13      review: []
 14    expertise:
 15      required: [react, nextjs, indexer]
 16      helpful: [blockchain_explorers, data_viz]
 17    context_tags: [scanner, explorer, transparency, dashboard, governors]
 18  
 19  dependencies:
 20    upstream: [F001, F008, F009]
 21    downstream: []
 22  
 23  interface:
 24    types_ref: _registry/types.cspec
 25    types:
 26      block: {height: u64, hash: bytes32, timestamp: u64}
 27      transaction: {id: bytes32, type: enum, status: enum}
 28      governor_status: {address: address, balance: u128, mint_history: []}
 29  
 30    functions:
 31      get_block: {inputs: [height], outputs: [block]}
 32      get_transaction: {inputs: [id], outputs: [transaction]}
 33      search: {inputs: [query], outputs: [results]}
 34      get_governor_status: {inputs: [address], outputs: [governor_status]}
 35  
 36  spec:
 37    # === PURPOSE ===
 38    purpose: Block explorer and transparency dashboard (ALPHA-Scanner)
 39  
 40    # === STRUCTURE ===
 41    structure:
 42      acdc-scanner/:
 43        web/: nextjs_application
 44        api/: backend_api
 45        indexer/: chain_indexer
 46  
 47    # === MODES ===
 48    modes:
 49      dashboard:
 50        default: true
 51        features:
 52          - network_status
 53          - governor_transparency_charts
 54          - validator_prover_status
 55          - alpha_governance_activity
 56          - delta_governance_activity
 57          - oracle_rates
 58          - cross_chain_health
 59        audience: all_users
 60  
 61      explorer:
 62        default: false
 63        features:
 64          - block_list
 65          - transaction_search
 66          - address_lookup
 67          - governor_detail_pages
 68          - proposal_detail_pages
 69          - raw_data_access
 70        audience: developers_power_users
 71  
 72    # === REQUIRED SECTIONS ===
 73    sections:
 74      network_status:
 75        - current_block_height
 76        - network_health
 77        - peer_count
 78      governor_transparency:
 79        - outstanding_balances
 80        - mint_burn_history
 81        - governance_participation
 82      validator_status:
 83        - active_validators
 84        - stake_distribution
 85        - uptime_metrics
 86      prover_status:
 87        - active_provers
 88        - proof_throughput
 89      alpha_governance_activity:  # Governor voting
 90        - active_alpha_proposals
 91        - governor_votes
 92        - historical_alpha_outcomes
 93      delta_governance_activity:  # DX staker voting
 94        - active_delta_proposals
 95        - dx_staker_votes
 96        - historical_delta_outcomes
 97      oracle_rates:
 98        - current_rates
 99        - oracle_health
100        - historical_rates
101      cross_chain_health:
102        - attestation_status
103        - sax_backing_ratio
104  
105    # === GOVERNOR MIRRORS ===
106    mirrors:
107      requirement: each_governor_minimum_1
108      features:
109        - localized_language_national
110        - public_api_access
111        - data_retention_52_to_364_epochs
112      update_frequency: every_5_minutes
113  
114    # === ORACLE MONITOR ===
115    oracle_integration:
116      ui_section: alpha_scanner_rates
117      api_access: programmatic
118      features:
119        - real_time_feeds
120        - multi_oracle_comparison
121        - failover_status
122        - deviation_alerts
123  
124  changelog:
125    - version: 1.1.0
126      date: 2026-01-15
127      type: enhancement
128      description: "Split governance activity into Alpha (governors) and Delta (DX stakers)"
129      breaking: false
130  
131    - version: 1.0.0
132      date: 2026-01-14
133      type: initial
134      description: "Initial scanner spec from UI/UX Specification v1.0"
135      breaking: false