Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
updatewitness
wallet/updatewitness
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/updatewitness \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner_address": "TPswDDCAWhJAZGdHPidFg5nEf8TkNToDX1",
  "update_url": "https://example.com/witness",
  "visible": true
}
'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": [
      {
        "type": "UpdateWitnessContract",
        "parameter": {
          "type_url": "type.googleapis.com/protocol.UpdateWitnessContract",
          "value": {
            "owner_address": "<string>",
            "update_url": "<string>"
          }
        }
      }
    ],
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}
TRON API method that creates a transaction to update a witness account’s URL. This allows witnesses to update their public information and promotional content displayed to voters in the TRON network governance system.
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 — hexadecimal address of the witness account to update
  • update_url — new URL string for the witness (maximum 256 bytes)
  • visible — boolean indicating whether addresses should be in visible format (Base58Check)

​
Response

  • visible — boolean indicating whether addresses are in visible format
  • txID — unique transaction ID for the witness update transaction
  • raw_data — raw transaction data containing:
    • contract — array with witness update 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/updatewitness method is used for:
  • Updating witness promotional URLs and information for voters.
  • Maintaining current witness contact information and websites.
  • Building witness management dashboards and governance tools.
  • Implementing automated witness information updates in applications.
  • Creating witness profile management systems for TRON governance participants.
Only the witness account owner can update their witness information. The URL field can contain website links, social media profiles, or other promotional content to help voters make informed decisions. Updates require network confirmation and consume bandwidth.

Body

application/json
​
owner_address
string
required

Hexadecimal address of the witness account to update

​
update_url
string

New URL string for the witness (maximum 256 bytes)

​
visible
boolean

Whether addresses should be in visible format (Base58Check)

Response

200 - application/json

Witness update transaction

​
visible
boolean

Whether addresses are in visible format

​
txID
string

Transaction ID for witness update transaction

​
raw_data
object
​
raw_data_hex
string

Raw transaction data in hex format