From 72e82a449b7ef9bd37bea9ab2bcb6c3a25003664 Mon Sep 17 00:00:00 2001 From: tequ Date: Tue, 12 Sep 2023 18:19:38 +0900 Subject: [PATCH] [JA] update concepts, use-cases in IA.v3 --- ...uing-and-operational-addresses-intro.ja.md | 8 +- .../accounts/cryptographic-keys.ja.md | 2 +- .../introduction/crypto-wallets.ja.md | 48 ++ .../introduction/software-ecosystem.ja.md | 60 +- .../introduction/txn-and-requests.ja.md | 114 ++++ .../introduction/what-is-the-xrp-ledger.ja.md | 69 +++ .../concepts/introduction/what-is-xrp.ja.md | 72 +++ content/concepts/payment-types/checks.ja.md | 2 +- .../payment-types/partial-payments.ja.md | 2 +- .../data-types/nftoken.ja.md | 3 +- .../transaction-types/nftokenacceptoffer.md | 2 +- .../transaction-types/payment.ja.md | 2 +- .../use-cases/defi/algorithmic-trading.ja.md | 101 ++++ content/use-cases/defi/algorithmic-trading.md | 4 +- .../defi/list-xrp-as-an-exchange.ja.md | 10 +- .../payments/peer-to-peer-payments-uc.ja.md | 53 ++ .../payments/restricting-deposits-uc.ja.md | 70 +++ .../payments/smart-contracts-uc.ja.md | 48 ++ .../tokenization/authorized-minter.ja.md | 103 ++++ .../tokenization/digital-artist.ja.md | 83 +++ .../tokenization/nft-mkt-overview.ja.md | 166 ++++++ .../tokenization/nftoken-marketplace.ja.md | 100 ++++ .../tokenization/stablecoin-issuer.ja.md | 544 ++++++++++++++++++ dactyl-config.yml | 54 +- 24 files changed, 1671 insertions(+), 49 deletions(-) create mode 100644 content/concepts/introduction/crypto-wallets.ja.md create mode 100644 content/concepts/introduction/txn-and-requests.ja.md create mode 100644 content/concepts/introduction/what-is-the-xrp-ledger.ja.md create mode 100644 content/concepts/introduction/what-is-xrp.ja.md create mode 100644 content/use-cases/defi/algorithmic-trading.ja.md create mode 100644 content/use-cases/payments/peer-to-peer-payments-uc.ja.md create mode 100644 content/use-cases/payments/restricting-deposits-uc.ja.md create mode 100644 content/use-cases/payments/smart-contracts-uc.ja.md create mode 100644 content/use-cases/tokenization/authorized-minter.ja.md create mode 100644 content/use-cases/tokenization/digital-artist.ja.md create mode 100644 content/use-cases/tokenization/nft-mkt-overview.ja.md create mode 100644 content/use-cases/tokenization/nftoken-marketplace.ja.md create mode 100644 content/use-cases/tokenization/stablecoin-issuer.ja.md diff --git a/content/_snippets/issuing-and-operational-addresses-intro.ja.md b/content/_snippets/issuing-and-operational-addresses-intro.ja.md index e708ef5f18..2bd0a046e8 100644 --- a/content/_snippets/issuing-and-operational-addresses-intro.ja.md +++ b/content/_snippets/issuing-and-operational-addresses-intro.ja.md @@ -1,5 +1,5 @@ -XRP Ledgerでは、金融機関は秘密鍵の漏えいに関連するリスクを最小限に抑えるために、複数のXRP Ledgerアドレスを使用するのが一般的です。Rippleでは、以下のように役割を分離することを強くお勧めします。 +XRP Ledgerでは、金融機関は秘密鍵の漏えいに関連するリスクを最小限に抑えるために、複数のXRP Ledgerアドレスを使用するのが一般的です。業界標準では、以下のような役割分担をしています。 -* 1つの**発行アドレス**。「コールドウォレット」とも呼ばれます。このアドレスは、レジャーでの金融機関の会計上の関係の中心となるものですが、トランザクションの送信は可能な限り少なく抑えます。 -* 1つ以上の**運用アドレス**。「ホットウォレット」とも呼ばれます。インターネットに接続した自動システムが、これらのアドレスへの秘密鍵を使用して、顧客やパートナーへの送金といった日常業務を実施します。 -* オプションの**スタンバイアドレス**。「ウォームウォレット」とも呼ばれます。信頼できる人間のオペレーターが、これらのアドレスを使用して運用アドレスに送金します。 \ No newline at end of file +* 1つの**発行アドレス**。「コールドウォレット」とも呼ばれます。このアドレスは、レジャーでの金融機関の会計上の関係の中心となるものですが、トランザクションの送信は可能な限り少なく抑えます。 +* 1つ以上の**運用アドレス**。「ホットウォレット」とも呼ばれます。インターネットに接続した自動システムが、これらのアドレスへの秘密鍵を使用して、顧客やパートナーへの送金といった日常業務を実施します。 +* オプションの**待機アドレス**。「ウォームウォレット」とも呼ばれます。信頼できる人間のオペレーターが、これらのアドレスを使用して運用アドレスに送金します。 diff --git a/content/concepts/accounts/cryptographic-keys.ja.md b/content/concepts/accounts/cryptographic-keys.ja.md index a6368b67c1..a2153b9b48 100644 --- a/content/concepts/accounts/cryptographic-keys.ja.md +++ b/content/concepts/accounts/cryptographic-keys.ja.md @@ -68,7 +68,7 @@ XRP Ledgerのトランザクションには、ネットワークがトランザ どちらの形式でもチェックサムがあるため、わずかな変更でアドレスが無効になり、他の有効なアカウントと入れ替わる可能性はありません。これにより、タイプミスや送信エラーが発生しても、間違った場所に送金されることはありません。 -すべてのアカウントID（またはアドレス）が台帳のアカウントを参照しているわけではないことを知っておくことが重要です。キーとアドレスの導出は、純粋に数学的な操作です。アカウントがXRPレジャーに情報を持つには、[XRPの支払いを受け](accounts.html#creating-accounts)、[準備金](reserves.html)を満たす必要があります。アカウントは、資金が供給されるまでトランザクションを送信することはできません。 +すべてのアカウントID（またはアドレス）が台帳のアカウントを参照しているわけではないことを知っておくことが重要です。キーとアドレスの導出は、純粋に数学的な操作です。アカウントがXRP Ledgerに情報を持つには、[XRPの支払いを受け](accounts.html#creating-accounts)、[準備金](reserves.html)を満たす必要があります。アカウントは、資金が供給されるまでトランザクションを送信することはできません。 アカウントIDやアドレスが資金提供されたアカウントを指していない場合でも、そのアカウントIDやアドレスを使用して、[レギュラーキーペア](#レギュラーキーペア)や[署名者リストのメンバー](multi-signing.html)を表すことはできます。 diff --git a/content/concepts/introduction/crypto-wallets.ja.md b/content/concepts/introduction/crypto-wallets.ja.md new file mode 100644 index 0000000000..8876377490 --- /dev/null +++ b/content/concepts/introduction/crypto-wallets.ja.md @@ -0,0 +1,48 @@ +--- +html: crypto-wallets.html +parent: intro-to-xrpl.html +blurb: ウォレットは、XRP Ledger上でユーザのXRPを管理するための便利な方法です。 +labels: + - ブロックチェーン +--- +# 暗号通貨のウォレット + +暗号通貨のウォレットは、XRP Ledger上であなたのアカウントと資金を管理する方法を提供します。多くのウォレットがありますが、最終的にはあなたのニーズとXRPを利用する上での快適さによって、適切なウォレットを選ぶことができます。 + + +## カストディアル vs ノンカストディアル ウォレット + +ウォレットを選ぶときの大きなポイントは、カストディアルウォレットにするかノンカストディアルウォレットにするかの選択です。 + +カストディアルウォレットとは、第三者があなたの資金を保持することを意味し、通常はXRP Ledger上で管理するアカウントで保持します。カストディアルウォレットは銀行のように考えることができ、あなたのお金を安全に保管するために他の組織を信頼することになります。多くの中央集権的な取引所はカストディアルウォレットを提供しており、その取引所でアカウントを作成し、そのアプリを使用する場合、厳密にはあなたはレジャー上にアカウントを持っていないことになります。 + +この種のウォレットは使い勝手がよく、パスワードを忘れても通常リセットしてもらえるため、日々の支払いにはこちらの方が望ましいかもしれません。また、XRP Ledgerのアカウントを持っていない場合、レジャーの準備金はあなたには適用されません。管理人は、あなたがXRP Ledgerで問題に遭遇した場合のバッファーの役割を果たし、あなたが何かをする方法がわからない場合、支援やサポートを提供することがあります。 + +![カストディアル vs ノンカストディアル ウォレット](img/introduction15-custodial-non-custodial.png) + +[XUMM](https://xumm.app/)のようなノンカストディアルウォレットは、あなたのアカウントの秘密鍵をあなた自身が管理するものです。つまり、アカウントのセキュリティを管理する最終的な責任はあなたにあるのです。 + +**注意:** もしキーを紛失した場合、あなたはXRP Ledgerのアカウントから切り離されてしまい、回復の方法はありません。 + +ノンカストディアルウォレットは、あなたに多くの自由を与えます。あなた自身がXRP Ledgerと直接やりとりしているので、誰にも選択肢を制限されることなく、どんな種類のトランザクションも扱うことができます。レジャーがそれを認めさえすれば、あなたは自由に取引ができるのです。また、ノンカストディアルウォレットは、あなたのお金を第三者に預ける必要がないため、自分のコントロールが及ばない市場要因から自身を守ることができます。 + +カストディアルウォレットとノンカストディアルウォレットの両方のユーザは、資金を盗み取ろうとする悪意のあるユーザから身を守る必要があります。カストディアルウォレットでは、アプリやサイトへのログインIDとパスワードを管理する必要があり、ノンカストディアルウォレットでは、オンレジャーアカウントへのシークレットキーを管理する必要があります。どちらの場合も、ソフトウェアのアップデートや依存関係を通じて攻撃者が悪意のあるコードをウォレットに読み込ませるサプライチェーン攻撃のような脆弱性から保護するために、ウォレットプロバイダ自身のセキュリティ対策も重要です。一方、カストディアルウォレットは、複数の顧客の資金に即座にアクセスできるため、攻撃者の大きな標的になり得ます。 + + +## ハードウェア vs ソフトウェア ウォレット + +また、ウォレットを選ぶ際の決め手として、ハードウェアウォレットとソフトウェアウォレットのどちらを選ぶかという点も重要です。 + +ハードウェアウォレットは、あなたの秘密鍵を保管する物理的なデバイスです。ハードウェアウォレットを使用する主な利点は、使用していないときにインターネットから切り離して情報を保護できることです。ハードウェアウォレットは、ハッキングが容易なコンピュータやスマートフォンから鍵を完全に隔離することができます。 + +![ハードウェア vs ソフトウェア ウォレット](img/introduction16-hardware-software.png) + +一方で、ソフトウェアウォレットは、完全にデジタル化されているのが特徴です。そのため、使い勝手が良い反面、安全性に劣りますが、通常、使い勝手を向上させるための追加機能が付いています。最終的に、この2つを選択するのは、あなた自身の使いやすさと、簡単であることがどれだけ重要であるかということになります。 + + +## 自分自身のウォレットを作成する + +XRP Ledgerはオープンソースプロジェクトであり、クライアントライブラリやAPIメソッドが公開されています。技術的にはHTTP/WebSocketツールを使ってレジャーとやりとりすることができますが、日常的な使用としては現実的ではありません。独自のウォレットを作成してレジャーとやり取りすることはできますが、このオプションを選択する前に、アカウント、トランザクション、レジャーがどのように連携しているかを正確に理解する必要があります。 + + +次のページ: [トランザクションとリクエスト](txn-and-requests.html) diff --git a/content/concepts/introduction/software-ecosystem.ja.md b/content/concepts/introduction/software-ecosystem.ja.md index b33f782319..9111492dad 100644 --- a/content/concepts/introduction/software-ecosystem.ja.md +++ b/content/concepts/introduction/software-ecosystem.ja.md @@ -1,64 +1,66 @@ --- html: software-ecosystem.html parent: introduction.html -blurb: XRP Ledgerソフトウェアで注目されている特性と、それらがどう組み合わさっているのか大まかに紹介します。 +blurb: どのようなXRP Ledgerソフトウェアがあり、どのように組み合わされているのか、その概要を知ることができます。 +labels: + - コアサーバ --- # ソフトウェアエコシステム -XRP Ledgerは、「価値のインターネット」を推進および実現可能にするソフトウェアプロジェクトの、深く階層化されたエコシステムの土台となるものです。XRP Ledgerとやり取りするプロジェクト、ツール、ビジネスをすべて挙げることはできないため、このページでは、一部のカテゴリーのみを取り上げ、[xrpl.org](https://xrpl.org)で説明されている主要プロジェクトを重点的にご紹介します。 +XRP Ledgerは、価値のあるインターネットを実現するソフトウェアプロジェクトの、深く階層的なエコシステムの本拠地となっています。 XRP Ledgerと相互作用する全てのプロジェクト、ツール、ビジネスをリストアップすることは不可能なので、このページではいくつかのカテゴリーを挙げ、このウェブサイトで文書化されているいくつかの中心的なプロジェクトに焦点を当てます。 +![XRPLエコシステム](img/ecosystem-apps-and-services.svg) ## スタックレベル -[![4層からなるエコシステムの図: 最下層にはXRP Ledgerのピアツーピアネットワーク、その上にプログラミングライブラリー、次にミドルウェア、そして最上層にアプリとサービスがあります。](img/ecosystem.ja.png)](img/ecosystem.ja.png) +- [_コアサーバ_](#コアサーバ)は、常にトランザクションを中継し処理するピアツーピアのネットワークであるXRP Ledgerの基盤となるものです。 -- [XRP Ledgerの基盤](#rippled-コアサーバー)は、トランザクションを共有し、[コンセンサスプロセス](consensus.html)に関与し、[トランザクション](transactions.html)を処理する常時接続のサーバーのピアツーピアネットワークです。XRP Ledgerエコシステム内の他のすべてのものが、最終的にこのピアツーピアネットワーク上に直接、または間接的に構築されます。 +- [_クライアントライブラリ_](#クライアントライブラリ)は、プログラムコードに直接インポートされるハイレベルなソフトウェアで使用され、XRP Ledgerにアクセスするためのメソッドを含んでいます。 -- [_プログラミングライブラリー_](#プログラミングライブラリー)は、さらに上位のソフトウェアに存在し、プログラムコードに直接インポートされます。また、XRP Ledgerにアクセスするためのルーチンの実装があらかじめ作成され、組み込まれています。 +- [_ミドルウェア_](#ミドルウェア)は、XRP Ledgerのデータへの間接アクセスを可能にします。多くの場合、この層のアプリケーションには、独自のデータストレージと処理が存在します。 -- [_ミドルウェア_](#ミドルウェア)は、XRP Ledgerデータへの間接アクセスを可能にします。多くの場合、この層のアプリケーションには、独自のデータストレージと処理が存在します。 - -- [_アプリとサービス_](#アプリとサービス)は、XRP Ledgerでのユーザーレベルのやり取りや、さらに上位のアプリやサービスに対する基盤を提供します。 +- [_アプリとサービス_](#アプリとサービス)は、XRP Ledgerでのユーザレベルのやり取りや、さらに上位のアプリやサービスに対する基盤を提供します。 -### rippled: コアサーバー +### コアサーバ -XRP Ledgerの中心であるピアツーピアネットワークは、コンセンサスとトランザクションプロセスのルールを実行するために、信頼性が高く、効率のよいサーバーを必要とします。Rippleでは、このサーバーソフトウェアのリファレンス実装である[**`rippled`**](xrpl-servers.html)（発音は「リップルディー」）を管理および公開しています。このサーバーは、[一般利用が可能なオープンソースライセンス](https://github.com/ripple/rippled/blob/develop/LICENSE.md)の下で使用できるため、誰でもこのサーバーの自身のインスタンスを検証し、変更することができます。また、いくつかの制限の下でそれを再公開することができます。 +XRP Ledgerの中心であるピアツーピアネットワークは、コンセンサスとトランザクションプロセスのルールを実行するために、信頼性が高く、効率のよいサーバを必要とします。XRP Ledger財団では、このサーバソフトウェアのリファレンス実装である[**`rippled`**](xrpl-servers.html)(発音は「リップルディー」)を公開しています。このサーバは、[一般利用が可能なオープンソースライセンス](https://github.com/XRPLF/rippled/blob/develop/LICENSE.md)の下で使用できるため、誰でもこのサーバの自身のインスタンスを検証し、変更することができます。また、いくつかの制限の下でそれを再公開することができます。 -`rippled`の各インスタンスは、（[Testnetなどの並列ネットワーク](parallel-networks.html)に従うように構成されていない限り）同じネットワークに同期され、ネットワーク全体のあらゆる通信にアクセスできます。ネットワーク上の各`rippled`サーバーは、最近のトランザクションの一部と、それらのトランザクションで行われた変更の記録とともに、XRP Ledger全体の最新の状態データの完全なコピーを保持します。また、各サーバーは各トランザクションを単独で処理すると同時に、そのトランザクションの結果が残りのネットワークに一致するか検証します。サーバーは、より多くの[レジャー履歴](ledger-history.html)を保持したり、[バリデータ](rippled-server-modes.html#バリデータ)としてコンセンサスプロセスに参加するように構成することができます。 +![コアサーバ](img/ecosystem-peer-to-peer.svg) -このサーバーは、データの検索、サーバーの管理、トランザクションの送信を行うための[`rippled` API](http-websocket-apis.html)をユーザーに公開します。 +各コアサーバは、（[テストネットワーク](parallel-networks.html)に従うように構成されていない限り）同じネットワークに同期され、ネットワーク全体のあらゆる通信にアクセスできます。ネットワーク上の各サーバは、最近のトランザクションと、それらのトランザクションで行われた変更の記録とともに、XRP Ledger全体の最新の状態データの完全なコピーを保持します。また、各サーバは各トランザクションを単独で処理すると同時に、そのトランザクションの結果が残りのネットワークに一致するか検証します。サーバは、より多くの[レジャー履歴](ledger-history.html)を保持したり、[バリデータ](rippled-server-modes.html#バリデータ)としてコンセンサスプロセスに参加するように構成することができます。 -### プログラミングライブラリー +コアサーバは、ユーザがデータを調べたり、サーバを管理したり、トランザクションを送信したりするために、[HTTP / WebSocket API](http-websocket-apis.html)を公開します。また、HTTP / WebSocket APIを提供するものの、ピアツーピアネットワークに直接接続せず、トランザクションを処理したりコンセンサスに参加したりしないサーバも存在します。Reportingモードで動作する`rippled`サーバやClioサーバなどのこれらのサーバは、トランザクションを処理するためにP2Pモードのコアサーバに依存しています。 -プログラミングライブラリーは、XRP Ledgerデータにアクセスするために必ずしも必要なわけではありません。HTTPまたはWebSocketを使用すれば、[`rippled` API](http-websocket-apis.html)に直接接続できるためです。ライブラリーは、`rippled` APIにアクセスする際の一般的な作業の一部を簡素化し、データをライブラリー内のプログラミング言語で理解しやすく、かつプログラミングしやすい形式に変換します。 -[JavaScript用のxrpl.js](get-started-using-javascript.html)は、長年にわたって使用され、かつ十分なサポートがある、XRP Ledgerにアクセスするためのライブラリーです。多くの[ミドルウェアサービス](#ミドルウェア)が、このような[プログラミングライブラリー](client-libraries.html)を内部で使用しています。 +### クライアントライブラリ + +ライブラリは、通常HTTP / WebSocket APIを通じてXRP Ledgerにアクセスする際の共通作業の一部をシンプルにするものです。これらは、データを様々なプログラミング言語にとってより身近で便利な形に変換し、一般的な操作の実装を備えています。クライアントライブラリの中には、XRP Ledger財団によって公式にメンテナンスされているものもあれば、コミュニティの他のエンティティによってメンテナンスされているものもあります。 + +![クライアントライブラリ](img/ecosystem-client-libraries.svg) + +ほとんどのクライアント・ライブラリのコアな機能の一つは、トランザクションをローカルで署名することであり、ユーザは秘密鍵をネットワーク上で送信する必要をなくします。 + +多くのミドルウェアサービスは、内部でクライアントライブラリを使用しています。 + +現在利用可能なクライアントライブラリについては、[クライアントライブラリ](client-libraries.html)を参照してください。 + ### ミドルウェア ミドルウェアサービスは、一方ではXRP Ledger APIを利用し、もう一方では独自のAPIを提供するプログラムです。抽象化層を提供して、いくつかの一般的な機能をサービスとして提供することで上位のアプリケーションを容易に構築できるようにします。 -[プログラムライブラリー](#プログラミングライブラリー)は、インポートしたプログラムによって新規にインスタンス化されたりシャットダウンされたりしますが、ミドルウェアはそれと異なり、多くの場合は無期限に実行され続け、独自のデータベース（リレーショナルSQLデータベースなど）や構成ファイルを持つことがあります。 +![ミドルウェア](img/ecosystem-middleware.svg) -XRP Ledger上のミドルウェアサービスの例として、[Data API](data-api.html)が挙げられます。Data APIは、XRP Ledgerデータを収集して変換することで、時間での照会、データタイプでの絞り込み、およびデータ分析を可能にします。 - -ミドルウェアサービスのもう1つの例は[XRP-API](xrp-api.html)です。XRP-APIは秘密鍵を管理し、あらゆるプログラミング言語のアプリに対してより使いやすいXRP LedgerへのRESTfulインターフェイスを提供します。 +クライアントライブラリは、インポートしたプログラムとともに新たにインスタンス化され、シャットダウンされますが、ミドルウェアサービスは通常、無期限に稼働し続け、独自のデータベース（リレーショナルSQLデータベースなど）や設定ファイルを持つことがあります。クラウドサービスとして提供されているものもあり、価格や利用方法にさまざまな制限があります。 ### アプリとサービス -最上層は、最もエキサイティングなことが起こる場所です。アプリとサービスは、XRP Ledgerに接続するための手段をユーザーとデバイスに提供します。この層では、[取引所がXRPを上場](list-xrp-as-an-exchange.html)したり、分散型取引所で使用するために[ゲートウェイが他の通貨を発行](stablecoin-issuer.html)したり、あるいはXRPを購入、売却、または単にHODLing保持するためにウォレットがユーザーインターフェイスを提供したりします。さらに高階層にサービスを追加するなど、他にも多くの可能性があります。 +最上層は、最もエキサイティングなことが起こる場所です。アプリとサービスは、XRP Ledgerに接続するための手段をユーザとデバイスに提供します。私設取引所、トークン発行者、マーケットプレイス、分散型取引所へのインターフェース、ウォレットなどのサービスは、XRPやあらゆる種類のトークンを含む様々な資産を売買・取引するためのユーザインターフェースを提供します。その他にも、さらに上位に重ねた追加サービスなど、多くの可能性が存在します。 -XRPだけでなく、通貨価値を表す他のさまざまな方法と互換性のあるアプリケーションを構築するには、XRPでの決済に[Interledger Protocol][]を使用するのが最適です。 +![アプリとサービス](img/ecosystem-apps-and-services.svg) -XRPと周辺テクノロジーを使用してユーザーとやり取りするプロジェクトには、他にも多くの例があります。 例については[XRP Ledger ビジネス](businesses.html)か、[エキスチェンジ](exchanges.html)か、[ウォレット](wallets.html)を参照してください。 - - -## 関連項目 - -- [RippleX](https://ripplex.io/) -- [技術に関するよくある質問](technical-faq.html) -- [XRPChat Links & Resources](https://www.xrpchat.com/links/) - ゲートウェイと取引所、ウォレットとストレージ、アプリなどの最新のリストが記載されています。 +このレイヤーで構築できるいくつかの例については、[ユースケース](use-cases.html)をご覧ください。 {% include '_snippets/rippled-api-links.md' %} diff --git a/content/concepts/introduction/txn-and-requests.ja.md b/content/concepts/introduction/txn-and-requests.ja.md new file mode 100644 index 0000000000..032fa44e02 --- /dev/null +++ b/content/concepts/introduction/txn-and-requests.ja.md @@ -0,0 +1,114 @@ +--- +html: txn-and-requests.html +parent: intro-to-xrpl.html +blurb: レジャーとのやりとりは、すべてトランザクションかリクエストで行われます。 +labels: + - ブロックチェーン +--- + +# トランザクションとリクエスト + +XRP Ledgerとのすべてのやり取りは、レジャーに変更を加えるトランザクションを送信するか、レジャーの情報を求めるリクエストを送信するかのいずれかとなっています。 + +## トランザクションの仕組み + +トランザクションを実行するには、RESTコマンドをXRP Ledgerに送信し、その応答を待ちます。コマンドの構文は、すべてのトランザクションで常に共通です。 + +トランザクションを行う _Account_ の _TransactionType_ とパブリックアドレスを常に提供する必要があります。 + +2つの必須のフィールドは、トランザクションの _Fee_ と、アカウントからのトランザクションの順番を決定する _Sequence_ 番号です。これらのフィールドは、トランザクションを送信する際に、レジャーサーバによって自動的に入力することができます。 + +特定のトランザクションには、トランザクションの種類に応じた必須項目も存在します。例えば、 _Payment_ トランザクションでは、 _Amount_ 値（単位は _drops_ または100万分の1XRP）と _Destination_ パブリックアドレスが必要となります。 + +以下は、JSON形式のトランザクションのサンプルです。このトランザクションは、アカウント _rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn_ から宛先アカウント _ra5nK24KXen9AHvsdFTKHSANinZseWnPcX_ へ1XRPを送金しています。 + +```json +{ + "TransactionType": "Payment", + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "Amount": 1000000, + "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX" +} +``` + +省略可能なフィールドはすべてのトランザクションで利用可能であり、特定のトランザクションでは追加のフィールドを利用することができます。必要な数だけ省略可能なフィールドを含めることができますが、すべてのトランザクションにすべてのフィールドを含める必要はありません。 + +JavaScript、Python、コマンドライン、または互換性のあるサービスから、RESTfulコマンドとしてトランザクションをレジャーに送信します。rippledサーバは、トランザクションをレジャーに提案します。 + +![トランザクションの提案](img/introduction17-gather-txns.png) + +バリデータの80%超が提案された現在のトランザクションを承認すると、その取引は永久的にレジャーの一部として記録されます。rippledサーバは、送信したトランザクションの結果を返します。 + +トランザクションについてのより詳しい解説は、[トランザクション](transactions.html)をご覧ください。 + +## リクエストの仕組み + +リクエストはレジャーから情報を取得するために使用されますが、レジャーに変更を加えることはありません。情報は誰でも自由に確認できるため、アカウント情報でサインインする必要はありません。 + +送信するフィールドは、リクエストの種類によって異なります。通常、いくつかの任意フィールドがありますが、必須フィールドは数個だけです。 + +リクエストを送信すると、rippledサーバまたはClioサーバ(リクエストに対応する専用のサーバ)で処理されます。 + +![Clioサーバ](img/introduction19-clio.png) + +ClioサーバはXRPL上の他のrippledサーバの負荷の一部を軽減し、処理速度と信頼性を向上させます。 + +これはJSON形式のリクエストのサンプルです。このリクエストは、指定したアカウントの現在のアカウント情報を取得します。 + +```json +{ + "command": "account_info", + "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn" +} +``` + +リクエストは、リクエストに使用した言語に適したフォーマットで豊富な情報を返します。以下は、アカウント情報のリクエストに対するJSON形式でのレスポンスの例です。 + +```json +{ + "result": { + "account_data": { + "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn", + "Balance": "999999999960", + "Flags": 8388608, + "LedgerEntryType": "AccountRoot", + "OwnerCount": 0, + "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42", + "PreviousTxnLgrSeq": 3, + "Sequence": 6, + "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F" + }, + "ledger_current_index": 4, + "queue_data": { + "auth_change_queued": true, + "highest_sequence": 10, + "lowest_sequence": 6, + "max_spend_drops_total": "500", + "transactions": [ + { + "auth_change": false, + "fee": "100", + "fee_level": "2560", + "max_spend_drops": "100", + "seq": 6 + }, + ... (trimmed for length) ... + { + "LastLedgerSequence": 10, + "auth_change": true, + "fee": "100", + "fee_level": "2560", + "max_spend_drops": "100", + "seq": 10 + } + ], + "txn_count": 5 + }, + "status": "success", + "validated": false + } +} +``` +Accountのフィールドについては、[アカウント](accounts.html)をご覧ください。 + +次のページ: [ソフトウェアエコシステム](software-ecosystem.html) diff --git a/content/concepts/introduction/what-is-the-xrp-ledger.ja.md b/content/concepts/introduction/what-is-the-xrp-ledger.ja.md new file mode 100644 index 0000000000..1d8a22154d --- /dev/null +++ b/content/concepts/introduction/what-is-the-xrp-ledger.ja.md @@ -0,0 +1,69 @@ +--- +html: what-is-the-xrp-ledger.html +parent: introduction.html +blurb: ブロックチェーン「XRP Ledger」についてご紹介します。 +labels: + - ブロックチェーン +--- +# XRP Ledgerとは? + +XRPは、中央集権的な機関が管理せずブロックチェーン暗号を用いた分散型システムであるXRP Ledgerによってトランザクションが検証され記録が管理されるデジタル通貨です。 + + +## ブロックチェーンとは? + +ブロックチェーンは、連続的に変化するデータのリストです。ブロックチェーンは、データのブロックからなります。 + +![データのブロック](img/introduction2-data-block.png) + +信頼できるバリデータノードのグループが、データが有効であるとのコンセンサスを得ます。 + +![バリデータノード](img/introduction3-validators.png) + +ブロックは、非常に精巧で複雑な、コンピュータで生成された、16進数64文字の暗号化されたハッシュ値で一意に識別されます。 + +![暗号化されたハッシュ値](img/introduction4-hash.png) + +また、ブロックは、作成時刻を示すタイムスタンプで識別されます。 + +![タイムスタンプ](img/introduction5-time-stamp.png) + +各バリデータノードはデータブロックの各自のコピーを保持します。単一の中央機関は存在しません。すべてのコピーが同一に有効です。 + +![有効なコピーを持つバリデータ](img/introduction6-valid-copies.png) + +各ブロックは、前のブロックへのリンクとしてハッシュポインタを含んでいます。また、タイムスタンプ、新しいデータ、独自のハッシュ値も持っています。 + +![ハッシュポインタ](img/introduction7-two-blocks.png) + +この構造により、各ブロックはチェーンの中で明確な位置を持ち、前のデータブロックにリンクしています。これにより、ブロックの不変的なチェーンが形成されます。前のブロックをたどることで、チェーン上の現在のすべての情報を常に確認することができます。 + +![3つのデータブロック](img/introduction8-3-blocks.png) + +設計上、ブロックチェーンはデータの改変に耐性があります。すべての台帳ノードは、ブロックチェーンの正確なコピーを取得します。 + +![ブロックチェーンの同一コピーを持つ2人のバリデータ](img/introduction9-2-sets-of-3.png) + +これにより、当事者間のトランザクションを効率よく、検証可能かつ永続的に記録するオープンな分散型台帳ができあがります。 + +一度記録されたブロックのデータは、バリデータの大多数が変更に同意しない限り、過去にさかのぼって変更することはできません。もし同意した場合、それ以降のブロックはすべて同じように変更されます（非常に稀で極端なケースです）。 + +### 連合コンセンサスプロセスのしくみ + +XRPLのrippledサーバのほとんどは、トランザクションを監視または提案します。サーバの重要なサブセットはバリデータとして実行されます。これらの信頼できるサーバは、新しいトランザクションのリストを新しく作成可能なレジャーインスタンス（ブロックチェーンにおける新しいブロック）に蓄積します。 + +![トランザクションの収集](img/introduction17-gather-txns.png) + +バリデータはそのリストを他のすべてのバリデータと共有します。バリデータは互いの変更案を取り入れ、新しいバージョンのレジャー案を配布します。 + +![80%のコンセンサス](img/introduction18-80-percent-consensus.png) + +80%超のバリデータが一連のトランザクションに合意すると、チェーンの末尾に新しいレジャーインスタンスを作成し、再びプロセスを開始します。このコンセンサスプロセスには4～6秒かかります。レジャーインスタンスが作成される様子は、[https://livenet.xrpl.org/](https://livenet.xrpl.org/)にて、リアルタイムで確認することができます。 + +### どのようなネットワークがありますか？ + +XRPLは、rippledサーバの自分のインスタンスをセットアップして接続したい人なら誰でも参加できます。ノードは、ネットワークを監視したり、トランザクションを実行したり、バリデータになったりすることができます。 + +自己資金を投入せずにXRPLの機能を試したい開発者や新規ユーザのために、 _Testnet_ と _Devnet_ という2つの開発者向けの環境が用意されています。ユーザは(偽の)1,000XRPの資金を得てアカウントを作成し、どちらの環境にも接続してXRPLとやり取りすることができます。 + +次のページ: [XRPとは?](what-is-xrp.html) diff --git a/content/concepts/introduction/what-is-xrp.ja.md b/content/concepts/introduction/what-is-xrp.ja.md new file mode 100644 index 0000000000..340ead7c32 --- /dev/null +++ b/content/concepts/introduction/what-is-xrp.ja.md @@ -0,0 +1,72 @@ +--- +html: what-is-xrp.html +parent: introduction.html +blurb: XRP Ledgerで取引される暗号通貨、XRPについてご紹介します。 +labels: + - ブロックチェーン +--- +# XRPとは? + +XRPはXRP Ledgerにて使用可能な暗号通貨です。 + +## 暗号通貨とは? + +暗号通貨は、暗号技術によって保護され、ブロックチェーンを使用して追跡されるデジタルまたは仮想通貨です。暗号通貨のセキュリティと完全性により、偽造や二重支払いはほぼ不可能です。 + +![ブロックチェーン上のXRPL](img/introduction10-xrp-on-chain.png) + +暗号通貨、デジタル通貨、デジタル資産は、すべて同じ一般的なカテゴリに分類されます。暗号通貨とは次のようなものを指します。 + +- デジタルネイティブ(インターネット向けに作られたものを意味します) +- プログラム可能 +- 低コストで速い送金 +- オープンで透明性が高い +- 国家、政府の枠にとらわれない(他国の資金を預かるノストロ口座は必要ない) +- 偽造できない +- 銀行口座や決済のためのインフラに依存しない + +![暗号通貨の利点](img/introduction11-all-the-things.png) + +暗号通貨は _代替可能トークン_ です。 _代替可能_ とは、あるトークンを同じ価値の他のトークンに置き換えることができるという意味です。郵便切手は代替可能（相対的な価値が一致し、交換可能）であるため、手紙を出すのに50セントかかる場合、25セント切手を2枚使うか、10セント切手を5枚使って郵便料金を支払うことが出来ます。 + +暗号通貨は分散型でもあります。通貨を管理する中央機関がないのです。一度でもトランザクションがブロックチェーンに登録されると、それを変更することはできません。暗号通貨を検閲することは困難です。システムが十分に分散化されている限り、誰もトランザクションをロールバックしたり、残高を凍結したり、誰かが分散化されたデジタル資産を使うことをブロックしたりすることはできません。あらゆる参加者の間で大きな合意がなければルールが変更されることはありません。 + +暗号通貨が投資家や開発者にとって魅力的なのは、単一の事業者が「電源を切って」暗号通貨を消滅させることができないからです。 + +## しかし、なぜそれが価値あるのでしょうか？ + +![暗号通貨の利点](img/introduction12-diamond.png) + +暗号通貨がコンピュータのデータのみに基づくものであり、貴金属のような有形の商品には基づかないというのは、一見不思議に思えるかもしれません。歴史的に見ると、通貨は牛や貝殻、希少金属、石などの物理的な物に基づいています。しかし、これらのものは、ある文化圏の人々の間で合意があったからこそ価値を持つものでした。 + +実物を手にした方が安心と思われるかもしれませんが、多くの人は、金と実物、ダイヤモンドとキュービックジルコニアを見分けることはできません。紙幣も偽造されることがあります。ポケットに10ドル札を入れているのを忘れて、洗濯でダメにしてしまうこともあります。支払いのために価値のあるものを安全に保管し、輸送するのにはコストがかかります。 + +暗号通貨の価値は、保有者が通貨に寄せる信頼から生まれます。記録が分散していることや、資金を保護するための暗号的セキュリティ対策を考えると、暗号通貨は従来の不換紙幣よりもはるかに堅牢で安全、かつ便利な通貨形態と考えることができるのではないでしょうか。 + + +## 暗号通貨であるXRPL + +XRP Ledgerは、2011年から2012年初頭にかけて、Jed McCaleb、Arthur Britto、David Schwartzによって開発されました。2012年9月、JedとArthurはChris LarsenとともにRippleと名の会社（当時はOpenCoin Inc.という会社）を設立し、Ripple社がXRP Ledger上で開発を行う代わりに、800億XRPをRipple社へ譲渡することを決定しました。 + +![男性と1XRP](img/introduction13-x-prefix.png) + +それ以来、同社はXRPを定期的に売却し、XRP市場の強化とネットワーク流動性の向上に利用し、より大きなエコシステムの発展を促してきました。2017年、同社は[550億XRPをエスクローに預け](https://ripple.com/insights/ripple-escrows-55-billion-xrp-for-supply-predictability/?__hstc=78174987.8aa695b6d0420a940041f1842edfd8a6.1692378128025.1692644550213.1692652561840.8&__hssc=78174987.3.1692652561840&__hsfp=3379522993)、当面の間、一般供給量に入る量が[予測可能に成長する](https://ripple.com/insights/ripple-to-place-55-billion-xrp-in-escrow-to-ensure-certainty-into-total-xrp-supply/?__hstc=78174987.8aa695b6d0420a940041f1842edfd8a6.1692378128025.1692644550213.1692652561840.8&__hssc=78174987.3.1692652561840&__hsfp=3379522993)ことを保証しました。Ripple社の[XRPマーケットパフォーマンスサイト](https://ripple.com/xrp/?__hstc=78174987.8aa695b6d0420a940041f1842edfd8a6.1692378128025.1692644550213.1692652561840.8&__hssc=78174987.3.1692652561840&__hsfp=3379522993)は、同社が現在利用可能でエスクローにロックされているXRPの量を報告しています。 + +![1,000億を表す "B "](img/introduction14-hundred-billion.png) + +### 名称 + +元々、XRP Ledgerは、その技術が[複数のホップと通貨を通じて波及(ripple)する](rippling.html)支払いを可能にする方法から「リップル」と呼ばれていました。Ledgerに組み込まれたネイティブアセットについて、クリエイターたちは「リップルクレジット」または「リップル」という用語と、[ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)標準の非国家通貨を表すX接頭辞から「XRP」というティッカーシンボルを選びました。同社は「Ripple Labs」として登録。「XRP」という名称は、技術や会社の類似した名称との混同を避けるため、あらゆる文脈で資産を指すために使用されるようになり、最終的に同社は自らの名称を「Ripple」に短縮しました。2018年5月、[コミュニティは、それまで会社とデジタル資産の両方に使用されていたトリスケリオンのロゴと区別するために、XRPを表す新しい「X」のシンボル](https://twitter.com/xrpsymbol/status/1006925937571713025)を選択しました。 + +| XRPの"X"ロゴ | Ripple社のトリスケリオン | +|:-------------------------------------|:-------------------------------------------| +| !["X"ロゴ](assets/img/xrp-x-logo.png) | ![トリスケリオン](img/ripple-triskelion.png) | + + +### 商標 + +「XRP」は、米国や中国、エストニアなどの国々におけるXRPL財団の登録商標です。 + +この商標出願は2013年に米国特許商標庁（USPTO）に登録され、OpenCoin IncとRipple Labs Incが譲受人となっています。2022年に商標の譲渡が更新され、現在はMITTETULUNDUSÜHING XRP LEDGER TRUST（「XRPLF」）に譲渡されています。 + +次のページ: [暗号通貨のウォレット](crypto-wallets.html) diff --git a/content/concepts/payment-types/checks.ja.md b/content/concepts/payment-types/checks.ja.md index fcfd97dd4d..7785c86374 100644 --- a/content/concepts/payment-types/checks.ja.md +++ b/content/concepts/payment-types/checks.ja.md @@ -36,7 +36,7 @@ XRP Ledger Checksは、XRP Ledgerに固有の問題も解決できます。た ### ユースケース: 支払いの承認 -**課題:** [BSA、KYC、AML、CFT](stablecoin-issuer.html#compliance-guidelines)などの規制に準拠するにあたり、金融機関は受領する資金の送金元に関する文書を提出する必要があります。違法な資金移動を防止するため、これらの規制は金融機関に対して、処理済のすべての支払いについて、その送金元と送金先を開示するよう義務付けています。XRP Ledgerの性質上、誰でもXRPを（および該当する場合には発行済み通貨を）XRP Ledger上の金融機関のアカウントに送金することができます。金融機関のコンプライアンス部門では、このような不審な支払いへの対応にかかるコスト（罰金の可能性を含む）の増大と処理の遅れが生じます。 +**課題:** [BSA、KYC、AML、CFT](stablecoin-issuer.html#コンプライアンス指針)などの規制に準拠するにあたり、金融機関は受領する資金の送金元に関する文書を提出する必要があります。違法な資金移動を防止するため、これらの規制は金融機関に対して、処理済のすべての支払いについて、その送金元と送金先を開示するよう義務付けています。XRP Ledgerの性質上、誰でもXRPを（および該当する場合には発行済み通貨を）XRP Ledger上の金融機関のアカウントに送金することができます。金融機関のコンプライアンス部門では、このような不審な支払いへの対応にかかるコスト（罰金の可能性を含む）の増大と処理の遅れが生じます。 **解決策:** 金融機関は各自のXRP Ledgerのアカウントで、[`AccountSet`トランザクションの`asfDepositAuth`フラグを設定](accountset.html)することにより、[Deposit Authorization](depositauth.html)を有効にできます。これにより、アカウントはPaymentトランザクションを受領できなくなります。Deposit Authorizationが有効なアカウントは、Escrow、Payment Channel、またはChecksでのみ資金を受領できます。Deposit Authorizationが有効な場合、Checksが最もシンプルで使いやすく、柔軟な資金移動手段となります。 diff --git a/content/concepts/payment-types/partial-payments.ja.md b/content/concepts/payment-types/partial-payments.ja.md index 8750bb24b7..1a29280474 100644 --- a/content/concepts/payment-types/partial-payments.ja.md +++ b/content/concepts/payment-types/partial-payments.ja.md @@ -8,7 +8,7 @@ labels: --- # Partial Payment -デフォルトのケースでは、XRP Ledgerの[Paymentトランザクション][]の`Amount`フィールドに、為替レートと[送金手数料](transfer-fees.html)を差し引いた実際の送金額が指定されます。「Partial Payment」フラグ（[**tfPartialPayment**](payment.html#paymentのフラグ)）を使うと、送金額を増額する代わりに受取金額を減額して、支払を正常に実行できます。Partial Paymentは、追加コストなしで[支払を返金](stablecoin-issuer.html#bouncing-payments)したい場合に便利です。 +デフォルトのケースでは、XRP Ledgerの[Paymentトランザクション][]の`Amount`フィールドに、為替レートと[送金手数料](transfer-fees.html)を差し引いた実際の送金額が指定されます。「Partial Payment」フラグ（[**tfPartialPayment**](payment.html#paymentのフラグ)）を使うと、送金額を増額する代わりに受取金額を減額して、支払を正常に実行できます。Partial Paymentは、追加コストなしで[支払を返金](stablecoin-issuer.html#不明な入金の返金)したい場合に便利です。 [トランザクションコスト](transaction-cost.html)に使用されるXRPの額は、トランザクションタイプに関わらず常に送金元のアカウントから差し引かれます。 diff --git a/content/references/protocol-reference/data-types/nftoken.ja.md b/content/references/protocol-reference/data-types/nftoken.ja.md index af301aad7b..d2e1188a77 100644 --- a/content/references/protocol-reference/data-types/nftoken.ja.md +++ b/content/references/protocol-reference/data-types/nftoken.ja.md @@ -108,7 +108,6 @@ URIフィールドは、`NFToken`に関連するデータまたはメタデー **注意:** URIは変更不可能であるため、例えば、存在しないウェブサイトにリンクしていたとしても、誰もそれを更新することはできません。 # NFTokenデータとメタデータの取得 -# Retrieving NFToken Data and Metadata {.invisible} 機能を犠牲にしたり不必要な制限を課したりすることなく`NFTokens`の容量を最小にするために、XRPL NFTは任意のデータフィールドを持ちません。その代わり、データは別に管理され、`NFToken`によって参照されます。URIは`Hash`に対して不変のコンテンツへの参照を提供し、`NFToken`オブジェクトに対しては任意の変更可能なデータを提供します。 @@ -130,7 +129,7 @@ xrpl-nft-data-token-info-v1 IN TXT "https://host.example.com/api/token-info/{tok https://example.com/.well-known/xrpl-nft/{tokenid} ``` -`NFTokenMint`トランザクションを使用して`NFTtoken`を作成します。`NFTokenBurn`トランザクションを使用して`NFToken`を破棄することもできます。 +`NFTokenMint`トランザクションを使用して`NFToken`を作成します。`NFTokenBurn`トランザクションを使用して`NFToken`を破棄することもできます。 {% include '_snippets/rippled-api-links.md' %} diff --git a/content/references/protocol-reference/transactions/transaction-types/nftokenacceptoffer.md b/content/references/protocol-reference/transactions/transaction-types/nftokenacceptoffer.md index 859518754a..a5b8645ce2 100644 --- a/content/references/protocol-reference/transactions/transaction-types/nftokenacceptoffer.md +++ b/content/references/protocol-reference/transactions/transaction-types/nftokenacceptoffer.md @@ -57,7 +57,7 @@ The semantics of brokered mode are slightly different than direct mode: the acco If the transaction succeeds: -- The `NFTtoken` changes ownership, meaning that the token is removed from the `NFTokenPage` of the existing owner and added to the `NFTokenPage` of the new owner. +- The `NFToken` changes ownership, meaning that the token is removed from the `NFTokenPage` of the existing owner and added to the `NFTokenPage` of the new owner. - Funds are transferred from the buyer to the seller, as specified in the `NFTokenOffer`. If the `NFToken` has a transfer fee, then its issuer receives the specified percentage, and the rest goes to the seller. The transaction fails with a [`tec`-class code](tec-codes.html) if: diff --git a/content/references/protocol-reference/transactions/transaction-types/payment.ja.md b/content/references/protocol-reference/transactions/transaction-types/payment.ja.md index 21b95c584a..2e756613cb 100644 --- a/content/references/protocol-reference/transactions/transaction-types/payment.ja.md +++ b/content/references/protocol-reference/transactions/transaction-types/payment.ja.md @@ -105,7 +105,7 @@ Payment型のトランザクションについては、[`Flags`フィールド]( ## Partial Payments -Partial Paymentsを利用すると、受取られる金額を減額することによって、支払いを成功させることができます。Partial Paymentsが有用なのは、追加的なコストを発生させずに[支払いを返金](stablecoin-issuer.html#bouncing-payments)する場合です。その一方で、成功したトランザクションの`Amount`フィールドに、送金された金額が常に正しく記述されていることを前提としている環境において、悪用されるおそれもあります。 +Partial Paymentsを利用すると、受取られる金額を減額することによって、支払いを成功させることができます。Partial Paymentsが有用なのは、追加的なコストを発生させずに[支払いを返金](stablecoin-issuer.html#不明な入金の返金)する場合です。その一方で、成功したトランザクションの`Amount`フィールドに、送金された金額が常に正しく記述されていることを前提としている環境において、悪用されるおそれもあります。 Partial Paymentsとは、**tfPartialPayment**フラグが有効になっている[Paymentトランザクション][]です。Partial Paymentsは、`SendMax`値を超える金額を送金することなく、`DeliverMin`フィールド以上の正の金額（`DeliverMin`が指定されていない場合、任意の正の金額）を送金する場合に成功します。 diff --git a/content/use-cases/defi/algorithmic-trading.ja.md b/content/use-cases/defi/algorithmic-trading.ja.md new file mode 100644 index 0000000000..c3f309dbd6 --- /dev/null +++ b/content/use-cases/defi/algorithmic-trading.ja.md @@ -0,0 +1,101 @@ +--- +html: algorithmic-trading.html +parent: defi-uc.html +blurb: XRP Ledgerの分散型取引所は、ユーザがトレードを行う際にオンデマンドで追跡される無制限の通貨ペアで構成されています。 +labels: + - トランザクション +--- +# アルゴリズムトレード + +XRP Ledgerの分散型取引所(DEX)には、「アルゴリズムトレード」によって収益を得る機会があります。アルゴリズムトレードでは通常、定量的な要因に基づいて多くのトレードを行い、安定した小さな利益を得ます。これは、市場のファンダメンタルズに基づいて少数の長期投資を行い、時間をかけて大きなリターンを得るのを待つ伝統的な手動トレードとは異なります。暗号通貨は一般的にボラティリティが高いため、伝統的な「バイ・アンド・ホールド」投資には適していませんので、ブロックチェーンは多くの場合、手動トレードよりもアルゴリズムトレードに適しています。 + +- 分散型取引所のデータはパブリックで自由に利用できます。 +- 取引は数秒で決済されるため、専門的な機材なしで高頻度トレードが可能です。 +- XRP Ledgerのトランザクションコストは低額です。 + +## トレード戦略 + +アルゴリズムトレードは、さまざまな戦略によって利益を上げることができます。アルゴリズムトレードの難しさ（あるいは楽しさ）の一つは、独自のアプローチを設計し、実行することです。アルゴリズムトレードのアプローチを大まかに分類すると、次のようになります。 + +- **裁定取引(アービトラージ):** 価格差を利用した資産の購入と即時売却。これは、価格が一致していない3つ以上の資産のセットを見つけたり、XRP Ledgerを使って価格が異なる取引所(CEX)間で資産を移動させたりすることを含みます。 +- **定量取引:** 過去の値動き、外部データ、またはその両方に基づいて将来の値動きを予測し、それを利用すること。例えば、[ローソク足パターン](https://blog.quantinsti.com/candlestick-patterns-meaning/)、資産の値動きと他の資産との相関関係、ソーシャルメディアのセンチメント分析などがあります。 +- **フロントランニング:** 保留中のトレード、特に大きなトレードを利用し、そのトレードが買っている資産を買ってすぐに転売すること。フロントランニングは、流動性を追加することなく他のトレーダーから利益を奪ったり、他の方法では発生しないトレードを可能にするため、しばしば嫌われます。XRP Ledgerの取引の正規順序は、フロントランニングを困難にしていますが、不可能ではありません。 + +### 裁定取引(アービトラージ)の例 + +裁定取引を行うには、XRP Ledgerの内部と関連する部分の両方で、多くの方法があります。以下の例は潜在的な戦略を説明するためのものですが、他の方法も可能です。 + +**循環支払い**を利用して、マルチアセットトレードを完了し利益を得ることができます。XRP Ledgerは、XRPが真ん中のアセットである3つのアセットセットセットと同様に、アセットペア間の重複した取引を自動的に接続します。しかし、XRP Ledgerのプロトコルは、他のより長い、あるいはより複雑な経路のトレードを自動的に見つけて競うことはしません。(可能な限り最善の経路を見つけることは、計算集約型な問題のカテゴリとして知られています。)したがって、XRP Ledgerが独自の経路を見つける場合、XRP Ledgerのプロトコルは自動的に他の、より長い、あるいはより複雑な経路の取引を見つけ、競争させることはありません。したがって、自分で経路探索(PathFinding)を行えば、このような有益な裁定取引の機会を見つけることが可能です。その場合は、[Paymentトランザクション](payment.html)でそれらの[経路(Paths)](paths.html)を明示的に指定できます。1つのFOOを使って2つのBARを買い、その2つのBARを使って3つのTSTを買い、最後に3つのTSTを使って1.1 FOOを買えば、0.1 FOOから取引に関わるトークンの[送金手数料](transfer-fees.html)などのコストを差し引いた利益を得ることができます。 + +資産の価格が異なる複数の取引所(CEX)に口座を持っている場合、**取引所間の裁定取引**を行うことができます。例えば、ACME取引所でXRPを1XRPあたり0.45ドルで購入し、そのXRPをWayGate取引所に移動して1XRPあたり0.50ドルで売却した場合、XRPあたり0.05ドルの利益を得ることができます。より複雑な例として、ACME取引所でBTC:ETHの価格が変動し、BTCに対してETHが安くなった場合、ある取引所でETH→XRPを売却し、そのXRPをACME取引所に移動し、XRP→BTC→ETHを取引して利益を得ることで、この価格変動を利用できる可能性があります。XRP Ledgerの取引は数秒で決済されますが、イーサリアムの取引は数分、ビットコインの取引は数時間かかることがあるため、XRPをブリッジ通貨として使用することで、ACME取引所でETH→BTC→BTC→ETHと取引するよりも早くこの機会を利用できる可能性があります。(これはもちろん、XRPへの交換が利益以上のコストにならないだけの十分な流動性と狭いスプレッドがある場合にのみ機能します) + + +## 背景 + +アルゴリズムトレードの一般的な知識については、以下のリソースをご覧ください。 + +- [Investopedia: Basics of Algorithmic Trading: Concepts and Examples](https://www.investopedia.com/articles/active-trading/101014/basics-algorithmic-trading-concepts-and-examples.asp) +- [_Flash Boys: A Wall Street Revolt_ by Michael Lewis](https://wwnorton.com/books/Flash-Boys/) +- [Investopedia: How Arbitraging Works in Investing, With Examples](https://www.investopedia.com/terms/a/arbitrage.asp) + +以下のページでは、XRP Ledgerの分散型取引所の仕組みについて説明しています。 + +- [トークン](tokens.html) +- [分散型取引所](decentralized-exchange.html) +- [オファー](offers.html) + + +## テストとよくある間違い + +どのような取引でもそうですが、アルゴリズムトレー ドは確実に儲かる方法ではありません。手作業によるトレードと比べると、アルゴリズムトレードはエラーの余地が非常に少なくなります。小さなミスを犯しても、そのミスを大量のトレードで倍増させようとすれば、問題を修正する前に損失があっという間に膨らんでしまいます。したがって、自分のトレード戦略が実際に利益を上げるかどうかを確認するために、さまざまなテストを行うのが賢明です。戦略やその実際の実装（よく _ボット_ と呼ばれます）をテストするために、次のようなことを行うことができます。 + +- 現在のレジャーの状態または過去のトレードに基づいて、潜在的な利益を手動で計算します。 +- 過去のデータを記録してボットに送り、ボットがどのようなアクションを取ったかを記録し、実際の過去の値動きと結果を比較します。 +- 将来の様々なシナリオをモデル化し、その結果を予測します。 + +このような計算やボットの作成においては、よく次のような間違いが存在します。 + +- **丸め誤差**: 計算が適切でなかったり、ブロックチェーンが使用する精度と一致しなかったりすると、トレード結果を不正確に予測して損失を出したり、トレードが全く実行されなかったりする可能性があります。XRP Ledgerは、トークンとXRPの量に異なる精度を使用しているため、一方を他方に交換する際、予期せぬ場所で四捨五入される可能性があります。プロトコルで使用される精度の詳細については、[通貨フォーマット](currency-formats.html)をご覧ください。 + - トークンの発行者は、トークンに関わる取引レートの精度をより詳細に制限できることに注意してください。詳しくは[Tick Size](ticksize.html)をご覧ください。 + - 通常、四捨五入の違いや、計算時と約定時の値動きの違いを考慮し、金額を調整する必要があります。この金額は「スリッページ」と呼ばれ、適切な金額を設定することが重要です。スリッページが低すぎると、トレードがまったく約定しない可能性があります。一方、スリッページが高すぎると、フロントランニングの影響を受けやすくなり、スリッページが高ければ高いほど、値動きによって利益が削られる可能性が高くなります。 +- **余分なコストと遅延を考慮しないこと**: 例えば、2つのステーブルコインの裏付けが米ドルであるにもかかわらず、ある発行者が0.5%の送金手数料を請求し、別の発行者が0.25%の[送金手数料](transfer-fees.html)を請求した場合、そのステーブルコインの取引価格には約0.25%の差が生じます。トランザクションを送信するためのコストは、通常は少額ですが、その他の潜在的な遅延の影響も忘れないでください。例えば、オフレジャーの取引所が現時点で有利な価格を示していたとしても、その取引所の入金処理に数時間から数日かかる場合、その取引所で事前に流動性を持っていない限り、その価格を利用することはできません。 +- **稀な事象を考慮していないこと**: 前例のない出来事（「ブラック・スワン」）はさておき、個々の異常値によって計算結果がゆがむことがあります。一例として(これは実話ですが)、あるトレーダーが、ある戦略の潜在的な利益を特定の時間帯で計算したところ、利益の80％以上が、他のユーザが誤って価格にゼロを追加してしまった1つの「入力ミス」の取引によるものであったと報じました。同じ戦略を、これらの異常値の取引を含まない時間範囲に対して計算すると、利益ははるかに少なくなりました。 +- **トランザクションのフラグを確認しないこ**と: XRP Ledgerのトランザクションのフラグは、そのトランザクションの処理方法や、プロトコルがそれを「成功」とマークするタイミングに大きな影響を与える可能性があります。例えば、"Offer"トランザクションのフラグは、全額がすぐに得られる場合にのみトレードされる"Fill or Kill"注文にすることができます。"Payment"トランザクションのフラグは、意図した宛先に全額を届けることができなくても成功する[partial payments](partial-payments.html)にすることができます。トランザクションの`Flags`フィールドを解析するためにビット演算をする必要がありますが、それをスキップしてしまうと、予想と結果が全く異なったものとなってしまう可能性があります。 + +## 税金とライセンス + +ブロックチェーン上でトレードを行うための法的要件は、法域によって異なります。多くの場合、ライセンスやその他の法的な障壁はありませんが、特に利益または損失がいくつかの基準値を超える場合、税務上の利益を報告する必要がある場合があります。米国では通常、トレードで得た利益(または損失)をキャピタルゲインとして報告します。つまり、購入した資産の取得時の原価を計算する必要があります。個々の状況に応じて、トレード活動を追跡したり、適切な納税申告書を作成するのに役立つ様々なツールがあります。トレードする資産やトレード戦略によって、詳細は異なります。アルゴリズムトレードを始める前に、必ず税務の専門家に相談するか、よく調べてください。 + + +## 技術的な詳細 + +### トレードの発注 + +XRP Ledgerの分散型取引所で_代替可能_トークンとXRPを売買するには、通常[OfferCreateトランザクション](offercreate.html)を送信します。この方法でトレードを行うためのコードと技術的ステップの詳細なウォークスルーについては、[分散型取引所でのトレード](trade-in-the-decentralized-exchange.html)をご覧ください。[Paymentトランザクション](payment.html)を使用して通貨を両替することも可能です。[クロスカレンしー支払い](cross-currency-payments.html)を他のユーザに送ったり、長い[パス](paths.html)を使って裁定取引の機会を1つの操作にまとめることで、自分自身に送り返すこともできます。 + +NFTをトレードするためのコードと技術的な手順については、[JavaScriptを使用したNFTokenの送信](transfer-nfts-using-javascript.html)を参照してください。 + +### トレードデータの確認 + +XRP Ledgerのトレード活動に関する情報源は数多くあります。トレード戦略やユースケースによっては、[公開サーバ](public-servers.html)を通してXRP Ledgerに接続することができるかもしれませんが、多くの場合、自分自身のサーバを稼働させることで利益を得ることができます。P2Pモードでコアサーバをセットアップする方法については、[`rippled`のインストール](install-rippled.html)をご覧ください。 + +他のトレード活動を追跡するアプローチの場合、トレード額を正確に知るためにトランザクションの詳細なメタデータを確認する必要があるかもしれません。オファーは部分的に約定することがあり、複数の一致するオファーを約定することがあります。トランザクションメタデータの解釈方法の詳細については、[トランザクションの結果の確認](look-up-transaction-results.html)をご覧ください。 + +利益確定のチャンスに反応する時間をできるだけ多く確保するために、[オープンレジャー](open-closed-validated-ledgers.html)から保留中のデータを見たり、提案されているトランザクションをモニタリングしたりすることもできます。WebSocketに接続している場合、`transactions_proposed`ストリームで[subscribeメソッド](subscribe.html)を使用すると、コンセンサスによって検証される前のトランザクションを見ることができます。また、`accounts_proposed`パラメータを使用してsubscribeすることで、特定のアカウント（例えば、トレードに興味のあるトークンの発行者）に影響するトランザクションのサブセットに限定することもできます。 + +### 今後の展開 + +Ripple社はXRP Ledger プロトコルを拡張し、既存の中央指値注文ベース(CLOB)の分散型取引所と連携するネイティブな自動マーケットメーカー(AMM)の機能を追加することを提案しました。この提案が受け入れられ、[amendments](amendments.html)として有効になれば、AMMはXRP Ledger上のトレードにおいて重要な要素となるでしょう。詳しくは以下のリンクをご覧ください。 + +- [XLS-30d: Automated Market Maker 規格草案](https://github.com/XRPLF/XRPL-Standards/discussions/78) +- [AMMドキュメント (Ripple社のオープンソースのサイト)](https://opensource.ripple.com/docs/xls-30d-amm/automated-market-makers/) + +## さらに詳しく + +次の記事では、これらの戦略が他のブロックチェーンでどのように機能するかについて、より具体的な例や興味深い情報を提供しています。これらの情報は、始めるために必要なものではありませんが、新たな視点を得るのに役立つかもしれません。 + +- [Ethereum is a Dark Forest](https://www.paradigm.xyz/2020/08/ethereum-is-a-dark-forest) +- [Flash Boys 2.0: Frontrunning, Transaction Reordering, and Consensus Instability in Decentralized Exchanges (PDF)](https://arxiv.org/pdf/1904.05234.pdf) +- [Slippage in AMM Markets](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4133897) +- [Frontrunner Jones and the Raiders of the Dark Forest: An Empirical Study of Frontrunning on the Ethereum Blockchain](https://www.usenix.org/conference/usenixsecurity21/presentation/torres) +- [SoK: Transparent Dishonesty: front-running attacks on Blockchain (PDF)](https://arxiv.org/pdf/1902.05164) diff --git a/content/use-cases/defi/algorithmic-trading.md b/content/use-cases/defi/algorithmic-trading.md index 1f0ab168cf..56f9843a55 100644 --- a/content/use-cases/defi/algorithmic-trading.md +++ b/content/use-cases/defi/algorithmic-trading.md @@ -11,7 +11,7 @@ The XRP Ledger's decentralized exchange presents an opportunity to earn money th - Decentralized exchange data is public and freely available. - Trades settle in seconds, enabling frequent trading without specialized equipment. -- Transaction fees on the XRP Ledger are low. +- Transaction costs on the XRP Ledger are low. ## Trading Strategies @@ -98,4 +98,4 @@ The following articles provide some more specific examples and interesting infor - [Flash Boys 2.0: Frontrunning, Transaction Reordering, and Consensus Instability in Decentralized Exchanges (PDF)](https://arxiv.org/pdf/1904.05234.pdf) - [Slippage in AMM Markets](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=4133897) - [Frontrunner Jones and the Raiders of the Dark Forest: An Empirical Study of Frontrunning on the Ethereum Blockchain](https://www.usenix.org/conference/usenixsecurity21/presentation/torres) -- [SoK: Transparent Dishonesty: front-running attacks on Blockchain (PDF)](https://arxiv.org/pdf/1902.05164) \ No newline at end of file +- [SoK: Transparent Dishonesty: front-running attacks on Blockchain (PDF)](https://arxiv.org/pdf/1902.05164) diff --git a/content/use-cases/defi/list-xrp-as-an-exchange.ja.md b/content/use-cases/defi/list-xrp-as-an-exchange.ja.md index ab47fb5726..d5dd129978 100644 --- a/content/use-cases/defi/list-xrp-as-an-exchange.ja.md +++ b/content/use-cases/defi/list-xrp-as-an-exchange.ja.md @@ -41,17 +41,17 @@ XRPをサポートするために、Alpha Exchangeでは以下を行う必要が 関連項目: -* [ゲートウェイコンプライアンス](stablecoin-issuer.html#compliance-guidelines) — ゲートウェイと取引所は異なりますが、取引所は地域の規制に準拠し、適切な当局の監督下になければなりません。 +* [コンプライアンス指針](stablecoin-issuer.html#コンプライアンス指針) — ゲートウェイと取引所は異なりますが、取引所は地域の規制に準拠し、適切な当局の監督下になければなりません。 -* [Requirements for Sending to XRP Ledger](stablecoin-issuer.html#requirements-for-sending-to-xrp-ledger) +* [XRP Ledgerへ送金するための要件](stablecoin-issuer.html#xrp-ledgerへ送金するための要件) -* [Requirements for Receiving from XRP Ledger](stablecoin-issuer.html#requirements-for-receiving-from-xrp-ledger) +* [XRP Ledgerへの入金の要件](stablecoin-issuer.html#xrp-ledgerへの入金の要件) -* [ゲートウェイの注意事項](stablecoin-issuer.html#precautions) +* [注意事項](stablecoin-issuer.html#注意事項) ### Partial Payments -追加の前に、取引所は[Partial Payments](partial-payments.html)機能について知っておく必要があります。この機能を使用すると、XRP Ledgerのユーザーは、`SendMax`を増やさずに、受取金額を減額して、支払いを正常に送信できます。この機能は、送信者側に追加費用が発生せず、[支払いの返金](stablecoin-issuer.html#bouncing-payments)に便利です。 +追加の前に、取引所は[Partial Payments](partial-payments.html)機能について知っておく必要があります。この機能を使用すると、XRP Ledgerのユーザーは、`SendMax`を増やさずに、受取金額を減額して、支払いを正常に送信できます。この機能は、送信者側に追加費用が発生せず、[支払いの返金](stablecoin-issuer.html#不明な入金の返金)に便利です。 #### Partial Paymentsに関する警告 diff --git a/content/use-cases/payments/peer-to-peer-payments-uc.ja.md b/content/use-cases/payments/peer-to-peer-payments-uc.ja.md new file mode 100644 index 0000000000..2dc2af8392 --- /dev/null +++ b/content/use-cases/payments/peer-to-peer-payments-uc.ja.md @@ -0,0 +1,53 @@ +--- +html: peer-to-peer-payments-uc.html +parent: payments-uc.html +blurb: XRP Ledgerを使用して、第三者の介入を受けずに日々の支払いを処理することができます。 +labels: + - トランザクション +--- +# 個人間取引 + +XRP Ledgerは、決済を処理するための効率的でボーダレスなサービスを提供します。従来の支払い方法とは異なり、資産を保有し価値を移転するために金融機関を必要としません。インターネットにアクセスできれば、誰かに現金を渡すのと同じくらい簡単に、XRP Ledger上で直接支払いを行うことができます。友人同士であれ、買い手と売り手であれ、XRP Ledgerは直接的な（ピアツーピアの）支払いを素早く、低いネットワーク手数料で処理することを可能にします。 + + +## ウォレット + +XRP Ledgerを使用して直接支払いを処理する前に、使用するウォレットを決める必要があります。ウォレットは、レジャーとのやり取りや資金の管理を簡単にします。ニーズに応じて多くの中から選ぶことができ、自分で作成することも可能です。[暗号通貨のウォレット](crypto-wallets.html)をご覧ください。 + + +## アカウントの作成 + +アカウントを作成する前に、XRP Ledgerのどのネットワークを使用するかを決定する必要があります。異なるユースケースのために複数のネットワークがありますが、ネイティブのXRPトランザクションは`Mainnet`でしか起こりません。[パラレルネットワーク](parallel-networks.html)をご覧ください。 + +一般に公開されているウォレットのほとんどは、アカウントを作成する機能を提供しており、公開鍵と秘密鍵を生成することができます。そうでない場合でも、数学的に有効である限り、自分でアカウントを作成することができます。[アカウントの作成](accounts.html#creating-accounts)をご覧ください。 + + +## アカウントを探す + +アカウントは、資金が提供され、最低準備金を満たすまでは、XRP Ledger上でアクティブではありません。[準備金](reserves.html)をご覧ください。 + +利用しているウォレットがXRPを購入するオプションを提供していない場合、それを行うサードパーティの取引所を見つけて、あなたのアカウントに送る必要があります。または、友人などからXRPをあなたのアカウントに送ってもらうこともできます。[Payment](payment.html)をご覧ください。 + +アカウントに資金を提供した後、XRP Ledger自体でアカウントが存在し、資金が提供されていることを確認する必要があります。次の方法などが利用できます。 + + - [XRPLエクスプローラー](https://livenet.xrpl.org/) + - [`account_info`コマンド](account_info.html) + + +## Paymentの利用 + + +### XRPによる直接支払い + +XRP支払いは、XRP Ledger上で誰かに支払いをする最も簡単な方法です。Checkやエスクローを使うこともできますが、これらは複数回のトランザクションを必要とします。XRPの直接支払いは1回のトランザクションで済みますので、この方法は日々の取引に最適です。もしあなたが大量のトランザクションを扱う事業者であれば、迅速かつシンプルで、手数料が最も低いこの方法がぴったりかもしれません。[XRPによる直接支払い](direct-xrp-payments.html)をご覧ください。 + +XRPの直接支払いを実現するためには、受取人のアドレスを知るだけで十分です。 + + +### クロスカレンシー支払い + +XRP Ledgerは、XRPとトークンのクロスカレンシー決済を可能にします。XRP Ledger内のクロスカレンシー支払いは完全にアトミックで、支払いが完全に実行されるか、支払いの一部すら全く実行されないことを意味します。 + +クロスカレンシー支払いは、宛先に固定額を送りますが、送信者は、トランザクションをネットワーク上で成立させるために必要となる経路によって、手数料コストが変動することがあります。[クロスカレンシー支払い](cross-currency-payments.html)をご覧ください。 + +XRPのネイティブ通貨ではなく、特定のトークンによる支払いを希望する場合に最適なオプションです diff --git a/content/use-cases/payments/restricting-deposits-uc.ja.md b/content/use-cases/payments/restricting-deposits-uc.ja.md new file mode 100644 index 0000000000..272b998996 --- /dev/null +++ b/content/use-cases/payments/restricting-deposits-uc.ja.md @@ -0,0 +1,70 @@ +--- +html: restricting-deposits-uc.html +parent: payments-uc.html +blurb: Checkは、紙の小切手と同じように後払い決済を行うことができます。 +labels: + - トランザクション +--- +# 入金の制限 + +銀行に関する規制を遵守するため、金融機関は受け取った資金の出所に関する書類を提出する必要があります。これらの規制は、金融機関が処理するすべての支払いの出所と行き先を追跡することを義務付け、不正な活動を防止することを目的としています。XRP Ledgerでは、支払いは受取人からのインタラクションなしに送受信することができます。このデフォルトの動作には問題がありますが、デポジット認可を有効にすることで、明示的に認可した資金のみを受け取ることができます。 + +デポジット認可が有効になっているアカウントでは、次のような場合のみ資金を受け取ることができます。 + + - 事前認可されたアカウント + - チェック + - エスクロー + + + +## デポジット認可のセットアップ + +デポジット認可を有効にするには、`AccountSet`トランザクションを使用して`asfDepositAuth`フラグを設定します。[デポジット認可](depositauth.html)をご覧ください。 + +## アカウントの事前認可 + +デポジット認可を有効にすると、アカウントは、あなたが特に許可しない限り、すべての受信トランザクションをブロックします。これは、あなたの求めていることかもしれませんが、大量のトランザクションを扱う場合、面倒になることがあります。信頼できる業者やアカウントがある場合は、それらの業者からのトランザクションを認可する必要がないように、事前認可することができます。 + +事前認可されたアカウントによる支払いは通貨を問わないので、認可する通貨を指定することはできません。すべてを認可するか認可しないかです。 + +[デポジットの事前認可](depositpreauth.html)をご覧ください。 + + +## 未認可のアカウントからの入金を許可する + +デポジット認可を有効にした後でも、未認可のアカウントから支払いを行うこととは可能です。それを可能にするいくつかの方法があります。 + + +### Check + +Checkは、デポジット認可が有効な場合、シンプルで親しみやすく、柔軟な資金移動方法です。Checkは、2つの要素から構成される支払い方法です。送信者がCheckを作成し、受信者がそのCheckを現金化する必要があります。Checkを現金化するとは、入金を明示的に承認することです。 + +この方法は最もシンプルですが、資金が保証されるわけではありません。Checkは後払いであり、Checkを現金化しようとする瞬間まで資金は動きません。Checkを現金化するときに、送金側のアカウントに必要な資金がない可能性があり、ビジネスによっては遅延やその他の問題を引き起こす可能性があります。 + +[Checkの利用](use-checks.html)をご覧ください。 + + +### Escrow + +入金時の資金保証が必要な場合は、エスクローで入金してもらう方法もあります。通常のエスクローと同様に、送金者はレジャーに資金を確保し、一定の条件が満たされるまで資金を効果的にロックします。これにより、エスクローを閉じて資金を放出するときに、資金が利用できることが保証されます。 + +[エスクローの利用](use-escrows.html)をご覧ください。 + + + diff --git a/content/use-cases/payments/smart-contracts-uc.ja.md b/content/use-cases/payments/smart-contracts-uc.ja.md new file mode 100644 index 0000000000..59df17f72c --- /dev/null +++ b/content/use-cases/payments/smart-contracts-uc.ja.md @@ -0,0 +1,48 @@ +--- +html: escrow-uc.html +parent: payments-uc.html +blurb: トランザクションにより、アカウントはXRP Ledgerを変更することができます。 +labels: + - レジャー +--- +# スマートコントラクト + +スマートコントラクトとは、2者間の合意の条件を処理し、その履行を実行するブロックチェーンベースのプログラムである。最も単純な構成要素に分解すると、スマートコントラクトは、「何か」が発生した場合に「何か」を行うというものです。 + +スマートコントラクトをブロックチェーンに導入することのメリットは、金融機関や法律機関といった従来のサードパーティを介さずに、契約を安全に遂行することができることです。その代わり、契約はブロックチェーンを運営する分散型コンピュータのネットワークによって管理されます。 + +これにより、スマートコントラクトの条件によって、相手が取引の約束を守るかどうかを信頼することなく、誰とでもトランザクションを行うことができます。 + + +## 条件付きのエスクロー + +XRP Ledger上のスマートコントラクトは、条件付きで保有するエスクローを通じて動作します。 + + +### エスクローを作成する + +条件付きエスクローは、通常のエスクローと似ています。エスクローで資金を確保し、受取人が資金を利用できることを保証します。違いは、レジャー上の条件付きエスクローには`Condition`が付加されており、これが資金をロックする役割を担っていることです。レジャーは、対応する`Fulfillment`フィールドを持つ`EscrowFinish`トランザクションが送信されるまで、これらの資金を解放しません。`Condition`と`Fulfillment`フィールドは、エスクローの錠と鍵のようなものであると考えることができます。 + +[`EscrowCreate`](escrowcreate.html)をご覧ください。 + + +### オラクルの確立 + +オラクルとは、スマートコントラクトを履行または無効化するために、現実世界のイベントを検証することができる中立的な第三者エージェントのことです。オラクルは、conditionとfulfillmentを生成し、conditionの条件が満たされるまでfulfillmentを秘密にすることで、条件付きエスクローを機能させるために不可欠です。 + +スマートコントラクトの文脈では、オラクルは現実世界のデータを読み取ることができるソフトウェアであることが大半でしょう。オラクルには、当事者間の契約条件がプログラムされ、conditionとfulfillmentの16進数値を生成することになります。 + +オラクルは、エスクロー作成者に条件となる16進数の値を与え、エスクローの初期設定を可能にします。 + +オラクルのプログラムが条件を満たしたことを検知した後、エスクローの受取人にfulfillmentの16進数値を渡します。この時点以降、オラクルはエスクローを終了させるなど、何も行いません。エスクローの受取人は、ほとんどの場合、エスクローを終了することになります。 + +[conditionとfulfillmentの生成](send-a-conditionally-held-escrow.html#1-generate-condition-and-fulfillment)をご覧ください。 + +## 例 + +スマートコントラクトの用途は多岐にわたりますが、いくつかの用途を紹介します。 + +1. 住宅ローンなど、本来なら弁護士が必要な高額商品の支払いへの対応。 +2. 商品の受け取りと同時に資金を届けるサプライチェーンマネジメント。 +3. ソフトウェアで確認できる特定の種類の保険金請求の自動化。 +4. 提供されたサービスに対する支払いの保証。 diff --git a/content/use-cases/tokenization/authorized-minter.ja.md b/content/use-cases/tokenization/authorized-minter.ja.md new file mode 100644 index 0000000000..d4ec11a7b6 --- /dev/null +++ b/content/use-cases/tokenization/authorized-minter.ja.md @@ -0,0 +1,103 @@ +--- +html: authorized-minter.html +parent: nft-mkt-overview.html +blurb: 他のアカウントのためにNFTをミントし、販売する。 +labels: + - Tokenization +--- +# 認可Minter + +_私は認可Minterとして、トークン発行者のために合意されたレートでトークンをミントし、トークンを売却して利益を得て、ロイヤリティを発行者に還元したいのです。_ + +トークン発行者の認可Minterとして動作することができます。この場合、あなたはNFTokenを所有しますが、ロイヤリティはNFTokenの発行者が受け取ります。そのNFTokenを売却する場合、最初の売却益はあなたに入ります。発行者と合意の上、初回売却額の一部または全部を発行者に支払うことができます。 + +チュートリアル[認可Minterの割り当て](assign-an-authorized-minter-using-javascript.html)で詳しく説明されています。 + +[![認可Minterのフロー](img/nft-mkt-auth-minter.png "認可Minterのフロー")](img/nft-mkt-auth-minter.png) + +## rippledインスタンスのセットアップ + +取引量の多い本格的なマーケットプレイスサイトを立ち上げる場合、独自のXRP Ledgerサーバインスタンスを立ち上げるという判断が当然となります。[rippledのインストール](install-rippled.html)をご覧ください。 + +## マーケットプレイスのセットアップ + +NFTを自分で設計するのではなく、NFTクリエイターと連携して認可Minterとなり、NFTの生成を代行することができます。これにより、NFTクリエイターは新しいNFTの生成に専念でき、あなたはNFTのミントと販売を担当することができます。[認可Minter](nftoken-authorized-minting.html)をご覧ください。 + +NFTの作成を終了すると、作成者は認可Minterの権限を取り消し、NFTに対する権限を取り戻すことができます。また、NFTの販売を行うマーケットプレイスにトークンを譲渡することもできます。あなたは、売りオファーと買いオファーのマッチングを行うブローカーとして機能することができます。[NFTオークションの実行](nftoken-auctions.html)を参照してください。 + +他のアカウントに代わって最初のNFTをミントする場合は、[他アカウントからのNFTミントを許可する](assign-an-authorized-minter-using-javascript.html)をご覧ください。 + +発行者として将来的にトークンをバーンできるようにしたい場合は、`Flags`フィールドを _1_ に設定します。NFTを譲渡可能にするには、`Flags`フィールドを _8_ に設定します。NFTをバーン可能かつ譲渡可能にするには、`Flags`フィールドを _9_ に設定します。[Burnableフラグ](nftoken.html#nftoken-flags)および[Transferableフラグ](nftoken.html#nftoken-flags)を参照してください。 + +transfer feeを設定することで、将来の取引からロイヤリティを徴収することができます。これは販売価格の0～50%を表す0～50000の値です。[NFTの取引手数料](nftoken.html#transferfee)を参照してください。 + +NFTokenのURLは、NFTのコンテンツが保存されている場所へのリンクです。IPFSアカウントを作成し、永続的なURLにNFTokenのコンテンツを保存するのも1つの方法です。[NFTデータ保存のベストプラクティス](https://docs.ipfs.io/how-to/best-practices-for-nft-data)をご覧ください。 + +最も気になるであろう留意点： + +* [コレクションとしてNFTをミントする](nft-collections.html) +TokenTaxonフィールドを使用して、特定のテーマや目的をもったNFTのセットを作成します。 +* [NFTの一定の供給量を保証する](nft-fixed-supply.html) +また、「使い捨て」アカウントでNFTを作成し、別のアカウントで一定数のNFTを取得した後、ミントに使用した「使い捨て」アカウントを削除することで、作成したNFTの希少性を確保することができます。[NFTの一定の供給量を保証する](nft-fixed-supply.html)をご覧ください。 + +## NFTの取引 + +NFTの取引は、売りオファーの作成または買いオファーの承諾によって行われます。[NFTokensの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +NFTをオークション形式で販売することができます。[NFTオークションの実行](nftoken-auctions.html)をご覧ください。 + +あなたはブローカーとして、売り手と入札者をつなぎ、取引を完了させ、購入価格の何パーセントかを保持することができます。[NFTokenの取引を仲介する](broker-an-nft-sale-using-javascript.html)をご覧ください。 + +### 準備金要件 + +販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、2XRPの準備金が必要です。NFTokenページは16～32個のNFTを保管することができます。 + +各`NFTokenOffer`オブジェクトは、2XRPの準備金が必要です。 + +`NFTokenOffer`を作成したり、NFTを売却したりする際には、些細な送金手数料（およそ6000ドロップ、または0.006 XRP）が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。 + +次のコンテンツをご覧ください。 + +1. [NFTokenOffer](nft-reserve-requirements.html#nftokenoffer-reserve) +2. NFToken page ([所有者準備金](nft-reserve-requirements.html#owner-reserve)) +3. 少額の[取引手数料](transfer-fees.html) + +### 支払い + +XRPL NFTの最もシンプルな支払い方法はXRPです。XRPを使ったNFTの売り買いの例については、[NFTokenの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +他の通貨での取引は、DEXを活用してあらゆる種類の発行通貨を受け入れ、取引することができます。[分散型取引所での取引](trade-in-the-decentralized-exchange.html#trade-in-the-decentralized-exchange)をご覧ください。 + +## NFTのインデックス + +NFTを出品する際、オブジェクトのメタデータを使って分類するのが便利な場合があります。XRPLライブラリ、Clioサーバ、XRPL APIやBithompライブラリの拡張機能などのクエリを使用して、NFTをクリエイター、価格、コレクション、レアリティなどでソートしたりフィルタリングしたりすることができます。 + +関連項目: + +- [Clioのセットアップ](install-clio-on-ubuntu.html) +- [XRPL Data API](https://api.xrpldata.com/docs/static/index.html#/) +- [Bithomp](https://docs.bithomp.com/#nft-xls-20) + + diff --git a/content/use-cases/tokenization/digital-artist.ja.md b/content/use-cases/tokenization/digital-artist.ja.md new file mode 100644 index 0000000000..fdf0af95a0 --- /dev/null +++ b/content/use-cases/tokenization/digital-artist.ja.md @@ -0,0 +1,83 @@ +--- +html: digital-artist.html +parent: nft-mkt-overview.html +blurb: Creating an NFT Marketplace for buying and selling NFTs. +labels: + - Tokenization +--- +# デジタルアーティスト + +_デジタルアーティストとして、私はXRPLを使って自分の作品のNFTokenを作成し、XRPLで販売したいと思います。XRPLはコスト効率がよく、カーボンニュートラルだからです。_ + +--- + +NFTokenを作成すると、実際の物理的またはデジタル資産の実質的なプレースホルダーとなる一意のトークンがXRPL上に作成されます。NFTokenを作成する際には、デジタルアートワークのようなアイテムそのものであるデジタルファイルへのURL、または物理的な世界でのアイテムを表すプレースホルダへのURLを提供します。 + +デジタルアーティストとして、あなたはNFTの作成に専念しており、おそらくXRP Ledgerで販売するためでしょう（自分の作品の実績を証明する方法としてNFTを作成する可能性もありますね）。 + +[Xumm](https://xumm.app)などのアプリを使用してNFTokenを作成することができます。 + +より実践的な体験をしたい方は、[クイックスタート・チュートリアル3 - NFTokenのミントとバーン](mint-and-burn-nfts-using-javascript.html)をご覧ください。 + +[![デジタルアーティストのフロー](img/nft-mkt-digital-artist.png "デジタルアーティストのフロー")](img/nft-mkt-digital-artist.png) + +## 公開サーバを利用する + +開始当初は、トランザクションは比較的少ないでしょう。無料のXRP Ledger公開サーバの1つで作業することができます。ビジネスが成長するにつれて、増加する販売トラフィックを処理するために、独自のXRP Ledgerインスタンスを検討することができます。[パブリックサーバ](public-servers.html)をご覧ください。 + +## NFTの作成 + +NFTをミントして販売することで、マーケットプレイスを構築します。 + +初めてNFTを作成する場合は、チュートリアル _NFTokenのミントとバーン_ の手順に従ってください。NFTを作成する際には、以下の点にも留意してください。 + +* transfer feeを設定することで、将来の取引からロイヤリティを徴収することができます。これは販売価格の0～50%を表す0～50000の値です。[NFTの取引手数料](nftoken.html#transferfee)を参照してください。 +* NFTokenのURLは、NFTのコンテンツが保存されている場所へのリンクです。IPFSアカウントを作成し、永続的なURLにNFTokenのコンテンツを保存するのも1つの方法です。[NFTデータ保存のベストプラクティス](https://docs.ipfs.io/how-to/best-practices-for-nft-data)をご覧ください。 + +* `TokenTaxon`フィールドを使用すると、NFTを論理的なコレクションとしてミントすることができます。[NFTをコレクションとしてミントする](nft-collections.html)をご覧ください。 +* 発行者として将来的にトークンをバーンできるようにしたい場合は、`Flags`フィールドを _1_ に設定します。NFTを譲渡可能にするには、`Flags`フィールドを _8_ に設定します。NFTをバーン可能かつ譲渡可能にするには、`Flags`フィールドを _9_ に設定します。[Burnableフラグ](nftoken.html#nftoken-flags)および[Transferableフラグ](nftoken.html#nftoken-flags)をご覧ください。 + +[NFTokenのミントとバーン](mint-and-burn-nfts-using-javascript.html)をご覧ください。 + +## NFTの販売 + +NFTを売却する場合は、売却オファーを作成する必要があります。[NFTokensの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +NFTをオークション形式で販売することができます。[NFTオークションの実行](transfer-nfts-using-javascript.html)をご覧ください。 + +### 準備金要件 + +販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、2XRPの準備金が必要です。NFTokenページは16～32個のNFTを保管することができます。 + +各`NFTokenOffer`オブジェクトは、2XRPの準備金が必要です。 + +`NFTokenOffer`を作成したり、NFTを売却したりする際には、些細な送金手数料（およそ6000ドロップ、または0.006 XRP）が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。 + +次のコンテンツをご覧ください。 + +1. [NFTokenOffer](nft-reserve-requirements.html#nftokenoffer-reserve) +2. NFToken page ([所有者準備金](nft-reserve-requirements.html#owner-reserve)) +3. 少額の[取引手数料](transfer-fees.html) + +### 支払い + +XRPL NFTの最もシンプルな支払い方法はXRPです。XRPを使ったNFTの売り買いの例については、[NFTokenの取引](transfer-nfts-using-javascript.html))をご覧ください。 + +他の通貨での取引は、DEXを活用してあらゆる種類の発行通貨を受け入れ、取引することができます。[分散型取引所での取引](trade-in-the-decentralized-exchange.html#trade-in-the-decentralized-exchange)をご覧ください。 + +## NFTのインデックス化 + +NFTを出品する際、オブジェクトのメタデータを使って分類するのが便利な場合があります。XRPLライブラリ、Clioサーバ、XRPL APIとBithompライブラリの拡張機能などのクエリを使用して、NFTをクリエイター、価格、コレクション、レアリティなどでソートしたりフィルタリングしたりすることができます。 + +関連項目: + +- [Clioのセットアップ](install-clio-on-ubuntu.html) +- [XRPL Data API](https://api.xrpldata.com/docs/static/index.html#/) +- [Bithomp](https://docs.bithomp.com/#nft-xls-20) + + +## NFTのバーン + +ワークフローの中には、現在の所有者に関係なく、将来のある時点で発行者がトークンをバーンする権利を保持することが適切な場合があります。例えば、カーボンクレジットに使用されるNFTはミントして取引することができますが、二酸化炭素が排出されると、NFTをバーンして取引不能にすることが可能です。このようなシナリオでは、NFTをミントする際に`lsfBurnable`フラグを設定します。 + +また、ゲーム内でライフを失った後にゲーム内資産をバーンすることもあります。また、NFTのチケットは、換金に成功した後、再び使用されないようにバーンすることができます。 diff --git a/content/use-cases/tokenization/nft-mkt-overview.ja.md b/content/use-cases/tokenization/nft-mkt-overview.ja.md new file mode 100644 index 0000000000..57474ff2d0 --- /dev/null +++ b/content/use-cases/tokenization/nft-mkt-overview.ja.md @@ -0,0 +1,166 @@ +--- +html: nft-mkt-overview.html +parent: tokenization.html +blurb: NFTマーケットプレイスのユースケースの概要。 +labels: + - Tokenization +--- +# NFTマーケットプレイスの概要 + + +## 主な特徴 + +NFTのXRPLネイティブサポートでは、以下のようなことが可能なツールを提供しています。 + +- NFTのミント、販売、バーン +- NFTのプロジェクトを短期間・低コストでスタート +- 売り手と買い手の間の取引を仲介するブローカーの設定 +- 他のアカウントへのNFTのミントを代行する権限の付与 +- クリエイターフレンドリーで、マーケットプレイス取引でも保証されるオンレジャーのロイヤリティの受け取り。 + +これらはすべて、XRP Ledgerの10年以上にわたる性能と信頼性の上に成り立っています。 + +## ゴールの設定 + +まず、どのようなマーケットプレイスを作りたいかを決めることから始めましょう。 + +- マーケットプレイスでは、他の人がミントしたNFTを販売します。 +- 認可Minter：アーティストのためにNFTをミントする。 +- デジタルアーティスト：自分でNFTを作成して販売する。 + +NFTビジネスを始めるにあたって、必要不可欠な4つの準備項目があります。 + +1. ネットワークへの接続方法の決定 +2. ブロックチェーンでの処理の設定 +3. 必要なNFT情報のインデックス作成 +4. NFTをキャッシュするための永続的なストレージ戦略の決定 + +[![NFTマーケットのフロー](img/nft-mkt-overview.png "NFTマーケットのフロー")](img/nft-mkt-overview.png) + +## XRPLへの接続 + +トランザクションの少ない小規模なサイトを立ち上げたい場合は、XRP Ledgerの無料の公開サーバのいずれかと連携することができます。[パブリックサーバ](public-servers.html)をご覧ください。 + +大規模なサイトを大量に立ち上げたい場合は、独自のXRP Ledgerのサーバインスタンスを導入する価値があるかもしれません。[rippledのインストール](install-rippled.html)をご覧ください。 + +関連項目: + +* [独自サーバ運用のメリットとデメリット](networks-and-servers.html#reasons-to-run-your-own-server). + +## ブロックチェーンの基本機能のセットアップ + +NFTをいくつかミントして販売することで、マーケットプレイスを構築し始めることができます。 + +最初のNFTを作成するには、チュートリアル _NFTonenのミントとバーン_ の指示に従います。[NFTのミントとバーン](mint-and-burn-nfts-using-javascript.html)をご覧ください。 + +NFTokenのURLは、NFTのコンテンツが保存されている場所へのリンクです。IPFSアカウントを作成し、永続的なURLにNFTokenのコンテンツを保存するのも1つの方法です。[NFTデータ保存のベストプラクティス](https://docs.ipfs.io/how-to/best-practices-for-nft-data)をご覧ください。 + +発行者として将来的にトークンをバーンできるようにしたい場合は、`Flags`フィールドを _1_ に設定します。NFTを譲渡可能にするには、`Flags`フィールドを _8_ に設定します。NFTをバーン可能かつ譲渡可能にするには、`Flags`フィールドを _9_ に設定します。[Burnableフラグ](nftoken.html#nftoken-flags)および[Transferableフラグ](nftoken.html#nftoken-flags)をご覧ください。 + +transfer feeを設定することで、将来の取引からロイヤリティを徴収することができます。これは販売価格の0～50%を表す0～50000の値です。[NFTの取引手数料](nftoken.html#transferfee)をご覧ください。 + +`TokenTaxon`フィールドを使用すると、NFTを論理的なコレクションとしてミントすることができます。[NFTをコレクションとしてミントする](nft-collections.html)をご覧ください。 + +自分で作成したコンテンツで自分のNFTをミントすることもできますが、他のクリエイターの代わりにNFTを生成する認可Minterになることもできます。この場合、クリエイターは新しいNFTの作成に専念し、あなたはNFTのミントと販売を担当することができます。 + +認可MinterがクリエイターのためにNFTをミントし終えたら、その権限を取り消し、クリエイターのNFTを制御できないようにすることができます。 + +[認可Minter](nftoken-authorized-minting.html)をご覧ください。 + +ミント済みのNFTは、`NFTokenPage`に記録されます。アカウント上の`NFTokenPage`1つにつき2XRPの準備金が必要です。[NFT準備金](nft-reserve-requirements.html)をご覧ください。 + +各「NFTokenPage」は16～32個のNFTを保持します。大量のNFTをミントすると、あなたのXRPを大量に準備金としてロックすることになります。オンデマンドミント（または _遅延ミント_ ）を行うことで、XRPを柔軟に維持することができます。[遅延ミント](nftoken-batch-minting.html#mint-on-demand-lazy-minting)と[スクリプトミント](nftoken-batch-minting.html#scripted-minting)をご覧下さい。 + + +### ウォレットのセットアップ + +新しいウォレットをセットアップします。[Xumm](https://xumm.app/)をご覧ください。 + +アカウントを作成する際には、10 XRPの基本準備金が必要であることに注意してください。[準備金](reserves.html#base-reserve-and-owner-reserve)をご覧ください。 + +### NFTの取引 + +NFTの取引は、売りオファーの作成または買いオファーの承諾によって行われます。[NFTokensの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +NFTをオークション形式で販売することができます。[NFTオークションの実行](nftoken-auctions.html)をご覧ください。 + +あなたはブローカーとして、売り手と入札者をつなぎ、取引を完了させ、購入価格の何パーセントかを保持することができます。[NFTokenの取引を仲介する](broker-an-nft-sale-using-javascript.html)をご覧ください。 + +#### 準備金要件 + +販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、2XRPの準備金が必要です。NFTokenページは16～32個のNFTを保管することができます。 + +各`NFTokenOffer`オブジェクトは、2XRPの準備金が必要です。 + +`NFTokenOffer`を作成したり、NFTを売却したりする際には、些細な送金手数料（およそ6000ドロップ、または0.006 XRP）が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。 + +次のコンテンツをご覧ください。 + +1. [NFTokenOffer](nft-reserve-requirements.html#nftokenoffer-reserve) +2. NFToken page ([所有者準備金](nft-reserve-requirements.html#owner-reserve)) +3. 少額の[取引手数料](transfer-fees.html) + +#### 支払い + +XRPL NFTの最もシンプルな支払い方法はXRPです。XRPを使ったNFTの売り買いの例については、[NFTokenの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +他の通貨での取引は、DEXを活用してあらゆる種類の発行通貨を受け入れ、取引することができます。[分散型取引所での取引](trade-in-the-decentralized-exchange.html#trade-in-the-decentralized-exchange)をご覧ください。 + + + +## NFTのインデックス化 + +NFTを出品する際、オブジェクトのメタデータを使って分類するのが便利な場合があります。XRPLライブラリ、Clioサーバ、XRPL APIとBithompライブラリの拡張機能などのクエリを使用して、NFTをクリエイター、価格、コレクション、レアリティなどでソートしたりフィルタリングしたりすることができます。 + +関連項目: + +- [Clioのセットアップ](install-clio-on-ubuntu.html) +- [XRPL Data API](https://api.xrpldata.com/docs/static/index.html#/) +- [Bithomp](https://docs.bithomp.com/#nft-xls-20) + + + + +## NFTのキャッシュ + +クリプト分野で作成されるNFTは、メディアや属性などのメタデータを保存することが想定されています。現在は中央集権化を避けるため、ほとんどがIPFSやArweaveに保存されています。 + + + +IPFS/Arweaveは分散化を促進する素晴らしいソリューションですが、メタデータを効率的にフェッチすることが問題になっています。IPFS/Arweaveに直接アクセスしてメタデータをフェッチするのは、高品質のメディアを持つNFTの複数ページをスクロールしているユーザからの即時応答を必要とする現代のウェブサイトにとって十分な速度とは言えません。現在、XRPL上の多くのNFTマーケットプレイスは、高速で信頼性の高いレスポンシブなウェブサイトを持つために、IPFSオリジナルのキャッシュバージョンを保存していますが、このプロセスは高価で非効率です。 + +CloudflareやInfuraをはじめとする多くのプロバイダが、こうした分散型ファイルの保存と、ユーザのための高速な検索に力を入れるようになっています。 + +[NFTのキャッシュ](nftoken.html#nftokenデータとメタデータの取得)をご覧ください。 + + diff --git a/content/use-cases/tokenization/nftoken-marketplace.ja.md b/content/use-cases/tokenization/nftoken-marketplace.ja.md new file mode 100644 index 0000000000..a13915ce7b --- /dev/null +++ b/content/use-cases/tokenization/nftoken-marketplace.ja.md @@ -0,0 +1,100 @@ +--- +html: nftoken-marketplace.html +parent: nft-mkt-overview.html +blurb: NFTを取引するための「NFTマーケットプレイス」を構築する。 +labels: + - Tokenization +--- +# NFTマーケットプレイス + +_NFTokenマーケットプレイスでは、XRPLを利用して、厳選されたNFTokenを消費者に譲渡するためのWeb上のサービスを提供し、ブランド構築と売上に応じた仲介手数料を得ることができるというメリットを得ることができるようになります。_ + +--- + +NFTokenマーケットプレイスは、NFTokenクリエイターとコレクターの仲介役となります。マーケットプレイスの運営は、NFTokenのクリエイターを探し出し、販売するアイテムを集めます。購入者は、あなたのサイトを訪れ、選択されたアイテムを確認し、オファーを提示します。あなたは、クリエイターが設定した最低価格と購入者から提示された最適な価格を照合し、トランザクションを完了させ、仲介手数料を受け取ります。 + +## NFTマーケットプレイスを作成する + +[![NFTマーケットプレイスのフロー](img/nft-mkt-marketplace.png "NFTマーケットプレイスのフロー")](img/nft-mkt-marketplace.png) + + +## rippledインスタンスのセットアップ + +取引量の多い本格的なマーケットプレイスサイトを立ち上げる場合、独自のXRP Ledgerサーバインスタンスを立ち上げるという判断が当然となります。[rippledのインストール](install-rippled.html)をご覧ください。 + + +### ウォレットのセットアップ + +新しいウォレットをセットアップします。[Xumm](https://xumm.app/)をご覧ください。 + +基本準備金については[準備金](reserves.html#base-reserve-and-owner-reserve)をご覧ください。 + +Current wallet options on XRPL: This is a good opportunity for XRPL to highlight wallet providers in the ecosystem + + +### NFTの取引 + +NFTの取引は、売りオファーの作成または買いオファーの承諾によって行われます。[NFTokensの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +NFTをオークション形式で販売することができます。[NFTオークションの実行](nftoken-auctions.html)をご覧ください。 + +あなたはブローカーとして、売り手と入札者をつなぎ、取引を完了させ、購入価格の何パーセントかを保持することができます。[NFTokenの取引を仲介する](broker-an-nft-sale-using-javascript.html)をご覧ください。 + + +### 準備金要件 + +販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、2XRPの準備金が必要です。NFTokenページは16～32個のNFTを保管することができます。 + +各`NFTokenOffer`オブジェクトは、2XRPの準備金が必要です。 + +`NFTokenOffer`を作成したり、NFTを売却したりする際には、些細な送金手数料（およそ6000ドロップ、または0.006 XRP）が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。 + +次のコンテンツをご覧ください。 + +1. [NFTokenOffer](nft-reserve-requirements.html#nftokenoffer-reserve) +2. NFToken page ([所有者準備金](nft-reserve-requirements.html#owner-reserve)) +3. 少額の[取引手数料](transfer-fees.html) + + +ブローカー販売については、トピック[XRP Ledgerでのトークン取引](non-fungible-token-transfers.html)で詳しく説明しています。 + +トークン取引手数料については、[取引手数料](transfer-fees.html)で詳しく解説しています。 + +[NFToken Saleの仲介](broker-an-nft-sale-using-javascript.html)の手順に従って、ブローカー販売市場の構築を開始することができます。 + +#### 支払い + +XRPL NFTの最もシンプルな支払い方法はXRPです。XRPを使ったNFTの売り買いの例については、[NFTokenの取引](transfer-nfts-using-javascript.html)をご覧ください。 + +他の通貨での取引は、DEXを活用してあらゆる種類の発行通貨を受け入れ、取引することができます。[分散型取引所での取引](trade-in-the-decentralized-exchange.html#trade-in-the-decentralized-exchange)をご覧ください。 + +## NFTのインデックス化 + +NFTを出品する際、オブジェクトのメタデータを使って分類するのが便利な場合があります。XRPLライブラリ、Clioサーバ、XRPL APIとBithompライブラリの拡張機能などのクエリを使用して、NFTをクリエイター、価格、コレクション、レアリティなどでソートしたりフィルタリングしたりすることができます。 + +関連項目: + +- [Clioのセットアップ](install-clio-on-ubuntu.html) +- [XRPL Data API](https://api.xrpldata.com/docs/static/index.html#/) +- [Bithomp](https://docs.bithomp.com/#nft-xls-20) + + diff --git a/content/use-cases/tokenization/stablecoin-issuer.ja.md b/content/use-cases/tokenization/stablecoin-issuer.ja.md new file mode 100644 index 0000000000..54dc3066c6 --- /dev/null +++ b/content/use-cases/tokenization/stablecoin-issuer.ja.md @@ -0,0 +1,544 @@ +--- +html: stablecoin-issuer.html +parent: tokenization.html +blurb: XRP Ledgerの外部の同価値の資産に基づき、独自のステーブルコインを発行する。 +labels: + - トークン +--- +# ステーブルコインの発行者 + +**ステーブルコイン**は、外部世界の資産に裏付けられた[トークン](tokens.html)です。ステーブルコインにより、ユーザは身近な通貨で取引を行うことができ、ブロックチェーンへの資金の出し入れを便利にすることができます。ステーブルコインの発行者は、これらのサービスを提供する代わりに、ステーブルコインの出金や送金にかかる手数料など、さまざまな方法で収益を得ることができます。 + +XRP Ledgerでは、誰でも任意の通貨コードを持つトークンを発行することができますが、ステーブルコインの価値は、対応する資産と交換できるという保証に基づきます。また、ステーブルコインの発行には、管轄区域によって異なる規制上の制約がある場合があります。これらの理由から、一般的に、ステーブルコインの発行には、信頼できる事業者が必要です。 + +**注記:** XRP Ledger上のステーブルコイン発行者は、以前は「ゲートウェイ」と呼ばれていました。 + +この記事では、ステーブルコインを発行する前に知っておくべき情報、ステーブルコイン発行者の設定に関わる選択肢のまとめ、XRP Ledgerとの技術統合を実装するためのリソースを提供します。 + + +## 背景情報 + +### トラストラインとトークン + +ネイティブ暗号通貨であるXRPを除くXRP Ledgerのすべての資産は、 _トークン_ として表され、その意味を定義する特定の発行者に結びつけられています。XRP Ledgerは、ユーザが望むトークンだけを保有し、受け取ることができるようにするために、 _トラストライン_ と呼ばれる双方向のアカウントの関係を持つシステムを備えています。 + +何らかの外部システムの資金に裏打ちされたトークンは、 _ステーブルコイン_ と呼ばれることがあります。これには、銀行口座の不換紙幣、別のブロックチェーン上の暗号通貨、あるいは他の種類の資産や価値の形態に裏打ちされたトークンが含まれます。「ステーブルコイン」という言葉は、トークンとそれが表す資産との交換レートが1：1(手数料を差し引いた値)で「安定」しているという考えに由来しています。 + +より詳細な情報は[トラストラインとトークン発行](trust-lines-and-issuing.html)をご覧ください。 + + +### XRP + +**XRP**は、XRP Ledgerのネイティブ暗号通貨です。XRPは、どのXRP Ledgerのアドレスからでも、他のアドレスに直接送ることができます。これはXRPをブリッジ通貨として活用するのに便利です。 + +トークン発行者は、XRPを蓄積したり交換したりする必要はありません。準備金要件を満たし、ネットワークを通じてトランザクションを送信するコストを支払うために、少量のXRP残高を保有する必要があるだけです。XRP換算で10USドルあれば、取引量の多い発行者にとっては、少なくとも1年間のトランザクションコストを賄えるはずです。 + +より詳細な情報は[XRPとは？](what-is-xrp.html)や[準備金](reserves.html)、[トランザクションコスト](transaction-cost.html)をご覧ください。 + + +### 流動性と取引 + +XRP Ledgerには分散型取引所があり、どのユーザもXRPとトークンを任意の組み合わせで交換するための注文を出し、それを約定することができます。分散型取引所は、アトミックな[クロスカレンシー決済](cross-currency-payments.html)を可能にする流動性も提供します。 + +ステーブルコインの発行者は、分散型取引所を直接利用する必要はありませんが、すべてのトークンは自動的に取引可能になります。トークンが広く使われていれば、ユーザ同士で自然に取引され、他の人気アセットへの流動性が生まれるはずです。発行者は、特にそのトークンが新しい場合、XRPや他の人気のあるトークンに基準レートで流動性を提供したいと考えるかもしれません。ステーブルコインの発行者が流動性を提供する場合のベストプラクティスは、**取引用と発行用で異なるアドレスを使用することです**。 + +分散型取引所の詳細については、[分散型取引所](decentralized-exchange.html)をご覧ください。 + + + + +## 推奨されるビジネスプラクティス + +XRP Ledgerにおけるステーブルコイン発行者のトークンの価値は、顧客が必要なときにトークンを換金できるという信頼に直結します。事業停止のリスクを減らすには、以下のベストプラクティスに従う必要があります。 + +* ネットワーク上のリスク要因を限定するため、[発行・運用アドレス](account-types.html)を分けて使用する。 +* [銀行秘密保護法](http://en.wikipedia.org/wiki/Bank_Secrecy_Act)など、管轄区域のマネーロンダリング防止規制に従う。これには通常、["Know-Your-Customer" (KYC) 情報](https://ja.wikipedia.org/wiki/KYC)を収集する要件が含まれます。 +* XRP Ledger財団の[トークン発行者自己評価](https://foundation.xrpl.org/token-assessment-framework/)を完了する。 +* すべての方針と手数料を公表する。 + + +### ホットウォレットとコールドウォレット + +{% include '_snippets/issuing-and-operational-addresses-intro.ja.md' %} + +主な記事: [発行アドレスと運用アドレス](account-types.html) + + +## 手数料および収益源 + +ステーブルコイン発行者は、以下のような様々な方法で収益を得ることができます。 + +- 出金または入金の手数料。発行者は、XRP Ledgerに資金を出し入れするサービスに対して、少額の手数料(1％など)を請求することができます。この手数料はXRP Ledger上では請求されませんが、発行者がユーザに発行または入金する金額を決定する際に、独自のシステムで請求されます。 +- 送金手数料。発行者は、ユーザがXRP Ledger内でステーブルコインを送金する際に請求する手数料をパーセンテージで設定することができます。この金額は、ユーザが取引を行うたびにXRP Ledgerから引き落とされ、発行者がレジャーの外で保有する資産の量を減らすことなく、ステーブルコインの発行者がレジャー内でユーザに対する債務の総額を減少させることができます。 +- 付加価値による間接的な収益。ステーブルコインは、他の関連するサービスの導入を容易にすることができる便利な機能を提供します。 +- 担保への利息。担保の利子について発行者は、ステーブルコインの担保となる資産を利子のつく口座で保有することができます。もちろん、顧客の引き出しに対応できる十分な資金に常にアクセスできるようにする必要があります。 +- 金融取引所。事業者は分散型取引所で自社のステーブルコインを売買し、クロスカレンシー決済に流動性を与え、場合によっては利益を得ることができます。(すべての金融取引と同様に、利益は保証されません)。 + + +### 手数料の選択 + +トークンの手数料はオプションです。高い手数料は、そのトークンが使用されたときに、より多くの収益を得ることができます。一方、手数料が高いと、顧客のサービス使用意欲を低下させます。他の発行者、特に同じ種類の資産を裏付けとするトークンを持つ他の発行者が請求する手数料や、送金手数料のようなXRP Ledger以外の伝統的な決済システムなどを考慮するとよいでしょう。正しい手数料体系を選択するためには、あなたの価格設定と市場が支払うことを望んでいる価格とのバランスをとることが重要です。 + + +## コンプライアンス指針 + +トークン発行者は、各国の規制を遵守し、適切な機関に報告する責任があります。規制は国や州によって異なりますが、以下のセクションで説明する報告やコンプライアンスの要件が含まれる場合があります。トークンを発行する前に、管轄区域やユースケースの要件について、専門家の法的助言を求める必要があります。以下のリソースは、背景情報として参考になる可能性があります。 + +### Know Your Customer (KYC) + +KYC(Know Your Customer)とは、金融機関が犯罪行為に利用されるのを防ぐために、顧客の身元を特定し確認するために行うデューデリジェンス活動のことです。金融用語でいう犯罪行為には、マネーロンダリング、テロ資金調達、金融詐欺、個人情報盗難などが含まれます。顧客は、個人、仲介者、企業のいずれでもあり得ます。 + +KYCプロセスは、一般的に次のことを目的としています。 + +- 顧客(組織や企業の場合は、実質的な所有者)の特定 + +- 取引関係の目的および意図された事項の理解 + +- 想定される取引活動の把握 + +KYCは、金融機関や関連企業にとって、リスク、特に法的リスクや風評リスクを軽減するために重要です。KYCプログラムが不十分であったり、存在しなかったりすると、金融機関や従業員個人に対して民事上・刑事上の罰則が科される可能性があります。 + +関連項目: + +- [(米国）銀行秘密保護法／マネーロンダリング防止審査マニュアル](https://bsaaml.ffiec.gov/manual/Introduction/01) + +- [金融活動作業部会(FATF)が定めたKYCに関する米国以外の基準について](http://www.fatf-gafi.org/publications/fatfrecommendations/documents/fatf-recommendations.html) + +### マネーロンダリング防止(AML)およびテロ資金調達対策(CFT)について + +マネーロンダリングとは、資金源、性質、所有者を偽装することによって違法な資金を移動させ、合法的な金融チャネルや信頼できる機関を通じて資金を合法的にアクセスまたは分配できるようにするプロセスである。つまり、「不正なお金」を「不正でないお金」に変換することです。アンチマネーロンダリング(AML)とは、マネーロンダリングの発生を阻止するために作られた法律と手続きのことです。 + +テロ資金とは、テロ活動に従事する組織、またはテロやその拡散を支援する組織に対する資金の勧誘、収集、提供のことです。テロ資金調達対策(CFT)とは、テロ資金調達に使われる資金の流れを特定し、報告し、阻止するプロセスを指します。 + +関連項目: + +- ["マネーロンダリングとテロリズム・拡散の資金調達との闘いに関する国際基準" FATF、2012年](http://www.fatf-gafi.org/publications/fatfrecommendations/documents/fatf-recommendations.html) + +- ["仮想通貨： 主要な定義と潜在的なAML/CFTリスク". FATF、2014年](http://www.fatf-gafi.org/publications/methodsandtrends/documents/virtual-currency-definitions-aml-cft-risk.html) + +### 資金源 + +金融機関は、不正な資金がシステムを通過するのを防ぐために、顧客の資金源が犯罪行為と関連しているかどうかを合理的に判断する必要があります。 + +すべての顧客の正確な資金源を特定することは、管理上実行不可能な場合があります。その結果、規制当局の中には、すべての口座について特定の規制やガイダンスを提供しない場合もある。しかし、特定の場合には、当局は金融機関に対して資金源を特定し報告することを求めることができる。FATFのガイダンスでは、マネーロンダリングやテロ資金供与のリスクが高い場合(一般に「リスクに応じたアプローチ」と呼ばれる)、金融機関は顧客の資金源を特定することを含むがこれに限定されないデューデリジェンスの強化を行うことを勧告しています。 + +### 不審行為報告書 + +金融機関は、資金が犯罪行為に関連している可能性があると疑われる場合、適切な規制当局に不審行為報告書/Suspicious Activity Report (SAR)を提出する必要があります。疑わしい活動を報告しなかった場合、金融機関は罰則を受ける可能性があります。 + +関連項目: + +- [不審行為報告書の概要(米国FFIEC)](https://bsaaml.ffiec.gov/manual/RegulatoryRequirements/04_ep) + +- [FATF勧告16：不審な取引の報告およびコンプライアンス](http://www.fatf-gafi.org/publications/fatfrecommendations/documents/fatf-recommendations.html) + +### トラベルルール + +トラベルルールとは、銀行機密保護法(BSA)に基づき、資金送金が米ドル換算で3,000ドル以上の場合、資金送金を行う金融機関に特定の情報を次の金融機関に転送することを義務付けるルールです。送金指示書には、以下の情報を記載する必要があります。 + +- 送信者の氏名 +- 送信者の口座番号(使用する場合) +- 送信者の住所 +- 送金者の金融機関の名称 +- 送信指示の金額 +- 送金注文の金額、送金注文の実行日 +- 受取人の金融機関の名称 + +関連項目: + +- [ファンドの「トラベル」規制について： 質問と回答](https://www.fincen.gov/resources/statutes-regulations/guidance/funds-travel-regulations-questions-answers) + +### 手数料の開示と資金の追跡 + +- 米国では、Dodd Frank 1073 Electronic Fund Transfer Act (Regulation E)により、銀行は米国発の国際決済について、為替レート、手数料、外国の指定受取人が受け取る金額など、コストと配送条件に関する情報を提供することが義務付けられています。「Pre-payment disclosure」は国際電子決済を依頼する際に消費者に提供され、「Receiption disclosure」は消費者が送金を許可する際に消費者に提供されます。 + + 関連項目 + + - [消費者金融保護局の説明による、銀行に対する規制とその適用範囲について](https://www.consumerfinance.gov/rules-policy/final-rules/electronic-fund-transfers-regulation-e/#rule) + +- 欧州連合(EU)では、EU資金移動規制により、マネーロンダリングやテロ資金供与を検知、調査、防止するために、送金元の銀行、受取人の銀行、仲介銀行がトランザクションの詳細に支払人と受取人の特定の情報を含めることが義務付けられています。 + + 関連項目: + + - [EU規則(EC) No 1781/2006の説明](http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2006:345:0001:0009:EN:PDF) + + - [2017年6月26日より施行 資金移動に付随する情報に関する規則2015/847号](http://eur-lex.europa.eu/legal-content/EN/ALL/?uri=CELEX%3A32015R0847) + +### 外国資産管理局(OFAC) + +外国資産管理局(OFAC)は、米国財務省の機関であり、米国の外交政策および国家安全保障上の目的を支援するために、経済制裁および貿易制裁を管理・執行しています。すべての米国人、米国法人およびその海外支店は、OFACの規制に従う必要があります。OFACの規制では、米国の金融機関は、OFACの許可または法令による明示的な除外がない限り、OFACが管理・執行する制裁または禁輸プログラム下の個人、団体、または国との取引およびその他の取引を行うことが禁止されています。 + +関連項目: + +- [OFAC関連資料の一覧](https://www.treasury.gov/resource-center/faqs/Sanctions/Pages/ques_index.aspx) + +### 仮想通貨・マネーサービス事業に関する指針について + +- 米国: + + - [仮想通貨に関するFinCENのガイダンスと定義(2013年3月18日付)](https://www.fincen.gov/resources/statutes-regulations/guidance/application-fincens-regulations-persons-administering) + + - [FinCEN、仮想通貨のマイナーと投資家に関する2つの裁定を発表 2014年1月30日](https://www.fincen.gov/news/news-releases/fincen-publishes-two-rulings-virtual-currency-miners-and-investors) + +- ヨーロッパ: + + - [仮想通貨に関する欧州銀行監督機構意見書(2014年7月4日付)](http://www.eba.europa.eu/documents/10180/657547/EBA-Op-2014-08+Opinion+on+Virtual+Currencies.pdf) + +- FATFの金融事業者向けガイダンス: + + - [金融活動作業部会、2009年7月](http://www.fatf-gafi.org/media/fatf/documents/reports/Guidance-RBA-money-value-transfer-services.pdf) + + + + +# XRP Ledgerの統合 + +本書では、ACME Exchangeという架空の暗号資産取引所が、XRP Ledger上でEURステーブルコインを発行することを決定した例を用いて、ステーブルコインの全体プロセスや資金フローを説明します。 + +## 統合前 + +暗号資産取引所としてのACMEは、すでに何らかのシステム(アプリやウェブサイトなど)を使って顧客からの出金や入金を受け付けています。ACMEは、各ユーザが数種類の資産のそれぞれをどれだけ取引所に保有しているかを追跡するための「記録システム」を持っています。このようなシステムは、単純な貸借対照表でモデル化することができますが、実際には、データベースやアプリケーションサーバ、その他信頼性や情報セキュリティなどを確保するためのさまざまなインフラが必要でしょう。 + +以下の図では、ACME Exchangeは、Bobの所有する1ユーロ、Charlieの所有する2ユーロ、さらにACME自身の所有する2ユーロの資本を含み、手元に5ユーロでスタートする。Aliceが5ユーロを入金したので、ACMEは彼女をバランスシートに加え、最終的に10ユーロになります。 + +![図： アリスがACMEに5ユーロを送金する。ACMEは彼女の残高を貸借対照表に追加する。](img/e2g-01.png) + +**前提条件:** XRP Ledgerと連携するために、ACMEのような取引所が以下の前提を満たしていることを想定しています。 + +* ACMEはすでに、何らかの外部の決済手段から入出金を受け付けるシステムを持っています。 +* ACMEは、ACMEの記録システムに入金される前に、入金の処理を待ちます。 +* ACMEは、その条件に従って、要求に応じて引き出しを行うのに十分な資金を常に手元に置いています。 + * ACMEは、そのビジネスモデルの必要に応じて、手数料、最低出金額、入出金の遅延時間などを設定することができます。 + +## XRP Ledgerへの送金 + +XRP Ledgerに _お金を送る_ には、ACMEがユーザの代わりに保有している金額に対して、新しいステーブルコインを発行する必要があります。フロー例としては、以下のようなものがあります。 + +1. AliceはACMEの残高のうち3ユーロをXRP Ledgerに送るよう依頼します。 +2. ACMEの記録システムでは、アリスの残高€3が差し引かれます。 +3. ACMEはXRP Ledgerのトランザクションを提出し、アリスのXRP Ledgerのアドレスに3ユーロを送ります。3ユーロはXRP Ledgerで、ACMEによって「発行」されたものとしてマークされます(3 EUR.ACME)。 + +**前提条件:** + +* AliceはすでにACMEアカウントとは別にXRP Ledgerにアドレスを持っています。Aliceは、サードパーティのクライアントアプリケーション(ウォレット)を使って、自分のXRP Ledgerのアドレスを管理しています。 + +![図： ACMEはXRP Ledger上でAliceに3EUR.ACMEを発行する。](img/e2g-02.png) + + + +この後、Aliceは自分のEUR.ACMEをXRP Ledgerの他のユーザに任意で送金したり取引したりすることができます。ACMEはいつでも、XRP Ledgerに照会して、誰が現在そのトークンを保持しているかを確認することができます。 + +### XRP Ledgerへ送金するための要件 + +そのためには、ACMEが満たさなければならない前提条件がいくつかあります。 + +- ACMEは、自社のステーブルコインを支える資金を確保します。その方法にはいくつか考えられます。 + - ACMEは、ACMEの記録システムにおいてXRP Ledger用担保口座を作成する。 + - ACMEは、XRP Ledgerに割り当てられた資金を、別の銀行口座に保管することもできます。 + - ステーブルコインが暗号資産によって支えられている場合、ACMEはXRP Ledgerに割り当てられた資金を保持するための別のウォレットを作成し、その準備金を公に検証可能な証明とすることができます。 +- ACME は、2つの別々のXRP Ledgerアドレスを管理する必要があります。詳細は[発行・運用アドレス](account-types.html)をご覧ください。 + - ACMEは、顧客がそのトークンを送受信するために、その発行アドレスでDefault Rippleフラグを有効にする必要があります。 +- Aliceは自分のXRP LedgerアドレスからACMEの発行アドレスへのアカウント関係(トラストライン)を作成する必要があります。彼女はACMEの発行アドレスを知っている限り、どのXRP Ledgerのクライアントアプリケーションからでもトラストラインの作成を行うことができます。 + - 発行アドレスは、ACMEのウェブサイト上で顧客が見つけることができるように公表する必要があります。また、[`xrp-ledger.toml`ファイル](xrp-ledger-toml.html)を使用して、自動化されたシステムに発行アドレスを公開することも出来ます。 + - また、ACMEはペイメントを送る代わりに、XRP LedgerにAliceに小切手を送付することもできます。この場合、資金はすぐに移動しませんが、アリスが小切手を現金化する際、トークンが送付されると同時にトラストラインが作成されます。 +- ACMEは、AliceがACME上の自身の資金をXRP Ledgerへ送ることを依頼するためのユーザインターフェイスを作成しなければなりません。 + - ACMEはAliceのXRP Ledger・アドレスを把握する必要があります。ACMEはAliceにインターフェイスの一部として彼女のXRP Ledgerアドレスを入力させる事も出来ますし、ACMEはAliceに彼女のXRP Ledgerアドレスを事前に入力し、確認するよう要求する事も出来ます。 + + +## XRP Ledgerからの送金 + +XRP Ledgerからの支払いは、発行者がXRP Ledgerで支払いを受け取り、発行者の記録システムでユーザに入金することを意味します。 + +XRP レジャーから入金されるフロー例 + +1. BobはACMEの発行アドレスに1ユーロのXRP Ledgerのトランザクションを送信します。 +2. ACMEの記録システムでは、ACMEはBobの残高に€1を入金します。 +3. その後、ボブはACME独自のインターフェースを使って、SEPAシステム(欧州)やACH(米国)を使った銀行預金の依頼、他のブロックチェーンでの支払いの受け取りなど、別の口座にお金を引き出すことができます。 + +XRP Ledgerにおける発行者への支払いは、単一通貨建てでもクロスカレンシー建てでも可能ですが、発行者が受け取る金額は通常、発行したステーブルコイン建てとなります。 + + +### XRP Ledgerへの入金の要件 + +XRP Ledgerに送信するための要件に加えて、ACMEがXRP Ledgerでの入金を処理するために満たすべき前提条件がいくつかあります。 + +- ACMEは、XRP Ledgerのアドレスへの入金を監視する必要があります。 +- ACMEは、入金された支払いについて、その記録システムでどのユーザに入金すべきかを特定する必要があります。 + - ACMEは、不明な入金を送信者に返金する必要があります。 + - 一般的に、入金を識別する方法としては、[宛先タグ](source-and-destination-tags.html)を使用することが推奨されています。 + + +## 注意事項 + +XRP Ledgerとの間で支払いを処理することは、当然ながらいくつかのリスクを伴うものであり、発行者はこれらの処理を実施する際には細心の注意を払う必要があります。ステーブルコインの発行者としては、以下の点に注意する必要があります。 + +- 可逆的な預金から身を守る。XRP レジャーの支払いは不可逆的ですが、多くのデジタル支払いはそうではありません。悪質な業者はこれを悪用して、XRP Ledgerでトークンを受け取った後に取引所からの出金をキャンセルして、現金(fiat money)を奪い取ろうとすることがあります。 +- XRP Ledgerに送金する際は、トークンの発行元として必ず発行者自身のアドレスを指定してください。そうでない場合、他のアドレスが発行した同じ通貨を送金するパスを誤って使用する可能性があります。 +- XRP Ledgerに支払いを送信する前に、支払いのコストを再確認してください。あなたの運用アドレスから顧客への支払いは、宛先金額とあなたが設定した送金手数料を超える費用は発生しないはずです。 +- XRP レジャーから支払いを処理する前に、顧客の身元を確認するようにしてください。これにより、匿名の攻撃者による不正行為が難しくなります。いずれにせよ、ほとんどのマネーロンダリング防止規制はこれを求めています。XRP Ledgerから入金するユーザは、XRP レジャーで最初に出金ユーザと異なる可能性があるため、これは特に重要です。 +- XRP Ledgerのトランザクションを送信する際には、信頼性の高いトランザクション送信のためのガイドラインに従ってください。 +- 入金をしっかりと監視し、正しい金額を把握する。相手が[部分支払い](partial-payments.html)による送金にもかかわらず、間違っても全額を入金しないように注意する必要があります。 +- XRP レジャー内の負債と残高を追跡し、担保口座の資産と比較してください。一致しない場合は、相違点を解決するまで、引き出しと入金の処理を停止してください。 +- あいまいな状況を避けることを推奨しています。 + - 顧客が誤ってXRPを送らないように、発行アドレスとすべての運用アドレスに対して「Disallow XRP」フラグを有効にしてください。(民間取引所は通常XRPを取引するため、このフラグを設定するべきではありません。) + - 発行アドレスとすべての運用アドレスに対して、[`RequireDest`フラグ](require-destination-tags.html)を有効にすることで、顧客が誤って入金先を示す宛先タグなしで支払いを送信することがないようにします。 + - 誤って通貨を発行できないように、すべての運用アドレスで`RequireAuth`フラグを有効にする。 +- 疑わしい行動や不正な行動を監視する。例えば、ユーザがXRP Ledgerに繰り返し資金を出し入れすることで、運用アドレスの残高を実質的に空にするサービス拒否攻撃などが考えられます。不審な行動に関与している顧客のアドレスのXRP Ledgerの支払いを処理しないことで、その顧客の利用を一時停止することも考えられます。 + +## XRP Ledger上での取引 + +XRP Ledgerでトークンが送付された後、XRP Ledgerのユーザはトークンを自由に譲渡したり取引したりすることができる。このような状況では、いくつかの影響が生じます。 + +- 誰でもXRP Ledger上でEUR.ACMEを売買することができます。ACMEが複数のトークンを発行する場合、それぞれ別のトラストラインが必要です。 + - これには、ACME Exchangeのシステムにアカウントを持っていないXRP Ledgerのユーザも含まれます。ACMEから資金を適切に引き出すには、ユーザはACMEに登録する必要があります。 + - オプションとして、ACMEは認可トラストライン機能を使用して、XRP LedgerでEUR.ACMEを保有できる人を制限することができます。 + - ACMEは、顧客が不正な行為をしたと判断した場合、XRP LedgerにおいてそのユーザのACMEに対する会計関係を凍結し、そのユーザが発行者のトークンを取引できないようにすることができます。 +- XRP Ledgerのユーザが互いにEUR.ACMEを取引・送信する場合、ACMEによる介入は一切不要です。 +- XRP Ledger上のすべての取引所と残高はすべて公開されています。 + +次の図は、AliceからCharlieに2EUR.ACMEを送るXRP Ledgerの支払いを表しています。ACMEはトランザクションが発生した後、いつでもその残高の更新を確認するためにXRP Ledgerに問い合わせることができます。 + +![図: Aliceはトラストラインを経由し、Charlieに2 EUR.ACMEを送信する。](img/e2g-03.png) + + + +## 凍結 + +発行者は、規制要件を満たすために、XRP Ledgerの会計関係を凍結することができます。 + +* 発行者は、顧客アドレスに不審な動きが見られたり、発行者の利用規約に違反した場合に備えて、個別の会計関係を凍結することができます。 +* 発行者は、重大なセキュリティ侵害や新しい発行アドレスへの移行に備え、発行したトークンをすべて凍結することもできます。 +* さらに、発行者は、会計関係を凍結する能力を永久的に放棄することができます。これにより、発行者は「物理的なお金に近い」サービスを提供し続けることを顧客に保証することができます。 + +より詳細な情報は[トークンの凍結](freezes.html)をご覧ください。 + + +## 認可トラストライン + +XRP Ledgerの認可トラストライン機能(旧称「認可アカウント」)は、発行者がその発行者のトークンを保有できる人を制限することを可能にし、未知のXRP Ledgerのアドレスがトークンを保有できないようにします。 + +より詳細な情報は[認可トラストライン](authorized-trust-lines.html)をご覧ください + + +## 送信タグと宛先タグ + +*宛先タグ*は、XRP Ledgerの支払いの機能の一つで、支払いの受取人または宛先を示すために使用されます。例えば、XRP Ledgerの発行者への支払いは、どの顧客にその支払いが入金されるかを示すために、宛先タグを含むことができます。発行者は、発行者の記録システムにおいて、宛先タグと口座のマッピングを保持する必要があります。 + +同様に、*送金タグ*は、支払の発信者または送信元を示します。最も一般的なのは、支払いの受取人が支払いを返金する場所を知るために、送金タグを含めることです。受信した支払いを返金する場合、受信した支払いの送金タグを送信(返金)する支払いの宛先タグとして使用します。 + +顧客が送金しようとするときに、オンデマンドで宛先タグを生成することができます。顧客のプライバシーを守るため、その宛先タグは予定金額の支払いに対してのみ有効であると考え、同じ宛先タグを再利用する他のトランザクションは返金するか無視する必要があります。 + +発行アドレスと運用アドレスで[宛先タグを要求する設定](require-destination-tags.html)を有効にすることで、顧客は支払いを送る際に宛先タグを使用して資金の入金先を示す必要が生まれます。 + +より詳細な情報は[送信タグと宛先タグ](source-and-destination-tags.html)をご覧ください + + +# 技術的な内容 + +## インフラストラクチャ + +あなた自身のセキュリティとネットワークの安定性のために、XRP Ledgerを利用する事業者は、1つの[バリデータ](rippled-server-modes.html#validators)を含む[独自のXRP Ledgerサーバ](install-rippled.html)を実行すべきです。 + + +### APIとミドルウェア + +XRP Ledgerへの接続方法は、ニーズや 既存のソフトウェアに応じて、いくつかのインターフェイスを使用することができます。 + +- [HTTP / WebSocket API](http-websocket-apis.html)は、XRP Ledgerのすべてのコア機能への低レベルのインターフェースとして使用することができます。 +- [クライアントライブラリ](client-libraries.html)は、いくつかのプログラミング言語で利用でき、XRP Ledgerにアクセスするための便利なユーティリティを提供します。 +- その他、[xApps](https://xumm.readme.io/docs/xapps)などのツールも利用可能です。 +- サードパーティのウォレットアプリケーションも、特に待機アドレスを担当する人間には便利かもしれません。 + + +## ツールのセキュリティ + +XRP Ledgerのトランザクションを送信するときはいつでも、あなたの秘密鍵を使って署名する必要があります。秘密鍵は、あなたのXRP Ledgerアドレスを完全にコントロールすることができます。**決して**他人が運営するサーバにあなたの秘密鍵を送ってはいけません。自分のサーバを使うか、クライアントライブラリを使用してローカルでトランザクションに署名してください。 + +安全な設定の手順や例については、[安全な署名の設定](secure-signing.html)をご覧ください。 + +## 発行者のセットアップ + +トークンの発行を開始する前に、XRP Ledgerアカウントで設定する必要がある設定がいくつかあります。これらの設定の例については、[代替可能トークンを発行するチュートリアル](issue-a-fungible-token.html)をご覧ください。 + +設定すべき項目は以下の通りです。 + +| 設定 | 備考 | +|---------|-------| +| Default Ripple | 発行者は、このフィールドを**必ず**有効にする必要があります。 | +| Deposit Authorization | 明示的に承認していないユーザからの入金をすべてブロックします。 | +| Require Auth | トークンの保持を、明示的に承認したユーザに限定します。 | +| Tick Size | 分散型取引所の取引所為替レートを四捨五入して、より迅速な価格決定を可能にします。 | +| Transfer Fee | ユーザ同士がトークンを送信する際に、一定割合の手数料を徴収します。 | + + +### Default Ripple + +Default Rippleフラグは、トラストラインの残高をデフォルトで[Ripplingを許可](rippling.html)するかどうかを制御します。Ripplingは顧客同士のトークンの送信や取引を可能にするものなので、発行者はその発行アドレスへのすべてのトラストラインでのRipplingを許可しなければなりません(MUST)。 + +顧客に発行アドレスへのトラストラインの作成を依頼する前に、発行者はそのアドレスのDefault Rippleフラグを有効にする必要があります。そうでない場合、発行者は、他のアドレスが作成した各トラストラインのNo Rippleフラグを個別に無効化する必要があります。 + + +### Deposit Authorization + +Deposit Authorizationの設定は、以下のいずれかを行わない限り、アカウントへのすべての入金をブロックします。 + +- 事前に送信者を事前認可している。 +- 資金を受け取るためにトランザクションを送信します。例えば、他人が開始したエスクローを終了させることができます。 + +Deposit Authorizationは、不要なXRPの支払いをブロックするのに最も有効です。なぜなら、発行元へのトラストラインを作成しない限り、既にトークンを受け取ることはできないからです。しかし、ステーブルコインの発行者としては、ステーブルコインをレジャー外の価値と交換するために、ユーザからの支払いを受け取ることができる必要があります。顧客を事前認可することはできますが、そうすると、顧客それぞれのアドレスについてレジャーにオブジェクトを格納する必要があり、準備金が大幅に増加します。 + +したがって、未知または制裁を受けたエンティティからお金を受け取ることに関する規制要件を満たすために必要でない限り、Deposit Authorizationはステーブルコインの発行者に推奨されません。 + +より詳細な情報は[Deposit Authorization](depositauth.html)をご覧ください。 + + +### Disallow XRP + +Disallow XRPの設定は、XRP Ledgerのユーザが誤ってXRPをアドレスに送信することを阻止するために設計されています。これは、XRPの受信と保持を意図していないアドレスからの不必要な返金コストと労力を削減するものです。なぜなら、そうすることでアドレスがXRPを誤って送金した場合に返金されずにXRPを失う可能性があるからです。クライアントアプリケーションは、デフォルトでDisallow XRPフラグを尊重すべきですが、ユーザがそれを無視することを許可する場合もあります。 + +Disallow XRPフラグはオプションですが、顧客からXRPを受け取るつもりがない場合は、発行アドレスとすべての運用アドレスで有効にしておくとよいでしょう。 + + +### Require Auth + +Require Authの設定は、最初にトラストラインを明示的に承認しない限り、発行したトークンをユーザが保持することをブロックします。XRP Ledger内で誰があなたのトークンを保持するかが重要である場合、規制要件を満たすためにこの設定を使用することができます。しかし、この設定は、ユーザへの承認がトークンを使用するためのボトルネックとなるため、トークンの有用性を低下させる可能性があります。 + +また、トラストラインを認可するたびに発行アドレスを使用する必要があります。多くのトラストラインを認可する必要がある場合、発行アドレスを頻繁に使用することになるため、発行アドレスのセキュリティが損なわれる可能性があります。(発行アドレスの使用頻度が少ない場合は、秘密鍵の保護を強化することができます。使用頻度が高ければ高いほど、その保護は大きな負担となります)。 + +より詳細な情報は[Authorized Trust Lines](authorized-trust-lines.html)をご覧ください。 + + +### Tick Size + +Tick Sizeは、[分散型取引所](decentralized-exchange.html)で為替レートを計算する際に使用する小数点以下の桁数を制御する設定です。Tick Sizeを大きくすると、より精度が高くなり、さまざまな取引の金額で丸め込みが少なくなります。取引は主に取引レートに基づいてランク付けされるため、トレーダーがリストの上位にわずかな金額を提供することができるため、精度が高すぎると不都合になることがあります。Tick Sizeを小さくすると、オークションの最低入札額と同じような効果があり、無関係な小額を徐々に入札する時間と労力が省けます。しかし、Tick Sizeを小さくすると四捨五入が多くなり、取引コストが高くなります。また、四捨五入前は完全に一致するように見えた2つのオファーが、四捨五入後は一致しなくなるという意外な結果になることもあります。 + +Tick Sizeはアカウントレベルの設定であり、同じアドレスで発行されたすべてのトークンに適用されます。 + +Tick Sizeは取引レートの精度を制御するだけで、トークン自体の精度を制御するものではありません。ユーザは、トークンの発行者が設定したTic Sizeに関係なく、非常に大きな金額や非常に小さな金額を送ったり保有したりすることができます。 + +より詳細な情報は[Tick Size](ticksize.html)をご覧ください。 + + +### Transfer Fees + +送金手数料の設定は、ユーザ同士がトークンを送金する際に、一定割合の手数料を請求するものです。送金手数料は、トークンを発行したり、発行アドレスで直接トークンを交換したりする場合には適用されません。(ユーザが発行アドレスに送金ときには適用されます。)同じアドレスから複数のトークンを発行する場合、すべてのトークンに対して同じ送金手数料が適用されます。 + +ユーザが送金手数料が設定されたトークンを送信すると、送信側から送金先金額に加えて送金手数料の金額が引き落とされますが、受信側には送金先金額のみが入金されます。手数料の金額はXRP Ledgerから「消える」のです。ステーブルコインの発行者としては、XRP Ledgerの外にある準備金にそれだけ自己資本が増える、言い換えれば、ユーザが送金手数料を支払うたびに担保として持っておく必要がある金額が減少することを意味します。 + +プロトコルレベルでは、送金手数料はアカウント設定の`TransferRate`で定義され、これは10億から20億までの整数で指定されます。 + +より詳細な情報は[Transfer Fees](transfer-fees.html)をご覧ください。 + + +### 運用アドレスと待機アドレスによる送金手数料 + +運用アドレスや待機アドレスを含むすべてのXRP Ledgerアドレスは、トークンを送信する際に発行者の送金手数料がかかります。送金手数料をゼロ以外に設定した場合、運用アドレスや待機アドレスから支払いを行う際に、(送金手数料を支払うために)余分に送金しなければなりません。つまり、あなたのアドレスは、支払いを行うたびに、あなたの発行アドレスが作った残高を少し返金する必要があります。 + +[トランザクションパラメータ`SendMax`][Payment]を送信先の`Amount`パラメータよりも`TransferRate`設定に基づく割合で高く設定します。 + +**注記:** 発行アドレスから、または発行アドレスへ直接トークンを送信する場合、送金手数料は適用されません。発行アドレスは、常にそのトークンをXRP Ledgerの額面価格で受け入れなければなりません。つまり、顧客が発行アドレスに直接支払いを送る場合は送金手数料を支払う必要はありませんが、運用アドレスに送る場合は支払う必要があります。両方のアドレスで支払いを受け付ける場合、顧客が運用アドレスに支払いを送る際に、顧客が支払う送金手数料を補うために、記録システムで顧客に入金する金額を調整する必要がある場合があります。 + +例えば、次のようなものです。ACMEが送金手数料を1％に設定した場合、顧客のアドレスからACMEの発行アドレスに5 EUR.ACMEを届けるためのXRP Ledger支払いは、ちょうど5 EUR.ACMEの費用がかかります。しかし、顧客は5 EUR.ACMEをACMEの運用アドレスに届けるために、5.05 EUR.ACMEを送る必要があります。ACMEの運用アドレスへの支払いを顧客に入金する際、ACMEは運用アドレスに届けられた金額と送金手数料を顧客に入金し、顧客はACMEのシステムで5.05ユーロを受け取ることができます。 + + +## 支払いに関するモニタリングの徹底 + +入金チェックを確実に行うために、発行者は以下のことを行う必要があります。 + +* 直近に処理したトランザクションとレジャーを記録しておく。そうすれば、一時的に接続ができなくなったとしても、どこまで遡ればいいのか分かります。 +* 受信したすべての支払いの結果コードを確認する。一部の支払いは、失敗したにもかかわらず、スパム対策料金を請求するためにレジャーに登録されます。結果コード`tesSUCCESS`を持つトランザクションだけが、XRP以外の残高を変更できます。また、検証されたレジャーからのトランザクションのみが確定的なものとなります。 +* [部分支払い](partial-payments.html)に注意してください。partial paymentフラグを有効にした場合、0以上の金額であれば、少額でも「成功」と判断されることがあります。 + * トランザクションに[`delivered_amount`フィールド](partial-payments.html#the-delivered_amount-field)があるかどうか確認してください。もし存在すれば、そのフィールドは`Destination`アドレスに実際にどれだけの金額が支払われたかを示しています。 + * xrpl.jsでは、[`xrpl.getBalanceChanges()`メソッド](https://js.xrpl.org/modules.html#getBalanceChanges)を使って、各アドレスがいくら受け取ったかを見ることができます。場合によっては、これを異なるトラストラインで複数回に分けて表示することも可能です。 +* トランザクションの中には、アドレスの1つへの直接の支払いやアドレスからの支払いでなくても、残高を変更するものがあります。たとえば、ACMEがゼロ以外の送金手数料を設定した場合、BobとCharlieがACMEのトークンを交換するたびに、ACMEの発行アドレスの未払い負債が減少します。 + +顧客の利便性を高めるため、運用アドレスと発行アドレスの両方への支払いを受け付けることをお勧めします。 + +追加の防止策として、新しいXRP Ledgerの各レジャーバージョンにおいて、発行アドレスの残高と内部会計システムにおける担保資金を比較することをお勧めします。発行アドレスのマイナス残高は、ネットワーク外のXRP Ledgerに割り当てた資産と一致するはずです。もし両者が一致しないのであれば、その不一致を解決するまでXRP Ledgerへの出入りの支払い処理を中断する必要があります。 + +* 残高を確認するには、`gateway_balances`メソッドを使用します。 +* Transfer Feeが設定されている場合、他のXRP Ledgerアドレスがあなたのトークンを転送するたびに、XRP Ledger内でのあなたの負債はわずかに減少します。 + +受信したトランザクションの詳細を確認する方法については、[トランザクションの結果を確認する](look-up-transaction-results.html)をご覧ください。 + + + +## 顧客への支払いを送信 + +顧客のためにXRP Ledgerに支払いを送る自動システムを構築する場合、そのシステムが支払いを厳密に構築していることを確認する必要があります。悪意ある人物は常に、システムを騙して必要以上に支払いをさせる方法を見つけようとしています。 + +一般的に、ステーブルコインを送る場合は[Payment トランザクション][]を使用します。初めてトークンを発行するのか、ホットウォレットから顧客へ送金するのかによって、細かい点が異なる部分もあります。注意すべき点は以下の通りです。 + +- 発行アドレスから新しいトークンを発行する場合、`SendMax`フィールドを省略する必要があります。そうしないと、悪意のあるユーザは、意図した宛先の`Amount`だけでなく、`SendMax`の全量を発行するように設定を変更することができます。 +- ホットウォレットからトークンを送信する場合、転送手数料がゼロでない場合は`SendMax`を指定する必要があります。この場合、`SendMax`フィールドに`Amount`フィールドで指定した金額と送金手数料を設定します。(計算の精度がXRP Ledgerと正確に一致しない場合に備えて、少し切り上げるとよいでしょう)。例えば、`Amount`フィールドに99.47 USDが指定され、送金手数料が0.25%のトランザクションを送信する場合、`SendMax`フィールドを124.3375、または切り上げる場合は124.34 USDに設定すべきです。 +- `Paths`フィールドを省略します。このフィールドは、発行元から直接送信する場合や、送信するトークンと受信するトークンの通貨コードと発行元が同じである限り、つまり同じステーブルコインである限り、ホットウォレットから設定する必要はありません。`Paths`フィールドは[クロスカレンシー支払い](cross-currency-payments.html)やより長いマルチホップ(rippling)支払いを対象としています。単純に経路探索を行い、トランザクションにパスを設定すると、直接の経路が利用できない場合、支払いは失敗するのではなく、より高価な遠回りのパスを取るかもしれません。悪意のあるユーザはこれを利用して利益を上げる可能性があります。 +- `tecPATH_DRY`の結果コードが表示された場合、通常、必要なトラストラインを顧客がまだ設定していないか、発行者のripplingの設定が正しく設定されていないことを意味します。 + +ステーブルコインであろうとなかろうと、XRP Ledger上でトークンを発行するための詳しいチュートリアルは、[代替可能トークンの発行](issue-a-fungible-token.html)をご覧ください。 + + +## 不明な入金の返金 + +アドレスが不明な支払いを受け取った場合、送金者に返金することが推奨されます。これは、資金を保管するよりも手間がかかりますが、顧客に対する誠意を示すことになります。オペレーターが手動で支払いを返金することもできますし、自動的に返金するシステムを構築することもできます。 + +返金の失敗を防ぐための第一の条件は、入金を適切に監視することです。顧客から送られてきた金額以上の金額を誤って返金してしまうことは避けなければなりません！(悪意のあるユーザは、[部分支払い](partial-payments.html#partial-payments-exploit)を送信して、脆弱なシステムを利用します。) + +第二に、返金を部分支払い(Partial Payment)として送信することです。第三者はアドレス間のパスのコストを操作することができるので、部分支払いを使えば、XRP Ledger内の取引レートを気にすることなく、支払い金額の全額を手放すことができます。利用規約の一部に、支払い失敗時のポリシーを公表する必要があります。失敗された支払いを、運用中のアドレスまたは待機中のアドレスのいずれかから送信します。 + +部分支払いを送信するには、トランザクションの[`tfPartialPayment`フラグ](payment.html#payment-flags)を有効にします。`Amount`フィールドに受け取った金額を設定し、`SendMax`フィールドは省略します。受信した支払いの`SourceTag`値を、返金する支払いの`DestinationTag`値として使用する必要があります。 + +2つのシステムで返金が繰り返されるのを防ぐため、送信する返金に新しい送信タグを設定することができます。もしシステムが予期しない支払いを受け取った場合で、その支払いの宛先タグが送信した返金の送信元タグと一致する場合は、その支払いを再び返金させないようにします。 + + +## 信頼性の高いトランザクションの送信 + +トランザクションを確実に送信するためには、次の2つを有限の時間で実現することが必要です。 + +* 冪等性 - トランザクションは一度のみ処理されるか、全く処理されないべきである。 +* 検証可能性 - アプリケーションはトランザクションの最終結果を確認することができる。 + +トランザクションを確実に送信するために、以下のガイドラインに従ってください。 + +* トランザクションの詳細を保存してから送信する。 +* `LastLedgerSequence`パラメータを使用します。(多くの[クライアントライブラリ](client-libraries.html)では、デフォルトでこのパラメータが使用されます)。 +* レジャーインデックスがトランザクションの`LastLedgerSequence`パラメータ以下である検証済みレジャーにトランザクションが含まれていない場合、トランザクションを再送信します。 + +より詳細な情報は[信頼性の高いトランザクションの送信](reliable-transaction-submission.html)をご覧ください。 + + +## xrp-ledger.toml ファイル + +不正や混乱から守るために、どの通貨を発行し、どのXRP Ledgerのアドレスを管理しているかという情報を、[`xrp-ledger.toml`ファイル](xrp-ledger-toml.html)を使って公表することができます。この機械判読可能なフォーマットは、クライアントアプリケーションが処理するのに便利です。XRP Ledgerのバリデータを実行する場合、同じファイルでキーを公開することもできます。 + + + + +## 関連項目 + +- **コンセプト:** + - [トークン](tokens.html) + - [分散型取引所](decentralized-exchange.html) + - [送信タグと宛先タグ](source-and-destination-tags.html) +- **チュートリアル:** + - [`rippled`のインストール](install-rippled.html) + - [安全な署名の設定](secure-signing.html) + - [非代替性トークンの発行](issue-a-fungible-token.html) + - [No Freezeの有効化](enable-no-freeze.html) + - [トラストラインの凍結](freeze-a-trust-line.html) + - [Enact Global Freeze](enact-global-freeze.html) +- **リファレンス:** + - [Payment トランザクション][] + - [AccountSet トランザクション][] + - [TrustSet トランザクション][] + - [RippleState オブジェクト](ripplestate.html) + - [account_lines メソッド][] + - [gateway_balances メソッド][] + + +{% include '_snippets/rippled-api-links.md' %} +{% include '_snippets/tx-type-links.md' %} +{% include '_snippets/rippled_versions.md' %} diff --git a/dactyl-config.yml b/dactyl-config.yml index 9034c44368..a2d945769b 100644 --- a/dactyl-config.yml +++ b/dactyl-config.yml @@ -500,7 +500,7 @@ pages: html: introduction.html parent: docs.html template: pagetype-category.html.jinja - blurb: XRP Ledgerとは「何なのか」、「なぜなのか」を学びましょう。 + blurb: XRP Ledger(XRPL)の主要な機能を簡単に紹介します。これを読んでXRPLのハイレベルな理解を深め、その後、特に興味のある分野についての詳細を読むことができます。XRP Ledgerは、アカウント間のトークンのデジタルトランザクションを永続的に記録するブロックチェーンです。以下のセクションは、その文章で紹介された概念を拡張するものです。 top_nav_grouping: カテゴリ targets: - ja @@ -508,11 +508,17 @@ pages: - md: concepts/introduction/what-is-the-xrp-ledger.md targets: - en + + - md: concepts/introduction/what-is-the-xrp-ledger.ja.md + targets: - ja - md: concepts/introduction/what-is-xrp.md targets: - en + + - md: concepts/introduction/what-is-xrp.ja.md + targets: - ja # Redirect from old XRP page @@ -529,12 +535,20 @@ pages: parent: introduction.html targets: - en + + - md: concepts/introduction/crypto-wallets.ja.md + parent: introduction.html + targets: - ja - md: concepts/introduction/txn-and-requests.md parent: introduction.html targets: - en + + - md: concepts/introduction/txn-and-requests.ja.md + parent: introduction.html + targets: - ja - md: concepts/introduction/software-ecosystem.md @@ -542,7 +556,6 @@ pages: targets: - en - # TODO: update based on EN changes - md: concepts/introduction/software-ecosystem.ja.md parent: introduction.html targets: @@ -591,18 +604,30 @@ pages: parent: payments-uc.html targets: - en + + - md: use-cases/payments/peer-to-peer-payments-uc.ja.md + parent: payments-uc.html + targets: - ja - md: use-cases/payments/restricting-deposits-uc.md parent: payments-uc.html targets: - en + + - md: use-cases/payments/restricting-deposits-uc.ja.md + parent: payments-uc.html + targets: - ja - md: use-cases/payments/smart-contracts-uc.md parent: payments-uc.html targets: - en + + - md: use-cases/payments/smart-contracts-uc.ja.md + parent: payments-uc.html + targets: - ja - name: Tokenization @@ -627,12 +652,20 @@ pages: parent: tokenization.html targets: - en + + - md: use-cases/tokenization/stablecoin-issuer.ja.md + parent: tokenization.html + targets: - ja - md: use-cases/tokenization/nft-mkt-overview.md parent: tokenization.html targets: - en + + - md: use-cases/tokenization/nft-mkt-overview.ja.md + parent: tokenization.html + targets: - ja # TODO: these files aren't nested under "NFT mkt overview" but they are in the nav @@ -640,18 +673,31 @@ pages: parent: nft-mkt-overview.html targets: - en + + # TODO: these files aren't nested under "NFT mkt overview" but they are in the nav + - md: use-cases/tokenization/nftoken-marketplace.ja.md + parent: nft-mkt-overview.html + targets: - ja - md: use-cases/tokenization/authorized-minter.md parent: nft-mkt-overview.html targets: - en + + - md: use-cases/tokenization/authorized-minter.ja.md + parent: nft-mkt-overview.html + targets: - ja - md: use-cases/tokenization/digital-artist.md parent: nft-mkt-overview.html targets: - en + + - md: use-cases/tokenization/digital-artist.ja.md + parent: nft-mkt-overview.html + targets: - ja - name: Decentralized Finance @@ -676,6 +722,10 @@ pages: parent: defi-uc.html targets: - en + + - md: use-cases/defi/algorithmic-trading.ja.md + parent: defi-uc.html + targets: - ja - md: use-cases/defi/list-xrp-as-an-exchange.md