Executions

Continue a prepared execution with its owner's transaction signature

Changed on

Submit the exact priced operation from prepareWorkflow. Accepts only the signature, not caller-supplied UserOperation fields. Rechecks the current owner/account identity, nonce and funding before first relay. Uses SendUserOpV07 without a server signing key or gas/nonce retry. Material changes or bundler rejection require fresh prepare/review/signing. Repeat calls still require a valid signature and reconcile the existing hash without rebroadcasting. Status polling requires the JWT only. A durable submitting marker precedes the send. The relay after that marker keeps running when the client disconnects. A crash before the RPC leaves the id submitting. A retry looks the hash up at the bundler: a hit is stored as submitted; an unknown hash stays submitting until the ten-minute signing window ends, then becomes unsent and requires a new prepare. That prepare uses the same sender and owner nonce key (entity 0, global), read from EntryPoint.getNonce with no session nonce cache, so an unmined operation and its replacement cannot both be included. A lookup error leaves the marker submitting. A post-send storage failure also preserves the marker. Poll the prepared hash. An empty bundler result during the window is unresolved. Uncertain and submitted records are retained for 24 hours and do not count toward the 64 prepared-record cap. A response is not a receipt; reuse GET /userops/{userOpHash} for confirmation.

post/executions/{id}:submit

Request

  • Base URL
    https://api.avaprotocol.org/api/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

ULID identifier (26-char Crockford base32).

Example:01JG2FE5MDVKBPHEG0PEYSDKAC

Request body

signaturestring required

65-byte EOA personal signature of the prepared hash. Recovery byte 0/1 or 27/28; gateway verifies and frames it for MA v2.

Response

Relay accepted or uncertain; use the existing UserOp status route.

executionIdstring required

ULID identifier (26-char Crockford base32).

userOpHashstring required

32-byte hex hash (UserOp hash, transaction hash).

chainIdinteger required

Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.

submissionState'submitting' | 'submitted' | 'unknown' required

Relay progress, not transaction success. Poll GET /userops/{userOpHash} with chainId for the existing receipt status. Unknown/submitting can survive a transport failure or restart; repeating submit never changes the operation or starts another broadcast.

Example response

{
  "executionId": "01JG2FE5MDVKBPHEG0PEYSDKAC",
  "userOpHash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "chainId": 11155111
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added