6.ネームスペース

Symbolブロックチェーンではネームスペースをレンタルしてアドレスやモザイクに視認性の高い単語をリンクさせることができます。ネームスペースは最大64文字、利用可能な文字は a, b, c, …, z, 0, 1, 2, …, 9, _ , - です。

6.1 手数料の計算

ネームスペースのレンタルにはネットワーク手数料とは別にレンタル手数料が発生します。ネットワークの活性度に比例して価格が変動しますので、取得前に確認するようにしてください。

ルートネームスペースを365日レンタルする場合の手数料を計算します。

rentalFees = await fetch(new URL("/network/fees/rental", NODE), {
  method: "GET",
  headers: { "Content-Type": "application/json" },
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

rootNsperBlock = Number(rentalFees.effectiveRootNamespaceRentalFeePerBlock);
rentalDays = 365;
rentalBlock = (rentalDays * 24 * 60 * 60) / 30;
rootNsRenatalFeeTotal = rentalBlock * rootNsperBlock;
console.log("rentalBlock:" + rentalBlock);
console.log("rootNsRenatalFeeTotal:" + rootNsRenatalFeeTotal);

出力例

> rentalBlock:1051200
> rootNsRenatalFeeTotal:210240000 //約210XYM

期間はブロック数で指定します。1ブロックを30秒として計算しました。最低で30日分はレンタルする必要があります（最大で1825日分）。

サブネームスペースの取得手数料を計算します。

childNamespaceRentalFee = Number(rentalFees.effectiveChildNamespaceRentalFee);
console.log(childNamespaceRentalFee);

出力例

> 10000000 //10XYM

サブネームスペースに期間指定はありません。ルートネームスペースをレンタルしている限り使用できます。

6.2 レンタル

ルートネームスペースをレンタルします(例:xembook)

// ネームスペース設定
name = "xembook"; // 作成するルートネームスペース

// Tx作成
tx = facade.transactionFactory.create({
  type: "namespace_registration_transaction_v1", // Txタイプ:ネームスペース登録Tx
  signerPublicKey: aliceKey.publicKey, // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  duration: new symbolSdk.symbol.BlockDuration(86400n), // duration:有効期限
  registrationType: symbolSdk.symbol.NamespaceRegistrationType.ROOT,
  name: new TextEncoder("utf-8").encode(name),
});
tx.fee = new symbolSdk.symbol.Amount(BigInt(tx.size * 100)); //手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, tx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(tx, sig);
await fetch(new URL("/transactions", NODE), {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: jsonPayload,
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

サブネームスペースをレンタルします(例:xembook.tomato)

// ネームスペース設定
parentNameId = symbolSdk.symbol.generateNamespaceId("xembook"); // 紐づけたいルートネームスペース
name = "tomato"; // 作成するサブネームスペース

subNamespaceTx = facade.transactionFactory.create({
  type: "namespace_registration_transaction_v1", // Txタイプ:ネームスペース登録Tx
  signerPublicKey: aliceKey.publicKey, // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  duration: new symbolSdk.symbol.BlockDuration(86400n), // duration:有効期限
  parentId: parentNameId,
  registrationType: symbolSdk.symbol.NamespaceRegistrationType.CHILD,
  name: new TextEncoder("utf-8").encode(name),
});
subNamespaceTx.fee = new symbolSdk.symbol.Amount(
  BigInt(subNamespaceTx.size * 100),
); //手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, subNamespaceTx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(
  subNamespaceTx,
  sig,
);
await fetch(new URL("/transactions", NODE), {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: jsonPayload,
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

2階層目のサブネームスペースを作成したい場合は例えば、xembook.tomato.morningを定義したい場合は以下のようにします。

// ネームスペース設定
rootNameId = symbolSdk.symbol.generateNamespaceId("xembook"); // ルートネームスペース
parentNameId = symbolSdk.symbol.generateNamespaceId("tomato", rootNameId); // 紐づけたい1階層目のサブネームスペース
name = "morning"; // 作成するサブネームスペース

// 以下はサブネームスペース作成と同じ

有効期限の計算

レンタル済みルートネームスペースの有効期限を計算します。

namespaceIds = symbolSdk.symbol.generateNamespacePath("xembook"); // ルートネームスペース
namespaceId = namespaceIds[namespaceIds.length - 1];

nsInfo = await fetch(
  new URL("/namespaces/" + namespaceId.toString(16).toUpperCase(), NODE),
  {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  },
)
  .then((res) => res.json())
  .then((json) => {
    return json.namespace;
  });

chainInfo = await fetch(new URL("/chain/info", NODE), {
  method: "GET",
  headers: { "Content-Type": "application/json" },
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });
lastHeight = chainInfo.height;

lastBlock = await fetch(new URL("/blocks/" + lastHeight, NODE), {
  method: "GET",
  headers: { "Content-Type": "application/json" },
})
  .then((res) => res.json())
  .then((json) => {
    return json.block;
  });
remainHeight = nsInfo.endHeight - lastHeight;

endDate = new Date(
  Number(lastBlock.timestamp) + remainHeight * 30000 + epochAdjustment * 1000,
);
console.log(endDate);

ネームスペース情報の終了ブロックを取得し、現在のブロック高から差し引いた残ブロック数に30秒(平均ブロック生成間隔)を掛け合わせた日時を出力します。テストネットでは設定した有効期限よりも1日程度更新期限が猶予されます。メインネットはこの値が30日となっていますのでご留意ください

出力例

> Tue Mar 29 2022 18:17:06 GMT+0900 (日本標準時)

6.3 リンク

アカウントへのリンク

// リンクするネームスペースとアドレスの設定
namespaceId = symbolSdk.symbol.generateNamespaceId("xembook");
address = new symbolSdk.symbol.Address(
  "TBIL6D6RURP45YQRWV6Q7YVWIIPLQGLZQFHWFEQ",
);

// Tx作成
tx = facade.transactionFactory.create({
  type: "address_alias_transaction_v1", // Txタイプ:アドレスエイリアスTx
  signerPublicKey: aliceKey.publicKey, // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  namespaceId: namespaceId,
  address: address,
  aliasAction: symbolSdk.symbol.AliasAction.LINK,
});
tx.fee = new symbolSdk.symbol.Amount(BigInt(tx.size * 100)); //手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, tx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(tx, sig);
await fetch(new URL("/transactions", NODE), {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: jsonPayload,
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

リンク先のアドレスは自分が所有していなくても問題ありません。

モザイクへリンク

// リンクするネームスペースとモザイクの設定
namespaceIds = symbolSdk.symbol.generateNamespacePath("xembook.tomato");
namespaceId = namespaceIds[namespaceIds.length - 1];
mosaicId = new symbolSdk.symbol.MosaicId(0x3A8416DB2D53xxxxn);

// Tx作成
tx = facade.transactionFactory.create({
  type: 'mosaic_alias_transaction_v1',  // Txタイプ:モザイクエイリアスTx
  signerPublicKey: aliceKey.publicKey,  // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  namespaceId: namespaceId,
  mosaicId: mosaicId,
  aliasAction: symbolSdk.symbol.AliasAction.LINK
});
tx.fee = new symbolSdk.symbol.Amount(BigInt(tx.size * 100)); //手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, tx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(tx, sig);
await fetch(
  new URL('/transactions', NODE),
  {
    method: 'PUT',
    headers: { 'Content-Type': 'application/json' },
    body: jsonPayload,
  }
)
.then((res) => res.json())
.then((json) => {
  return json;
});

モザイクを作成したアドレスと同一の場合のみリンクできるようです。

6.4 未解決で使用

送信先にUnresolvedAccountとして指定して、アドレスを特定しないままトランザクションを署名・アナウンスします。チェーン側で解決されたアカウントに対しての送信が実施されます。

v3 ではネームスペースを直接指定できないため、アドレスを特定しないまま操作する場合はデータを加工する必要があります。

// UnresolvedAccount 導出
namespaceId = symbolSdk.symbol.generateNamespaceId("xembook");
namespaceIdData = symbolSdk.utils.hexToUint8(namespaceId.toString(16));
namespaceIdData.reverse();
unresolvecAccount = new Uint8Array([
  networkType + 1,
  ...namespaceIdData,
  ...new Uint8Array(24 - (namespaceIdData.length + 1)),
]);

// Tx作成
tx = facade.transactionFactory.create({
  type: "transfer_transaction_v1", // Txタイプ:転送Tx
  signerPublicKey: aliceKey.publicKey, // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  recipientAddress: unresolvecAccount, // UnresolvedAccount:未解決アカウントアドレス
  mosaics: [],
  message: new Uint8Array(),
});
tx.fee = new symbolSdk.symbol.Amount(BigInt(tx.size * 100)); //手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, tx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(tx, sig);
await fetch(new URL("/transactions", NODE), {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: jsonPayload,
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

送信モザイクにUnresolvedMosaicとして指定して、モザイクIDを特定しないままトランザクションを署名・アナウンスします。

// address = new symbolSdk.symbol.Address("*****");
namespaceIds = symbolSdk.symbol.generateNamespacePath("xembook.tomato");
namespaceId = namespaceIds[namespaceIds.length - 1];

// Tx作成
tx = facade.transactionFactory.create({
  type: "transfer_transaction_v1", // Txタイプ:転送Tx
  signerPublicKey: aliceKey.publicKey, // 署名者公開鍵
  deadline: facade.network.fromDatetime(Date.now()).addHours(2).timestamp, //Deadline:有効期限
  recipientAddress: address,
  mosaics: [
    {
      mosaicId: namespaceId, // UnresolvedMosaic:未解決モザイク
      amount: 1n, // 送信量
    },
  ],
  message: new Uint8Array(),
});
tx.fee = new symbolSdk.symbol.Amount(BigInt(tx.size * 100)); // 手数料

// 署名とアナウンス
sig = facade.signTransaction(aliceKey, tx);
jsonPayload = facade.transactionFactory.constructor.attachSignature(tx, sig);
await fetch(new URL("/transactions", NODE), {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: jsonPayload,
})
  .then((res) => res.json())
  .then((json) => {
    return json;
  });

XYMをネームスペースで使用する場合は以下のように指定します。

namespaceIds = symbolSdk.symbol.generateNamespacePath("symbol.xym");
namespaceId = namespaceIds[namespaceIds.length - 1];

> 16666583871264174062n

6.5 参照

アドレスへリンクしたネームスペースの参照します

nameId = symbolSdk.symbol.generateNamespaceId("xembook");
namespaceInfo = await fetch(
  new URL("/namespaces/" + nameId.toString(16).toUpperCase(), NODE),
  {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  },
)
  .then((res) => res.json())
  .then((json) => {
    return json;
  });
console.log(namespaceInfo);

出力例

> {meta: {…}, namespace: {…}, id: '6492E0242F7CE156B00D7580'}
    id: "6492E0242F7CE156B00D7580"
  > meta:
      active: true
      index: 9
  > namespace:
    > alias:
        address: "981CFF6235B50FEAB020C824D5E0EBD4894F8D605DD2DF93"
        type: 2 //AliasType
      depth: 1
      endHeight: "1432950"
      level0: "A43415EB268C7385"
      ownerAddress: "981CFF6235B50FEAB020C824D5E0EBD4894F8D605DD2DF93"
      parentId: "0000000000000000"
      registrationType: 0 // NamespaceRegistrationType
      startHeight: "393270"
      version: 1

AliasTypeは以下の通りです。

{0: 'None', 1: 'Mosaic', 2: 'Address'}

NamespaceRegistrationTypeは以下の通りです。

{0: 'RootNamespace', 1: 'SubNamespace'}

モザイクへリンクしたネームスペースを参照します。

namespaceIds = symbolSdk.symbol.generateNamespacePath("xembook.tomato");
nameId = namespaceIds[namespaceIds.length - 1];
namespaceInfo = await fetch(
  new URL("/namespaces/" + nameId.toString(16).toUpperCase(), NODE),
  {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  },
)
  .then((res) => res.json())
  .then((json) => {
    return json;
  });
console.log(namespaceInfo);

出力例

> {meta: {…}, namespace: {…}, id: '6492E0242F7CE156B00D758B'}
    id: "6492E0242F7CE156B00D758B"
  > meta:
      active: true
      index: 9
  > namespace:
    > alias:
        mosaicId: "663B178E904CADB8"
        type: 1 //AliasType
      depth: 1
      endHeight: "1432950"
      level0: "A43415EB268C7385"
      level1: "FA547FD28C836431"
      ownerAddress: "981CFF6235B50FEAB020C824D5E0EBD4894F8D605DD2DF93"
      parentId: "A43415EB268C7385"
      registrationType: 1 // NamespaceRegistrationType
      startHeight: "393270"
      version: 1

逆引き

アドレスに紐づけられたネームスペースを全て調べます。

body = {
  addresses: ["TBIL6D6RURP45YQRWV6Q7YVWIIPLQGLZQFHWFEQ"],
};
accountNames = await fetch(new URL("/namespaces/account/names", NODE), {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(body),
})
  .then((res) => res.json())
  .then((json) => {
    return json.accountNames;
  });

namespaceIds = accountNames[0].names;
console.log(namespaceIds);

モザイクに紐づけられたネームスペースを全て調べます。

body = {
  mosaicIds: ["72C0212E67A08BCE"],
};
mosaicNames = await fetch(new URL("/namespaces/mosaic/names", NODE), {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(body),
})
  .then((res) => res.json())
  .then((json) => {
    return json.mosaicNames;
  });

namespaceIds = mosaicNames[0].names;
console.log(namespaceIds);

レシートの参照

トランザクションに使用されたネームスペースをブロックチェーン側がどう解決したかを確認します。 v3 では、ネームスペースを紐づけている対象によってアクセスする際のURLが異なります。

アドレスの場合

query = new URLSearchParams({
  height: 179401, // 6.4 で作成したTxが取り込まれたブロック高
});
state = await fetch(
  new URL("/statements/resolutions/address?" + query.toString(), NODE), // アドレス用のURI
  {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  },
)
  .then((res) => res.json())
  .then((json) => {
    return json.data;
  });

モザイクの場合

query = new URLSearchParams({
  height: 179401, // 6.4 で作成したTxが取り込まれたブロック高
});
state = await fetch(
  new URL("/statements/resolutions/mosaic?" + query.toString(), NODE), // モザイク用のURI
  {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  },
)
  .then((res) => res.json())
  .then((json) => {
    return json.data;
  });

出力例

> data: Array(1)
  > 0:
      id: "64B6A3742F7CE156B0108826"
    > meta:
        timestamp: "22440529194"
    > statement:
        height: "646246"
        resolutionEntries: Array(1)
        > 0:
            resolved: "986A4B98552007D13947E6F4F1202604BD26CC4018BACACC"
          > source:
              primaryId: 1
              secondaryId: 0
        unresolved: "99534C3F83755AD3D9000000000000000000000000000000"

注意事項

ネームスペースはレンタル制のため、過去のトランザクションで使用したネームスペースのリンク先と現在のネームスペースのリンク先が異なる可能性があります。過去のデータを参照する際などに、その時どのアカウントにリンクしていたかなどを知りたい場合は必ずレシートを参照するようにしてください。

6.6 現場で使えるヒント

外部ドメインとの相互リンク

ネームスペースは重複取得がプロトコル上制限されているため、インターネットドメインや実世界で周知されている商標名と同一のネームスペースを取得し、外部(公式サイトや印刷物など)からネームスペース存在の認知を公表することで、 Symbol上のアカウントのブランド価値を構築することができます (法的な効力については調整が必要です)。外部ドメイン側のハッキングあるいは、Symbol側でのネームスペース更新忘れにはご注意ください。

ネームスペースを取得するアカウントについての注意

ネームスペースはレンタル期限という概念をもつ機能です。今のところ、取得したネームスペースは放棄か延長の選択肢しかありません。運用譲渡などが発生する可能性のあるシステムでネームスペース活用を検討する場合はマルチシグ化(9章)したアカウントでネームスペースを取得することをおすすめします。

6.1 手数料の計算​

出力例​

出力例​

6.2 レンタル​

有効期限の計算​

出力例​

6.3 リンク​

アカウントへのリンク​

モザイクへリンク​

6.4 未解決で使用​

6.5 参照​

出力例​

出力例​

逆引き​

レシートの参照​

アドレスの場合​

モザイクの場合​

出力例​

注意事項​

6.6 現場で使えるヒント​

外部ドメインとの相互リンク​

ネームスペースを取得するアカウントについての注意​

6.1 手数料の計算

出力例

出力例

6.2 レンタル

有効期限の計算

出力例

6.3 リンク

アカウントへのリンク

モザイクへリンク

6.4 未解決で使用

6.5 参照

出力例

出力例

逆引き

レシートの参照

アドレスの場合

モザイクの場合

出力例

注意事項

6.6 現場で使えるヒント

外部ドメインとの相互リンク

ネームスペースを取得するアカウントについての注意