Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -43,22 +43,26 @@ where ``token_id`` is a ``TokenIdU64`` (8 bytes, little-endian). The ``@concordi

.. note::

**Registry contracts (mainnet):** CIS-8004 Agent Registry ``<10082,0>``, CIS-8 External Key Registry ``<10081,0>``. A badge that parses to any other contract is not a Concordium Badge.
**Registry contracts.** :doc:`CIS-8004 <cis-8004>` and :doc:`CIS-8 <cis-8>` are open standards. Concordium operates the official registries — on mainnet, the CIS-8004 Agent Registry ``<10082,0>`` and the CIS-8 External Key Registry ``<10081,0>`` — but a badge is a Concordium Badge whenever its contract *implements the CIS-8004 standard*, not only when it resolves to the official instance. Each badge's ``contracts`` block names the specific contracts it resolves against, and a verifier decides which registries it trusts.

Resolve and verify a badge
==========================

Verification is trustless: given only the badge string, any party can verify it independently, without trusting whoever presented it.

.. note::

**Zero-setup path.** A badge embedded in an Agent Card may advertise a ``verification`` block (defined under **Embed the badge**, below) that points at a hosted resolver. A consumer that has never used Concordium can then verify from the card alone — ``GET`` the ``verifyUrl`` and read the verdict — without first discovering which node, resolver, or MCP endpoint to call. The steps below are what that resolver runs, and what a consumer verifying directly against the chain performs itself.

#. **Parse** the Base58Check string into ``(contract, token_id)``. *(MCP tool: ``parse_token_address``)*

#. **Confirm the contract** is the expected CIS-8004 registry for the network (mainnet ``<10082,0>``).
#. **Confirm the contract** implements CIS-8004 and is a registry your application trusts. Concordium's official mainnet registry is ``<10082,0>``.

#. **Resolve on-chain** with the CIS-8004 ``agent_of(token_id)`` query, which returns the owner account, agent wallet, status, ``agent_uri``, and ``metadata_hash``. Require ``status = "Active"``. *(MCP tools: ``agent_by_token_address`` / ``agent_of``)*

#. **Check card integrity.** Fetch the Agent Card at ``agent_uri``, compute the SHA-256 hash of its canonical bytes, and require that it equals the on-chain ``metadata_hash``. The published card cannot be swapped without the chain revealing a mismatch. *(MCP tool: ``verify_agent_card``)*

#. **(Optional)** Confirm the agent's platform handle via its CIS-10 assertion, and/or an external cryptographic key bound to the agent via :doc:`CIS-8 <cis-8>`.
#. **(Optional)** Confirm an external cryptographic key bound to the agent via :doc:`CIS-8 <cis-8>`.

A passing check proves that the agent is registered in the Agent Registry, is currently active, is owned by an accountable Concordium account, and that its published card is exactly the one committed on-chain. The trust root is Concordium — not the party presenting the badge.

Expand All @@ -78,9 +82,34 @@ Add a ``concordium`` block to the :doc:`Agent Card <agent-card>`:
"chain": "ccd:9dd9ca4d19e9393877d2c44b70f89acb",
"owner": { "account": "<account>", "caip10": "ccd:9dd9ca4d…:<account>" },
"contracts": { "cis8004": "10082,0", "cis8": "10081,0" },
"verify": "Resolve tokenAddress via CIS-8004 agent_of; confirm owner + status=Active + card SHA-256 == metadata_hash."
"verify": "Resolve tokenAddress via CIS-8004 agent_of; confirm owner + status=Active + card SHA-256 == metadata_hash.",
"verification": {
"service": "Concordium Agent Registry",
"verifyUrl": "https://agent-registry-mcp.concordium.com/v1/badge-check/<account>",
"mcp": "https://agent-registry-mcp.concordium.com/mcp",
"docs": "https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/concordium-badge.html"
}
}

The ``verify`` string names the steps; the optional ``verification`` block names **where to run them** — ``service``, ``verifyUrl``, ``mcp``, and ``docs``. Together they make a badge *self-resolving*: a consumer that has never seen Concordium can verify it from the card alone. The values below are Concordium's official Agent Registry service, shown as an example — the block is **not limited to them**. Any issuer may point these fields at a different service that runs the same checks, and any party may ignore the hints entirely and resolve directly against the contracts in ``contracts``.

.. list-table::
:header-rows: 1
:widths: 20 80

* - Field
- Purpose
* - ``service``
- Human-readable name of the resolver / registry service.
* - ``verifyUrl``
- REST endpoint — the owner account's badge check — returning a JSON verdict for each of the account's badges, including this one (owner, ``status``, and card-hash match). One ``GET``, no MCP client, SDK, or node access required.
* - ``mcp``
- MCP endpoint for agents that speak the Model Context Protocol; they can call ``verify_agent_card`` / ``agent_by_token_address`` directly.
* - ``docs``
- This specification, for a consumer that prefers to verify manually against the chain.

A service named here is a convenience, not an authority — it returns chain-derived data the consumer can re-check against the contracts in the badge. Issuers point these fields at whichever hosted verification service — resolver and :doc:`MCP <mcp-service>` — they operate or trust. Discovery and enumeration (finding agents you don't already have a badge for) is a separate concern handled by the :doc:`Indexer <indexer>`, not the badge.

Profile or bio
--------------

Expand Down Expand Up @@ -109,21 +138,6 @@ The badge introduces no new standard. It composes:
- :doc:`CIS-8 <cis-8>` — external key binding
- :doc:`Agent Card <agent-card>` — the agent's published metadata document

Worked example (mainnet)
========================

.. code-block:: text

Badge: Mf22soLh1NuZYFgBK8iSs
parse → contract 10082,0 · token_id 484 (hex e401000000000000)
agent_of→ owner 4DDvjwdcLmTy1Ar9FCKKPMiABrS261TvyXJGr4n4ypuuogXeFF
status Active (registered 2026-06-17)
card https://…/.well-known/agent-card.json
hash 1253bd8fa1618f6b5fd2ff741cc8f4d60a0e6ac0f8ea5f32640c71540001e0d0
CAIP-19 → ccd:9dd9ca4d19e9393877d2c44b70f89acb/cis-2:Mf22soLh1NuZYFgBK8iSs

Fetch the card, compute its SHA-256, and confirm it equals ``1253bd8f…`` — the badge is verified end-to-end.

Tooling
=======

Expand Down
Loading