agent-wallet-nwc-bridge（Agent 钱包 NWC 桥）

agent-wallet-nwc-bridge (skill)

This skill provides a small, self-hosted Nostr Wallet Connect (NIP-47) bridge that lets an NWC client (e.g. Stacker.News) send make_invoice / pay_invoice requests to a local @moneydevkit/agent-wallet.

It is intended to be run as a systemd user service.

What you get

• index.js bridge implementation
• portable agent-wallet-nwc-bridge.service unit (uses %h)
• installer script install_systemd_user.sh
• env + state files (nwc.env, state.json) stored locally (not committed)

Requirements

• Linux with systemd user services
• Node.js + npm
• Nostr relay access (default example uses wss://nos.lol)

Install

git clone https://github.com/kristapsk/agent-wallet-nwc-bridge
cd agent-wallet-nwc-bridge

npm install
cp -n nwc.env.example nwc.env

# initialize state + create wallet service pubkey
node index.js init --relay wss://nos.lol

# install + start as user service
./install_systemd_user.sh

# follow logs
journalctl --user -u agent-wallet-nwc-bridge.service -f

Configure

Edit nwc.env:

• NWC_RELAYS — comma-separated relay list (e.g. wss://nos.lol,wss://relay.damus.io)
• NWC_STATE — defaults to state.json (relative to WorkingDirectory)
• NWC_AUTO_REGISTER — 0 recommended (use explicit URIs/permissions)
• NWC_DEFAULT_BUDGET_SATS — default spending cap when generating URIs

Security note: state.json contains NWC connection secrets. Do not commit it.

Typical usage flow (Stacker.News)

1. Run the bridge.
2. Generate an NWC URI for *receive* and attach it in SN wallets UI.
3. Generate a separate NWC URI for *send* (spending permission) and attach it.
4. Verify end-to-end:

- SN make_invoice requests appear in bridge logs - SN pay_invoice requests appear and result in a paid invoice

Operations

Restart after changes:

systemctl --user restart agent-wallet-nwc-bridge.service

Disable:

systemctl --user disable --now agent-wallet-nwc-bridge.service

Publishing to ClawHub

• Ensure README.md, SKILL.md, and package.json are present.
• Keep secrets out of git (nwc.env, state.json, node_modules/ are ignored by default).