didname CLI

A CLI tool for batch retrieving and updating domain nameservers, supporting multiple DNS providers.

Installation

Global Installation

npm install -g @blocklet/didnames

Usage

List Domains

# Using globally installed CLI
didnames list-domains

# Using locally installed CLI
npx didnames list-domains

# Specify provider
didnames list-domains --provider route53

Update Domain Nameservers

# Update nameservers for a single domain
didnames update-nameservers --provider route53 --domains example.com --nameservers ns1.example.com ns2.example.com

# Update nameservers for multiple domains
didnames update-nameservers --provider route53 --domains example.com test.com --nameservers ns1.example.com ns2.example.com

Options

• --provider <provider>: Specify DNS provider, currently supports route53 (default)
• --domains <domains...>: List of domains to update
• --nameservers <nameservers...>: List of nameservers to set

Integration with Domain Hosting Feature

1. Run list-domains command to get the domain list
2. Copy the output domain list (one domain per line)
3. Select "Import from AWS Route53" on the domain hosting page
4. Paste the copied domain list into the input box

Environment Variables

AWS Route53

• AWS_ACCESS_KEY_ID: AWS Access Key ID
• AWS_SECRET_ACCESS_KEY: AWS Secret Access Key
• AWS_REGION: AWS Region (default: us-east-1)

Debugging

Set the environment variable DEBUG=didnames:* to view detailed debug information:

DEBUG=didnames:* didnames list-domains

Required AWS Permissions

To use didname CLI with AWS Route53 Domains, your AWS account must have the following permissions:

• List domains: route53domains:ListDomains
• Change nameserver: route53domains:UpdateDomainNameservers

Minimal policy example:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["route53domains:ListDomains", "route53domains:UpdateDomainNameservers"],
      "Resource": "*"
    }
  ]
}

Supported Providers

• route53: AWS Route53 (default)