https://github.com/mizcausevic-dev/aeo-sdk-rust
Rust SDK for the AEO Protocol v0.1. Parse, build, validate, and fetch AEO declaration documents. serde + serde_json, optional ureq client. Clippy and rustfmt clean. Loads canonical examples from aeo-protocol-spec.
https://github.com/mizcausevic-dev/aeo-sdk-rust
aeo aeo-protocol ai-governance answer-engine-optimization crates-io kinetic-gain-protocol-suite protocol-implementation rust rust-sdk serde well-known
Last synced: 12 days ago
JSON representation
Rust SDK for the AEO Protocol v0.1. Parse, build, validate, and fetch AEO declaration documents. serde + serde_json, optional ureq client. Clippy and rustfmt clean. Loads canonical examples from aeo-protocol-spec.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/aeo-sdk-rust
- Owner: mizcausevic-dev
- License: mit
- Created: 2026-05-12T05:12:48.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-23T21:40:56.000Z (20 days ago)
- Last Synced: 2026-05-23T23:22:01.506Z (20 days ago)
- Topics: aeo, aeo-protocol, ai-governance, answer-engine-optimization, crates-io, kinetic-gain-protocol-suite, protocol-implementation, rust, rust-sdk, serde, well-known
- Language: Rust
- Homepage: https://github.com/mizcausevic-dev/aeo-sdk-rust
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# aeo-sdk-rust
[](https://crates.io/crates/aeo-protocol)
[](https://docs.rs/aeo-protocol)
[](https://opensource.org/licenses/MIT)
Rust SDK for the [AEO Protocol v0.1](https://github.com/mizcausevic-dev/aeo-protocol-spec) — parse, build, validate, and fetch AEO declaration documents.
## Install
```toml
[dependencies]
aeo-protocol = "0.1"
```
## Quickstart
```rust
use aeo_protocol::{Document, fetch_well_known};
fn main() -> Result<(), aeo_protocol::AeoError> {
// Fetch and parse from a live well-known URL
let doc = fetch_well_known("https://mizcausevic-dev.github.io")?;
println!("{}", doc.entity.name); // "Miz Causevic"
println!("{:?}", doc.claim_ids()); // ["current-role", ...]
println!("{:?}", doc.find_claim("years-experience").map(|c| &c.value));
// Parse from a string
let raw = std::fs::read_to_string("aeo.json")?;
let parsed = Document::from_json(&raw)?;
println!("{}", parsed.to_json()?);
Ok(())
}
```
## What it does
- **Parse** — `Document::from_json(&str)` returns a strongly-typed `Document`
- **Build** — `Document`, `Entity`, `Authority`, `Claim`, `Verification`, `CitationPreferences`, `AnswerConstraints`, `Audit` are all public struct types with `serde::Serialize` + `serde::Deserialize`
- **Serialize** — `doc.to_json()` returns canonical pretty-printed JSON
- **Fetch** — `fetch_well_known(origin)` performs HTTP discovery against `/.well-known/aeo.json` with `Accept: application/aeo+json, application/json` (feature `client`, on by default)
- **Query** — `doc.claim_ids()` and `doc.find_claim(id)` helpers
## Features
- `client` (default) — HTTP discovery via [ureq](https://crates.io/crates/ureq). Disable with `default-features = false` for a pure-serde build (no networking).
## Conformance
Supports the AEO Protocol at **conformance Level 1 (Declare)**. Signature verification (L2) and audit-endpoint posting (L3) deferred to v0.2.
## Dependencies
- [serde](https://crates.io/crates/serde) and [serde_json](https://crates.io/crates/serde_json) — JSON model
- [thiserror](https://crates.io/crates/thiserror) — error type
- [ureq](https://crates.io/crates/ureq) — HTTP client (optional, `client` feature only)
## Development
```bash
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-features
```
## Specification
Full spec at [github.com/mizcausevic-dev/aeo-protocol-spec](https://github.com/mizcausevic-dev/aeo-protocol-spec).
## License
MIT-licensed. Free for commercial and non-commercial use with attribution. The AEO Protocol specification this SDK implements is also MIT (see [aeo-protocol-spec](https://github.com/mizcausevic-dev/aeo-protocol-spec)).
## Kinetic Gain Protocol Suite
| Spec | Implementation |
|---|---|
| [AEO Protocol](https://github.com/mizcausevic-dev/aeo-protocol-spec) | [aeo-sdk-python](https://github.com/mizcausevic-dev/aeo-sdk-python) · [aeo-sdk-typescript](https://github.com/mizcausevic-dev/aeo-sdk-typescript) · **aeo-sdk-rust** (this) · [aeo-sdk-go](https://github.com/mizcausevic-dev/aeo-sdk-go) · [aeo-cli](https://github.com/mizcausevic-dev/aeo-cli) · [aeo-crawler](https://github.com/mizcausevic-dev/aeo-crawler) |
| [Prompt Provenance](https://github.com/mizcausevic-dev/prompt-provenance-spec) | — |
| [Agent Cards](https://github.com/mizcausevic-dev/agent-cards-spec) | — |
| [AI Evidence Format](https://github.com/mizcausevic-dev/ai-evidence-format-spec) | — |
| [MCP Tool Cards](https://github.com/mizcausevic-dev/mcp-tool-card-spec) | — |
---
**Connect:** [LinkedIn](https://www.linkedin.com/in/mirzacausevic/) · [Kinetic Gain](https://kineticgain.com) · [Medium](https://medium.com/@mizcausevic/) · [Skills](https://mizcausevic.com/skills/)