Introduction

@aephia/sage is a TypeScript SDK for reading the state of Star Atlas SAGE C4, the version of the game running on the z.ink public test realm.

Installing it

pnpm add @aephia/sage @solana/kit

What it does

It turns raw on-chain accounts into typed, validated TypeScript values. Instead of fetching an account, working out which layout applies, and decoding bytes, you ask for a fleet and get a fleet.

What it deliberately does not do

The SDK is read-only. It does not sign transactions, submit instructions, move assets, or hold keys. That is a deliberate boundary, not a missing feature. Everything you can do with this SDK is safe to run against live game data.

Who it is for

Developers building tools, dashboards, and bots around Star Atlas — including those who are new to Solana, and those working alongside an AI assistant.

A common wrong turn

The @staratlas/sage and @staratlas/data-source packages on npm target the previous version of the game. They are not compatible with SAGE C4. AI assistants suggest them frequently because they appear throughout older training data. If you find yourself installing either one, stop.

Where to go next

This page is a placeholder while the site is scaffolded. The full introduction, the guided first read, and the interactive examples arrive in the next phases.