Blockcert Complete Project Step by Step


I am testing blockcerts and trying to make a test project for verifying certificates on bitcoin blockchain.

So far I have cloned certs-schema repository and found templates of JSON. Now I have installed Docker and stuck what to do.

I didn’t find step by step tutorial for developing a complete project. Can anyone give me a step by step guide.



Hello and welcome to the Blockcerts community! Check out these instructions and let us know if you have any questions:



Hi Kim ,

I have my test project setup and is running . Request you to please clarify on below point.

-> We never used cert-schema in this process ( ), i have read your article about cert-schema V2 also . So in future we will use cert-schema for verification process only . While Cert-tools will be used for template generation. Is my understanding correct ?



That’s correct, cert-schema is only needed by template creators for validating their templates, and cert-tools is used for generating templates.

cert-tools validates against cert-schema before writing the files, so you don’t have to run it separately.


Dear Kim,
Really appreciate your prompt response. I am trying to go ahead with ethereum blockchains for cetificates. I am finding difficulty in understanding the API Call. If you can help me in understanding the Cert-issuer module.


I’m not part of the blockcert team and I just had a quick look at the cert-issuer module. When you call cert-issuer it’ll run and you can trace the chain of the function run from there. The console command options are mostly (if not all) stored in Parts that need ‘Bitcoin’ usually have an import bitcoin or from bitcoin import * on top and these are generally the files you need to add support for Ethereum.

The current implementation is quite tied to Bitcoin so I think if we want to add support for Ethereum (and make it easier for other blockchains) we might need to abstract out some components. I hope that helps a bit :slight_smile: I’m sure Kim will have better answer when she has the time to reply. All the best!


Tasya is correct, and I realized also that the repo is currently missing some API documentation, which would be useful for consuming cert-issuer as a library (instead of a standalone script). I created an issue for that, and I’ll try to get around to that this week.


Hi folks,
Sorry for the late follow-up! I updated the main README in cert-issuer with a clearer description of the class design.




Can you help me to build my 1st ever blockchain application and I’m new to development environment.

To start with, I’m planning to follow cert-web-component/ to build it.

I’ve a query on the following step:
Add the element and specify the href attribute to the certificate you need to render.
blockchain-certificate href="./path/to/your/certificate.json"></blockchain-certificate

My query is whether we need to create certificate.json file?


Hi @Parameswaran,
There are a few example certificates in cert-web-component, but I’m wondering what you would like to do first. We generally recommend starting with cert-issuer, which has a quick start allowing you to issue a certificate on the blockchain.

I realize we need better general “getting started” instructions; the best we have now is this quick start. If anyone in the community would like to help with improving these instructions, I’d be eternally grateful. :slight_smile:


Hi @kim,

Appreciate your efforts in helping the community understand this process better. But it would be really helpful if someone could come up with a video tutorial on the complete setup. As, being a windows user, I’ve been sitting with the cert-issuer whole day and still not able to find the solution.

Thank you.


Hi , I am not able to get anything regarding the setting up. I am trying to setup the app on my local system which is running Windows 8. Some brief instructions on how to do that please.


Check out my tutorial for blockchain on Grails with whole setup and files for download. There is instructions for Windows setup as well (using chocolatey).