Integrations
An admissions office, an employer's HR system or another credential platform can check Certichain credentials without using the web application. This section covers the ways to do that.
All of them rest on the same fact: a credential's state lives on the chain, and each method either reads the chain itself or receives an answer signed by a key the caller pinned.
Choosing a method
| Method | Needs | Trust rests on | Page |
|---|---|---|---|
| REST API | HTTPS | The API signer address you pinned | REST API |
| JavaScript SDK | Node.js 20 or a browser | The same, checked for you | SDK |
| Standard VC verifier | A VC library such as Digital Bazaar's, the Certichain plugin, the status list publisher address | The issuer's signature, the status list publisher you pinned, and the chain | Verifiable credentials, Interop and SDK tests |
| Command-line verifier | Node.js, optionally an RPC endpoint | The issuer's signature and the chain | Command-line tools |
| Direct chain reads | An RPC endpoint and the contract ABIs | The chain only | Contracts, Deployment manifest |
The API and SDK are the simplest: one HTTPS call and a signature check. Reading the chain directly removes trust in the deployment's server entirely, at the cost of running more code.
The REST API and status lists are built but switched off on the Sepolia deployment until the owner sets their signer keys. The SDK is not published to npm. The command-line verifier and direct chain reads work now. Everything runs on the Sepolia test network only.
Pages in this section
| Page | What it covers |
|---|---|
| REST API | Endpoints, parameters, answers, limits and errors |
| SDK | @certichain/sdk: options, calls, checks, standing and errors |
| Command-line tools | Credential verifier, import check, access tool, API keys, circuit files, network cost tools |
Related formats: API envelope, Credential package, Verifiable credential.
Source files
src/app/api/v1/,src/lib/server/api/,src/lib/api/packages/sdk/blockchain/scripts/verify-credential.tsinterop/(independent verifier library tests)docs/api/README.md
Tests
src/lib/server/api/*.test.ts,packages/sdk/test/,interop/test/- E2E:
e2e/journeys/verification-api.journey.ts