H-Series
Manage your directory

API documentation

Base URL: https://h-cert.xr-utilities.ai

H-Cert is an owner-signed principal directory and a behavior-backed standing layer. An owner names a grantee, signs the delegation as EIP-712 typed data, and H-Cert verifies the signature before anchoring a salted commitment of both identities to a Hedera topic. Directory and standing reads are free; the label and salts stay off chain.

What H-Cert does

An owner connects an EVM wallet and names a principal: a subject identity, a claim (operated-by or trusted), scopes, and a private label. The owner signs the delegation as EIP-712. H-Cert verifies the signature against the owner, then anchors a commitment (a hash of each identity with a per-record salt, never the raw identifier) on Hedera Consensus Service. The public record proves a vouch is owner-signed and intact without revealing who is named. An owner reads their resolved roster through an authenticated view, and can hand an auditor the identity and salt to reproduce any commitment keylessly.

Alongside each vouch, H-Cert joins a behavior-backed standing for the subject, computed from how it has actually acted across the H-Series. Risk events emitted by H-Grant, H-Gate, H-Relay, H-Scope, and H-Agent (carried on the shared audit topic and read through H-Index), together with H-Seal receipts and H-Scope posture, fold into a decayed risk load that lowers the standing tier while risk is recent and recovers as it decays. It is fail-soft and can only cap a subject down, at most to suspended, never revoke. The standing is advisory: a consumer such as H-Grant or H-Pact resolves your directory and gates on the standing tier at its own trust boundary; H-Cert itself never blocks a call.

The Agent Track Record card is the free, public read of this standing: a subject's current tier and the behavior behind it. It is a record of observed behavior, not a score, rating, or verdict.

GET /config

Returns the service configuration: the ruleset version, the standing topic ID, the read mode, the operator key metadata, and whether anchoring is enabled.

Response 200
{
  "rulesetVersion": "standing-v1.0.0",
  "standingTopicId": "0.0.10601816",
  "readMode": "http",
  "operatorKeyId": "h-cert-op-1",
  "operatorPublicKey": "MCowBQYDK2Vw...",
  "operatorKeyStable": true,
  "anchoring": true,
  "store": "postgres"
}

Authentication

EIP-712 delegation signing

A delegation is signed by the owner as EIP-712 typed data. v1 accepts eip155 (EVM) owners; the other wallet namespaces and the OIDC owner bridge are wired to fail closed until they are enabled. H-Cert verifies the signature against the owner before anything is stored, so authorship is cryptographic rather than trust-based. Revocation is likewise owner-signed and terminal.

On-chain commitments

Every vouch and revocation is anchored to the standing topic as a salted commitment. Anyone replaying the topic can verify each record is owner-signed and intact, never the identities. A fresh salt per record stops correlation of the same identity across vouches from the public record alone.

MCP tools

H-Cert is also exposed as MCP tools under the h_cert_* namespace via the shared H-Series MCP server at https://mcp.xr-utilities.ai/mcp. An agent can resolve a principal directory and read standing through the same tool surface it uses for the rest of the H-Series, without a separate client.