[BUG]: P2P sync downloads full 500-block chunks without headers-first validation
Mantenedores costumam responder em até 1 dia
@anshulchikhale30-p já está trabalhando nisso.
Desde 8/11/2026.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 25/100
- Tipo de issue
- Funcionalidade
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- python
- Domínio
- distributed-systems, networking
Direção de pesquisa
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.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Python
- Estrelas
- 12
- Forks
- 27
- Merge médio
- 2min
- PRs com merge (30d)
- 1
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de StabilityNexus/MiniChain
-
[BUG]: Handle JSON-RPC notifications and empty batches correctlyTalvez já em andamento @Muneerali199 assumiu há 10 dias. Abertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
StabilityNexus/MiniChain#177 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
automatic-copyright-year: keep README copyright currentTalvez já em andamento @anshulchikhale30-p assumiu há 7 dias. Abertadocumentation enhancement
Dificuldade 3/5 Meio dia Facilidade para iniciantes 35/100
StabilityNexus/MiniChain#189 ·
Mantenedores costumam responder em até 1 dia
-
Difficulty: bound per-block EMA moves, add a difficulty floor, and preserve state across restartsTalvez já em andamento @anshulchikhale30-p assumiu há 7 dias. Abertabug documentation enhancement
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 25/100
StabilityNexus/MiniChain#187 ·
Mantenedores costumam responder em até 1 dia
-
[BUG]: Blocks on a different parent are classified INVALID and get the sender bannedTalvez já em andamento @kansalakshat assumiu há 7 dias. Abertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 35/100
StabilityNexus/MiniChain#185 ·
Mantenedores costumam responder em até 1 dia
-
[FEATURE]: Add transaction and receipt lookup RPC methodsTalvez já em andamento @Thushara3005 assumiu há 10 dias. Abertaenhancement
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 58/100
StabilityNexus/MiniChain#176 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de StabilityNexus/MiniChain
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
huggingface/datasets#9128 ·
Mantenedores costumam responder em até 1 dia
-
priority:low ready-for-dev
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
OpenHands/extensions#975 ·
Mantenedores costumam responder em até 1 dia
-
Function/dict state handlers can't supply provider-state injected values (`generate.provider_state`)Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
pact-foundation/pact-python#1789 ·
Mantenedores costumam responder em até 9 dias
-
documentation
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
juandresrodca/AdminForge#66 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
Mantenedores costumam responder em até 1 dia