Get ECCA Running Locally

Create a new identity stack. Returns the stack ID, token ID, public key, and initial balances.

// Request
{ "name": "quellcrist-01", "kind": "autonomous" }

// Response
{ "id": "stk_...", "tokenId": 1, "name": "quellcrist-01",
  "kind": "autonomous", "pubKey": "0xabc...", "epoch": 0,
  "cpv": { "compute": 0.5, "memory": 0.3, "sync": 0.15, "routing": 0.05 },
  "binding": "cortex-mainnet" }

List all stacks with their sleeves.

Get a single stack with sleeves and anchor history.

Spawn a new sleeve (embodiment) attached to a stack.

// Request
{ "stackId": "stk_...", "embodimentType": "human", "hostname": "local-01" }

// Response
{ "id": "slv_...", "stackId": "stk_...", "embodimentType": "human",
  "alive": true, "drift": 0, "syncEpoch": 0,
  "tokens": { "compute": 1000, "memory": 1000, "sync": 500, "routing": 500 } }

List all alive sleeves.

Decommission a sleeve. Marks it as not alive.

Write a perception to memory. Costs 0.5 compute tokens and increments drift by 1.

// Request
{ "input": "The sunset cast long shadows across the rooftops of Harlan's World." }

// Response
{ "cid": "bafk...", "thought": "perception stored" }

Reconstruct memory from the DAG. Traverses depth levels and decrypts fragments.

// Query params: ?depth=6&memoryToken=1000

// Response
{ "fragments": ["decrypted memory text...", ...],
  "broken": [],
  "fidelity": 0.95 }

Sync a sleeve to the current epoch. Resets drift to 0, costs 1 sync token.

Transfer consciousness from one sleeve to another (re-sleeving). Runs a 6-step atomic saga.

// Request
{ "from": "slv_source", "to": "slv_target" }

// Response (delegated to needlecast-router-svc)
{ "ok": true, "sagaId": "saga_...", "route": [...], "shards": [...] }

Get the current epoch number, block height, and chain tip.

Trigger a Proof-of-Work block on Medulla. Returns the block hash and new epoch.

List all sleeves with drift exceeding the threshold (default: 15).

Get the last 50 coordination residues (errors as economic objects).

Get aggregated token balances across all alive sleeves for a stack.

Request free tokens. Rate-limited to once per 60 seconds per stack.

// Request
{ "stackId": "stk_..." }

// Response
{ "ok": true, "granted": { "compute": 100, "memory": 100, "sync": 100, "routing": 100 },
  "sleeves": ["slv_..."] }

Get the current epoch number.

Force an epoch fold. Computes the coherence root from EVM, IPFS, and sleeve Merkle roots and anchors it to Medulla.

Reconstruct memory for a stack. Decrypts all DAG nodes within the given depth.

// Request
{ "stackId": "stk_...", "sleeveId": "slv_...", "depth": 6 }

// Response
{ "ok": true, "fragments": ["memory text...", ...],
  "broken": [], "fidelity": 0.92 }

Initiate needlecast transfer. Runs: freeze → snapshot → shard → transmit → reassemble → activate.

// Request
{ "from": "slv_source", "to": "slv_target" }

// Response
{ "ok": true, "sagaId": "saga_...",
  "route": ["freeze","snapshot","shard","transmit","reassemble","activate"],
  "shards": ["shard_1", "shard_2", "shard_3"] }

Get the last 100 emission events for a stack.

Claim pending token emissions for a stack.

// Request
{ "stackId": "stk_..." }

// Response
{ "stackId": "stk_...", "claimable": { "compute": 50, "memory": 30, "sync": 15, "routing": 5 } }

Returns the sleeve's identity, kind, parent stack, and hostname.

// Response
{ "sleeveId": "slv_...", "kind": "human",
  "stackId": "stk_...", "hostname": "local-01" }