To register a hash value:
Step 1: An authenticated user or system with access to your PencilDATA organization would create a unique hash that represents the “thing” you wish to register. We call the “thing” you’re registering a digital entity. As a simple example, a university might create a hash that represents a students grade for a particular class when recording it to their academic database. An example hash looks like this:
Step 2: Call our REST API (“/register”) and pass in the hash for the digital entity you wish to register. Behind the scenes, we register your hash in a blockchain smart contract using our Patent Pending process. We return JSON with an entity ID that’s unique to your registration. All registration activity is logged in a full audit trail.
To verify a hash value:
Step 1: An authenticated user or system with access to your PencilDATA organization would generate a hash of the digital entity they want to verify. In our academic grade example, the transcript system could generate a hash of the grade(s) prior to creating the official transcript, ensuring that the grades hadn’t been altered in the database since they were recorded, ensuring accuracy of the transcript.
Step 2: Call our REST API, passing in both the unique entity ID and hash that you want to verify. Our system will trigger the blockchain smart contract, and if provenance is confirmed (meaning the hash passed in matches the hash that was originally registered), we will return true, otherwise the verification attempt will fail and provenance is not confirmed.