explaingit

luke-jr/python-blkmaker

Analysis updated 2026-07-17 · repo last pushed 2021-11-28

★ 29PythonAudience · developerComplexity · 3/5DormantSetup · moderate

TLDR

A Python library that lets Bitcoin miners request and manage block templates from a Bitcoin node, handling the strict timing rules around when a miner may update a block's timestamp.

Mindmap

mindmap
  root((repo))
    What it does
      Requests block templates
      Python port of libblkmaker
    Key Rules
      mintime and maxtime
      Timestamp rolling limits
    Usage
      Talks to Bitcoin node
      See example.py
    Audience
      Mining pool operators
      Custom miner developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build custom Bitcoin mining software that requests fresh block templates from a node.

USE CASE 2

Implement a mining pool backend that correctly enforces block template timing rules.

USE CASE 3

Learn how the getblocktemplate protocol's mintime/maxtime constraints work by studying a working Python implementation.

What is it built with?

PythonBitcoin

How does it compare?

luke-jr/python-blkmakeradityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Last pushed2021-11-28——
MaintenanceDormant——
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencedevelopervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a running Bitcoin node to connect to and strict adherence to block-template timing rules.

Copy-paste prompts

Prompt 1
Using python-blkmaker, show me how to request a block template from a Bitcoin node and check when it's safe to roll the timestamp.
Prompt 2
Explain the mintime and maxtime rules enforced by python-blkmaker and what happens if a miner ignores them.
Prompt 3
Walk me through the example.py in python-blkmaker and adapt it into a minimal custom mining client.
Prompt 4
How do I use python-blkmaker to determine exactly when my current block template expires?

Frequently asked questions

What is python-blkmaker?

A Python library that lets Bitcoin miners request and manage block templates from a Bitcoin node, handling the strict timing rules around when a miner may update a block's timestamp.

What language is python-blkmaker written in?

Mainly Python. The stack also includes Python, Bitcoin.

Is python-blkmaker actively maintained?

Dormant — no commits in 2+ years (last push 2021-11-28).

How hard is python-blkmaker to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is python-blkmaker for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos