Remove legacy links to RippleAPI 1.x docs

2025-11-20 19:55:54 +00:00 · 2021-10-20 12:18:13 -07:00
parent ee927ebf94
commit 12eff02bc6
21 changed files with 210 additions and 199 deletions
--- a/content/tutorials/get-started/send-xrp.ja.md
+++ b/content/tutorials/get-started/send-xrp.ja.md
@@ -6,6 +6,7 @@ cta_text: XRPを送金しよう
 embed_ripple_lib: true
 filters:
    - interactive_steps
+    - include_code
 labels:
  - 支払い
  - XRP
@@ -13,7 +14,7 @@ top_nav_grouping: 人気ページ
 ---
 # XRPの送金

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

 ## 前提条件

@@ -21,26 +22,37 @@ top_nav_grouping: 人気ページ
 <script type="application/javascript" src="assets/js/tutorials/send-xrp.js"></script>
 {% set use_network = "Testnet" %}

- このページでは、ripple-lib（RippleAPI）ライブラリーバージョン1.8.2を使用するJavaScriptの例を紹介します。[RippleAPI入門ガイド](get-started-with-rippleapi-for-javascript.html)に、RippleAPIを使用してJavaScriptからXRP Ledgerデータにアクセスする方法の説明があります。
+- このページでは、xrpl.jsライブラリーを使用するJavaScriptの例を紹介します。[xrpl.js入門ガイド](get-started-using-javascript.html)に、xrpl.jsを使用してJavaScriptからXRP Ledgerデータにアクセスする方法の説明があります。

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

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

-## Test Netでの送金
+## Testnetでの送金
 {% set n = cycler(* range(1,99)) %}

-### {{n.next()}}. Test Netサーバーへの接続
+### {{n.next()}}. Testnetサーバーへの接続

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

-以下のサンプルコードでは、新しいRippleAPIインスタンスを作成し、Rippleが運用している公開XRP Test Netサーバーに接続します。
+以下のサンプルコードでは公開XRP Testnetサーバーに接続します。
+
+<!-- MULTICODE_BLOCK_START -->
+
+_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") }}
+
+<!-- MULTICODE_BLOCK_END -->

-```js
-ripple = require('ripple-lib')
-api = new ripple.RippleAPI({server: 'wss://s.altnet.rippletest.net:51233'})
-api.connect()
-```

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

@@ -67,29 +79,23 @@ XRP送金に対して指定する必要がある必要最小限の指示は次
 - XRPを受け取るアドレス（`"Destination"`）。このアドレスは送信元アドレスと同じものではいけません。
 - 送金するXRP額（`"Amount"`）。通常、XRPの「drop数」を示す整数として指定します。1,000,000ドロップは1 XRPです。

