Skip to main content

For auditors, impact assessors and CSR committees

How ParamAI impact evidence is recorded and verified

Every sponsored programme on ParamAI keeps its own evidence ledger and can issue signed attestations of its figures. This page is the complete rule for both, so that anyone can check them independently. Updated 8 November 2026.

1. The evidence ledger

A ledger is a sequence of entries, one chain per programme, numbered from 1 with no gaps. Each entry’s hash is the SHA-256 (hex) of these nine values joined by a newline character, in this order:

PARAMAI-IMPACT-LEDGER-v1
partner_id
programme_id
seq
event_type
subject
occurred_at
payload
prev_hash
  • occurred_at is UTC with exactly six decimal places and a literal Z, e.g. 2026-11-08T07:57:07.123456Z.
  • payload is canonical JSON: object keys sorted, no spaces.
  • prev_hash is the previous entry’s hash; for entry 1 it is 64 zeros.
  • subject is a student pseudonym, or empty for programme-level events.

Because each hash covers the one before it, changing, removing, inserting or reordering any entry breaks every hash after it. Separately, the database refuses to update or delete a ledger entry or an attestation.

programme_createdThe programme was set up: name, Schedule VII item, SDG targets, financial year, target, states and dates.
funds_receivedA payment was recorded: amount in paise, bank reference, date received and the seats it bought per class band.
beneficiary_enrolledA student joined: class band, whether a funded seat was spent, and whether they already had the full report.
assessment_completion_observedAn enrolled student’s assessment was found complete. The time is when it was observed.
join_code_rotatedThe programme’s join code was replaced; the old one stopped working.
enrolment_toggledEnrolment was opened or closed.
attestation_issuedA signed attestation was issued: its code, the SHA-256 of the signed message and the key id.

2. How students are named

A student appears only as a pseudonym: S- followed by the first 16 hex characters of HMAC-SHA256 over impact-subject-v1:<programme_id>:<user_id>, keyed with a secret ParamAI holds. It is stable within a programme (so an auditor can count distinct students and match an enrolment to its completion) and different in every programme (so two sponsors comparing ledgers learn nothing about each other’s students).

No name, contact detail, school roll number, gender or result is ever written to the ledger. Dashboards and attestations show aggregates only; a group of fewer than ten students is combined with others, and the next-smallest group is folded in too so that no group can be recovered by subtraction.

3. Signed attestations

An attestation is a JSON statement — partner, programme, as-of time, metrics, and the sequence number and hash of the ledger’s latest entry — in canonical form. The signed message is:

PARAMAI-IMPACT-ATTESTATION-v1
<canonical statement JSON>

It is signed with ed25519. The public key is published at https://paramai.in/api/v1/impact/public-key, and each attestation names its key id (the first 16 hex characters of the SHA-256 of the public key). After issuing, the ledger records an attestation_issued entry containing the SHA-256 of the signed message, so the statement and the ledger are bound in both directions.

Every statement carries its own limits inside the signature: it is evidence of delivery (outputs), not an independent impact assessment under rule 8(3) of the Companies (CSR Policy) Rules, 2014, and partner registration numbers are as declared.

4. Verify it yourself

  1. Ask the programme for its evidence CSV (dashboard → Evidence → Download evidence CSV).
  2. Download the verification script (Python 3, standard library only) and run python3 verify_impact_ledger.py evidence.csv.
  3. It prints INTACT with the head hash, or the first entry that fails and why.
  4. Open the attestation’s verification link (or scan its QR code) and compare its ledger head with the entry of that number in the CSV. A match means the figures were stated over exactly that record.

Running or funding a programme? See what a sponsored programme includes and what it costs.

ParamAI for CSR & NGOs