An open-source TypeScript SDK for integrating with Zimbabwe's ZIMRA Fiscalisation Data Management System (FDMS), handling device registration, mTLS, receipt signing, hash chain, QR generation, and offline queueing.

Stars

8

7-day growth

No data

Forks

2

Open issues

1

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the hardest, recurring integration problems for Zimbabwean POS software (certificate lifecycle, stateful fiscal-day cycle, hash chains, canonical signing) in a verified, open-source library, eliminating per-receipt middleware costs.

Who it is for

  • Zimbabwean POS/accounting software developers
  • Zimbabwean businesses building in-house fiscalization solutions
  • Systems integrators handling ZIMRA compliance for multiple clients
  • Developers maintaining or migrating existing FDMS integrations

Use cases

  • Integrating receipt signing and hash-chain validation into a POS system
  • Building an offline sales queue that syncs within the 72-hour grace window
  • Automating device registration and certificate renewal with mTLS
  • Generating compliant fiscal-day close reports and verification QR codes

Strengths

  • Verified live against ZIMRA's FDMS test environment for core operations
  • Handles tricky details like ASN.1 DER signatures and canonical signing strings out of the box
  • Minimal runtime dependencies (only one, for CSR generation) and zero‑dependency HTTP transport
  • Includes regression tests that pin critical behaviors like signing strings and counter accumulation

Considerations

  • Requires Node.js 18+ and a single runtime dependency (@peculiar/x509)
  • State (hash chain, counters) must be manually persisted and restored across restarts
  • Assumes familiarity with ZIMRA FDMS concepts and test portal workflows

README quick start

Quick start

Description

TypeScript SDK for ZIMRA FDMS fiscalisation — direct device registration, mTLS, receipt signing, fiscal days, offline queue, QR codes

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191