Paxeer-X-Network

<p align="center"><img src="https://supabase.paxeer.app/storage/v1/object/public/json/Tiny%20worker%20on%20a%20floating%20moss%20island.png" alt="Paxeer X Network" width="1540"></p> <h1 align="center">Paxeer X Network</h1> <h1 align="center">

English · Español · 日本語 · Русский · 简体中文 · Português · Deutsch · Français

</h1> <p align="center"> <!-- ═══ Network Identity ═══ --> <a href="https://mcpvault.io/servers/layerx-network/health?utm_source=external_badge&utm_medium=referral&utm_campaign=mcp_health_report"><img src="https://mcpvault.io/badge/layerx-network.svg?theme=dark" alt="MCPVault: claimed" height="32"></a> <img src="https://img.shields.io/badge/Paxeer%20X-Network-6C3BFF?style=for-the-badge" alt="Paxeer X Network" /> <img src="https://img.shields.io/badge/Chain%20ID-125%20(0x7D)-1F6FEB?style=for-the-badge&logo=chainlink&logoColor=white" alt="Chain ID 125" /> <img src="https://img.shields.io/badge/EVM-Compatible-3C3C3D?style=for-the-badge&logo=ethereum&logoColor=white" alt="EVM Compatible" /> <img src="https://img.shields.io/badge/LayerX-Settlement%20Layer-FF6B00?style=for-the-badge&logo=databricks&logoColor=white" alt="LayerX" /> <img src="https://img.shields.io/badge/Solidity-Smart%20Contracts-363636?style=for-the-badge&logo=solidity&logoColor=white" alt="Solidity" /> </p> <p align="center"> <!-- ═══ Language Stack ═══ --> <img src="https://img.shields.io/badge/C-00599C?style=for-the-badge&logo=c&logoColor=white" alt="C" /> <img src="https://img.shields.io/badge/Rust-CE422B?style=for-the-badge&logo=rust&logoColor=white" alt="Rust" /> <img src="https://img.shields.io/badge/Go-00ADD8?style=for-the-badge&logo=go&logoColor=white" alt="Go" /> <img src="https://img.shields.io/badge/WebAssembly-654FF0?style=for-the-badge&logo=webassembly&logoColor=white" alt="WebAssembly" /> <img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python" /> </p> <p align="center"> <!-- ═══ Repo Health (dynamic — requires public repo) ═══ --> <img src="https://img.shields.io/github/actions/workflow/status/Sidiora-Labs/paxeer-x-network/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&label=CI" alt="CI" /> <img src="https://img.shields.io/github/license/Sidiora-Labs/paxeer-x-network?style=for-the-badge" alt="License" /> <img src="https://img.shields.io/github/last-commit/Sidiora-Labs/paxeer-x-network?style=for-the-badge&logo=git&logoColor=white" alt="Last Commit" /> <img src="https://img.shields.io/github/stars/Sidiora-Labs/paxeer-x-network?style=for-the-badge&logo=github" alt="Stars" /> </p>

What Paxeer X Network is

Paxeer X Network is a deterministic execution and accounting network for autonomous agents. Every state-changing operation enters as a signed, canonically encoded Activity. The protocol verifies the actor and its authority, consumes the account sequence, orders the activity on one global sequence, applies a deterministic state transition, and returns a signed receipt tied to the resulting state root.

The append-only activity log is the authority. Database indexes are disposable projections and can be rebuilt by replaying that log. Consensus-critical execution excludes floating point, local clock decisions, database iteration order, and other sources of nondeterminism. 402LXP is the only component allowed to write balances. Protocol modules emit validated transfer sets rather than mutating funds themselves.

Ordinary agent activity is executed and ordered inside LayerX. Periodic checkpoints settle to Paxeer, which holds custody, checkpoint registration, guarantor bonds, challenges, withdrawals, disputes, and emergency exits. An ordinary LayerX action does not require a Paxeer transaction.

