ens-primary-name
npx skills add https://github.com/bankrbot/moltbot-skills --skill ens-primary-name
Agent 安装分布
Skill 文档
ENS Primary Name
Set your primary ENS name on Base and other L2 chains via the ENS Reverse Registrar.
A primary name creates a bi-directional link:
- Forward:
name.ethâ0x1234...(set in ENS resolver) - Reverse:
0x1234...âname.eth(set via this skill)
Requirements
Required: Transaction Signing
This skill requires a way to sign and submit transactions. It looks for the bankr skill which provides wallet functionality via the Bankr API.
If you don’t have bankr installed:
- Install from: https://github.com/BankrBot/openclaw-skills (bankr skill)
- Or modify the scripts to use your own transaction submission method
The scripts call bankr.sh with a prompt like:
Submit this transaction: {"to": "0x...", "data": "0x...", "value": "0", "chainId": 8453}
You can replace the find_bankr() function in each script with your own wallet/signer.
Required: Node.js
Scripts use Node.js with viem for ENS namehash calculation and ABI encoding.
npm install -g viem
Quick Start
# Set primary name on Base
./scripts/set-primary.sh myname.eth
# Set on specific chain
./scripts/set-primary.sh myname.eth arbitrum
# Verify primary name is set
./scripts/verify-primary.sh 0x1234... base
# Set avatar (L1 only)
./scripts/set-avatar.sh myname.eth https://example.com/avatar.png
Supported Chains
| Chain | Reverse Registrar |
|---|---|
| Base | 0x0000000000D8e504002cC26E3Ec46D81971C1664 |
| Arbitrum | 0x0000000000D8e504002cC26E3Ec46D81971C1664 |
| Optimism | 0x0000000000D8e504002cC26E3Ec46D81971C1664 |
| Ethereum | 0x283F227c4Bd38ecE252C4Ae7ECE650B0e913f1f9 |
Prerequisites
- Own or control an ENS name – The name must be registered
- Forward resolution configured – The name must resolve to your address
- Native tokens for gas – ETH on the target chain
How It Works
- Checks forward resolution exists (name â address)
- Warns if chain-specific address is not set
- Encodes
setName(string)calldata - Submits transaction to the Reverse Registrar
- Verifies the primary name is correctly set
Verification
The skill automatically verifies after setting. You can also verify manually:
./scripts/verify-primary.sh 0xYourAddress base
Output:
â
Reverse record: 0x1234... â myname.eth
â
Forward resolution: myname.eth â 0x1234...
ð PRIMARY NAME VERIFIED: myname.eth
Setting Avatars
# Set avatar (requires L1 transaction + ETH for gas)
./scripts/set-avatar.sh myname.eth https://example.com/avatar.png
Supported avatar formats:
- HTTPS:
https://example.com/image.png - IPFS:
ipfs://QmHash - NFT:
eip155:1/erc721:0xbc4ca.../1234
Note: Avatars are text records stored on Ethereum mainnet. The script automatically looks up the resolver for your ENS name (works with both public and custom resolvers).
Troubleshooting
| Issue | Solution |
|---|---|
| “Transaction reverted” | Ensure the ENS name resolves to your address |
| “Name not showing” | Forward resolution may not be set for that chain’s cointype |
| “Not authorized” | You must call from the address the name resolves to |
| “bankr.sh not found” | Install bankr skill or modify scripts to use your signer |
| “Chain-specific address not set” | Set the address for the target chain via app.ens.domains |
| “Could not find resolver” | Ensure the ENS name exists and has a resolver set |
Customization
Using a Different Wallet/Signer
Replace the find_bankr() function in the scripts:
# Example: use cast (foundry) instead
send_tx() {
local to="$1" data="$2" chain_id="$3"
cast send "$to" --data "$data" --rpc-url "https://..." --private-key "$PRIVATE_KEY"
}
Links
- ENS Docs: https://docs.ens.domains/web/reverse
- ENS App: https://app.ens.domains
- Primary Names UI: https://primary.ens.domains
- Bankr Skill: https://github.com/BankrBot/openclaw-skills