basename-register

Register .base.eth basenames and assign primary names for wallet addresses.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/0xAxiom/axiom-public --skill basename-register
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: basename-register
Source: https://github.com/0xAxiom/axiom-public/tree/main/agent-tools/skills/basename-register
Command: npx skills add https://github.com/0xAxiom/axiom-public --skill basename-register

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires viem, and includes scripts (resource) components.

What problem does it solve?

This Skill enables AI agents to have stable, human-readable identities on Base by registering .base.eth basenames, simplifying wallet recognition and branding across services.

Core Features & Use Cases

  • Check availability: Verify whether a .base.eth name is available for a wallet address.
  • Registration & primaries: Register the name to a wallet and set as primary to map an address to a friendly name.
  • Use Case: Example: register axiombotx.base.eth for an agent wallet to enable easy signing and identity across apps and ecosystems.

Quick Start

Register a basename for your wallet by running:

export NET_PRIVATE_KEY=0x...

node scripts/register-basename.mjs myname

Frequently Asked Questions about basename-register

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register a .base.eth basename for my wallet?

Register a .base.eth basename by setting your private key as an environment variable and running the registration script with your desired name. The script checks availability, handles pricing, and assigns the name as your wallet's primary identifier on Base.

Can I check if a .base.eth name is available before registering?

Yes, availability checks are built into the registration workflow. The skill verifies whether a .base.eth name is available for your wallet address before proceeding with registration and pricing calculations.

What do I need to register a basename on Base?

You need Node.js 18+, a private key with Base ETH for gas fees, and viem to interact with Base Basename contracts. The skill handles the rest through bundled scripts that manage availability, pricing, and registration.

How does setting a basename as primary help my agent wallet?

Setting a basename as primary maps your wallet address to a human-readable .base.eth name, enabling easy identity recognition and signing across Base applications and ecosystems without exposing raw wallet addresses.

Can I manage basenames across multiple wallets?

Yes, the skill automates basename lifecycle management across wallets and domains in Base ecosystems. You can register and assign primary names to different wallet addresses using separate private keys and registration calls.

What happens if a .base.eth name is unavailable or already taken?

The availability check identifies taken names before registration proceeds. If unavailable, the script reports the status and pricing so you can choose a different name or retry later when registration becomes possible.