Fully ENS-compatible, the Resolver contract supports multiple record types, reverse resolution, and metadata customization. It follows the standard ENS interface structure but is tightly integrated with the dotHYPE Registry to enforce domain status and expiration.

This contract does not handle ownership—it simply reflects what the Registry allows, and enables you to associate rich identity data with your name.

🔍 What It Does

The Resolver supports:

• Address resolution (EVM and multi-chain)

• Text records (socials, avatar, website, etc.)

• Content hash linking (IPFS, Swarm)

• Reverse resolution (address → name)

• Record versioning and batch updates

If your name is expired or inactive, all resolution queries return blank results. The Resolver only returns records for active .hype names.

🔗 Address Resolution

You can link your .hype name to wallet addresses using either:

• A simple EVM address (default Ethereum-style resolution)

• A multi-coin address using SLIP-0044 standards

function addr(bytes32 node) external view returns (address);
function addr(bytes32 node, uint256 coinType) external view returns (bytes memory);

Set via:

function setAddr(bytes32 node, address addr) external;
function setAddr(bytes32 node, uint256 coinType, bytes calldata addr) external;

If no address is set, most systems default to the current domain owner.

📝 Text Records

Text records allow you to embed human-readable metadata into your .hype name.

Common uses include:

• Socials: com.twitter, com.github

• Profile: avatar, description

• Contact: email, url, website

function text(bytes32 node, string calldata key) external view returns (string memory);
function setText(bytes32 node, string calldata key, string calldata value) external;

Text records power UI display, social graphing, and indexing.

🧬 Content Hash

Use a .hype name to link to decentralized content like:

• IPFS files or websites

• Swarm hashes

• Other content-addressed systems

function contenthash(bytes32 node) external view returns (bytes memory);
function setContenthash(bytes32 node, bytes calldata hash) external;

This is ideal for user profiles, dApp frontends, or media hubs.

🔄 Versioning System

Rather than deleting records one by one, dotHYPE enables full record resets via versioning.

function recordVersions(bytes32 node) external view returns (uint256);
function clearRecords(bytes32 node) external;

Each record is linked to a version counter:

• clearRecords() bumps the version

• All previous records become invalid

Useful for refreshing a stale or incorrect profile in one transaction.

🔁 Reverse Resolution

Reverse records map wallet addresses back to .hype names. This is what makes UIs (wallets, explorers, dApps) show your name instead of a 0x address.

Key functions:

function setReverseRecord(string calldata name) external returns (bytes32);
function clearReverseRecord() external;
function reverseLookup(address addr) external view returns (string memory);
function getName(address addr) external view returns (string memory);

You can also:

• Query a text record via reverse: getValue(address, key)

• Check if an address has a reverse record: hasRecord(address)

🚫 Domain Expiration Enforcement

The Resolver enforces expiration checks. If a domain is expired:

• All resolution returns are blank

• Records cannot be set or updated

function isAuthorized(bytes32 node) internal view returns (bool);

This ensures that only active .hype names can display metadata or resolve onchain.

🧩 Multi-call Support

To keep things gas-efficient, the resolver supports batch operations:

• Set multiple records in a single call

• Commonly used when updating profiles or migrating data

This feature inherits from the Multicallable interface standard.

🔐 Access & Authorization

Only the current name owner can set or update records.

• Ownership is checked against the Registry

• If your name is expired, you temporarily lose write access

All write functions include internal isAuthorized() checks.

📡 Interface Discovery

Applications can check whether this resolver supports a given record type using:

function supportsInterface(bytes4 interfaceID) public view override returns (bool);

dotHYPE Resolver supports:

• IAddrResolver

• IAddressResolver

• ITextResolver

• IContentHashResolver

• IReverseResolver

This ensures compatibility with ENS-resolving dApps and multi-chain interfaces.

🧠 For Developers

If you're building with .hype names:

• Use addr() to resolve to a wallet or contract

• Use text() to display social or profile metadata

• Use reverseLookup() to show names for addresses

The Resolver does not store ownership—it’s a read/write utility that enhances what the Registry tracks.

