Methodology & Synthetic Data Governance
AddressBench produces format-valid synthetic test specimens—never scraped personal data and never deliverable residential profiles.
1. Deterministic PRNG Architecture (FNV-1a + Mulberry32)
Every specimen generated on AddressBench—whether inside your browser or returned by GET /api/generate—is derived from a deterministic 32-bit FNV-1a hash seeded into a Mulberry32 PRNG namespaced with addressbench-v1. Passing the same seed, country, state, and phone mode produces byte-identical addresses and E.164 phone numbers across machines and CI runners.
2. Official Postal & Telecom Reference Standards
Address layouts, postal regexes, and leading-zero rules are audited against primary national specifications: USPS Publication 28 (United States), Japan Post (Japan), Chunghwa Post 3+3 (Taiwan), Royal Mail PAF (UK), Canada Post, Deutsche Post DIN 5008, La Poste AFNOR, Australia Post, SingPost, Hongkong Post, Korea Post, and Poste Italiane.
Each city is paired with its verified primary area code. In default Regulator Safe mode, numbers draw from official drama/test reservations where available: NANPA 555-0100 through 0199 (US/CA), Ofcom 07700 900xxx & 020 7946 0xxx (GB), ACMA 0491 570 xxx (AU), Arcep 06 39 98 xx xx (FR), and BNetzA 030 23125 xxx (DE), or zero-padded synthetic QA blocks elsewhere.
3. Non-Deliverability & Zero Real-PII Guarantee
AddressBench never scrapes residential databases, voter rolls, or real people. All personal names come from synthetic rosters, emails strictly use RFC 2606 reserved domains (example.com, example.org, example.net, specimen.example), and house numbers are synthesized. Specimens are NOT checked against USPS DPV and must never be used for physical mail or billing fraud.
4. Edge API Specification
Automated pipelines can fetch reproducible JSON or UTF-8 BOM CSV fixtures from /api/generate?country=US&taxFree=1&count=10&seed=ab-ci-01&format=json. Use format=csv&excelSafe=1 for human-opened spreadsheets or excelSafe=0 for strict machine CSV parsing.