Sigil documentation
ReferenceJSON-RPC

sigil_getUsernameAuction

Fetch a premium-name auction by canonical name.

Method

sigil_getUsernameAuction 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 a premium-name auction by canonical name.

Request binding

Source handler: rpc_username::handle_get_username_auction in sigil/node/sigil-node/src/rpc_username.rs, line 163.

The handler uses no directly named params.get fields, or delegates input parsing to a typed helper. Use the request types below rather than assuming an empty parameter object.

Parsing excerpt

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

    let name = match extract_string_param(&req.params, 0, "name") {
        Some(n) => n,
        None => return RpcResponse::error(req.id.clone(), -32602, "missing 'name' 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