Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
updatesetting
wallet/updatesetting
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/updatesetting \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "consume_user_resource_percent": 10,
  "visible": true
}'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": [
      "<any>"
    ],
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}
TRON API method that updates the consume user resource percentage setting for a smart contract. This setting determines what percentage of the contract caller’s resources (bandwidth and energy) should be consumed when executing the contract.
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 contract owner who can update settings
  • contract_address — address of the smart contract to update settings for
  • consume_user_resource_percent — percentage (0–100) of caller’s resources to consume
  • visible — boolean indicating whether to use visible (Base58) address format instead of hex

​
Response

  • visible — boolean indicating whether addresses are in visible format
  • txID — unique transaction ID for the setting update transaction
  • raw_data — raw transaction data containing:
    • contract — array with contract update 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/updatesetting method is used for:
  • Adjusting resource consumption patterns for smart contract execution.
  • Optimizing contract costs by controlling user vs contract owner resource usage.
  • Managing energy and bandwidth allocation between contract and users.
  • Implementing different pricing models for contract interactions.
  • Fine-tuning contract economics and user experience trade-offs.
  • Setting up contracts to be more or less resource-friendly to callers.
Only the contract owner can update the consume user resource percentage. Setting this to 100 means all resources come from the caller, while 0 means all resources come from the contract owner. The default is typically 100.

​
curl example

Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/updatesetting' \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "consume_user_resource_percent": 10,
  "visible": true
}'
1

verify owner account exists

Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccount' \
  --header 'Content-Type: application/json' \
  --data '{ "address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC", "visible": true }'
2

confirm contract owner

Use wallet/getcontract with a hex address to retrieve origin_address and ensure it matches owner_address (converted to hex if needed).
Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getcontract' \
  --header 'Content-Type: application/json' \
  --data '{ "value": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c" }'
common validation errors:
  • Account [41…] does not exist — the payer address is not activated or visible does not match the provided address format.
  • No permission — the owner_address is not the contract owner (origin_address).
  • Contract not found — verify the contract address and format.

Body

application/json
​
owner_address
string
required

Address of the contract owner

​
contract_address
string
required

Address of the smart contract

​
consume_user_resource_percent
number
required

Percentage (0-100) of caller's resources to consume

Required range: 0 <= x <= 100
​
visible
boolean

Whether to use visible (Base58) address format

Response

Contract setting update transaction

​
visible
boolean

Whether addresses are in visible format

​
txID
string

Transaction ID for the setting update

​
raw_data
object
​
raw_data_hex
string

Raw transaction data in hex format