push_transaction

Eos RPC

Archive Method

Only on the full archive nodes. Complex queries might take longer and incur additional cost

Overview

The push_transaction method is utilized to transmit a transaction to the EOS blockchain. This method takes a transaction in JSON format and endeavors to apply it to the blockchain, facilitating numerous interactions such as transferring tokens and invoking smart contracts.

// yarn add @tatumio/tatum

import { TatumSDK, Eos, Network } from '@tatumio/tatum'

const tatum = await TatumSDK.init<Eos>({ network: Network.EOS })

const transaction = {
  signatures: [
    /* array of signatures */
  ],
  compression: false,
  packedContextFreeData: 'string', // json to hex
  packedTrx: 'string', // Transaction object json to hex
}

const response = await tatum.rpc.pushTransaction(transaction)

await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs

Example use cases:

  1. Transaction Submission:
    Developers and users might employ the push_transaction method to broadcast transactions to the EOS network, allowing for various interactions and operations on the blockchain.

  2. Smart Contract Interaction:
    Invoking actions on smart contracts deployed on the EOS blockchain is another crucial functionality of this method, granting users the ability to interface with decentralized applications.

  3. Token Transfer:
    For transferring EOS tokens or other tokens available on the EOS blockchain between accounts, the push_transaction method is used.

Request Parameters

The pushTransaction method mandates the following parameters in the request body:

  • signatures (array of strings, required) - An array of strings representing signatures needed to authorize the transaction.
  • compression (boolean, required) - A boolean indicating the status of compression used, typically false.
  • packedContextFreeData (string, required) - Represents the JSON converted to hex.
  • packedTrx (string, required) - Specifies the transaction object, converted from JSON to hex.

Return Object

When a transaction is successfully broadcasted, the push_transaction method typically returns nothing but a 200 OK status.

JSON-RPC Request Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "push_transaction",
  "params": {
    "signatures": ["SIG_K1_..."],
    "compression": false,
    "packedContextFreeData": "746573742064617461", // Example hex of JSON data
    "packedTrx": "00e1f5055c95b089c2e0d0e4" // Example hex of JSON transaction object
  }
}

JSON-RPC Response Example

{
  "jsonrpc": "2.0",
  "id": 1
}