[BUG]: P2P sync downloads full 500-block chunks without headers-first validation
Los mantenedores suelen responder en 1 día
@anshulchikhale30-p ya está trabajando en esto.
Desde el 8/11/2026.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- python
Línea de trabajo
Start with main.py handlers request_chain, chain_request, and chain_response, then read minichain/p2p.py and minichain/chain.py to understand current sync and validation. Run the existing test suite and inspect its sync coverage before planning the new tests named in the issue. Done means header-first sync, bounded and rate-limited body requests, peer handling for invalid data, and the stated acceptance criteria are implemented and documented in docs/sync.md.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Bug Description
MiniChain's P2P sync downloads up to 500 full blocks per request and has no headers-first phase or block locator. When a peer's tip is ahead, main.py calls request_chain(network, chain.last_block.index + 1, 500); on a fork it requests up to 50 blocks backward. This works for small local chains but is inefficient and unsafe at scale.
Current behavior:
request_chainbroadcasts achain_requestwithstart_indexandlimit=500.chain_requestserveschain.chain[start_index:start_index+limit]and sends every full block (header + transactions + receipts).chain_responseparses all received blocks into memory and applies them one by one.- There is no
getheaders/headersphase and no block locator, so an invalid chain is only discovered after downloading entire bodies. chain_requestacceptsstart_indexandlimitwithout bounds; a peer can request a very large range or send a very large response.- There is no request ID/response correlation, no maximum response size, and no per-peer sync rate limit.
p2p.pycoverage is 37% (README), so these paths are under-tested.
Impact:
- Slow sync and high memory use on long chains.
- Wasted bandwidth and CPU on invalid or adversarial chains.
- DoS vector via oversized requests/responses or request floods.
- Repeated 50-block backward scans on forks.
- Multi-node research at 10k+ blocks is impractical.
Expected behavior:
- Sync headers first with a locator, validate the header chain (PoW, target, timestamp, parent linkage, cumulative work), then download bodies in bounded batches.
- Bound request/response sizes, add request IDs, unicast to one peer, and rate-limit per peer.
- Disconnect or ban peers that send invalid or oversized data.
Proposed fix:
- Add
getheaderswith a locator (recent block hashes),stop_hash, andmax(e.g. 2000), plus aheadersresponse. - Validate headers before bodies: PoW, target, timestamp, parent linkage, cumulative work.
- Add
getblockby hash or bounded range; fetch bodies in small batches (e.g. 64 blocks) with a maximum number of in-flight requests. - Verify transaction root, receipt root, and state root after executing the bodies.
- Add request IDs, unicast requests to one peer, and deduplicate responses.
- Cap
start_index,limit, and response bytes; add a per-peer token bucket. - Feed invalid or oversized responses into the existing validation counters and ban repeat offenders.
- Add tests for 10k-block sync, 100-block reorg, invalid headers, invalid bodies, oversized requests/responses, restart mid-sync, and rate limiting.
- Document the protocol and limits in
docs/sync.md.
Acceptance criteria:
- 10k-block sync completes within an agreed target and bounded memory.
- Headers are validated before bodies are downloaded.
- Fork detection uses a locator, not repeated 50-block scans.
- Requests and responses are bounded and rate-limited.
- Invalid or oversized peers are disconnected or banned.
- No unbounded queues or response buffers.
-
p2p.pycoverage is at least 65%. - Sync protocol and limits are documented.
Relevant files:
main.py(request_chain,chain_request,chain_response)minichain/p2p.pyminichain/chain.pytests/test_sync.py(new)tests/test_p2p_limits.py(new)
References:
- Bitcoin P2P network guide: https://developer.bitcoin.org/devguide/p2p_network.html
- Bitcoin protocol documentation: https://en.bitcoin.it/wiki/Protocol_documentation
- BIP 152 compact block relay (optional future work): https://github.com/bitcoin/bips/blob/master/bip-0152.mediawiki
Steps to Reproduce
- Start two nodes on different ports with separate data directories.
- Let one node mine more than 500 blocks.
- Connect the second node to the first node.
- Observe the
hellohandler requestchain_requestwithlimit=500, followed by full-blockchain_responsepayloads. - For the adversarial case, send a
chain_requestwith a very largelimit, or send achain_responsecontaining a very large list of blocks, and observe memory/CPU use.
Logs and Screenshots
Relevant log lines include:
?? Peer ... is ahead (...) . Initiating chunked sync...
?? Peer requested blocks from ... (limit 500).
No screenshots available.
Environment Details
- OS: Windows 11 / Linux
- Python 3.10+
- MiniChain
mainbranch as of 2026-11-08 p2p.pycoverage: 37% (README coverage report)
Impact
High - Major feature is broken (sync works for small chains, but is not safe or efficient at scale).
Code of Conduct
- I have joined the Discord server and will post updates there
- I have searched existing issues to avoid duplicates
- Lenguaje dominante
- Python
- Estrellas
- 12
- Forks
- 27
- Merge medio
- 2 min
- PR fusionados (30 d)
- 1
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de StabilityNexus/MiniChain
-
[BUG]: Handle JSON-RPC notifications and empty batches correctlyPosiblemente ocupada @Muneerali199 la tomó hace 10 días. Abiertobug
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
StabilityNexus/MiniChain#177 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
automatic-copyright-year: keep README copyright currentPosiblemente ocupada @anshulchikhale30-p la tomó hace 7 días. Abiertodocumentation enhancement
Dificultad 3/5 Medio día Aptitud para principiantes 35/100
StabilityNexus/MiniChain#189 ·
Los mantenedores suelen responder en 1 día
-
Difficulty: bound per-block EMA moves, add a difficulty floor, and preserve state across restartsPosiblemente ocupada @anshulchikhale30-p la tomó hace 7 días. Abiertobug documentation enhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 25/100
StabilityNexus/MiniChain#187 ·
Los mantenedores suelen responder en 1 día
-
[BUG]: Blocks on a different parent are classified INVALID and get the sender bannedPosiblemente ocupada @kansalakshat la tomó hace 7 días. Abiertobug
Dificultad 2/5 1-3 horas Aptitud para principiantes 35/100
StabilityNexus/MiniChain#185 ·
Los mantenedores suelen responder en 1 día
-
[FEATURE]: Add transaction and receipt lookup RPC methodsPosiblemente ocupada @Thushara3005 la tomó hace 10 días. Abiertoenhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 58/100
StabilityNexus/MiniChain#176 ·
Los mantenedores suelen responder en 1 día
Todos los issues de StabilityNexus/MiniChain
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
huggingface/datasets#9128 ·
Los mantenedores suelen responder en 1 día
-
priority:low ready-for-dev
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
OpenHands/extensions#975 ·
Los mantenedores suelen responder en 1 día
-
Function/dict state handlers can't supply provider-state injected values (`generate.provider_state`)Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
pact-foundation/pact-python#1789 ·
Los mantenedores suelen responder en 9 días
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
juandresrodca/AdminForge#66 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día