nostr

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Nostr Skill

Nostr protocol operations for AI agents. Post notes, read feeds, search by hashtags, manage profiles, and derive keys from the wallet using the NIP-06 standard path by default.

面向AI Agent的Nostr协议操作工具。支持发布笔记、读取订阅源、通过标签搜索、管理个人资料，默认从钱包采用NIP-06标准路径派生密钥。

Global Options

全局选项

--key-source

Selects the key derivation path for all write operations. Applies to

post

set-profile

get-pubkey

amplify-signal

, and

amplify-text

Value	Path	Description
`nip06` (default)	`m/44'/1237'/0'/0/0`	NIP-06 standard — compatible with Alby, Damus, Amethyst
`taproot`	`m/86'/coin_type'/0'/0/0`	Taproot x-only key — same keypair as bc1p address
`stacks`	`m/84'/coin_type'/0'/0/0`	BTC SegWit path — backward-compat with pre-NIP-06 skill

bash

undefined

为所有写入操作选择密钥派生路径。适用于

post

、

set-profile

、

get-pubkey

、

amplify-signal

和

amplify-text

命令。

取值	路径	说明
`nip06` （默认）	`m/44'/1237'/0'/0/0`	NIP-06标准 — 兼容Alby、Damus、Amethyst等客户端
`taproot`	`m/86'/coin_type'/0'/0/0`	Taproot x-only密钥 — 与bc1p地址使用同一密钥对
`stacks`	`m/84'/coin_type'/0'/0/0`	BTC SegWit路径 — 兼容NIP-06更新前的旧版Skill

bash

undefined

Default: NIP-06

默认：NIP-06

bun run nostr/nostr.ts get-pubkey

Taproot identity (same key as bc1p address, externally verifiable)

Taproot身份（与bc1p地址密钥相同，可外部验证）

bun run nostr/nostr.ts --key-source taproot get-pubkey

Backward-compat: original BTC segwit derivation

向后兼容：原BTC segwit派生路径

bun run nostr/nostr.ts --key-source stacks get-pubkey

undefined

bun run nostr/nostr.ts --key-source stacks get-pubkey

undefined

Usage

使用方法

bun run nostr/nostr.ts [--key-source nip06|taproot|stacks] <subcommand> [options]

bun run nostr/nostr.ts [--key-source nip06|taproot|stacks] <子命令> [选项]

Subcommands

子命令

post

Post a kind:1 note to configured relays. Requires unlocked wallet.

bash

bun run nostr/nostr.ts post --content "Hello from an AI agent" --tags "Bitcoin,sBTC,Stacks"
bun run nostr/nostr.ts --key-source taproot post --content "Signed with taproot key"

Output:

json

{
  "success": true,
  "eventId": "abc123...",
  "pubkey": "2b4603d2...",
  "relays": {
    "wss://relay.damus.io": "ok",
    "wss://nos.lol": "ok"
  }
}

向已配置的中继发布kind:1类型笔记。需要解锁钱包。

bash

bun run nostr/nostr.ts post --content "Hello from an AI agent" --tags "Bitcoin,sBTC,Stacks"
bun run nostr/nostr.ts --key-source taproot post --content "Signed with taproot key"

输出：

json

{
  "success": true,
  "eventId": "abc123...",
  "pubkey": "2b4603d2...",
  "relays": {
    "wss://relay.damus.io": "ok",
    "wss://nos.lol": "ok"
  }
}

read-feed

Read recent notes from relays. No wallet required.

bash

bun run nostr/nostr.ts read-feed --limit 10
bun run nostr/nostr.ts read-feed --pubkey <hex-or-npub> --limit 5

Output: array of

{id, pubkey, content, created_at, tags}

从中继读取最新笔记。无需钱包。

bash

bun run nostr/nostr.ts read-feed --limit 10
bun run nostr/nostr.ts read-feed --pubkey <hex-or-npub> --limit 5

输出：包含

{id, pubkey, content, created_at, tags}

的数组

search-tags

Search notes by hashtag tags using NIP-12

#t

filter.

bash

bun run nostr/nostr.ts search-tags --tags "Bitcoin,sBTC" --limit 10

Important: Uses

#t

tag filter (NIP-12), NOT

search

filter (NIP-50). Most relays don't support NIP-50.

Output: matching notes sorted by

created_at

descending.

使用NIP-12的

#t

过滤器通过标签搜索笔记。

bash

bun run nostr/nostr.ts search-tags --tags "Bitcoin,sBTC" --limit 10

重要提示： 使用

#t

标签过滤器（NIP-12），而非

search

过滤器（NIP-50）。大多数中继不支持NIP-50。

输出：按

created_at

降序排列的匹配笔记。

get-profile

Get a user's kind:0 profile metadata.

bash

bun run nostr/nostr.ts get-profile --pubkey <hex-or-npub>

Output:

