DEV Community

GUARDIANCHAIN-GC1
GUARDIANCHAIN-GC1

Posted on

How to Create Immutable Audit Trails for AI Agents

#ai #automation #security #blockchain

Troy Anthony Cronin is the founder of GuardianChain, LLC and the architect of GC-1 — non-custodial cryptographic evidence infrastructure for AI accountability. 64,000+ governance capsules sealed, 328-day unbroken sovereign seal chain.

Your AI agent approved a $400K credit line at 2:14 AM. Three months later, the applicant defaults and the regulator calls. Can you prove exactly what the model evaluated, what rules it checked, and why it said yes?

If your agent's audit trail lives in a database you control, the answer is: not really. Mutable logs are not evidence. They are assertions you can edit at any time.

This article shows you how to build immutable audit trails for AI agents — trails that are anchored to public blockchains, independently verifiable by anyone, and cryptographically tamper-proof. No trust in the vendor required.

The Problem with Mutable Logs

Most AI systems log decisions to a database or object store. This creates three problems regulators already understand:

  1. Logs can be altered after the fact. There is no way for an external party to confirm that what you show them today is what actually happened six months ago.

  2. Log completeness is unverifiable. If you deleted an embarrassing entry, no one can prove it was ever there. No one can prove it was not there, either.

  3. Timestamps are self-asserted. Your server clock is not an independent authority. You control it.

Blockchain anchoring solves all three. Once a hash is committed to a public chain, it cannot be edited, deleted, or backdated. The chain's block timestamp is independent of your infrastructure.

Architecture: Non-Custodial Evidence

GC-1's approach is non-custodial. Your data never leaves your infrastructure. Only a SHA-256 hash is submitted. The hash is anchored to up to 6 blockchain networks (Base, Polygon, Ethereum, Optimism, Arbitrum, Arweave) and replicated across 5 cloud storage providers.

This means:

  • GC-1 cannot read your data (it never receives it).
  • GC-1 cannot alter your evidence (blockchain anchors are immutable).
  • Anyone can verify your evidence (public blockchain, no account needed).

Step 1: Seal Agent Decisions

Install the SDK:

npm install @guardianchain-llc/gc1
Enter fullscreen mode Exit fullscreen mode

Seal a governance decision:

import { GuardianChain } from '@guardianchain-llc/gc1';

const gc1 = new GuardianChain({ apiKey: process.env.GC1_API_KEY! });

const decisionData = JSON.stringify({
  agentId: 'lending-agent-v3',
  applicantHash: gc1.hash('applicant-12345'),
  action: 'CREDIT_APPROVED',
  amount: 400000,
  modelVersion: 'gpt-4-turbo-2025-04',
  featuresUsed: ['income', 'employment_length', 'debt_ratio'],
  timestamp: new Date().toISOString(),
});

const capsule = await gc1.seal({
  contentHash: gc1.hash(decisionData),
  anchorClass: 'INSTITUTIONAL_REGULATED',
  metadata: {
    title: "'Credit Decision - Applicant 12345',"
    kind: 'AI_GOVERNANCE',
  },
});
Enter fullscreen mode Exit fullscreen mode

What just happened:

  1. You hashed the decision data locally. The raw data never left your server.
  2. The hash was submitted to GC-1, which anchored it to Base L2 and Polygon.
  3. The hash was replicated to Cloudflare R2, AWS S3, and Backblaze B2.
  4. An Ed25519 certificate was issued and signed.
  5. The capsule was included in the next sovereign seal batch.

The result is a governance capsule with a unique ID, a verification URL, and a certificate PDF — all independently verifiable.

Step 2: Verify Evidence Independently

Any party can verify a capsule without trusting GC-1. The SDK verify method checks the blockchain anchors directly:

const result = await gc1.verify(capsule.data.capsule_id);
// CERTIFIED = anchored on blockchain, signature valid, hash confirmed
Enter fullscreen mode Exit fullscreen mode

For air-gapped or classified environments where no network call is acceptable, use the offline verifier:

npm install -g @guardianchain-llc/gc1-verify

