【完全保存版】Solana Actionsの実行とライフサイクルについて

当記事は、こちらを翻訳・編集したものです。

Execution & Lifecycle | Actions & Alerts

１　実行とライフサイクル

これまでにURLスキームおよびGETおよびPOST APIについて説明しました。

次に、典型的なHTTP REST APIライフサイクルに従う、アクション実行フローの全体像を説明します。

１　GETリクエストの送信

クライアントがアクションURLにGETリクエストを送信する。

２　GETリスポンスの受信

アクションAPIが、このURLでのアクションを説明する人間が読めるメタデータを含むGETレスポンスボディを、上記の仕様に従って返す。

３　POSTリクエストの送信

エンドユーザーが利用可能なオプションから実行するアクションを選択します。

そして、クライアントが指定されたURL（GET URLと同じか、異なる場合もある）にPOSTリクエストを送信する。

４　POSTリスポンスの受信

アクションプロバイダーがこのリクエストを受信します。

そして、エンドユーザーが実行するアクションを構成するトランザクション（またはメッセージ）を作成し、このトランザクションを含むPOSTレスポンスボディを返す。

５　クライアントサイドのウォレットへの送信

クライアントがこのトランザクションを受け取ります。

クライアントサイドのウォレット（例えばChrome拡張機能や埋め込みウォレット）に送信してエンドユーザーが署名できるように準備する。

６　トランザクションの送信

ユーザーがトランザクション（またはメッセージ）に署名し、クライアントがこのトランザクションをブロックチェーンに送信する。

２　バリデーション

アクションプロバイダーはバリデーションをサポートしています。

GETおよびPOSTリクエストはまず、アクションが実行可能かどうかを検証し、レスポンスのメタデータをカスタマイズし、バリデーションが失敗した場合に無効化（disabled）を使用することができます。

例えば、オークション中のNFTに対するGETリクエストが、「このオークションは終了しました」というエラーメッセージを返し、「入札」ボタンを無効（disabled）として表示することがあります。

また、投票期間が終了したDAOガバナンス提案に対する投票のGETリクエストが、「この提案にはもう投票できません」というエラーメッセージを返し、「賛成」および「反対」ボタンを無効（disabled）として表示することがあります。

３　実行

一度署名された後、トランザクションはブロックチェーンに送信され、クライアントが実行ライフサイクルの追跡を担当します。

４　永続性

アクションは、単一のセッションを超えてその実行状態を永続化しません。

ユーザーがクライアントをリフレッシュしたり、後で戻ってきたりした場合、過去または現在のアクションとの相互作用はクライアントに反映されません。