xrp-ledger.tomlファイル

XRP Ledgerバリデータを実行するか、ビジネスにXRP Ledgerを使用する場合、機械が読み取れる形式の xrp-ledger.toml ファイルで自分のXRP Ledgerの使用状況に関する情報を世界中に提供することができます。スクリプトとアプリケーションでxrp-ledger.tomlファイルの情報を使用して、XRP Ledgerでの自分の情報を分かりやすく示すことができます。また、同じファイルを人間が読むことが便利な場合もあります。

xrp-ledger.tomlファイルの主な使用例のひとつに、ドメインの検証があります。

表記法

本書のキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、RFC 2119の記述どおりに解釈されます。

ファイルの提供方法

xrp-ledger.tomlファイルは、Webサーバより提供することを前提としています。このファイルは、次のURLで提供できます。

https://{DOMAIN}/.well-known/xrp-ledger.toml

{DOMAIN}には、お使いのドメイン名が入ります（サブドメインを含む）。例えば、次のいずれのURLからでもファイルを提供できます。

https://example.com/.well-known/xrp-ledger.toml
https://xrp.services.example.com/.well-known/xrp-ledger.toml

プロトコル

上記の内容は、セキュリティ上、HTTPSプロトコル経由で提供する必要があります。その際、TLSの最新の安全なバージョンと、既知の認証局によって署名された有効な証明書を使用します。（注記: TLSは以前はSSLと呼ばれていましたが、現在それらのバージョンは安全とは言えません。）つまり、xrp-ledger.tomlファイルをホストするための前提条件は、適切に構成されたHTTPSのWebサーバを用意することです。

プレーンHTTPプロトコルは中間者攻撃に対して脆弱です。例えば、一部のインターネットサービスは、プレーンHTTP経由で取得したコンテンツを、独自の広告が挿入されるように改変していることが知られています。同様の技術によってxrp-ledger.tomlファイルの内容が誤って伝達され、スクリプトの誤動作または虚偽的な動作につながる可能性を防ぐため、プレーンHTTP経由で提供されるxrp-ledger.tomlファイルの内容を信頼すべきではありません。

ドメイン

xrp-ledger.tomlファイルを提供するドメインは、所有権の表明とも言えます。このようなファイルの内容は、単独で提供されている場合、有用または信頼できるものではありません。実用的な観点からすれば、メインドメインからファイルを提供することは望ましくない場合もあります。そのため、任意の数のサブドメインを使用することができます。XRP LedgerアカウントのDomainフィールドを設定するときは、使用したすべてのサブドメインを含むフルドメインを指定する必要があります。詳細は、アカウントの検証を確認してください。

必要に応じて、複数のサブドメインから同じファイルを提供することもできます。例えば、サブドメインwww.example.comからexample.comと同じWebサイトに遷移する場合は、どちらからもファイルを提供できます。Webサイトでプレフィクスwwwが必要な場合は、ドメインを指定する際（例えば、XRP LedgerアカウントのDomainフィールドを設定する際）に必ずプレフィクスを含めてください。

xrp-ledger.tomlファイルと同じドメインから人間が読める形式のWebサイトを提供することをお勧めします。このWebサイトでは、あなたのIDおよびXRP Ledgerの使用方法に関する詳細情報を提供します。この情報は、あなたやあなたのサービスに対する信頼を構築するのに役立ちます。

パス

RFC5785に準拠し、パスの開始部分は/.well-known/でなければなりません。ファイルは、パス/.well-known/xrp-ledger.tomlで正しく表示される必要があります（すべて小文字）。

必要に応じて、同じファイルを、大文字と小文字を変えて（例: /.well-known/XRP-Ledger.TOML）提供することもできます。パスが大文字か小文字かによって、異なるコンテンツを提供することはできません。

ヘッダー

Content-Type

xrp-ledger.tomlファイルに推奨されるContent-Typeはapplication/tomlです。ただし、このファイルを使用するアプリケーションは、Content-Typeの値としてtext/plainも受け入れる必要があります。

CORS

