bns

Manage .btc domain names via CLI with lookup, pricing, and registration.

Updated Mar 29, 2026

Search Tags:#cli #wallet #domain #lookup #registration #btc #bns

Ready to run

npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill bns

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bns
Source: https://github.com/Jay0xx/forge0btc-news-agent/tree/main/aibtcdev-skills/bns
Command: npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill bns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables software engineers and power users to manage Bitcoin Name System (.btc) domains from a single CLI, unifying lookups, pricing, and registrations.

Core Features & Use Cases

Read operations without a wallet: lookup, reverse-lookup, get-info, check-availability, get-price, list-user-domains.
Write operations with wallet requirements: claim-fast, preorder, register, all guarded by unlock prerequisites and safety checks.
Use cases: register new .btc names quickly via claim-fast or plan a two-step preorder/register flow for non-.btc namespaces.

Quick Start

Run bun run bns/bns.ts lookup --name myname.btc to see a sample result.

Frequently Asked Questions about bns

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

FAQPage Schema

How do I check .btc domain availability and pricing from the command line?▼

Use the BNS CLI to perform a reverse-lookup by querying an owner address, returning the associated .btc domain names as structured JSON without requiring a wallet connection.

Do I need an unlocked wallet to register a .btc domain name?▼

Yes, write operations like register and claim-fast require an unlocked wallet, while read-only operations like lookup and get-price do not need a wallet connection.

What is the difference between the claim-fast and preorder/register workflows for BNS?▼

The claim-fast operation registers .btc names in a single transaction, while the preorder and register flow is a two-step process required for non-.btc namespaces.

Can I list all .btc domains owned by a specific address without connecting a wallet?▼

Yes, the list-user-domains command is a read-only operation that retrieves all .btc domains owned by a specific address without requiring an unlocked wallet.