jwt.js

JWT tokens signed using nkeys for Ed25519 for the NATS JavaScript ecosystem.

Very Important Disclaimer

This repository provides an API to build NATS JWTs using JavaScript. However, at this time it is not a supported API. Use at your own risk.

One important take away from this project is that the purpose of the library is for building JWTs, not to validate them exhaustively. This means that tokens generated by this library are expected to be validated by a process that uses the NATS JWT Go library. As that library is the one used by:

• nats-server,
• nats-account-server
• nsc

Under that context, ultimate validity of the JWT is delegated to tools or servers that use the NATS JWT Go library. Use of this library implies an agreement with the above disclaimer.

Installation

This module is distributed in two different registries:

• npm a node-specific library supporting CJS (require) and ESM (import) for node specific projects
• jsr a node and other ESM (import) compatible runtimes (deno, browser, node)

If your application doesn't use require, you can simply depend on the JSR version.

NPM

The NPM registry hosts a node-only compatible version of the library supporting both CJS and ESM:

npm install @nats-io/nats-core

JSR

The JSR registry hosts the ESM-only version of the library.

deno add jsr:@nats-io/jwt

npx jsr add @nats-io/jwt

yarn dlx jsr add @nats-io/jwt

bunx jsr add @nats-io/jwt

API

The API of this library requires knowledge of the NATS JWT entities.

How use it

For now please look at the tests, and investigate the source.