Verification

Learn how to verify Fairseq temporal ordering proofs using the SDK or REST API.

What Verification Proves

When you verify a Fairseq proof, you confirm:

• The transactions were ordered as claimed at proof generation time
• The proof was anchored to a specific time beacon epoch
• The cryptographic commitments are valid
• No tampering has occurred since proof generation

API Verification

// Direct API usage (no SDK required)
const response = await fetch('https://api.fairseq.io/v1/verify', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FAIRSEQ_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ proof_id: 'proof_abc123' }),
});

const result = await response.json();

console.log({
  valid: result.valid,
  lighthouse_epoch: result.lighthouse_epoch,
  anchor_hash: result.anchor_hash,
  verified_at: result.verified_at,
});

Public Verification

Anyone can verify proofs without an API key using the public endpoint:

curl https://api.fairseq.io/v1/verify/proof_abc123

Verification Badge

Embed a verification badge on your site:

<img src="https://api.fairseq.io/badge/proof_abc123" alt="Fairseq Verified" />

Best practices

• Store proof hashes with published batches.
• Verify proofs before publishing status pages.
• Keep proof inputs deterministic to avoid verification drift.