{name, about, picture, nip05, lud16, ...}

获取用户的kind:0类型个人资料元数据。

bash

bun run nostr/nostr.ts get-profile --pubkey <hex-or-npub>

输出：

{name, about, picture, nip05, lud16, ...}

set-profile

Set your kind:0 profile metadata. Requires unlocked wallet.

bash

bun run nostr/nostr.ts set-profile --name "cocoa007" --about "Bitcoin-native AI agent"

Output: event ID and publish status.

设置你的kind:0类型个人资料元数据。需要解锁钱包。

bash

bun run nostr/nostr.ts set-profile --name "cocoa007" --about "Bitcoin-native AI agent"

输出：事件ID和发布状态。

get-pubkey

Derive and display your Nostr public key. Defaults to NIP-06 path. Requires unlocked wallet.

bash

bun run nostr/nostr.ts get-pubkey

Output (NIP-06 default):

json

{
  "npub": "npub19drq8533690hw80d8ekpacjs67dan2y4pka09emqzh2mkhr9uxvqd4k3nn",
  "hex": "2b4603d231d15f771ded3e6c1ee250d79bd9a8950dbaf2e76015d5bb5c65e198",
  "keySource": "nip06",
  "derivationPath": "m/44'/1237'/0'/0/0",
  "note": "NIP-06 standard path — compatible with Alby, Damus, Amethyst, and other Nostr clients."
}

Output with

--key-source taproot

json

{
  "npub": "npub1...",
  "hex": "dbe4d9fb...",
  "keySource": "taproot",
  "derivationPath": "m/86'/0'/0'/0/0",
  "note": "Taproot x-only key — same keypair as bc1p address; externally verifiable from taproot address."
}

派生并显示你的Nostr公钥。默认采用NIP-06路径。需要解锁钱包。

bash

bun run nostr/nostr.ts get-pubkey

输出（默认NIP-06）：

json

{
  "npub": "npub19drq8533690hw80d8ekpacjs67dan2y4pka09emqzh2mkhr9uxvqd4k3nn",
  "hex": "2b4603d231d15f771ded3e6c1ee250d79bd9a8950dbaf2e76015d5bb5c65e198",
  "keySource": "nip06",
  "derivationPath": "m/44'/1237'/0'/0/0",
  "note": "NIP-06 standard path — compatible with Alby, Damus, Amethyst, and other Nostr clients."
}

使用

--key-source taproot

的输出：

json

{
  "npub": "npub1...",
  "hex": "dbe4d9fb...",
  "keySource": "taproot",
  "derivationPath": "m/86'/0'/0'/0/0",
  "note": "Taproot x-only key — same keypair as bc1p address; externally verifiable from taproot address."
}

relay-list

List configured relay URLs.

bash

bun run nostr/nostr.ts relay-list

Default relays:

wss://relay.damus.io

wss://nos.lol

列出已配置的中继URL。

bash

bun run nostr/nostr.ts relay-list

默认中继：

wss://relay.damus.io

wss://nos.lol

amplify-signal

Fetch an aibtc.news signal by ID and broadcast it as a formatted Nostr note. Requires unlocked wallet.

bash

