# FAQ

## What does it mean to assign a domain?

In simple terms it means "let someone else use it for the time being". While you are holding your ownership of the domain entity, you can assign only the token to another account that would be able to use your domain in other applications (that use token ownership) until you assign it to another wallet.

## Why is Canonical Owner allowed to override token ownership with Token Assignments?

Domain Token is just one part of the domain entity in ZNS. Besides that domain data is scattered around ZNS based on it's usage and necessary availability. There is a million ways to use a domain created in ZNS, so the protocol needs to cover multiple use-cases with relative ease. Since we use address binding for ownership, access control and other things, we wanted to make domain management more configurable and less limiting. People use combinations of hot and cold wallets, Safe Accounts, smart contracts and other thing for their asset management, 3rd party apps need better ways of connecting and managing domains, communities need easy access to domain management and so on.

For this reason there is a Canonical Owner, which is the owner of the domain name/record/hash in `ZNSRegistry` and this data is used across the protocol to grant rights, discovery and ownership. Token should be viewed just as token - a utility tool that helps transfer domains easily, trade domains, get access to token gated chats, etc. Having the ability to assign a token to any of your wallets, like a hot wallet which you use often while you have your Canonical Owner being a Safe Account, for example, or give it to your friend to use inside a community or create multiple controlled subdomains for your company's employees and being able to revoke them as employees leave are all possible use-cases for this feature.

However, remember that properly transferring your domain token (not "assigning" through `ZNSRootRegistrar` contract WILL transfer your canonical ownership along with the token).

## What is an operator?

Operators are specific addresses that have been granted permission to modify a domain on its owner's behalf. This is done by adding addresses to the operator list for your account address in the `ZNSRegistry` contract. Domain owners can grant an operator access to their domains' records at any point in time. This is typically done to allow third-party applications or other users the ability to manage a domain for an owner without requiring that owner forfeit their domain's NFT.

It's important to note that operators are assigned at an owner level, not a domain level. This means that if the domain is transferred to a new owner, both the old owner and their operators will lose access to it.&#x20;

Many functions within ZNS use the `onlyOwnerOrOperator` guard to restrict who is able to call that function.

## What does it mean to revoke a domain?

Domain revocation entails forfeiting ownership of that domain and burning the associated NFT, rendering the domain available again for anyone to register.  Domains and subdomains that were registered via ZERO's stake-to-mint paradigm will be refunded their stake amount (but not associated fees and gas costs) in full. Subdomains that were purchased via direct, one-time payments will not have that payment refunded if revoked.&#x20;

Revocation of a parent domain with existing child subdomains will not impact those subdomains; once minted, subdomains are entirely emancipated from their parent domain.  It will not be possible to mint new child subdomains under a revoked domain, however, until the parent domain is re-minted.

## What is a domain hash?

A domain hash is a cryptographic hash function of that domain's full name. For example, the `wilder.world` domain has a name of `wilder.world`, but the label is specifically just `world`.&#x20;

For top level domains, or Worlds, there is no parent domain and so the domain hash is calculated as jus the hash of the label:

```solidity
bytes32 domainHash = keccak256(bytes(name));
```

For subdomains, the parent domain hash exists and so the domain hash is instead calculated as:

<pre class="language-solidity"><code class="lang-solidity"><strong>bytes32 domainHash = keccak256(abi.encodePacked(parentHash,keccak256(bytes(label))));
</strong></code></pre>

## What is a distribution configuration?

Distribution configurations specify three things:

* The type of payment this domain accepts (STAKE vs. DIRECT)&#x20;
* The accessibility of this domain to have subdomains minted (LOCKED, OPEN, or MINTLIST)
* The `ZNSPricer` contract to use for this domain
* The price config that is used to determine subdomain prices encoded as bytes

This configuration is given to the domain upon registration through either `registerRootDomain` or `registerSubdomain`

Read more in [Subdomain Distribution](/zns/subdomain-distribution.md)and [Base Distribution Configuration](/zns/subdomain-distribution/base-distribution-configuration.md).

## What is a payment configuration?

Payment configurations specify what ERC-20 token a domain accepts as payment for subdomains. It also specifies the recipient direct payments or stakes fees for subdomain registrations under that domain.

This configuration is given to the domain on registration through via `registerRootDomain`,  `registerSubdomain`, or through using the `setPaymentConfig` call.

Read more in [Base Distribution Configuration](/zns/subdomain-distribution/base-distribution-configuration.md)and [Payments](/zns/subdomain-distribution/payments.md).

## What is a price configuration?

Price configurations specify the necessary variables required by the `ZNSPricer` contract used by ZNS's registrar. Custom contracts can be used in this configuration; if this contract is one of the two pricing contracts ZERO has created, then the configuration specifies either a single price for each domain regardless of that domain label's length for `FixedPricer`. If the `CurvedPricer` contract is used, the base length, maximum length, curve multiplier, and maximum price of a domain are part of the config. The config then needs to be encoded into a bytes array to be able to be passed to ZNS contracts. More information is available on these values and what they mean in [Pricing](/zns/subdomain-distribution/pricing.md).&#x20;

Much of this configuration handled for the user when minting through ZERO's Explorer application.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zer0-1.gitbook.io/zns/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
