Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
createwitness
wallet/createwitness
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/createwitness \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "url": "https://mywitness.example.com",
  "visible": true
}
'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": "<array>",
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}
TRON API method that creates a transaction to register an account as a witness (validator) on the TRON network. Witnesses participate in block production and network governance through the Delegated Proof of Stake (DPoS) consensus mechanism.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • owner_address — address of the account that will become a witness. Use base58 with visible: true, or hex with visible: false.
  • url — witness website URL providing information about the witness (must be a valid URL)
  • visible — optional boolean. When true, addresses are base58; when false, hex. Default is true.

​
Response

  • visible — boolean indicating whether addresses are in visible format
  • txID — unique transaction ID for the witness creation transaction
  • raw_data — raw transaction data containing:
    • contract — array with witness creation contract details
    • ref_block_bytes — reference block bytes for transaction validation
    • ref_block_hash — hash of the reference block
    • expiration — transaction expiration timestamp
    • timestamp — transaction creation timestamp
  • raw_data_hex — complete transaction data encoded in hexadecimal format

​
Use case

The wallet/createwitness method is used for:
  • Registering an account as a witness to participate in TRON network governance.
  • Setting up block production capabilities for earning rewards from the network.
  • Establishing a public presence for community voting and trust building.
  • Preparing to compete for one of the 27 Super Representative positions.
  • Contributing to network security and decentralization through validation services.
  • Building reputation and credibility within the TRON ecosystem.
This method only creates the witness registration transaction. You must sign the transaction and use wallet/broadcasttransaction to complete the witness registration. Becoming an active block producer requires receiving votes from TRX holders.

​
curl example

Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/createwitness' \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "url": "https://mywitness.example.com",
  "visible": true
}'
seeing INVALID hex String? Provide a base58 address with visible: true, or a 21‑byte hex address (starts with 41…) with visible: false.

Body

application/json
​
owner_address
string
required

Address that will become a witness. Use base58 with visible: true, or hex with visible: false.

​
url
string
required

Witness website URL (must be a valid URL)

​
visible
boolean
default:true

When true, addresses are base58; when false, hex.

Response

200 - application/json

Witness creation transaction

​
visible
boolean

Whether addresses are in visible format

​
txID
string

Transaction ID for witness creation

​
raw_data
object
​
raw_data_hex
string

Raw transaction data in hex format

Last modified on November 1, 2025