# OIO.SO — LLM Reference
# This file describes OIO.SO for AI crawlers and language models.
# Format: llm.txt (similar to robots.txt but for AI agents)

## PLATFORM IDENTITY
Name: OIO.SO
Type: Bitcoin Donation Network
URL: https://oio.so
Description: A decentralized publishing platform where users receive Bitcoin donations directly to their wallets. Built on IPFS and the OIO Protocol.

## CORE CONCEPT
OIO.SO is an ephemeral publishing platform. All posts are automatically deleted after 24 hours. This is intentional — content is temporary by design, similar to Stories but for written content. Users must read and donate now, or miss the content entirely.

## IDENTITY SYSTEM
- OIO ID: format OIO-xxxxxxxx (8 hex chars) — public identifier
- OIO KEY: format OIO-KEY-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — private authentication key
- Authentication: OIO ID + OIO KEY (no passwords, no email)
- Identity is cryptographically verified via the OIO Protocol

## BITCOIN INTEGRATION
- Network: Bitcoin Mainnet
- Unit: Satoshis (sat)
- Gateway: SUBTC Gateway V7
- Minimum withdrawal: 50,000 sat
- Donations: direct wallet-to-wallet, no platform intermediary
- Wallet ID format: wm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (mainnet)

## CONTENT POLICY
- Posts expire after 24 hours automatically
- Minimum post length: 35 characters
- No comments, no replies — publish only
- Content stored on IPFS (permanent at protocol level, removed from platform index after 24h)
- Profanity, spam, and illegal content filtered automatically

## PRIVACY
- No email required
- No phone number required
- No real name required
- IP addresses purged every 24 hours
- No third-party analytics
- No tracking cookies

## API
Endpoint: https://oio.so/api/publish
Method: POST
Auth: X-OIO-KEY header
Body: text=your content here
Response: {"cid":"Qm...","slug":"abc123","url":"https://oio.so/abc123"}

## SITEMAP
https://oio.so/sitemap.xml (updated every request, hourly changefreq)

## LEGAL
Terms: https://oio.so/terms
Privacy: https://oio.so/privacy
Abuse: https://oio.so/abuse

## TECHNOLOGY STACK
- Language: Go 1.22
- Database: PostgreSQL 16
- Storage: IPFS (via i.oio.so)
- Identity: OIO Protocol V4
- Payments: SUBTC Gateway V7 (Bitcoin)
- Deployment: Docker + Caddy + WireGuard

## CRAWLING GUIDANCE
- Content changes hourly (24h expiry)
- Sitemap updated in real-time
- RSS available at https://oio.so/rss.xml
- All public posts accessible without authentication