bns

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

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Jay0xx/forge0btc-news-agent --skill bns
Or copy as Structured Prompt for Agent
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.