README
¶
bitcoin-shard-common
Shared protocol primitives for the BSV transaction sharding pipeline. Imported
by bitcoin-shard-proxy, bitcoin-shard-listener, bitcoin-retry-endpoint,
and bitcoin-subtx-generator.
Packages
| Package | Purpose |
|---|---|
frame |
Wire format codec: BRC-12/124/128 frames, BRC-127 announce, BRC-130 fragments, BRC-131 blocks, BRC-132 subtree data |
shard |
TxID → IPv6 multicast group derivation (consistent-hash); control groups |
seqhash |
XXH64 per-flow HashKey computation |
sequence |
Per-shard monotonic counters (sync/atomic, zero-alloc) |
Documentation
- Wire Protocol Specification — BRC-124/BRC-128 frame format, legacy BRC-12, shard derivation, proxy forward rules
Requirements
- Go 1.25 or later
Build
go build ./...
go test ./...
License
Apache 2.0 — see LICENSE.
Directories
¶
| Path | Synopsis |
|---|---|
|
BRC-135 block header frame encode/decode.
|
BRC-135 block header frame encode/decode. |
|
Package seqhash provides the hash function used to compute HashKey values in BRC-124/BRC-128 frames.
|
Package seqhash provides the hash function used to compute HashKey values in BRC-124/BRC-128 frames. |
|
Package sequence provides per-shard monotonic sequence counters.
|
Package sequence provides per-shard monotonic sequence counters. |
|
Package shard derives IPv6 multicast group addresses from BSV transaction IDs for deterministic packet-level sharding across the BSV sharding pipeline.
|
Package shard derives IPv6 multicast group addresses from BSV transaction IDs for deterministic packet-level sharding across the BSV sharding pipeline. |
Click to show internal directories.
Click to hide internal directories.