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

Documentation

• Wiki index: docs/wiki/Home.md
• Monorepo layout and release tags: docs/MONOREPO.md
• Qualification gates: docs/QUALIFICATION.md
• Specifications: spec/

SDKs and integrations

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.