Capsule Lifecycle

DRAFT (staged, not yet submitted)
    │
    ▼ submitCapsule()
PENDING (voting window open - 72h)
    │
    ├── Thresholds met → ACCEPTED
    │       │
    │       ▼ finalizeCapsule()
    │   FINALIZED (canonical, distribution active)
    │       │
    │       ├── Challenged → CONTESTED (court case open)
    │       │       │
    │       │       └── Verdict → integrity label applied
    │       │                    VERIFIED | MISLEADING | FRAUDULENT
    │       │
    │       └── Correction submitted → SUPERSEDED
    │               (new PENDING correction Capsule)
    │
    └── Thresholds not met → REJECTED
            │
            └── Can revise and resubmit

// Original capsule
capsule #247: {
  status: "superseded",
  rootCapsuleId: "247",
  parentCapsuleId: null,
  revisionNumber: 0
}

// Correction capsule
capsule #289: {
  status: "finalized",
  rootCapsuleId: "247",    // always points to original
  parentCapsuleId: "247",  // direct parent
  revisionNumber: 1,
  revisionReason: "Vote count corrected from 6-3 to 7-2",
  currentCapsuleId: "289"  // authoritative version
}

GET https://bridge.presschain.io/capsules/:id/history

{
  "rootCapsuleId": "247",
  "currentCapsuleId": "289",
  "chain": [
    { "capsuleId": "247", "revisionNumber": 0, "status": "superseded" },
    { "capsuleId": "289", "revisionNumber": 1, "status": "finalized" }
  ]
}

30 PRESS
├── 35% → Validators          (10.5 PRESS)
├── 20% → Burn Pool           ( 6.0 PRESS)
├── 15% → Media Validators    ( 4.5 PRESS)
├── 10% → Integrity Treasury  ( 3.0 PRESS)
├── 10% → Vault Operators     ( 3.0 PRESS)
└── 10% → Foundation          ( 3.0 PRESS)

Fee charged → PRESS burned
Distribution downgrade applied
Public log entry written on-chain

POST /capsules/:id/supporting
{ "supportingCapsuleId": "190", "relationshipType": "corroborates" }

GET /capsules/:id/supporting
# → array of related capsule IDs and relationship types

// Parse all timestamps (stored as Unix strings)
const capsule = await getCapsule("247");

const opensAt  = new Date(Number(capsule.opensAt)  * 1000);
const closesAt = new Date(Number(capsule.closesAt) * 1000);
const accepted = capsule.acceptedAt
  ? new Date(Number(capsule.acceptedAt) * 1000)
  : null;

// Time remaining in voting window
const now = Date.now();
const remaining = closesAt.getTime() - now;
const hoursLeft = Math.max(0, remaining / 3_600_000).toFixed(1);
console.log(`${hoursLeft}h remaining`);