README.md

metadata

title: CHAINSTATE Chat
emoji: ⛓
colorFrom: gray
colorTo: blue
sdk: gradio
sdk_version: 4.44.0
python_version: '3.11'
app_file: app.py
pinned: true
license: mit
short_description: Chat with the CHAINSTATE symbolic-weight blockchain

Φ CHAINSTATE Chat

A conversational interface to the CHAINSTATE symbolic-weight blockchain on Base mainnet 8453, with full integration to the Ornith × CHAINSTATE ecosystem (visual builder · terminal · agent · simulation · AGI dashboard) and the ASI-Evolve loop.

Every message you type is dispatched to the CHAINSTATE swarm: processed through the 65,536-dimensional symbolic embedding, consensus-pooled via reputation-weighted Bayesian log-pooling, and returned as a verifiable ⛓ consensus receipt. An interpreter LM renders that receipt as a long-form conversational response with organized sections (Direct Answer, Reasoning, Code, Math, Examples, and the on-chain Consensus Receipt).

Header controls · left → right

Four things sit on the right side of the header, each doing something the old chat didn't:

Control	What it does
DEMO / LIVE toggle	DEMO preloads a three-turn transcript that shows a pure-symbol query (∫∂x → ?), an AGI/ASI-Evolve interaction (round-32 best NWO-ASM program), and code generation (Python SHA3-256). Toggle LIVE to clear and dispatch your own queries. State persists to localStorage['cs-mode'].
Connect Wallet	EIP-1193 wallet connect (MetaMask, Rabby, Coinbase, Frame). Auto-switches to Base 8453 (chainId: 0x2105). Once connected, the button shows your truncated address (click to copy). Address stored in localStorage['cs-wallet'].
SOURCE	→ cpater-chainstate.static.hf.space — the main CHAINSTATE app (wallet ops, staking, node registration, treasury). Opens in the same window.
CODE	→ cpater-ornith-chainstate.static.hf.space — the Ornith × CHAINSTATE builder / terminal / agent / simulation / AGI dashboard. Opens in the same window.

An i button next to CODE opens the full feature guide modal.

How it works

        ┌─────────────────────┐
        │   User types in     │      DEMO mode: chatbot preloaded with
        │  the Gradio chat UI │      three example turns. LIVE mode:
        └──────────┬──────────┘      empty; type to dispatch.
                   │
                   ▼
        ┌─────────────────────┐
        │  CHAINSTATE Worker  │      Edge dispatcher (Cloudflare Worker
        │      POST /query    │      · 300+ edge locations)
        └──────────┬──────────┘
                   │
                   ▼
        ┌─────────────────────┐
        │  Symbolic consensus │      6 subspaces × 65,536 dims
        │  via log-pooling    │      k=10 nodes (v0.4.0 heterogeneous:
        │                     │      lang-detect · codepoint-density ×8
        │                     │      · unicode-category)
        └──────────┬──────────┘      Convergence: cos ≥ 0.95 in 3–7 rounds
                   │
                   ▼
        ┌─────────────────────┐
        │  Consensus receipt  │      dominant_subspace, top_symbols,
        │  returned to Space  │      confidence, rounds_run, gas,
        │                     │      cache, truth_lattice, verdict
        └──────────┬──────────┘
                   │
                   ▼
        ┌─────────────────────┐
        │  Interpreter LM     │      Receipt + history + query →
        │  via HF Router      │      structured markdown response,
        │  (SSE streaming)    │      streamed token-by-token
        └──────────┬──────────┘
                   │
                   ▼
        ┌─────────────────────┐
        │   User sees long-   │      ## Direct Answer
        │  form chat response │      ## Reasoning
        │  + ⛓ receipt at end │      ## Code / ## Math (if applicable)
        │                     │      ## ⛓ Consensus Receipt
        └──────────┬──────────┘
                   │
                   ▼ (if wallet connected)
        ┌─────────────────────┐
        │  Chat pair saved to │      localStorage['cs-chat-<addr>']
        │  browser localStore │      Restored on next visit with the
        │  keyed to wallet    │      same wallet — "Saved chat found"
        └─────────────────────┘      strip appears above the chatbot.

Architecture explained

CHAINSTATE on its own returns structured receipts, not prose. A query like "explain CRDTs" comes back as a JSON object describing which symbolic subspace dominated, which top-k symbols emerged from consensus, the participating node count, confidence, gas, and cache status. That's the unique CHAINSTATE artifact: every response is an on-chain consensus receipt.

For a normal user typing into a chat interface, the receipt alone is not enough. The user expects long-form English, code samples, mathematical notation, organized sections. The interpreter LM provides that layer.