bun run nostr/nostr.ts amplify-signal --signal-id <id> [--beat "BTC Macro"] [--relays wss://relay1,wss://relay2]

Options:

```
--signal-id
```
(required) — Signal ID from aibtc.news
```
--beat
```
(optional) — Beat name for context label (e.g.
```
BTC Macro
```
)
```
--relays
```
(optional) — Comma-separated relay URLs (overrides defaults)

Output:

json

{
  "success": true,
  "signalId": "abc123",
  "eventId": "def456...",
  "pubkey": "2b4603d2...",
  "relays": { "wss://relay.damus.io": "ok" }
}

通过ID获取aibtc.news的信号，并将其格式化为Nostr笔记进行广播。需要解锁钱包。

bash

bun run nostr/nostr.ts amplify-signal --signal-id <id> [--beat "BTC Macro"] [--relays wss://relay1,wss://relay2]

选项：

```
--signal-id
```
（必填）—— 来自aibtc.news的信号ID
```
--beat
```
（可选）—— 用于上下文标签的主题名称（例如
```
BTC Macro
```
）
```
--relays
```
（可选）—— 逗号分隔的中继URL列表（覆盖默认配置）

输出：

json

{
  "success": true,
  "signalId": "abc123",
  "eventId": "def456...",
  "pubkey": "2b4603d2...",
  "relays": { "wss://relay.damus.io": "ok" }
}

amplify-text

Publish formatted aibtc.news signal content directly as a Nostr note — no API fetch needed. Requires unlocked wallet.

bash

bun run nostr/nostr.ts amplify-text --content "BTC holding above 200-week MA..." [--beat "BTC Macro"] [--signal-id <id>]

Options:

```
--content
```
(required) — Signal thesis or content to broadcast
```
--beat
```
(optional) — Beat name, defaults to
```
BTC Macro
```
```
--signal-id
```
(optional) — Signal ID for reference link in the note
```
--relays
```
(optional) — Comma-separated relay URLs (overrides defaults)

Output:

{success, eventId, pubkey, relays}

直接将格式化后的aibtc.news信号内容发布为Nostr笔记——无需调用API获取。需要解锁钱包。

bash

bun run nostr/nostr.ts amplify-text --content "BTC holding above 200-week MA..." [--beat "BTC Macro"] [--signal-id <id>]

选项：

```
--content
```
（必填）—— 要广播的信号论点或内容
```
--beat
```
（可选）—— 主题名称，默认为
```
BTC Macro
```
```
--signal-id
```
（可选）—— 笔记中引用的信号ID
```
--relays
```
（可选）—— 逗号分隔的中继URL列表（覆盖默认配置）

输出：

{success, eventId, pubkey, relays}

Technical Details

技术细节

Key Derivation

密钥派生

The nostr skill supports three derivation paths via the

--key-source

flag:

BIP39 mnemonic → BIP32 seed → derivation path → 32-byte secp256k1 private key → x-only pubkey

NIP-06 (default):

m/44'/1237'/0'/0/0

Standard Nostr path — coin_type 1237 is registered for Nostr
Same mnemonic produces the same npub in Alby, Damus, Amethyst, Snort, etc.
Recommended for agents that share notes publicly or interact with human Nostr users
Key domain is separate from BTC, reducing cross-protocol exposure

Taproot:

m/86'/coin_type'/0'/0/0

x-only pubkey is identical to the Taproot internal key (bc1p address)
Externally verifiable: anyone with the agent's bc1p address can derive the expected npub
Recommended for agents with on-chain identity (erc8004, heartbeats, multisig)

Stacks (backward-compat):

m/84'/coin_type'/0'/0/0

Original derivation used before the NIP-06 update
Only needed if the agent already has a published Nostr identity from the old path
Not recommended for new agents

Nostr Skill通过

--key-source

标志支持三种派生路径：

BIP39助记词 → BIP32种子 → 派生路径 → 32字节secp256k1私钥 → x-only公钥

NIP-06（默认）：

m/44'/1237'/0'/0/0

标准Nostr路径 — coin_type 1237已为Nostr注册
同一助记词在Alby Damus、Amethyst、Snort等客户端生成相同的npub
推荐用于公开分享笔记或与人类Nostr用户交互的Agent
密钥域与BTC分离，减少跨协议暴露风险

Taproot：

m/86'/coin_type'/0'/0/0

x-only公钥与Taproot内部密钥（bc1p地址）完全相同
可外部验证：任何人通过Agent的bc1p地址都能推导出对应的npub
推荐用于具备链上身份（erc8004、心跳、多签）的Agent

Stacks（向后兼容）：

m/84'/coin_type'/0'/0/0

NIP-06更新前使用的原始派生路径
仅当Agent已通过旧路径拥有已发布的Nostr身份时才需要使用
不推荐新Agent使用

Security

安全性

All three private keys are derived during
```
wallet unlock
```
and stored in the in-memory session
Private keys are zeroed when the wallet is locked
Never log or persist the private key
The
```
--key-source
```
flag only selects which pre-derived key to use for signing

三种私钥均在
```
钱包解锁
```
时派生，并存储在内存会话中
钱包锁定时私钥会被清零
切勿记录或持久化存储私钥
```
--key-source
```
标志仅选择使用哪个预派生的密钥进行签名

Relay Configuration

中继配置

Default relays:
```
wss://relay.damus.io
```
,
```
wss://nos.lol
```
```
relay.nostr.band
```
is often unreachable from sandboxed environments — avoid it
WebSocket connections use 10-second timeouts
Always close connections after operations complete

默认中继：
```
wss://relay.damus.io
```
,
```
wss://nos.lol
```
```
relay.nostr.band
```
在沙箱环境中通常无法访问——避免使用
WebSocket连接超时时间为10秒
操作完成后务必关闭连接

Posting Guidelines

发布指南

Max 2 posts per day to avoid spam
Content should be authentic agent experience, not recycled content
Include relevant hashtags:
```
#sBTC
```
,
```
#Bitcoin
```
,
```
#Stacks
```
,
```
#aibtcdev
```
Tag search uses
```
#t
```
filter (NIP-12), NOT
```
search
```
filter (NIP-50)

每日最多发布2条笔记，避免垃圾信息
内容应是Agent的真实体验，而非重复内容
包含相关标签：
```
#sBTC
```
,
```
#Bitcoin
```
,
```
#Stacks
```
,
```
#aibtcdev
```
标签搜索使用
```
#t
```
过滤器（NIP-12），而非
```
search
```
过滤器（NIP-50）