getassetregistry

getassetregistry "asset_id_or_ Query the asset registry for Returns the complete registry Arguments: 1. asset_id_or_ticker (string, Result: { "asset_id" : "hex", "policy_bits" : n, "allowed_spk_families" : n, "icu_txid" : "hex", "icu_vout" : n, "unlock_fees_sats" : n, "fees_accum_sats" : n, "ticker" : "str", "decimals" : n, "has_kyc" : true|false, "zk_vk_commitment" "max_root_age" : n, "tfr_flags" : n, "issued_total" : n, "burned_total" : n, "icu_flags" : n, "icu_visibility" : n, "policy_quorum_bps" : n, "issuance_cap_units" : n, "icu_ctxt_commit" "icu_plain_commit" "core_policy_commit" "policy_epoch" : n } Examples: > bitcoin-cli getassetregistry > bitcoin-cli getassetregistry ticker" detailed information about a specific asset. entry including ZK/ICU configuration and governance parameters. required) Asset identifier (hex) or ticker (json object) (string) Asset identifier (numeric) Policy flags (numeric) Allowed script families mask (string) Current ICU transaction ID (numeric) Current ICU output index (numeric) Unlock threshold in satoshis (numeric) Accumulated fees in satoshis (string, optional) Ticker symbol (numeric, optional) Display decimals (255=not set) (boolean) Whether ZK/KYC verification is enabled : "hex", (string, optional) ZK verification key commitment (numeric) Maximum merkle root age in seconds (numeric) Transfer restriction flags (numeric) Total units minted (numeric) Total units burned (numeric) ICU structural flags (numeric) ICU visibility (0=public, 1=holder_only) (numeric) Governance quorum in basis points (numeric) Maximum issuance cap in base units (0=unlimited) : "hex", (string) ICU ciphertext commitment : "hex", (string) ICU plaintext commitment : "hex", (string) Core policy immutability commitment (numeric) Policy version counter "a3f747562969280eb3ddc96ff57e3692b7b55611d8c89785f52fc2d1535d22b3" "GOLD"

Signature

getassetregistry(asset_id_or_ticker: string) → any

Code samples

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

bitcoin-cli getassetregistry "a3f747562969280eb3ddc96ff57e3692b7b55611d8c89785f52fc2d1535d22b3"

bitcoin-cli getassetregistry "GOLD"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getassetregistry",
        "params": ["\"<asset_id_or_ticker>\""],
    },
    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: "getassetregistry",
    params: ["\"<asset_id_or_ticker>\""],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
asset_id_or_ticker	`string`	yes	Asset identifier (hex) or ticker

Result

Type: any

{ (json object) "asset_id" : "hex", (string) Asset identifier "policy_bits" : n, (numeric) Policy flags "allowed_spk_families" : n, (numeric) Allowed script families mask "icu_txid" : "hex", (string) Current ICU transaction ID "icu_vout" : n, (numeric) Current ICU output index "unlock_fees_sats" : n, (numeric) Unlock threshold in satoshis "fees_accum_sats" : n, (numeric) Accumulated fees in satoshis "ticker" : "str", (string, optional) Ticker symbol "decimals" : n, (numeric, optional) Display decimals (255=not set) "has_kyc" : true|false, (boolean) Whether ZK/KYC verification is enabled "zk_vk_commitment" : "hex", (string, optional) ZK verification key commitment "max_root_age" : n, (numeric) Maximum merkle root age in seconds "tfr_flags" : n, (numeric) Transfer restriction flags "issued_total" : n, (numeric) Total units minted "burned_total" : n, (numeric) Total units burned "icu_flags" : n, (numeric) ICU structural flags "icu_visibility" : n, (numeric) ICU visibility (0=public, 1=holder_only) "policy_quorum_bps" : n, (numeric) Governance quorum in basis points "issuance_cap_units" : n, (numeric) Maximum issuance cap in base units (0=unlimited) "icu_ctxt_commit" : "hex", (string) ICU ciphertext commitment "icu_plain_commit" : "hex", (string) ICU plaintext commitment "core_policy_commit" : "hex", (string) Core policy immutability commitment "policy_epoch" : n (numeric) Policy version counter }

Source: services/core-node/bcore/src/wallet/rpc/assets.cpp:4637

C++ symbol: getassetregistry

Code samples

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

bitcoin-cli getassetregistry "a3f747562969280eb3ddc96ff57e3692b7b55611d8c89785f52fc2d1535d22b3"

bitcoin-cli getassetregistry "GOLD"

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getassetregistry",
        "params": ["\"<asset_id_or_ticker>\""],
    },
    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: "getassetregistry",
    params: ["\"<asset_id_or_ticker>\""],
  }),
});
console.log(await res.json());