Logistics

• GTIN/EAN/UPC validation and generation (GS1 mod 10)
• Global Location Number (GLN) validation and generation
• Serial Shipping Container Code (SSCC) validation and generation
• Vehicle Identification Number (VIN) validation
• ISO 6346 container code validation
• Air Waybill (AWB) validation and generation
• IMO ship identification number validation and generation

Telecom

• IMEI validation and generation
• MEID validation and generation
• ICCID validation and generation
• MAC address validation and generation
• OUI validation and generation
• ASN validation and generation
• IPv4 structural validation
• IPv6 structural validation

Education & Media

• ISBN-10 validation and generation
• ISBN-13 validation and generation
• ISSN validation and generation
• DOI structural validation
• ISNI validation and generation
• ISMN validation and generation
• ISRC structural validation

Healthcare

• NHS Number validation and generation
• ORCID validation and generation

Additional identifiers and algorithms will be added per the PRD.

Example usage

// Validate an IBAN
Finance.Iban.TryValidate("FR14 2004 1010 0505 0001 3M02 606", out var iban);
Console.WriteLine(iban.IsValid);            // True
Console.WriteLine(iban.Value!.Value);       // FR1420041010050500013M02606

// Generate a GTIN-13
foreach (var s in Bulk.GenerateMany((dst, rng) => {
    var ok = Logistics.Gtin.TryGenerate(13, new GenerationOptions { Seed = rng.Next() }, dst, out var w);
    return (ok, w);
}, count: 3, seed: 42))
{
    Console.WriteLine(s);
}

// Validate a telecom identifier
Telecom.Imei.TryValidate("490154203237518", out var imei);
Console.WriteLine(imei.IsValid);            // True

Project structure

src/Veritas/          core library organised by domain
  Core/              shared primitives and algorithms
  Finance/           financial identifiers
  Tax/               national and regional tax identifiers
  Energy/            electricity and gas identifiers
  Identity/          software and personal identifiers
  Logistics/         supply chain identifiers
  Healthcare/        health identifiers
  Telecom/           network and telecom identifiers
  Education/         research and publishing identifiers
  Media/             media identifiers

test/Veritas.Tests/   xUnit test suite

Adding new identifiers

1. Add a new static class <IdName> in the appropriate domain with TryValidate and, when safe, TryGenerate methods.
2. Include a value type <IdName>Value containing the normalized representation.
3. Add unit tests under test/Veritas.Tests verifying valid and invalid cases.
4. Update the PRD and this README with the new identifier and its capabilities.
5. Run dotnet test -f net8.0 and ensure all tests pass.

Contributing

Contributions are welcome! Fork the repository, create a topic branch, and open a pull request:

1. Describe the motivation and design in the PR description.
2. Ensure tests and formatting checks pass.
3. The maintainers will review and merge when ready.

Continuous integration via GitHub Actions restores dependencies, builds, and runs the test suite on every push and pull request. Packages are produced by the publish workflow and releases are drafted automatically.