@veriproof/sdk-core

npm install @veriproof/sdk-core

npm install @veriproof/sdk-core @veriproof/sdk-instrumentation-ai-sdk ai

import { configureVeriproof, VeriproofSdkOptions } from '@veriproof/sdk-core';
 
const { provider, exporter } = configureVeriproof(
  VeriproofSdkOptions.createDevelopment({
    apiKey: process.env.VERIPROOF_API_KEY!,
    applicationId: 'your-application-id',
  }),
  {
    serviceName: 'your-application-id',
    setGlobal: true,   // registers as the global TracerProvider
  },
);

// Development / sandbox
VeriproofSdkOptions.createDevelopment({ apiKey, applicationId, tenantId? })
 
// Production
VeriproofSdkOptions.createProduction({ apiKey, applicationId, tenantId? })
 
// From environment variables: reads VERIPROOF_API_KEY and VERIPROOF_APPLICATION_ID
veriproofClientOptionsFromEnv()

import {
  VeriproofClient,
  VeriproofSdkOptions,
  DecisionContext,
  SessionMetadata,
  StepTags,
} from '@veriproof/sdk-core';
 
const client = new VeriproofClient(
  VeriproofSdkOptions.createProduction({ apiKey: process.env.VERIPROOF_API_KEY!, applicationId: 'loan-underwriting' }),
);
 
const session = client
  .startSession('loan-decision')
  .withSessionMetadata(
    SessionMetadata.forTransaction('txn-4421').withEnvironment('production'),
  )
  .addStep('retrieve_credit_profile', { output: { score: 742 } }, StepTags.retrieval())
  .addChatTurn(
    'Should we approve applicant #4421?',
    'Approve with standard terms — strong credit and acceptable leverage.',
    'gpt-4o',
  )
  .setDecision(
    DecisionContext.withOptions(
      'Loan decision',
      ['approve', 'deny', 'manual-review'],
      'approve',
      'Score 742 exceeds threshold; no recent derogatory marks.',
      0.93,
    ),
  );
 
await session.complete();

// Decision with options
DecisionContext.withOptions(
  label,        // e.g. "Loan decision"
  options,      // e.g. ['approve', 'deny', 'manual-review']
  selected,     // e.g. 'approve'
  reasoning?,   // explanatory text
  confidence?,  // 0.0 – 1.0
)
 
// Simple decision
DecisionContext.withScore(label, score, threshold?)

import { computeMerkleRootHex, MerkleTree } from '@veriproof/sdk-core';
 
const tree = new MerkleTree();
tree.addLeaf({ step: 'retrieve_credit_profile', score: 742 });
tree.addLeaf({ step: 'evaluate_rule_set', passed: true });
tree.addLeaf({ decision: 'approve', confidence: 0.93 });
 
const root  = tree.getRootHex();       // SHA-256 Merkle root (hex)
const proof = tree.generateProof(2);   // proof for the third leaf

import { VeriproofIngestTransport } from '@veriproof/sdk-core';
 
const transport = new VeriproofIngestTransport(options);
await transport.submit(payload);          // single payload
await transport.submitBatch(payloads);    // multiple payloads
const healthy = transport.isHealthy();    // false when circuit is open
await transport.forceFlush();             // drain retry buffer immediately
await transport.shutdown();              // graceful shutdown

import { DataEncryptionService } from '@veriproof/sdk-core';
 
const masterKey = DataEncryptionService.generateKeyHex();
const svc = new DataEncryptionService(masterKey);
 
const encrypted = svc.encrypt('sensitive data', 'session-context');
const plain      = svc.decryptToString(encrypted, 'session-context');

import { LogBuffer, BufferFullMode } from '@veriproof/sdk-core';
 
const buf = new LogBuffer<string>(100, BufferFullMode.DropOldest);
 
buf.write('span-abc');               // returns { accepted: true, dropped: [] }
const items = buf.drain();           // removes and returns all items atomically
const snap  = buf.snapshot();        // non-destructive copy
buf.prependMany(['priority-item']);  // insert at front

import { configureVeriproof } from '@veriproof/sdk-core';
import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
 
const { provider } = configureVeriproof(options, { serviceName: 'your-app', setGlobal: true });
 
// Add your secondary exporter on the returned provider
provider.addSpanProcessor(new SimpleSpanProcessor(new OTLPTraceExporter({
  url: 'https://api.honeycomb.io/v1/traces',
})));