Skip to content

Blockchain Audit Trail

Kiket provides immutable, blockchain-verified audit logs for all critical operations in your organization. Records are anchored to the Polygon blockchain, providing cryptographic proof that data has not been tampered with.

How It Works

  1. Audit Logging - All actions (issue changes, AI decisions, config updates) create audit records with cryptographic content hashes
  2. Merkle Tree Batching - Records are grouped into Merkle trees at regular intervals
  3. Blockchain Anchoring - The Merkle root is submitted to the Polygon blockchain
  4. Verification - Any record can be independently verified against the chain
┌──────────────────────────────────────────────────────────────────┐
│                    Blockchain Anchoring Flow                      │
├──────────────────────────────────────────────────────────────────┤
│                                                                   │
│  Action occurs    SHA-256 Hash    Merkle Tree     Polygon TX     │
│  ┌─────────┐      ┌─────────┐     ┌────────┐     ┌──────────┐   │
│  │ Issue   │──────│ Content │─────│  Root  │─────│ Anchor   │   │
│  │ Update  │      │  Hash   │     │  Hash  │     │ Contract │   │
│  └─────────┘      └─────────┘     └────────┘     └──────────┘   │
│                                                                   │
└──────────────────────────────────────────────────────────────────┘

Anchoring Frequencies

Plan Standard Frequency High-Frequency Option Immediate Anchoring
Starter Hourly No No
Professional Hourly 15 minutes No
Enterprise Hourly 15 minutes Yes (configurable)

High-Frequency Anchoring (Professional+)

Organizations with compliance requirements can enable 15-minute anchoring intervals for faster verification times.

Immediate Anchoring (Enterprise)

Critical actions can trigger immediate anchoring (within a 5-minute batched window):

  • Role changes (user permissions modified)
  • Approval decisions (granted or denied)
  • API key creation/revocation
  • Secret management operations

What Gets Anchored

Issue Lifecycle

  • Issue creation, updates, and deletion
  • Status transitions and workflow changes
  • Comment additions and modifications
  • Attachment uploads

AI Operations

  • AI agent invocations and decisions
  • Auto-assignment recommendations
  • Generated content and suggestions
  • Model performance metrics

Configuration Changes

  • Workflow definition updates
  • Extension installations and settings
  • Project settings modifications
  • Organization-wide configuration

Security Events

  • User permission changes
  • API key management
  • OAuth connection changes
  • GitHub sync operations

Viewing Anchor Status

Admin Dashboard

Organization admins can view blockchain anchoring status at /blockchain:

  • Total Anchors - Number of Merkle roots submitted
  • Confirmed - Successfully verified on-chain
  • Pending - Awaiting blockchain confirmation
  • Failed - Needs retry (automatic)

Activity Log

Users can view their organization's audit trail at /audit_trail:

  • Filter by action type, resource, or date range
  • See blockchain verification status for each action
  • Export personal audit history

Record Badges

Throughout the application, look for blockchain status indicators:

  • Verified (green chain icon) - Record is blockchain-anchored
  • Pending (yellow clock icon) - Awaiting next anchor batch

Next Steps

  • [Verifying Records(blockchain-verification.md) - Learn how to verify individual records
  • [Compliance Reports(../compliance/blockchain-reports.md) - Generate audit reports with proofs
  • [Blockchain API(../api/blockchain.md) - Programmatic access to anchoring data