初級

ネットワーク時間⚓︎

Symbol ブロックチェーンにおける時間は「ネットワーク時間」で測定されます。これは、チェーンの最初のブロックから経過したミリ秒数として定義されます。

この簡単なチュートリアルでは、API 呼び出しによって返されるネットワーク時間を UTC のような標準的なタイムスタンプに変換する方法を説明します。

前提条件⚓︎

このチュートリアルでは、SDK を必要とせずに Symbol REST API を使用します。 HTTP リクエストを行う方法さえあれば実行可能です。

完全なコード⚓︎

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

Python JavaScript

import json
import os
import datetime
import urllib.request

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

try:
    # Fetch Nemesis timestamp
    properties_path = '/network/properties'
    print(f'Fetching network properties from {properties_path}')
    with urllib.request.urlopen(
            f'{NODE_URL}{properties_path}') as response:
        response_json = json.loads(response.read().decode())
        nemesis_datetime = datetime.datetime.fromtimestamp(
            int(response_json['network']['epochAdjustment'].rstrip('s')),
            tz=datetime.timezone.utc)

    # Fetch current network timestamp
    time_path = '/node/time'
    print(f'Fetching current network time from {time_path}')
    with urllib.request.urlopen(f'{NODE_URL}{time_path}') as response:
        response_json = json.loads(response.read().decode())
        network_ms = int(
            response_json['communicationTimestamps']['receiveTimestamp'])

    network_datetime = nemesis_datetime + datetime.timedelta(
        milliseconds=network_ms)

    print(f'\nNemesis time (UTC): {nemesis_datetime}')
    print(f'Network time (ms since Nemesis): {network_ms}')
    print(f'Network time (UTC): {network_datetime}')
except Exception as error:
    print(error)

Download source

const NODE_URL = process.env.NODE_URL
    || 'https://whydah.symbolmain.net:3001';
console.log(`Using node ${NODE_URL}`);

try {
    // Fetch Nemesis timestamp
    const propertiesPath = '/network/properties';
    console.log(`Fetching network properties from ${propertiesPath}`);
    const propertiesResponse = await fetch(
        `${NODE_URL}${propertiesPath}`);
    const propertiesJson = await propertiesResponse.json();
    const nemesisStr = propertiesJson.network.epochAdjustment;
    const nemesisSeconds = parseInt(nemesisStr.replace('s', ''), 10);
    const nemesisDatetime = new Date(nemesisSeconds * 1000);

    // Fetch current network timestamp
    const timePath = '/node/time';
    console.log(`Fetching current network time from ${timePath}`);
    const timeResponse = await fetch(`${NODE_URL}${timePath}`);
    const timeJson = await timeResponse.json();
    const networkMs = parseInt(
        timeJson.communicationTimestamps.receiveTimestamp, 10);

    const networkDatetime = new Date(
        nemesisDatetime.getTime() + networkMs);

    console.log(`\nNemesis time (UTC): ${nemesisDatetime.toISOString()}`);
    console.log(`Network time (ms since Nemesis): ${networkMs}`);
    console.log(`Network time (UTC): ${networkDatetime.toISOString()}`);
} catch (error) {
    console.error(`Error: ${error.message}`);
}

Download source

コード解説⚓︎

コードはネメシスブロックのタイムスタンプと現在のネットワーク時間を取得します。その後、それらを足し合わせて標準的な UTC での現在時刻を求めます。

ネメシスタイムスタンプの取得⚓︎

Python JavaScript

    properties_path = '/network/properties'
    print(f'Fetching network properties from {properties_path}')
    with urllib.request.urlopen(
            f'{NODE_URL}{properties_path}') as response:
        response_json = json.loads(response.read().decode())
        nemesis_datetime = datetime.datetime.fromtimestamp(
            int(response_json['network']['epochAdjustment'].rstrip('s')),
            tz=datetime.timezone.utc)

    const propertiesPath = '/network/properties';
    console.log(`Fetching network properties from ${propertiesPath}`);
    const propertiesResponse = await fetch(
        `${NODE_URL}${propertiesPath}`);
    const propertiesJson = await propertiesResponse.json();
    const nemesisStr = propertiesJson.network.epochAdjustment;
    const nemesisSeconds = parseInt(nemesisStr.replace('s', ''), 10);
    const nemesisDatetime = new Date(nemesisSeconds * 1000);

