初級

ネームスペース情報の取得⚓︎

このチュートリアルでは、ネームスペースのプロパティと、それが指し示すモザイクまたはアカウントを取得する方法を説明します。

前提条件⚓︎

このチュートリアルはネットワークからデータを読み取るだけです。アカウントは必要ありません。

開始する前に、開発環境のセットアップを済ませておいてください。

完全なコード⚓︎

このチュートリアルの完全なコード一覧を以下に示します。詳細な手順ごとの説明は次のセクションで行います。

Python JavaScript

import json
import os
import urllib.request

from symbolchain.symbol.IdGenerator import generate_namespace_path
from symbolchain.symbol.Network import Address

NODE_URL = os.getenv(
    'NODE_URL', 'https://reference.symboltest.net:3001')
print(f'Using node {NODE_URL}')

NAMESPACE_NAME = os.getenv('NAMESPACE_NAME', 'symbol.xym')
print(f'Namespace name: {NAMESPACE_NAME}')

try:
    # Generate namespace ID from name
    path = generate_namespace_path(NAMESPACE_NAME)
    namespace_id = path[-1]
    namespace_id_hex = f'{namespace_id:x}'
    print(f'Namespace ID: {namespace_id} (0x{namespace_id_hex})')

    # Fetch namespace information
    namespace_path = f'/namespaces/{namespace_id_hex}'
    print(f'Fetching namespace information from {namespace_path}')
    with urllib.request.urlopen(
            f'{NODE_URL}{namespace_path}') as response:
        response_json = json.loads(response.read().decode())
        ns = response_json['namespace']
        print('Namespace information:')
        reg_type = ns['registrationType']
        print(f'  Registration type: {reg_type}')
        owner_address = Address.from_decoded_address_hex_string(
            ns['ownerAddress'])
        print(f'  Owner address: {owner_address}')
        depth = int(ns['depth'])
        print(f'  Depth: {depth}')
        print(f'  Level 0 ID: {ns["level0"]}')
        if depth >= 2:
            print(f'  Level 1 ID: {ns["level1"]}')
        if depth == 3 and 'level2' in ns:
            print(f'  Level 2 ID: {ns["level2"]}')
        print(f'  Start height: {ns["startHeight"]}')
        end_height = int(ns['endHeight'])
        print(f'  End height: {end_height} (0x{end_height:X})')

        # Display alias information
        alias = ns['alias']
        alias_type = alias['type']
        print(f'  Alias type: {alias_type}')
        if alias_type == 1:
            print(f'  Linked mosaic ID: {alias["mosaicId"]}')
        elif alias_type == 2:
            linked_address = (
                Address.from_decoded_address_hex_string(
                    alias['address']))
            print(f'  Linked address: {linked_address}')
        else:
            print('  No alias linked')

except Exception as e:
    print(e)

Download source

import { Address, generateNamespacePath } from 'symbol-sdk/symbol';

const NODE_URL = process.env.NODE_URL
|| 'https://reference.symboltest.net:3001';
console.log('Using node', NODE_URL);

const NAMESPACE_NAME = process.env.NAMESPACE_NAME || 'symbol.xym';
console.log('Namespace name:', NAMESPACE_NAME);

try {
    // Generate namespace ID from name
    const path = generateNamespacePath(NAMESPACE_NAME);
    const namespaceId = path[path.length - 1];
    const namespaceIdHex = namespaceId.toString(16);
    console.log('Namespace ID:', `${namespaceId} (0x${namespaceIdHex})`);

    // Fetch namespace information
    const namespacePath = `/namespaces/${namespaceIdHex}`;
    console.log(
        'Fetching namespace information from', namespacePath);
    const namespaceResponse =
        await fetch(`${NODE_URL}${namespacePath}`);
    if (!namespaceResponse.ok) {
        throw new Error(
            `HTTP error! status: ${namespaceResponse.status}`);
    }
    const namespaceJSON = await namespaceResponse.json();
    const ns = namespaceJSON.namespace;
    console.log('Namespace information:');
    console.log('  Registration type:', ns.registrationType);
    const ownerAddress = Address.fromDecodedAddressHexString(
        ns.ownerAddress);
    console.log('  Owner address:', ownerAddress.toString());
    const depth = ns.depth;
    console.log('  Depth:', depth);
    console.log('  Level 0 ID:', ns.level0);
    if (depth >= 2) {
        console.log('  Level 1 ID:', ns.level1);
    }
    if (depth === 3 && ns.level2) {
        console.log('  Level 2 ID:', ns.level2);
    }
    console.log('  Start height:', ns.startHeight);
    const endHeight = BigInt(ns.endHeight);
    console.log('  End height:',
        `${endHeight} (0x${endHeight.toString(16).toUpperCase()})`);

    // Display alias information
    const alias = ns.alias;
    console.log('  Alias type:', alias.type);
    if (alias.type === 1) {
        console.log('  Linked mosaic ID:', alias.mosaicId);
    } else if (alias.type === 2) {
        const linkedAddress = Address.fromDecodedAddressHexString(
            alias.address);
        console.log('  Linked address:', linkedAddress.toString());
    } else {
        console.log('  No alias linked');
    }
} catch (e) {
    console.error(e.message);
}

Download source

このスニペットでは、 NODE_URL 環境変数を使用してSymbol APIノードを設定します。値が指定されない場合は、デフォルトのテストネットノードが使用されます。

NAMESPACE_NAME 環境変数は、照会するネームスペースを指定します。設定されていない場合は、ネットワークのネイティブ通貨である XYM にリンクされたネームスペース symbol.xym がデフォルトで設定されます。

コード解説⚓︎

ネームスペースIDの生成⚓︎

Python JavaScript

    # Generate namespace ID from name
    path = generate_namespace_path(NAMESPACE_NAME)
    namespace_id = path[-1]
    namespace_id_hex = f'{namespace_id:x}'
    print(f'Namespace ID: {namespace_id} (0x{namespace_id_hex})')

    // Generate namespace ID from name
    const path = generateNamespacePath(NAMESPACE_NAME);
    const namespaceId = path[path.length - 1];
    const namespaceIdHex = namespaceId.toString(16);
    console.log('Namespace ID:', `${namespaceId} (0x${namespaceIdHex})`);

ネームスペースIDは、 IdGenerator.generate_namespace_pathgenerateNamespacePath を使用して、ネームスペース名からローカルで計算されます。この関数は、 symbol.xym のような完全修飾名を受け取り、それを . で分割し、階層の各レベルのネームスペースIDの配列を返します。最後の要素は、最も深いネームスペースのIDです。