# power_house
[](https://github.com/JROChub/power_house/actions/workflows/ci.yml)
[](https://crates.io/crates/power_house)
[](https://docs.rs/power_house)
[](LICENSE)
`power_house` is a Rust verification stack for deterministic sum-check proofs,
commitment-bound sparse workloads, transcript anchoring, and optional quorum
networking.
## Verified Scale
The repository contains four reproducible proof modes:
| Constant polynomial | `2^70` points | `O(70)` | `cargo run --release --example sextillion_verify` |
| Seeded affine polynomial | `2^4096` points | `O(4096)` | `cargo run --release --example hyperscale_affine` |
| Seeded sparse polynomial | `2^1,000,000` points | `O(n + I log n)` | `cargo run --release --example sparse_record` |
| External committed sparse polynomial | `2^1,000,000` points | `O(n + I log n)` | `cargo run --release --example committed_workload` |
Here `n` is the number of variables and `I` is the number of nonzero variable
incidences. None of these modes allocates the expanded Boolean hypercube.
The external workflow stores the polynomial and proof separately:
- `PHSMv1`: canonical sparse polynomial
- `PHCPv1`: proof containing a domain-separated BLAKE2b-256 commitment
Verification requires both files and rejects workload substitution.
These results demonstrate verification over enormous implicit domains. They do
not establish that arbitrary sextillion-step computations can be verified, do
not replace a quantum computer, and are not currently claimed as a world first.
See [Research Claim Standard](docs/research_claim.md).
## Install
```bash
cargo add power_house
cargo install power_house --features net
```
## Reproduce
```bash
cargo test --all-targets
cargo test --all-targets --features net
cargo run --release --example sextillion_verify
cargo run --release --example hyperscale_affine
cargo run --release --example sparse_record
cargo run --release --example committed_workload
python3 scripts/verify_sparse_certificate.py \
target/power_house_sparse_record.phsp
python3 scripts/verify_sparse_certificate.py \
target/external_interaction_model.phcp \
--polynomial target/external_interaction_model.phsm
```
The full procedure, formats, expected outputs, and failure tests are in
[Verification Guide](docs/verification_guide.md).
## Library
```rust
use power_house::{Field, GeneralSumProof};
let field = Field::new(1_000_000_007);
let proof = GeneralSumProof::prove_seeded_affine(
4096,
&field,
b"public reproducible workload",
);
assert!(proof.verify_seeded_affine(
&field,
b"public reproducible workload",
));
```
Primary APIs:
- `GeneralSumProof`: dense, streaming, constant, and seeded-affine sum-check
- `SeededSparseProof`: stable `PHSPv1` seeded sparse certificates
- `CommittedSparsePolynomial`: canonical external sparse workloads
- `CommittedSparseProof`: stable `PHCPv1` commitment-bound certificates
- `ProofLedger`: transcript logs, anchors, and quorum reconciliation
## Network
The `net` feature enables the `julian` CLI, libp2p transport, signed envelopes,
data availability endpoints, governance policies, stake accounting, and token
migration commands.
```bash
julian keygen ed25519://<seed> --out ./keys/node.identity
julian net start \
--node-id <node_id> \
--log-dir ./logs/<node_id> \
--listen /ip4/0.0.0.0/tcp/0 \
--bootstrap /dns4/mfenx.com/tcp/7002/p2p/<PEER_ID> \
--quorum 2 \
--key ed25519://<seed>
```
Operations and migration procedures are documented in
[Operations](docs/ops.md) and [Mainnet Launch](docs/mainnet_launch.md).
## Documentation
- [Verification Guide](docs/verification_guide.md)
- [JULIAN Protocol](JULIAN_PROTOCOL.md)
- [Committed Workload Format](docs/committed_workload.md)
- [Million-Round Sparse Certificate](docs/sparse_record.md)
- [Hyperscale Seeded-Affine Proof](docs/hyperscale_proof.md)
- [Research Claim Standard](docs/research_claim.md)
- [Orbital Observatory](docs/orbital_observatory.md)
- [Operations](docs/ops.md)
## License
MIT OR BSD-2-Clause.