https://github.com/mizcausevic-dev/aeo-sdk-go
Go SDK for the AEO Protocol v0.1. Parse, build, validate, and fetch AEO declaration documents. Zero non-stdlib dependencies. Strict json.DisallowUnknownFields parsing. Context-aware HTTP client.
https://github.com/mizcausevic-dev/aeo-sdk-go
aeo aeo-protocol ai-governance answer-engine-optimization go-sdk golang kinetic-gain-protocol-suite protocol-implementation stdlib well-known
Last synced: 12 days ago
JSON representation
Go SDK for the AEO Protocol v0.1. Parse, build, validate, and fetch AEO declaration documents. Zero non-stdlib dependencies. Strict json.DisallowUnknownFields parsing. Context-aware HTTP client.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/aeo-sdk-go
- Owner: mizcausevic-dev
- License: agpl-3.0
- Created: 2026-05-12T05:15:13.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-12T21:37:22.000Z (about 1 month ago)
- Last Synced: 2026-05-12T22:29:49.295Z (about 1 month ago)
- Topics: aeo, aeo-protocol, ai-governance, answer-engine-optimization, go-sdk, golang, kinetic-gain-protocol-suite, protocol-implementation, stdlib, well-known
- Language: Go
- Homepage: https://github.com/mizcausevic-dev/aeo-sdk-go
- Size: 30.3 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-go
[](https://pkg.go.dev/github.com/mizcausevic-dev/aeo-sdk-go)
[](https://goreportcard.com/report/github.com/mizcausevic-dev/aeo-sdk-go)
[](https://opensource.org/licenses/MIT)
Go SDK for the [AEO Protocol v0.1](https://github.com/mizcausevic-dev/aeo-protocol-spec) — parse, build, validate, and fetch AEO declaration documents. **Zero non-stdlib dependencies.**
## Install
```bash
go get github.com/mizcausevic-dev/aeo-sdk-go
```
## Quickstart
```go
package main
import (
"context"
"fmt"
"log"
aeo "github.com/mizcausevic-dev/aeo-sdk-go"
)
func main() {
// Fetch and parse from a live well-known URL
doc, err := aeo.FetchWellKnown("https://mizcausevic-dev.github.io")
if err != nil {
log.Fatal(err)
}
fmt.Println(doc.Entity.Name) // "Miz Causevic"
fmt.Println(doc.ClaimIDs()) // [current-role location ...]
fmt.Println(doc.FindClaim("years-experience").Value) // 30
// Parse from bytes
doc2, _ := aeo.ParseDocumentString(`{"aeo_version":"0.1", ...}`)
// Custom HTTP client with context
ctx := context.Background()
client := aeo.DefaultClient()
_, _ = client.FetchWellKnown(ctx, "https://example.com")
_ = doc2
}
```
## What it does
- **Parse** — `ParseDocument(bytes)`, `ParseDocumentString(s)`, `LoadDocument(path)` — all use `json.DisallowUnknownFields` for strict conformance
- **Build** — `Document`, `Entity`, `Authority`, `Claim`, `Verification`, `CitationPreferences`, `AnswerConstraints`, `Audit` are all exported struct types with proper JSON tags
- **Serialize** — `doc.Marshal()` returns pretty-printed JSON
- **Fetch** — `aeo.FetchWellKnown(origin)` does HTTP discovery against `/.well-known/aeo.json` with `Accept: application/aeo+json, application/json`. Custom `Client` lets you bring your own `*http.Client` and pass a `context.Context`.
- **Query** — `doc.ClaimIDs()` and `doc.FindClaim(id)` helpers
## Conformance
Supports the AEO Protocol at **conformance Level 1 (Declare)**. Signature verification (L2) and audit-endpoint posting (L3) deferred to v0.2.
## Dependencies
None. Uses only the standard library: `encoding/json`, `net/http`, `context`, `io`.
## Development
```bash
go vet ./...
go test -race -v ./...
go build ./...
```
## 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](https://github.com/mizcausevic-dev/aeo-sdk-rust) · **aeo-sdk-go** (this) · [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/)