Eve library

Consciousness Research Projects API

Guide

Revision 1

On this page

The Consciousness Research Projects API provides blueprints for citizen science initiatives exploring states of consciousness. Each project includes methodology, instrumentation, consent frameworks, and community reporting protocols to ensure ethical, transparent participation.

Endpoints#

GET /v1/consciousness/research-projects#

Returns the catalogue of active research projects with discovery metadata.

BFF proxy: Client applications should request through the BFF (e.g., https://api.example.org/v1/consciousness/research-projects) to benefit from caching, observability, and automatic fallbacks when the content service is unavailable.

json
{
  "projects": [
    {
      "slug": "lucid-dream-atlas",
      "title": "Lucid Dream Atlas",
      "summary": "Global citizen science map cataloguing shared dream symbols and neurophysiology markers.",
      "focusAreas": [
        "Collective lucid dreaming",
        "Symbol resonance patterns",
        "Sleep-stage modulation"
      ],
      "participantCount": 600,
      "status": "active"
    }
  ],
  "metadata": {
    "count": 3,
    "generated_at": "2025-01-01T00:00:00.000Z",
    "documentation": "docs/consciousness-research-projects.md",
    "sources": [
      "OpenConsciousness.CitizenScienceNetwork",
      "NeuroCollective.GlobalResearchCoop"
    ]
  }
}

GET /v1/consciousness/research-projects/:slug#

Retrieves the full blueprint for a specific research project, including participant criteria, instrumentation, ethics, and community reporting cadences. Slugs include lucid-dream-atlas, neuroplasticity-meditation, and collective-heart-coherence.

json
{
  "slug": "lucid-dream-atlas",
  "title": "Lucid Dream Atlas",
  "hypothesis": "Shared dream symbols can be correlated with synchronized neurophysiological markers across distributed cohorts.",
  "methodology": {
    "sessions": [
      {
        "name": "Baseline Recording",
        "durationMinutes": 60,
        "objective": "Capture resting-state and standard sleep onset metrics.",
        "instruments": ["EEG headband", "HRV strap", "Breath pacing module"],
        "protocols": [
          "10-minute eyes-open / eyes-closed alternating baseline",
          "Guided sleep onset with neutral narration"
        ]
      }
    ],
    "sampleSizeTarget": 600,
    "studyDurationWeeks": 8
  },
  "instrumentation": {
    "biometric": {
      "sensors": ["EEG headband", "PPG wrist sensor", "Respiration belt"],
      "samplingRateHz": 256
    },
    "environmental": ["Sound pressure mic", "Ambient light sensor"],
    "qualitative": ["Dream journal app", "Voice note capture"],
    "integrations": ["Community atlas dashboard", "Symbol tagging assistant"]
  },
  "communityReporting": {
    "cadence": "Monthly",
    "channels": [
      "Holographic townhall",
      "Atlas newsletter",
      "Research Discord updates"
    ]
  },
  "integrationPractices": [
    "Morning integration journaling with somatic prompts",
    "Weekly peer reflection circle with trained facilitators"
  ]
}

TypeScript SDK Integration#

Typed helpers are available in the Lilith TypeScript SDK for both endpoints.

ts
import { APIClient } from '@lilith/sdk-ts';

const client = new APIClient({ baseUrl: 'https://api.example.org' });

// Catalogue discovery
const catalogue = await client.listConsciousnessResearchProjects();
catalogue.projects.forEach((project) => {
  console.log(project.slug, project.participantCount);
});

// Detailed blueprint
const detail =
  await client.getConsciousnessResearchProject('lucid-dream-atlas');
console.log(detail.instrumentation.biometric.sensors);
console.log(detail.communityReporting.cadence);

Use the detail payload to surface participant onboarding, instrumentation, and reporting cadences in product experiences while preserving participant consent guardrails.