mirror of https://github.com/jmcorgan/fips.git synced 2026-07-22 07:48:26 +00:00

Go to file

Johnathan Corgan 7d5d1adedc Redesign bloom filter parameters with mathematical justification

Analysis revealed original parameters (4KB, k=7) were oversized:
- Expected filter occupancy ~250-800 entries, not ~4,096
- Original FPR estimates in docs were incorrect (5-7x optimistic)
- d^(2K) formula overcounted by assuming mesh vs tree structure

New v1 parameters:
- Filter size: 1 KB (was 4 KB) - 75% bandwidth reduction
- Hash functions: k=5 (was 7) - optimal for 800-1600 entries
- K-hop scope: 2 (unchanged)

Added forward compatibility via size_class field:
- Power-of-2 sizes (512B, 1KB, 2KB, 4KB) enable folding
- v1 requires size_class=1; future versions can negotiate larger
- Receivers can fold larger filters down to preferred size

Updated docs:
- fips-routing.md: Part 1 rewritten with math foundation
- fips-gossip-protocol.md: §3 and Appendix A.2 wire format
- fips-architecture.md: Configuration parameters

2026-02-02 14:41:28 +00:00

docs

Redesign bloom filter parameters with mathematical justification

2026-02-02 14:41:28 +00:00

src

Session 48: Wire format design and logging improvements

2026-02-01 05:18:59 +00:00

.gitignore

Add identity module with NodeId, FipsAddress, and auth challenge

2026-01-24 23:57:48 +00:00

Cargo.lock

Session 46: Noise IK peer authentication implementation