トランザクション

Solanaネットワークと対話するには、トランザクションを送信する必要があります。トランザクションは、いくつかのフォームを含む封筒のようなものと考えることができます。各フォームはネットワークに何をすべきかを指示するinstructionです。トランザクションを送信することは、フォームが処理されるように封筒を郵送するようなものです。

以下の例は、2つのトランザクションの簡略版を示しています。最初のトランザクションが処理されると、単一のinstructionが実行されます。2番目のトランザクションが処理されると、順番に3つのinstructionが実行されます：まずinstruction 1、次にinstruction 2、そしてinstruction 3の順です。

トランザクションはアトミックです：単一のinstructionが失敗すると、トランザクション全体が失敗し、変更は一切発生しません。

2つのトランザクションを示す簡略図

Transactionは以下の情報で構成されています：

signatures: 署名の配列
message: 処理されるinstructionsのリストを含むトランザクション情報

Transaction

pub struct Transaction {
    #[wasm_bindgen(skip)]
    #[serde(with = "short_vec")]
    pub signatures: Vec<Signature>,

    #[wasm_bindgen(skip)]
    pub message: Message,
}

トランザクションの2つの部分を示す図

トランザクションの総サイズ制限は1232バイトです。この制限にはsignatures配列とmessage構造体の両方が含まれます。

この制限はIPv6の最大伝送単位（MTU）サイズ1280バイトから、ネットワークヘッダー用の48バイト（IPv6用40バイト

ヘッダー用8バイト）を引いたものです。

トランザクションフォーマットとサイズ制限を示す図

署名

トランザクションのsignatures配列にはSignature構造体が含まれています。各Signatureは64バイトで、アカウントの秘密鍵でトランザクションのMessageに署名することで作成されます。トランザクションのinstructionsに含まれる各署名者アカウントには署名を提供する必要があります。

最初の署名は、トランザクションの基本手数料を支払うアカウントに属し、トランザクション署名となります。このトランザクション署名を使用して、ネットワーク上でトランザクションの詳細を検索することができます。

メッセージ

トランザクションの message は Message 構造体であり、以下の情報を含んでいます：

header: メッセージのヘッダー
account_keys: トランザクションのinstructionsに必要なアカウントアドレスの配列
recent_blockhash: トランザクションのタイムスタンプとして機能するブロックハッシュ
instructions: instructionsの配列

スペースを節約するため、トランザクションは各アカウントの権限を個別に保存しません。代わりに、アカウントの権限は header と account_keys を使用して決定されます。

Message

pub struct Message {
    /// The message header, identifying signed and read-only `account_keys`.
    pub header: MessageHeader,

    /// All the account keys used by this transaction.
    #[serde(with = "short_vec")]
    pub account_keys: Vec<Pubkey>,

    /// The id of a recent ledger entry.
    pub recent_blockhash: Hash,

    /// Programs that will be executed in sequence and committed in
    /// one atomic transaction if all succeed.
    #[serde(with = "short_vec")]
    pub instructions: Vec<CompiledInstruction>,
}

ヘッダー

メッセージの header は MessageHeader 構造体です。以下の情報を含んでいます：

num_required_signatures: トランザクションに必要な署名の総数
num_readonly_signed_accounts: 署名が必要な読み取り専用アカウントの総数
num_readonly_unsigned_accounts: 署名が不要な読み取り専用アカウントの総数

MessageHeader

pub struct MessageHeader {
    /// The number of signatures required for this message to be considered
    /// valid. The signers of those signatures must match the first
    /// `num_required_signatures` of [`Message::account_keys`].
    pub num_required_signatures: u8,

    /// The last `num_readonly_signed_accounts` of the signed keys are read-only
    /// accounts.
    pub num_readonly_signed_accounts: u8,

    /// The last `num_readonly_unsigned_accounts` of the unsigned keys are
    /// read-only accounts.
    pub num_readonly_unsigned_accounts: u8,
}

メッセージヘッダーの3つの部分を示す図

アカウントアドレス

メッセージの account_keys はアカウントアドレスの配列で、コンパクト配列形式で送信されます。配列のプレフィックスはその長さを示します。配列の各項目は公開鍵であり、instructionsで使用されるアカウントを指しています。accounts_keys 配列は完全で、以下の順序に厳密に従う必要があります：

署名者 + 書き込み可能
署名者 + 読み取り専用
署名者でない + 書き込み可能
署名者でない + 読み取り専用

厳密な順序付けにより、account_keys 配列をメッセージのheaderの情報と組み合わせて、各アカウントの権限を決定することができます。

アカウントアドレス配列の順序を示す図

Instructions

メッセージのinstructionsは、処理されるすべてのinstructionの配列で、コンパクト配列形式で送信されます。配列のプレフィックスはその長さを示します。配列の各項目はCompiledInstruction構造体であり、以下の情報を含んでいます：

program_id_index：account_keys配列内のアドレスを指すインデックス。この値はinstructionを処理するプログラムのアドレスを示します。
accounts：account_keys配列内のアドレスを指すインデックスの配列。各インデックスはこのinstructionに必要なアカウントのアドレスを指します。
data：プログラム上で呼び出すinstructionを指定するバイト配列。また、instructionに必要な追加データも含まれます。（例えば、関数の引数など）

CompiledInstruction

pub struct CompiledInstruction {
    /// Index into the transaction keys array indicating the program account that executes this instruction.
    pub program_id_index: u8,
    /// Ordered indices into the transaction keys array indicating which accounts to pass to the program.
    #[serde(with = "short_vec")]
    pub accounts: Vec<u8>,
    /// The program input data.
    #[serde(with = "short_vec")]
    pub data: Vec<u8>,
}

Instructionのコンパクト配列