Blockchain Compendium — Filter & Quality Criteria

Filtro "Para o Kode" + critérios de qualidade do topic blockchain. Consumido por /k-compendium blockchain durante Passos 3 e 2.

Estrutura do compendium blockchain

compendium/blockchain/
├── INDEX.md
├── 01-timeline.md                ← Hashcash 1997 → Bitcoin 2008 → presente
├── 02-fundamentos.md             ← ledger, immutability, Byzantine generals, CAP, finality, MEV
├── 03-consensus.md               ← PoW, PoS, BFT, DAG, PoH, PoSpace
├── 04-l1-bitcoin.md              ← Bitcoin: BIPs, SegWit, Taproot, Lightning, Stacks, ordinals
├── 05-l1-ethereum.md             ← Ethereum: EVM, EIPs, Merge, blobs, MEV, account abstraction
├── 06-l1-alt.md                  ← Solana, Avalanche, Cardano, Polkadot, Cosmos, Sui, Aptos, TON
├── 07-l2-scaling.md              ← rollups (optimistic + zk), state channels, sidechains, modular thesis
├── 08-smart-contracts.md         ← Solidity, Vyper, Move, CairoVM, RISC Zero, formal verification
├── 09-defi.md                    ← AMMs, lending, derivatives, stablecoins, RWA, restaking
├── 10-nft-gamefi-rwa.md          ← NFTs, gaming, real-world assets, DePIN
├── 11-bridges-interop.md         ← cross-chain bridges, IBC, restaking, intent-based
├── 12-tokenomics.md              ← token types, vesting, MEV, governance (DAOs)
├── 13-regulacao.md               ← BR (Lei 14.478, CVM, BCB Drex), UE (MiCA), US (SEC), demais
├── 14-incidentes.md              ← Mt. Gox, DAO, Ronin, FTX, Terra, Wormhole, Nomad, exploits DeFi
└── 15-koder-aplicada.md          ← posicionamento Koder Stack (hoje: sem blockchain)

Critérios de qualidade por seção

Para EIPs/BIPs (04-l1-bitcoin, 05-l1-ethereum, 07-l2-scaling)

Uma proposta merece entrada se:

• Status Final ou Last Call OU
• Ativada via softfork/hardfork em mainnet OU
• Adotada por L2 com TVL > $100M OU
• Define padrão usado por > 2 implementações

Para L1s (06-l1-alt)

Um L1 merece entrada se atender ≥ 2:

• TVL > $500M sustentado por > 6 meses OU
• Inovação consensual única (não fork de algoritmo existente) OU
• Adoção institucional documentada (corporates, governos) OU
• Active dev community (> 100 commits/mês) e mainnet > 12 meses

Para L2s (07-l2-scaling)

Um L2 merece entrada se:

• Mainnet com TVL > $100M OU
• Suporte oficial de L1 host (rollup framework canônico) OU
• Inovação técnica única (proof system, DA layer, sequencer model)

Para DeFi protocols (09-defi)

Protocolo merece entrada se:

• TVL > $500M sustentado por > 3 meses OU
• Categoria nova (primeiro AMM, primeiro perp, primeiro restaking, etc.) OU
• Audit clean por firm major + > 12 meses live sem hack

Para regulação (13-regulacao)

Mudança regulatória merece entrada se:

• Lei/regulação publicada (não draft) em jurisdição relevante OU
• Enforcement action major (> $10M ou empresa Tier-1) OU
• Mudança de classification de token específico OU
• Marco brasileiro (BCB, CVM, RFB)

Para incidentes (14-incidentes)

Incidente merece entrada se:

• Perda > $50M OU
• Afetou > 100K usuários OU
• Quebrou exchangeprotocolbridge major OU
• Demonstrou vulnerabilidade nova de classe (não variação de exploit conhecido)

Filtro para o Kode

Importante: a Koder Stack não tem componentes blockchain hoje (decisão arquitetural — ver memory [Blockchain compendium]). O filtro abaixo é monitoring + opportunity-spotting — capturar sinais de quando vale revisitar essa decisão, sem inventar usos forçados.

Priorizar informações que respondem a:

1. Há payment rail viável sem custódia (Brasil)? → Lightning, Drex direct, USDC corporate — só revisitar se atingir UX comparable a PIX
2. Há identity standard que ameaça o Koder ID? → DIDs, Verifiable Credentials, Soulbound Tokens — capturar se virar de-facto em algum vertical Koder atende
3. Há audit/proof rail útil pra Koder Signer ou Koder Trace? → cripto-anchored receipts, OCSP-on-chain, transparency logs (Sigstore, Certificate Transparency)
4. Há ferramenta de programação descentralizada que ameaça o Koder Flow? → Radicle, Gitcoin Passport, on-chain CI/CD
5. Drex muda alguma coisa? → CBDC brasileira em produção pode mudar disponibilidade de PIX-substitute pra rails da Vivver/Crescer
6. Regulação BR muda compliance? → Lei 14.478, CVM 175, BCB resoluções — tracking por rebatimento na Vivver e produtos Koder de gestão financeira
7. Tokenização de RWA toca clientes Koder? → CIMMG, prefeituras, CrescerVivver podem precisar receberemitir tokens RWA — capturar quando virar mainstream BR
8. Auditoria off-chain (Koder Trace) tem competidor on-chain? → eventos imutáveis blockchain-baseados — comparar custoUX vs `servicesai/trace`
9. Stack precisa interagir com cliente que opera on-chain? → integração read-only (índice/oracle) é o ponto de entrada mais provável
10. Sinal de quando virar blockchain-aware: TVL no setor brasileiro > $X, adoção corporativa > Y%, marco regulatório claro — definir thresholds em 15-koder-aplicada.md

Regras de escrita por arquivo

O que SEMPRE incluir:

• Whitepaper: título + autor(es) + ano + link arxivIPFSsite oficial
• EIP/BIP: número + título + eips.ethereum.org/EIPS/eip-NNNN ou github.com/bitcoin/bips
• Auditoria: empresa (Trail of Bits, OpenZeppelin, Spearbit, Quantstamp, ConsenSys Diligence) + data
• CVE / SWC: swcregistry.io pra SWC
• Hack/exploit: data + valor em USD + transação on-chain quando público
• Datas exatas de mainnet launch, hard forks, exploits, propostas final
• Marketcap / TVL com data (nunca afirmar valor sem data — envelhece em dias)
• Token symbol entre parênteses na primeira menção: Ethereum (ETH), Solana (SOL)
• Status atual: live, deprecated, defunct, dormant, mainnet, testnet

O que NUNCA fazer:

• Tratar marketcap/preço como verdade permanente sem data
• Confundir L1 (chain própria) com L2 (settle em outra chain)
• Confundir custodial vs non-custodial wallets
• Misturar permissioned (Hyperledger) com permissionless (público)
• Atribuir invenção de "blockchain" a Satoshi (estrutura existia em Haber-Stornetta 1991)
• Capturar drama de Twitter / influencer sem documento oficial corroborando
• Endossar projeto sem audit clean ou track record > 12 meses

Notação (já em INDEX.md):