Raw Transaction

Execute raw EVM transactions using the Okto Gateway. This endpoint handles custom EVM transactions with specified parameters.

Dev Tools Available!

For quick testing purposes, we provide development tools like the Okto Auth Token Generator. This tool helps you generate authentication tokens instantly, making it easier to test our APIs.

Session & OAuth Token Generator Github API Template

POST Request

Endpoint

POST https://sandbox-okto-gateway.oktostage.com/rpc

Headers

Name	Type	Description
Content-Type	string	Must be `application/json`
Authorization	string	Bearer token for authentication

Request Body

{
  "method": "execute",
  "jsonrpc": "2.0",
  "id": "<request-id>",
  "params": [
    {
      "sender": "string",                      // Sender's address
      "nonce": "string",                       // Transaction nonce
      "callData": "string",                    // Encoded function call data
      "callGasLimit": "string",                // Gas limit for the call
      "verificationGasLimit": "string",        // Gas limit for verification
      "preVerificationGas": "string",          // Gas for pre-verification
      "maxFeePerGas": "string",                // Maximum fee per gas
      "maxPriorityFeePerGas": "string",        // Maximum priority fee per gas
      "paymaster": "string",                   // Paymaster contract address
      "paymasterPostOpGasLimit": "string",     // Gas limit for post-operation
      "paymasterVerificationGasLimit": "string", // Gas limit for verification
      "paymasterData": "string",               // Data for paymaster
      "signature": "string"                    // Transaction signature
    }
  ]
}

Tip:Request Parameters

Show

callData: The encoded function call data for the raw transaction
callGasLimit: Gas limit for the actual function call
maxFeePerGas and maxPriorityFeePerGas: Gas fee parameters
nonce: Unique identifier for the transaction
paymaster: Address of the paymaster contract
paymasterData: Data required for paymaster operations
paymasterPostOpGasLimit: Gas limit for post-operation checks
paymasterVerificationGasLimit: Gas limit for paymaster verification
preVerificationGas: Gas required for pre-verification steps
sender: Address of the transaction sender
verificationGasLimit: Gas limit for transaction verification
signature: Cryptographic signature of the transaction

Response

{
  "jsonrpc": "2.0",
  "id": "<request-id>",
  "result": {
    "jobId": "string"    // Unique identifier for the transaction job
  }
}

Example

curl --location 'https://sandbox-okto-gateway.oktostage.com/rpc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your-token>' \
--data '{
  "jsonrpc": "2.0",
  "id": "25456a8f-8b66-4405-ad18-906aad82eba3",
  "method": "execute",
  "params": [
    {
      "sender": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "nonce": "0x000000000000000000000000000000003ee337319e964ab9892cea476b36295d",
      "callData": "0x8dd7712f...",
      "callGasLimit": "0x493e0",
      "verificationGasLimit": "0x30d40",
      "preVerificationGas": "0xc350",
      "maxFeePerGas": "0x77359400",
      "maxPriorityFeePerGas": "0x77359400",
      "paymaster": "0x5408fAa7F005c46B85d82060c532b820F534437c",
      "paymasterVerificationGasLimit": "0x186a0",
      "paymasterPostOpGasLimit": "0x186a0",
      "paymasterData": "0x000000...",
      "signature": "0x6bf06e6d..."
    }
  ]
}'

Response Examples

{
  "jsonrpc": "2.0",
  "id": "25456a8f-8b66-4405-ad18-906aad82eba3",
  "result": {
    "jobId": "3ee33731-9e96-4ab9-892c-ea476b36295d"
  }
}