All domain registrations and renewals are routed through the controller; it’s the decision-making contract that sits between users and the registry.

This is where pricing, access rules, signature verification, and allowlist enforcement live.

🔍 What It Does

The Controller handles:

• Enforcing registration pricing (based on name length and duration)

• Processing payments in $HYPE (based on USD-pegged prices)

• Verifying signed requests to prevent front-running (via EIP-712)

• Checking Merkle proofs for allowlisted mints

• Managing name reservations (for pre-approved addresses)

Think of it as the programmable access layer for the dotHYPE registry.

💸 Pricing Model

dotHYPE uses a simple but powerful pricing structure:

• Price is based on name length (e.g., 3-char names cost more than 5+)

• All prices are denominated in USD

• Payment is made in $HYPE, converted using an onchain oracle

• Registration and renewal are priced separately

Example (public mint):

• 3 characters: $100/year

• 4 characters: $40/year

• 5+ characters: $15/year

Pricing can be updated over time by the protocol owner, but logic is hardcoded for length-based tiers.

To fetch the price:

function getPrice(string calldata name, uint256 duration) public view returns (uint256);

✍️ Signature-Based Registration

Most mints use EIP-712 structured data to ensure fair access. This prevents bots from front-running open registrations.

function registerWithSignature(...) external payable returns (uint256);

This flow:

1. Verifies a signed message from an authorized backend signer

2. Confirms the nonce hasn't been used

3. Calculates price and duration

4. Registers the name through the Registry

Signatures are used in public mint, premium auction, and certain reserved phases.

🌿 Merkle-Based Allowlists

For whitelist and partner-only phases, we use Merkle trees to verify whether a user can register a name:

function registerWithMerkleProof(...) external payable returns (uint256);

Each address on the allowlist can register one name. Proofs are verified onchain. The Merkle root is updated periodically by the owner.

🪪 Reserved Name Access

Some names are explicitly reserved for specific addresses—partners, integrations, or founders.

function registerReservedName(...) external payable returns (uint256);

Only the address that a name is reserved for can register it. No one else can front-run or bypass this.

Admin can assign or remove reservations:

function reserveName(...) external onlyOwner;
function removeReservation(...) external onlyOwner;

🔁 Renewal

Renewals are permissionless. Anyone can renew any name by paying the correct amount.

function renew(string calldata name, uint256 duration) external payable returns (uint256);

• Duration is in seconds

• Pricing uses the renewal tier (not the first-year price)

🔐 Payment Handling

The Controller:

• Calculates price in $USD

• Converts it to $HYPE using a live price oracle

• Verifies the user paid enough

• Refunds any overpayment

• Sends funds to the treasury or designated recipient

All payments are native token compatible—no need for approval flows.

🛠 Admin Functions

The Controller can be configured by the protocol owner (via multisig):

setAnnualPrice()
setAnnualRenewalPrice()
setRegistry()
setSigner()
setPaymentRecipient()
setPriceOracle()

These functions adjust pricing, set key addresses, and manage access without changing the contract itself.

📡 Events for Tracking

Events emitted for downstream analytics:

• DomainRegistered

• DomainRenewed

• ReservedNameRegistered

• MerkleProofRegistration

• SignerUpdated, PaymentRecipientUpdated, PriceOracleUpdated

These can be tracked via Subgraph or block explorer for indexers and dashboards.

🔎 For Developers

If you’re building a dApp or CLI for minting:

• Use getPrice() to fetch cost before submitting

• Use registerWithSignature() for standard public minting

• Use registerWithMerkleProof() for allowlisted flows

You don’t need to interact with the Registry directly—the Controller routes all writes.

Want to mint for users via backend signature? Check our SDK guide or integration examples.

To see how a registered name becomes usable across dApps, dashboards, and wallets, continue to the Resolver Contract →

Every .hype name is an NFT—minted and stored using this registry. It’s compliant with ERC-721, but also includes extensions to manage lifecycle events like renewal, expiration, and status tracking in a way that fits naming infrastructure.

