Repository navigation
v1.0.0
v1.0.0 is the first public release of qbit-explorer, a block explorer and mempool visualizer for qbit, based on mempool/mempool v3.3.1. These notes describe the qbit-specific delta from that upstream baseline.
Highlights
- qbit mainnet, testnet4 and regtest, with qbit address formats, P2MR scripts and post-quantum signatures.
- qbit's block rules: 2,000,000 weight-unit blocks with no witness discount, so a transaction's size, virtual size and weight are equal, and fees are in bits and bits/vB.
- Mining views for qbit's 60-second block target: every block shows whether it came from the permissionless or the AuxPoW lane, AuxPoW blocks are attributed to their parent-chain pools, and graph ranges are sized for qbit's block rate.
- qbit's standardness policy from genesis, with dust and sigops counted the way qbitd counts them.
- qbit.org's site header and footer, which operators can turn off.
qbit Behavior
- AuxPoW blocks show their parent work hash on the block page.
- Invalid addresses get a 400 response with the reason, for example
invalid qbit address HRP: expected tq, got bc, instead of a 500. GET /api/blocks/tip/heightanswers 503 until the backend finishes its first block sync.- The Rust block-template builder stays off (
MEMPOOL.RUST_GBT), because it still applies Bitcoin's witness scale factor. The backend projects the next blocks with its TypeScript implementation.
Operator Notes
- qbit-explorer needs an unpruned
qbitdwithtxindex=1and RPC enabled. qbit-electrs is optional and adds address pages (MEMPOOL.BACKEND=esplora). - No prebuilt images are published. docker/README.md shows how to build and run them.
QBIT_SITE_CHROME=falseremoves qbit.org's header and footer and stops the page from contacting qbit.org.- Upstream's paid, account and externally hosted services are off by default, and the Lightning explorer is removed.
- You may keep the Qbit name and logo on your own instance, but don't present it as an official Qbit service.
Known Issues
- The Block Fees, Block Fees Vs Subsidy and Block Rewards graphs are empty, because their queries need fiat price data, which qbit doesn't have.
- Search doesn't suggest addresses as you type:
/api/address-prefixanswers 500.
Validation
- CI builds and tests the backend and frontend in development and production modes, runs the backend integration tests against MariaDB, builds both Docker images and checks that the compose stack becomes healthy.
- CI also runs the backend and the browser tests against a qbit regtest stack of qbitd, qbit-electrs and MariaDB.
- The same code, apart from the version number and documentation, ran on both testnet4 origins before this release, with read-only checks of each host and an API comparison against the previous build.
Verifying
The v1.0.0 tag is signed. Check it in a fresh clone, not one that also tracks upstream mempool, whose tags use the same names:
git clone https://github.com/Qbit-Org/qbit-explorer.git
cd qbit-explorer
git verify-tag v1.0.0
git rev-parse 'v1.0.0^{commit}'The last command should print 382a1c447115dca212792a91ab6fdd9d01f689d4.