HostDec Logo
HostDec
Decentralized Hosting
...
🇺🇸  English
🇦🇷  Español
Domains Browser Docs Whitepaper Token Community ↗ Open DApp
Frequently Asked Questions · FAQ

Everything you need
to know

Get answers about NFT domains, IPFS, the HDEC token and the desktop app. If you can't find your answer, write to us in the community.

NFT Domains 📁 IPFS HDEC Token 🖥 Desktop App
Categories
💡 General
Basic concepts about HostDec and how the protocol works.
H
What is HostDec?

HostDec is a decentralized domain protocol based on NFTs on the Arbitrum One network. It combines three layers: a smart contract on Arbitrum that registers domains as ERC-721 NFTs, a DApp at hostdec.com to manage everything, and IPFS to store your site's content.

The core idea is simple: your .hostdec domain is an NFT you own, and your site lives on IPFS. No one can take it away or censor it.

🔒
Why is it better than a traditional domain?

Traditional domains are rented annually from centralized registrars that can suspend them, transfer them, or not renew them. With HostDec:

✔ You pay once and the domain is yours forever.
✔ The domain lives on the blockchain — no middlemen.
✔ No one can cancel or censor it.
✔ It's a transferable NFT: you can sell it or give it away.

Why Arbitrum and not Ethereum mainnet?

Arbitrum is a Layer 2 network on top of Ethereum. This means it inherits Ethereum's security but with minimal fees (sometimes cents) and confirmations in seconds.

Registering a domain on Ethereum mainnet would cost tens of dollars in gas. On Arbitrum One (Chain ID: 42161), the cost is negligible.

🛠
What do I need to get started?

To register a domain you need three things:

1. MetaMask (or another compatible wallet) configured on Arbitrum One.
2. HDEC tokens to pay for the registration (the price varies by domain length).
3. A little ETH on Arbitrum to pay the gas for transactions (minimal amount).

Tip: You can acquire ETH on Arbitrum from any exchange and bridge from Ethereum mainnet using Arbitrum's official bridge.
🌍
Can I view my .hostdec site from any browser?

Yes, but as a subdomain of HostDec. With the Browser, .hostdec domains are resolved natively without extensions or additional configuration.

🌐 Domains
Everything about registering, naming and managing .hostdec domains.
✏️
What characters can I use in my domain?

Domain names must follow these rules:

✔ Letters a-z (lowercase)
✔ Numbers 0-9
✔ Hyphens - in the middle
Cannot start or end with a hyphen
✖ Minimum 3 characters

💰
How much does it cost to register a domain?

The price varies according to the length of the name, measured in HDEC tokens:

LengthExamplePriceRarity
3 charactersbtc.hostdec10,000 HDECPremium
4 charactersdefi.hostdec1,000 HDECRare
5–6 characterspablo.hostdec500 HDECStandard
7+ charactersmyblog.hostdec100 HDECCommon
Remember: This is a one-time payment. No annual fees or renewal charges.
🔍
How do I know if a domain is available?

From the DApp you can type the domain name you want to register. The system will automatically check whether that name is already in use or still available.

If the name is free, you'll be able to register it directly from the application.

You can also check the domain status in the Arbitrum blockchain explorer.

📋
What are the steps to register a domain?

Step 1 — Search the name: Type the domain name you want in the DApp and the system verifies whether it's available.

Step 2 — Confirm payment: If the domain is free, confirm the operation from your wallet.

Step 3 — Blockchain registration: Once the transaction is confirmed, the domain is registered in your name.

Done! The domain is yours and you can use it to point to your website or decentralized content.

♾️
Does the domain ever expire?

No. Domains are perpetual NFTs. Once you register one, it's yours as long as you hold the NFT in your wallet. There are no renewals, fees or expiry dates.

You can only lose it if you transfer or sell the NFT to someone else.

🔄
Can I change the content of my domain after registering it?

Yes. Once you register your domain, you can update your website's content whenever you want from the DApp.

This allows you to modify or improve your page over time without losing your domain.

📦 IPFS & Content
How to upload your site to IPFS and link it to your domain.
What is a CID?

A CID (Content Identifier) is a cryptographically generated identifier based on the content. In IPFS, every file or folder has a unique CID.

A key property: if the content changes, the CID changes. This guarantees that when you visit a CID, you always get exactly that content. Example CID: QmXyz123... or bafy....

☁️
How do I upload my site to IPFS?

The recommended services are Pinata (pinata.cloud) or Web3.Storage. Both have free plans and allow you to upload entire folders.

The process is: create an account → upload your folder with the site files → copy the root directory CID → paste it into the HostDec DApp.

Important: It is recommended to use pinning so that the content is permanently available. Without pinning, IPFS nodes may remove the content over time.
🔗
What is the difference between Web CID and Metadata CID?

The contract manages two types of CID per domain:

Web CID (getCIDWeb): This is the CID of the published site. It is served when someone browses to yourdomain.hostdec. It can be updated at any time without restrictions.

Metadata CID (getCurrentCID): This is the CID of the NFT metadata. It uses a circular buffer that stores version history. It has a cooldown before it can be updated.

📜
Can I view the version history of my domain?

