Sigil documentation
ReferenceJSON-RPC

sigil_getIdentity

Fetch an OAS identity document by DID.

Method

sigil_getIdentity is registered in the canonical JSON-RPC catalog. Use POST /rpc, Content-Type: application/json, JSON-RPC 2.0 and a caller-controlled request id. Node RPC profile, build feature and runtime activation checks still apply.

Fetch an OAS identity document by DID.

Request binding

Source handler: rpc_server::handle_get_identity in sigil/node/sigil-node/src/rpc_server.rs, line 2025.

The handler directly reads these named fields: did. Additional typed parsing, aliases and nested validation are defined by its request types. Field presence alone does not establish optionality.

Parsing excerpt

These source excerpts show binding and validation; they are not runnable client code.

    let did = match req.params.get("did").and_then(|v| v.as_str()) {
        Some(d) => d,
        None => return RpcResponse::error(req.id.clone(), -32602, "missing 'did' parameter"),
    };

Responses and failures

Check HTTP status, parse the JSON-RPC envelope, reject error, and require result on success. Preserve large base-unit integers without floating-point rounding. A catalog method does not bypass authentication, capability, policy or activation requirements.

On this page