# 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.
- [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.
- [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.
- [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.
- [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 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.
- [active.mor.org (live status)](https://nodedocs.mor.org/ecosystem/active-status.md): Mirror summary of active.mor.org — live status, active models, and active bids on the Morpheus marketplace.
- [tech.mor.org (calculators, sessions, TEE, throughput)](https://nodedocs.mor.org/ecosystem/tech-mor-org.md): Mirror summary of tech.mor.org — Morpheus's technical explainer site with calculators and protocol-level documentation.
- [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, including OpenAI / Anthropic / Prodia / Hyperbolic API types.
- [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.