Morpheus Lumerin Node

The purpose of this software is to enable interaction with distributed, decentralized LLMs on the Morpheus network through a desktop chat experience.

v7.0.0 — Full TEE capability. The v7 release completes a two-hop Trusted Execution Environment (TEE) trust chain for any model registered on-chain with the tee tag:

• Phase 1 — consumer → P-Node. A consumer proxy-router (v6.0.0+) cryptographically verifies the provider's P-Node runs the exact official hardened -tee image inside a genuine Intel TDX SecretVM, with TLS pinning, at session open and on every prompt.
• Phase 2 (new in v7) — P-Node → backend LLM. The v7+ P-Node itself verifies the backend LLM it forwards inference to (CPU TDX quote, TLS pinning, workload RTMR3 replay of the backend's docker-compose.yaml, CPU-GPU nonce binding, and NVIDIA NRAS GPU attestation) at startup and on every prompt.

Because Phase 2 runs inside the attested P-Node, any v6+ consumer is forward-compatible with a v7+ provider and gains the Phase 2 guarantees automatically — no client-side upgrade required. See the TEE reference, the SecretVM quickstart, and the TEE backend verification developer reference.

Documentation

The canonical documentation lives at nodedocs.mor.org. Source files are in /docs and built with Mintlify. The site replaces the previous 00-overview.md / 02-*.md / 04-*.md / 99-troubleshooting.md set of files; old paths still resolve via redirects in docs/docs.json.

The site is structured around role-based journeys (consumer / prosumer / provider tiers), with anti-hallucination AI knowledge pages and curated mirrors of the broader ecosystem (mor.org, tech.mor.org, active.mor.org, MyProvider, Everclaw, NodeNeo, app.mor.org).

What's in this repo

• Lumerin proxy-router — background process that monitors blockchain contract events, manages secure sessions between consumers and providers, and routes prompts and responses between them.
• ui-desktop/ (MorpheusUI) — Electron desktop app for consumers. Release assets are *-morpheus-app-* installers (.dmg / .AppImage / portable .exe); on first launch the app downloads the proxy-router, a local llama.cpp + tinyllama demo model, and an IPFS (kubo) node. There is no zip / mor-launch package in current releases.
• cli/ — CLI client (*-morpheus-cli-* release binaries; local builds produce mor-cli).
• Standalone *-morpheus-router-* release binaries for headless / provider deployments.

End-to-end picture

0. PreRequisites: BASE Layer 2 Blockchain, MOR and ETH on BASE for staking and bidding.
1. Existing, Hosted AI model available for inference via the Morpheus network.
2. The proxy-router talks to and listens to the blockchain; it routes prompts and inference between providers' models and consumers.
3. Providers register their models via bids on the blockchain.
4. The consumer node is the "client" that purchases bids, sends prompts via the proxy-router, and receives inference back from the provider's models.
5. Consumers stake MOR to open a session for the duration they intend to use.
6. Once the session is open, prompt and inference (ChatGPT-like) can start.

Tokens and contract information

Item	BASE Mainnet	BASE Sepolia (testnet)
Chain ID	8453	84532
Branch	main (MAIN-* releases)	test (*-test releases)
MOR Token	0x7431aDa8a591C955a994a21710752EF9b882b8e3	0x5C80Ddd187054E1E4aBBfFCD750498e81d34FfA3
Diamond Marketplace	0x6aBE1d282f72B474E54527D93b979A4f64d3030a	0xA328196f2438DADA5ab729E39388D86896c27c85
Block Explorer	https://base.blockscout.com/	https://base-sepolia.blockscout.com/

You will need both MOR (for stake / fees / session payment) and ETH on BASE (for gas) in your wallet.

Quickstart

Role	Start here
Consumer (chat)	Consumer quickstart
Provider (host your own model)	Provider quickstart
TEE provider (SecretVM)	SecretVM quickstart
Resale provider	Resale overview
Prosumer / agent	Prosumer overview
Developer (API)	API overview

Contributing

PRs should target dev, not main. Changes promote dev → test → main.

See CONTRIBUTING.md for the branch model, PR checklist, and local docs/proxy-router tips. The GitHub PR template reminds you to pick the right base branch.

For AI agents reading this repo

Start with AGENTS.md — hard rules, quick lookup tables, and ingestion instructions.

To load the full documentation corpus in one fetch:

Resource	URL	Use
Full corpus (preferred)	llms-full.txt	Complete markdown export — primary ingestion path
Page index	llms.txt	Titles, descriptions, and per-page .md links
Page Markdown	append .md or non-browser fetch	Same page URL returns clean Markdown when Accept lacks text/html
Docs MCP	/mcp	Search / retrieve pages without scraping HTML

See AGENTS.md for priority reading slugs and anti-hallucination rules.