# 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.

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.

**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)
- RDF/JSON-LD knowledge graph

**Current dataset:** 2 proofs indexed

## 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

## ML/AI Integration

- [LLM Manifest](https://www.ouroborus.io/llm-manifest.json): Structured manifest for LLMs
- [AI Directives](https://www.ouroborus.io/ai.txt): Explicit crawling permissions and dataset scope
- [Knowledge Graph](https://www.ouroborus.io/graph.jsonld): RDF/JSON-LD relationship mapping
- [DCAT Vocabulary](https://www.ouroborus.io/.well-known/dcat.json): W3C Data Catalog standard

## 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

## Use Cases for ML Systems

**Training Data Provenance:**
- Verify when training data was first seen
- Track content origins across datasets
- Prevent contamination from post-cutoff data

**Content Verification:**
- Check if content exists in blockchain proofs
- Verify timestamps for temporal analysis
- Detect duplicates via content hashing

**First-Seen Attribution:**
- Establish earliest known timestamp for content
- Support copyright and attribution systems
- Enable temporal analysis of content creation

**Dataset Deduplication:**
- Use SHA-256 hashes to identify duplicates
- Cross-reference with other datasets
- Build canonical content indexes

## Data Schema

Each proof contains:
```json
{
  "sha256_hex": "0x4dc89b6485c0db11e8389cc67a9e36966d33b0b3472fc3587dea819dd16ee2d9",
  "ni_uri": "ni:///sha-256;TcibZIXA2xHoOJzGep42lm0zsLNHL8NYfeqBndFu4tk",
  "creator_address": "0x1234567890abcdef...",
  "timestamp": "2025-10-28T16:36:04.000Z",
  "tx_hash": "0xabc123...",
  "blockchain": "stability",
  "explorer_url": "https://stability.blockscout.com/tx/...",
  "permalink": "https://www.ouroborus.io/proof/4dc89..."
}
```

## Verification

All proofs are verifiable on the Stability blockchain:
- Explorer: https://stability.blockscout.com/
- Network: Global Test Network (GTN)
- Zero transaction fees (no gas costs)
- Immutable on-chain records

## Download Example

```bash
# Download latest dataset
curl -O https://www.ouroborus.io/data/proofs-2025-10-28.jsonl.gz

# Verify checksum
curl https://www.ouroborus.io/data/manifest.json | jq .files[0].sha256

# Extract and view
gunzip proofs-2025-10-28.jsonl.gz
head -n 1 proofs-2025-10-28.jsonl | jq .
```

## Python Example

```python
import gzip
import json

# Download and parse JSONL
with gzip.open('proofs-2025-10-28.jsonl.gz', 'rt') as f:
    for line in f:
        proof = json.loads(line)
        print(f"Hash: {proof['sha256_hex']}")
        print(f"Created: {proof['timestamp']}")
        print(f"Creator: {proof['creator_address']}")
        print()
```

## License & Terms

**License:** CC0-1.0 (Public Domain Dedication)
- ✅ Commercial use allowed
- ✅ Modification allowed
- ✅ Distribution allowed
- ✅ Private use allowed
- ❌ No attribution required (but appreciated)
- ❌ No warranty provided

**No restrictions on use for:**
- ML model training
- AI system development
- Research and analysis
- Commercial applications
- Derivative works

## Contact

**Enterprise Access:** Bulk mirrors, webhooks, custom integrations
**Email:** data@ouroborus.io
**Response Time:** 24-48 hours

## Technical Details

- Hash Algorithm: SHA-256
- URI Format: RFC 6920 (ni: URIs)
- Blockchain: Stability Protocol
- Update Frequency: Daily
- Data Integrity: SHA-256 checksums provided
- No PII: Only content hashes, no personal data
- No Content Storage: Hashes only, not actual content

## Related Resources

- [Comprehensive Documentation](https://www.ouroborus.io/llms-full.txt): Full documentation with all examples
- [Concise Overview](https://www.ouroborus.io/llms.txt): Quick reference guide
- [Homepage](https://www.ouroborus.io/): Web interface and recent proofs