HashiCorp Vault Verifier Factory API Reference

This document provides a concise API reference for the VaultVerifierFactory class within the Hedera DID SDK for JavaScript. The VaultVerifierFactory class is responsible for creating Vault Verifier instances and authenticating with HashiCorp Vault to securely manage cryptographic keys.

Class Diagram

The class diagram below illustrates the core methods of the Vault VaultVerifierFactory interface for interacting with HashiCorp Vault.

vault verifier factory class diagram

Static Methods

loginWithToken

static loginWithToken(
    options: VaultLoginWithTokenOptions,
): Promise<VaultVerifierFactory>

Creates a new VaultVerifierFactory instance by authenticating with HashiCorp Vault using an access token.

Parameters

  • options: An object containing the necessary options to authenticate with HashiCorp Vault using an access token (refer to VaultLoginWithTokenOptions Type for details).

Returns

  • The new VaultVerifierFactory instance.

loginWithUsernameAndPassword

static loginWithUsernameAndPassword(
  options: VaultLoginWithUsernameAndPasswordOptions,
): Promise<VaultVerifierFactory>

Creates a new VaultVerifierFactory instance by authenticating with HashiCorp Vault using a username and password.

Parameters
Returns

  • The new VaultVerifierFactory instance.

loginWithAppRole

static async loginWithAppRole(
  options: VaultLoginWithAppRoleOptions,
): Promise<VaultVerifierFactory>

Creates a new VaultVerifierFactory instance by authenticating with HashiCorp Vault using an AppRole.

Parameters

  • options: An object containing the necessary options to authenticate with HashiCorp Vault using an AppRole (refer to VaultLoginWithAppRoleOptions Type for details).

Returns

  • The new VaultVerifierFactory instance.

Methods

forKey

forKey(keyName: string): Promise<Verifier>

Returns a Vault Verifier instance for the specified key stored in HashiCorp Vault.

Parameters

  • keyName: The unique identifier for the key stored in HashiCorp Vault.

Returns

  • A Verifier instance for the specified key.

Data Types

This section elaborates on the data types employed within the VaultVerifierFactory class.

VaultLoginWithTokenOptions Type

The VaultLoginWithTokenOptions type is an object that contains the necessary options to authenticate with HashiCorp Vault using an access token.

Name Type Description

token

string

The access token used to authenticate with HashiCorp Vault.

url

string | URL

The URL of the HashiCorp Vault server.

transitPath?

string

The path for the transit secret engine. Default is transit.

VaultLoginWithUsernameAndPasswordOptions Type

The VaultLoginWithUsernameAndPasswordOptions type is an object that contains the necessary options to authenticate with HashiCorp Vault using a username and password.

Name Type Description

username

string

The username used to authenticate with HashiCorp Vault.

password

string

The password used to authenticate with HashiCorp Vault.

url

string | URL

The URL of the HashiCorp Vault server.

transitPath?

string

The path for the transit secret engine. Default is transit.

VaultLoginWithAppRoleOptions Type

The VaultLoginWithAppRoleOptions type is an object that contains the necessary options to authenticate with HashiCorp Vault using an AppRole.

Name Type Description

roleId

string

The ID of the AppRole used to authenticate with HashiCorp Vault.

secretId

string

The secret ID of the AppRole used to authenticate with HashiCorp Vault.

url

string | URL

The URL of the HashiCorp Vault server.

transitPath?

string

The path for the transit secret engine. Default is transit.

Errors

Exception code Description

invalidArgument

Specified key does not exist or cannot be accessed.

internalError

Vault authentication failed.

Class Implementation

The Hiero DID SDK provides the VaultVerifierFactory class within its verifier-hashicorp-vault package. For further details, refer to the @hiero-did-sdk-js/verifier-hashicorp-vault package documentation.