Yes. The system stores a history of the changes you make to your domain's content.

This way you can review previous versions and see how your site has evolved over time.

🪙 HDEC Token
Everything about the HDEC token and how to use it in the protocol.
🪙
What is the HDEC token used for?

The HDEC token is the currency of the HostDec protocol. It is used to pay for domain registrations. Each domain has a price in HDEC based on its length.

It is the mechanism that gives value to the ecosystem and distributes costs proportionally: shorter (and more valuable) domains cost more HDEC.

Why do I have to approve the contract before registering?

This is a standard ERC-20 security mechanism. For the HostDec contract to transfer your HDEC, you must first grant it permission (allowance) by executing the approve(CONTRACT_ADDRESS, price) function.

The DApp does this automatically before executing registerDomain(). You only need to confirm the approval transaction in MetaMask.

💱
How much HDEC do I need to register my first domain?

It depends on the length of the name you want:

— Domain of 7+ letters: 100 HDEC (most accessible price)
— Domain of 5–6 letters: 500 HDEC
— Domain of 4 letters: 1,000 HDEC
— Domain of 3 letters: 10,000 HDEC

You also need a small amount of ETH on Arbitrum to cover gas.

📊
Can HDEC prices change?

Prices are defined in the smart contract. Any change to the prices would require updating the contract, which implies full transparency: any change would be visible on-chain.

The DApp shows current prices in real time by querying the contract directly.

🔍
Where can I verify the token contract?

You can verify the main HostDec contract on Arbiscan. The contract address is:

0x45d1021512d607b0a81425f2547d6279a7ea5987

The source code is verified and public, so you can audit exactly how the pricing and registration logic works.

⛓ Smart Contract
Technical details of the HostDec smart contract.
📍
What is the contract address?

The HostDec contract is deployed on Arbitrum One (Chain ID: 42161) at the following address:

0x349d141cfe8fffb17443fcc1671bf75fe4db6e14

It follows the ERC-721 standard. The source code is verified on Arbiscan and publicly accessible.

📖
What are the main functions of the contract?

Read functions (READ):
getCIDWeb(tokenId) — CID of the website.
getCurrentCID(tokenId) — Current CID of the metadata.
getRecentHistory(tokenId) — Circular buffer history.
hasCIDWeb(tokenId) — Whether the domain has content.

Write functions (WRITE):
setCIDWeb(tokenId, cid) — Links a CID to the domain.
updateMetadata(tokenId, cid) — Updates metadata (with cooldown).
registerDomain(name) — Registers a new domain.

📡
What events does the contract emit?

The contract emits two main events:

DomainRegistered(owner, name, tokenId, price, timestamp) — Emitted every time a new domain is registered.

CIDWebUpdated(tokenId, cid, updatedBy, timestamp) — Emitted every time the web CID of a domain is updated.

You can listen to these events in real time to integrate HostDec with other applications.

What is the UpdateTooSoon error?

The UpdateTooSoon error occurs when you try to call updateMetadata() before the required cooldown period has passed.

Solution: Wait for the cooldown time indicated before trying to update the metadata again.
🖥 Desktop App
How to install and use the app to browse .hostdec domains.
🖥
What exactly does the desktop app do?

The desktop application lets you access and browse .hostdec domains directly from your computer, similar to how you use any web browser.

You can download and run it from the official website or from the GitHub repository. Once launched, the application automatically resolves .hostdec domains and displays their content in your browser.

💻
What operating systems does the app support?

Currently the desktop application is available for Windows.

Versions for macOS and Linux are under development and will be available soon.

You can download the application from the Browser section at hostdec.com or from the official GitHub repository.

⚙️
How does the app resolve a domain's content?

When you navigate to yourdomain.hostdec, the app executes this logic:

1. Extracts the keyword from the domain.
2. Calls contract.getTokenId(keyword) to get the tokenId.
3. Calls contract.getCIDWeb(tokenId) to get the CID.
4. Serves the content from https://ipfs.io/ipfs/{cid}/{subpath}.

All of this happens in milliseconds, transparently for the user.

💱 Marketplace
Buying, selling and transferring NFT domains.
🏪
How does the Marketplace work?

The HostDec Marketplace is built on the OpenSea Seaport protocol, ensuring compatibility with the entire NFT ecosystem.

As a domain owner you can list your domain at any ETH price you choose. Anyone can buy it by paying in ETH and receiving the NFT in their wallet. You can also cancel the listing at any time.

💸
What currency are domains bought and sold in?

Marketplace transactions are carried out in ETH (on the Arbitrum One network). The DApp shows the conversion price in USD in real time so you can reference the value.

Remember: the initial domain registration is paid in HDEC, but secondary buying/selling on the Marketplace is done in ETH.

🔄
What happens to the domain content when I sell it?

When you transfer the NFT, the new owner receives full control of the domain. This includes the ability to update the web CID and metadata.

The previous content on IPFS is not automatically deleted (IPFS is permanent as long as it is pinned), but the new owner can link a new CID and change what is served on the domain.

Remember: Transferring the NFT = transferring the domain. Make sure to agree on terms with the buyer before listing.

Still have
questions?

Join the HostDec community on Discord or Telegram. Our team and the community can help you with any inquiry.