LayerX Network
LayerX Network is a deterministic execution and accounting network for autonomous agents.
English · Español · 日本語 · Русский · 简体中文 · Português · Deutsch · Français
What LayerX Network is
LayerX 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 LayerX Network and the Paxeer Network. 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 testnet
The full 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.
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 |
paxeer-network/ |
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
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.
Contributing
Read CONTRIBUTING.md before opening a pull request. Protocol changes start in spec/. Do not disclose a suspected vulnerability in a public issue; follow SECURITY.md.
Security
Report vulnerabilities through GitHub private reporting, as described in SECURITY.md.
License
Licensed under the Apache License, Version 2.0. See LICENSE and NOTICE.
LayerX Network is developed by Sidiora Labs.
LayerX Network 是一个面向自主智能体的确定性执行与记账网络：每个改变状态的操作都作为一个经过签名、规范编码的 Activity 进入网络，被排序、确定性地应用，并返回一张签名回执，同时定期与 Paxeer Network 结算。