gitwtfhub

wtf is python-blkmaker?

luke-jr/python-blkmaker — explained in plain English

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

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

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

PythonBitcoin

How it stacks up

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 spin it up?

Difficulty · moderate Time to first run · 1h+

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

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane