# Stability Proof Index

> Timestamped, verifiable proofs of content creation on the Stability blockchain. Bulk data exports (JSONL), API access, and real-time feeds. CC0-1.0 license. Perfect for training data provenance, content verification, and "first seen" timestamps.

## What This Site Is

This is a **blockchain proof indexing system** that provides cryptographic proof of when content was created. Each proof links a SHA-256 content hash to an on-chain transaction with a verifiable timestamp.

**Source of Truth:**
- Primary data source: Stability Protocol blockchain
- This site indexes and provides human/machine-readable access to on-chain proofs
- Each proof URL is immutable once created
- Transaction hashes link to blockchain explorer for verification

**Key features:**
- Daily JSONL exports with checksums
- Static JSON API for hash lookups
- Real-time Atom feed with WebSub
- OpenAPI 3.0 specification
- All data is CC0 (public domain)

**Current dataset:** 2 proofs indexed

## Site Structure & Endpoints

**Homepage** (`/`): Dataset overview, recent proofs, discovery links

**Proof Pages** (`/proof/{hash}/`): Individual proof with full metadata
- Each proof page is the canonical source for that specific proof
- Includes JSON-LD structured data embedded in HTML
- Immutable once created (hash-based URLs)

**Machine-Readable Formats:**
- `/proof/{hash}/linkset.json` - RFC 9264 resource relationships
- `/sitemap.xml` - All proof URLs for crawlers
- `/feed.xml` - Real-time Atom feed with WebSub
- `/rss.xml` - RSS 2.0 feed
- `/graph.jsonld` - RDF knowledge graph of all proofs and creators

**Data Access:**
- `/data/manifest.json` - Bulk export metadata and checksums (SOURCE OF TRUTH for bulk data)
- `/data/proofs-{date}.jsonl.gz` - Compressed bulk export
- `/api/v1/resolve/{hash}.json` - JSON API for hash lookups
- `/api/v1/stats.json` - Dataset statistics

**Discovery & Standards:**
- `/robots.txt` - Crawler permissions (all AI crawlers explicitly allowed)
- `/llms.txt` - This file
- `/ai.txt` - AI agent directives
- `/dataset.json` - Schema.org Dataset metadata
- `/openapi.json` - OpenAPI 3.0 specification

## Quick Start

- [Dataset Manifest](https://www.ouroborus.io/data/manifest.json): Metadata, checksums, schema, file listing
- [Download Latest JSONL](https://www.ouroborus.io/data/proofs-2025-10-28.jsonl.gz): Gzipped bulk export (updates daily)
- [API Index](https://www.ouroborus.io/api/v1/index.json): All available API endpoints with examples

## API Documentation

- [OpenAPI Specification](https://www.ouroborus.io/openapi.json): Complete API docs in OpenAPI 3.0 format
- [Dataset Documentation](https://www.ouroborus.io/.well-known/dataset.json): Schema.org structured metadata
- [API Statistics](https://www.ouroborus.io/api/v1/stats.json): Proof count, creators, timestamps

## Data Access Methods

- [Bulk JSONL Export](https://www.ouroborus.io/data/proofs-2025-10-28.jsonl.gz): Newline-delimited JSON, gzipped, with SHA-256 checksum
- [API - Latest Manifest](https://www.ouroborus.io/api/v1/manifest/latest.json): Info about latest dataset export
- [API - Resolve Hash](https://www.ouroborus.io/api/v1/resolve/0x4dc89b6485c0db11e8389cc67a9e36966d33b0b3472fc3587dea819dd16ee2d9.json): Look up any content hash

## Real-time Feeds

- [Atom Feed](https://www.ouroborus.io/feed.xml): Real-time updates with WebSub support
- [Sitemap](https://www.ouroborus.io/sitemap.xml): All proofs for search engine indexing

## Standards & Specs

- [JSON-LD Examples](https://www.ouroborus.io/proof/4dc89b6485c0db11e8389cc67a9e36966d33b0b3472fc3587dea819dd16ee2d9/): See structured data implementation
- [Linkset JSON](https://www.ouroborus.io/proof/4dc89b6485c0db11e8389cc67a9e36966d33b0b3472fc3587dea819dd16ee2d9/linkset.json): RFC 9264 resource relationships
- [IndexNow Configuration](https://www.ouroborus.io/indexnow-urls.json): Push notification setup

## Example Proofs

- [Proof 0x4dc89b64...](https://www.ouroborus.io/proof/4dc89b6485c0db11e8389cc67a9e36966d33b0b3472fc3587dea819dd16ee2d9/): Text content proof with metadata
- [Proof 0x7f83b165...](https://www.ouroborus.io/proof/7f83b1657ff1fc53b92dc18148a1d65dfc2d4b1fa3d677284addd200126d9069/): Simple test proof

## Optional

- [Robots.txt](https://www.ouroborus.io/robots.txt): Crawler instructions
- [GitHub Repo](https://github.com/yourusername/stbl_index): Source code (if applicable)
- [UCFR Specification](https://stability.blockscout.com/): Universal Content Format Registry on Stability blockchain

## Use Cases

**Content Provenance:** Verify when content was first created using blockchain timestamps.

**Training Data Attribution:** Prove when training data existed and who created it.

**Deduplication:** Check if content hash already exists before processing.

**"First Seen" Proof:** Provide cryptographic proof of content existence at a specific time.

## Data Format

Each JSONL record contains:
- `sha256_hex`: Content hash (0x... format)
- `ni_uri`: RFC 6920 named information URI
- `creator_address`: Ethereum address
- `timestamp`: ISO 8601 timestamp
- `tx_hash`: Blockchain transaction hash
- `permalink`: Permanent URL to proof page
- `blockchain`: "stability"
- `network`: "testnet"
- `explorer_url`: Blockchain explorer link

## Contact

**Enterprise Access:** Bulk mirrors, embeddings, webhooks, custom integrations
**Email:** data@ouroborus.io
**License:** CC0-1.0 (Public Domain)