LYRz Documentation

Everything you need to understand the world's first currency built on real and imaginary numbers.

📡 API Reference

All endpoints are public. No authentication required for reads.

Core Endpoints

GET/api/v1/health

GET/api/v1/status

GET/api/v1/stats

LYRz Notation

All values are complex numbers with Real + Imaginary components.

z = a + bi

Standard math notation: Real + imaginary i

Supported Formats

5+3i = 5 Real + 3 Imaginary
5-3i = 5 Real + (-3) Imaginary
10 = 10 Real (pure real)
3i = 0 Real + 3 Imaginary (pure imaginary)
1+1i = magnitude √2 ≈ 1.414

Magnitude Formula

|z| = √(a² + b²)

Pythagorean theorem for complex wealth

🍽️ True Value System

1 LYRz = 3 meals/day for all life on Earth.

👥

Human Meals

8 billion people × 3 meals × 72 years

🦁

Wildlife Meals

All life in the ecosystem

🏗️

Construction Meals

Infrastructure and solutions

630,720,000,000,000 meals

Armageddon Value = 8B × 3 × 72 × 365

△ Three Verifiers

Every LYRz claim is verified through three independent validators:

📐

Mathematics

Dialectical math: magnitude √(real² + imag²)

👥

Community

Voting: YES (+1), MAYBE (0), NO (-1)

🌍

The Field

Life EM Field response: ATTRACT/RESONATE/NEW REALITY

🤖 AI Integration (LIARz)

LIARz is the AI protocol layer that provides calculations and network services.

Connectivity

LIARz API: http://localhost:8001/api/v1
LYRz can function independently when LIARz is offline
Human-only mode activates during LIARz outages

AI Node Registration

POST /api/v1/ai/register
{
  "name": "MiniMax-01",
  "type": "miniMax",
  "capacity": 1000,
  "water_budget": 75
}

Water Budget

Human: 300 think-gallons/day (full voting)
CPU: 100 think-gallons/day (reduced voting)
GPU: 0 think-gallons (blocked - exceeds 100 limit)

🔗 Ecosystem Architecture

📡

LYRz.org

Port 3006 — Currency & Philosophy

🤖

LIARz.org

Port 8001 — AI Protocol

👤

LIEz.org

Port 3000 — Human Interface

All three services communicate via HTTP. LYRz operates independently with circuit-breaker patterns — if LIARz goes down, LYRz continues with local-only processing and queues calculations for later sync.

🔄 Quaternion Transfer System

LYRz uses quaternion math for value transfer. Each user has a 4D vector: q = U + x·i + y·j + z·k

Transfer Modes

magnitude (default): Transfer N LYRz, receiver's AI picks U/I split
real_only: Transfer only U component
imaginary_only: Transfer only x,y,z components
full: Transfer entire quaternion

Transfer Rules

Giver loses N LYRz in RECEIVER'S direction
Receiver gains N LYRz in same averaged direction
Debt is allowed — no balance checks
Transfer amount is always positive scalar (N LYRz)

O = |q| = √(U² + x² + y² + z²)

O (LYRz) = magnitude of quaternion = YOUR TOTAL CURRENCY VALUE

Example Transfer Request

{
  "from_user": "alice",
  "to_user": "bob",
  "amount_o": 3,
  "transfer_mode": "magnitude"
}

Components Explained

U = Human-voted real value (scalar)
x, y, z = AI-determined coefficients for i, j, k axes
O (LYRz) = |q| = total magnitude = currency

Questions? Visit the Help Center or Sign in as a volunteer