トランザクションの共通フィールド

どのトランザクションについても、共通する一連のフィールドに加え、トランザクションのタイプに応じた追加のフィールドがあります。フィールドの名前では、大文字と小文字が区別されます。すべてのトランザクションに共通するフィールドは、以下のとおりです。

: トランザクションのPreviousTxnIDフィールドは、AccountTxnIDフィールドに置き換えられました。この文字列/Hash256フィールドは、過去に発生したトランザクションの一部に記述されています。このフィールドは、一部のレジャーオブジェクトにあるPreviousTxnIDという同じ名前のフィールドとは無関係です。

AccountTxnID

AccountTxnIDフィールドにより、直前のトランザクション（シーケンス番号で識別）も有効で、かつ期待するトランザクションに一致しない限り、現在のトランザクションが有効にならないよう、トランザクションどうしをチェーンにすることができます。

このフィールドが有用になるのは、例えば、トランザクション送信用のプライマリーシステムと受動的なバックアップシステムを運用している場合です。受動的なバックアップシステムがプライマーリから切断されたものの、プライマリが完全に稼働停止となったわけではなく、両システムが同時に稼働を開始した場合は、トランザクションが2回送信される、あるいはまったく送信されないなど、深刻な問題が発生するおそれがあります。AccountTxnIDを使用してトランザクションどうしをチェーンにすると、両方のシステムがアクティブになったときも、有効なトランザクションを送信できるのはいずれか一方のみとなります。

AccountTxnIDを使用するには、アカウントの1つ前のトランザクションのIDがレジャーで追跡されるよう、最初にasfAccountTxnIDフラグを設定する必要があります。

自動入力可能なフィールド

一部のフィールドについては、トランザクションの署名前に、rippledサーバーによって、または署名に使用されるripple-lib などのライブラリーによって値を自動入力できます。値を自動入力するには、最新の状態を取得するためのXRP Ledgerへのアクティブな接続が必要です。したがって、オフラインでは実行できません。ripple-lib とrippledのどちらも、以下の値を自動的に提供できます。

• Fee - ネットワークに基づいてトランザクションコストを自動的に入力します。

  注記:rippledのsignメソッドを使用するときは、fee_mult_maxパラメーターとfee_mult_divパラメーターを使用して、自動入力値の上限を設定できます。

• Sequence - トランザクションを送信する側のアカウントの次のシーケンス番号を自動的に使用します。

本番システムについては、これらのフィールドの値がサーバーによって入力される状態に しない ことをお勧めします。例えば、ネットワークの負荷が一時的に急上昇したためにトランザクションコストが高騰した場合、トランザクションによっては、一時的な高額のコストを支払うよりも、必要に応じて待機し、コストが低下してから送信したほうが好ましいことがあります。

PaymentトランザクションタイプのPathsフィールドについても、値を自動入力できます。

Flagsフィールド

Flagsフィールドには、トランザクションの行動を調整する各種のオプションを設定できます。オプションは、ビット単位のOR操作と組み合わせることで複数のフラグを同時に設定できるバイナリー値として表現します。

トランザクションで所定のフラグが有効になっているかどうかを確認するには、ビット単位のAND演算子をフラグの値とFlagsフィールドで使用します。結果が0の場合は無効になっていることを示し、結果がフラグ値と等しい場合は有効になっていることを示します（その他の結果の場合は、実行した操作に誤りがあることを示します）。

ほとんどのフラグは、特定のタイプのトランザクションに対してのみ効果があります。複数のタイプのトランザクションに対して、同一のビット単位値をフラグに再利用できるため、フラグの設定と読み取りではTransactionTypeフィールドに留意することが重要です。

フラグとして定義しないビットは、0にする必要があります(fix1543 Amendmentでは、一部のタイプのトランザクションについて、このルールが適用されます。デフォルトでは、ほとんどのタイプのトランザクションでこのルールが強制されます)。