This page explains how the registry works and what matters for developers or curious users.

📘 What It Does

The Registry contract is responsible for:

• Minting .hype names as NFTs

• Assigning expiration timestamps

• Enforcing availability logic (e.g. what counts as expired)

• Preventing transfers of expired names

• Handling metadata for display

All minting and renewing must come through the Controller contract, which acts as a gatekeeper. That ensures pricing and access logic can be upgraded independently.

You can think of the Registry as the final source of truth for who owns what and for how long.

⏳ Expiration & Renewal Rules

Each name is registered for a fixed period, starting from the time of mint. Once that period ends, the name enters a 30-day grace period. During this window:

• The owner can still renew the name

• But it can’t be transferred or sold

After the grace period ends:

• The name becomes available to others

• It can be re-registered by anyone

To ensure meaningful durations, all registrations must last at least 28 days.

🔐 Availability Logic

A name is considered available if:

• It has never been registered

• OR its expiration + grace period has passed

This logic ensures names can’t be accidentally or maliciously re-claimed too early. Builders can use the available() function to check status.

function available(string calldata name) external view returns (bool);

🔁 Minting & Renewal Process (Simplified)

Names are minted and renewed through the Controller. The Registry handles the actual recording.

When a name is registered:

1. A token ID is created using the namehash algorithm

2. An expiration time is assigned

3. An NFT is minted to the user

When renewed:

• The expiration is extended based on the original expiry (not the current time)

• If the name is expired but within the grace period, it can still be renewed

function register(string calldata name, address owner, uint256 duration) external onlyController returns (uint256 expiresAt);
function renew(string calldata name, uint256 duration) external onlyController returns (uint256 expiresAt);

🧠 Token ID Generation

Each .hype name is converted into a token ID using a standard namehash algorithm—similar to ENS. This ensures uniqueness and predictability.

function nameToTokenId(string calldata name) public pure returns (uint256);

The algorithm:

• Hashes the domain label using keccak256

• Combines it with a root .hype identifier

• Outputs a 256-bit integer as the token ID

This process ensures all names are deterministically derived and collision-resistant.

🖼 Metadata & Status Queries

Each name has a metadata URI, which can be customized using an external metadata provider. This lets you:

• Display profile cards, avatars, or status in apps

• Serve dynamic visuals for first 1K mints or milestone names

The Registry also exposes read-only status functions:

function expiresAt(uint256 tokenId) external view returns (uint256);
function expiry(string calldata name) external view returns (uint256);
function isExpired(uint256 tokenId) external view returns (bool);

🚫 Transfer Restrictions

Expired names (outside the grace period) cannot be transferred. This is enforced at the contract level no UI trickery.

The Registry overrides the _update() function to block transfers of expired tokens unless they are first renewed.

This protects users and prevents accidental loss of names post-expiration.

🛠 Admin Controls

Some functions are reserved for the protocol owner or multisig governance:

function setController(address _controller) external onlyOwner;
function setMetadataProvider(address _metadataProvider) external onlyOwner;

These allow future upgrades or metadata format changes without touching the core Registry logic.

🔎 For Developers

If you’re building an integration and want to:

• Check if a name is expired

• Query expiration time

• Display metadata or avatars

...the Registry is your go-to source.

It’s not where minting logic lives—that happens in the Controller. But it’s where final ownership, expiration, and display logic is confirmed.

See the Controller Contract → to understand how minting works upstream.

Still have questions? Reach out in our dev community →

Mainnet

🌐 Network Information

• Current Network: HyperEVM Mainnet

• Chain ID: 999

• Block Explorer: HyperEVM Scan

🧾 Protocol Information

• Protocol Name: DotHYPE

• Top-Level Domain: .hype

• Total Contracts: 4 of 4 configured

Testnet

🌐 Network Information

• Current Network: Hyperliquid Testnet

• Chain ID: 998

• Block Explorer: HyperEVM Scan

🧾 Protocol Information

• Protocol Name: DotHYPE

• Top-Level Domain: .hype

• Total Contracts: 4 of 4 configured