Technical Documentation

Architecture Directory & Guide Catalog

NodeHash coordinates decentralized multi-party barter cycles, clears mutual credit obligations without fiat reserves, and enforces Sybil resistance through cryptographic sponsor lineage. These guides explain protocol mechanics, onboarding sequences, and candidate ranking pipelines.

💡
Core Invariant: Hard Depth Cap (K ≤ 3)

The barter matching engine discovers only 2-way bilateral and 3-way trilateral closed trade loops. Longer cycles with 4 or 5 parties remain disabled at the graph traversal layer. This constraint bounds counterparty delivery risk, avoids exponential search latencies, and guarantees sub-second cycle resolution.

Architectural Overview

The NodeHash network combines graph theory, decentralized identity, and double-entry mutual credit into five foundational subsystems:

Bidirectional Profile Pairing

Every network participant maintains two paired portfolios: a supply_profile defining skills and compute they provide, and a demand_profile specifying needs they want fulfilled. This dual-sided structure powers cycle discovery.

Two-Tier Value Taxonomy

Categorization adheres to a strict depth limit of 2. Tier 1 Primary Tags cluster candidates into candidate pools, while Tier 2 Sub-Tags score precision affinity using Jaccard similarity metrics.

7-State AI Lifecycle Machine

Trades advance through deterministic states: REGISTERED, CLASSIFIED, MATCHED, RANKED, NEGOTIATING, COMPLETED, and RECORDED with zero-sum ledger finality.

Graph-Based Trust Lineage

Newcomers join via sponsor endorsement codes. Sybil attacks become economically irrational because dispute liability ripples back through the sponsor tree with geometric damping: factor = 0.5^(depth - 1).

Core Guide Catalog

Explore detailed implementation walkthroughs and protocol references:

Install native iOS, Android, or Web clients. Activate your sponsor endorsement code, generate hardware-backed passkeys, and configure your first supply and demand items.

Master the two-tier skill classification tree. Learn how candidate pools cluster via Tier 1 Primary Tags, how Tier 2 Sub-Tags determine affinity ranking, and why depth is strictly capped at 2.

Synchronize time zones across global peers. Configure 168-hour weekly availability windows and compute temporal overlap scores for candidate cycles.

Inspect automated term convergence. Discover how the autonomous AI mediator drafts compromise proposals, schedules milestones, and tracks consensus.

Secure deliverables with milestone hash commitments. Sign fulfillment attestations with passkey signatures and unlock credit transfers with zero counterparty drift.

Calculate dynamic credit allowances based on verified transaction turnover. Understand positive balance caps, demurrage decay rules, and credit freeze conditions.

Quick Health Check

Verify your connection to the NodeHash API daemon using curl:

Shell
curl -X GET http://localhost:3000/api/v1/health

Expected response confirms that the taxonomy index and cycle graph engine are ready:

JSON Response
{
  "status": "healthy",
  "version": "1.0.0",
  "services": {
    "database": "connected",
    "taxonomy": "ready",
    "cycleEngine": "active"
  }
}