verifyProof

Validate a database proof

Definition

The verifyProof command validates a proof by recalculating the root hash and comparing that to the hash found in the Chainpoint receipt and validating receipt on the blockchain.

The verifyProof command has the following form:

JavaScript

{
    "verifyProof"  : <string>
    "format" : <string>
}

The command accepts the following fields:

Field	Type	Mandatory	Description
verifyProof	string	yes	The id of the proof to validate.
format	string	no	Values can be: "json" (default) - proof in JSON text format "binary" - proof in binary format

Output

The returned document contains a subset of the following fields:

Field	Type	Description
ok	number	The status of the command.
version	number	The version when it was proved.
dateTime	date	The date and time the proof happened.
hash	string	The proof hash.
proofId	string	The proof Id.
proofStatus	string	The proof status: pending, valid, invalid, submitted, failed, purged.
btcTransaction	string	The BTC transaction id.
btcBlockNumber	string	The BTC block number.
proof	document, binary	The proof.

Example

Below we query the _provendb_versionProofs collection to find the most recent proof, then run verifyProof to verify that proof

JavaScript

// Find most recent proof
mongo> db.
... ...   getCollection('_provendb_versionProofs').
... ...   find({ status: 'valid' }, { proofId: 1, version: 1 }).
... ...   sort({ version: -1 }).
... ...   limit(1).pretty();
{
	"_id" : ObjectId("5c9433eb41d82814ca398110"),
	"proofId" : "076f78a0-4c3e-11e9-a4bd-01e33ea1e3b0",
	"version" : NumberLong(10883428)
}
// Verify that proof
mongo> db.runCommand({verifyProof:'076f78a0-4c3e-11e9-a4bd-01e33ea1e3b0',
                                          format:'binary'})
{
	"ok" : 1,
	"version" : NumberLong(10883428),
	"dateTime" : ISODate("2019-03-25T22:00:28.899Z"),
	"hash" : "3c4eacc774a1d38f5f24b5d5152b108bfb5bc516824ba73cc5f19db894c60a98",
	"proofId" : "076f78a0-4c3e-11e9-a4bd-01e33ea1e3b0",
	"proofStatus" : "Valid",
	"btcTransaction" : "4582f2a2852dc615523f3960d9c007e53e64ecbc8e7a8e3f8ddef0d90d02de29",
	"btcBlockNumber" : "568217",
	"proof" : BinData(0,"eJyVl89uZUcRxuEleAKWeNzVXd1d5dVISKxYsspmVH+6GUuDPbKdEJaBDdsseADIQEKUDRJiyXsM4mH4jseZML5GClfjO/a5p+t0V33fr+r+/qvncX11tz69++fLu7vXtxfn579ul/ns+uaX5/HSLq9eX19e3Z1/0t7c/eb1+vqn7y+9eWm3L98+b8HLIuZko2yy+67sPTv16lTEt3ePTkNw2WaL6Js0XZRjFFP55gjz4jJfXF3nevvjMsee  .... ==")
}

### execution ended```