@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/issuerUsage
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 linkA complete, tested version: examples/03-issue-hosted.
Secure defaults (0.7.0)
createParrequiresallowedRedirectUris(array orclientId → listfunction); a client without registered addresses is rejected withinvalid_redirect_uri.- DPoP has one function per endpoint:
verifyTokenDpopat the token endpoint,verifyResourceDpop(access token and bound key required) at resource endpoints. verifyKeyAttestation,verifyKaProofandverifyAttestationProofrequirestatusOf(or"none"); results carrystatusChecked.WalletStatusCheckerpins the status list signer to a wallet provider key in the trusted list.
New in 0.8.6
buildCredentialswritesnbf(default: the issuance timeiat; passnbffor a future start, never beforeiat).issuerMetadata({ mdocConfigurations }): each entry takes an optionalscope(default: itsid) so an mdoc configuration can share the SD-JWT configuration's scope, andreusePolicyto publishcredential_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).
Links
- 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