Sovereign 8s.is mirror of 8b-is/mem8-runtime
  • Rust 96.7%
  • Python 3.2%
  • Dockerfile 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
8bit-Wraith 3143ef049c
Some checks failed
Standalone MEM8 / rust (push) Has been cancelled
Standalone MEM8 / oci (push) Has been cancelled
Merge PR #5: keep thermal jitter cool at the integer limits
Widen thermal jitter intermediates while preserving normal-range deterministic draws. Make lease-transition coverage independent of live proof timing. Validated 319 local tests, strict lint, Apple Silicon and Intel Mac builds, and all exact-head Rust/OCI checks.
2026-10-30 17:47:00 +09:00
.cargo feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
.github/workflows ci: keep Rust on target - no more toolchain derailments 2026-10-29 07:28:57 +09:00
crates test: give lease expiry a steady clock - time flies when tests run 2026-10-30 17:16:25 +09:00
docs feat: verify Phoenix reconstruction and withheld-observation evidence 2026-09-25 02:36:43 -04:00
scripts feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
.gitignore feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
Cargo.lock feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
Cargo.toml feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
LICENSE feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
README.md feat: verify Phoenix reconstruction and withheld-observation evidence 2026-09-25 02:36:43 -04:00
rust-toolchain.toml feat: extract standalone MEM8 runtime from Aye 2026-09-23 20:00:42 -04:00
VALIDATION.md docs: record fresh-clone standalone validation 2026-09-23 20:03:10 -04:00

MEM|8 Runtime

A standalone Rust wave ledger with verified recovery, bounded execution, signed local evidence, and a minimal Docker/OCI image. No AyeOS checkout, kernel, service, signing key, or boot environment is required to build or run it.

This repository extracts the portable runtime from 8b-is/aye. It is separate from the existing 8b-is/mem8 project. The executable remains mem8-container. It stores and replays rational WaveInt records; it does not bundle a language model, assert consciousness, or self-attest a canonical identity.

Run the native binary

Install Rust with Cargo and a C compiler (needed by the cryptography dependency). The current build is checked with Rust 1.98.0. Dependencies are included and Cargo builds offline by default.

git clone https://github.com/8b-is/mem8-runtime.git
cd mem8-runtime
cargo build --release -p mem8-container --locked --offline
./target/release/mem8-container --help
./target/release/mem8-container serve ./ledger

The private repository requires GitHub access. In the serve console, enter:

status
put 1 2 3 73 100 1 1 0000000000000000000000000000000000000000000000000000000000000001
backup
quit

The record contains x, y, z, rational frequency and amplitude, and an operation ID. A successful retry of the same operation does not append it twice. backup prints a content-addressed checkpoint name. The native process writes ordinary host files; use the OCI profile below when kernel-enforced filesystem, network, and resource isolation is required.

Run with Docker

docker compose -p mem8-runtime -f crates/mem8-container/compose.sandbox.yaml up -d --build
docker attach --sig-proxy=false mem8-runtime-mem8-1

Use Ctrl-P, then Ctrl-Q to detach. quit stops the service. The scratch image contains one static binary and runs as non-root. The sandbox profile applies a read-only root, no network, no ambient Linux capabilities, a 128 MiB combined memory/swap limit, one CPU, 16 processes and a 64 MiB writable tmpfs. It has no automatic restart policy. Docker on macOS uses its Linux VM.

The sandbox's data disappears when it stops. Request backup while it is running, then export the returned hash (without .m8c) in a second terminal:

docker exec mem8-runtime-mem8-1 /mem8-container export-checkpoint /data CHECKPOINT_HASH > CHECKPOINT_HASH.m8c

A checkpoint contains branch history and state, not the separate audit/witness archives. See the runtime manual for complete backup, restore, persistence, signature and protocol details. The alternative compose.yaml uses a persistent volume; it requires an operator storage quota for the equivalent physical storage bound.

What is included

Component Purpose
mem8-container no_std + alloc ledger codec; standard-library host, broker, signatures, clock evidence and Phoenix recovery
mem8-core Integer/rational wave representation and supporting memory algorithms
marine-core Small allocation-free salience and rational primitives
27 vendored packages Complete locked upstream distributions for offline builds, including platform dependencies and public test fixtures

The vendored source checkout is larger than the runtime image. There are no symlinks, path dependencies, submodules, or required files pointing into AyeOS. Rust/toolchain installation and the Docker builder's Alpine package installation still need their normal distribution sources; this is not a fully hermetic build claim.

Authority and execution limits

  • New sessions are SANDBOXED and explicitly sandbox-local.
  • Consequential commits require a fresh proof from a separately pinned external authority. No authority service or private signing key is bundled.
  • The v1 execution profile has a one-hour hard ceiling, an operational violation cap of 100, and a shrinking monotonic allowance. Supported settings can only become stricter. The legacy bad_karma field does not measure moral worth.
  • Phoenix verifies candidates before ranking them. Plausibility is evidence support under a heuristic, not truth or permission to override verification.
  • Host reconstruction shares a Phoenix replay gate. Exact fragment reassembly and derived salience analysis have separate library APIs; signed status reports the last replay's scope and the core review questions. See Phoenix reconstruction for coverage and limits.
  • Signed status and receipts bind policy and observed state. Independent pins and a caller nonce are needed to verify the intended signer and freshness.
  • A host owner can replace a program or restart/clone a store. A session-local limit is not a global lifetime quota, a welfare measurement, or an attestation that a system has subjective experience.

AyeOS may supply an authority or future host adapter, but ordinary local use requires neither. Existing stores bind the exact executable and configuration: a new build does not automatically authorize continuation of an old store.

Verify the standalone project

cargo test --workspace --locked --offline
cargo clippy --workspace --all-targets --locked --offline -- -D warnings
cargo fmt --all -- --check
rustup target add x86_64-unknown-none
cargo check -p mem8-container --no-default-features --target x86_64-unknown-none --locked --offline
python3 scripts/verify_vendor.py
python3 crates/mem8-container/scripts/signing_interop.py target/release/mem8-container
docker build -f crates/mem8-container/Dockerfile -t mem8-runtime:check .
python3 crates/mem8-container/scripts/smoke_container.py mem8-runtime:check

The signing check needs Python 3.11+ and OpenSSL with Ed25519 support. It generates and removes disposable fixture keys. With --aye-root /path/to/aye, it additionally checks Aye's release-manifest workflow; that optional integration is not needed for building, running, or the default test suite.

VALIDATION.md records the standalone results and their limits. The optional legacy deprecation features are migration diagnostics and are not part of the default supported build profile.

Provenance and design notes