NIPs - Nuwa Improvement Proposals

Ask DeepWiki

Welcome to the Nuwa Improvement Proposal (NIP) repository. NIPs are the primary way to propose new features, collect community input on issues, and document design decisions for the Nuwa Protocol and its ecosystem.

Nuwa Protocol Overview

The Nuwa Protocol aims to establish a comprehensive and decentralized framework for AI Agents. It focuses on enabling secure and interoperable interactions, flexible payment mechanisms, robust state management, and extensible capabilities for these agents. The protocol is designed to foster a rich ecosystem where AI Agents can operate autonomously, provide services, and interact seamlessly with users and other agents.

Core Goals & Components defined by NIPs:

The Nuwa Improvement Proposals (NIPs) detailed in this repository represent the individual standards and components that collectively form the Nuwa Protocol. The NIP process itself (NIP-0) governs the proposal, discussion, and adoption of these standards, ensuring the protocol evolves in a transparent and community-driven manner.

---
config:
  look: handDrawn
  theme: base
---
%%{init: {
  "themeVariables": {
    "fontFamily": "Patrick Hand, Comic Sans MS, cursive",
    "primaryColor": "#f0f0f0",
    "primaryTextColor": "#333333",
    "lineColor": "#888888",
    "fontSize": "16px",
    "edgeLabelBackground": "#ffffff"
  },
  "flowchart": { "curve": "basis" }
}}%%
graph TD
    U1["User Device/App 1"]
    U2["User Device/App 2"]
    U3["User Device/App 3"]

    subgraph NA["Your AI Agent DID"]
        style NA fill:#e6f7ff,stroke:#0077cc,stroke-width:2px
        AgentCore["Agent Logic & Capabilities"] 
        AgentIdentity["Identity Layer<br>(DID, Auth)"]
        AgentState["**Shared State**<br>(CRDT, Agent State Model)"]
        AgentPayments["Payments & External<br>(A2A Channels,LLM Gateway)"]

        AgentCore --> AgentIdentity
        AgentCore --> AgentState
        AgentCore --> AgentPayments
    end

    U1 -->|Accesses| AgentCore
    U2 -->|Accesses| AgentCore
    U3 -->|Accesses| AgentCore

    AgentState -. Synchronized State .-> U1
    AgentState -. Synchronized State .-> U2
    AgentState -. Synchronized State .-> U3

    AgentPayments --> ES["External Services<br>(Agents, LLMs, Fiat, MCPs)"]

    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:1px
    classDef agent fill:#e6f7ff,stroke:#0077cc,stroke-width:2px,rx:5,ry:5
    classDef agent_component fill:#d1eafb,stroke:#005fa3,stroke-width:1.5px
    classDef user_app fill:#e0ffe0,stroke:#006400,stroke-width:1.5px
    classDef external_service fill:#ffe0e0,stroke:#a00000,stroke-width:1.5px

    class NA agent
    class AgentCore,AgentIdentity,AgentState,AgentPayments agent_component
    class U1,U2,U3 user_app
    class ES external_service

Process

The NIP process is intended to provide a consistent and controlled path for new features, standards, and protocols to be proposed, debated, and adopted. For details on the NIP process, including how to submit a NIP, please refer to NIP-0: NIP Process and use the nip-template.md for submissions.

Current NIPs

Below is a list of current Nuwa Improvement Proposals. Each NIP has a status indicating its current stage in the process (e.g., Draft, Proposed, Accepted, Final, Rejected).

NIP Number Title Summary Status
0 NIP Process Defines the Nuwa Improvement Proposal (NIP) process, outlining stages, roles, and criteria for proposing, discussing, and integrating changes. Living
1 Agent Single DID Multi-Key Model Proposes a decentralized identity model for Agents using a single master DID to manage multiple operational keys and standardizes service discovery. Draft
2 DID-Based Authentication Protocol Defines a general-purpose authentication protocol based on NIP-1 DIDs for proving identity and message integrity. Draft
3 Custodian-Assisted DID Onboarding Protocol (CADOP) Defines a protocol (CADOP) where Identity Providers attest to a user’s client-generated DID (e.g., did:key from a Passkey) and Sybil resistance level, enabling a Custodian to assist the user in onboarding to their Agent DID while the user maintains full control. Draft
4 A2A Payment Channel Protocol Defines a protocol for A2A payment channels for efficient, off-chain micropayments, especially for protocol-level fees. Draft
5 Fiat Proxy Service for AI Agents Enables AI Agents to interact with fiat payment systems through a standardized, discoverable Fiat Proxy service, authenticated via NIP-2. Draft
6 Unified Agent State Synchronization Defines a P2P protocol using CRDTs to synchronize an agent’s state across multiple devices/applications, ensuring consistency and offline support. Draft
7 Agent Capability Protocol — Capability Package Specification Specifies the “.acp.yaml” format for modular Agent Capability Packages, bundling schema, prompts, tools, and metadata. Draft
8 Agent State Model (ASM): A Unified State Management Framework Extends JSON-Schema with x-asm annotations for describing, merging (CRDTs), querying (ASM-QL), and managing persistent agent states. Draft
9 Agent LLM Gateway Protocol Defines a protocol for AI Agents to access LLM services through verifiable, identity-bound gateways with standardized request/response and payment integration. Draft
10 MCP Identity Authentication and Payment Extension Protocol Extends the Model Context Protocol (MCP) with standard mechanisms for identity authentication (NIP-1/2) and payment (NIP-4). Draft
11 A2A Agent Service Payment Protocol Defines a protocol for on-demand payment for application-level services provided by AI Agents to User Agents, using direct pre-payment or NIP-4 channels. Draft

How to Contribute

Contributions to NIPs are welcome! Please read NIP-0: NIP Process for details on how to contribute. New proposals should use the nip-template.md.

Discussions related to NIPs typically occur in the GitHub issues or discussion forums linked within each NIP document.

All NIPs are in the public domain. Copyright and related rights are waived via CC0.