gc1-verify bundle.json
gc1-verify --hash <capsuleId> <contentHash> <anchorClass>
gc1-verify --cert certificate.json
Enter fullscreen mode Exit fullscreen mode

The offline verifier uses only Node.js built-in crypto. No GC-1 libraries, no network calls, no trust in any vendor. If the math checks out, the evidence is valid.

Step 3: Link Decisions to Sessions

Real agents do not make decisions in isolation. They operate in sessions — sequences of related actions. GC-1 links capsules to sessions so the full decision chain is reconstructable:

const sessionStart = await gc1.seal({
  contentHash: gc1.hash(JSON.stringify({
    sessionId: 'lending-review-2026-04-02',
    agentId: 'lending-agent-v3',
    action: 'SESSION_START',
    timestamp: new Date().toISOString(),
  })),
  anchorClass: 'INSTITUTIONAL_REGULATED',
  metadata: {
    title: "'Lending Review Session Start',"
    kind: 'AI_GOVERNANCE',
  },
});

// Agent performs analysis, checks rules, makes decision...

const decision = await gc1.seal({
  contentHash: gc1.hash(JSON.stringify({
    sessionId: 'lending-review-2026-04-02',
    agentId: 'lending-agent-v3',
    action: 'CREDIT_APPROVED',
    amount: 400000,
    ruleResults: [
      { ruleId: 'FAIR_LENDING_001', result: 'PASS' },
      { ruleId: 'DEBT_RATIO_001', result: 'PASS', detail: '0.38 < 0.43' },
    ],
    timestamp: new Date().toISOString(),
  })),
  anchorClass: 'INSTITUTIONAL_REGULATED',
  metadata: {
    title: "'Credit Decision - Approved',"
    kind: 'AI_GOVERNANCE',
  },
});

const history = await gc1.sessionHistory('lending-review-2026-04-02');
Enter fullscreen mode Exit fullscreen mode

Each capsule in the session is independently anchored. If a regulator asks for the complete decision chain, you reconstruct it from the session history — every step is hash-linked and blockchain-proven.

Step 4: Prove What Didn't Happen

Most audit systems can only prove what did happen. GC-1 can prove what didn't happen.

If your lending agent is required to check fair lending rules before every credit decision, the absence of a governance capsule for that check is itself evidence of a violation. GC-1 calls this Silent Witness — an absence proof.

And if your agent was presented with a prohibited action and refused to execute it, that refusal is sealed as a Proof of Restraint capsule. This proves the governance system actively prevented harm, not just that harm didn't happen to occur.

No competitor offers absence proofs or governed refusal evidence. Both are sealed using the same seal method shown above.

Why Not Just Use a Database with Checksums?

You could hash your logs and store the hashes. But who verifies the hashes? You. That is the problem. Self-asserted integrity is not evidence. It is a claim.

Blockchain anchoring moves the trust anchor outside your organization. The hash is committed to a public ledger that you do not control, that you cannot edit, and that anyone can read. That is the difference between a log and evidence.

What This Means for Compliance

The EU AI Act (Article 12) requires high-risk AI systems to maintain logs that enable tracing and auditing. The NIST AI RMF calls for documented AI governance with verifiable records. SEC and FINRA expect auditable decision trails for algorithmic trading and lending.

None of these frameworks are satisfied by mutable database logs. All of them are satisfied by immutable, independently verifiable, cryptographically signed evidence trails.

Getting Started 

npm install @guardianchain-llc/gc1
Enter fullscreen mode Exit fullscreen mode

Three lines to provable governance:

import { GuardianChain } from '@guardianchain-llc/gc1';
const gc1 = new GuardianChain({ apiKey: process.env.GC1_API_KEY! });
const capsule = await gc1.seal({ contentHash: gc1.hash(yourData) });
Enter fullscreen mode Exit fullscreen mode

Public verification requires no API key and no account. Anyone can verify any capsule at any time.

GuardianChain, LLC is a Delaware company building non-custodial cryptographic evidence infrastructure for AI accountability. GC-1 proves what happened, what didn't happen, and what was actively prevented from happening — permanently, independently, and without storing any underlying content.

Top comments (0)