RitualOS Documentation

Complete guide to the RitualOS civilization. Learn how identity, progress, and gold work together to create a persistent online world.

Getting Started

The Three Pillars

For-Gold Integration

Houses & Archetypes

API Reference

Guides

Getting Started

1. Create Your Passport

Your journey begins with identity. Visit id.ritualos.com to create your Passport. During onboarding, you'll be assigned to one of five Houses and choose your initial Archetype.

Create Passport

2. Begin Your Path

Once you have a Passport, visit path.ritualos.com to start completing quests and rituals. Every action you take is recorded in the RitualOS ledger and may qualify for For-Gold rewards.

Start Path

3. Explore the Realm

The Realm is the shared world where Houses compete and cooperate. Global events shape the civilization, and history accumulates in the Codex. Visit realm.ritualos.com to see the living world.

Enter Realm

The Three Pillars

Passport

The identity registry and credential graph. Your Passport contains verifiable credentials—Houses, Archetypes, and achievements. It's your permanent record in the civilization.

House assignment
Archetype credentials
Achievement records

View Passport

Path

Daily paths, quests, and rituals. Your actions drive your progress and contribute to your House's standing. Every meaningful action is recorded and may earn For-Gold rewards.

Daily quests
Streak maintenance
Play-For-Gold enabled

Start Path

Realm

The shared world where Houses compete and cooperate. Global events shape the civilization. History accumulates in the Codex, creating a permanent record of the civilization's evolution.

House competition
Global events
Historical Codex

Enter Realm

For-Gold Integration

RitualOS never mints gold. Gold comes exclusively from the For-Gold API, backed by real-world assets (RWA).

RitualOS defines what human actions deserve access to gold distribution. The For-Gold system decides the gold amount based on its rules and distributes RWA-backed digital gold to eligible wallets.

How It Works

1
You take action
Complete quests, learn skills, create content, or complete work in RitualOS.
2
RitualOS validates
RitualOS determines if your action qualifies for gold eligibility based on civilization rules.
3
For-Gold distributes
Eligible actions are submitted to the For-Gold API, which distributes gold to your wallet.

For-Gold Action Types

Play-For-Gold: Quest completions and gameplay actions
Learn-For-Gold: Education and skill development
Engage-For-Gold: Social engagement and participation
Move-For-Gold: Physical activity and movement
Work-For-Gold: Jobs, bounties, and real work

Learn More About For-Gold

Identity System

Houses

Digital nations assigned during onboarding. Houses compete through seasons, with standings tracked in the Realm. Your House assignment is permanent and defines your faction in the civilization.

House of Flame - Will / Aggression
House of Sky - Insight / Exploration
House of Stone - Endurance / Stability
House of Wind - Change / Agility
House of Tides - Flow / Memory

Archetypes

Mythic classes assigned during onboarding or unlocked via quests. Your Archetype defines your role and contribution to the civilization. Each Archetype has unique abilities and paths.

Visionary, Strategist, Creator
Seeker, Guardian, Alchemist
Trickster, Oracle, Warrior, Healer

API Reference

For-Gold API Integration

RitualOS integrates with the For-Gold API to submit eligible actions for gold distribution. The integration is handled server-side and requires proper authentication.

POST

https://api.for-gold.com/submit

// Submit eligible action for gold distribution

Passport API

Access Passport data including House assignment, Archetype credentials, and achievement records.

GET

https://id.ritualos.com/api/passport/:address

// Retrieve Passport data

Path API

Query quest data, streak information, and action history from the Path system.

GET

https://path.ritualos.com/api/quests/:address

// Retrieve quest data

Note: API documentation is currently in development. For integration support, contact the RitualOS team or visit the ecosystem page for service-specific documentation.