Develop a blueprint
Introduction
This article is the pathway for developers on their journey to develop blueprints with the Python v3.11 blueprint SDK.
info
For now, you must develop your blueprint using Python 3.11. Support for other Python versions and additional programming languages may be added in the future.
Understand
Before you start developing your blueprints, you need to understand nano contracts. See:
- Everything about nano contracts: for those not familiar with this feature.
- Nano contracts — how it works: to understand how smart contracts work on Hathor.
Implement
- Blueprint SDK — guidelines: to consult the constraints that your blueprint code must follow.
- Blueprint SDK — API: to consult the names from package
hathor.nanocontractsthat can be imported in your blueprint module. - Get started with blueprint SDK — part 1: hands-on tutorial to assist developers to conceive and design their first blueprint.
- Get started with blueprint SDK — part 2: hands-on tutorial to assist developers to implement and test their first blueprint.
Test
At the time of writing (August 9, 2025), the blueprint SDK is embedded in Hathor core. As a result, to test your blueprint, you need to install Hathor Core.
Then, for all the testing tooling provided by the SDK, see Blueprint SDK — tests.
Deploy
- Nano contracts with headless wallet: for how to deploy your blueprint on the ledger (blockchain).
- Public networks: to connect to the correct public instance of Hathor network.
Examples
Blueprint 'Bet' is provided as a complete example (source code, tests, and documentation):
- Bet — blueprint module: source code of blueprint 'Bet'.
- Bet — unit tests: unit tests for blueprint 'Bet'.
- Bet — documentation: to understand how this blueprint works, and how to document blueprints.