ciris-edge
Reticulum-native federation transport for the CIRIS stack. Replaces the Python edge across CIRISLens (FastAPI), CIRISAgent (httpx), CIRISRegistry (HTTPS) with a single Rust crate that does signed message in/out, verify-via-persist, and typed handler dispatch.
Status: v0.2.0 — Phase 1 substrate live. Verify pipeline (hybrid
Ed25519 + ML-DSA-65 via persist's directory lookup), durable outbound
queue + dispatcher, typed handler dispatch, HTTP transport, the CC 0.7
two-tier wire vocabulary (Tier-1 constitutional bodies + Tier-2 opaque
app RPC — send::<OpaqueRequest> / OpaqueResponse / OpaqueEvent,
WIRE_VOCABULARY_HASH build-gate pinned), and a sovereign-mode convenience
constructor (EdgeBuilder::from_keyring_seed_dir) for Reticulum-style
adoption with no persist Engine in-process. PyO3 surface (Edge
class registration + init_edge_runtime) lands in v0.3.x; reticulum
- multi-medium transports follow per Phase 3 of the FSD.
Read in this order
-
MISSION.md— the WHY. Mission Driven Development alignment to CIRIS Accord Meta-Goal M-1; per-module mission statements; anti-patterns that violate the mission; failure modes. -
FSD/CIRIS_EDGE.md— the WHAT. Architecture spec, three-phase delivery plan, crate shape, public API surface, verify-via-persist contract, wire-format envelope, test categories. -
FSD/OPEN_QUESTIONS.md— the HOW. Thirteen design forks needing owner input before Phase 1 starts. Each question states the choice, the trade-off, and a lens-side default; resolutions land at the bottom inCLOSED.
TL;DR
The CIRIS architecture has three peers (agent, lens, registry) each
maintaining their own network edge. Three parallel HTTP shims, three
retry policies, three cert-management stories. The Proof-of-Benefit
Federation FSD (~/CIRISAgent/FSD/PROOF_OF_BENEFIT_FEDERATION.md
§3.2) names Reticulum-rs as the transport that closes the federation
loop: addressing IS identity, multi-medium reach, fork-survivable Rust.
ciris-edge is the crate that operationalizes that proposal. Each
peer becomes:
host application code
│ registers handlers
▼
ciris-edge ←── Reticulum link sessions (TCP / LoRa / serial / I²P)
│ verify via persist
▼
ciris-persist ←── steward identity, federation_keys, trace storage
One shape, many peers. Library, not sidecar. Verify happens at the wire, before any handler sees a byte. Key seeds never cross the FFI boundary. HTTP fallback ships in Phase 1 so cloud deployments can participate today; Reticulum is canonical and Phase 3 productionizes LoRa + serial + I²P for the deployments that need M-1 most.
Phases
| Phase | Outcome |
|---|---|
| 1 (immediate) | Crate skeleton; HTTP transport + Reticulum behind a feature flag; Ed25519 verify via persist; typed handler dispatch; lens cuts over from FastAPI to embedded edge runner |
| 2 | Agent + registry adopt edge; HTTPS becomes per-peer fallback |
| 3 | LoRa, packet-radio, serial transports productionized; off-grid CIRIS deployments tractable |
Sister repos
CIRISAgent— agent reasoning loop; emits signed traces. Wire-format spec lives atFSD/TRACE_WIRE_FORMAT.md.CIRISPersist— substrate. Owns the federation keys directory, steward identity, canonical-bytes canonicalization, trace storage. Edge calls into persist for sign + verify.CIRISLens— analytical observatory. First peer to adopt edge in Phase 1 (cuts over from FastAPI ingest).CIRISRegistry— identity / build / license / revocation directory. Adopts edge in Phase 2.CIRISVerify— cryptographic primitives library. Edge depends transitively via persist.
License
AGPL-3.0, matching the rest of the CIRIS federation stack. License-
locked mission preservation per MISSION.md §6.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ciris_edge-9.1.7-cp310-abi3-win_amd64.whl.
File metadata
- Download URL: ciris_edge-9.1.7-cp310-abi3-win_amd64.whl
- Upload date:
- Size: 9.5 MB
- Tags: CPython 3.10+, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae1e7b34da178dca237b06bf9a8df3120d766047bc77ae6d0df407ea3c1dadbc
|
|
| MD5 |
85b51c99224f07e2957f4558890a3134
|
|
| BLAKE2b-256 |
c9aa28925679ab99291106d5768b3d267746113bb5c6c5cd0f4da87e9b9976dd
|
Provenance
The following attestation bundles were made for ciris_edge-9.1.7-cp310-abi3-win_amd64.whl:
Publisher:
ci.yml on CIRISAI/CIRISEdge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_edge-9.1.7-cp310-abi3-win_amd64.whl -
Subject digest:
ae1e7b34da178dca237b06bf9a8df3120d766047bc77ae6d0df407ea3c1dadbc - Sigstore transparency entry: 2122726667
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISEdge@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Branch / Tag:
refs/tags/v9.1.7 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_x86_64.whl.
File metadata
- Download URL: ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_x86_64.whl
- Upload date:
- Size: 16.8 MB
- Tags: CPython 3.10+, manylinux: glibc 2.39+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af3d415e1943063d983a0abb80c94b260af1204963863e7866494bfbd8bbcadf
|
|
| MD5 |
1c846dbf2b2083416b499a6e48247706
|
|
| BLAKE2b-256 |
64ad36f2082d37a1917662acc5c650ed514906bd47d185dc839e23eaff1ce8bb
|
Provenance
The following attestation bundles were made for ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_x86_64.whl:
Publisher:
ci.yml on CIRISAI/CIRISEdge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_x86_64.whl -
Subject digest:
af3d415e1943063d983a0abb80c94b260af1204963863e7866494bfbd8bbcadf - Sigstore transparency entry: 2122727228
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISEdge@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Branch / Tag:
refs/tags/v9.1.7 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_aarch64.whl.
File metadata
- Download URL: ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_aarch64.whl
- Upload date:
- Size: 15.6 MB
- Tags: CPython 3.10+, manylinux: glibc 2.39+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
22a8ac74d9cf5daba2ad51c3551b34cf80b83a5ff3c965ef62eb8a1e6cab1657
|
|
| MD5 |
9e2860c6228c115c181a41c7991d9584
|
|
| BLAKE2b-256 |
edc2a1c0389ac0d9028c6ab65b9bbcdc06e43ce2b2fba26190a93466974a5511
|
Provenance
The following attestation bundles were made for ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_aarch64.whl:
Publisher:
ci.yml on CIRISAI/CIRISEdge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_edge-9.1.7-cp310-abi3-manylinux_2_39_aarch64.whl -
Subject digest:
22a8ac74d9cf5daba2ad51c3551b34cf80b83a5ff3c965ef62eb8a1e6cab1657 - Sigstore transparency entry: 2122727426
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISEdge@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Branch / Tag:
refs/tags/v9.1.7 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ciris_edge-9.1.7-cp310-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: ciris_edge-9.1.7-cp310-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 15.6 MB
- Tags: CPython 3.10+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5ee38c0d18c798fed6f88655804d47b6abd6fd1b8d559e97a4ae7351f67c1d72
|
|
| MD5 |
be42208afc142e634338910ac6884529
|
|
| BLAKE2b-256 |
85b155512f651648213e826497220f14d3fcf4fea75e886fe03a2892d9ebce95
|
Provenance
The following attestation bundles were made for ciris_edge-9.1.7-cp310-abi3-macosx_11_0_arm64.whl:
Publisher:
ci.yml on CIRISAI/CIRISEdge
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ciris_edge-9.1.7-cp310-abi3-macosx_11_0_arm64.whl -
Subject digest:
5ee38c0d18c798fed6f88655804d47b6abd6fd1b8d559e97a4ae7351f67c1d72 - Sigstore transparency entry: 2122726923
- Sigstore integration time:
-
Permalink:
CIRISAI/CIRISEdge@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Branch / Tag:
refs/tags/v9.1.7 - Owner: https://github.com/CIRISAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@baee59cb85775d4f1fc1dc9c858b8742983c8a05 -
Trigger Event:
push
-
Statement type:
