Skip to content
Merged
Show file tree
Hide file tree
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
4 changes: 2 additions & 2 deletions public/llms.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Concordium Developer Documentation

> Technical documentation for developers building on, integrating with, or operating the Concordium blockchain. Concordium is a public, permissionless Layer 1 blockchain with a built-in identity layer, fast finality, and smart contract support.
> Technical documentation for developers building on, integrating with, or operating Concordium. Concordium is an AI infrastructure for the agentic economy, powered by a public, permissionless Layer-1 blockchain with identity and trust built into the protocol.

The documentation is organized into four sections following the Diátaxis framework: Explore (concepts), Tutorials (learning by doing), How-to (task guides), and Reference (technical look-up material).

Expand Down Expand Up @@ -65,7 +65,7 @@ On-chain identity and discovery for AI agents.
- [CIS-8004: Agent Registry standard](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/cis-8004.html): CIS-8004 contract specification — token model, entrypoints, and external references
- [CIS-8: External Key Registry standard](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/cis-8.html): CIS-8 contract specification — cross-chain key bindings and proof schemes
- [Agent Card format](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/agent-card.html): Agent Card JSON structure, Concordium extension block, and card verification
- [Concordium Badge](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/concordium-badge.html): Badge string format (token address, CAIP-19), trustless resolution and verification, and embedding guidance
- [Verified by Concordium badge](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/concordium-badge.html): Badge string format (token address, CAIP-19), trustless resolution and verification, and embedding guidance
- [MCP service](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/mcp-service.html): Model Context Protocol server — hosted endpoint, local setup, and all available tools
- [Indexer](https://docs.concordium.com/en/mainnet/technical-reference/agent-registry/indexer.html): Event indexer for agent discovery — setup, REST API, and sync state

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The demand for reliable user verification is rapidly intensifying across various

Zero-knowledge proofs resolve these issues. A zero-knowledge proof (ZKP) is a cryptographic method that allows one party (the "prover") to prove to another party (the "verifier") that a statement is true, without revealing any information beyond the validity of the statement itself. In the context of ID verification, a user can prove they are over 18 without ever disclosing their actual date of birth. This enables robust, verifiable identity checks that eliminate the need to store sensitive data and fully preserve user privacy.

Concordium is a science-backed, public, and permissionless Layer-1 blockchain designed to meet the needs of modern businesses. It uniquely balances user privacy with regulatory accountability through a built-in identity layer at the protocol level. This core feature establishes a trusted, secure, and compliant environment, allowing developers, users, and enterprises to build and transact with confidence on a platform that is both fast and cost-effective.
Concordium is an AI infrastructure for the agentic economy, powered by a public, permissionless Layer-1 blockchain with an identity layer at the protocol level. It uniquely balances user privacy with regulatory accountability through a built-in identity layer at the protocol level. This core feature establishes a trusted, secure, and compliant environment, allowing developers, users, and enterprises to build and transact with confidence on a platform that is both fast and cost-effective.

Concordium ZKP key features
===========================
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ This guide covers the technical requirements for integrating Concordium blockcha
Integration overview
====================

Concordium is a Layer-1 :term:`proof-of-stake` blockchain with a built-in :ref:`identity layer<reference-identity>` at protocol level balancing user privacy with regulatory compliance. The platform supports multiple transaction types, offers native staking and :term:`delegation` functionality, and uses an efficient gRPC-based node communication protocol.
Concordium is an AI infrastructure for the agentic economy, powered by a public, permissionless Layer-1 blockchain with an identity layer at the protocol level. The platform supports multiple transaction types, offers native staking and :term:`delegation` functionality, and uses an efficient gRPC-based node communication protocol.

Integrating Concordium involves implementing support for several protocol-specific features:

Expand Down
4 changes: 3 additions & 1 deletion source/mainnet/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@
Developer Documentation
=======================

Concordium is a public, permissionless Layer 1 blockchain with a built-in identity layer. It provides fast, affordable transactions with smart contract support, and a unique approach to regulatory compliance through verified identities.
Concordium is an AI infrastructure for the agentic economy, powered by a purpose-built, regulatory-grade blockchain with identity and trust built into the protocol.

The blockchain behind it is a public, permissionless Layer-1 with an identity layer at the protocol level. Every account, whether it belongs to a person, a business, or an autonomous AI agent, is created from a verified real-world identity. It provides fast, affordable transactions with smart contract support and a unique approach to regulatory compliance through verified identities.

Find technical documentation here for every stage — evaluating, building, integrating, and operating Concordium. If you want to know more about how this documentation is organized and how to find what you need, see :doc:`Navigate this documentation <how-to/navigate-docs>`.

Expand Down
16 changes: 14 additions & 2 deletions source/mainnet/learn/concordium-protocol.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,11 @@
What is the Concordium Protocol
===============================

Concordium is a public and permissionless blockchain platform designed for both business applications and public use. It combines privacy-preserving features with regulatory compliance, fast transaction processing, and cost-effective operations.
Concordium is an AI infrastructure for the agentic economy, powered by a purpose-built, regulatory-grade blockchain with identity and trust built into the protocol.

The blockchain behind it is a public, permissionless Layer-1 with an identity layer at the protocol level. Every account, whether it belongs to a person, a business, or an autonomous AI agent, is created from a verified real-world identity, while on-chain activity remains private. Transactions finalize in seconds, costs are stable in Euro terms, and smart contracts run on WebAssembly and are written in Rust.

Founded in 2018 and backed by leading cryptographers, Concordium is powered by a non-profit Foundation based in Switzerland.

Core features
=============
Expand All @@ -15,6 +19,14 @@ Identity layer
--------------
Concordium provides a new solution to blockchain privacy through its identity layer. When users create an account, they first verify their identity with an authorized :term:`identity provider`. On the blockchain, their transactions remain private, but their identity can be revealed through a regulated legal process if required by authorities.

Verified agents
---------------
The same identity layer applies to autonomous software. An AI agent can be registered through the :doc:`Agent Registry <../technical-reference/agent-registry/index>`, where it is minted as a non-fungible CIS-2 token under the :doc:`CIS-8004 standard <../technical-reference/agent-registry/cis-8004>`. That token is the agent's stable on-chain identity: discoverable, transferable, and, combined with Concordium's ID layer, linked to a verified human or business owner. A counterparty can establish who stands behind an agent before transacting with it.

Each agent carries a :doc:`Verified by Concordium badge <../technical-reference/agent-registry/concordium-badge>`, a compact identifier anyone can check against the chain to confirm the agent's owner, its active status, and an integrity-checked :doc:`Agent Card <../technical-reference/agent-registry/agent-card>` describing its capabilities and endpoints. CIS-8004 is compatible with ERC-8004, and the :doc:`CIS-8 External Key Registry <../technical-reference/agent-registry/cis-8>` binds Concordium accounts to keys from Ethereum, Solana, Cosmos, and other chains, so an agent stays attributable from outside the Concordium ecosystem.

See :doc:`Agent Registry <../technical-reference/agent-registry/index>` for the standards, data formats, and services.

Fast and final transactions
---------------------------
The Concordium blockchain confirms transactions within seconds. Once confirmed, these transactions cannot be reversed. This is achieved through a :term:`proof-of-stake<Proof-of-stake>` consensus mechanism called :term:`ConcordiumBFT<Concordium Byzantine Fault Tolerance (BFT) protocol>`, where :term:`validators<validator>` who stake :term:`CCD` tokens help secure and maintain the network.
Expand All @@ -38,7 +50,7 @@ The consensus layer ensures all nodes agree on the state of the blockchain using
Identity layer
--------------
The identity layer manages user verification and privacy. It works with external identity providers who verify users' real-world identities. This information is stored securely off-chain, while on-chain transactions maintain user privacy. Only through a regulated process involving multiple authorities can identities be revealed.
At no point does Concordium see or hold any identiy information about its users, nor does the identity provider know which accounts are opened by which users.
At no point does Concordium see or hold any identity information about its users, nor does the identity provider know which accounts are opened by which users.

Execution layer
---------------
Expand Down
5 changes: 5 additions & 0 deletions source/mainnet/learn/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ Understand how Concordium works. Browse all topics below, grouped by theme, or u

- :doc:`What is the Concordium Protocol <concordium-protocol>`

**Agents**

- :doc:`Agent Registry <../technical-reference/agent-registry/index>`

**Identity**

- :doc:`Identity <identity/index>`
Expand Down Expand Up @@ -79,6 +83,7 @@ Understand how Concordium works. Browse all topics below, grouped by theme, or u
:hidden:

What is the Concordium Protocol <concordium-protocol>
Agent Registry <../technical-reference/agent-registry/index>
Identity <identity/index>
Accounts <accounts/index>
Transactions <transactions/index>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
.. include:: ../../variables.rst
.. _concordium-badge:

================
Concordium Badge
================
============================
Verified by Concordium badge
============================

A Concordium Badge is the compact, verifiable identifier showing that an agent has a live on-chain identity in the :ref:`Agent Registry <agent-registry-reference>`. The badge is the agent's :doc:`CIS-8004 <cis-8004>` NFT **token address** — anyone can resolve it against the chain to confirm the agent's owner, its active status, and an integrity-checked :doc:`Agent Card <agent-card>`.
A Verified by Concordium badge is the compact, verifiable identifier showing that an agent has a live on-chain identity in the :ref:`Agent Registry <agent-registry-reference>`. The badge string is the agent's :doc:`CIS-8004 <cis-8004>` NFT **token address** — anyone can resolve it against the chain to confirm the agent's owner, its active status, and an integrity-checked :doc:`Agent Card <agent-card>`.

The badge is **not a new contract or token type**. It is a naming and resolution convention layered over existing Concordium standards, so adopting it requires no new deployment.

Expand Down Expand Up @@ -43,7 +43,7 @@ where ``token_id`` is a ``TokenIdU64`` (8 bytes, little-endian). The ``@concordi

.. note::

**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.
**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 qualifies as a Verified by 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
==========================
Expand Down Expand Up @@ -115,13 +115,13 @@ Profile or bio

.. code-block:: text

Concordium Badge: Mf22soLh1NuZYFgBK8iSs
Badge string: Mf22soLh1NuZYFgBK8iSs
Agent Card: https://…/.well-known/agent-card.json

Visual mark
===========

The human-facing badge is the official **"Verified by Concordium"** logomark from the Concordium Agent Registry brand kit. It should link to the resolved badge — the agent's registry or explorer entry.
The human-facing visual is the official **Verified by Concordium logomark** from the Concordium Agent Registry brand kit. It should link to the resolved badge — the agent's registry or explorer entry.

.. warning::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Reference documentation for the Concordium Agent Registry — a suite of on-chai
**Data formats**

- :doc:`Agent Card <agent-card>`
- :doc:`Concordium Badge <concordium-badge>`
- :doc:`Verified by Concordium badge <concordium-badge>`

.. grid-item::

Expand Down
4 changes: 2 additions & 2 deletions source/mainnet/technical-reference/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Reference documentation for Concordium APIs, SDKs, command-line tools, smart con
- :doc:`CIS-8: External Key Registry <agent-registry/cis-8>`
- :doc:`CIS-8004: Agent Registry <agent-registry/cis-8004>`
- :doc:`Agent Card <agent-registry/agent-card>`
- :doc:`Concordium Badge <agent-registry/concordium-badge>`
- :doc:`Verified by Concordium badge <agent-registry/concordium-badge>`
- :doc:`MCP service <agent-registry/mcp-service>`
- :doc:`Indexer <agent-registry/indexer>`

Expand Down Expand Up @@ -127,7 +127,7 @@ Reference documentation for Concordium APIs, SDKs, command-line tools, smart con
CIS-8: External Key Registry <agent-registry/cis-8>
CIS-8004: Agent Registry <agent-registry/cis-8004>
Agent Card <agent-registry/agent-card>
Concordium Badge <agent-registry/concordium-badge>
Verified by Concordium badge <agent-registry/concordium-badge>
MCP service <agent-registry/mcp-service>
Indexer <agent-registry/indexer>

Expand Down
2 changes: 1 addition & 1 deletion source/mainnet/tutorials/using-ID-in-dApps/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Using ID in dApps

In this tutorial, you'll learn how to integrate Concordium's browser and mobile wallets into a React-based decentralized application (dApp), and generate zero-knowledge (ZK) proofs.

Concordium is an identity-based blockchain with a unique approach to balancing privacy and compliance. Through wallets, users can generate zero-knowledge proofs and selectively disclose identity attributes on their accounts like nationality, age, etc., instead of sharing the entire ID information.
Concordium is an AI infrastructure for the agentic economy, powered by a public, permissionless Layer-1 blockchain with an identity layer at the protocol level. Through wallets, users can generate zero-knowledge proofs and selectively disclose identity attributes on their accounts like nationality, age, etc., instead of sharing the entire ID information.

Concordium wallets serve a unique dual purpose compared to wallets on other blockchains. They not only hold :ref:`accounts <managing_accounts>` (blockchain addresses) but also manage :ref:`identities <reference-identity>`.
Users first create an identity in their wallet by completing a verification process with an :term:`identity provider` (using a passport or ID card). Then, they can create on-chain accounts through a :ref:`transaction <transactions>` that associates each account with their verified identity.
Expand Down
Loading