PNS Troubleshooting Guide

This guide helps you resolve common issues you might encounter while using the Polkadot Naming Service (PNS).

Common Issues

Transaction Failures

If you're experiencing transaction failures, try the following:

1. Check Gas Fees

   • Ensure you have enough WND tokens for gas

   • Verify the gas price is appropriate for the network

   • Consider increasing gas limit if needed

2. Network Connection

   • Verify you're connected to the correct network (Westend Asset Hub testnet)

   • Check your internet connection

   • Try refreshing the page

3. Wallet Balance

   • Ensure you have sufficient WND tokens

   • Check for any pending transactions

   • Verify your wallet is properly connected

Name Registration Issues

If you're having trouble registering a name:

1. Name Availability

   • Verify the name isn't already taken

   • Check if the name follows the allowed format

   • Ensure you're using valid characters

2. Name Format

   • Use only Latin alphabet letters (A-Z, a-z)

   • Numbers (0-9) are allowed

   • No spaces or special characters

   • Only approved suffixes (.dot, .jam) are allowed

3. Registration Process

   • Ensure you have enough WND tokens

   • Check if your wallet is properly connected

   • Verify you're on the correct network

Resolution Problems

If you're having trouble resolving names:

1. Name Verification

   • Double-check the spelling of the name

   • Verify the name exists in the system

   • Check if the name has expired

2. Resolver Settings

   • Verify the resolver is properly configured

   • Check if records are set correctly

   • Ensure the resolver is active

3. Network Issues

   • Confirm you're on the correct network

   • Check network status for any outages

   • Verify your connection is stable

Security Concerns

Common Scams

1. Phishing Attempts

   • Be cautious of fake PNS websites

   • Always verify website URLs

   • Never share your private keys

   • Use official PNS links only

2. Fake Support

   • Official support will never ask for private keys

   • Use only official support channels

   • Verify support staff identity

   • Be wary of unsolicited support messages

Getting Help

Support Channels

1. Documentation

   • Check the PNS documentation
   • Review this troubleshooting guide

   • Search for similar issues

2. Community Support

   • Join the Discord community
   • Check GitHub discussions
   • Ask questions in the community forums

3. Technical Support

   • Submit issues on GitHub
   • Contact the support team

   • Check the status page for any ongoing outages

Best Practices

1. Security

   • Keep your private keys secure

   • Use hardware wallets for large holdings

   • Enable 2FA where available

   • Regularly check your account activity

2. Transaction Management

   • Always verify transaction details

   • Double-check recipient addresses

   • Review gas fees before confirming

   • Keep track of your transactions

3. Regular Maintenance

   • Monitor name expiration dates

   • Update records when needed

   • Keep resolver information current

   • Regularly check for updates