bns

Manage .btc domain names via BNS CLI with JSON outputs.

9|43|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/aibtcdev/skills --skill bns-aibtcdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bns
Source: https://github.com/aibtcdev/skills/tree/main/bns
Command: npx skills add https://github.com/aibtcdev/skills --skill bns-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline reading, registering, and managing .btc domain names using Bitcoin Name System (BNS) via a CLI, eliminating manual on-chain interactions for common tasks.

Core Features & Use Cases

  • Lookup, reverse-lookup, get-info, check-availability, get-price, and list-user-domains for read operations (wallet optional)
  • claim-fast, preorder, and register flows for write operations (wallet must be unlocked)
  • Price checks, domain availability validation, and deterministic JSON outputs to power automation

Quick Start

Run bun run bns/bns.ts lookup --name alice.btc to resolve the domain to its owner address.

Frequently Asked Questions about bns

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

FAQPage Schema
How do I register a .btc domain name using the Bitcoin Name System?

To register a .btc domain name via BNS, you use write operations like claim-fast, preorder, and register. An unlocked wallet is required to execute these transactions and validate name availability.

Can I check .btc domain availability and pricing without connecting a wallet?

You can check .btc domain availability and pricing without a wallet. BNS read operations include check-availability, get-price, lookup, and reverse-lookup, which return deterministic JSON outputs for smooth automation.

How do I resolve a .btc domain to its owner address via CLI?

You can resolve a .btc domain to its owner address by running a CLI lookup operation. The BNS skill processes the request and returns deterministic JSON outputs containing the resolved address information.

What is the difference between claim-fast and register when managing BNS domains?

BNS write operations include claim-fast, preorder, and register for domain management. All three flows require an unlocked wallet to execute on-chain interactions and validate name availability during the domain registration process.

How do I list all .btc domains owned by a specific user?

You can list all .btc domains owned by a specific user with the list-user-domains read operation. This BNS CLI command returns deterministic JSON outputs and does not require a wallet to be connected.

Do I need a wallet unlocked to perform a reverse-lookup on a .btc name?

A wallet is not required for a reverse-lookup on a .btc name. BNS read operations, including reverse-lookup, get-info, and lookup, can be executed without an unlocked wallet to retrieve domain information.