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 | CES-based synthesized scoring with an HHI diversity bonus is 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 is no longer the old linear 1.0 / 1.5 / 1.5 weighting model. The code now uses:
Final Score = A × [α·F^ρ + β·J^ρ + γ·H^ρ]^(1/ρ) × (1 + k × (1 - HHI))Where F, J, H are Florin / Joule / HoW balances; α, β, γ are their per-token weights; ρ is the CES substitution parameter; A is total factor productivity (network-wide scaling constant); k is the diversity bonus coefficient; and HHI is the Herfindahl-Hirschman Index of contribution concentration. See Scoring Algorithms for the derivation.
Current defaults in the service layer:
alpha (α) = 1.0— Florin weightbeta (β) = 1.0— Joule weightgamma (γ) = 1.0— HoW weightrho (ρ) = -0.5— substitution parameter (moderate complementarity)k = 0.3— diversity bonus coefficient
Important consequences:
- Balanced portfolios are rewarded through the HHI diversity bonus.
- Single-token holders are no longer over-rewarded by the old zero-input bug.
- 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 distributed across three pools:
- Retroactive pool: 20%
- Seed pool: 10%
- Contribution emission: 70% -- mined over time through participation
Within the 70% contribution emission pool (7,000,000,000 tokens), allocation follows a 5-epoch fixed model:
- 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: 8-tier ladder used by the app's Network Standing surfaces. Five middle tiers are CES-derived (
INITIATE,EXPLORER,NAVIGATOR,FOUNDER); the bottom three (GHOST,GUEST,OBSERVER) and the top one (FOUNDING_GUARDIAN) are not score-derived.OBSERVERis the default for any account that has not yet earned a score;GHOST/GUESTare derived from the standing logic;FOUNDING_GUARDIANis a manually-assigned co-founder display label (m.contribution_level_source = 'manual'in Neo4j) that combinesFOUNDERtier weight with elevated standing — there is exactly one founder so it's a unique display label, not a separate CES tier. The canonical display string is "Founding Guardian" (Title Case) / "FOUNDING GUARDIAN" (caps pill). - 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: CES 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