Skip to main content
The Rust relayer exposes these routes. Routes are defined in services/server/src/main.rs. See also:

​
Authentication

All /api/* routes require signed headers. The SDK handles this automatically.

​
Required Headers

HeaderDescription
x-public-keyHex-encoded Ed25519 public key (32 bytes)
x-signatureHex-encoded Ed25519 signature (64 bytes)
x-timestampUnix timestamp in seconds (5-minute validity window)

​
Optional Headers

HeaderDescription
x-account-idMemWalAccount object ID hint — speeds up account resolution when not cached
x-delegate-keyDelegate private key (hex) — used by the default SDK for SEAL decrypt flows

​
Signature Format

The signed message is: {timestamp}.{method}.{path}.{body_sha256} The relayer verifies the Ed25519 signature, then resolves the owner by looking up the public key in onchain MemWalAccount.delegate_keys.

​
Public Routes

​
GET /health

Service health check. No authentication required. Response: 
{
  "status": "ok",
  "version": "0.1.0"
}

​
POST /sponsor

Proxy to the SEAL/Walrus sidecar’s /sponsor endpoint for sponsored transactions. No authentication required.

​
POST /sponsor/execute

Proxy to the sidecar’s /sponsor/execute endpoint. No authentication required.

​
Protected Routes

​
POST /api/remember

Store text as an encrypted memory. The relayer handles embedding, SEAL encryption, Walrus upload, and vector indexing. Request: 
{
  "text": "User prefers dark mode",
  "namespace": "demo"
}
namespace defaults to "default" if omitted. Response: 
{
  "id": "uuid",
  "blob_id": "walrus-blob-id",
  "owner": "0x...",
  "namespace": "demo"
}

​
POST /api/recall

Search for memories matching a natural language query. Returns decrypted plaintext results. Request: 
{
  "query": "What do we know about this user?",
  "limit": 10,
  "namespace": "demo"
}
limit defaults to 10. namespace defaults to "default". Response: 
{
  "results": [
    {
      "blob_id": "walrus-blob-id",
      "text": "User prefers dark mode",
      "distance": 0.15
    }
  ],
  "total": 1
}

​
POST /api/remember/manual

Register a client-encrypted payload. The client sends SEAL-encrypted data (base64) and a precomputed embedding vector. The relayer uploads the encrypted bytes to Walrus and stores the vector mapping. Request: 
{
  "encrypted_data": "base64-encoded-seal-encrypted-bytes",
  "vector": [0.01, -0.02, ...],
  "namespace": "demo"
}
Response: 
{
  "id": "uuid",
  "blob_id": "walrus-blob-id",
  "owner": "0x...",
  "namespace": "demo"
}

​
POST /api/recall/manual

Search with a precomputed query vector. Returns blob IDs and distances only — the client handles downloading and decrypting. Request: 
{
  "vector": [0.01, -0.02, ...],
  "limit": 10,
  "namespace": "demo"
}
Response: 
{
  "results": [
    {
      "blob_id": "walrus-blob-id",
      "distance": 0.15
    }
  ],
  "total": 1
}

​
POST /api/analyze

Extract facts from text using an LLM, then store each fact as a separate memory (embed, encrypt, upload, index). Request: 
{
  "text": "I live in Hanoi and prefer dark mode.",
  "namespace": "demo"
}
Response: 
{
  "facts": [
    {
      "text": "User lives in Hanoi",
      "id": "uuid",
      "blob_id": "walrus-blob-id"
    },
    {
      "text": "User prefers dark mode",
      "id": "uuid",
      "blob_id": "walrus-blob-id"
    }
  ],
  "total": 2,
  "owner": "0x..."
}

​
POST /api/ask

Recall memories, inject them into an LLM prompt, and return an AI-generated answer with the context used. Request: 
{
  "question": "What do you know about my preferences?",
  "limit": 5,
  "namespace": "demo"
}
limit defaults to 5. namespace defaults to "default". Response: 
{
  "answer": "Based on your memories, you prefer dark mode and live in Hanoi.",
  "memories_used": 2,
  "memories": [
    {
      "blob_id": "walrus-blob-id",
      "text": "User prefers dark mode",
      "distance": 0.12
    }
  ]
}

​
POST /api/restore

Rebuild missing vector entries for one namespace. Queries onchain blobs by owner and namespace, downloads from Walrus, decrypts, re-embeds, and re-indexes only the entries missing from the local database. Request: 
{
  "namespace": "demo",
  "limit": 50
}
limit defaults to 50. Response: 
{
  "restored": 3,
  "skipped": 7,
  "total": 10,
  "namespace": "demo",
  "owner": "0x..."
}