Cowrie Research

openattestation-primary-sources-2026-05-12

2 min read

OpenAttestation primary sources — 2026-05-12

Project status in this pass

  • OpenAttestation’s clearest accessible primary materials in this pass were the framework README and the companion document-store smart-contract README.
  • No standalone whitepaper surfaced through the accessible primary-source path used here.
  • The strongest signal is that OpenAttestation is a reusable lower-layer framework for verifiable documents, not just a single certificate product or verification website.

Primary-source snapshots

1) OpenAttestation framework README

  • URL: https://raw.githubusercontent.com/Open-Attestation/open-attestation/master/README.md
  • Key excerpts/signals:
    • Describes OpenAttestation as a framework of attestation and notary for any document types on the blockchain.
    • Says documents can be issued and verified either through smart contracts on Ethereum or through digital signatures without paying Ethereum transaction fees.
    • Explains that wrapDocuments computes a batch Merkle root, appends proofs to each document, and allows that root to be published onchain or signed by the issuer.
    • Includes signDocument, verifySignature, validateSchema, getData, and obfuscateDocument as first-class functions.
    • Notes an experimental schema direction compatible with the W3C Verifiable Credentials data model.
  • Why it mattered:
    • This source makes the core decomposition explicit: integrity proof, issuer identity/signing, publication path, and later verification are separate layers rather than one bundled app flow.

2) Document Store smart-contract README

  • URL: https://raw.githubusercontent.com/Open-Attestation/document-store/master/README.md
  • Key excerpts/signals:
    • Describes Document Store as smart contracts for managing issuance and revocation of documents for OpenAttestation.
    • Splits the system into a regular Document Store and a Transferable Document Store.
    • Says regular document stores support issuance and revocation, while transferable document stores make each document an ERC-721 NFT with optional soulbound behavior.
    • Exposes role separation through admin, issuer, and revoker permissions.
    • Supports batch issuance proofs for ordinary documents and single-document issuance for transferable records.
  • Why it mattered:
    • This source is the clearest proof that OpenAttestation is not just a file-format or signing library. It also includes an explicit issuance/revocation and transferability control plane.

Working conclusion

OpenAttestation is best cataloged as verifiable-document middleware that separates document integrity, issuer identity proof, publication path, revocation control, transferability, and disclosure policy. The decisive clue is not only the Merkle wrapping flow, but the fact that the project supports both smart-contract and signature-based issuance and then extends into ordinary versus transferable document stores as separate trust surfaces.

Graph View