OpenAgentIDDocumentation
API referencenpm packages@openagentid/oas-vanillaCrypto
OpenAgentIDAPI reference

@openagentid/oas-vanilla/crypto/proof

API contract shipped by @openagentid/oas-vanilla 1.0.2. Exact exports, signatures, dependencies and availability.

All packages · Runnable examples · Start an agent

ContractValue
Package@openagentid/oas-vanilla@1.0.2
Entry point@openagentid/oas-vanilla/crypto/proof
AvailabilityPublished package
Reference sourcePublished JavaScript and JSDoc (inferred types)
Package enginesnode >=20.0.0

Before integrating

Publishes JavaScript with JSDoc, not TypeScript declarations. Inferred signatures are labeled separately.

This reference is generated from the integrity-verified npm archive for this exact version. Signatures describe the public contract; they are not standalone programs. Complete examples are checked separately.

This package ships JavaScript with JSDoc, not .d.ts files. The signatures below are inferred from that published source. An inferred any reflects missing type information in the package.

Import conditions

Use the public entry point above. The package resolves it to these shipped files; do not import its internal files directly.

ConditionPublished file
default./src/crypto/proof.js

Exports

AgentLineageProof

Agent lineage proof with migration-compatible optional security bindings.

Legacy instances remain parseable, but every verification method rejects them with LegacyInsecureProof.

Signature
declare class AgentLineageProof {
  constructor(fields: Record<string, any>);
  static generate(parentKeypair: any, parentDid: any, childDid: any, derivationPath: any): Promise<AgentLineageProof>;
  static generateBound(parentKeypair: OasKeyPair, binding: { parentDid: string; childDid: string; derivationPath: string; verificationMethod: string; childVerificationMethod: string; childPublicKeyMultibase: string; parentDocumentDigest: string; parentDocumentSequence: number; generation: number; }): Promise<AgentLineageProof>;
  static fromJSON(input: any): AgentLineageProof;
  type: any;
  parentDid: any;
  childDid: any;
  derivationPath: any;
  algorithm: any;
  publicKeyMultibase: any;
  verificationMethod: any;
  proofPurpose: any;
  canonicalization: any;
  childVerificationMethod: any;
  childPublicKeyMultibase: any;
  parentDocumentDigest: any;
  parentDocumentSequence: any;
  generation: any;
  signature: any;
  verify(): Promise<void>;
  verifyWithKey(trustedPublicKey: Uint8Array | string): Promise<void>;
  toJSON(): Record<string, string | number>;
}

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:49.

canonicalProofPayload

Constructs exact RFC 8785 UTF-8 bytes for a strict proof.

Signature
declare function canonicalProofPayload(proof: AgentLineageProof | Record<string, any>): Uint8Array;

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:412.

parseLineageProofForMigration

Returns migration diagnostics without establishing authority.

Signature
declare function parseLineageProofForMigration(input: any): Readonly<{ proof: AgentLineageProof; profile: "strict"; authorizes: false; }> | Readonly<{ proof: AgentLineageProof; profile: "legacy"; authorizes: false; diagnosticCode: "LegacyInsecureProof"; }> | Readonly<{ diagnosticCode?: string; proof: AgentLineageProof; profile: "unsupported"; authorizes: false; }>;

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:267.

PROOF_ALGORITHM

Signature
declare const PROOF_ALGORITHM: "HKDF-SHA256-Ed25519";

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:12.

PROOF_CANONICALIZATION

Signature
declare const PROOF_CANONICALIZATION: "JCS-RFC8785";

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:13.

PROOF_PURPOSE

Signature
declare const PROOF_PURPOSE: "capabilityDelegation";

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:14.

PROOF_TYPE

Signature
declare const PROOF_TYPE: "AgentLineageProof2025";

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:11.

validateLineageProofSecurityProfile

Validates strict suite values and mandatory signed bindings.

Signature
declare function validateLineageProofSecurityProfile(proof: AgentLineageProof | Record<string, any>): void;

Source: @openagentid/oas-vanilla@1.0.2, src/crypto/proof.js:304.

Package requirements

This version declares no dependencies or peer dependencies.

Archive verification

Pinned integrity:

SHA-512 integrity
sha512-66sPTWDxCcQ55S9YvPbk4BxF8c92CNqAHOUv7jp1uC+3ygYzZKf5dbvK2/rQwvhP+3oi7T3n1Zn1K1PK99zvMQ==

Machine-readable API manifest · Coverage

On this page