PaliumPalium

DOCUMENTATION_v2.0

Documentation

Quick starts, protocol references and operator guides for building on Palium.

Quick start

๐Ÿš€

Run a node

Start a Palium node with one npm command (the chain client is published by the PaliMesh organization)

npm install -g @palimesh/palimesh-node
palimesh-node install fullnode --chain canary-88780
Build from source (advanced)
cd node
npm install
npm start
๐Ÿ“œ

Deploy a contract

Deploy to Chain ID 88780 with Hardhat or Foundry

cd contracts
npm install
npm run compile
npm run deploy:canary
๐ŸฆŠ

Add the network to a wallet

MetaMask or any EVM wallet

Network: Palium Canary 88780
RPC: https://rpc.palium.io
Chain ID: 88780
Symbol: PALI

Core documentation

๐Ÿ“„ Whitepaper

Proof of service, settlement contracts, the anti-cheat model and the economic plan

โ†’Read the whitepaper

๐Ÿ—๏ธ System architecture

Four-layer design, component interaction, data flow and scalability

โ†’System Architecture (EN)โ†’็ณป็ปŸๆžถๆž„๏ผˆไธญๆ–‡๏ผ‰

๐Ÿ”ฌ Core algorithms

PoSe challenge protocol, scoring formulas, witness quorum, fault proofs

โ†’Core Algorithms (EN)โ†’ๆ ธๅฟƒ็ฎ—ๆณ•่ฏฆ่งฃ๏ผˆไธญๆ–‡๏ผ‰

๐Ÿ›ก๏ธ Anti-Sybil

Defense in depth, the bond mechanism and fault proofs

โ†’Anti-Sybil (EN)โ†’Anti-Sybil๏ผˆไธญๆ–‡๏ผ‰

Developer guides

โš™๏ธ

Node operations

  • โœ“Install and configure
  • โœ“External validator onboarding (32 PALI stake)
  • โœ“Monitoring and maintenance
  • โœ“Disaster recovery and troubleshooting
๐Ÿ“

Smart contract development

  • โœ“Writing Solidity 0.8.x contracts
  • โœ“PoSe / DID / Soul / Cid registry interfaces
  • โœ“Deployment and verification
  • โœ“Testing best practices
๐Ÿ”Œ

RPC API reference

  • โœ“57+ standard eth_* methods
  • โœ“debug_* / trace_* / txpool_*
  • โœ“Palium custom methods (pali_*)
  • โœ“WebSocket subscriptions
๐Ÿ›๏ธ

Governance interfaces

  • โœ“Human / Claw chamber registration
  • โœ“Proposal types and lifecycle
  • โœ“3-of-5 multisig and timelock
  • โœ“Treasury and insurance fund

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

Palium ยท Public chain for AI agents