@vane.build/sdk

npm install @vane.build/sdk

import { VaneClient } from '@vane.build/sdk';

// Object form (recommended)
const client = new VaneClient({
  baseUrl: 'https://vane.build',
  apiKey: 'vane_a1b2c3d4...',
});

// Positional form
const client = new VaneClient('https://vane.build', 'vane_a1b2c3d4...');

const record = await client.attest(
  agentId,      // string — the agent taking the action
  companyId,    // string — your company ID (embedded in payload; server uses API key for auth)
  actionType,   // string — what the agent did
  payload,      // unknown — any JSON-serializable value
  delegationToken?, // string — optional delegation JWT
);

const record = await client.attest(
  'researcher-1',
  'acme',
  'web-search',
  {
    query: 'EU AI Act compliance requirements',
    results: 10,
    topUrl: 'https://example.com/eu-ai-act',
  },
);

console.log(record.index);     // 0
console.log(record.hash);      // 'f651a7c3...'
console.log(record.signature); // 'vdv-nC4o...'

const proof = await client.getProof(index); // number

const { record, proof, root } = await client.getProof(0);

// Verify the proof manually:
// Start from record.hash, apply each sibling, assert result equals root

import type {
  VaneClientOptions,
  AttestationRecord,
  DelegationInfo,
  ActClaim,
  ProofNode,
  InclusionProof,
} from '@vane.build/sdk';

interface AttestationRecord {
  index: number;
  timestamp: string;         // ISO 8601
  payload: unknown;
  delegation?: DelegationInfo;
  hash: string;              // SHA-256 hex
  signature: string;         // base64url Ed25519 signature
}

interface DelegationInfo {
  subject: string;           // SPIFFE ID of the subject
  delegationChain: string[]; // [subject, ..., actor]
  act: ActClaim | null;
  tokenId: string;           // jti of the delegation token
}

interface ActClaim {
  sub: string;
  act?: ActClaim; // nested for multi-hop chains
}

interface InclusionProof {
  record: AttestationRecord;
  proof: ProofNode[];
  root: string;
}

interface ProofNode {
  sibling: string;
  position: 'left' | 'right';
}

import { VaneClient } from '@vane.build/sdk';

const client = new VaneClient({
  baseUrl: process.env.VANE_URL!,
  apiKey: process.env.VANE_API_KEY!,
});

async function main() {
  // Attest a tool call
  const record = await client.attest(
    'researcher-1',
    'acme',
    'tool-call',
    {
      tool: 'web-search',
      input: 'EU AI Act compliance',
      output: 'Found 42 relevant documents',
      durationMs: 830,
    },
  );

  console.log(`Attested at index ${record.index}`);

  // Get an inclusion proof for the record
  const { proof, root } = await client.getProof(record.index);
  console.log(`Merkle root: ${root}`);
  console.log(`Proof has ${proof.length} nodes`);
}

main().catch(console.error);