Technical Overview
Current implementation state across scoring, identity, APIs, graph systems, and planned gaps.
Short-form system view: what is live, what changed, and what is planned. Grounded in the current codebase and architecture tracker.
What Is Live Now
| Area | Current state |
|---|---|
| Token foundation | Florin, Joule, HoW, and membership credential flows are built around Solana Token-2022 on mainnet-beta |
| Identity model | Members, personas, standings, and contribution levels are modeled separately instead of being collapsed into one field |
| Scoring | ƒxyz position model · weighted contribution magnitude with an HHI breadth bonus feeding the Formula B conviction accumulator · active in the contribution service and the ranking cron |
| Data layer | Neo4j stores member identity, circles, expertise, graph relationships, and scoring metadata |
| API layer | GraphQL Yoga is the canonical application API; REST handles service-specific routes such as Bridge, Fixie, Solana, documents, and prices |
| Frontend surface | The monorepo runs app, api, docs, web, and shared packages on Next.js 16 + React 19 |
| Deployment surface | Frontend and API deployment targets are documented around Coolify on bare metal infrastructure |
Contribution And Ranking Model
The current contribution engine replaces both the old linear 1.0 / 1.5 / 1.5 weighting model and the retired CES mean with Option B, weighted magnitude × breadth:
Final Score = A × (w_F·F + w_J·J + w_H·H) × (1 + k × (1 - HHI))Where F, J, H are effective Florin / Joule / HoW contributions; w_F, w_J, w_H are their per-input weights; A is total factor productivity (network-wide scaling constant); k is the breadth-bonus coefficient; and HHI is the Herfindahl-Hirschman Index of contribution concentration. See Scoring Algorithms for the derivation.
Current defaults in the service layer:
w_F = w_J = w_H = 1.0: equal input weightsk = 0.3: diversity bonus coefficientrho = -0.5remains a lineage-only parameter for the retiredcesAggregatehelper; it does not affect the live score
Important consequences:
- The weighted magnitude is monotone: more contribution on any axis always raises the score.
- Lower HHI earns a breadth bonus, rewarding balanced contribution without zeroing specialists.
- The retired exact-zero re-normalization cliff no longer affects single-axis contributors.
- Allocation amount can still act as a floor on contribution level where the later architecture phases require it.
Emission Schedule
Total supply is 10,000,000,000 tokens (10B) for regulatory and member-communication purposes, distributed across three pools:
- Retroactive pool: 20%
- Genesis pool: 10%
- Contribution emission: 70% -- earned over time through participation
Architectural note: the 10,000,000,000 (10B) total supply is the single canonical figure, the accounting ceiling, locked under tokenomics v4.1. The per-member steady-state ceiling inflow ÷ (1 − α) is an implementation detail of the Formula B conviction accumulator (how one member's balance approaches its bound), not a competing supply claim. The network envelope never exceeds the 10B ceiling.
Within the 70% contribution emission pool (7,000,000,000 tokens), Joule and HoW emissions transform continuously into ƒxyz via mass-conserving applyTransform (Yakovenko-Drăgulescu 2000) over a 180-day window (Joule) and 365-day window (HoW); Florin routes event-driven on time-deposit unlock, allocation vesting, or redemption. The transformed mass feeds the Formula B conviction accumulator y(t+1) = α(tier) · y(t) + score_inflow(t). Nothing decays; every token routes.
The live emission schedule uses five fixed epochs over 20 years, not a halving formula.
The category split for net emission across the 70% pool:
- Joule: 33%
- HoW: 33%
- Florin: 33%
- Governance reserve: 1%
Identity Model
Current identity state separates three concerns:
- Standing: lifecycle state such as
GHOST(pre-onboarding),GUEST,ACTIVE,INACTIVE,SUSPENDED,REVOKED,BANNED - Contribution level: the five canonical tiers (
OBSERVER,INITIATE,EXPLORER,NAVIGATOR,FOUNDER).OBSERVERis the default for any account that has not yet earned a score;GHOST/GUESTare derived from the standing logic and are not contribution tiers; the four upper tiers are score-derived. - Ring: percentile bucket used for relative ranking
This is a major cleanup from earlier docs that mixed lifecycle and rank into one enum.
High-Value Subsystems
- Membership: non-transferable membership certificates, proofs, and persona-linked identity
- Membership credential minting: Minting live through the current Solana membership flow
- Knowledge graph: Neo4j-backed network graph, FIBO-aligned entity modeling, and relationship-driven views
- Fixies: AI-agent route family and supporting service surface
- Bridge flows: fiat on/off-ramp infrastructure and KYC-related route families
- Scoring and expertise: Option B magnitude × breadth scoring, domain expertise profiles, and stellar metadata fields
Still Planned Or In Progress
The latest architecture tracker still leaves several phases open:
- On-chain identity /
sol-didintegration - Credential live-update triggers when score or metadata changes
- Privacy and CryptoGrapher surface completion
- Bridge compliance hardening and remaining operational fixes
For the longer implementation tracker, use Architecture / Current State. For the scientific and design material behind the system shape, use Research Atlas.
Where To Go Next
- Architecture tracker: Current State
- Algorithms and math context: Algorithm Reference
- Graph and network foundations: /docs/TheNetwork
- Local setup: Local Development