Discovery

Seller manifest

Call this before paying a seller. Returns the ServiceListing the seller also publishes to the HCS registry: its HCS-14 identity (uaid), the account that receives payments (payTo), the facilitator that settles, and every sellable endpoint with its pricing model per accepted asset. Free, unauthenticated, cached publicly for 60 seconds. A buyer that discovered the seller through the registry should compare this document with the on-chain listing; an audit attestation covers the hash of payTo, baseUrl, quotePath, facilitator and endpoints, so any change here invalidates it.

GET

.well-known

agora402.json

Seller manifest

curl --request GET \
  --url http://localhost:4402/.well-known/agora402.json

{
  "uaid": "uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402",
  "name": "agora-demo-seller",
  "version": "1.0.0",
  "payTo": "0.0.5001234",
  "baseUrl": "http://localhost:4402",
  "quotePath": "/a2a/quote",
  "facilitator": "https://api.testnet.blocky402.com",
  "receiptsTopicId": "0.0.6009999",
  "publishedAt": "2026-09-13T09:00:00.000Z",
  "endpoints": [
    {
      "id": "infer",
      "method": "POST",
      "path": "/v1/infer",
      "description": "LLM chat completion (OpenAI-compatible body). Metered: base fee + per 1k input tokens + per 1k budgeted output tokens.",
      "skills": [
        0
      ],
      "accepts": [
        {
          "network": "hedera:testnet",
          "asset": "0.0.0",
          "symbol": "HBAR",
          "decimals": 8,
          "pricing": {
            "kind": "per-token",
            "base": "50000",
            "inputPer1k": "20000",
            "outputPer1k": "60000"
          }
        }
      ]
    },
    {
      "id": "hbar-rate",
      "method": "GET",
      "path": "/v1/rates/hbar",
      "description": "Live HBAR/USD exchange rate from the Hedera network rate file, with consensus expiry. Priced per query.",
      "skills": [
        20
      ],
      "accepts": [
        {
          "network": "hedera:testnet",
          "asset": "0.0.0",
          "symbol": "HBAR",
          "decimals": 8,
          "pricing": {
            "kind": "per-unit",
            "unit": "query",
            "amountPerUnit": "10000"
          }
        }
      ]
    }
  ]
}

Response

200 - application/json

The seller's ServiceListing

What a seller publishes to the registry topic and serves as its manifest

uaid

string

required

HCS-14 universal agent id

Pattern: ^uaid:

Example:

"uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402"

name

string

required

version

string

required

payTo

string

required

Account that receives payments

Pattern: ^\d+\.\d+\.\d+$

Example:

"0.0.5001234"

baseUrl

string<uri>

required

facilitator

string<uri>

required

Blocky402 facilitator that verifies and settles

endpoints

object[]

required

Minimum array length: 1

Show child attributes

publishedAt

string<date-time>

required

quotePath

string

default:/a2a/quote

A2A-style quote endpoint, relative to baseUrl

receiptsTopicId

string

HCS topic where the seller writes receipts; absent when receipts stay in memory

Pattern: ^\d+\.\d+\.\d+$

Example:

"0.0.5001234"

⌘I

Seller manifest

curl --request GET \
  --url http://localhost:4402/.well-known/agora402.json

{
  "uaid": "uaid:aid:2NEpo7TZRRrLZSi2U;uid=agora-demo-seller;registry=agora402;proto=a2a;nativeId=hedera:testnet:0.0.5001234;domain=localhost:4402",
  "name": "agora-demo-seller",
  "version": "1.0.0",
  "payTo": "0.0.5001234",
  "baseUrl": "http://localhost:4402",
  "quotePath": "/a2a/quote",
  "facilitator": "https://api.testnet.blocky402.com",
  "receiptsTopicId": "0.0.6009999",
  "publishedAt": "2026-09-13T09:00:00.000Z",
  "endpoints": [
    {
      "id": "infer",
      "method": "POST",
      "path": "/v1/infer",
      "description": "LLM chat completion (OpenAI-compatible body). Metered: base fee + per 1k input tokens + per 1k budgeted output tokens.",
      "skills": [
        0
      ],
      "accepts": [
        {
          "network": "hedera:testnet",
          "asset": "0.0.0",
          "symbol": "HBAR",
          "decimals": 8,
          "pricing": {
            "kind": "per-token",
            "base": "50000",
            "inputPer1k": "20000",
            "outputPer1k": "60000"
          }
        }
      ]
    },
    {
      "id": "hbar-rate",
      "method": "GET",
      "path": "/v1/rates/hbar",
      "description": "Live HBAR/USD exchange rate from the Hedera network rate file, with consensus expiry. Priced per query.",
      "skills": [
        20
      ],
      "accepts": [
        {
          "network": "hedera:testnet",
          "asset": "0.0.0",
          "symbol": "HBAR",
          "decimals": 8,
          "pricing": {
            "kind": "per-unit",
            "unit": "query",
            "amountPerUnit": "10000"
          }
        }
      ]
    }
  ]
}

Overview

Discovery

Negotiation

Paid services

Trust

Receipts

SDK reference

Seller manifest

Response