$ USE CASES

import { Kontext } from 'kontext-sdk';

const ctx = Kontext.init({
  projectId: 'my-payment-agent',
  environment: 'production',
});

// One call: compliance check + transaction log + digest chain
const result = await ctx.verify({
  txHash: '0xabc123...',
  chain: 'base',
  amount: '5000',
  token: 'USDC',
  from: '0xAgentWallet...abc',
  to: '0xVendor...def',
  agentId: 'payment-agent-v2',
});

if (result.compliant) {
  console.log('Risk level:', result.riskLevel);       // 'low'
  console.log('Trust score:', result.trustScore.score); // 87
  console.log('Checks passed:', result.checks.length);
} else {
  // result.checks tells you exactly what failed
  // result.recommendations tells you what to do about it
  console.log('Blocked:', result.recommendations);
}

import { Kontext } from 'kontext-sdk';
import Stripe from 'stripe';

const ctx = Kontext.init({
  projectId: 'stripe-agent',
  environment: 'production',
});
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

async function handleAgentPayment(agentId: string, amount: number) {
  // Verify with Kontext before creating payment intent
  const result = await ctx.verify({
    amount: String(amount / 100),
    currency: 'USD',
    from: agentId,
    to: 'merchant-account',
    agentId,
    paymentMethod: 'card',
    metadata: { provider: 'stripe', type: 'payment_intent' },
  });

  if (!result.compliant) {
    throw new Error('Payment blocked by compliance checks');
  }

  // Embed Kontext proof in Stripe metadata for traceability
  const intent = await stripe.paymentIntents.create({
    amount,
    currency: 'usd',
    metadata: {
      kontext_digest: result.digestProof.terminalDigest,
      kontext_trust_score: String(result.trustScore.score),
      agent_id: agentId,
    },
  });

  return intent;
}

import { Kontext } from 'kontext-sdk';

const ctx = Kontext.init({
  projectId: 'anchored-compliance',
  environment: 'production',
});

// verify() with on-chain anchoring -- writes your digest to Base
const result = await ctx.verify({
  txHash: '0xdef456...',
  chain: 'base',
  amount: '25000',
  token: 'USDC',
  from: '0xTreasury...abc',
  to: '0xVendor...def',
  agentId: 'payment-agent-v4',
  reasoning: 'Monthly vendor payment, pre-approved in budget cycle',
  anchor: {
    rpcUrl: process.env.BASE_RPC_URL,
    contractAddress: '0xKontextAnchor...abc',
    privateKey: process.env.ANCHOR_SIGNER_KEY,
  },
});

// The anchor proof is included in the result
if (result.anchorProof) {
  console.log('Digest anchored on-chain');
  console.log('Anchor tx:', result.anchorProof.txHash);
  console.log('Block:', result.anchorProof.blockNumber);
  console.log('Digest:', result.anchorProof.digest);
}

// Anyone can independently verify the anchor later
// Zero dependencies -- uses native fetch() + ABI encoding
import { verifyAnchor } from 'kontext-sdk';
const verification = await verifyAnchor(
  process.env.BASE_RPC_URL,
  '0xKontextAnchor...abc',
  result.anchorProof.digest,
);
console.log('Anchor verified:', verification.anchored); // true

import { Kontext } from 'kontext-sdk';

const ctx = Kontext.init({
  apiKey: process.env.KONTEXT_KEY,
  projectId: 'forensics-dashboard',
  environment: 'production',
  plan: 'payg',
});

// Register agent identities with wallet mappings
ctx.registerAgentIdentity({
  agentId: 'treasury-agent-v2',
  displayName: 'Treasury Agent',
  entityType: 'autonomous',
  wallets: [
    { address: '0xTreasury...abc', chain: 'base', label: 'primary' },
    { address: '0xReserve...def', chain: 'base', label: 'reserve' },
  ],
});

// Detect wallet clusters across all registered agents
const clusters = ctx.getWalletClusters();
// [{ wallets: ['0xTreasury...abc', '0xReserve...def'],
//    heuristics: ['shared-owner', 'funding-chain'],
//    evidence: [...] }]

// Confidence score: how certain is the identity?
const score = ctx.getKYAConfidenceScore('treasury-agent-v2');
// { score: 82, level: 'high', components: [...] }