The proxy-router is a critical component that monitors the BASE blockchain and manages models, providers, and sessions. It’s a standalone application that runs anywhere with access to your blockchain node and AI model.

Published image

The official image is on GHCR: ghcr.io/morpheusais/morpheus-lumerin-node:latest. Built per release from the main branch. Browse: MorpheusAIs Packages. To run that same image on Railway instead of a local Docker host, see Proxy-router on Railway (includes an 11-minute walkthrough). For TEE-hardened images (-tee suffix), see SecretVM quickstart and TEE reference.

Pre-requisites

  • AI model reachable on a private endpoint (e.g. http://my-model.example:8080).
  • Funded wallet (MOR + ETH on BASE) and its private key.
  • Public endpoint for the provider (host:port, no protocol), e.g. mycoolmornode.example:3333.

Volume + env layout

Mount a host directory into /app/data so these files persist: Map -p for the proxy port (3333) and admin/API port (8082).

Run with .env file

Minimal proxy-router.env (mainnet):
Run:

Run with command-line variables

Set ETH_NODE_ADDRESS explicitly. The proxy-router has a built-in public RPC round-robin fallback. It exists for first-run sanity checks only — for any real provider it is rate-limited and unreliable, and missing blockchain events will silently break your node.

Manual build

If you want to customize, build locally:

Validate & register

  • http://localhost:8082/swagger/index.html should render. Authenticated routes need Authorize with your .cookie credentials (API auth).
  • Continue to Register on chain.

Notes