getmodelregistrationstatus

workflowrun-a-miner·step 3 of 6Workflow: run-a-miner · step 3 of 6

getmodelregistrationstatus "model_has Query the registration status of Arguments: 1. model_hash (string, required) Result: { "model_hash" : "str", "status" : "str", "deposit_txid" : "str", "deposit_vout" : n, "deposit_block_hash" : "str", "deposit_block_height" : n, "deposit_unspent" : true|false, "commit_txid" : "str", "commit_block_hash" : "str", "commit_block_height" : n, "verification_code" : n, "verification_details" : "str", "burn_txid" : "str", "burn_vout" : n, "burn_block_height" : n, "deposit_unlock_height" : n, "owner_reclaim_allowed" : true|false, "burn_allowed_height" : n, "burn_ready" : true|false, "successful_commit_count" : n, "verification_event_height" : n, "challenge_block_hash" : "str", "challenge_deposit_txid" "challenge_deposit_vout" : n, "challenge_deposit_height" : n, "challenge_verdict_height" : n, "challenge_commit_count" : n } Examples: > bitcoin-cli getmodelregistrationstatus h" a model hash. Model hash (json object) Model status information (string) Model hash (string) Registration status (string) Deposit transaction id (numeric) Deposit output index (string) Block hash where the deposit confirmed (numeric) Block height where the deposit confirmed (boolean) Whether the deposit output is still unspent in chainstate (string) Commit transaction id (if any) (string) Block hash where the commit confirmed (numeric) Block height where the commit confirmed (numeric) Verification result code (string) Optional verification details (string) Burn transaction id (numeric) Burn output index (numeric) Block height where the burn confirmed (numeric) Block height where owner reclaim becomes allowed (boolean) Whether the owner may reclaim the deposit now (numeric) Block height where the burn allowed (boolean) Burn could be realized flag (numeric) Number of successful commit transactions confirmed on-chain (numeric) Height at which the verification window closes (0 if not scheduled) (string) Block hash being challenged (zero if none) : "str", (string) Challenge deposit transaction id (numeric) Challenge deposit output index (numeric) Block height of the challenge deposit (numeric) Scheduled height for challenge verdict (0 if none) (numeric) Number of challenge commit transactions observed "<model_hash>"

Signature

getmodelregistrationstatus(model_hash: string) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getmodelregistrationstatus","params":["\"<model_hash>\""]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli getmodelregistrationstatus "<model_hash>"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getmodelregistrationstatus",
        "params": ["\"<model_hash>\""],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getmodelregistrationstatus",
    params: ["\"<model_hash>\""],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
model_hash	`string`	yes	Model hash

Result

Type: any

{ (json object) Model status information "model_hash" : "str", (string) Model hash "status" : "str", (string) Registration status "deposit_txid" : "str", (string) Deposit transaction id "deposit_vout" : n, (numeric) Deposit output index "deposit_block_hash" : "str", (string) Block hash where the deposit confirmed "deposit_block_height" : n, (numeric) Block height where the deposit confirmed "deposit_unspent" : true|false, (boolean) Whether the deposit output is still unspent in chainstate "commit_txid" : "str", (string) Commit transaction id (if any) "commit_block_hash" : "str", (string) Block hash where the commit confirmed "commit_block_height" : n, (numeric) Block height where the commit confirmed "verification_code" : n, (numeric) Verification result code "verification_details" : "str", (string) Optional verification details "burn_txid" : "str", (string) Burn transaction id "burn_vout" : n, (numeric) Burn output index "burn_block_height" : n, (numeric) Block height where the burn confirmed "deposit_unlock_height" : n, (numeric) Block height where owner reclaim becomes allowed "owner_reclaim_allowed" : true|false, (boolean) Whether the owner may reclaim the deposit now "burn_allowed_height" : n, (numeric) Block height where the burn allowed "burn_ready" : true|false, (boolean) Burn could be realized flag "successful_commit_count" : n, (numeric) Number of successful commit transactions confirmed on-chain "verification_event_height" : n, (numeric) Height at which the verification window closes (0 if not scheduled) "challenge_block_hash" : "str", (string) Block hash being challenged (zero if none) "challenge_deposit_txid" : "str", (string) Challenge deposit transaction id "challenge_deposit_vout" : n, (numeric) Challenge deposit output index "challenge_deposit_height" : n, (numeric) Block height of the challenge deposit "challenge_verdict_height" : n, (numeric) Scheduled height for challenge verdict (0 if none) "challenge_commit_count" : n (numeric) Number of challenge commit transactions observed }

Source: services/core-node/bcore/src/wallet/rpc/transactions.cpp:2579

C++ symbol: getmodelregistrationstatus

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getmodelregistrationstatus","params":["\"<model_hash>\""]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli getmodelregistrationstatus "<model_hash>"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getmodelregistrationstatus",
        "params": ["\"<model_hash>\""],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getmodelregistrationstatus",
    params: ["\"<model_hash>\""],
  }),
});
console.log(await res.json());