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:

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

Registry Structure

The Validator Registry maintains the following information for each validator:

• Name: Human-readable identifier (e.g., "fabrica-us-validator")
• Address: Contract address on each supported blockchain
• Metadata: Additional information about the validator's capabilities
• Status: Active, deprecated, or pending status

Validator Resolution Process

When a property token needs to interact with its validator:

1. The token stores its validator's contract address (set via updateValidator)
2. An application reads that address and calls the registry's name(address) function
3. 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: