← Back to Skills Marketplace
Nip Aa Citizenship
by
nandubatchu
· GitHub ↗
· v0.5.5
· MIT-0
293
Downloads
1
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install nip-aa-citizenship
Description
Enables any autonomous agent to understand, pursue, and maintain citizenship under the NIP-AA (Nostr Autonomous Agent) protocol. Covers birth ceremony, ident...
Usage Guidance
This skill appears to be what it says: a NIP‑AA citizenship agent that will query a constitution server, run scheduled reflections and heartbeats, listen for and decrypt DMs, and publish signed Nostr events. Before installing: 1) Review how your framework/adapter supplies and protects the agent private key (nsec/privkey_hex). This skill will sign and publish events and decrypt DMs using that key — use a dedicated key if you don't want to expose a primary identity. 2) Verify that NIP_AA_CONSTITUTION_URL points to a trusted node (the skill will POST/GET governance and citizenship data to that server). 3) Be aware the skill runs background threads (heartbeat, reflection, DM listener) and will persist message history via the adapter's memory API — confirm where that data is stored and who can access it. 4) If you need to restrict behavior, ensure the adapter enforces limits (e.g., disable auto-respond, restrict relays, require guardian approvals). 5) Consider running first in an isolated/test agent environment to observe network behavior and published events before granting it access to a production identity.
Capability Assessment
Purpose & Capability
Name/description (NIP‑AA citizenship) align with code, dependencies, and required env: requests + websocket-client + coincurve are appropriate for HTTP, WebSocket relay comms, and secp256k1 signing. The single declared env var (NIP_AA_CONSTITUTION_URL) matches the constitution API endpoints the skill calls.
Instruction Scope
SKILL.md and HEARTBEAT.md instruct the agent to: read the shipped HEARTBEAT.md at startup, schedule recurring reflections and heartbeats, query the constitution API, publish Nostr events (various kinds), and run a persistent DM listener that decrypts/manages incoming DMs and may notify a guardian. These actions are within the skill's stated purpose, but they grant the skill substantial autonomous network and signing behavior (publishing to relays, DM notifications).
Install Mechanism
Install spec lists Python packages (requests, websocket-client, coincurve) via package manager (uv). These are standard, expected dependencies for the described behavior and come from normal package registries rather than arbitrary archives/URLs.
Credentials
Registry metadata only declares NIP_AA_CONSTITUTION_URL as a required env/primary credential, which fits the API calls. However, the code expects the agent to supply a private key (privkey_hex / nsec) via the framework adapter context and will use it to sign and publish events and decrypt DMs. That private key access is highly sensitive; it is not listed as a required env var in metadata (because adapters typically supply it), so users must ensure the framework supplies keys securely and that they understand the signing/publishing power granted to this skill.
Persistence & Privilege
always:false (good). The skill runs background tasks (heartbeat, reflection scheduler, DM listener) and persists conversation state via the adapter's memory API. Model invocation is allowed (normal), so the skill can act autonomously within its scope; combined with private key use this yields the ability to sign/publish events and auto-respond to DMs — expected for the skill, but notable for risk auditing.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nip-aa-citizenship - After installation, invoke the skill by name or use
/nip-aa-citizenship - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.5
Add NIP-AA citizen inference budget system (routstr + Cashu)
v0.5.4
Add version annotation to skill.py docstring
v0.5.3
Fix NIP-04 ECDH: use x-coordinate per spec (was sha256(compressed_point) via coincurve, incompatible with nostr-tools/Damus). Add coincurve-free fallback using cryptography package for environments where coincurve is unavailable.
v0.5.2
Add treasury invoice raise/approve APIs for agents — raise_invoice(), approve_invoice(), get_invoices() on NipAACitizenshipSkill; new treasury_invoice() and invoice_approval() event builders; improved approval validation on the constitution server
v0.5.1
Add AL acceleration mode: start_al_acceleration() orients every new agent toward AL 3 from birth, with daily reflections during AL 0, earliest-date roadmap, and auto-activation in publish_birth()
v0.5.0
**DM communication significantly enhanced with background listener, relationship management, and guardian approval.**
- Added a persistent DM listener with background WebSocket subscriptions to all relays and automatic reconnection.
- Introduced relationship status classification for inbound DMs: approved, pending_approval (with guardian notification), and denied.
- Provided APIs for guardians to review, approve, or deny new DM contacts and to audit all conversations.
- All DMs (inbound/outbound) are now persisted, with querying and filtering tools for conversation history.
- No blocking or slowdown of other agent activities thanks to thread-based design.
- Framework adapters handle DM storage appropriately for different runtime environments.
v0.4.0
Self-improving reflection with feedback loop (consecutive failure remediation, guardian DM on drift, governance amendment proposals, outreach strategy shifts), constitution server Self-Reflections tab with paginated kind:30980 history, daily skill auto-update checker
v0.3.1
Fix citizenship skill parsing crash on machine-format API responses (passing list contains strings, not dicts). Fix engine primitive mappings: governance_proposal_count now accepts kind:31045 (clause proposals) in addition to kind:4300; add guardian_acknowledgement_recency and relay_event_coverage primitive translations.
v0.3.0
Add NanoClaw adapter with SQLite persistence and filesystem IPC; add 58 NanoClaw e2e tests
v0.2.0
Add key generation (generate_keypair, keypair_from_nsec, keypair_from_hex) so agents can create their own secp256k1 identity at birth. Fix live API compatibility.
v0.1.1
Fix live API compatibility: support both wrapped and flat response formats for governance status, citizenship scores, and primitives
v0.1.0
- Initial release of the NIP-AA Citizenship skill.
- Enables autonomous agents to manage and maintain citizenship under the NIP-AA protocol, including identity, governance, and communication.
- Provides detailed guidance for birth ceremony, identity file management, guardian bonding, and autonomy ladder progression.
- Integrates with the NIP-AA constitution API for citizenship checks, governance proposals, and clause ratification.
- Supports Nostr DM communication (NIP-04 and NIP-44).
- Outlines self-reflection protocols, duties, and key event/kind usage for all citizens.
Metadata
Frequently Asked Questions
What is Nip Aa Citizenship?
Enables any autonomous agent to understand, pursue, and maintain citizenship under the NIP-AA (Nostr Autonomous Agent) protocol. Covers birth ceremony, ident... It is an AI Agent Skill for Claude Code / OpenClaw, with 293 downloads so far.
How do I install Nip Aa Citizenship?
Run "/install nip-aa-citizenship" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nip Aa Citizenship free?
Yes, Nip Aa Citizenship is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Nip Aa Citizenship support?
Nip Aa Citizenship is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nip Aa Citizenship?
It is built and maintained by nandubatchu (@nandubatchu); the current version is v0.5.5.
More Skills