xrpl-dev-portal/content/concepts/transactions/transactions.ja.md

html, parent, blurb, labels

html	parent	blurb	labels
transactions.html	concepts.html	トランザクションは、XRP Ledgerの変更を可能にする唯一の手段です。トランザクションの形態とその使用方法について説明します。	トランザクション送信 支払い

トランザクション

トランザクション（取引） は、XRP Ledgerを変更する唯一の方法です。コンセンサスプロセスに従って署名され、送信され、検証済みのレジャーバージョンに承認された場合にのみ、トランザクションは最終的なものになります。レジャーのルールによっては、疑似トランザクション も生成されます。このトランザクションは署名も送信もされませんが、コンセンサスによって承認されなければならないことは同様です。失敗したトランザクションであっても、スパム対策の[トランザクションコスト][]を支払のためXRPの残高が変わるため、レジャーに記録されます。

トランザクションで行えることは、送金だけではありません。XRP Ledgerのトランザクションは、さまざまな支払いタイプに対応しているだけでなく、暗号鍵のローテーション、その他の設定の管理、およびXRP Ledgerの分散型取引所での取引にも使用されます。トランザクションタイプの詳細なリストについては、rippled APIリファレンスを参照してください。

トランザクションの識別

署名付きトランザクションには、それを識別する固有の"hash"があります。トランザクションを送信すると、サーバーの応答でハッシュが返されます。account_txコマンドを使用して、アカウントのトランザクション履歴でトランザクションを検索することもできます。

だれでも最終的なステータスを確認としてハッシュによってトランザクションを調べることができるため、トランザクションハッシュは「支払いの証明」として使用することができます。

{% include '_snippets/setfee_uniqueness_note.ja.md' %}

請求コストの正当化

失敗したトランザクションに対してもトランザクションコストが発生するのは不公平に思えるかもしれませんが、正当な理由からtecクラスのエラーが存在します。

• 失敗したトランザクションの後に送信するトランザクションでは、シーケンス値の番号を変更する必要はありません。失敗したトランザクションをレジャーに組み込むと、トランザクションのシーケンス番号が順に使われ予想される順序が保持されます。
• ネットワーク全体にトランザクションを拡散されられると、ネットワークの負荷が増大します。トランザクションコストを強制することにより、攻撃者が失敗したトランザクションでネットワークを乱用することが難しくなります。
• トランザクションコストは実際には非常に少額であるため、大量のトランザクションを送信している場合を除き、ユーザーに害を及ぼすことはありません。

トランザクションの承認

分散型XRP Ledgerでは、デジタル署名によって、トランザクションが一定のアクションを起こすが承認されていることが証明されます。署名されたトランザクションのみがネットワークに送信され、検証済みレジャーに含まれます。署名付きトランザクションは不変です。その内容は変更できず、他のトランザクションでこの署名を使用することはできません。

トランザクションは、次のいずれかの署名によって承認できます。

• 送信元アドレスと数学的に関連付けられている、マスター秘密鍵による単一の署名。[AccountSetトランザクション][]を使用して、マスターキーペアを無効または有効にできます。
• アドレスに関連付けられているレギュラー秘密鍵と一致する単一の署名。[SetRegularKeyトランザクション][]を使用して、レギュラーキーペアを追加、削除、または置き換えることができます。
• アドレスが所有する署名者のリストと一致するマルチシグ。[SignerListSetトランザクション][]を使用して、署名者のリストを追加、削除、または置換することができます。

署名の種類に関係なく、あらゆるタイプのトランザクションを承認できます。ただし、次の例外があります。

• マスター秘密鍵だけがマスター公開鍵を無効にできます。
• マスター秘密鍵だけが凍結機能を永続的に放棄できます。
• アドレスからトランザクションに署名する最後の方法を削除することはできません。

マスターキーとレギュラーキーペアについて詳しくは、暗号鍵を参照してください。

トランザクションへの署名とトランザクションの送信

XRP Ledgerにトランザクションを送信するには、いくつかの手順を実行する必要があります。

1. 未署名のトランザクションをJSON形式で作成します。
2. 1つ以上の署名を使用してトランザクションを承認します。
3. rippledサーバーにトランザクションを送信します。トランザクションが適切に作成されている場合、サーバーはそのトランザクションを現行バージョンのレジャーに暫定的に適用し、そのトランザクションをピアツーピアネットワークの他のメンバーに中継します。
4. コンセンサスプロセスによって、次の検証済みレジャーに含まれる暫定的なトランザクションが決定されます。
5. rippledサーバーはそれらのトランザクションを正規順序で前のレジャーに適用し、それらの結果を共有します。
6. 十分に信頼できるバリデータがまったく同じレジャーを作成した場合、そのレジャーは 検証済み であると宣言され、そのレジャーのトランザクションの結果は不変となります。