他のWebサイト上のスクリプトでファイルを照会できるようにするには、ファイルに対してCORSを有効にする必要があります。具体的には、サーバでxrp-ledger.tomlを提供するときに次のヘッダーを付加する必要があります。

Access-Control-Allow-Origin: *

このヘッダーが付加されるようにサーバを構成する方法については、CORSセットアップをご覧ください。

その他のヘッダー

サーバでは、必要に応じて、圧縮、キャッシュ制御、リダイレクト、関連リソースのリンクなど、他の標準HTTPヘッダーを使用できます。

生成

xrp-ledger.tomlファイルは、Webサーバに格納されている実際のファイルである場合もあれば、Webサーバによってオンデマンドで生成される場合もあります。ファイルで提供されるコンテンツまたはWebサイトの構成によっては、後者の方が望ましい場合があります。

内容

xrp-ledger.tomlファイルの内容は、TOMLでフォーマットする必要があります。 内容はすべてオプションです。 コメントは省略できますが、分かりやすくするために推奨されます。

サンプルコンテンツ:

# Example xrp-ledger.toml file. These contents should not be considered
# authoritative for any real entity or business.
# Note: all fields and all sections are optional.

[METADATA]
modified = 2019-01-22T00:00:00.000Z
expires = 2019-03-01T00:00:00.000Z

[[VALIDATORS]]
public_key = "nHBtDzdRDykxiuv7uSMPTcGexNm879RUUz5GW4h1qgjbtyvWZ1LE"
network = "main"
owner_country = "us"
server_country = "us"
unl = "https://vl.ripple.com"

[[VALIDATORS]]
public_key = "nHB57Sey9QgaB8CubTPvMZLkLAzfJzNMWBCCiDRgazWJujRdnz13"
network = "testnet"
owner_country = "us"
server_country = "us"
unl = "https://vl.testnet.rippletest.net"

[[ACCOUNTS]]
address = "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV"
desc = "Ripple-owned address from old ripple.txt file"
# Note: This doesn't prove ownership of an account unless the
#   "Domain" field of the account in the XRP Ledger matches the
#   domain this file was served from.

[[SERVERS]]
json_rpc = "https://s1.ripple.com:51234/"
ws = "wss://s1.ripple.com/"
peer = "https://s1.ripple.com:51235/"
desc = "General purpose server cluster"

[[SERVERS]]
json_rpc = "https://s2.ripple.com:51234/"
ws = "wss://s2.ripple.com/"
peer = "https://s2.ripple.com:51235/"
desc = "Full-history server cluster"

[[SERVERS]]
json_rpc = "https://s.testnet.rippletest.net:51234/"
ws = "wss://s.testnet.rippletest.net:51233/"
peer = "https://s.testnet.rippletest.net:51235/"
network = "testnet"
desc = "Test Net public server cluster"

[[PRINCIPALS]]
name = "Rome Reginelli" # Primary spec author
email = "[email protected]" # Not my real email address

[[CURRENCIES]]
code = "LOL"
issuer = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
network = "testnet"
display_decimals = 2
symbol = "😆" # In practical situations, it may be unwise to use emoji

# End of file

Metadata

メタデータセクションには、xrp-ledger.tomlファイル自体に関する情報が表示されます。このセクションは、（存在する場合） 単一 角括弧を使用した[METADATA]行で開始する単一のテーブルでなければなりません。（xrp-ledger.tomlファイルの他のほとんどのセクションでは、情報の配列のために二重括弧を使用していますが、[METADATA]セクションは最大で1つしかありません。）以下から任意のフィールドを指定できます（大文字と小文字は区別されます）。

本仕様ではdomainフィールドは定義していません。このフィールドは、ファイルを提供するサイトから決定する必要があります。

バリデータ

バリデータリストには、操作するサーバの検証に関する情報が表示されます。バリデータリストは、（存在する場合）各エントリが二重角括弧のヘッダー[[VALIDATORS]]を使用する複数のテーブルの配列でなければなりません。各エントリで、別個の検証サーバが示されます。

ファイル内の 最初の[[VALIDATORS]]エントリは、プライマリのバリデータとして扱われます。本番環境のXRP Ledgerで1つ以上のバリデータを実行する場合は、他のバリデータに信頼されるバリデータを最初に配置する必要があります。

