[jeffrey-graham]

Summary

Builds the authoritative blockchain verification status service and Next.js API endpoints for Stellar-linked snippets.

Key Changes

• lib/blockchain-verification-service.ts:
  • Supports all 5 verification lifecycle states (pending, confirmed, failed, unverifiable, retry_scheduled).
  • Validates Stellar transaction existence, on-chain outcome (successful), ledger confirmation, network matching, and expected operation/memo matching.
  • Prevents duplicate verification records across repeated and concurrent requests via in-flight coalescing and composite key indexing.
  • Implements recoverable retry scheduling for Horizon timeouts, RPC errors, and network outages with retry exhaustion handling (RETRY_EXHAUSTED).
  • Enforces read/write authorization for private/shared snippets and strips internal ownership fields from public verification responses.
  • Records immutable audit trail entries for all verification attempts, retries, and state transitions.
• API Endpoints:
  • GET /api/snippets/[id]/verification-status
  • POST /api/snippets/[id]/verify
  • GET /api/verifications/[verificationId]
  • POST /api/verifications/[verificationId]/retry
• Tests (lib/__tests__/blockchain-verification-service.test.ts):
  • 16 unit and route handler tests covering all lifecycle states, network errors, retry exhaustion, authorization, audit logging, and idempotency.

Closes #221

[vercel]

@jeffrey-graham is attempting to deploy a commit to the Sudipta 's projects Team on Vercel.

A member of the Team first needs to authorize it.