Aetherna

Aetherna is an experimental AI + DeFi protocol workspace centered on a Solana-based RAPR token/treasury system and an Athena/Aetherna agent that can publish protocol updates and prepare parameter changes.

This repository is a multi-part prototype, not a single packaged application.

Repository Structure

• gui/ - Next.js frontend for the public Aetherna interface, staking/ticket pages, charts, profile views, meme creation, and documentation pages
• api/ - NestJS API and Socket.IO gateway for health/status, tweet publishing, scheduled mood/config updates, and Solana transaction submission
• solana/ - Rust Solana program for RAPR minting, burning, transfers, staking, ticket purchase/redeem, treasury setup, and protocol config updates
• agent/ - Athena agent configuration, environment placeholders, Akash deployment scaffolding, and personality/config JSON
• model/ - local model, LoRA, conversion, and dataset artifacts used during Athena model experiments
• deploy.sh - deployment helper script

Main Components

Frontend

The GUI is a Next.js 15 app using React 19, Tailwind CSS, Radix UI primitives, Recharts, and custom Aetherna assets. It contains pages for:

• homepage and docs
• staking
• ticket buying/selling
• charts
• profile and transaction history
• meme creation

API

The API is a NestJS 10 service with:

• HTTP health/status endpoint
• Socket.IO gateway
• scheduled Athena mood publishing
• Twitter posting hooks
• Solana devnet transaction flow for protocol config updates

The API expects runtime environment variables for Twitter and Solana signing before the live actions can work.

Solana Program

The Solana program is named rapr and includes instruction handlers for minting, burning, transfers, staking, unstaking, ticket purchase/redeem, treasury setup, config initialization, config updates, config retrieval, and token withdrawals.

Agent And Model Artifacts

The agent/ package contains configuration and deployment scaffolding for an Athena/RAPR protocol agent. In this snapshot, the package scripts reference TypeScript source files under agent/src/, but that source directory is not present. Treat the agent folder as scaffolding/config unless source files are restored.

The model/ folder contains experimental model, adapter, and dataset files. It is not wired as a standalone package from the repository root.

Quick Start

Run each module from its own directory.

GUI

cd gui
pnpm install
cp env-example .env.local
pnpm dev

Open http://localhost:3000.

API

cd api
pnpm install
pnpm start:development

Required live-action environment variables include:

PROGRAM_ID=
ADMIN_PRIVATE_KEY=
ADMIN_PUBLIC_KEY=
TWITTER_KEY=
TWITTER_SECRET=
TWITTER_AT=
TWITTER_AT_SECRET=

Without those values, read-only health checks may work, but Twitter and Solana actions will not.

Solana Program

cd solana
pnpm install
pnpm test:build
pnpm test:run

pnpm test builds the SBF program and runs the TypeScript tests.

Status

This is a prototype workspace with several active experiments and some generated/model artifacts checked in. The root README is the canonical project overview; subdirectories may contain lower-level notes for their own modules.