ネメシスブロックの作成時間は固定のネットワークプロパティであり、 /network/properties GET エンドポイントを使用して取得できます。返される値（ epochAdjustment ）は、 s サフィックスを削除して整数に変換すると、 UNIX タイムスタンプになります。つまり、UNIX エポック（1970年1月1日 00:00:00 UTC）から経過したうるう秒を除いた秒数です。

このチュートリアルでは説明の目的でネットワークから取得していますが、これは固定値であるため、必要に応じて定数として扱い、ハードコードすることも可能です。 Symbolのメインネットの場合、値は 1615853185 であり、これは 2021-03-16T00:06:25Z （2021年3月16日午前0時06分25秒 UTC）に相当します。

現在のネットワーク時間の取得⚓︎

Python JavaScript

    time_path = '/node/time'
    print(f'Fetching current network time from {time_path}')
    with urllib.request.urlopen(f'{NODE_URL}{time_path}') as response:
        response_json = json.loads(response.read().decode())
        network_ms = int(
            response_json['communicationTimestamps']['receiveTimestamp'])

    const timePath = '/node/time';
    console.log(`Fetching current network time from ${timePath}`);
    const timeResponse = await fetch(`${NODE_URL}${timePath}`);
    const timeJson = await timeResponse.json();
    const networkMs = parseInt(
        timeJson.communicationTimestamps.receiveTimestamp, 10);

照会先のノードが認識している現在のネットワーク時間は、 /node/time GET エンドポイントを使用して取得されます。ネットワーク内のノードは通常同期されているため、ほぼ同じ時間を返します。

実際に照会されるプロパティは communicationTimestamps.receiveTimestamp であり、これはリクエストがノードによって受信された時間を表します。

この値はネットワーク時間、つまりネメシスブロックが作成されてから経過したミリ秒数で表されます。

変換⚓︎

現在のネットワーク時間から UTC への変換は、単位（秒またはミリ秒）を揃えることに注意しながら、2つの数値を足し合わせるだけで済みます。

Python JavaScript

    network_datetime = nemesis_datetime + datetime.timedelta(
        milliseconds=network_ms)

    print(f'\nNemesis time (UTC): {nemesis_datetime}')
    print(f'Network time (ms since Nemesis): {network_ms}')
    print(f'Network time (UTC): {network_datetime}')

    const networkDatetime = new Date(
        nemesisDatetime.getTime() + networkMs);

    console.log(`\nNemesis time (UTC): ${nemesisDatetime.toISOString()}`);
    console.log(`Network time (ms since Nemesis): ${networkMs}`);
    console.log(`Network time (UTC): ${networkDatetime.toISOString()}`);

このチュートリアルでは、プロセスを示すために手動で加算を行っています。 Symbol SDK を使用している場合は、 NetworkTimestampDatetimeConverterNetworkTimestampDatetimeConverter がより便利な抽象化を提供します。

出力⚓︎

以下に示す出力は、プログラムの典型的な実行結果に対応しています。

Using node https://whydah.symbolmain.net:3001
Fetching network properties from /network/properties
Fetching current network time from /node/time

Nemesis time (UTC): 2021-03-16T00:06:25.000Z
Network time (ms since Nemesis): 159102619442
Network time (UTC): 2026-03-31T11:16:44.442Z

5行目はネメシスブロックのタイムスタンプを示しており、常に同じ値を表示します。

7行目は、UTC に変換された現在のネットワーク時間を示しています。

結論⚓︎

このチュートリアルでは、以下の方法を説明しました。

ステップ	関連ドキュメント
ネメシスタイムスタンプの取得	`/network/properties` `GET`
現在のネットワーク時間の取得	`/node/time` `GET`
両方の結合	`NetworkTimestampDatetimeConverterNetworkTimestampDatetimeConverter` (オプション)