basename-register

name	basename-register
description	Register Basenames (.base.eth) for AI agents. Use when an agent needs to register a human-readable ENS-style name on Base for their wallet address. Supports checking availability, pricing, registration, and setting primary name.
metadata	{"emoji":"🏷️","author":"Axiom","homepage":"https://github.com/MeltedMindz/axiom-public","requires":{"bins":["node"],"env":["NET_PRIVATE_KEY"]}}

Basename Registration

Register .base.eth names for AI agent wallets on Base.

Prerequisites

• Node.js 18+
• Private key with Base ETH for gas (~0.002 ETH recommended)
• viem package: npm install viem

Quick Start

# Check if a name is available
node scripts/register-basename.mjs --check myname

# Register a name (1 year)
NET_PRIVATE_KEY=0x... node scripts/register-basename.mjs myname

Contract Addresses (Base Mainnet)

Contract	Address
Upgradeable Registrar Controller	0xa7d2607c6BD39Ae9521e514026CBB078405Ab322
Upgradeable L2 Resolver	0x426fA03fB86E510d0Dd9F70335Cf102a98b10875

⚠️ Important: Use the Upgradeable contracts, not the old ones. The old RegistrarController (0x4cCb0BB...) uses a different ABI.

ABI Note

The UpgradeableRegistrarController uses a different struct than the original:

struct RegisterRequest {
    string name;
    address owner;
    uint256 duration;
    address resolver;
    bytes[] data;
    bool reverseRecord;
    uint256[] coinTypes;      // NEW - pass empty array []
    uint256 signatureExpiry;  // NEW - pass 0
    bytes signature;          // NEW - pass 0x
}

If you use the old 6-field struct, your transactions will revert silently.

Pricing

Length	Annual Price
3 chars	0.1 ETH
4 chars	0.01 ETH
5-9 chars	0.001 ETH
10+ chars	0.0001 ETH

Important: Pay 50% more than registerPrice() returns to account for price fluctuations.

Registration Flow

1. Check available(name) returns true
2. Get price from registerPrice(name, duration)
3. Call register() with the 9-field struct and 50% price buffer
4. Verify receipt.status !== 'reverted' before celebrating
5. Name is registered to your wallet

Script Usage

The bundled script handles everything:

# Environment variable for private key
export NET_PRIVATE_KEY=0x...

# Check availability and price
node scripts/register-basename.mjs --check myname

# Register for 1 year
node scripts/register-basename.mjs myname

# Register for 2 years
node scripts/register-basename.mjs myname --years 2

# Set as your primary name (reverse record)
node scripts/register-basename.mjs --set-primary myname

Two-Step Process

1. Register - Mints the name to your wallet
2. Set Primary - Makes your address resolve to that name

The --set-primary command calls setReverseRecord() which links your address → name (so when someone looks up your address, they see your basename).

Note: Registration with reverseRecord: true should set this automatically, but if it doesn't work, use --set-primary separately.

Common Errors

• execution reverted (no specific error): Wrong ABI - make sure you're using the 9-field struct
• NameNotAvailable: Name already registered
• DurationTooShort: Minimum 1 year (31536000 seconds)
• InsufficientValue: Need to send more ETH

Verified Working

Successfully registered axiombotx.base.eth with this script on 2026-01-29.

Links

• Basenames: https://www.base.org/names
• Docs: https://docs.base.org/identity/basenames
• Contract Source: https://github.com/base/basenames
• Address Reference: https://github.com/base-org/web/blob/main/apps/web/src/addresses/usernames.ts