did:solidus — DID Method Specification

The official specification of the did:solidus Decentralized Identifier method. did:solidus is anchored on the Solidus Network, a HotStuff-style Byzantine Fault Tolerant layer-1 blockchain implemented in Rust and purpose-built as a trust anchor for decentralized identity.

• Specification: SPEC.md — v0.1.0 (editor's draft)
• Reference implementation (Rust): https://github.com/solidusnetwork/protocol
• Reference SDK (TypeScript): @solidus-network/sdk
• Public testnet resolver: https://rpc.solidus.network (JSON-RPC method solidus_didResolve)
• W3C DID Method Registry submission: see w3c/did-extensions (pending)

DID at a glance

did:solidus:testnet:5dXc8vN3kzGm7p6L9HsQrR2hYfBaT1Wj
└─ did ─┘└ method ┘└ network ┘└──── identifier ────┘

• Network: testnet (production today) or mainnet (reserved for post-audit launch).
• Identifier: Base58 encoding of the first 20 bytes of BLAKE3-256 over the controller's 32-byte Ed25519 public key.
• DID Document: a first-class on-chain data type; stored in its own RocksDB column family (CF_DIDS) on every validator.
• Finality: single-block (~1–2 s).
• Operations: Create, Read (Resolve), Update (key rotation, controller reassignment, service edits), Deactivate.

Resolving a DID

curl -s -X POST https://rpc.solidus.network \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "solidus_didResolve",
    "params": ["did:solidus:testnet:5dXc8vN3kzGm7p6L9HsQrR2hYfBaT1Wj"]
  }'

Or via the TypeScript SDK:

import { createSdk } from '@solidus-network/sdk';

const sdk = createSdk({ mode: 'testnet' });
const { didDocument, didDocumentMetadata } =
  await sdk.did.resolveWithMetadata(
    'did:solidus:testnet:5dXc8vN3kzGm7p6L9HsQrR2hYfBaT1Wj',
  );

Versioning

This repository follows semantic versioning at the spec level. Breaking changes to the on-chain DID Document shape, the identifier syntax, or any normative requirement bump the major version. Additive, backward-compatible clarifications bump the minor version. The W3C DID Method Registry entry links to a tagged version of SPEC.md for content-integrity-protection.

Issues, feedback, and PRs

We welcome issue reports and pull requests on this repository. For normative concerns or interoperability questions, please file an issue before opening a PR. Implementer questions are best raised on the Solidus Network discussions board.

License

Specification text is licensed under CC BY 4.0. Code samples are licensed under MIT.

Contact

• Email: info@solidus.network
• Web: https://solidus.network