各[[VALIDATORS]]エントリごとに、以下から任意のフィールドを指定することができます。

アカウント

アカウントリストには、所有するXRP Ledgerアカウントに関する情報が表示されます。アカウントリストは、（存在する場合）各エントリが二重角括弧を含んだヘッダー[[ACCOUNTS]]を使用する複数のテーブルの配列でなければなりません。各エントリで、個別のアカウントが示されます。 各[[ACCOUNTS]]エントリごとに、以下から任意のフィールドを指定することができます。

責任者

責任者リストには、XRP Ledgerのビジネスおよびサービスに関係するユーザ（または企業）に関する情報が表示されます。責任者リストは、（存在する場合）各エントリが二重角括弧を含んだヘッダー[[PRINCIPALS]]を使用する複数のテーブルの配列でなければなりません。各エントリは異なる連絡先を示します。 各[[PRINCIPALS]]エントリごとに、以下から任意のフィールドを指定することができます。

必要に応じて、他の連絡先情報を指定することができます。（カスタムフィールドについては、カスタムフィールドをご覧ください。）

サーバ

サーバリストには、パブリックアクセスで実行するXRP Ledgerサーバ（rippled）に関する情報が表示されます。サーバリストは、（存在する場合）各エントリが二重角括弧を含んだヘッダー[[SERVERS]]を使用する複数のテーブルの配列でなければなりません。各エントリは、異なるサーバまたはサーバクラスターを示します。 各[[SERVERS]]エントリごとに、以下から任意のフィールドを指定することができます。

このセクションのすべてのURLの末尾にスラッシュを付けることが推奨されます。省略された場合、クライアントアプリケーションでは、末尾にスラッシュが含まれていると想定します。

通貨

XRP Ledgerで資産、トークン、または通貨を発行する場合は、[[CURRENCIES]]リストでそれらに関する情報を提供できます。通貨リストは、（存在する場合）各エントリが二重角括弧を含んだヘッダー[[CURRENCIES]]を使用する複数のテーブルの配列でなければなりません。各エントリは、個別のまたは資産を示します。 各[[CURRENCIES]]エントリごと に 、以下から任意のフィールドを指定することができます。

カスタムフィールド

xrp-ledger.tomlファイルは、XRP Ledgerのユーザが、他のユーザやスクリプト、アプリケーションに情報を提供することを目的としています。そのため、内容を伝えるのに役立つものの、この仕様には記載されていない多くの種類の情報が存在する可能性があります。ユーザは、必要に応じて関連情報を伝えるために、xrp-ledger.tomlファイルの任意のレベルで他のフィールドを追加することをお勧めします。

xrp-ledger.tomlファイルを解析するツールは、アプリケーションが把握していないその他のフィールドを含むドキュメントを受け入れる必要があります。そのようなツールは、これらの追加フィールドを呼び出す上位レベルのアプリケーションで、追加フィールドを使用できるようにするか、それらのフィールドを無視することができます。この仕様の将来のバージョンとのフォワードコンパティビリティを維持するために、ツールはこの標準で指定されたフィールドを無視することもできます。xrp-ledger.tomlファイルに認識されていないフィールドが含まれている場合、ツールはエラーを返すべきではありません。タイプミスを検出するために、ツールは認識されていないフィールド（特に、フィールド名が標準フィールド名と類似している場合など）に警告を表示することができます。

認識したフィールドが予期されたとおりのフォーマットではない場合、そのフィールドがこの仕様で定義されていなくても、ツールがエラーを返す場合もあります。

カスタムフィールドを作成するときは、選択するフィールド名に注意してください。ごく一般的なフィールド名を使用すると、他のユーザが同じ名前で異なるものを意味するか、競合する方法でフォーマットされる場合があります。他のユーザにとって有益だと思われるカスタムフィールドを使用する場合は、このドキュメントのメンテナーにそのフィールドの仕様を提供してください。

CORSの設定

xrp-ledger.tomlファイルに対してCross-Origin Resource Sharing（CORS）を許可するようにWebサーバを構成する必要があります。この構成は、Webサーバによって異なります。

