# Aephia SAGE SDK

Unofficial, public `0.x` TypeScript SDK for read-only Star Atlas SAGE C4
access. It is ESM-only and uses `@solana/kit` addresses.

## Start here

- README.md — README
- docs/PUBLIC_API.md — Public API Review
- docs/CONSUMER_AGENT_GUIDE.md — Consumer Agent Guide
- docs/GENERATED_BINDINGS_UPGRADE.md — Generated Binding Upgrade Procedure
- TEST_PLAN.md — verification and coverage contract
- fixtures/captured-binary/registry.json — provenance for checked-in captured account bytes
- fixtures/zink-ptr/registry.json — dated public read-only PTR anchors
- fixtures/relationships.json — audited relationship metadata kept outside runtime bundles

Use `createSageClient` for loaded Profile → Character → Fleet traversal or
capability functions for focused imports. Start from a known Profile address.
Never infer wallet-to-Profile derivation. Never add signing, transactions, or
writes. Do not use previous-generation Star Atlas SDK packages.