# バイナリフォーマット [[ソース]](https://github.com/XRPLF/rippled/blob/develop/src/ripple/protocol/impl/STObject.cpp#L696-L718) このページでは、XRP Ledgerのトランザクションとその他のデータの正規バイナリフォーマットについて説明します。このバイナリフォーマットは、トランザクションの内容のデジタル署名を作成および検証するために必要であり、[サーバ間のピアツーピア通信](/ja/docs/concepts/networks-and-servers/peer-protocol)を含む他の用途にも使用されます。通常、[`rippled` API](/ja/docs/references/http-websocket-apis)は、JSONを使用してクライアントアプリケーションと通信します。ただしJSONは、同じデータをさまざまな同等の方法で表現できるため、デジタル署名を付与するトランザクションをシリアル化するのに適したフォーマットではありません。 トランザクションをJSONまたはその他の表現から正規バイナリフォーマットへシリアル化するプロセスのステップを、以下にまとめます。 1. すべての必須フィールドが指定されていること（必須の[「自動入力可能」フィールド](/ja/docs/references/protocol/transactions/common-fields#%E8%87%AA%E5%8B%95%E5%85%A5%E5%8A%9B%E5%8F%AF%E8%83%BD%E3%81%AA%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)を含む）を確認します。 [トランザクションフォーマットリファレンス](/ja/docs/references/protocol/transactions)に、XRP Ledgerトランザクションの必須フィールドと省略可能なフィールドが定義されています。 `SigningPubKey`もこのステップで指定する必要があります。署名の際に、署名用に指定された秘密鍵から[このキーを導出](/ja/docs/concepts/accounts/cryptographic-keys#%E9%8D%B5%E5%B0%8E%E5%87%BA)できます。 2. 各フィールドのデータを[「内部」バイナリフォーマット](#%E5%86%85%E9%83%A8%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88)に変換します。 3. フィールドを[正規順序](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%AD%A3%E8%A6%8F%E9%A0%86%E5%BA%8F)でソートします。 4. 各フィールドの前に[フィールドID](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89id)を付加します。 5. フィールド（プレフィクスを含む）をソート順に連結します。 その結果、ECDSA（secp256k1楕円曲線を使用）やEd25519などの既知の署名アルゴリズムを使用して署名できるバイナリBlobが1つ作成されます。XRP Ledgerのために、適切なプレフィクス（シングル署名の場合は`0x53545800`、マルシグの場合は`0x534D5400`）を使用してデータを[ハッシュ化](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5)する必要があります。署名後に、指定されている`TxnSignature`フィールドを使用してトランザクションを再度シリアル化する必要があります。 XRP Ledgerでは、[レジャーオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types)や処理済みのトランザクションなど他のタイプのデータを表す場合にも同じシリアル化フォーマットが使用されます。ただし、署名されるトランザクションに追加するのに適切なフィールドは限られています。（たとえば署名自体が指定されている`TxnSignature`フィールドは、署名するバイナリBlobに含まれていてはなりません。）このように、「署名」フィールドとされてオブジェクトに署名するときにオブジェクトに含まれるフィールドもあれば、「非署名」とされてオブジェクトに含まれないフィールドもあります。 ### 例 署名済みトランザクションと未署名のトランザクションはいずれも、JSONフォーマットとバイナリフォーマットの両方で表すことができます。同じ署名済みトランザクションのJSONフォーマットとバイナリフォーマットの例を以下に示します。 **JSON:** { "Account": "rMBzp8CgpE441cp5PVyA9rpVV7oT8hP3ys", "Expiration": 595640108, "Fee": "10", "Flags": 524288, "OfferSequence": 1752791, "Sequence": 1752792, "SigningPubKey": "03EE83BB432547885C219634A1BC407A9DB0474145D69737D09CCDC63E1DEE7FE3", "TakerGets": "15000000000", "TakerPays": { "currency": "USD", "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "value": "7072.8" }, "TransactionType": "OfferCreate", "TxnSignature": "30440220143759437C04F7B61F012563AFE90D8DAFC46E86035E1D965A9CED282C97D4CE02204CFD241E86F17E011298FC1A39B63386C74306A5DE047E213B0F29EFA4571C2C", "hash": "73734B611DDA23D3F5F62E20A173B78AB8406AC5015094DA53F53D39B9EDB06C" } **バイナリ（16進数として表現）:** 120007220008000024001ABED82A2380BF2C2019001ABED764D55920AC9391400000000000000000000000000055534400000000000A20B3C85F482532A9578DBB3950B85CA06594D165400000037E11D60068400000000000000A732103EE83BB432547885C219634A1BC407A9DB0474145D69737D09CCDC63E1DEE7FE3744630440220143759437C04F7B61F012563AFE90D8DAFC46E86035E1D965A9CED282C97D4CE02204CFD241E86F17E011298FC1A39B63386C74306A5DE047E213B0F29EFA4571C2C8114DD76483FACDEE26E60D8A586BB58D09F27045C46 ## サンプルコード ここで説明するシリアル化プロセスは複数の場所にさまざまなプログラミング言語で実装されています。 - C++: [`rippled`コードベース](https://github.com/XRPLF/rippled/blob/develop/src/ripple/protocol/impl/STObject.cpp) - JavaScript: [`ripple-binary-codec`](https://github.com/ripple/ripple-binary-codec/)パッケージ - Python 3: このリポジトリのコードサンプルセクション これらのすべての実装には、一般利用が可能なオープンソースライセンスが提供されているので、学習のためにドキュメントと合わせて使用するだけでなく、必要に応じてコードをインポート、使用、または変更することができます。 ## 内部フォーマット 各フィールドには「内部」バイナリフォーマットがあります。このフォーマットは、`rippled`ソースコードで署名時に（およびその他のほとんどの場合に）そのフィールドを表示するのに使用されます。すべてのフィールドの内部フォーマットは、[`SField.cpp`](https://github.com/XRPLF/rippled/blob/master/src/ripple/protocol/impl/SField.cpp)のソースコードに定義されています。（このフィールドには、トランザクションフィールド以外のフィールドも含まれています。）[トランザクションフォーマットリファレンス](/ja/docs/references/protocol/transactions)にも、すべてのトランザクションフィールドの内部フォーマットが記載されています。 たとえば`Flags`[共通トランザクションフィールド](/ja/docs/references/protocol/transactions/common-fields)はUInt32（32ビット符号なし整数）になります。 ### 定義ファイル 以下のJSONファイルには、XRP Ledgerデータをそのバイナリフォーマットにシリアル化し、バイナリからシリアル化解除するのに必要な重要な定数が定義されています。 **[https://github.com/ripple/ripple-binary-codec/blob/master/src/enums/definitions.json](https://github.com/ripple/ripple-binary-codec/blob/master/src/enums/definitions.json)** この定義ファイルの最上位フィールドの定義を以下の表に示します。 | フィールド | 内容 | | --- | --- | | `TYPES` | フィールドIDの作成と正規順序でのフィールドのソートのためのデータタイプからその[「タイプコード」](#%E3%82%BF%E3%82%A4%E3%83%97%E3%82%B3%E3%83%BC%E3%83%89)へのマップ。1未満のコードは実際のデータには含まれません。10000を超えるコードは、他のオブジェクト内部ではシリアル化できない「トランザクション」などの特殊な「上位」オブジェクトタイプを表します。各タイプのシリアル化方法についての詳細は、[タイプリスト](#%E3%82%BF%E3%82%A4%E3%83%97%E3%83%AA%E3%82%B9%E3%83%88)をご覧ください。 | | `LEDGER_ENTRY_TYPES` | [レジャーオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types)から対応するデータタイプへのマップ。これはレジャー状態データと、処理されたトランザクションの[メタデータ](/ja/docs/references/protocol/transactions/metadata)の「affected nodes」セクションに含まれます。 | | `FIELDS` | トランザクション、レジャーオブジェクト、あるいはその他のデータに含まれる可能性があるすべてのフィールドを表すタプルからなるソート済み配列。各タプルの1番目のメンバーはフィールドの文字列名であり、2番目のメンバーはそのフィールドのプロパティーが含まれているオブジェクトです。（これらのフィールドの定義については、以下の「フィールドプロパティー」の表をご覧ください。） | | `TRANSACTION_RESULTS` | [トランザクション結果コード](/ja/docs/references/protocol/transactions/transaction-results)から対応する数値へのマップ。レジャーに含まれない結果タイプにはマイナスの値が含まれています。`tesSUCCESS`に数値0が含まれています。[`tec`クラスコード](/ja/docs/references/protocol/transactions/transaction-results/tec-codes)は、レジャーに含まれている失敗を示しています。 | | `TRANSACTION_TYPES` | [トランザクションのタイプ](/ja/docs/references/protocol/transactions/types)から対応する数値へのマップ。 | 署名と送信のためにトランザクションをシリアル化するという目的から、`FIELDS`、`TYPES`、および`TRANSACTION_TYPES`フィールドが必要です。 `FIELDS`配列のフィールド定義オブジェクトには以下のフィールドが含まれています。 | フィールド | 型 | 内容 | | --- | --- | --- | | `nth` | 数値 | このフィールドの[フィールドコード](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%82%B3%E3%83%BC%E3%83%89)。このコードは、[フィールドID](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89id)の作成時と、同一データタイプの他のフィールドとのソート時に使用されます。 | | `isVLEncoded` | ブール値 | `true`の場合、このフィールドには[長さプレフィクスが付加されています](#%E9%95%B7%E3%81%95%E3%83%97%E3%83%AC%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%82%92%E4%BB%98%E5%8A%A0%E3%81%99%E3%82%8B)。 | | `isSerialized` | ブール値 | `true`の場合、このフィールドはシリアル化バイナリデータにエンコードされる必要があります。このフィールドが`false`の場合、一般にフィールドは保管されず、オンデマンドで再作成されます。 | | `isSigningField` | ブール値 | `true`の場合、署名のためにトランザクションを準備する際にこのフィールドをシリアル化する必要があります。`false`の場合、このフィールドは署名対象データから省略する必要があります。（これはトランザクションに含まれていない可能性があります。） | | `type` | 文字列 | このフィールドの内部データタイプ。これは、このフィールドの[タイプコード](#%E3%82%BF%E3%82%A4%E3%83%97%E3%82%B3%E3%83%BC%E3%83%89)を示す`TYPES`マップのキーにマップします。 | ### フィールドID [[ソース - エンコード]](https://github.com/seelabs/rippled/blob/cecc0ad75849a1d50cc573188ad301ca65519a5b/src/ripple/protocol/impl/Serializer.cpp#L117-L148) [[ソース - デコード]](https://github.com/seelabs/rippled/blob/cecc0ad75849a1d50cc573188ad301ca65519a5b/src/ripple/protocol/impl/Serializer.cpp#L484-L509) フィールドのタイプコードとフィールドコードを結合すると、フィールドの一意のIDになります。このIDは、最終的なシリアル化Blobでこのフィールドの前に付加されます。フィールドIDのサイズは、タイプコードとその結合対象のフィールドコードに応じて1～3バイトとなります。以下の表をご覧ください。 | | タイプコード < 16 | タイプコード >= 16 | | --- | --- | --- | | **フィールドコード < 16** | ![1バイト: 上位4ビットがタイプを定義し、下位4ビットがフィールドを定義します。](/assets/field-id-common-type-common-field.ja.757308644a654d986dabb1ba78c2cd7369e9570742e5f040499b7ad0a1e72081.ac57e6ef.png) | ![2バイト: 1番目のバイトの下位4ビットがフィールドを定義し、次のバイトがタイプを定義します。](/assets/field-id-uncommon-type-common-field.ja.74520423b92656dc53ca2ef3f9295c20407b0568f8c71759fb0bcbb5f80a64be.ac57e6ef.png) | | **フィールドコード >= 16** | ![2バイト: 1番目のバイトの上位4ビットがタイプを定義し、1番目のバイトの下位4ビットは0になります。次のバイトがフィールドを定義します。](/assets/field-id-common-type-uncommon-field.ja.8b365a5007b699bd5944de055ce93cad84755f51a6f094796fb5db1d55d25152.ac57e6ef.png) | ![3バイト: 1番目のバイトは0x00、2番目のバイトはタイプを定義します。3番目のバイトはフィールドを定義します。](/assets/field-id-uncommon-type-uncommon-field.ja.09830b0b814c3bc0bd5e70b0c6c41395e44074ef319e5f25d7d5e7999befb0b8.ac57e6ef.png) | デコードの際には、**1番目のバイト**のどのビットがゼロであるかによって、フィールドIDのバイト数を把握できます。これは、上記の表の例に対応しています。 | | 上位4ビットがゼロ以外である | 上位4ビットがゼロである | | --- | --- | --- | | **下位4ビットがゼロ以外である** | 1バイト: 上位4ビットがタイプを定義し、下位4ビットがフィールドを定義します。 | 2バイト: 1番目のバイトの下位4ビットがフィールドを定義し、次のバイトがタイプを定義します。 | | **下位4ビットがゼロである** | 2バイト: 1番目のバイトの上位4ビットがタイプを定義し、1番目のバイトの下位4ビットは0になります。次のバイトがフィールドを定義します。 | 3バイト: 1番目のバイトは0x00、2番目のバイトはタイプを定義します。3番目のバイトはフィールドを定義します。 | フィールドIDは、フィールドのソートに使用される2つの要素で構成されますが、シリアル化されたフィールドID自体に基づいてソートを実行しないでください。これは、フィールドIDのバイト構造によってソート順序が変わるためです。 ### 長さプレフィクスを付加する 一部の可変長フィールドの前には、長さインディケーターが付加されています。`Blob`フィールド（任意のバイナリデータを含む）がこれに該当します。長さプレフィクスが付加されているタイプのリストについては、[タイプリスト](#%E3%82%BF%E3%82%A4%E3%83%97%E3%83%AA%E3%82%B9%E3%83%88)の表をご覧ください。 一部のタイプの可変長フィールドには、長さプレフィクスが付加されません。このようなタイプでは、他の方法で内容の終わりが示されます。 長さプレフィクスはフィールドの長さを示す1～3バイトで構成され、タイププレフィクスと内容の間に挿入されます。 - フィールドに0～192バイトのデータが含まれている場合、1番目のバイトは内容の長さを示し、長さバイトの直後にそのバイト数のデータが続きます。 - フィールドに193～12480バイトのデータが含まれている場合、最初の2バイトは以下の式で算出されるフィールドの長さを示します。 ``` 193 + ((byte1 - 193) * 256) + byte2 ``` - フィールドに12481～918744バイトのデータが含まれている場合、最初の3バイトは以下の式で算出されるフィールドの長さを示します。 ``` 12481 + ((byte1 - 241) * 65536) + (byte2 * 256) + byte3 ``` - 長さプレフィクスが付加されているフィールドに格納できる最大データは918744バイトです。 デコード時に、1番目の長さバイトの値から、追加の長さバイト（0、1、または2）が存在するかどうかを把握できます。 - 1番目の長さバイトの値が192以下の場合、これは唯一の長さバイトであり、フィールドの内容の長さはこのバイトが示すバイト数です。 - 1番目の長さバイトの値が193～240の場合、2つの長さバイトがあります。 - 1番目の長さバイトの値が241～254の場合、3つの長さバイトがあります。 ## フィールドの正規順序 トランザクションのすべてのフィールドは、まずフィールドのタイプ（特に各タイプに割り当てられている数値の「タイプコード」）に基づいて特定の順序でソートされ、次にフィールド自体（「フィールドコード」）に基づいてソートされます。（たとえば、姓がフィールドのタイプ、名前がフィールド自体とすると、姓で最初にソートし、次に名でソートすることになります。） ### タイプコード 各フィールドタイプには任意のタイプコードが含まれており、番号が小さいコードから最初にソートされます。これらのコードは[`SField.h`](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/SField.h#L60-L98)で定義されています。 たとえば [UInt32のタイプコードが2である](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/SField.h#L67)ので、すべてのUInt32フィールドは、すべての[Amountフィールド（タイプコード6）](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/SField.h#L71)よりも前に位置します。 [定義ファイル](#%E5%AE%9A%E7%BE%A9%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB)には、`TYPES`マップの各タイプのタイプコードがリストされています。 ### フィールドコード 各フィールドにはフィールドコードが含まれています。フィールドコードは、同じタイプのフィールドをソートするときに使用され、番号が小さいコードが最初になるようにソートされます。これらのフィールドは[`sfields/macro`](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/detail/sfields.macro)で定義されています。 たとえば[Paymentトランザクション](/ja/docs/references/protocol/transactions/types/payment)の`Account`フィールドの[ソートコードが1である](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/detail/sfields.macro#L269)場合、このフィールドは`Destination`フィールド（[ソートコードが3である](https://github.com/XRPLF/rippled/blob/master/include/xrpl/protocol/detail/sfields.macro#L271)フィールド）よりも前に位置します。 フィールドコードは異なるフィールドタイプのフィールドで再利用されますが、同じタイプのフィールドに同じフィールドコードが含まれることはありません。タイプコードとフィールドコードを組み合わせると、フィールドの一意の[フィールドID](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89id)になります。 ## タイプリスト トランザクションの指示には、以下のタイプのフィールドを指定できます。 | タイプ名 | タイプコード | ビット長 | [長さプレフィクスを付加する](#%E9%95%B7%E3%81%95%E3%83%97%E3%83%AC%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%82%92%E4%BB%98%E5%8A%A0%E3%81%99%E3%82%8B)? | 説明 | | --- | --- | --- | --- | --- | | [AccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 8 | 160 | はい | [アカウント](/ja/docs/concepts/accounts)の一意のID。 | | [Amount](#amount%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 6 | 64または384 | いいえ | XRPまたはトークンの金額。フィールドの長さは、XRPの場合は64ビット、トークンの場合は384ビット（64+160+160）です。 | | [Blob](#blob%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 7 | 可変 | はい | 任意のバイナリデータ。このようなフィールドの中で重要なフィールドとして、`TxnSignature`（トランザクションを承認する署名）があります。 | | [Hash128](#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 4 | 128 | いいえ | 128ビットの任意のバイナリ値。該当する唯一のフィールドは`EmailHash`です。これは、[Gravatar](https://www.gravatar.com/)を取得する目的でアカウント所有者のメールのMD-5ハッシュを保管するフィールドです。 | | [Hash160](#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 17 | 160 | いいえ | 160ビットの任意のバイナリ値。これにより通貨コードまたはイシュアーが定義されます。 | | [Hash256](#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 5 | 256 | いいえ | 256ビットの任意のバイナリ値。これは通常、トランザクション、レジャーバージョン、またはレジャーデータオブジェクトの「SHA-512ハーフ」ハッシュを表します。 | | [PathSet](#pathset%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 18 | 可変 | いいえ | [クロスカレンシー支払い](/ja/docs/concepts/payment-types/cross-currency-payments)の有効な[ペイメントパス](/ja/docs/concepts/tokens/fungible-tokens/paths)のセット。 | | [STArray](#%E9%85%8D%E5%88%97%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 15 | 可変 | いいえ | 可変数のメンバーからなる配列。フィールドによってタイプが異なる場合があります。この例として、[memos](/ja/docs/references/protocol/transactions/common-fields#memos%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)や[マルチ署名](/ja/docs/concepts/accounts/multi-signing)で使用される署名者のリストがあります。 | | [STIssue](#issue%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 24 | 160 or 320 | いいえ | 数量を含まない、資産(XRPまたはトークン)を指定します。 | | [STObject](#%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 14 | 可変 | いいえ | 1つ以上のネストされたフィールドを含むオブジェクト。 | | [UInt8](#uint%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 16 | 8 | いいえ | 8ビットの符号なし整数。 | | [UInt16](#uint%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 1 | 16 | いいえ | 16ビットの符号なし整数。`TransactionType`は、このタイプの特殊なフィールドで、特定の文字列から整数値へのマッピングを含みます。 | | [UInt32](#uint%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 2 | 32 | いいえ | 32ビットの符号なし整数。このタイプの例として、すべてのトランザクションの`Flags`フィールドと`Sequence`フィールドがあります。 | | [XChainBridge](#xchainbridge%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 25 | 可変 | いいえ | 2つのブロックチェーン間のブリッジで、両方のチェーン上のドアアカウントと発行された資産によって識別されます。 | 上記のフィールドタイプの他に、[レジャーオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types)や[トランザクションメタデータ](/ja/docs/references/protocol/transactions/metadata)などのコンテキストでは以下のタイプが含まれることがあります。 | タイプ名 | タイプコード | [長さプレフィクスを付加する](#%E9%95%B7%E3%81%95%E3%83%97%E3%83%AC%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%82%92%E4%BB%98%E5%8A%A0%E3%81%99%E3%82%8B)? | 説明 | | --- | --- | --- | --- | | Transaction | 10001 | いいえ | [トランザクション](/ja/docs/references/protocol/transactions)全体を含む「上位」タイプ。 | | LedgerEntry | 10002 | いいえ | [レジャーオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types)全体を含む「上位」タイプ。 | | Validation | 10003 | いいえ | ピアツーピア通信で[コンセンサスプロセス](/ja/docs/concepts/consensus-protocol)の検証投票を表すために使用される「上位」タイプ。 | | Metadata | 10004 | いいえ | [1つのトランザクションのメタデータ](/ja/docs/references/protocol/transactions/metadata)を含む「上位」タイプ。 | | [UInt64](#uint%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 3 | いいえ | 64ビットの符号なし整数。このタイプはトランザクションの指示には含まれませんが、さまざまなレジャーオブジェクトでこのタイプのフィールドが使用されます。 | | Vector256 | 19 | はい | このタイプはトランザクションの指示には含まれませんが、[Amendmentレジャーオブジェクト](/ja/docs/references/protocol/ledger-data/ledger-entry-types/amendments)の`Amendments`フィールドでは、現在有効な[Amendment](/ja/docs/concepts/networks-and-servers/amendments)を示すためにこのタイプが使用されます。 | ### AccountIDフィールド このタイプのフィールドには、XRP Ledger[アカウント](/ja/docs/concepts/accounts)の160ビットのIDが含まれています。JSONではこれらのフィールドは[base58](/ja/docs/references/protocol/data-types/base58-encodings) XRP Ledger「アドレス」および追加のチェックサムデータとして表示されます。このため、スペルミスが有効なアドレスとなることがありません。（このエンコードは「Base58Check」とも呼ばれ、誤ったアドレスへの送金を防止します。）これらのフィールドのバイナリフォーマットにはチェックサムデータは含まれておらず、また[アドレスのbase58エンコード](/ja/docs/concepts/accounts/addresses#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9%E3%81%AE%E3%82%A8%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89)で使用される`0x00`「タイププレフィクス」も含まれていません。（ただし、バイナリフォーマットは主に署名済みトランザクションに使用されるため、署名済みトランザクションを転記する際にスペルミスなどのエラーが発生すると署名が無効となり、送金できなくなります。） スタンドアロンフィールドとして表示されるAccountID（`Account`や`Destination`など）の長さは固定長の160ビットですが、[長さプレフィクスが付加](#%E9%95%B7%E3%81%95%E3%83%97%E3%83%AC%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%82%92%E4%BB%98%E5%8A%A0%E3%81%99%E3%82%8B)されます。その結果、これらのフィールドの長さインディケーターは常に`0x14`バイトになります。特殊フィールドの子として示されるAccountID（[Amount `issuer`](#amount%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)、[PathSet `account`](#pathset%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)など）では長さプレフィクスは付加 *されません* 。 ### Amountフィールド 「Amount」タイプは、通貨（XRPまたはトークン）の額を表す特殊なフィールドタイプです。このタイプは2つのサブタイプで構成されます。 - **XRP** XRPは64ビット符号なし整数（ビッグエンディアンオーダー）としてシリアル化されます。ただし、XRPであることを示すため最上位ビットが常に0であり、プラスの値であることを示す最上位から2番目のビットは`1`となります。XRPの最大額（1017 drop）には57ビットが必要であるため、XRPのシリアル化フォーマットを計算するには、標準の64ビット符号なし整数をとり、`0x4000000000000000`のビットOR演算を行います。 - **トークン** トークンは以下の3つのセグメントで構成され、セグメントの順序は以下のとおりです。 1. [トークンの数量フォーマット](#%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3%E3%81%AE%E6%95%B0%E9%87%8F%E3%83%95%E3%82%A9%E3%83%BC%E3%83%9E%E3%83%83%E3%83%88)の額を示す64ビット。1番目のビットは、これがXRPではないことを示す`1`です。 2. [通貨コード](/ja/docs/references/protocol/data-types/currency-formats#%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)を示す160ビット。標準APIでは、[標準通貨コードフォーマット](/ja/docs/references/protocol/data-types/currency-formats#%E6%A8%99%E6%BA%96%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)を使用して「USD」などの3文字のコードが160ビットのコードに変換されますが、160ビットのカスタムコードも使用できます。 3. イシュアーのアカウントIDを示す160ビット。（関連項目: [アカウントアドレスエンコード](/ja/docs/concepts/accounts/addresses#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9%E3%81%AE%E3%82%A8%E3%83%B3%E3%82%B3%E3%83%BC%E3%83%89) 1番目のビットに基づいて2つのサブタイプのいずれに該当するかを確認できます。`0`の場合はXRP、`1`の場合はトークンです。 以下の図に、XRPの額とトークン額のシリアル化フォーマットを示します。 [](/assets/serialization-amount.ja.c527063a06aa0dbc3b94be222a6f845564257062008a51dfcee68d477e543a16.ac57e6ef.svg) #### トークンの数量フォーマット [[ソース]](https://github.com/XRPLF/rippled/blob/35fa20a110e3d43ffc1e9e664fc9017b6f2747ae/src/ripple/protocol/impl/STAmount.cpp) [](/assets/currency-number-format.ja.96172b9f379e479be95eca81720b82c7236842a5834d3f38e13488fafc364e94.ac57e6ef.svg) XRP Ledgerは64ビットを使って(代替可能な)トークンの金額をシリアライズします。(JSONフォーマットでは、通貨量オブジェクトの`value`フィールドが数値量になります)。バイナリ形式では、数値は"非XRP"ビット、符号ビット、指数、有効数字の順で構成されます。 1. トークン数量の最初の(最上位)ビットは`1`で、XRP数量ではないことを示します。(XRPの金額は、このフォーマットと区別するために、最上位ビットが常に`0`に設定されています)。 2. 符号ビットは、金額がプラスかマイナスかを示します。標準的な[2の補数](https://ja.wikipedia.org/wiki/2%E3%81%AE%E8%A3%9C%E6%95%B0)整数とは異なり、XRP Ledgerフォーマットでは`1`は**正**を表し、`0`は**負**を表します。 3. 次の8ビットは指数を符号なし整数で表します。指数は、-96から+80(含む)の範囲でスケール（有効桁を10の何乗にするか）を示します。しかし、シリアライズするときには、指数に97を加えて符号なし整数としてシリアライズできるようにします。したがって、シリアル化された値`1`は指数`-96`を表し、シリアル化された値`177`は指数`80`を表します。 4. 残りの54ビットは、符号なし整数として有効数字(*mantissa* と呼ばれることもあります)を表します。シリアライズするとき、この値は1015(`1000000000000000`)から1016-1(`9999999999`)の範囲に正規化されます。0の特別なケースでは、符号ビット、指数、有効数字はすべて0ですので、64ビットの値は`0x800000000000000000000000`としてシリアライズされます。 数値の金額は、[通貨コード](/ja/docs/references/protocol/data-types/currency-formats#%E6%A8%99%E6%BA%96%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)および発行者とともにシリアライズされ、完全な[トークン金額](#amount%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)を形成します。 #### 通貨コード プロトコルレベルでは、XRP Ledgerの通貨コードは任意の160bit値ですが、以下の値には特別な意味があります。 - 通貨コード`0x0000000000000000000000005852500000000000`は**使用できません** 。(これは"標準フォーマット"において"XRP"を表します)。 - 通貨コード`0x0000000000000000000000000000000000000000`(すべてゼロ)は、**許可されません**。通常、XRPの金額を通貨コードで指定することはありません。しかし、XRPの通貨コードを指定しなければならないフィールドが存在する場合、このコードはXRPを示すために使用されます。 [`rippled` API](/ja/docs/references/http-websocket-apis)は、3文字のASCIIコードを160ビットの16進数に変換するための**標準フォーマット**を以下のようにサポートしています。 [](/assets/currency-code-format.ja.981a5cda95d76ca6da2817fa419d480280f4a14ced275f1da4ece7b880fd72e3.ac57e6ef.svg) 1. 最初の8ビットは`0x00`でなければなりません。 2. 次の88ビットは予約済みで、すべて`0`でなければなりません。 3. 次の24ビットはASCIIの3文字を表します。 [ISO 4217](https://www.xe.com/iso4217.php) コード、または "BTC"のような一般的な擬似 ISO 4217コードの使用を推奨します。すべての大文字と小文字、数字、記号 `?`, `!`, `@`, `#`, `$`, `%`, `^`, `&`, `*`, `<`, `>`, `(`, `)`, `{`, `}`, `[`, `]`, |が利用可能です。 通貨コード`XRP`(すべて大文字)はXRPのために予約済みであり、トークンで使用することはできません。 4. 次の40ビットは予約済みで、すべて`0`でなければなりません。 **非標準フォーマット**は、最初の8ビットが`0x00`以外の160ビットのデータです。 ### 配列フィールド 一部のトランザクションフィールド（[SignerListSetトランザクション](/ja/docs/references/protocol/transactions/types/signerlistset)の`SignerEntries`や[`Memos`](/ja/docs/references/protocol/transactions/common-fields#memos%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)など）はオブジェクトの配列です（「STArray」タイプと呼ばれます）。 配列には、さまざまな[オブジェクトフィールド](#%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)がそのネイティブバイナリフォーマットで特定の順序で含まれています。JSONでは、各配列メンバーが1つのフィールド（メンバーオブジェクトフィールドの名前）を含むJSON「ラッパー」オブジェクトです。そのフィールドの値は（「内部」）オブジェクト自体です。 バイナリフォーマットでは、配列の各メンバーにはフィールドIDプレフィクス（ラッパーオブジェクトの単一キーに基づく）と内容（[オブジェクトとしてシリアル化された](#%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)内部オブジェクトからなる）が含まれています。配列の終わりをマークするため、アイテムにフィールドID `0xf1`（配列のタイプコードとフィールドコード1）を付加し、内容は指定しません。 以下の例は、配列のシリアル化フォーマットを示します（`SignerEntries`フィールド）。 [](/assets/serialization-array.ja.7eb7080b95c0f242dbd89ceb9f7c6be0cede233cf59f18b00d89589167bae775.ac57e6ef.svg) ### Blobフィールド Blobタイプは、任意のデータを持つ[長さプレフィクスが付加されている](#%E9%95%B7%E3%81%95%E3%83%97%E3%83%AC%E3%83%95%E3%82%A3%E3%82%AF%E3%82%B9%E3%82%92%E4%BB%98%E5%8A%A0%E3%81%99%E3%82%8B)フィールドです。このタイプを使用する2種類の一般的なフィールドとして、`SigningPubKey`と`TxnSignature`があります。これらのフィールドにはそれぞれ、トランザクションの実行を承認する公開鍵と署名が含まれています。 両方のフィールドにはこれ以上の内容構造がないため、フィールドIDと長さプレフィクスの後に可変長エンコードで示される正確なバイト数で構成されます。 ### ハッシュフィールド XRP LedgerのハッシュタイプにはHash128、Hash160、Hash256があります。これらのフィールドには特定のビット数のバイナリデータが含まれており、それらのデータはハッシュ演算の結果を表す場合とそうでない場合があります。 これらのフィールドは、長さインディケーターを使用せずに、ビッグエンディアンバイトオーダーで特定数のビットとしてシリアル化されます。 ### Issueフィールド いくつかのフィールドは、XRPや[トークン](/ja/docs/concepts/tokens)といったアセットタイプを指定します。これらのフィールドは、1つまたは2つの160ビットから構成されています： 1. 最初の160ビットはアセットの[通貨コード](#%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89)です。XRPの場合、これはすべて0です。 2. 最初の160ビットが全て0の場合(アセットがXRPの場合)、フィールドはそこで終了します。そうでない場合、アセットはトークンであり、次の160ビットは[トークン発行者のAccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)です。 ### オブジェクトフィールド トランザクションフィールドの一部（[SignerListSetトランザクション](/ja/docs/references/protocol/transactions/types/signerlistset)の`SignerEntry`や`Memos`配列の`Memo`など）はオブジェクトです（「STObject」タイプと呼ばれます）。オブジェクトのシリアル化は配列のシリアル化に似ていますが、唯一異なる点としてオブジェクトフィールド内では**オブジェクトのメンバーを正規順序に従って配置する必要がある**点があげられます。配列フィールドではすでに順序が明示的に設定されています。 オブジェクトフィールドの[正規フィールド順序](#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%AD%A3%E8%A6%8F%E9%A0%86%E5%BA%8F)は、すべての最上位フィールドの正規フィールド順序と同じですが、オブジェクトのメンバーはオブジェクト内でソートする必要があります。最終メンバーの後には、「オブジェクトの終わり」を示すフィールドID（`0xe1`）があり、このフィールドには内容がありません。 以下の例は、オブジェクトのシリアル化フォーマットを示します（`Memos`配列内の1つの`Memo`オブジェクト）。 [](/assets/serialization-object.ja.5da6f4daa4d1095c72f2180fb03737a6c108d6e50dbba14d24867ab3aca725f6.ac57e6ef.svg) ### PathSetフィールド クロスカレンシーの[Paymentトランザクション](/ja/docs/references/protocol/transactions/types/payment)の`Paths`フィールドは、JSONで配列からなる配列として表される「PathSet」です。使用されるパスについての詳細は、[パス](/ja/docs/concepts/tokens/fungible-tokens/paths)をご覧ください。 PathSetは、**1～6**の個別パスとして順序どおりにシリアル化されます[[ソース]](https://github.com/XRPLF/rippled/blob/4cff94f7a4a05302bdf1a248515379da99c5bcd4/src/ripple/app/tx/impl/Payment.h#L35-L36)。それぞれの完全なパスの後には、パスの後に続く内容を示すバイトが配置されます。 - `0xff`は別のパスが続くことを示します。 - `0x00`はPathSetの終わりを示します。 各パスには**1～8**のパスステップがこの順序で含まれています[[ソース]](https://github.com/XRPLF/rippled/blob/4cff94f7a4a05302bdf1a248515379da99c5bcd4/src/ripple/app/tx/impl/Payment.h#L38-L39)。各ステップは**タイプ**を示すバイトで始まり、その後にパスステップを記述する1つ以上のフィールドが続きます。タイプは、ビット単位のフラグを使用してそのパスステップに含まれるフィールドを示します。（たとえば値が`0x30`の場合、通貨とイシュアーの両方が変更されます。）複数のフィールドが含まれている場合、フィールドは常に特定の順序で配置されます。 以下の表に、有効なフィールドと、タイプバイトでフィールドを示すために設定されるビット単位のフラグを示します。 | タイプフラグ | 含まれるフィールド | フィールドタイプ | ビットサイズ | 順序 | | --- | --- | --- | --- | --- | | `0x01` | `account` | [AccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 160ビット | 1番目 | | `0x10` | `currency` | [通貨コード](/ja/docs/references/protocol/data-types/currency-formats#%E6%A8%99%E6%BA%96%E9%80%9A%E8%B2%A8%E3%82%B3%E3%83%BC%E3%83%89) | 160ビット | 2番目 | | `0x20` | `issuer` | [AccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89) | 160ビット | 3番目 | いくつかの組み合わせは無効です。詳細は、[パスの仕様](/ja/docs/concepts/tokens/fungible-tokens/paths#%E3%83%91%E3%82%B9%E3%81%AE%E4%BB%95%E6%A7%98)をご覧ください。 `account`フィールドと`issuer`フィールドのAccountIDには、長さプレフィクスは付加 *されていません* 。`currency`がXRPの場合、通貨コードは160ビットのゼロとして表されます。 各ステップの直後にはパス上の次のステップが続きます。前述したように、パスの最終ステップの後には`0xff`（別のパスが続く場合）または`0x00`（これが最終パスの終わりの場合）が続きます。 以下の例は、PathSetのシリアル化フォーマットを示します。 [](/assets/serialization-pathset.ja.4057c0736fd680b3a3e28968896d74058572c1245ad677cea1a1fac6c8eded0b.ac57e6ef.svg) ### UIntフィールド XRP Ledgerには符号なし整数タイプUInt8、UInt16、UInt32、UInt64があります。これらのタイプはすべて、指定されたビット数の標準ビッグエンディアンバイナリー符号なし整数です。 JSONオブジェクトにこれらのフィールドが含まれている場合、ほとんどはデフォルトでJSONの数値として表されます。例外として、UInt64は文字列として表されます。これは、一部のJSONデコーダーがこれらの整数を64ビットの「倍精度」浮動小数点数として表現しようとするためです。64ビットの「倍精度」浮動小数点数では、すべてのUInt64値を完全な精度で表現することができません。 もう1つの特殊なケースとして`TransactionType`フィールドがあります。JSONではこのフィールドは便宜上、トランザクションタイプの名前の文字列として表現されますが、バイナリではこのフィールドはUInt16です。[定義ファイル](#%E5%AE%9A%E7%BE%A9%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB)内の`TRANSACTION_TYPES`オブジェクトにより、これらの文字列が特定の数値にマップされます。 ### XChainBridgeフィールド [](/assets/serialization-xchainbridge.ja.6bd851d363a67b5650bc8978ae6a799ea564cd4b27b34f399d3c9f35be41481b.ac57e6ef.svg) `XChainBridge`フィールドは、[クロスチェーンブリッジ](/ja/docs/concepts/xrpl-sidechains/cross-chain-bridges)に関連するトランザクションとレジャーエントリで使用され、XChainBridgeタイプの唯一のフィールドです。XChainBridgeフィールドは4つの要素から構成され、ブロックチェーン間のブリッジを定義します。 - ロックチェーンのドアアカウント、長さ接頭辞付きの[AccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)。 - ロックチェーンの資産タイプ、[STIssue](#issue%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)。 - 発行チェーンのドアアカウント、長さ接頭辞付きの[AccountID](#accountid%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)。 - 発行チェーンの資産タイプ、[STIssue](#issue%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)。 ネストされた2つの[STIssue](#issue%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89)タイプは、それぞれ160ビットまたは320ビットです。STIssueフィールドに含まれる通貨コードがすべて0の場合、STIssueフィールドは160ビットで、ブリッジされた資産がそれぞれのチェーンのネイティブ資産、例えばXRP Ledger MainnetのXRPであることを意味します。通貨コードが0でない場合、STIssueフィールドにはトークンのネイティブチェーンにおける発行者の(長さ接頭辞のない)AccountIDも含まれます。 ドアアカウントのAccountIDの値は長さ接頭辞付きですが、発行者のAccountIDの値は長さ接頭辞付きではありません。 全体として、XChainBridgeフィールドは常に656、816、または976ビット（82、102、または122バイト）のいずれかになります。