Skip to content

@tamga-network/issuer ​

Everything an institution needs to issue: a credential factory, OpenID4VCI helpers and the revocation-list publisher (Token Status List, fixed interval, random positions; the list format itself is in @tamga-network/sd-jwt and re-exported here). The /client subpath talks to Tamga's hosted issuing service with your institution's API key.

Install ​

sh
npm install @tamga-network/issuer

Usage ​

ts
import { createIssuerClient } from "@tamga-network/issuer/client";

const tamga = createIssuerClient({ baseUrl: "https://issuer.tamga.network", slug: "your-institution", apiKey });
const offer = await tamga.createOffer({ subjectId: "121200001", vct: "urn:tamga:edu:DiplomaCredential:1" });
// offer.deepLink → QR code;  offer.txCode → a different channel, never inside the link

A complete, tested version: examples/03-issue-hosted.

Secure defaults (0.7.0) ​

  • createPar requires allowedRedirectUris (array or clientId → list function); a client without registered addresses is rejected with invalid_redirect_uri.
  • DPoP has one function per endpoint: verifyTokenDpop at the token endpoint, verifyResourceDpop (access token and bound key required) at resource endpoints.
  • verifyKeyAttestation, verifyKaProof and verifyAttestationProof require statusOf (or "none"); results carry statusChecked. WalletStatusChecker pins the status list signer to a wallet provider key in the trusted list.

New in 0.8.6 ​

  • buildCredentials writes nbf (default: the issuance time iat; pass nbf for a future start, never before iat).
  • issuerMetadata({ mdocConfigurations }): each entry takes an optional scope (default: its id) so an mdoc configuration can share the SD-JWT configuration's scope, and reusePolicy to publish credential_reuse_policy (ADR-0089).

Status ​

Published on npm as the 0.8.6 test release; the stable 1.0.0 comes when everything is ready. In test releases the API may change. Every release is built from this repository by GitHub Actions and carries npm provenance (verifiable link to the source commit).

  • Working examples, run in CI against the real packages: examples/
  • Integration guides and specifications: docs.tamga.network
  • Code: Apache-2.0 · Documentation: CC BY 4.0