Plutus スクリプトの評価
このページでは、EvaluateContext が、台帳データ、実行予算、評価コンテキストを用いて Plutus V1 から V4 までのスクリプトを評価する方法を説明します。
EvaluateContext の引数の形
Section titled “EvaluateContext の引数の形”各 EvaluateContext メソッドは、スクリプトの台帳データと実行予算、評価コンテキストを受け取ります。評価を中止できる Go の context.Context も受け取ります。
| スクリプトのバージョン | データ引数 | メソッドの形 |
|---|---|---|
| Plutus V1 | datum, redeemer, scriptContext | EvaluateContext(ctx, datum, redeemer, scriptContext, budget, evalContext) |
| Plutus V2 | datum, redeemer, scriptContext | EvaluateContext(ctx, datum, redeemer, scriptContext, budget, evalContext) |
| Plutus V3 | scriptContext | EvaluateContext(ctx, scriptContext, budget, evalContext) |
| Plutus V4 | scriptContext | EvaluateContext(ctx, scriptContext, budget, evalContext) |
Plutus V1 と V2 は、datum、redeemer、scriptContext の順で引数を適用します。Plutus V3 と V4 は scriptContext を受け取り、そのコンテキストに各バージョンが必要とするデータを含めます。
すべてのバージョンで、呼び出し元は実行の budget と evalContext を指定します。評価器は、予算が 0 の場合も含め、指定された予算を強制します。
台帳コンテキストの大きなデータ
Section titled “台帳コンテキストの大きなデータ”EvaluateContext は、台帳状態の datum、redeemer、スクリプトコンテキストを実行引数として渡します。評価器はこれらを UPLC プログラム項とは別に保持するため、データに含まれる Plutus データノードは UPLC プログラムの構造ノード数を増やしません。
この動作により、非常に大きなインライン datum を持つコンテキストでも、台帳データ自体が構造ノード数の上限超過を引き起こすことなく処理できます。V3 の回帰テストには、1,000,000 個を超える PlutusData ノードを持つ台帳コンテキストが含まれます。
信頼された引数として扱う対象は、EvaluateContext の引数で渡す有限のデータ値のみです。評価器は引き続き UPLC プログラムをデコードして検証し、そのプログラムには構造上の制限が適用されます。この動作は、台帳データを無制限にしたり、実行予算の強制を解除したりするものではありません。
評価結果の扱い
Section titled “評価結果の扱い”最終結果が unit か非 unit かだけを判定する場合は、RunScriptContext を使用します。この経路はスクリプトを評価して判定結果を返しますが、最終結果を展開したり discharge したりしません。
完全な結果を項として取得する場合は、RunContextWithTrustedDataArguments を使用できます。この経路は評価後に結果を discharge するため、評価自体が成功していても、結果が大きすぎると ErrCodeResultTooLarge で失敗することがあります。どちらの経路も、実行予算の超過など評価中のエラーを返します。
入力の妥当性とエラー
Section titled “入力の妥当性とエラー”呼び出し元は、信頼するすべての引数ツリーを、EvaluateContext に渡す前にその生成元で検証する必要があります。EvaluateContext はこれらを RunContextWithTrustedDataArguments に転送し、この関数の検証では、転送されたツリーを意図的に検証しません。各ツリーが有限で、有効な Plutus データを含み、循環がないことを呼び出し元が保証してください。
デコードした datum や redeemer をスクリプトから参照する値として渡す前に、data.Normalize を適用してください。デコーダーは元の CBOR の固定長または不定長の形式を保持しますが、参照実装はスクリプト用の値を新しく構築します。data.Normalize を適用しない値は、同じ意味のデータでも参照実装と異なるシリアライズ済みバイト列になる可能性があります。
既定の入力デコーダーは CBOR tag 1401 と long-head bignum tag を拒否します。Integer と ByteString の CBOR unmarshalling も、以前より厳格に入力を検証します。
BudgetError が予算超過を示す場合、Requested は予算を超過させた charge、Available はその charge の直前に残っていた予算を示します。charge-then-check の動作では、評価器は失敗を返す前に charge を差し引くため、失敗後の残りの予算は Available - Requested です。これは、評価は予算内で成功したものの、最終結果の discharge に失敗する ErrCodeResultTooLarge とは別のエラーです。
評価器は、呼び出し元のコードが構築した不正または未知のスクリプト項を評価せず、エラーを返します。このエラーの後に再試行する場合は、指定した項を修正してください。
Docs authored by Doc Holiday