Apache HTTP Serverを実行する場合は、以下の内容を構成ファイルに追加します。

<Location "/.well-known/xrp-ledger.toml">
    Header set Access-Control-Allow-Origin "*"
</Location>

または、以下の内容をサーバの/.well-known/ディレクトリ内の.htaccessファイルに追加できます。

<Files "xrp-ledger.toml">
    Header set Access-Control-Allow-Origin "*"
</Files>

nginxを使用する場合は、以下の内容を構成ファイルに追加します。

location /.well-known/xrp-ledger.toml {
    add_header 'Access-Control-Allow-Origin' '*';
}

他のWebサーバについては、サーバにCORSサポートを追加したいをご覧ください。マネージドホスティングを使用する場合、特定のパスでCORSを有効にする方法については、Webホストのドキュメントをご覧ください。（Webサイト全体でCORSを有効にすることはあまりないと思われます。）

ドメイン検証

xrp-ledger.tomlファイルの用途のひとつは、同じエンティティが特定のドメインを運用し、かつバリデータの公開鍵によって識別される特定のバリデータも運用することを検証することです。ドメインとバリデータが同じエンティティによって所有されていることを検証することで、バリデータオペレーターとしてのIDを確実に保証できます。また、これは信頼できるバリデータになるための推奨手順でもあります。（他の推奨事項については、優れたバリデータの特徴の理解をご覧ください。）

ドメイン検証では、ドメインオペレーターとバリデータの間に双方向リンクを確立する必要があります。

1. ドメインはバリデータの所有権を主張します。

   • 本書に記載されているすべての要件に従って、当該ドメインからxrp-ledger.tomlファイルを提供します。

   • そのxrp-ledger.tomlファイルで、[[VALIDATORS]]エントリのpublic_keyフィールドにバリデータのマスター公開鍵を入力します。

2. バリデータは、ドメイン別に所有権を主張します。このステップの手順は、本仕様書の範囲外です。

アカウント検証

ドメイン検証と同様に、アカウント検証は、同じエンティティが特定のドメインと特定のXRP Ledgerアドレスを運用していることを証明するという考え方を示します。XRP Ledgerの使用やxrp-ledger.tomlファイルの提供にはアカウント検証は必要ありませんが、透明性の確保のために、アカウントを検証することもできます。

アカウント検証では、ドメインオペレーターとアドレスの間に双方向リンクを確立する必要があります。

1. ドメインはアドレスの所有権を主張します。

   • 本書に記載されているすべての要件に従って、当該ドメインからxrp-ledger.tomlファイルを提供します。

   • そのxrp-ledger.tomlファイルで、検証するアカウントのアドレスを[[ACCOUNTS]]エントリに入力します。このアドレスから通貨を発行する場合は、[[CURRENCIES]]エントリのissuerフィールドでこのアカウントを指定することもできます。

2. アドレスは、ドメイン別に所有権を主張します。

   このxrp-ledger.tomlファイルの提供元のドメインに一致するように、アカウントのDomainフィールドを設定します。ドメイン値（ASCIIからデコードされた場合）は、www.などのすべてのサブドメインを含め、 正確に 一致する必要があります。国際化ドメイン名の場合は、RFC3492の説明に従って、Domain値をドメインのPunycodeに設定します。

   Domainを設定するにはトランザクションを送信する必要があるため、Domain値を設定する場合は必ずトランザクションを送信した時のアカウントの秘密鍵を所有している必要があります。

これらの2つのリンクのどちらも、それ自体で、権限があると見なされるべきではありません。誰でも任意のアカウントの所有権を主張するxrp-ledger.tomlファイルをホストでき、任意のアカウントオペレーターはそのDomainフィールドを任意の文字列に設定できます。両者が一致したら、いずれも同じエンティティが操作しているという強力な証拠になります。

謝辞

この仕様は、オリジナルのripple.txt仕様をもとに作成されたものであり、stellar.tomlファイルから発想を得たものです。この仕様には、XRPコミュニティメンバーと、過去および現在の多くのRipple従業員からのフィードバックも組み込まれています。