📖
Pulse Domains
  • 👋Introduction
  • đŸŸĸRegistration FAQ
  • 📒Terminology
  • Guides
    • đŸĒ„Domain Registration
    • đŸ§â€â™€ī¸Updating Your Profile
    • đŸĨˇPreserving Your Privacy
    • đŸ‘ĨCreating Subdomains
    • đŸ›Šī¸Domain Transfer
    • 🤝DNS Domain Setup
    • 🍭Brand Guidelines
    • 💸Referrals
    • 📜Whitelist & Claims
    • 🌟Registration Widget
    • đŸĒ…CCIP & PNS
    • đŸĒ…Name Renewal
  • Deep Dives
    • đŸŦName Wrapper
      • đŸ”ĨFuses
      • âŗExpiry
      • ✅Approved Operators
    • 👨‍🔧Managing a Name
    • 🔤Homoglyphs
  • pls.fyi Profile
    • ✨Your Web3 Profile
  • PLS.TO dWeb
    • đŸĒInterPlanetary FileSystem (IPFS)
    • 🌐Your Decentralized Website
    • đŸ’ģIPFS & PLS.TO Guide
  • Partner Sites
    • 📈PulseCoinList.com
    • 💱PulseSwap.io: The Aggregator of Aggregators
      • 📈 Integration for Developers and Projects
  • Dapp Developer Guide
    • đŸ› ī¸Getting Started
      • PNS Enabling your DApp
      • PNS Libraries
      • Working with PNS
      • Resolving Names
      • Managing Names
      • Registering & Renewing Names
      • PNS Front-End Design Guidelines
      • PNS as NFT
      • PNS Data guide
    • 🐛Bug Bounty Program & Audit
  • âš™ī¸Contract Api Reference
    • 📜Deployed Contracts
    • Name Processing
    • Registry
    • ReverseRegistrar
    • TestRegistrar
    • PublicResolver
    • .pls Permanent Registrar
      • Registrar
      • Controller
    • DNS Registrar
    • Name Wrapper
      • Expiry
      • Fuses
      • Wrapped States
    • Subgraph
      • Entities
      • Queries
  • 📙Contract Developer Guide
    • Resolving Names On-chain
    • Writing a Resolver
    • Writing a Registrar
  • đŸĻ¸â€â™‚ī¸Community
    • Community Dev Resources
  • Links
    • đŸ•šī¸PNS App
    • đŸĻTwitter
    • âœˆī¸Telegram
    • 💡PNS Name Ideas (Community Site)
Powered by GitBook
On this page
  • What Are Fuses in PNS?
  • Types of Fuses in PNS
  • Understanding Emancipated and Locked States
  • Hierarchical Nature of Fuses
  • DNS Domains and Fuses
  • Key Takeaways

Was this helpful?

  1. Deep Dives
  2. Name Wrapper

Fuses

PreviousName WrapperNextExpiry

Last updated 1 year ago

Was this helpful?

What Are Fuses in PNS?

Fuses in PNS are like digital settings for your .pls domain names. They allow you to grant or revoke certain permissions or features. Once a fuse is "burned" (activated), it can't be reversed until the domain's expiry date.

Types of Fuses in PNS

Parent-Controlled Fuses

Set by the owner of the main .pls domain, these fuses determine the capabilities and restrictions of subdomains.

  • PARENT_CANNOT_CONTROL: Allows the main domain owner to grant independence to a subdomain. Once activated, the main domain can no longer modify or delete the subdomain.

  • IS_DOT_ETH: This is an internal setting for when a .pls second-level domain is wrapped. It's not user-controlled.

  • CAN_EXTEND_EXPIRY: Enables the subdomain owner to extend their domain's expiry date independently.

  • Custom Fuses: There are 13 additional parent-controlled fuses that can be customized for various purposes.

Owner-Controlled Fuses

These can be set by either the subdomain owner or the main domain owner, acting as permissions that can be revoked.

  • CANNOT_UNWRAP: Locks the domain, preventing it from being converted back to a non-NFT state. This is a prerequisite for burning other owner-controlled fuses.

  • CANNOT_BURN_FUSES: Freezes the current state of fuses, preventing any further changes.

  • CANNOT_TRANSFER: Stops the domain from being transferred to another owner.

  • CANNOT_SET_RESOLVER: Disables updates to the resolver contract for the domain.

  • CANNOT_SET_TTL: Prevents changes to the domain's Time To Live (TTL) setting.

  • CANNOT_CREATE_SUBDOMAIN: Prohibits the creation of new subdomains.

  • CANNOT_APPROVE: Restricts updates to the approved "subname renewal manager" for the domain.

  • Custom Fuses: There are 9 more owner-controlled fuses available for custom use.

Understanding Emancipated and Locked States

  • Emancipated State: A subdomain enters this state when it gains independence, typically after the PARENT_CANNOT_CONTROL fuse is burned. In this state, the main domain can't alter the subdomain until it expires.

  • Locked State: A domain in this state cannot be unwrapped, ensuring the stability and security of its settings and subdomains.

Hierarchical Nature of Fuses

  • Fuses operate in a hierarchical manner. For example, to burn owner-controlled fuses, the domain must be in a locked state.

  • To lock a domain (burn the CANNOT_UNWRAP fuse), the parent domain must have burned the PARENT_CANNOT_CONTROL fuse.

DNS Domains and Fuses

  • Currently, the fuse system is mainly for .pls domains. DNS domain owners can technically use fuses, but their control is ultimately governed by the DNS network and not fully within PNS.

Key Takeaways

  • Fuses offer sophisticated management of your .pls domain names, allowing for a wide range of permissions and features.

  • They provide a means to customize your .pls domains, enhancing their functionality and security.

  • Understanding the hierarchical nature and the specific functions of each fuse can greatly enhance your experience with PNS.

đŸŦ
đŸ”Ĩ
Parent-Controlled Fuses
Owner-Controlled Fuses