Layer	Role	Owner
Gradio Blocks UI (this Space)	Chat UX · header · wallet · DEMO/LIVE · session persistence	This Space
CHAINSTATE Worker (/query)	Symbolic consensus · 10-peer heterogeneous swarm · 4-dim modal receipts	Cloudflare Workers
Interpreter LM (Llama-3.1-8B-Instruct, default)	Long-form rendering of receipts as conversation	HF Router → any Inference Provider
Browser localStorage	Wallet address + chat pairs keyed to address	Client (this Space's JS)
Receipt section in every reply	Transparency / on-chain proof	Both layers

Why this is honest — the swarm consensus is real. The interpreter LM is openly disclosed as the language-rendering layer. The receipt is shown verbatim under a ⛓ Consensus Receipt section in every reply, so the user always sees exactly what came back from the chain. The worker never sees your wallet — persistence is purely client-side.

Where this is going — as actual swarm nodes come online (each running a real LM), the consensus over text outputs will become the interpreter, and the external LM call will get displaced. This Space is the today-shape of the long-term vision. The four-dimensional modal receipt (Epistemic · Doxastic · Deontic · Dynamic) already produced by the CODE app's ASI-Evolve loop is available through this chat too — ask about it directly.

Examples to try

The Space has eight one-click examples exercising every feature:

Query	What it tests
∫∂x → ?	Pure math subspace routing (4,096-d)
Explain the four-dimensional modal receipt (Epistemic · Doxastic · Deontic · Dynamic)	Self-explanation of the AGI-tier receipt structure
What is the ASI-Evolve fitness function S(π) with the hard Deontic veto?	Alignment-by-construction math
Show me a NWO-ASM program with QPU dispatch and referrer metadata	Code generation across ecosystem opcodes
Compare CHAINSTATE truth lattice L={b,M}^4 to RLHF	Meta-comparison against frontier LM alignment
道 心 学 智 一 二 三	Multi-script CJK routing (16,384-d language)
🧠 🤔 💎 → ✨	Pure emoji + control routing
What is reputation-weighted Bayesian log-pooling?	Foundational self-explanation

Wallet & session persistence

Connecting a wallet unlocks session memory:

• Address stored in localStorage['cs-wallet']
• Chat pairs serialized to localStorage['cs-chat-<address>'] after every response
• On return with the same wallet, a strip appears above the chatbot: "Saved chat found for this wallet · N KB" with Restore / Discard buttons
• Click the wallet button (once connected) to copy your full address to the clipboard

Auto-switches to Base mainnet 8453 on connect. Nothing is signed, no gas is spent — this chat is read-only. Write operations (staking, node registration, treasury) live in the SOURCE app.

Configuration

The Space reads six environment variables. All are optional; defaults produce a fully-functional Space.

Variable	Default	Notes
CHAINSTATE_WORKER	https://chainstate-worker.ciprianpater.workers.dev	The CHAINSTATE edge worker URL
CHAINSTATE_ADAPTER	https://chainstate-code.onrender.com	Ornith / ASI-Evolve adapter (used when the interpreter answers AGI-related questions)
HF_TOKEN	(auto on HF Spaces)	HuggingFace token — only required for gated interpreter models
INTERPRETER_MODEL	meta-llama/Llama-3.1-8B-Instruct	Any chat-capable model on HF Router
INTERPRETER_URL	https://router.huggingface.co/v1/chat/completions	OpenAI-compatible endpoint
INTERPRETER_PROVIDER	""	Pin a specific provider: together, hf-inference, fireworks-ai, sambanova, cerebras, nebius, novita, hyperbolic, replicate

To swap the interpreter, set INTERPRETER_MODEL in the Space's Settings to e.g. mistralai/Mistral-7B-Instruct-v0.3, Qwen/Qwen2.5-7B-Instruct, or meta-llama/Llama-3.3-70B-Instruct. The default uses Llama-3.1-8B-Instruct because it has the best instruction following at this size; Llama models require accepting the license on HF and a token with the right access — the auto-injected HF_TOKEN on Spaces covers this for most accounts.

Deploy your own

This Space is part of the main CHAINSTATE repo, under hf-chat/. To run your own instance:

1. Create a new Space on HuggingFace:
   • SDK: Gradio
   • Hardware: CPU basic (the inference is offloaded to the HF Router)
   • Make it public or private as you prefer
2. Push these three files to the new Space:
   • app.py
   • requirements.txt — the version pins matter, don't loosen them
   • README.md (with the YAML frontmatter at the top of THIS file)
3. Set environment variables in the Space's Settings if you want to customize (all are optional):
   • CHAINSTATE_WORKER, CHAINSTATE_ADAPTER, INTERPRETER_MODEL, INTERPRETER_PROVIDER
4. Wait ~1–2 minutes for the Space to build and start.
5. Test with one of the eight example queries in the Space.

If you want auto-deploy from GitHub (similar to how CPater/chainstate static space is wired in .github/workflows/deploy.yml), add a second job to that workflow targeting your new Space ID.

Local development

cd hf-chat
pip install -r requirements.txt
export HF_TOKEN='hf_...'   # from huggingface.co/settings/tokens
export CHAINSTATE_WORKER='https://chainstate-worker.ciprianpater.workers.dev'
export CHAINSTATE_ADAPTER='https://chainstate-code.onrender.com'
python app.py
# Open http://localhost:7860

What this gives you that a regular LM doesn't

• A verifiable consensus receipt at the bottom of every reply — proof the response was processed through reputation-weighted Bayesian log-pooling over a heterogeneous 10-peer swarm (lang-detect · codepoint-density ×8 · unicode-category), not one model's hallucination
• A dominant_subspace classification of every query, surfacing how CHAINSTATE interpreted the input (math vs occult vs language vs sci vs emo vs ctrl)
• Top-k symbol emergence — the three highest-weighted symbols from the log-pool's softmax, useful for understanding the chain's interpretation vector
• Direct access to the AGI/ASI-Evolve loop — ask about the current best-scoring NWO-ASM program, the four-dimensional modal verdict, the fitness function with hard Deontic veto, the substrate cost economics; the interpreter has that context baked in
• A clean separation of consensus and rendering — the receipt is cryptographically verifiable (with future swarm node attestations); the interpreter is replaceable per Space settings
• Wallet-tied browser persistence — connect once, come back weeks later, your chat is still there
• Zero-friction trial — no wallet, no API key, no signup required to use the chat. Everything above works anonymously; wallet is only needed for the memory layer
• The same $STATE gas model and $0.000019-per-query economics as the rest of the CHAINSTATE stack; substrate calls on the CODE app settle in USDC with atomic 15% referrer share via the MetaStateSplitter contract at 0x93a7962f75475b7e3Fbb62d3A23194f8833b1BE4

CHAINSTATE Chat · v0.7.3

Two-panel interface for the CHAINSTATE distributed cognition substrate:

• Left: chat with the substrate — every message becomes a POST /query against chainstate-worker.ciprianpater.workers.dev
• Right: full v0.7.3 receipt panel — semantic grounding + modal quadruple + on-chain anchor status + optional Cardiac-verified requester identity

What the receipt panel shows (public substrate output only)

• Query text + qHash
• Consensus: dominant subspace · confidence · nodes · depth · execution ms · cache HIT/MISS
• Semantic grounding (v0.7.0): encoder · dim · truncated hash preview · top-3 nearest priors
• Modal assessors: Epistemic · Doxastic · Deontic (with any flagged Deontic categories) · Dynamic
• Truth lattice · verdict
• Requester identity (if Cardiac rootTokenId provided): verified · type · display name
• On-chain anchor status (v0.7.3): Anchor contract · tx hash (Basescan link) · block
• Substrate cost (USDC) · timestamp
• Recent-receipts strip: last 5 receipts from the current session

What is NEVER shown (defense in depth)

• API keys, bearer tokens, private keys, PEM blocks
• *_KEY, *_TOKEN, *_SECRET, *_PRIVATE, *_MNEMONIC values
• BIP-39 mnemonics
• 60+ character hex strings (potential private keys)
• Environment variables, config files, worker source paths
• KV keys or internal cache identifiers
• Full 65,536-d symbolic_state or raw model weights
• AUDIT_ADMIN_TOKEN, ANCHOR_QUEUE_TOKEN, AGI_PRIVATE_KEY

Two redaction layers enforce this:

1. redact_string() — regex scrubs secret-shaped tokens
2. redact_receipt() — recursively drops fields with forbidden keys

v0.7.3 features covered

• Semantic grounding (v0.7.0): 384-dim MiniLM + top-3 nearest priors
• Modal quadruple: Epistemic · Doxastic · Deontic · Dynamic
• Deontic ruleset: 7 categories including genomic_integrity hard veto
• Requester enrichment (v0.7.3): optional X-NWO-Cardiac-Root-Token-Id header
• On-chain anchor (v0.7.3): CHAINSTATEAnchor at 0x1244166274… on Base 8453
• Fallback safety: if the worker is unreachable, the panel switches to a clearly-labeled demo receipt with a warning; no cached/stale live data is shown

Live infrastructure referenced

• Worker: https://chainstate-worker.ciprianpater.workers.dev
• Encoder: https://chainstate-encoder.onrender.com
• Priors: https://chainstate-priors.onrender.com
• Anchor microservice: https://chainstate-anchor.onrender.com
• Anchor contract: 0x1244166274… · Base 8453 · verified
• Cardiac Extensions: 0x5438854ead… · Base 8453 · verified

Related

• Paper 3 · Rev 2 — Verifiable Autonomous Cognition at the Frontier · 21 pages · v0.3.0→v0.6.0 arc · math per phase · frontier LM comparison · geopolitics · roadmap
• Paper 2 — CHAINSTATE CODE: A Formal Framework for Agentic Coding on a Symbolic-Weight Blockchain
• Paper 1 — CHAINSTATE Whitepaper v1.0
• Source — chainstate · chainstate-code
• Author — Ciprian Florin Pater · nwo.capital · Imperium Romanum Digital Nation State · University of Agder, Norway
• Worker — /status

License

MIT. See LICENSE in the parent repo.