https://github.com/valkyoth/eth
https://github.com/valkyoth/eth
Last synced: about 9 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/valkyoth/eth
- Owner: valkyoth
- License: eupl-1.2
- Created: 2026-06-19T09:03:20.000Z (about 17 hours ago)
- Default Branch: main
- Last Pushed: 2026-06-19T11:16:08.000Z (about 14 hours ago)
- Last Synced: 2026-06-19T11:23:56.312Z (about 14 hours ago)
- Language: Rust
- Size: 105 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# eth
`eth` is a `no_std`-first Rust workspace for Ethereum execution-layer protocol
building blocks.
The project target is a production-ready Ethereum crate at `1.0.0`, reached
through small releases with explicit security, conformance, and dependency
evidence. The first implementation work is intentionally conservative:
bounded canonical decoding, explicit fork context, stable crate boundaries, and
security documentation before RPC, signer, REVM, Reth, or P2P adapters become
real dependencies.
## Current Status
Status: `v0.2.0` implementation complete; pending external pentest input.
Implemented now:
- Rust workspace pinned to stable `1.96.0`.
- MSRV policy for Rust `1.90.0` through `1.96.0`.
- `no_std` facade and focused first-party crates.
- One admitted `no_std` constant-time helper dependency and no third-party
Ethereum dependencies yet.
- EUPL-1.2 license.
- Security, modularity, supply-chain, implementation, and release planning docs.
- Local check and release-gate scripts.
## Trust Dashboard
| Area | Status |
| --- | --- |
| License | `EUPL-1.2` |
| MSRV | Rust `1.90.0` |
| Pinned toolchain | Rust `1.96.0` |
| Default target | `no_std` |
| Runtime dependencies | `subtle` for constant-time equality |
| Unsafe policy | first-party crates use `#![forbid(unsafe_code)]` |
| Default features | protocol-core only |
| Network/signing defaults | none |
| 1.0 target | serious production-ready Ethereum execution-layer toolkit |
## Rust Version Support
The minimum supported Rust version is Rust `1.90.0`. New deployments should use
the pinned stable Rust `1.96.0` until the toolchain policy is updated.
Compatibility evidence:
| Rust | Local Evidence |
| --- | --- |
| `1.90.0` | `cargo check --workspace --all-features` |
| `1.91.0` | `cargo check --workspace --all-features` |
| `1.92.0` | `cargo check --workspace --all-features` |
| `1.93.0` | `cargo check --workspace --all-features` |
| `1.94.0` | `cargo check --workspace --all-features` |
| `1.95.0` | `cargo check --workspace --all-features` |
| `1.96.0` | full check gate |
## Workspace Shape
| Crate | Default | Purpose |
| --- | --- | --- |
| `eth` | yes | Facade crate over stable protocol-core crates. |
| `eth-valkyoth-primitives` | yes | Chain, fork, block, gas, nonce, and bounded value types. |
| `eth-valkyoth-codec` | yes | Bounded exact-consumption wire decoding policy. |
| `eth-valkyoth-protocol` | yes | Fork-aware validation states and protocol context. |
| `eth-valkyoth-verify` | yes | Verification boundaries for signatures, proofs, and replay domains. |
| `eth-valkyoth-evm` | no | Future REVM adapter boundary. |
| `eth-valkyoth-rpc` | no | Future explicit RPC trust-policy boundary. |
| `eth-valkyoth-signer` | no | Future signer isolation boundary. |
| `eth-valkyoth-reth` | no | Future Reth integration boundary. |
| `eth-valkyoth-testkit` | no | Test fixtures, conformance helpers, and adversarial inputs. |
## Checks
```bash
scripts/checks.sh
scripts/release_0_2_gate.sh
```
`scripts/check_latest_tools.sh` is an advisory networked currency check for
maintainers. It is intentionally separate from deterministic release gates.
For dependency-policy checks, install `cargo-deny` and `cargo-audit`, then run:
```bash
cargo deny check
cargo audit
```
## Documentation
- [Implementation Plan](docs/IMPLEMENTATION_PLAN.md)
- [Release Plan](docs/RELEASE_PLAN.md)
- [Scope](docs/SCOPE.md)
- [Threat Model](docs/threat-model.md)
- [Spec Matrix](docs/SPEC_MATRIX.md)
- [Spec Source Policy](docs/spec-source-policy.md)
- [GitHub Security Settings](docs/github-security-settings.md)
- [Secret Handling Policy](docs/secret-handling-policy.md)
- [Modularity Policy](docs/modularity-policy.md)
- [Supply-Chain Security](docs/supply-chain-security.md)
- [Unsafe Policy](docs/unsafe-policy.md)
## License
Licensed under the European Union Public Licence 1.2.