Skip to main content

QueryAssetRoots

QueryAssetRoots attempts to locate the current Universe root for a specific asset. This asset can be identified by its asset ID or group key.

Source: universerpc/universe.proto

gRPC

rpc QueryAssetRoots (AssetRootQuery) returns (QueryRootResponse);

REST

HTTP MethodPath
GET /v1/taproot-assets/universe/roots/asset-id/{id.asset_id_str}

Code Samples

const fs = require('fs');
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');

const GRPC_HOST = 'localhost:10029'
const MACAROON_PATH = 'TAPROOT-ASSETS_DIR/regtest/taproot-assets.macaroon'
const TLS_PATH = 'TAPROOT-ASSETS_DIR/tls.cert'

const loaderOptions = {
keepCase: true,
longs: String,
enums: String,
defaults: true,
oneofs: true,
};
const packageDefinition = protoLoader.loadSync('universerpc/universe.proto', loaderOptions);
const universerpc = grpc.loadPackageDefinition(packageDefinition).universerpc;
process.env.GRPC_SSL_CIPHER_SUITES = 'HIGH+ECDSA';
const tlsCert = fs.readFileSync(TLS_PATH);
const sslCreds = grpc.credentials.createSsl(tlsCert);
const macaroon = fs.readFileSync(MACAROON_PATH).toString('hex');
const macaroonCreds = grpc.credentials.createFromMetadataGenerator(function(args, callback) {
let metadata = new grpc.Metadata();
metadata.add('macaroon', macaroon);
callback(null, metadata);
});
let creds = grpc.credentials.combineChannelCredentials(sslCreds, macaroonCreds);
let client = new universerpc.Universe(GRPC_HOST, creds);
let request = {
id: <ID>,
};
client.queryAssetRoots(request, function(err, response) {
console.log(response);
});
// Console output:
// {
// "issuance_root": <UniverseRoot>,
// "transfer_root": <UniverseRoot>,
// }

Messages

universerpc.AssetRootQuery

Source: universerpc/universe.proto

FieldgRPC TypeREST TypeREST Placement
id
IDobjectmixed

universerpc.QueryRootResponse

Source: universerpc/universe.proto

FieldgRPC TypeREST Type
issuance_root
UniverseRootobject
transfer_root
UniverseRootobject

Nested Messages

universerpc.ID

FieldgRPC TypeREST Type
asset_id
bytesstring
asset_id_str
stringstring
group_key
bytesstring
group_key_str
stringstring
proof_type
ProofTypestring

universerpc.MerkleSumNode

FieldgRPC TypeREST Type
root_hash
bytesstring
root_sum
int64string

universerpc.UniverseRoot

FieldgRPC TypeREST Type
id
IDobject
mssmt_root
MerkleSumNodeobject
asset_name
stringstring
amounts_by_asset_id
AmountsByAssetIdEntry[]object

universerpc.UniverseRoot.AmountsByAssetIdEntry

FieldgRPC TypeREST Type
key
stringunknown
value
uint64unknown

Enums

universerpc.ProofType

NameNumber
PROOF_TYPE_UNSPECIFIED
0
PROOF_TYPE_ISSUANCE
1
PROOF_TYPE_TRANSFER
2