ƒxyzƒxyz Docs

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

AreaCurrent state
Token foundationFlorin, Joule, HoW, and membership credential flows are built around Solana Token-2022 on mainnet-beta
Identity modelMembers, personas, standings, and contribution levels are modeled separately instead of being collapsed into one field
ScoringCES-based synthesized scoring with an HHI diversity bonus is active in the contribution service and the ranking cron
Data layerNeo4j stores member identity, circles, expertise, graph relationships, and scoring metadata
API layerGraphQL Yoga is the canonical application API; REST handles service-specific routes such as Bridge, Fixie, Solana, documents, and prices
Frontend surfaceThe monorepo runs app, api, docs, web, and shared packages on Next.js 16 + React 19
Deployment surfaceFrontend 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 weight
  • beta (β) = 1.0 — Joule weight
  • gamma (γ) = 1.0 — HoW weight
  • rho (ρ) = -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. OBSERVER is the default for any account that has not yet earned a score; GHOST/GUEST are derived from the standing logic; FOUNDING_GUARDIAN is a manually-assigned co-founder display label (m.contribution_level_source = 'manual' in Neo4j) that combines FOUNDER tier 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-did integration
  • 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

On this page