-技術上、一部の追加のフィールドは実行可能なトランザクションに含める必要があり、また、省略可能なフィールドでも、`LastLedgerSequence`などは含めることを強く推奨します。[`prepareTransaction()`メソッド](rippleapi-reference.html#preparetransaction)は、トランザクションの残りのフィールドに適切なデフォルトを自動的に入力します。上記の送金を準備する際の例を示します。
+技術上、一部の追加のフィールドは実行可能なトランザクションに含める必要があり、また、省略可能なフィールドでも、`LastLedgerSequence`などは含めることを強く推奨します。[`autofill()`メソッド](https://js.xrpl.org/classes/Client.html#autofill)は、トランザクションの残りのフィールドに適切なデフォルトを自動的に入力します。上記の送金を準備する際の例を示します。

-```js
-// Continuing after connecting to the API
-async function doPrepare() {
-  const sender = "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
-  const preparedTx = await api.prepareTransaction({
-    "TransactionType": "Payment",
-    "Account": sender,
-    "Amount": api.xrpToDrops("22"), // Same as "Amount": "22000000"
-    "Destination": "rUCzEr6jrEyMpjhs4wSdQdz4g8Y382NxfM"
-  }, {
-    // Expire this transaction if it doesn't execute within ~5 minutes:
-    "maxLedgerVersionOffset": 75
-  })
-  const maxLedgerVersion = preparedTx.instructions.maxLedgerVersion
-  console.log("準備されたトランザクション指示：", preparedTx.txJSON)
-  console.log("トランザクションコスト：", preparedTx.instructions.fee, "XRP")
-  console.log("トランザクションの有効期限はこのレジャー後：", maxLedgerVersion)
-  return preparedTx.txJSON
-}
-txJSON = doPrepare()
-```
+<!-- MULTICODE_BLOCK_START -->
+
+_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") }}
+
+<!-- MULTICODE_BLOCK_END -->

 {{ start_step("Prepare") }}
 <div class="input-group mb-3">
@@ -109,16 +115,27 @@ txJSON = doPrepare()

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

-RippleAPIの[sign()メソッド](rippleapi-reference.html#sign)を使用して、トランザクションに署名します。最初の引数は、署名するJSONトランザクションの文字列バージョンです。
+xrpl.jsの[Wallet.sign()メソッド](https://js.xrpl.org/classes/Wallet.html#sign)を使用して、トランザクションに署名します。最初の引数は、署名するJSONトランザクションの文字列バージョンです。
+
+<!-- MULTICODE_BLOCK_START -->
+
+_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" ) }}
+
+<!-- MULTICODE_BLOCK_END -->

-```js
-// Continuing from the previous step...
-const response = api.sign(txJSON, "s████████████████████████████")
-const txID = response.id
-console.log("Identifying hash:", txID)
-const txBlob = response.signedTransaction
-console.log("Signed blob:", txBlob)
-```

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

@@ -132,27 +149,22 @@ console.log("Signed blob:", txBlob)

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

-[submit()メソッド](rippleapi-reference.html#submit)を使用して、トランザクションをネットワークに送信します。送信する前に、[getLedgerVersion()メソッド](rippleapi-reference.html#getledgerversion)を使用して最新の検証済みレジャーインデックスを書き留めておくことをお勧めします。この送信の結果としてトランザクションが追加される可能性のある最も古いレジャーバージョンは、送信時に最新の検証済みレジャーより1つ大きなバージョンとなります。
+トランザクションをネットワークに送信します。

-ただし、同じトランザクションが以前に送信されたことがある場合、そのトランザクションはすでに以前のレジャーに入っています。（2回目の送信は成功しませんが、正しいレジャーバージョンの中を確認しないと、すでに成功していたことに気付かない可能性があります。）
+<!-- MULTICODE_BLOCK_START -->

-```js
-// use txBlob from the previous example
-async function doSubmit(txBlob) {
-  const latestLedgerVersion = await api.getLedgerVersion()
+_JavaScript_

-  const result = await api.submit(txBlob)
+{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Submit", end_before="// Wait", language="js" ) }}

-  console.log("予備結果コード：", result.resultCode)
-  console.log("予備結果メッセージ", result.resultMessage)
+_Python_

-  // Return the earliest ledger index this transaction could appear in
-  // as a result of this submission, which is the first one after the
-  // validated ledger at time of submission.
-  return latestLedgerVersion + 1
-}
-const earliestLedgerVersion = doSubmit(txBlob)
-```
+{{ 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" ) }}
+
+<!-- MULTICODE_BLOCK_END -->

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

@@ -175,16 +187,21 @@ const earliestLedgerVersion = doSubmit(txBlob)

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

-RippleAPIの`ledger`イベントタイプを使用して、新しい検証済みレジャーバージョンがあるときにコードが実行されるようにしておきます。例:
+<!-- MULTICODE_BLOCK_START -->

-```js
-api.on('ledger', ledger => {
-  console.log("レジャーインデックス", ledger.ledgerVersion, "は検証されました。")
-  if (ledger.ledgerVersion > maxLedgerVersion) {
-    console.log("トランザクションはまだ検証されていませんなら、有効期限が切れています。")
-  }
-})
-```
+_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" ) }}
+
+<!-- MULTICODE_BLOCK_END -->

 {{ start_step("Wait") }}
 {% include '_snippets/interactive-tutorials/wait-step.ja.md' %}
@@ -193,25 +210,26 @@ api.on('ledger', ledger => {

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

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

-```js
-// Continues from previous examples.
-// earliestLedgerVersion was noted when the transaction was submitted.
-// txID was noted when the transaction was signed.
-try {
-  tx = await api.getTransaction(txID, {minLedgerVersion: earliestLedgerVersion})
-  console.log("トランザクションの結果：", tx.outcome.result)
-  console.log("残高変化：", JSON.stringify(tx.outcome.balanceChanges))
-} catch(error) {
-  console.log("トランザクションの結果を取得出来ませんでした。エラー：", error)
-}
+<!-- MULTICODE_BLOCK_START -->

-```
+_JavaScript_

-RippleAPIの`getTransaction()`メソッドは、トランザクションが検証済みレジャーバージョンに登録された場合にのみ成功を返します。登録されなかった場合は、`await`式が例外を発生させます。
+{{ include_code("_code-samples/send-xrp/js/send-xrp.js", start_with="// Check", end_before="// End of", language="js" ) }}

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

 {{ start_step("Check") }}
 <button id="get-tx-button" class="btn btn-primary previous-steps-required">トランザクションステータスを確認する</button>
@@ -228,36 +246,73 @@ RippleAPIの`getTransaction()`メソッドは、トランザクションが検

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

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

 ```js
-const generated = api.generateAddress()
-console.log(generated.address) // 例: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
-console.log(generated.secret) // 例: sp6JS7f14BuwFY8Mw6bTtLKWauoUs
+const wallet = new xrpl.Wallet()
+console.log(wallet.address) // Example: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
+console.log(wallet.seed) // Example: sp6JS7f14BuwFY8Mw6bTtLKWauoUs
 ```

+_Python_
+
+```py
+from xrpl.wallet import Wallet
+my_wallet = Wallet.create()
+print(my_wallet.classic_address) # Example: rGCkuB7PBr5tNy68tPEABEtcdno4hE6Y7f
+print(my_wallet.seed)            # Example: sp6JS7f14BuwFY8Mw6bTtLKWauoUs
+```
+
+_Java_
+
+```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
+```
+
+<!-- MULTICODE_BLOCK_END -->
+
 **警告:** ローカルマシンで安全な方法で生成したアドレスとシークレットのみを使用してください。別のコンピューターでアドレスとシークレットを生成して、ネットワーク経由でそれらを自分に送信した場合は、ネットワーク上の他の人がその情報を見ることができる可能性があります。その情報見ることができる人は、あなたと同じようにあなたのXRPを操作できます。また、Test Netと本番で同じアドレスを使用しないことも推奨します。指定したパラメーターによっては、一方のネットワークに向けて作成したトランザクションが、もう一方のネットワークでも実行可能になるおそれがあるためです。

-アドレスとシークレットを生成しても、直接XRPを入手できるわけではありません。単に乱数を選択しているだけです。また、そのアドレスでXRPを受け取って[アカウントに資金供給](accounts.html#アカウントの作成)する必要があります。XRPを取得する方法として最も一般的なのは、取引所から購入し、所有しているアドレスに入れる方法です。詳細は、Rippleの[XRP購入ガイド](https://ripple.com/xrp/buy-xrp/)を参照してください。
+アドレスとシークレットを生成しても、直接XRPを入手できるわけではありません。単に乱数を選択しているだけです。また、そのアドレスでXRPを受け取って[アカウントに資金供給](accounts.html#アカウントの作成)する必要があります。XRPを取得する方法として最も一般的なのは、取引所から購入し、所有しているアドレスに入れる方法です。詳細は、[XRP Overview](xrp-overview.html)を参照してください。

 ### 本番XRP Ledgerへの接続

-`RippleAPI`オブジェクトのインスタンスを作成するときに、適切なXRP Ledgerと同期しているサーバーを指定する必要があります。多くの場合はRippleの公開サーバーを、以下のスニペットなどで使用できます。
+XRP Ledgerと同期しているサーバーを指定する必要があります。多くの場合は公開サーバーを、以下のスニペットなどで使用できます。
+
+<!-- MULTICODE_BLOCK_START -->
+
+_JavaScript_

 ```js
-ripple = require('ripple-lib')
-api = new ripple.RippleAPI({server: 'wss://s1.ripple.com:51233'})
+const xrpl = require('xrpl')
+const api = new xrpl.Client('wss://xrplcluster.com')
 api.connect()
 ```

-自分で[`rippled`をインストール](install-rippled.html)した場合は、デフォルトで本番ネットワークに接続されます。（代わりに、[Test Netに接続するように構成](connect-your-rippled-to-the-xrp-test-net.html)することもできます。）サーバーが同期されると（通常は起動から約15分以内）、RippleAPIをサーバーにローカルで接続することができます。そうすると、[さまざまなメリット](rippled-server-modes.html#ストックサーバーを運用する理由)があります。以下の例は、RippleAPIをデフォルト構成で運用されているサーバーに接続する方法を示しています。
+_Python_

-```js
-ripple = require('ripple-lib')
-api = new ripple.RippleAPI({server: 'ws://localhost:6006'})
-api.connect()
+```py
+from xrpl.clients import JsonRpcClient
+client = JsonRpcClient("https://xrplcluster.com")
 ```

+_Java_
+
+```java
+final HttpUrl rippledUrl = HttpUrl.get("https://xrplcluster.com");
+XrplClient xrplClient = new XrplClient(rippledUrl);
+```
+
+<!-- MULTICODE_BLOCK_END -->
+
 **ヒント:** ローカル接続では、WebSocketプロトコルのTLSで暗号化されたバージョン（`wss`）ではなく、暗号化されていないバージョン（`ws`）を使用します。この方式は、通信が同じマシンの中だけで行われてマシンの外に出て行かないという点で安全で、TLS証明書が不要であるため設定が簡単です。外部ネットワークとの接続では、必ず`wss`を使用してください。

 ## 次のステップ
@@ -265,7 +320,7 @@ api.connect()
 このチュートリアルを完了後は、以下を試してみてください。

 - 本番システム向けに[信頼できるトランザクションの送信](reliable-transaction-submission.html)を構築する
- [RippleAPI JavaScriptリファレンス](rippleapi-reference.html)を参照して、XRP Ledgerの全機能を確認する
+- [xrpl.jsリファレンス](https://js.xrpl.org/)を参照して、XRP Ledgerの全機能を確認する
 - [アカウント設定](manage-account-settings.html)をカスタマイズする
 - [トランザクションのメタデータ](transaction-metadata.html)にトランザクションの結果の詳細がどのように記述されているかを知る
 - escrowやPayment Channelなどの[複雑な支払いタイプ](complex-payment-types.html)について調べる