🥷
Namespace
AppDev Portal
  • [ Introduction ]
    • ENS
    • Namespace
  • Official Links
  • Apps
    • Overview
    • Onchain Subnames (App)
      • Search & Register
      • Wizard
        • Listing an ENS Name
        • Features List
      • ENS Widget
      • Farcaster Frames
        • Default Frame
        • Custom Frame
    • Offchain Subnames (DevApp)
      • Subnames
      • Resolver set
      • API keys
  • How-to Guides and Demos
  • Dev Docs
    • SDK
      • Offchain Manager
        • Installation
        • Generate API key
        • Create or Update Subname
        • DeleteSubname
        • IsSubnameAvailable
        • GetFilteredSubnames
        • AddressRecords
          • ChainName
        • TextRecords
        • DataRecords
      • Indexer Manager
        • Installation
        • Fetch L2 Subnames
        • Fetch L2 Registries
      • Mint Manager
        • Installation
        • GetMintDetails
        • GetMintTransactionParameters
        • IsSubnameAvailable
        • How To Mint L1 & L2 subname via mint-manager
      • Namespace Client (deprecated)
        • Installation
        • GetListedName
        • GetMintDetails
        • GetMintTransactionParameters
        • IsSubnameAvailable
        • GenerateAuthToken
    • APIs
      • Offchain Manager
      • Mint Manager
    • Infrastructure
      • Namespace L2 Subnames
    • Subpages
  • Ecosystem
    • Use Cases
  • Jobs
    • 📌We’re Hiring 👇
    • 🧑‍💻 Full-Stack Dev
    • 🥷 DevRel Lead
    • 💼 BD Lead
    • 🐣 Intern (dev role)
Powered by GitBook
On this page
  1. Dev Docs
  2. APIs

Mint Manager

PreviousOffchain ManagerNextInfrastructure

Last updated 27 days ago

Mint Manager – Service that provides signed parameters required to interact with L1 and L2 minting contracts for subname creation.

  • POSTGenerate mint parameters and return a signed payload
  • GETGet estimated minting parameters and validation results

Get estimated minting parameters and validation results

get
Query parameters
parentNamestring · min: 3 · max: 100Required

The parent name (e.g., domain) under which the label will be minted.

Example: example.eth
labelstring · min: 1 · max: 100Required

The label or subname to be minted under the parent name.

Example: subname
minterAddressstringRequired

Ethereum address of the minter.

Example: 0x1234567890abcdef1234567890abcdef12345678
isTestnetbooleanOptional

Indicates whether the operation is on a sepolia testnet.

Example: true
Responses
200
Estimated price, fee, and validation status for requested subname.
application/json
get
GET /api/v1/mint/estimate?parentName=example.eth&label=subname&minterAddress=0x1234567890abcdef1234567890abcdef12345678 HTTP/1.1
Host: 
Accept: */*
200

Estimated price, fee, and validation status for requested subname.

{
  "canMint": true,
  "estimatedPriceEth": 0.01,
  "estimatedFeeEth": 0.002,
  "isStandardFee": true,
  "validationErrors": [
    "SUBNAME_TAKEN",
    "MINTER_NOT_WHITELISTED"
  ]
}

Generate mint parameters and return a signed payload

post
Body
labelstring · min: 1 · max: 255Required

Label or subname to mint (e.g., "satoshi"). Must be 1-255 characters.

Example: satoshi
parentNamestring · min: 1 · max: 255Required

Parent ENS name under which the label is being minted (e.g., "universe.eth").

Example: universe.eth
expiryInYearsnumberOptional

Optional number of years the subname will be valid for. Used for expirable names. Defaults to 1 if not provided

Example: 1
minterAddressstringRequired

Ethereum address of the minter.

Example: 0x1234567890abcdef1234567890abcdef12345678
isTestnetbooleanOptional

Whether the operation is being performed on a testnet.

Example: true
ownerobjectOptional

Optional custom owner address of the subname (if different from minter).

Example: 0xabcdefabcdefabcdefabcdefabcdefabcdefabcd
Responses
200
Signed mint parameters ready to be used on-chain.
application/json
post
POST /api/v1/mint HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 196

{
  "label": "satoshi",
  "parentName": "universe.eth",
  "expiryInYears": 1,
  "minterAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "isTestnet": true,
  "owner": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
}
200

Signed mint parameters ready to be used on-chain.

{
  "content": {
    "label": "satoshi",
    "owner": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "fee": "0.002",
    "price": "0.01",
    "parentNode": "0xabc123abc123abc123abc123abc123abc123abc123abc123abc123abc123abc1",
    "paymentReceiver": "0x1234567890abcdef1234567890abcdef12345678",
    "verifiedMinter": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
    "signatureExpiry": 1726425612,
    "expiry": 4294967295,
    "fuses": 65536
  },
  "signature": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1b"
}