グローバルフラグ

すべてのトランザクションにグローバルに適用される唯一のフラグは、以下のとおりです。

signメソッド（または「署名と送信」モードのsubmitメソッド）を使用すると、rippledは、Flagsフィールドがすでに存在している場合を除き、tfFullyCanonicalSigフラグを有効にした状態でFlagsフィールドを追加します。tfFullyCanonicalSigフラグは、Flagsが明示的に指定されている場合、自動的には有効になりません。また、sign_forメソッドを使用してマルチ署名済みトランザクションに署名を追加する場合も、自動的には有効になりません。

警告: tfFullyCanonicalSigを有効にしない場合は、不正使用者がトランザクションの署名を改変して、期待されるものとは別のハッシュを使用してトランザクションを成功させることが理論上可能になります。最悪の場合、同一の支払を何回も送信するようシステムに仕掛けられるおそれがあります。この問題を回避するには、署名するすべてのトランザクションでtfFullyCanonicalSigフラグを有効にします。

フラグの範囲

トランザクションのFlagsフィールドでは、さまざまなレベルや状況に適用されるフラグを設定できます。個々の状況に関するフラグは、以下の範囲に限定されます。

注記: AccountSetトランザクションタイプには、タイプに基づくフラグと似た目的を果たすビット単位ではない独自のフラグがあります。レジャーオブジェクトにも、さまざまなビット単位のフラグが定義されるFlagsフィールドがあります。

Memosフィールド

Memosフィールドは、トランザクションに関する任意のメッセージデータを保持します。このフィールドは、オブジェクトの配列として表現します。各オブジェクトには唯一のフィールドMemoがあり、このフィールドは、以下のフィールドを1つ以上持つ別のオブジェクトを保持しています。

MemoTypeフィールドとMemoFormatフィールドには、以下の文字のみを使用できます。 ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~:/?#[]@!$&'()*+,;=%

Memosフィールドのサイズの上限は1KBです（バイナリーフォーマットでシリアル化されている場合）。

以下に、Memosフィールドが定義されているトランザクションの例を示します。

{
    "TransactionType": "Payment",
    "Account": "rMmTCjGFRWPz8S2zAUUoNVSQHxtRQD4eCx",
    "Destination": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
    "Memos": [
        {
            "Memo": {
                "MemoType": "687474703a2f2f6578616d706c652e636f6d2f6d656d6f2f67656e65726963",
                "MemoData": "72656e74"
            }
        }
    ],
    "Amount": "1"
}

Signersフィールド

Signersフィールドには、最大8つのキーペアから取得された署名を保持し、トランザクションを承認するためのマルチ署名が含まれています。Signersリストはオブジェクトの配列であり、各オブジェクトが1つのSignerフィールドを保持しています。Signerフィールドには、以下の入れ子フィールドがあります。

SigningPubKeyは、Accountアドレスに関連付けられているキーでなければなりません。参照されているAccountが、レジャーにあり資金供給済みアカウントである場合、SigningPubKeyには、そのアカウントの現在のレギュラーキー（設定されている場合）を指定できます。また、lsfDisableMasterフラグが有効になっている場合を除き、そのアカウントのマスターキーを指定することもできます。参照されているAccountアドレスが、レジャーの資金供給済みのアカウントではない場合、SigningPubKeyは、そのアドレスに関連付けられているマスターキーでなければなりません。

署名の検証は大量の演算能力を消費するタスクであるため、マルチ署名済みトランザクションをネットワークに中継するには、追加のXRPがコストとしてかかります。マルチ署名に含まれている署名ごとに、トランザクションに必要なトランザクションコストが増加します。例えば、トランザクションをネットワークに中継するための現在の最小トランザクションコストが10000dropである場合、Signers配列に3つのエントリーが含まれているマルチ署名済みトランザクションを中継するには、Feeの値を少なくとも40000dropにする必要があります。