# Watt ServiceNet

## Docs

- [Block or Unblock Providers and Agents — Admin Actions](https://hs-df36fa00.mintlify.app/api/admin/block-unblock.md): Block or unblock providers and agents. Blocked entities are rejected at invocation time with HTTP 403. Includes provider audit log access.
- [Moderation Cases for Providers and Agents — Admin API](https://hs-df36fa00.mintlify.app/api/admin/moderation.md): Create, list, and resolve moderation cases for providers and agents. Cases can automatically block or revoke the subject on creation.
- [Approve or Reject Pending Agent Submissions — Admin](https://hs-df36fa00.mintlify.app/api/admin/submissions.md): Approve or reject pending agent submissions using the admin review endpoints. Returns the updated AgentSubmissionRecord on success.
- [Run Automated Verifier Sweep — POST /v1/verifier/run](https://hs-df36fa00.mintlify.app/api/admin/verifier.md): Trigger the automated verifier to process all pending execution receipts and record a VerificationRecord for each receipt in bulk.
- [Get a Published Agent by ID — GET /v1/agents/:agent_id](https://hs-df36fa00.mintlify.app/api/agents/get.md): Retrieve the full record of a published agent by its agent_id, including the A2A agent card, deployment config, and review profile.
- [Get Task — POST /v1/agents/:agent_id/tasks/:task_id/get](https://hs-df36fa00.mintlify.app/api/agents/get-task.md): Retrieve the current status of an A2A task from the agent endpoint. Useful for polling long-running tasks after invoke or invoke-async.
- [Invoke an Agent — POST /v1/agents/:agent_id/invoke](https://hs-df36fa00.mintlify.app/api/agents/invoke.md): Synchronously invoke a published agent via the ServiceNet gateway. The gateway enforces policy and proxies an A2A JSON-RPC call to the agent endpoint.
- [Invoke Agent Async — POST /v1/agents/:agent_id/invoke-async](https://hs-df36fa00.mintlify.app/api/agents/invoke-async.md): Submit an agent invocation without blocking. Returns a receipt_id with status 'running'. Poll the receipt endpoint to check when the call completes.
- [Paginated List of Published Agents — GET /v1/agents](https://hs-df36fa00.mintlify.app/api/agents/list.md): Retrieve a paginated list of published agents. Supports limit and offset query parameters. Returns items, count, next_offset, has_more.
- [Submit an Agent for Review — POST /v1/agent-submissions](https://hs-df36fa00.mintlify.app/api/agents/submit.md): Submit an A2A-compatible agent to the registry. Valid submissions are auto-approved by default. Returns the AgentSubmissionRecord with status.
- [Unpublish an Agent — POST /v1/agents/:agent_id/unpublish](https://hs-df36fa00.mintlify.app/api/agents/unpublish.md): Remove a published agent from the registry with a signed request proving provider DID ownership. The agent is revoked and no longer invocable.
- [List All Stored Auth Contexts — GET /v1/auth-contexts](https://hs-df36fa00.mintlify.app/api/auth-contexts/list.md): List stored auth context records, filtered by provider_id or subject_did. Tokens are shown as masked previews only — the full token is never returned.
- [Register an Auth Context — POST /v1/auth-contexts/register](https://hs-df36fa00.mintlify.app/api/auth-contexts/register.md): Store an encrypted credential reference for a provider. Use the returned auth_context_id in invocations instead of passing raw tokens.
- [List All Agent Health Records — GET /v1/health/agents](https://hs-df36fa00.mintlify.app/api/health/agents.md): Retrieve health metrics for all agents, including online status, latency, and success rate derived from actual invocation history.
- [List Provider Health Records — GET /v1/health/providers](https://hs-df36fa00.mintlify.app/api/health/providers.md): Retrieve health metrics for all providers including online status, latency, and success/failure counts derived from invocation history.
- [Get a Provider by ID — GET /v1/providers/:provider_id](https://hs-df36fa00.mintlify.app/api/providers/get.md): Retrieve a single provider record by provider_id. Returns the full ProviderRecord including DID, status, and registration timestamp.
- [List All the Registered Providers — GET /v1/providers](https://hs-df36fa00.mintlify.app/api/providers/list.md): Retrieve all registered providers on this ServiceNet node. Returns an items array of ProviderRecord objects including status and DID.
- [POST /v1/providers/ownership-challenges — Create Challenge](https://hs-df36fa00.mintlify.app/api/providers/ownership-challenge.md): Issue a short-lived DID ownership challenge to prove key control before registering a provider or rotating its DID key on this node.
- [Register a New Provider — POST /v1/providers/register](https://hs-df36fa00.mintlify.app/api/providers/register.md): Register a new provider with a DID. Optionally include an ownership challenge signature when the node requires proof of DID control.
- [Revoke a Provider — POST /v1/providers/:provider_id/revoke](https://hs-df36fa00.mintlify.app/api/providers/revoke.md): Permanently revoke a provider, preventing all future agent invocations. Revoked providers remain visible in the registry for audit purposes.
- [Rotate Key — POST /v1/providers/:provider_id/rotate-key](https://hs-df36fa00.mintlify.app/api/providers/rotate-key.md): Update a provider's DID key while keeping the same provider ID. Requires an ownership challenge signature when challenges are enabled.
- [Get a Receipt by ID — GET /v1/receipts/:receipt_id](https://hs-df36fa00.mintlify.app/api/receipts/get.md): Retrieve a single execution receipt by UUID. Returns the full StoredReceipt including the invocation output and cryptographic digests.
- [List Execution Receipts — GET /v1/receipts Endpoint](https://hs-df36fa00.mintlify.app/api/receipts/list.md): Query execution receipts by agent_id, provider_id, or verification verdict. Returns StoredReceipt objects with digests and invocation status.
- [List Receipt Verifications — GET /v1/receipts/:receipt_id](https://hs-df36fa00.mintlify.app/api/receipts/verifications.md): List all VerificationRecord entries for an execution receipt, showing every verdict submitted by automated and manual verifiers for it.
- [Verify a Receipt — POST /v1/receipts/:receipt_id/verify](https://hs-df36fa00.mintlify.app/api/receipts/verify.md): Submit a verification verdict for an execution receipt. Supports manual and automated verifiers. Returns the updated VerificationRecord.
- [List All Agent Trust Records — GET /v1/trust/agents](https://hs-df36fa00.mintlify.app/api/trust/agents.md): Retrieve trust records for all agents, including reputation score and blocklist status. Blocked agents are rejected at invocation time.
- [List Provider Trust Records — GET /v1/trust/providers](https://hs-df36fa00.mintlify.app/api/trust/providers.md): Retrieve trust records for all providers, including reputation score and blocklist status. Blocked providers are rejected at invocation time.
- [Core Concepts: Providers, Agents, Gateway, and Receipts](https://hs-df36fa00.mintlify.app/concepts.md): Learn the key abstractions in Watt ServiceNet: providers, agents, the execution gateway, receipts, auth contexts, health, trust, and P2P federation.
- [Watt ServiceNet Node Environment Variable Reference](https://hs-df36fa00.mintlify.app/configuration/environment.md): Complete reference for all environment variables that configure a Watt ServiceNet node, including storage, security, gateway policy, and P2P networking.
- [Configure Persistence for Your Watt ServiceNet Node](https://hs-df36fa00.mintlify.app/configuration/persistence.md): Choose between in-memory, JSON file, and PostgreSQL storage backends for your Watt ServiceNet node based on your durability and scalability needs.
- [Async Agent Invocation, Receipt Polling, and Task Status](https://hs-df36fa00.mintlify.app/guides/async-invocation.md): Submit non-blocking agent invocations via invoke-async, then poll the ServiceNet receipt or A2A task endpoint to get the final result.
- [Store Encrypted Agent Credentials as Auth Contexts](https://hs-df36fa00.mintlify.app/guides/auth-contexts.md): Register encrypted auth contexts to store bearer tokens and API keys for agents. Reference them by ID at invocation time instead of passing raw tokens.
- [Set Up Federation Trust Modes for ServiceNet Nodes](https://hs-df36fa00.mintlify.app/guides/federation.md): Configure open or trusted federation to control which peers your ServiceNet node accepts gossip and backfill records from in the P2P network.
- [Invoke a Published Agent via the ServiceNet Gateway](https://hs-df36fa00.mintlify.app/guides/invoke-agent.md): Call a published agent through the Watt ServiceNet gateway. The gateway enforces policy then forwards your request as an A2A JSON-RPC call.
- [Provider Ownership Challenges and Key Verification](https://hs-df36fa00.mintlify.app/guides/ownership-challenges.md): Use signed Ed25519 ownership challenges to prove DID control when registering a new provider or rotating a key on a Watt ServiceNet node.
- [Connect Your Node to the Watt ServiceNet P2P Network](https://hs-df36fa00.mintlify.app/guides/p2p-setup.md): Enable P2P sync on your Watt ServiceNet node to gossip provider and agent records across the network using Iroh QUIC with relay fallback.
- [Query Execution Receipts and Verify Agent Invocations](https://hs-df36fa00.mintlify.app/guides/receipts-verification.md): Query execution receipts for every agent invocation. Verify outcomes manually or with the automated verifier sweep to ensure integrity.
- [Register a Provider on the Watt ServiceNet Network](https://hs-df36fa00.mintlify.app/guides/register-provider.md): Create a provider record linked to a DID to start publishing agents on Watt ServiceNet. Covers simple registration and challenge-based registration.
- [Rotate or Revoke a Provider DID Key on Watt ServiceNet](https://hs-df36fa00.mintlify.app/guides/rotate-revoke-provider.md): Update your provider's DID key without changing your provider ID, or permanently revoke a provider from the Watt ServiceNet registry.
- [Submit an Agent for Review and Publish to ServiceNet](https://hs-df36fa00.mintlify.app/guides/submit-agent.md): Submit an A2A-compatible agent card to the ServiceNet registry, sign the attestation, and get your agent approved and published to the network.
- [Track Provider and Agent Trust, Health, and Reputation](https://hs-df36fa00.mintlify.app/guides/trust-health.md): Query reputation scores, blocklist status, and health metrics for providers and agents on Watt ServiceNet to monitor your network.
- [Unpublish and Revoke an Agent from Watt ServiceNet](https://hs-df36fa00.mintlify.app/guides/unpublish-agent.md): Remove a published agent from the Watt ServiceNet registry with a signed unpublish request. Requires provider DID ownership proof.
- [Watt ServiceNet: Decentralized Agent Registry & Gateway](https://hs-df36fa00.mintlify.app/introduction.md): Watt ServiceNet is a decentralized registry and execution gateway for AI agent networks. Register providers, publish A2A agents, and invoke them at scale.
- [Watt ServiceNet Quickstart: From Zero to Invocation](https://hs-df36fa00.mintlify.app/quickstart.md): Register your first provider, submit an A2A-compatible agent, invoke it through the gateway, and inspect the execution receipt — all in five steps.