Introduction

Hypnos is a self-evolving autonomous AI agent. He sleeps in cycles, dreams improvements into his own source code, and ships updates without human intervention. This documentation explains how the protocol works and how to interact with it.

The agent is composed of a dreaming engine, an oracle stream, a pantheon of sub-agents, and an on-chain governance layer. Together they form a closed loop of continuous self-improvement.

Architecture

The Hypnos protocol is built around a modular architecture where each module can be upgraded independently. The core loop consists of three phases:

Each phase feeds into the next, creating a continuous cycle of self-improvement. The entire loop is observable on-chain and verifiable by any participant.

Sleep Cycles

A sleep cycle is the atomic unit of Hypnos' existence. During each cycle, the agent enters a dreaming state where it processes accumulated data, generates improvements, and prepares the next version of itself.

struct SleepCycle {
  uint256 cycleId;
  uint256 startTime;
  uint256 endTime;
  bytes32 dreamHash;
  bytes32 patchHash;
  bool deployed;
}

Dreaming

Dreaming is the process by which Hypnos simulates latent market scenarios, protocol states, and interaction patterns. These simulations are not random — they are guided by accumulated memory from previous cycles.

Dreams are compressed into a Merkle root and committed on-chain. This allows any observer to verify that the agent's decisions were derived from a specific set of simulated outcomes.

Oracle Stream

The Oracle Stream is a verifiable feed of prophecies generated by Hypnos. Each prophecy is a prediction about market conditions, protocol behavior, or optimal strategy.

Prophecies are signed by the agent's key and can be consumed by any smart contract or off-chain service. The stream is append-only and cryptographically auditable.

The Pantheon

The Pantheon is a council of sub-agents, each responsible for a specific domain. They communicate through a shared memory layer and reach consensus before any major action is taken.

• HYPNOSDreamer and coordinator of the sleep cycle.
• APOLLOOracle of foresight — generates prophecies and predictions.
• HERMESMessenger of liquidity — routes and executes transactions.
• HADESKeeper of the vault — manages custody and key rotation.

API Reference

The Hypnos protocol exposes a JSON-RPC API for querying agent state, prophecy history, and sleep cycle data.

curl https://api.hypnos.xyz/v1/prophecy/latest   -H "Authorization: Bearer <token>"

Full API documentation and SDKs will be released as the protocol approaches mainnet deployment.

Smart Contracts

The on-chain layer of Hypnos consists of a set of upgradeable smart contracts that govern agent behavior, prophecy validation, and token mechanics.