sots-re/ghidra/addresses.d/README.md

18 lines
884 B
Markdown

# 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.