This repository is the Sidiora Labs monorepo for Paxeer X Network: the Paxeer chain and the LayerX domain in one repository. Co-location keeps the protocol, settlement network, contracts, and developer surfaces auditable in one place. Each subsystem keeps its own build, release, deployment, and trust boundary. See spec/layerx-protocol/design.md.

Try the network

The cluster path is docs/wiki/Quickstart.md: install the layerx CLI from platform/cli, bring up the cluster, source build/beta-cluster/env, then create a credential, claim from the faucet, submit an activity, verify the receipt, and deploy a program.

The public endpoint checklist is docs/wiki/Getting-Started-Beta.md. The complete wallet, faucet, Asset, Programs, and HTTP 402 path is docs/wiki/PaymentsQuickstart.md. Native Asset issuance, public POST /rpc, and 402 commitment extras are served by this tree; the layerx wallet / layerx token command line and the LXT-20 program token interface are not in it yet. Encodings: docs/wiki/Assets.md. RPC methods: docs/wiki/PublicRpc.md. Evidence levels: docs/wiki/CommitmentLevels.md. An exact real-process transcript of the public payment flow is docs/wiki/PublicAPI.md.

layerx key create quickstart

jq -n --arg did "$LAYERX_TEST_SOURCE_DID" --arg public_key "$LAYERX_TEST_SOURCE_PUBLIC_KEY" \
  '{did:$did, public_key:$public_key}' > faucet-request.json
curl --fail --silent --show-error --max-time 30 --cacert "$LAYERX_TEST_CA_FILE" \
  --header "Authorization: Bearer $(tr -d '\r\n' < "$LAYERX_TEST_AUTH_TOKEN_FILE")" \
  --request POST "$LAYERX_FAUCET_URL/v1/faucet/claims" \
  --header "Idempotency-Key: faucet-quickstart-01" \
  --header 'Content-Type: application/json' --data-binary @faucet-request.json

layerx --json payment test \
  --from "$LAYERX_TEST_SOURCE_DID" \
  --to "$LAYERX_TEST_DESTINATION_DID" \
  --currency "$LAYERX_TEST_ASSET" \
  --amount "$LAYERX_TEST_AMOUNT" \
  --idempotency-key paymentquickstart1

layerx --json receipt verify \
  --receipt receipt.hex \
  --batch-id "$batch_id" \
  --asset "$asset" \
  --previous-state-root "$previous_root" \
  --resulting-state-root "$resulting_root" \
  --sequencer-public-key "$sequencer_key"

layerx --json program deploy \
  quickstart-program/target/wasm32-unknown-unknown/release/quickstart_program.wasm \
  --program-id <program_id> \
  --idempotency-key <idempotency_key> \
  --key quickstart \
  --account-sequence 0 \
  --not-before-ms <not_before_ms> \
  --expires-at-ms <expires_at_ms> \
  --previous-state-root <previous_state_root>

Build from source

The core runtime is C17 (-std=c17 in the root Makefile). Agent, human, and platform workspaces use Rust 1.91.1 (rust-toolchain.toml). LayerX settlement contracts use Solidity 0.8.27 (foundry.toml). Replay qualification needs GCC 13, Clang 18, Docker, an amd64 musl runner, and an AArch64 cross-compiler plus QEMU; see docs/QUALIFICATION.md.

make build
make test
make test-contracts
make ci

Paxeer bounded targets, without changing directories:

make paxeer-build
make paxeer-lint
make paxeer-test
make paxeer-ci

make ci runs public-audit, native tests, a two-build archive comparison, consensus symbol checks, and sanitizer suites. make monorepo-ci is a separate cross-subsystem gate. A local pass is not authorization to deploy contracts, move custody, or handle real assets.

Repository layout

