Icard/angular-clarity-master(work.../node_modules/@sigstore/tuf
realSnehal 400e0876de frontend 2024-07-16 20:25:36 +05:30
..
dist frontend 2024-07-16 20:25:36 +05:30
store frontend 2024-07-16 20:25:36 +05:30
LICENSE frontend 2024-07-16 20:25:36 +05:30
README.md frontend 2024-07-16 20:25:36 +05:30
package.json frontend 2024-07-16 20:25:36 +05:30

README.md

@sigstore/tuf · npm version CI Status Smoke Test Status

A JavaScript library for securely retrieving targets from the Sigstore TUF repository.

Features

  • Embeds the trutsted root metadata file necessary to bootstrap interaction with the Sigstore TUF repository.
  • Automatically initializes the local TUF cache for storing metadata and target files.

Prerequisites

  • Node.js version >= 14.17.0

Installation

npm install @sigstore/tuf

Usage

const { initTUF } = require('@sigstore/tuf')
import { initTUF } from '@sigstore/tuf'

initTUF([options])

Returns a TUF client which can be used to retrieve any target from the Sigstore TUF repository. The local TUF cache will be initialized and the TUF metadata files downloaded from the remote repository as part of the initialization process.

  • options <Object>
    • mirrorURL <string>: Base URL for the Sigstore TUF repository. Defaults to 'https://tuf-repo-cdn.sigstore.dev'
    • cachePath <string>: Absolute path to the directory to be used for caching downloaded TUF metadata and targets. Defaults to a directory named "sigstore-js" within the platform-specific application data directory.
    • rootPath <string>: Path to the initial trust root for the TUF repository. Defaults to the embedded root.

The TUF client object returned from initTUF has a single getTarget function which takes the name of a target in the Sigstore TUF repository and returns the content of that target.

getTrustedRoot([options])

Retrieves the most recent version of the "trusted_root.json" target from the Sigstore TUF repository. The format of "trusted_root.json" file is described by the TrustedRoot protobuf and contains the complete set of trusted verification materials for the Sigstore public-good instance.

  • options <Object>
    • mirrorURL <string>: Base URL for the Sigstore TUF repository. Defaults to 'https://tuf-repo-cdn.sigstore.dev'
    • cachePath <string>: Absolute path to the directory to be used for caching downloaded TUF metadata and targets. Defaults to a directory named "sigstore-js" within the platform-specific application data directory.
    • rootPath <string>: Path to the initial trust root for the TUF repository. Defaults to the embedded root.