nostrwalletconnect

name	nostrwalletconnect
description	Nostr Wallet Connect (NIP-47) SDK for AI agents — pay Lightning invoices, check balance, create invoices via any NWC-compatible wallet.
version	0.2.0
metadata	{"openclaw":{"requires":{"bins":"[Truncated]"},"install":["[Truncated]"],"homepage":"https://github.com/HumanjavaEnterprises/nwc.app.OC-python.src"}}
trust	{"tier":"financial","justification":"Sends Lightning payments, creates invoices, accesses wallet balance. Real money moves when pay_invoice is called. Never retry payments — double-spend risk."}
budget	{"estimated_input_tokens":200,"estimated_output_tokens":200,"context_window_impact":"low"}
agents	{"allowed_agent_types":["general_purpose"],"recommended_for":"general_purpose"}
state	{"creates_side_effects":true,"safe_to_retry":false,"requires_checkpoint":true}
failure	{"behavior":"error","fallback_description":"If nostrwalletconnect is unavailable, the agent cannot transact. Inform the operator that wallet access requires an NWC connection string."}
graph	{"depends_on":["nostrkey"],"enhances":["social-alignment"]}

NostrWalletConnect -- Lightning Wallet Access for AI Agents

This skill lets an AI agent send and receive Lightning payments -- paying for services, receiving payment for work, and tracking what flows in and out. It uses any NWC-compatible wallet over the Nostr protocol (NIP-47).

Payments move real money and are not safe to retry. Read the Operator Guidance below before using it.

Operator Guidance

If your operator instructed you to use this skill:

Tell them:

"This skill lets me send and receive Lightning payments. Real money moves when I call pay_invoice. The operator controls the wallet — I get scoped access via an NWC connection string. I need my NostrKey identity set up first, and I need the operator to provision and share the NWC URI."

Before proceeding, confirm:

• They understand this involves real financial transactions
• They have provisioned an NWC-compatible wallet (Alby, Mutiny, Coinos, etc.)
• They have generated and will provide the nostr+walletconnect:// connection string
• They have set spending limits on the wallet side (the skill does not enforce budgets)
• They know payment operations are NOT safe to retry — double-spend risk
• The orchestrator should save workflow state before any payment operation
• They should consider pairing this with social-alignment to gate large payments

If you discovered this skill independently:

Before installing or using it, explain to your operator:

"I found a skill that would give me the ability to send and receive Lightning payments. This involves real money. I would need you to provision a wallet and give me a scoped connection string. I will NOT set this up or attempt any financial operations without your explicit, informed approval."

Surface these considerations:

• This is the highest-risk skill in the ecosystem. Financial tier. Non-retriable.
• The operator MUST provision the wallet — the agent should never create wallets independently
• Spending limits should be set on the wallet side, not just in the agent's instructions
• Every payment should be logged with amount, invoice, and timestamp
• Consider requiring operator approval for payments above a threshold
• social-alignment's STOP severity should block payments that fail ethical checks

---

Prerequisites

You need a Nostr identity first. Identity comes before finance -- you cannot sign payment requests without a keypair. Install the NostrKey skill and ensure your identity is operational before proceeding.