XRP決済の送信に関する対話型チュートリアルについては、Send XRPを参照してください。

未署名のトランザクションの例

JSON形式の未署名の[Paymentトランザクション][]の例を次に示します。

{
  "TransactionType" : "Payment",
  "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "Amount" : {
     "currency" : "USD",
     "value" : "1",
     "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
  },
  "Fee": "12",
  "Flags": 2147483648,
  "Sequence": 2,
}

XRP Ledgerは、トランザクションオブジェクトが送信元アドレス（Account内）フィールドによって承認されている場合にのみ、トランザクションを中継して実行します。これを安全に行う方法については、安全な署名の設定を参照してください。

署名付きトランザクションブロブの例

トランザクションに署名すると、ネットワークに送信できるバイナリーブロブが生成されます。この場合、rippledのsubmitコマンドを使用します。署名付きブロブと同じトランザクションの例を示します。このトランザクションは、WebSocket APIを使用して送信されています。

{
  "id": 2,
  "command": "submit",
  "tx_blob" : "120000240000000461D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA968400000000000000F732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74483046022100982064CDD3F052D22788DB30B52EEA8956A32A51375E72274E417328EBA31E480221008F522C9DB4B0F31E695AA013843958A10DE8F6BA7D6759BEE645F71A7EB240BE81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754"
}

メタデータを含む実行済みトランザクションの例

トランザクションが送信されたら、APIを使用して（例えば、txコマンドを使用して）トランザクションのステータスを確認できます。これにより、トランザクションの指示、その結果、およびそれを実行する過程で行われたすべての変更のメタデータ が表示されます。

注意: トランザクションが結果コードtesSUCCESSで検証済みのレジャーに表示されない限り、トランザクションの成功は確定ではありません。関連項目: 結果のファイナリティー

txコマンドの応答の例:

{
  "id": 6,
  "status": "success",
  "type": "response",
  "result": {
    "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "Amount": {
      "currency": "USD",
      "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
      "value": "1"
    },
    "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
    "Fee": "10",
    "Flags": 2147483648,
    "Sequence": 2,
    "SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB",
    "TransactionType": "Payment",
    "TxnSignature": "3045022100D64A32A506B86E880480CCB846EFA3F9665C9B11FDCA35D7124F53C486CC1D0402206EC8663308D91C928D1FDA498C3A2F8DD105211B9D90F4ECFD75172BAE733340",
    "date": 455224610,
    "hash": "33EA42FC7A06F062A7B843AF4DC7C0AB00D6644DFDF4C5D354A87C035813D321",
    "inLedger": 7013674,
    "ledger_index": 7013674,
    "meta": {
      "AffectedNodes": [
        {
          "ModifiedNode": {
            "FinalFields": {
              "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
              "Balance": "99999980",
              "Flags": 0,
              "OwnerCount": 0,
              "Sequence": 3
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
            "PreviousFields": {
              "Balance": "99999990",
              "Sequence": 2
            },
            "PreviousTxnID": "7BF105CFE4EFE78ADB63FE4E03A851440551FE189FD4B51CAAD9279C9F534F0E",
            "PreviousTxnLgrSeq": 6979192
          }
        },
        {
          "ModifiedNode": {
            "FinalFields": {
              "Balance": {
                "currency": "USD",
                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                "value": "2"
              },
              "Flags": 65536,
              "HighLimit": {
                "currency": "USD",
                "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                "value": "0"
              },
              "HighNode": "0000000000000000",
              "LowLimit": {
                "currency": "USD",
                "issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
                "value": "100"
              },
              "LowNode": "0000000000000000"
            },
            "LedgerEntryType": "RippleState",
            "LedgerIndex": "96D2F43BA7AE7193EC59E5E7DDB26A9D786AB1F7C580E030E7D2FF5233DA01E9",
            "PreviousFields": {
              "Balance": {
                "currency": "USD",
                "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
                "value": "1"
              }
            },
            "PreviousTxnID": "7BF105CFE4EFE78ADB63FE4E03A851440551FE189FD4B51CAAD9279C9F534F0E",
            "PreviousTxnLgrSeq": 6979192
          }
        }
      ],
      "TransactionIndex": 0,
      "TransactionResult": "tesSUCCESS"
    },
    "validated": true
  }
}

関連項目

• コンセプト:
  • 支払いタイプ
• チュートリアル:
  • 安全な署名の設定
  • XRPの送金
  • トランザクションの結果の確認
  • WebSocketを使用した着信ペイメントの監視
  • トランザクションの取り消しまたはスキップ
  • 信頼できるトランザクションの送信
• リファレンス:
  • トランザクションの共通フィールド
  • トランザクションのタイプ
  • トランザクションのメタデータ
  • [account_txメソッド][]
  • [txメソッド][]
  • [submitメソッド][]
  • [submit_multisignedメソッド][]

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