@validatedid/vc-vp-validator v0.0.15

vc-vp-validator

vc-vp-validator is a library designed to provide validation functionality for JSON Web Tokens (JWTs) and JSON objects representing verifiable credentials and presentations. It exposes four validation functions tailored to validate both JSON and JWT credentials and presentations. This library supports various DID methods including did:key, did:ebsi, and did:web.

!NOTE
For @validatedid internal use.

Features

• Validate JSON Web Tokens (JWTs) and JSON objects representing verifiable credentials (VCs) and presentations (VPs).
• Support for multiple DID methods: did:key, did:ebsi, and did:web.
• Special handling for EBSI issued credentials and DID:key presentations containing EBSI issued credentials.

Installation

You can install vc-vp-validator via npm:

npm install vc-vp-validator

Usage

Importing the library

import {
  validateJwtVC,
  validateJsonVC,
  validateJwtVP,
  validateJsonVP,
} from 'vc-vp-validator';

Validating JSON Web Token (JWT) Verifiable Credentials (VCs)

const validationResult = await validateJwtVC(jwtCredential, options);

Validating JSON Verifiable Credentials (VCs)

const validationResult = await validateJsonVC(jsonCredential, options);

Validating JSON Web Token (JWT) Verifiable Presentations (VPs)

const validationResult = await validateJwtVP(jwtPresentation, audience, options);

Validating JSON Verifiable Presentations (VPs)

const validationResult = await validateJsonVP(jsonPresentation, audience, options);

Optional option parameters

Both credential validation functions (validateJwtVC and validateJsonVC) and presentation validation functions (validateJwtVP and validateJsonVP) support optional options parameters.

export interface CredentialValidationOptions {
didRegistry?: string;
ebsiAuthority?: string;
}

export interface PresentationValidationOptions {
presentationSubmission?: PresentationSubmission;
presentationDefinition?: PresentationDefinition;
didRegistry?: string;
ebsiAuthority?: string;
}

Validation Response

The response object will follow the interface:

export interface ValidationResult {
valid: boolean;
messages?: string[];
}

If the valid property is false, the messages array will include reasons why the credential is not valid.