UVerify Examples

Official code examples for integrating UVerify — on-chain certificate anchoring on Cardano.

Examples run against the Cardano preprod testnet by default. No tADA required — the UVerify faucet funds your wallet on first run. For fully local development, start the sandbox below.

Sandbox (local devnet)

The sandbox runs a complete UVerify stack on your machine using Docker — Cardano devnet, backend, and UI — with contracts already deployed and funded.

Prerequisites: Docker Desktop 24+

./sandbox.sh start

  Service                     URL
  ─────────────────────────   ──────────────────────────────────────────
  UVerify UI                  http://localhost:3000
  UVerify Backend             http://localhost:9090
  API docs (Swagger)          http://localhost:9090/swagger-ui
  Chain viewer                http://localhost:3001
  Yaci Store API              http://localhost:8080
  Yano devnet API             http://localhost:7070/q/swagger-ui

./sandbox.sh info      # show service status and URLs
./sandbox.sh stop      # stop all services
./sandbox.sh restart   # stop then start

To reset all persisted chain data and start fresh from the snapshot:

(cd sandbox && docker compose down -v)
./sandbox.sh start

Examples

Each language directory contains the same set of certificate templates. Pick your language and run an example:

TypeScript (Deno)

cd typescript/notary
deno run -A index.ts

Example	Description
notary/	Proof of existence for files, contracts, and creative works
diploma/	Batch-issue academic degree certificates
laboratory_report/	Privacy-preserving lab report certification
certificate_of_insurance/	Insurance certificate issuance
digital_product_passport/	EU Digital Product Passport
pet_necklace/	QR-code pet ID necklace tags
product_verification/	Anti-counterfeiting product authentication
document_integrity/	File integrity verification with drag-and-drop
tokenizable_certificate/	Issue and redeem CIP-68 NFT certificates

Python

cd python/<example>
pip install -r requirements.txt
python main.py

See python/ for available examples.

Java

cd java/<example>
mvn compile exec:java

See java/ for available examples.

On first run each example generates a wallet, requests tADA from the UVerify faucet, issues certificates, and prints a verification link to https://app.preprod.uverify.io.

Links

• UVerify App (preprod)
• Documentation
• API Reference
• Discord
• GitHub

Contributing

See CONTRIBUTING.md for guidelines. For security issues, see SECURITY.md.

License

MIT