Skip to main content
The Network Broadcast API allows you to broadcast signed transactions to the Hive blockchain. Use this API to submit transactions after they have been properly signed with the required authorities.

​
broadcast_transaction

Broadcast a signed transaction to the network. 
import { createHiveChain } from "@hiveio/wax";

const chain = await createHiveChain();

// Create and sign transaction
const tx = await chain.createTransaction();
tx.pushOperation({
  vote: {
    voter: "alice",
    author: "bob",
    permlink: "example-post",
    weight: 10000
  }
});
tx.sign(wallet, publicKey);

// Broadcast using the chain helper
await chain.broadcast(tx);

// Or call the API directly
await chain.api.network_broadcast_api.broadcast_transaction({
  trx: tx.transaction,
  max_block_age: -1
});

console.log("Transaction broadcasted successfully");

​
Parameters

​
trx
ApiTransaction
required
The signed transaction to broadcast
​
max_block_age
number
required
Maximum block age in seconds. Use -1 to disable the check.

​
Response

This endpoint returns an empty response on success. If the transaction is invalid or cannot be broadcast, an error will be thrown. 
{
  "trx": {
    "ref_block_num": 12345,
    "ref_block_prefix": 987654321,
    "expiration": "2026-03-04T12:05:00",
    "operations": [
      {
        "type": "vote",
        "value": {
          "voter": "alice",
          "author": "bob",
          "permlink": "example-post",
          "weight": 10000
        }
      }
    ],
    "extensions": [],
    "signatures": [
      "1f7f0c3e89e6ccef1ae156a96fb4255e619ca3a73ef3be46746b4b40a66cc4252070eb313cc6308bbee39a0a9fc38ef99137ead3c9b003584c0a1b8f5ca2ff8707"
    ]
  },
  "max_block_age": -1
}

​
Transaction lifecycle

Before broadcasting a transaction, follow these steps:

​
1. Create transaction with TaPoS

Transactions require TaPoS (Transaction as Proof of Stake) data for security: 
// Get TaPoS from current blockchain state
const tx = await chain.createTransaction();

// Or create with specific block reference
const tx = chain.createTransactionWithTaPoS(
  "04c1c7a566fc0da66aee465714acee7346b48ac2",
  "2026-03-04T12:00:00"
);

​
2. Add operations

Push one or more operations to the transaction: 
tx.pushOperation({
  vote: {
    voter: "alice",
    author: "bob",
    permlink: "example-post",
    weight: 10000
  }
});

// Validate the transaction
tx.validate();

​
3. Sign transaction

Sign with the required authority (posting, active, or owner): 
// Sign with beekeeper wallet
tx.sign(wallet, "STM5RqVBAVNp5ufMCetQtvLGLJo7unX9nyCBMMrTXRWQ9i1Zzzizh");

// Or sign with private key directly
const wax = await createWaxFoundation();
const signature = wax.createSignature(
  tx.sigDigest,
  "5JkFnXrLM2ap9t3AmAxBJvQHF7xSKtnTrCTginQCkhzU5S7ecPT"
);
tx.transaction.signatures.push(signature);

​
4. Broadcast

Broadcast the signed transaction to the network: 
await chain.broadcast(tx);

​
Error handling

Handle common broadcasting errors: 
try {
  await chain.broadcast(tx);
  console.log("Transaction successful");
} catch (error) {
  if (error.message.includes("expired")) {
    console.error("Transaction expired, create a new one");
  } else if (error.message.includes("signature")) {
    console.error("Invalid signature");
  } else if (error.message.includes("authority")) {
    console.error("Missing required authority");
  } else {
    console.error("Broadcast failed:", error);
  }
}

​
Common errors

  • Transaction expired: The transaction expiration time has passed. Create a new transaction with fresh TaPoS data.
  • Missing authority: The transaction is not signed with the required authority (posting, active, or owner).
  • Duplicate transaction: A transaction with the same operations and expiration already exists in the blockchain.
  • Insufficient RC: The account doesn’t have enough Resource Credits to execute the operations.
  • Invalid signature: The signature doesn’t match the transaction or public key.

Build docs developers (and LLMs) love

Get started for freeTalk to us