# Per-lane address fragments

`addresses.json` is a single shared file. When several lanes run concurrently they edit the
same lines, and three times on 2026-09-08 one lane's `git add` swept another's in-flight
entries into the wrong commit. Nothing was lost, but authorship and atomicity were.

A lane may instead drop its own file here:

```json
{ "entries": [ { "name": "...", "addr": "0x...", "convention": "...",
                 "prototype": "...", "status": "verified", "source": "findings/..." } ] }
```

Name it after the lane (`lane-d.json`). `tools/gen_addresses.py` merges every fragment in
sorted order after `addresses.json`. A **duplicate name across files is a hard error**, not
last-wins — two lanes disagreeing about an address is exactly the thing we must not paper over.

The integrator folds fragments back into `addresses.json` once the lane's work is merged.