コアJSON-RPCメソッド

ペイマスターAPIはJSON-RPCを使用しており、これはEthereum互換ノードと通信するための標準です。以下が利用可能な主要なメソッドです：

pm_supported_tokens

ペイマスターがガス支払いをサポートするERC20トークンのリストと価格情報を取得します。

パラメータ：

userOperation - 少なくともsenderフィールドを含む最小限のUserOperationオブジェクト
apiKey - AAプラットフォームから取得したAPIキー
entryPoint - EntryPointコントラクトアドレス（通常は0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789）

リクエスト例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "pm_supported_tokens",
  "params": [
    {
      "sender": "0xAAWalletAddress",
      "nonce": "0x0",
      "initCode": "0x",
      "callData": "0x",
      "callGasLimit": "0x0",
      "verificationGasLimit": "0x0",
      "preVerificationGas": "0x0",
      "maxFeePerGas": "0x0",
      "maxPriorityFeePerGas": "0x0",
      "paymasterAndData": "0x",
      "signature": "0x"
    },
    "YOUR_API_KEY",
    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
  ]
}

レスポンス例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "freeGas": true,
    "native": { 
      "gas": "0x337dc", 
      "price": 1, 
      "decimals": 18, 
      "symbol": "NERO" 
    },
    "tokens": [
      {
        "type": "system",
        "token": "0xD5a6dcff7AC339A03f6964c315575bF65c3c6cF6",
        "symbol": "DAI",
        "decimals": 18,
        "price": 2.1
      },
      {
        "type": "custom",
        "token": "0x13DCf97b6B94bDA883492AB46d556E8919445876",
        "symbol": "TestToken",
        "decimals": 18,
        "price": 0.1
      }
    ]
  }
}

このレスポンスでは：

freeGasはガススポンサーシップ（タイプ0）が利用可能かどうかを示します
nativeはネイティブトークン（NERO）に関する情報を提供します
tokensはNEROに対する相対価格比率を持つすべてのサポート対象ERC20トークンをリストします

pm_sponsor_userop

ペイマスターでUserOperationに署名し、スポンサードまたはトークン支払いトランザクションに必要なpaymasterAndDataフィールドを追加します。

パラメータ：

userOperation - 署名される完全なUserOperation
apiKey - AAプラットフォームから取得したAPIキー
entryPoint - EntryPointコントラクトアドレス
context - 支払い詳細を含むオブジェクト：
- type - 支払いタイプ（0：スポンサード、1：前払い、2：後払い）
- token - ERC20トークンアドレス（タイプ1と2では必須）

無料ガス（タイプ0）のリクエスト例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "pm_sponsor_userop",
  "params": [
    {
      "sender": "0xAAWalletAddress",
      "nonce": "0x0",
      "initCode": "0x",
      "callData": "0xCallData",
      "callGasLimit": "0x88b8",
      "verificationGasLimit": "0x33450",
      "preVerificationGas": "0xc350",
      "maxFeePerGas": "0x9502f900",
      "maxPriorityFeePerGas": "0x9502f900",
      "paymasterAndData": "0x",
      "signature": "0xUserSignature"
    },
    "YOUR_API_KEY",
    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
    {
      "type": 0
    }
  ]
}

ERC20支払い（タイプ1）のリクエスト例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "pm_sponsor_userop",
  "params": [
    {
      "sender": "0xAAWalletAddress",
      "nonce": "0x0",
      "initCode": "0x",
      "callData": "0xCallData",
      "callGasLimit": "0x88b8",
      "verificationGasLimit": "0x33450",
      "preVerificationGas": "0xc350",
      "maxFeePerGas": "0x9502f900",
      "maxPriorityFeePerGas": "0x9502f900",
      "paymasterAndData": "0x",
      "signature": "0xUserSignature"
    },
    "YOUR_API_KEY",
    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
    {
      "type": 1,
      "token": "0xTokenAddress"
    }
  ]
}

レスポンス例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "sender": "0xAAWalletAddress",
    "nonce": "0x0",
    "initCode": "0x",
    "callData": "0xCallData",
    "callGasLimit": "0x88b8",
    "verificationGasLimit": "0x33450",
    "preVerificationGas": "0xc350",
    "maxFeePerGas": "0x9502f900",
    "maxPriorityFeePerGas": "0x9502f900",
    "paymasterAndData": "0xPaymasterAddress+EncodedData+PaymasterSignature",
    "signature": "0xUserSignature"
  }
}

pm_entrypoints

現在サポートされているEntryPointアドレスを取得します。

リクエスト：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "pm_entrypoints",
  "params": [
      "entryPoint"
  ]
}

レスポンス：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
  ]
}

概要支払いタイプ