Validator Registry

The Validator Registry is a core component of the Fabrica ecosystem that maps each validator's contract address to a human-readable name, so applications can display a token's validator by name instead of a raw address.

Name Resolution

A property token stores its validator as a contract address. The registry resolves that address to a human-readable name via its name(address) function, providing several benefits:

Improved Readability: Applications can show a validator's name rather than its cryptographic address
Stable Display: The onchain validator name travels with the token as a trait, resolved from the address
Cross-Chain Compatibility: The registry on each chain resolves that chain's validator addresses to names

Registry Structure

The registry contract (FabricaValidatorRegistry) stores one thing per validator: a mapping from the validator's contract address to its name (e.g., "fabrica-us-validator"). It exposes:

Function	Who can call it	What it does
`name(address)`	anyone	Returns the name registered for a validator address (empty if none)
`addName(address, string)`	registry owner	Registers a name for an address
`updateName(address, string)`	registry owner	Changes a registered name
`removeName(address)`	registry owner	Removes a registered name

The registry is for display only. It does not decide which validator a token relies on: each token stores its own validator address, changed through the token contract's updateValidator by an account holding at least 70% of the token's supply.

Validator Resolution Process

When a property token needs to interact with its validator:

The token stores its validator's contract address (set via updateValidator)
An application reads that address and calls the registry's name(address) function
The registry returns the validator's human-readable name, which the token also exposes as an onchain trait

Supported Validators

The registry currently includes the following validators:

Name	Description	Supported Networks
fabrica-us-validator	Primary validator for US properties	Ethereum Mainnet, Sepolia, Base Sepolia