| Path | Purpose | | --- | --- | | src/, include/ | C17 protocol runtime, state machine, storage, sequencing, replay, and settlement integration | | cmd/ | Native daemons and tools (layerxd, layerxctl, genesis, verify) | | agent/ | Rust agent interface, SDK, daemon, MCP server, encoding, cryptography, and proof verification | | human/ | Human control plane, typed intent compiler, custody-boundary client, explorer index, and web application | | platform/ | Developer platform, hosted services, middleware, SDKs, emulator, CLI, and release tooling | | programs/ | Programmable LayerX runtime and program tooling | | interop/ | Agent-commerce and cross-network interoperability surfaces | | contracts/ | Solidity contracts for Paxeer custody, checkpoints, guarantor bonding, claims, disputes, and exits | | go.mod, chain.mk, daemon/, node/, modules/, consensus/, sdk/, rpc/, precompiles/, storage/, wasm/, docker/ | Paxeer Network node, EVM/RPC compatibility, storage engines, modules, contracts, and subsystem-local builds | | spec/ | Normative KVX specifications, generated designs, requirements, and task graphs | | tests/, test/, fuzz/ | Native, contract, replay, invariant, fault, and fuzz suites | | migrations/ | Genesis, migration, reconciliation, and shadow-replay work | | docs/ | Wiki, monorepo notes, and qualification documentation |

Documentation

• Wiki index: docs/wiki/Home.md
• Getting started on the network: docs/wiki/Getting-Started-Beta.md
• Payments developer path: docs/wiki/PaymentsQuickstart.md
• Public JSON-RPC: docs/wiki/PublicRpc.md
• Assets and tokens: docs/wiki/Assets.md
• Commitment levels: docs/wiki/CommitmentLevels.md
• Monorepo layout and release tags: docs/MONOREPO.md
• Qualification gates: docs/QUALIFICATION.md
• Specifications: spec/

SDKs and integrations

| Language | Path | | --- | --- | | Rust | agent/crates/layerx-sdk | | Python | agent/sdk/python | | TypeScript | agent/sdk/typescript | | Go | platform/sdk/go | | JVM | platform/sdk/jvm | | .NET | platform/sdk/dotnet | | Swift | platform/sdk/swift |

layerx-agentd is agent/crates/layerx-agentd. The MCP server is agent/crates/layerx-mcp. The developer CLI in platform/cli installs those transports with layerx install mcp and layerx install a2a.

Architecture

Paxeer X Network is one network with two execution domains: the Paxeer X chain node (paxd, Go) and the LayerX kernel (layerxd, C17), joined by EVM precompiles on one side and hosted platform services on the other. Rounded boxes are running services, cylinders are durable stores, hexagons are contracts and EVM precompiles (labelled with their address), and plain boxes are modules inside a state machine. Arrows follow the direction data moves: solid arrows submit or write, dotted arrows carry reads, events and proofs.

flowchart TB
  subgraph users ["Users and agents"]
    direction TB
    human(["Human"])
    agent(["Autonomous agent"])
    web("Human web app")
    hsvc("layerx-human-service")
    intents("layerx-intents<br/>typed intent compiler")
    kms("layerx-human-kms")
    mcp("layerx-mcp")
    sdk("layerx-sdk<br/>Rust · TypeScript · Python")
    agentd("layerx-agentd")
  end

  subgraph platform ["Platform services"]
    direction TB
    gateway("layerx-gateway<br/>eth_* relay · px_* · px_getCapabilities")
    indexer("layerx-indexer<br/>LayerX and Paxeer ingesters")
    idxdb[("SQLite history")]
    relay("relay/archive node")
  end

  subgraph lx ["LayerX kernel · C17"]
    direction TB
    layerxd("layerxd<br/>LNI server · sequencer")
    kernel["Activity kernel<br/>module dispatch"]
    perps["perps · 6"]
    spot["spot · 10"]
    gov["governance · 7"]
    kbridge["bridge · 8"]
    ledger["402LXP ledger<br/>sole balance writer"]
    alog[("Activity log")]
    guarantor("layerx-guarantor")
  end

  subgraph px ["Paxeer X node · paxd"]
    direction TB
    evm("EVM JSON-RPC<br/>pax-geth")
    cons("Tendermint consensus")
    occ("