Skip to main content

Batch requests

To improve UX by minimizing app switches, MWP allows client apps to make requests with multiple actions at once. Wallets should return results in a single response message as well. Client can specify whether each action is required or optional to customize the flow.

Request has actions​

  • A request message contains an array of actions
  • Each action defines a single JSON RPC call with corresponding parameters in JSON format
  • optional boolean property to tell the host wallet to cancel the request if it fails to process non-optional action.

Example request message with three actions batched​

{
  "version": "1.0.3",
  "sender": "AD6aqQNPr4/NRQymzqr14qjlnO9LN5JaEs/XEwEGTno=",
  "content": {
    "request": {
      "actions": [
        {
          "paramsJson": "{\"chainId\":\"137\"}",
          "method": "wallet_switchEthereumChain",
          "optional": false
        },
        {
          "paramsJson": "{\"address\":\"0x571a6a108adb08f9ca54fe8605280F9EE0eD4AF6\",\"message\":\"message\"}",
          "method": "personal_sign",
          "optional": true
        },
        {
          "paramsJson": "{\"toAddress\":\"0\",\"fromAddress\":\"0x571a6a108adb08f9ca54fe8605280F9EE0eD4AF6\",\"chainId\":\"137\",\"weiValue\":\"0\",\"data\":\"\"}",
          "method": "eth_sendTransaction",
          "optional": false
        }
      ]
    }
  },
  "timestamp": 689616588.09238,
  "callbackUrl": "myappxyz://mycallback/wsegue",
  "uuid": "84920218-ED92-4DF7-83BC-3CBFD1E5C7E3"
}

Response has values​

  • A response message contains array of values
  • value can be either
    • result: JSON string
    • error: error code and message

Example​

coming soon