xrpl-dev-portal/content/tutorials/get-started/send-xrp.ja.md

html, parent, blurb, cta_text, embed_xrpl_js, filters, labels, top_nav_grouping

html	parent	blurb	cta_text	embed_xrpl_js	filters	labels	top_nav_grouping
send-xrp.html	get-started.html	Test Netを使用してXRPの送金をテストします。	XRPを送金しよう	true	interactive_steps	支払い XRP	人気ページ

XRPの送金

このチュートリアルでは、xrpl.jsを使用してシンプルなXRP送金を行う方法について説明します。まずは、XRP Testnetを使用してプロセスを順に進めます。次に、そのプロセスと、本番で同様の処理を行う場合に発生する追加要件とを比較します。

前提条件

<script type="application/javascript" src="assets/js/tutorials/send-xrp.js"></script>

{% set use_network = "Testnet" %}

• このページでは、xrpl.jsライブラリーを使用するJavaScriptの例を紹介します。xrpl.js入門ガイドに、xrpl.jsを使用してJavaScriptからXRP Ledgerデータにアクセスする方法の説明があります。

• XRP Ledgerでトランザクションを送信するには、まずアドレスと秘密鍵、そしていくらかのXRPが必要となります。次のインターフェイスを使用して、XRP Test NetにあるアドレスとTestnet XRPを入手できます。

{% include '_snippets/interactive-tutorials/generate-step.ja.md' %}

Testnetでの送金

{% set n = cycler(* range(1,99)) %}

{{n.next()}}. Testnetサーバーへの接続

必須の自動入力可能フィールドに入力されるようにするために、ripple-libを、アカウントの現在のステータスと共有レジャー自体を取得できるサーバーに接続する必要があります。（セキュリティを高めるために、トランザクションの署名はオフライン中に行うことを推奨します。ただしその場合は、自動入力可能フィールドに手動で入力する必要があります。）トランザクションの送信先となるネットワークに接続する必要があります。

以下のサンプルコードでは公開XRP Testnetサーバーに接続します。

JavaScript

