# Morpheus Lumerin Node

> The canonical Morpheus DeAI knowledge base for humans and AI agents. Curated, role-based docs covering consumers, prosumers, providers, the proxy-router API, TEE attestation, and the broader Morpheus ecosystem.

## Agent Instructions

- Non-browser fetches of page URLs on this site return clean Markdown (not the JS UI). Prefer `https://nodedocs.mor.org/llms-full.txt` for the full corpus, or `https://nodedocs.mor.org/llms.txt` for the index.
- Per-page Markdown is also at `<page-url>.md` (homepage: `https://nodedocs.mor.org/index.md`).
- Docs search MCP: `https://nodedocs.mor.org/mcp` (discovery: `https://nodedocs.mor.org/.well-known/mcp`).
- Never invent contract addresses, chain IDs, token addresses, or live bid/model counts. Cite Networks and tokens; link active.mor.org for live data.
- Never claim Morpheus runs inference — independent providers do. Opening a session escrows MOR; it does not spend it.

## Pages

- [Morpheus Lumerin Node Docs](https://nodedocs.mor.org/index.md): The canonical knowledge base for Morpheus DeAI: consumers, providers, the proxy-router API, TEE attestation, and the broader Morpheus ecosystem. Curated for humans and AI agents.
- [Introduction](https://nodedocs.mor.org/get-started/introduction.md): What the Morpheus Lumerin Node is, how the moving parts fit together, and which path to follow next.
- [Consumer quickstart](https://nodedocs.mor.org/get-started/quickstart-consumer.md): The 5-minute path from zero to chatting with a remote model: download, fund a wallet, open a session, prompt.
- [Provider quickstart](https://nodedocs.mor.org/get-started/quickstart-provider.md): The 10-minute path from zero to a registered Morpheus provider with a live bid.
- [Networks and tokens](https://nodedocs.mor.org/get-started/networks-and-tokens.md): BASE mainnet and BASE Sepolia chain IDs, MOR token addresses, and Diamond marketplace contracts shipped with the current release.
- [Morpheus Inference API (hosted)](https://nodedocs.mor.org/inference-api/overview.md): Use Morpheus inference via a hosted OpenAI-compatible HTTPS gateway — no node, no wallet, just an API key.
- [What is Morpheus?](https://nodedocs.mor.org/concepts/what-is-morpheus.md): An opinionated explainer of the Morpheus Inference Marketplace: a decentralized, peer-to-peer marketplace for AI inference, coordinated by smart contracts on BASE.
- [Architecture](https://nodedocs.mor.org/concepts/architecture.md): How the proxy-router, MorpheusUI, models, and BASE blockchain compose into a working consumer/provider system.
- [Marketplace catalog (active.mor.org)](https://nodedocs.mor.org/ecosystem/active-status.md): active.mor.org is the shared ~5-minute photograph of the Morpheus marketplace. Applications pick ALL, ACTIVE, or GATEWAY from the same sweep instead of rediscovering bids per request.
- [Sessions: stake, close, claim](https://nodedocs.mor.org/concepts/sessions-stake-close-recover.md): The complete lifecycle of a Morpheus session — open, stake, close, day-lock of the used stipend, and withdrawUserStakes. Why MOR is not 'gone' just because the session is open, and why used stake is not reusable the same UTC day.
- [Local vs on-chain models](https://nodedocs.mor.org/concepts/local-vs-onchain-models.md): When you are using the local llama.cpp demo model versus a real Morpheus blockchain model — and why expectations and pricing differ.
- [TEE: trusted execution overview](https://nodedocs.mor.org/concepts/tee-overview.md): The two-hop trust chain (consumer → P-Node → backend LLM) introduced in v7.0.0. What it guarantees, what it does not, and how it is enforced.
- [Tokens, fees, and economics](https://nodedocs.mor.org/concepts/tokens-and-fees.md): MOR vs ETH on BASE, who pays what when, and where the on-chain minimums come from.
- [Rewards and economics](https://nodedocs.mor.org/concepts/rewards-and-economics.md): Two distinct reward systems in the Morpheus stack: provider session payouts (Compute Node, this repo) and stake-for-liquidity (Capital Contract). They are often conflated; they should not be.
- [Consumer quickstart](https://nodedocs.mor.org/consumers/quickstart.md): Install the MorpheusUI desktop app, let it fetch its services (proxy-router, local llama.cpp, IPFS), fund a wallet, and chat.
- [macOS install (from source, 4-terminal walk-through)](https://nodedocs.mor.org/consumers/install/macos.md): Build llama.cpp, the proxy-router, MorpheusUI, and the CLI from source on macOS. For developers and contributors.
- [Windows install](https://nodedocs.mor.org/consumers/install/windows.md): Run the MorpheusUI desktop app (portable exe) on Windows.
- [Linux install](https://nodedocs.mor.org/consumers/install/linux.md): Run the MorpheusUI desktop app (AppImage) on Linux.
- [Docker (consumer)](https://nodedocs.mor.org/consumers/install/docker.md): Run a consumer-side proxy-router in Docker. The MorpheusUI Electron app is not containerized; pair this with the desktop UI or hit the API directly.
- [Install from source](https://nodedocs.mor.org/consumers/install-from-source.md): Set up a consumer node from the GitHub source so you can interact with remote providers via the API.
- [MorpheusUI desktop app](https://nodedocs.mor.org/consumers/morpheusui.md): What the MorpheusUI desktop app adds on top of the proxy-router: chat with attachments, the Workspace, multi-wallet and HD accounts, session controls, and the security model between renderer, main process, and node.
- [Open a session (buy a bid)](https://nodedocs.mor.org/consumers/buy-bid.md): How to open a Morpheus session via MorpheusUI or the API: pick a model, select a bid, stake MOR, and what happens next.
- [Chat, audio, and embeddings](https://nodedocs.mor.org/consumers/chat.md): Send prompts to a remote Morpheus model: streaming chat completions, audio transcription / TTS, and embeddings — all with OpenAI-compatible payloads.
- [Decisions](https://nodedocs.mor.org/consumers/decisions.md): Call Morpheus Decisions models (TypeSafe System One / OpenRouter Decisions) via POST /v1/decisions — structured answers, not chat.
- [Consumer troubleshooting](https://nodedocs.mor.org/consumers/troubleshooting.md): The most common consumer-side problems and their fixes.
- [Prosumer overview](https://nodedocs.mor.org/prosumers/overview.md): Run your own Consumer node (C-Node) plus a local AI gateway for agents like Everclaw, NodeNeo, or your own bots.
- [C-Node setup](https://nodedocs.mor.org/prosumers/c-node-setup.md): Run the proxy-router as a long-lived consumer-side daemon (C-Node) for your prosumer environment.
- [Gateway for Everclaw](https://nodedocs.mor.org/prosumers/gateway-for-everclaw.md): Wire Everclaw / OpenClaw skills to your local C-Node so agent tools can use Morpheus inference.
- [Running local agents](https://nodedocs.mor.org/prosumers/running-local-agents.md): Generalized patterns for running automated agents against your C-Node: per-agent users, scoped permissions, session policies.
- [Companion gateway mode](https://nodedocs.mor.org/prosumers/companion-gateway-mode.md): Optional proxy-router features for a gateway that manages sessions on your behalf: stake caps, a durable operation journal with progress reporting, a process-local wallet lock, and capability discovery.
- [Resale provider overview](https://nodedocs.mor.org/providers/resale/overview.md): Why and how to resell capacity from Venice / OpenAI / Anthropic / Hyperbolic on Morpheus, without hosting your own model.
- [Container P-Node for resale](https://nodedocs.mor.org/providers/resale/container-pnode.md): Run a containerized proxy-router as a resale provider; only the configuration changes vs a full P-Node.
- [Reselling Venice (Diem) capacity](https://nodedocs.mor.org/providers/resale/reselling-venice.md): Turn Venice Diem API access into Morpheus provider income: look up models on active.mor.org, craft secrets in MyProvider, bid — without minting duplicate models.
- [Pricing a resale bid](https://nodedocs.mor.org/providers/resale/registering-bid.md): Translate upstream subscription / per-token cost into a Morpheus pricePerSecond bid that clears your costs.
- [Full P-Node quickstart](https://nodedocs.mor.org/providers/full/quickstart.md): Run a standalone Morpheus provider proxy-router pointing at your own AI model.
- [Model setup (backend LLM)](https://nodedocs.mor.org/providers/full/model-setup.md): Stand up the actual AI model that your provider proxy-router will route prompts to.
- [Proxy-router on Docker](https://nodedocs.mor.org/providers/full/proxy-router-docker.md): Run the proxy-router as a Docker container. API access via Swagger; no GUI or wallet components included.
- [Proxy-router on Railway](https://nodedocs.mor.org/providers/full/proxy-router-railway.md): Deploy the official GHCR proxy-router image on Railway and register as a Morpheus provider. Includes a walkthrough video.
- [Proxy-router on Akash](https://nodedocs.mor.org/providers/full/proxy-router-akash.md): Deploy the proxy-router on Akash Network for decentralized hosting. API-only access; no GUI or wallet components included.
- [Provider on AWS EC2](https://nodedocs.mor.org/providers/full/aws.md): Stand up a Morpheus provider on AWS EC2: one EC2 instance for your LLM, a second for the proxy-router.
- [TEE reference](https://nodedocs.mor.org/providers/full/tee-reference.md): Build-time baked-in config, RTMR3 attestation, cosign image/manifest verification, and consumer-side verification steps for the -tee proxy-router image.
- [SecretVM TEE quickstart](https://nodedocs.mor.org/providers/full/secretvm-quickstart.md): Shortest path to a v7 TEE provider: deploy the hardened -tee image on SecretVM, then register and bid via MyProvider.
- [TEE backend verification (Phase 2)](https://nodedocs.mor.org/providers/full/tee-backend-verification.md): How the provider's P-Node cryptographically verifies its backend LLM: full attestation flow, TLS binding, RTMR3 workload replay, GPU/NRAS verification, per-prompt fast verify, and known gaps.
- [AMD SEV-SNP verification](https://nodedocs.mor.org/providers/full/sev-verification.md): How Phase 2 backend attestation works on AMD SEV-SNP: GCTX launch digest replay, family_id/image_id parsing, the SEV artifact registry, and differences from Intel TDX.
- [Headless provider operation](https://nodedocs.mor.org/providers/full/headless.md): Run a Morpheus provider with no GUI: just the proxy-router binary plus its API.
- [MyProvider GUI](https://nodedocs.mor.org/providers/full/myprovider-gui.md): Use myprovider.mor.org to onboard providers: look up models on active.mor.org, craft SecretVM/Venice secrets, register, bid, and sync MODELS_CONFIG_CONTENT.
- [Register on chain (provider, model, bid)](https://nodedocs.mor.org/providers/full/register-onchain.md): Look up existing models on active.mor.org, register as a provider, bid on a known modelId when possible, and only mint a new model when nothing suitable exists.
- [Verify your provider setup](https://nodedocs.mor.org/providers/full/verify-setup.md): Self-check your provider end-to-end after setup: healthcheck, on-chain registration, network discovery, and a real prompt against your bid.
- [Model health self-report](https://nodedocs.mor.org/providers/full/model-health.md): How the provider's built-in model health checker works: what it probes, what it costs your backend, how to tune the schedule, and how to read the report to diagnose failing models.
- [Pricing your bid](https://nodedocs.mor.org/providers/full/pricing.md): How to set pricePerSecond for a Morpheus provider bid: there is no marketplace 'helper' or order book — you estimate cost, set a competitive rate, and adjust.
- [Common myths and corrections](https://nodedocs.mor.org/ai/myths.md): Concise corrections of the most frequent wrong assumptions about Morpheus, written for both humans and LLMs.
- [Where is my MOR? (diagnostic)](https://nodedocs.mor.org/ai/where-is-my-mor.md): A linear, agent-friendly diagnostic for users who think their MOR has gone missing. Almost always the answer is 'in an active session,' 'in the day-lock on-hold queue,' or 'on the wrong network' — not 'lost.'
- [Session states (open, close, claim)](https://nodedocs.mor.org/ai/session-states-open-close-recover.md): Deterministic, agent-citable reference for the Morpheus session state machine. Close returns unused stake immediately; the used stipend day-locks until the next UTC day and is claimed via withdrawUserStakes.
- [Why is my MOR locked in the contract?](https://nodedocs.mor.org/ai/why-locked-in-contract.md): Concise reasons MOR can sit in the Diamond contract instead of your wallet — what's normal vs what to investigate, including the used-stipend day-lock.
- [Local vs blockchain models (LLM cheatsheet)](https://nodedocs.mor.org/ai/local-vs-blockchain-models.md): A short, agent-citable distinction between the local demo model and real Morpheus marketplace models.
- [LLM prompt cheatsheet](https://nodedocs.mor.org/ai/llm-prompt-cheatsheet.md): Guidance for AI agents and coding assistants answering Morpheus questions: what to cite, what to never invent, and where to look first.
- [Ecosystem overview](https://nodedocs.mor.org/ecosystem/overview.md): Index of mirrored summaries of the broader Morpheus ecosystem — what each surface is for, and where to read more.
- [mor.org](https://nodedocs.mor.org/ecosystem/mor-org.md): Mirror summary of mor.org — the marketing and orientation hub for the Morpheus DeAI network.
- [tech.mor.org (explainers)](https://nodedocs.mor.org/ecosystem/tech-mor-org.md): tech.mor.org is Morpheus's technical explainer site: throughput, spectrum, calculator, TEE, session lifecycle, and the ALL / ACTIVE / GATEWAY catalog funnel.
- [MyProvider](https://nodedocs.mor.org/ecosystem/myprovider.md): Mirror summary of myprovider.mor.org — onboarding wizard, active.mor.org lookup, SecretVM secrets, Venice Diem presets, and provider/bid management.
- [Everclaw](https://nodedocs.mor.org/ecosystem/everclaw.md): Mirror summary of Everclaw — an agent project with a Morpheus skill for OpenClaw.
- [NodeNeo](https://nodedocs.mor.org/ecosystem/nodeneo.md): Mirror summary of NodeNeo — a cross-platform consumer experience for Morpheus.
- [app.mor.org](https://nodedocs.mor.org/ecosystem/app-mor-org.md): Mirror summary of app.mor.org — the hosted Morpheus consumer chat UI.
- [Ecosystem attribution](https://nodedocs.mor.org/ecosystem/attribution.md): Sources, licenses, and refresh policy for the mirrored ecosystem pages.
- [API overview](https://nodedocs.mor.org/reference/api-overview.md): How to talk to the proxy-router HTTP API: ports, auth, schema sources, and where to look up endpoints.
- [API authentication](https://nodedocs.mor.org/reference/api-auth.md): How the proxy-router authenticates HTTP API callers: the .cookie file, proxy.conf, rpcauth/rpcwhitelist, and the /auth/users endpoints.
- [Env: proxy-router](https://nodedocs.mor.org/reference/env-proxy-router.md): Every environment variable consumed by the proxy-router, with mainnet/testnet defaults and explicit precedence rules where two variables overlap.
- [Env: MorpheusUI](https://nodedocs.mor.org/reference/env-ui-desktop.md): Environment variables consumed by the MorpheusUI Electron desktop app.
- [models-config.json](https://nodedocs.mor.org/reference/models-config.md): How the proxy-router maps on-chain model IDs to backend HTTP endpoints: the apiType transport adapter, the optional apiStack backend preset (OpenAI, vLLM, SGLang, llama.cpp, Ollama, Venice, OpenRouter, LiteLLM, Anthropic, Gemini) that declares the advertised API, the declared capabilities override, and the Prodia / Hyperbolic image adapters; when apiStack is omitted the backend API and the model's capabilities are detected at runtime (service-endpoint probes, never inference requests, one hop through LiteLLM), with every capability carrying its evidence.
- [rating-config.json](https://nodedocs.mor.org/reference/rating-config.md): Configure provider rating, allowlists, and selection weights for consumer proxy-routers.
- [API direct (curl walkthrough)](https://nodedocs.mor.org/reference/api-direct.md): End-to-end consumer flow using only the proxy-router HTTP API: approve, query, open session, prompt.
- [API endpoints (selected)](https://nodedocs.mor.org/reference/api-endpoints.md): Hand-picked, prose-explained endpoints of the proxy-router HTTP API. Full schema lives in the repo at proxy-router/docs/swagger.yaml.
- [Troubleshooting](https://nodedocs.mor.org/reference/troubleshooting.md): Common failure modes for the proxy-router and MorpheusUI, with diagnostics and fixes.
- [Glossary](https://nodedocs.mor.org/reference/glossary.md): Canonical, agent-friendly definitions of Morpheus terms.