優先料金とコンピュート管理

まとめ

V1トランザクションのコンピュートユニットと優先料金は、setTransactionConfig()で設定します。

• V1ではcomputeUnitLimitと合計priorityFeeを使用します。
• UmiのV1トランザクションビルダーはCompute Budgetプログラム命令を拒否します。
• V0ではsetComputeUnitLimitとsetComputeUnitPriceを使用します。
• コンピュートユニットあたりのマイクロラムポートで表される優先料金の見積もりは、V1では合計ラムポートに変換する必要があります。

UmiのV1トランザクションではコンピュート制限と優先料金の合計をトランザクションメッセージに格納し、V0トランザクションではCompute Budgetプログラム命令を使用します。

V1のコンピュートユニットと優先料金を設定する

V1トランザクションでは、setTransactionConfig()を使用してコンピュートユニット制限と優先料金の合計を設定します。

import { lamports, transactionBuilder } from '@metaplex-foundation/umi'

await transactionBuilder()
  .add(myInstruction)
  .useV1()
  .setTransactionConfig({
    computeUnitLimit: 600_000,
    priorityFee: lamports(600),
  })
  .sendAndConfirm(umi)

priorityFeeはコンピュートユニットあたりの価格ではなく、料金の合計です。価格が1,000マイクロラムポート、制限が600,000ユニットの場合、合計は600,000 × 1,000 ÷ 1,000,000 = 600ラムポートです。

V0のコンピュートユニットと優先料金を設定する

V0トランザクションでは、引き続き@metaplex-foundation/mpl-toolboxのCompute Budgetプログラム命令を使用します。

import { transactionBuilder } from '@metaplex-foundation/umi'
import {
  setComputeUnitLimit,
  setComputeUnitPrice,
} from '@metaplex-foundation/mpl-toolbox'

await transactionBuilder()
  .add(setComputeUnitLimit(umi, { units: 600_000 }))
  .add(setComputeUnitPrice(umi, { microLamports: 1_000 }))
  .add(myInstruction)
  .useV0()
  .sendAndConfirm(umi)

トランザクションでAddress Lookup Tableが必要な場合、または接続されたウォレットがV1トランザクションをサポートしていない場合はV0を使用してください。

注意事項

• useV1()とsetTransactionConfig()を使用するにはUmi 1.6.0以降が必要です。
• V1のコンピュートユニット制限は1,400,000を超えることができません。
• コンピュートユニットと料金の見積もりについては、トランザクション実行の最適化を参照してください。
• すべての互換性要件については、V0からV1トランザクションへの移行を参照してください。