{{ include_code("_code-samples/get-started/js/base.js", language="js") }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Connect", end_before="# Get credentials", language="py") }}

Java

{{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Connect", end_before="// Prepare transaction", language="java") }}

このチュートリアルでは、以下のボタンをクリックすることでブラウザーから直接接続できます。

{% include '_snippets/interactive-tutorials/connect-step.ja.md' %}

{{n.next()}}. トランザクションの準備

通常は、XRP LedgerトランザクションをオブジェクトとしてJSONトランザクションフォーマットで作成します。以下の例に、必要最小限の送金仕様を示します。

{
  "TransactionType": "Payment",
  "Account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
  "Amount": "2000000",
  "Destination": "rUCzEr6jrEyMpjhs4wSdQdz4g8Y382NxfM"
}

XRP送金に対して指定する必要がある必要最小限の指示は次のとおりです。

• これが送金であることを示すインディケーター（"TransactionType": "Payment"）
• 送信元アドレス（"Account"）
• XRPを受け取るアドレス（"Destination"）。このアドレスは送信元アドレスと同じものではいけません。
• 送金するXRP額（"Amount"）。通常、XRPの「drop数」を示す整数として指定します。1,000,000ドロップは1 XRPです。

技術上、一部の追加のフィールドは実行可能なトランザクションに含める必要があり、また、省略可能なフィールドでも、LastLedgerSequenceなどは含めることを強く推奨します。autofill()メソッドは、トランザクションの残りのフィールドに適切なデフォルトを自動的に入力します。上記の送金を準備する際の例を示します。

JavaScript

{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Prepare", end_before="// Sign", language="js" ) }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Prepare", end_before="# Sign", language="py" ) }}

Java

{{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Prepare", end_before="// Sign", language="java") }}

{{ start_step("Prepare") }}

送金する額：

XRP

サンプルトランザクションを準備する

{{ end_step() }}

{{n.next()}}. トランザクションの指示への署名

xrpl.jsのWallet.sign()メソッドを使用して、トランザクションに署名します。最初の引数は、署名するJSONトランザクションの文字列バージョンです。

JavaScript

{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Sign", end_before="// Submit", language="js" ) }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Sign", end_before="# Submit", language="py" ) }}

Java

{{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Sign", end_before="// Submit", language="java" ) }}

署名処理の結果は、署名を含むトランザクションオブジェクトになります。通常、XRP Ledger APIは、署名済みトランザクションがトランザクションの正規のバイナリーフォーマット（「ブロブ」と呼ばれる）の16進数表現になることを想定しています。

署名APIは、トランザクションのID、つまり識別用ハッシュを返します。この識別用ハッシュは、後でトランザクションを検索する際に使用します。識別用ハッシュは、このトランザクションに固有の64文字の16進文字列です。

{{ start_step("Sign") }} サンプルトランザクションに署名する

{{ end_step() }}

{{n.next()}}. 署名済みブロブの送信

トランザクションをネットワークに送信します。

JavaScript

{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Submit", end_before="// Wait", language="js" ) }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Submit", end_before="# Wait", language="py") }}

Java {{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Submit", end_before="// Wait", language="java" ) }}

このメソッドは、ローカルでトランザクションを適用しようと試みたときの一時的な結果を返します。この結果は、トランザクションが検証済みレジャーに含まれた時点で変わる_可能性があります_。当初は成功していたトランザクションが最終的に失敗となったり、当初失敗していたトランザクションが最終的に成功する場合があります。しかしながら、一時的な結果はほとんどの場合は最終結果と一致するため、ここでtesSUCCESSが表示されたらひとまず安心しても問題ありません。😁

他の結果が表示された場合は、以下の点を確認します。

• 送信元および送信先の正しいアドレスを使用しているか。
• トランザクションの他のフィールドへの入力漏れ、ステップのスキップ、その他の入力ミスがないか。
• トランザクションの送信に必要なTest Net XRPが十分にあるか。送金できるXRPの額は、必要準備金によって制限されています。現時点では、20XRPに加えて、レジャー内に保有している各「オブジェクト」につき5XRPずつ追加となります。（Test Net Faucetを使用して新しいアドレスを生成した場合は、保有するオブジェクトはありません。）
• テストネットワークのサーバーに接続しているか。

他の可能性については、トランザクション結果の完全なリストを参照してください。

{{ start_step("Submit") }} サンプルトランザクションを送信する

送信中...

{{ end_step() }}

{{n.next()}}. 検証の待機

ほとんどのトランザクションは送信後の次のレジャーバージョンに承認されます。つまり、4～7秒でトランザクションの結果が最終的なものになる可能性があります。XRP Ledgerがビジーになっているか、ネットワーク接続の品質が悪いためにトランザクションをネットワーク内で中継する処理が遅延した場合は、トランザクション確定までにもう少し時間がかかることがあります。（トランザクションの有効期限を設定する方法については、信頼できるトランザクションの送信を参照してください。）

JavaScript

{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Wait", end_before="// Check", language="js" ) }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Wait", end_before="# Check", language="py") }}

Java

{{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Wait", end_before="// Check", language="java" ) }}

{{ start_step("Wait") }} {% include '_snippets/interactive-tutorials/wait-step.ja.md' %} {{ end_step() }}

{{n.next()}}. トランザクションステータスの確認

トランザクションが行った内容を正確に把握するために、トランザクションが検証済みレジャーバージョンに記録されたときにトランザクションの結果を調べる必要があります。例えば、[txメソッド][]を使用して、トランザクションのステータスを確認できます。

JavaScript

{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Check", end_before="// End of", language="js" ) }}

Python

{{ include_code("_code-samples/send-xrp/py/send-xrp.py", start_with="# Check", language="py") }}

Java

{{ include_code("_code-samples/send-xrp/java/SendXrp.java", start_with="// Check", language="java" ) }}

注意: APIは、まだ検証されていないレジャーバージョンからの暫定的な結果を返す場合があります。例えば、rippled APIの[txメソッド][]を使用した場合は、応答内の"validated": trueを探して、データが検証済みレジャーバージョンからのものであることを確認してください。検証済みレジャーバージョンからのものではないトランザクション結果は、変わる可能性があります。詳細は、結果のファイナリティーを参照してください。

{{ start_step("Check") }} トランザクションステータスを確認する

{{ end_step() }}

本番環境の場合の相違点

本番XRP LedgerでXRPを送金する場合も、大部分の手順は同じです。ただし、必要なセットアップでは重要な相違点がいくつかあります。

• 実際のXRPは無料で取得できません。
• 本番XRP Ledgerネットワークと同期されているサーバーに接続する必要があります。

実際のXRPアカウントの取得

このチュートリアルでは、Test Net XRPがすでに資金供給されているアドレスをボタンで取得しましたが、それが可能だったのはTest Net XRPに何の価値もないからです。実際のXRPでは、XRPを所有している他者からXRPを入手する必要があります。（たとえば、取引所で購入する方法など。）xrpl.jsのWallet()クラスを使用して、本番またはTestnetで機能するアドレスとシークレットを生成できます。

JavaScript

const wallet = new xrpl.Wallet()
console.log(wallet.address) // Example: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
console.log(wallet.seed) // Example: sp6JS7f14BuwFY8Mw6bTtLKWauoUs

Python

from xrpl.wallet import Wallet
my_wallet = Wallet.create()
print(my_wallet.address) # Example: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
print(my_wallet.seed)            # Example: sp6JS7f14BuwFY8Mw6bTtLKWauoUs

Java

WalletFactory walletFactory = DefaultWalletFactory.getInstance();
SeedWalletGenerationResult generationResult = walletFactory.randomWallet(false);
Wallet wallet = generationResult.wallet();
System.out.println(wallet.classicAddress()); // Example: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
System.out.println(generationResult.seed()); // Example: sp6JS7f14BuwFY8Mw6bTtLKWauoUs

警告: ローカルマシンで安全な方法で生成したアドレスとシークレットのみを使用してください。別のコンピューターでアドレスとシークレットを生成して、ネットワーク経由でそれらを自分に送信した場合は、ネットワーク上の他の人がその情報を見ることができる可能性があります。その情報見ることができる人は、あなたと同じようにあなたのXRPを操作できます。また、Test Netと本番で同じアドレスを使用しないことも推奨します。指定したパラメーターによっては、一方のネットワークに向けて作成したトランザクションが、もう一方のネットワークでも実行可能になるおそれがあるためです。

アドレスとシークレットを生成しても、直接XRPを入手できるわけではありません。単に乱数を選択しているだけです。また、そのアドレスでXRPを受け取ってアカウントに資金供給する必要があります。XRPを取得する方法として最も一般的なのは、取引所から購入し、所有しているアドレスに入れる方法です。詳細は、XRP Overviewを参照してください。

本番XRP Ledgerへの接続

XRP Ledgerと同期しているサーバーを指定する必要があります。多くの場合は公開サーバーを、以下のスニペットなどで使用できます。

JavaScript

const xrpl = require('xrpl')
const api = new xrpl.Client('wss://xrplcluster.com')
api.connect()

Python

from xrpl.clients import JsonRpcClient
client = JsonRpcClient("https://xrplcluster.com")

Java

final HttpUrl rippledUrl = HttpUrl.get("https://xrplcluster.com");
XrplClient xrplClient = new XrplClient(rippledUrl);

ヒント: ローカル接続では、WebSocketプロトコルのTLSで暗号化されたバージョン（wss）ではなく、暗号化されていないバージョン（ws）を使用します。この方式は、通信が同じマシンの中だけで行われてマシンの外に出て行かないという点で安全で、TLS証明書が不要であるため設定が簡単です。外部ネットワークとの接続では、必ずwssを使用してください。

次のステップ

このチュートリアルを完了後は、以下を試してみてください。

• 本番システム向けに信頼できるトランザクションの送信を構築する
• xrpl.jsリファレンスを参照して、XRP Ledgerの全機能を確認する
• アカウント設定をカスタマイズする
• トランザクションのメタデータにトランザクションの結果の詳細がどのように記述されているかを知る
• escrowやPayment Channelなどの複雑な支払いタイプについて調べる

{% include '_snippets/rippled-api-links.md' %} {% include '_snippets/tx-type-links.md' %} {% include '_snippets/rippled_versions.md' %}