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 · CES inflow into Formula B conviction accumulator with an HHI diversity bonus · 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 (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) + CES_inflow(t). Nothing decays; every token routes.
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 CES tiers; the four upper tiers are CES-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: 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