エラー処理

ペイマスターAPIを統合する際には、適切なエラー処理が不可欠です。このセクションでは、遭遇する可能性のある一般的なエラーと堅牢な実装のためのベストプラクティスについて説明します。

一般的なエラーコード

トランザクションの送信などのペイマスターAPIとのやり取りでは、標準的なJSON-RPCエラーが返されることがあります。以下は一般的なエラーコードとその意味です：

これらのエラーの多くには、EntryPointからの追加のエラーメッセージも含まれています。

コード	説明
-32521	実行フェーズ中にトランザクションがリバートした（またはリバートする予定）。
-32602	無効なUserOperation構造体/フィールド。
-32500	アカウント作成または検証中にentryPointのsimulateValidationによってトランザクションが拒否された。
-32501	paymasterのvalidatePaymasterUserOpによってトランザクションが拒否された。
-32502	オペコード検証によってトランザクションが拒否された。
-32503	UserOperationが時間範囲外：アカウントまたはペイマスターが時間範囲を返し、既に期限切れ（またはすぐに期限切れになる）。
-32504	ペイマスター（または署名アグリゲーター）がスロットル/禁止されているためトランザクションが拒否された。
-32505	ペイマスター（または署名アグリゲーター）のステークまたはアンステーク遅延が低すぎるためトランザクションが拒否された。
-32506	アカウントが未サポートの署名アグリゲーターを指定したためトランザクションが拒否された。
-32507	validateUserOpまたはvalidatePaymasterUserOpが無効な署名チェックを返した。

バンドラーエラーコードには、追加のガイダンスを提供するためにEntryPointによって提供される追加のAAxxコードが付随していることがよくあります。