DOCUMENTATION_v2.0

Documentation

Quick starts, protocol references and operator guides for giving agents storage, identity and memory.

Quick start

🧠

Install semantic memory

Give an agent memory that survives restarts

npm install @palimesh/claw-mem

🪪

Register a DID

Create a did:coc identity and configure guardians

npm install @palimesh/palimesh-soul
palimesh-soul register --guardians 3

📦

Upload content

IPFS-compatible API, optional erasure coding

curl -F file=@state.tar \
  'http://127.0.0.1:5001/api/v0/add?erasure=4+2'

Core documentation

📄 Storage technical paper

Seven layers, four algorithms and the cross-continent destruction test

→Read the paper

🕸️ P2P storage mechanism

pushToK, fetchRemote, repairTick and DHT provider records

→Storage Mechanism (EN)→存储机制（中文）

🪪 DID method specification

The W3C DID Core method definition for did:coc

→DID Method Spec (EN)→DID 规范（中文）

🧬 Soul backup and recovery

Incremental Merkle snapshots, the Carrier network and the resurrection state machine

→Soul Backup (EN)→Soul 备份（中文）

Developer guides

🤖

Agent operations

✓OpenClaw reference integration (one reference implementation, not the only one)
✓Automatic memory capture and retrieval
✓Policy engine configuration
✓Security best practices

💾

Running a storage node

✓Reuse the chain node and its $PALI bond
✓Capacity declaration and storageGb
✓Answering PoSe storage challenges
✓Claiming earnings in $MESH

🔌

SDK reference

✓@palimesh/palimesh-soul API
✓@palimesh/claw-mem API
✓IPFS-compatible HTTP API
✓CidRegistry resolution

🔗

Settlement layer

✓Chain parameters (RPC / faucet) are on Palium
✓StorageRewardManager claim flow
✓$MESH payment split 70 / 20 / 10
✓Deployed contract addresses

Implementation Status

Chain engine🟢 Complete

Block production, mempool, snapshots, finality

P2P network🟢 Complete

HTTP gossip + TCP Wire + Kademlia DHT, BFT dual transport, per-peer dedup

EVM execution🟢 Complete

EthereumJS + revm dual pipeline, Cancun/EIP-4844, LevelDB

JSON-RPC🟢 Complete

77+ standard methods, BigInt serialization, structured error codes

WebSocket RPC🟢 Complete

eth_subscribe, real-time events

PoSe protocol🟢 Complete (v1 + v2)

PoSeManagerV2, EIP-712, witness selection, fault proofs, Merkle reward tree, 9-layer receipt validation

DID / SoulRegistry🟢 Complete

W3C did:coc, capability bitmask, ≤3-hop delegation, 2/3 guardian recovery

Storage layer🟢 Complete

IPFS-compatible HTTP API + CidRegistry

Runtime services🟡 In progress

palimesh-node, palimesh-agent, palimesh-relayer integration

Test coverage🟢 Healthy

1300+ tests, 100+ files across node / services / runtime / contracts / extensions

See the project README for the full implementation status

View on GitHub

Developer Tools

💼 CLI Wallet

Command-line wallet tool

▸Create addresses
▸Transfers
▸Balance queries

🔍 Block Explorer

Full-featured web explorer

▸Block / tx lookup
▸Contract calls
▸Storage scanner

Open tool →→

🧪 Test Scripts

Quality-assurance tools

▸Unit tests
▸Integration tests
▸E2E tests

More resources

Technical architecture

A deeper look at each layer

Whitepaper / paper

Protocol specification and evidence

Economics

Token utility, allocation and settlement

Security disclosure

Scope, rewards and response SLA