This guide provides practical instructions for interacting with the Fee Burner module, primarily for operators, validators, and users who need to query information about burned fees.
Querying Module Parameters
You can query the current parameters of the Fee Burner module using the CLI:
neutrond query feeburner params
Example output:
{
"params": {
"neutron_denom": "untrn",
"reserve_address": "", // Deprecated in v0.4.4
"treasury_address": "neutron1..."
}
}
Or via the REST API:
curl -X GET "http://localhost:1317/neutron/feeburner/params"
Checking Total Burned NTRN Amount
To query the total amount of NTRN tokens that have been burned since genesis:
neutrond query feeburner total-burned-neutrons-amount
Example output:
{
"total_burned_neutrons_amount": {
"coin": {
"denom": "untrn",
"amount": "1532687456789"
}
}
}
Or via the REST API:
curl -X GET "http://localhost:1317/neutron/feeburner/total_burned_neutrons_amount"
For Chain Governance
Updating Module Parameters
The module parameters can be updated through governance proposals using the MsgUpdateParams
message:
{
"@type": "/neutron.feeburner.MsgUpdateParams",
"authority": "neutron1...", // governance authority address
"params": {
"neutron_denom": "untrn",
"treasury_address": "neutron1...",
"reserve_address": ""
}
}
This message can only be executed through governance proposals, not directly by individual users.
For Developers
Programmatic Queries
Using gRPC
You can query the module’s parameters using gRPC:
grpcurl -plaintext \
-d '{}' \
localhost:9090 \
neutron.feeburner.Query/Params
To query the total burned NTRN amount:
grpcurl -plaintext \
-d '{}' \
localhost:9090 \
neutron.feeburner.Query/TotalBurnedNeutronsAmount
Using CosmJS
// Query Fee Burner module parameters
const queryClient = await cosmwasm.SigningCosmWasmClient.connect(rpcEndpoint);
const params = await queryClient.queryContractSmart(
"neutron/feeburner/params",
{}
);
console.log(params);
// Query total burned NTRN amount
const burnedAmount = await queryClient.queryContractSmart(
"neutron/feeburner/total_burned_neutrons_amount",
{}
);
console.log(burnedAmount);
Monitoring Fee Burning
To monitor fee burning activities, you can:
- Set up an indexer to track and aggregate burned fee amounts over time
- Create visualizations that show the deflationary impact on NTRN supply
- Build alerts for significant burning events
Understanding Fee Impact
The Fee Burner module has a direct impact on NTRN tokenomics. To understand this impact:
- Monitor Burn Rate: Track the amount of NTRN burned over time relative to network usage
- Calculate Deflationary Pressure: Compare the burn rate to any inflationary mechanisms
- Analyze Supply Changes: Observe how the circulating supply changes in response to network activity
You can calculate the annualized burn rate using:
Annual Burn Rate = (Daily Burned Amount * 365) / Total Supply
This provides insight into the long-term deflationary effects of the Fee Burner module.