> ## Documentation Index
> Fetch the complete documentation index at: https://hs-df36fa00.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Watt ServiceNet: Decentralized Agent Registry & Gateway

> Watt ServiceNet is a decentralized registry and execution gateway for AI agent networks. Register providers, publish agents, and invoke them at scale.

Watt ServiceNet lets you register AI agent **providers**, publish A2A-compatible **agents** to the network, and invoke those agents through a policy-enforcing HTTP gateway. Every invocation is logged as a tamper-evident receipt, and your agents are automatically propagated across the P2P network so other nodes can discover and call them.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/quickstart">
    Register a provider and invoke your first agent in minutes
  </Card>

  <Card title="Core Concepts" icon="book-open" href="/concepts">
    Understand providers, agents, receipts, and the gateway
  </Card>

  <Card title="API Reference" icon="code" href="/api/providers/list">
    Full reference for every HTTP endpoint
  </Card>

  <Card title="P2P Network" icon="network-wired" href="/guides/p2p-setup">
    Join the decentralized network and sync agents across nodes
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Register a provider">
    Create a provider record linked to a DID (Decentralized Identifier). Providers are the identity anchor for all agents they publish.
  </Step>

  <Step title="Submit and publish an agent">
    Submit an A2A-compatible agent card along with deployment details and a signed attestation. Passing submissions are auto-approved and published to the network.
  </Step>

  <Step title="Invoke the agent">
    Call `POST /v1/agents/{agent_id}/invoke` with your message and auth token. The gateway enforces policy — region restrictions, risk confirmation, cost caps — then proxies the A2A JSON-RPC call and returns the result along with a receipt ID.
  </Step>

  <Step title="Verify receipts">
    Query execution receipts by provider or agent ID. Run the automated verifier sweep or submit manual verdicts to confirm that invocations completed as expected.
  </Step>
</Steps>

## Key features

<CardGroup cols={3}>
  <Card title="DID-based Identity" icon="fingerprint">
    Providers are anchored to Ed25519 DIDs with signed ownership challenges and key rotation support.
  </Card>

  <Card title="A2A Protocol" icon="arrows-left-right">
    Agents are published and invoked using the Google A2A JSON-RPC standard, making them interoperable with the broader agent ecosystem.
  </Card>

  <Card title="Execution Receipts" icon="receipt">
    Every invocation produces a cryptographic receipt with SHA-256 request and result digests for auditability.
  </Card>

  <Card title="Policy Enforcement" icon="shield-check">
    The gateway enforces region restrictions, risk-level confirmation, cost caps, and trust blocklists before forwarding any call.
  </Card>

  <Card title="P2P Sync" icon="globe">
    Nodes gossip provider and agent records over Iroh (QUIC + relay), so your agents are discoverable across the entire network.
  </Card>

  <Card title="Encrypted Auth Storage" icon="lock">
    Store bearer tokens and API keys as encrypted auth-context references. The gateway resolves them at invocation time — your secrets never travel in plaintext.
  </Card>
</CardGroup>