🔒 SIGILLO API v5.4.0

Cryptographic document certification with server-side Merkle chain.

⚠️ Important Legal Notice

SIGILLO is NOT a Qualified Trust Service Provider (QTSP) under eIDAS Regulation. Timestamps are server-generated and NOT RFC 3161 compliant. This service provides technical documentation only, not legal certification. For legal proceedings, consult a qualified professional.

What SIGILLO Can and Cannot Do

CapabilityStatusNotes
Proof of Existence✓ SupportedHash existed at server timestamp
Proof of Ordering✓ SupportedMerkle chain proves A registered before B
Proof of Absence✗ Not PossibleCan only confirm "not in THIS registry"
Legal Timestamp⚠ LimitedNot eIDAS qualified, server time only

Endpoints

Register Document

POST /register v5.4.0

Register a document hash. Server calculates Merkle chain.

{
  "hash": "64-char-hex-sha256",
  "filename": "document.pdf",
  "size": 12345
}

Response (201):

{
  "status": "registered",
  "registration": {
    "id": "uuid",
    "hash": "...",
    "merkle": "...",
    "prev_merkle": "...",
    "chain_position": 123,
    "server_timestamp": "ISO8601",
    "signature": "..."
  }
}

Verify Document

GET /verify/{hash}

Check if a document hash is registered.

Response (200 - Found):

{
  "status": "found",
  "registration": { ... },
  "verification": {
    "timestamp": "ISO8601",
    "chain_verified": true
  }
}

Response (404 - Not Found):

{
  "status": "not_found",
  "note": "Hash NOT FOUND in registry as of timestamp",
  "disclaimer": [
    "This does NOT prove document never existed",
    "Only confirms not in THIS registry"
  ]
}

Chain Verification v5.4.0

GET /chain/verify

Verify integrity of the entire Merkle chain.

Statistics

GET /stats

Get registry statistics and chain state.

Rate Limits

TierLimitReset
Free (anonymous)100 requests/dayMidnight UTC
ProContact us-

OMBRA Lifecycle v5.4.0

Every entity (document or AI execution) follows the OMBRA lifecycle. Events are recorded automatically or via explicit API calls.

StateTriggerDescription
GENESISAuto on /registerEntity first created
ITERAuto on /verifyEntity verified or accessed
TELOSPOST /crt/foldPeriod compressed into SuperAtomo
MUTATIONEPOST /crt/revoke/{id}Entity revoked (data preserved)
EXTINCTIOPOST /crt/extinct/{id}End of lifecycle (irreversible)

Get Lifecycle

GET /crt/lifecycle/{id} v5.4.0

Get all lifecycle events for an entity. Accepts UUID (document) or exec:{execution_id} (AI).

Geometric Verification

GET /crt/verify-geometric/{id} v5.4.0

Run 3-geometry verification: Topology (graph integrity), Vector (temporal monotonicity), Projection (folding readiness).

Temporal Folding (SuperAtomo)

POST /crt/fold v5.4.0

Compress a time period into a single atom. Minimum 10 records per period.

{
  "period": "2026-01",
  "period_type": "MONTHLY"
}

Valid period types: MONTHLY, QUARTERLY, YEARLY

List Atoms

GET /crt/atoms v5.4.0

List all compressed atoms with compression metrics.

Revoke Entity

POST /crt/revoke/{id} v5.4.0

Revoke an entity (MUTATIONE). Data preserved for audit. Blocked if already EXTINCTIO.

{ "reason": "Contract expired" }

Extinct Entity

POST /crt/extinct/{id} v5.4.0

Mark entity as permanently extinct (EXTINCTIO). No further transitions possible. Data preserved.

{ "reason": "End of lifecycle" }

CRT Statistics

GET /crt/stats v5.4.0

Lifecycle events count by type, geometric verifications, temporal folding metrics.

AI Execution Tracking v5.4.0

Certify AI decision chains with OMBRA lifecycle integration.

Register Execution Step

POST /register-execution

Register an AI execution step. INTENT at step 0 triggers GENESIS; subsequent steps trigger ITER.

{
  "execution_id": "ai-run-001",
  "step_number": 0,
  "step_type": "INTENT",
  "hash": "64-char-hex",
  "merkle": "64-char-hex",
  "intent_score": 0.95,
  "parent_step_hash": null
}

Valid step types: INTENT, EXECUTION, HALT, FINAL

Get Execution Trace

GET /execution/{id}

Retrieve all steps for an execution.

Verify Execution Chain

POST /execution/{id}/verify

Mathematical chain verification: step continuity, hash linkage, merkle presence, parent linkage. Triggers ITER event.

Security Features (v5.4.0)

SIGILLO v5.4.0 — Angelia srl SB — CRT-Certifications.org