shell
--fees 382199010nhash,99usd.example

• Additional fee = 10000nhash

• Gas = 10000

• Fee passed in = 19070000nhash

java
// Source: https://github.com/provenance-io/provenance

val cosmosService = cosmos.tx.v1beta1.ServiceGrpc.newBlockingStub(channel)
cosmosService.simulate(SimulateRequest.newBuilder().setTx(txFinal).build()).gasInfo.gasUsed

java
// Source: https://github.com/provenance-io/provenance

val msgFeeClient = io.provenance.msgfees.v1.QueryGrpc.newBlockingStub(channel)
msgFeeClient.calculateTxFees(CalculateTxFeesRequest.newBuilder().setTx(txFinal).build())

shell
provenanced tx simulate <required params>

• GitHub Repository: provenance-io/provenance

• Assess Fee Specifications: Message Fees Messages Documentation

• Parameters Documentation: Message Fees Parameters Documentation

protobuf
// Source: https://github.com/provenance-io/provenance

// MsgFee is the core of what gets stored on the blockchain to define a msg-based fee.
message MsgFee {
  // msg_type_url is the type-url of the message with the added fee, e.g. "/cosmos.bank.v1beta1.MsgSend".
  string msg_type_url = 1;

  // additional_fee is the extra fee that is required for the given message type (can be in any denom).
  cosmos.base.v1beta1.Coin additional_fee = 2 [(gogoproto.nullable) = false];

  // recipient is an option address that will receive a portion of the additional fee.
  // There can only be a recipient if the recipient_basis_points is not zero.
  string recipient = 3;

  // recipient_basis_points is an optional portion of the additional fee to be sent to the recipient.
  // Must be between 0 and 10,000 (inclusive).
  //
  // If there is a recipient, this must not be zero. If there is not a recipient, this must be zero.
  //
  // The recipient will receive additional_fee * recipient_basis_points / 10,000.
  // The fee collector will receive the rest, i.e. additional_fee * (10,000 - recipient_basis_points) / 10,000.
  uint32 recipient_basis_points = 4;
}

• If there is a recipient, this must not be zero

• If there is not a recipient, this must be zero

• The recipient will receive: additional_fee * recipient_basis_points / 10,000

• The fee collector will receive the rest: additional_fee * (10,000 - recipient_basis_points) / 10,000

protobuf
// Source: https://github.com/provenance-io/provenance

// MsgAssessCustomMsgFeeRequest defines an sdk.Msg type
message MsgAssessCustomMsgFeeRequest {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;
  option (gogoproto.goproto_stringer) = true;

  // optional short name for custom msg fee, this will be emitted as a property of the event
  string name = 1;

  // amount of additional fee that must be paid
  cosmos.base.v1beta1.Coin amount = 2 [(gogoproto.nullable) = false];

  // optional recipient address, the basis points amount is sent to the recipient
  string recipient = 3;

  // the signer of the msg
  string from = 4;

  // optional basis points 0 - 10,000 for recipient defaults to 10,000
  string recipient_basis_points = 5;
}

• GitHub Repository: provenance-io/provenance

• Documentation: Provenance Blockchain Developer Portal

go
// Source: https://github.com/cosmos/cosmos-sdk/blob/master/x/gov/spec/04_events.md
// Governance events documentation available at the above GitHub link

• Cosmos SDK Gov Events: https://github.com/cosmos/cosmos-sdk/blob/master/x/gov/spec/04_events.md

protobuf
// Source: https://github.com/provenance-io/provenance

// QueryParamsRequest is the request type for the Query/Params RPC method.
message QueryParamsRequest {}

protobuf
// Source: https://github.com/provenance-io/provenance

// QueryParamsResponse is the response type for the Query/Params RPC method.
message QueryParamsResponse {
  // params defines the parameters of the module.
  Params params = 1 [(gogoproto.nullable) = false];
}

protobuf
// Source: https://github.com/provenance-io/provenance

// QueryAllMsgFeesRequest queries all Msg which have fees associated with them.
message QueryAllMsgFeesRequest {
  // pagination defines an optional pagination for the request.
  cosmos.base.query.v1beta1.PageRequest pagination = 2;
}

protobuf
// Source: https://github.com/provenance-io/provenance

// response for querying all msg's with fees associated with them
message QueryAllMsgFeesResponse {
  repeated MsgFee msg_fees = 1;
  // pagination defines an optional pagination for the request.
  cosmos.base.query.v1beta1.PageResponse pagination = 2;
}

protobuf
// Source: https://github.com/provenance-io/provenance

// CalculateTxFeesRequest is the request type for the Query RPC method.
message CalculateTxFeesRequest {
  // tx_bytes is the transaction to simulate.
  bytes tx_bytes = 1;

  // default_base_denom is used to set the denom used for gas fees
  // if not set it will default to nhash.
  string default_base_denom = 2;

  // gas_adjustment is the adjustment factor to be multiplied against the estimate returned by the tx simulation
  float gas_adjustment = 3;
}

protobuf
// Source: https://github.com/provenance-io/provenance

// CalculateTxFeesResponse is the response type for the Query RPC method.
message CalculateTxFeesResponse {
  // additional_fees are the amount of coins to be for addition msg fees
  repeated cosmos.base.v1beta1.Coin additional_fees = 1 [
    (gogoproto.nullable)     = false,
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins",
    (amino.dont_omitempty)   = true,
    (amino.encoding)         = "legacy_coins"
  ];

  // total_fees are the total amount of fees needed for the transactions (msg fees + gas fee)
  // note: the gas fee is calculated with the floor gas price module param.
  repeated cosmos.base.v1beta1.Coin total_fees = 2 [
    (gogoproto.nullable)     = false,
    (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins",
    (amino.dont_omitempty)   = true,
    (amino.encoding)         = "legacy_coins"
  ];

  // estimated_gas is the amount of gas needed for the transaction
  uint64 estimated_gas = 3;
}

protobuf
// Example Query Service Definition
// Source: https://github.com/provenance-io/provenance

service Query {
  // Params queries the parameters for x/msgfees
  rpc Params(QueryParamsRequest) returns (QueryParamsResponse) {
    option (google.api.http).get = "/provenance/msgfees/v1/params";
  }

  // Query all Msgs which have fees associated with them.
  rpc QueryAllMsgFees(QueryAllMsgFeesRequest) returns (QueryAllMsgFeesResponse) {
    option (google.api.http).get = "/provenance/msgfees/v1/all";
  }

  // CalculateTxFees simulates executing a transaction for estimating gas usage and additional fees.
  rpc CalculateTxFees(CalculateTxFeesRequest) returns (CalculateTxFeesResponse) {
    option (google.api.http) = {
      post: "/provenance/tx/v1/calculate_msg_based_fee"
      body: "*"
    };
  }
}

go
// Example parameter structure
// Source: https://github.com/provenance-io/provenance

type Params struct {
    FloorGasPrice   uint32 `json:"floor_gas_price"`
    NhashPerUsdMil  uint64 `json:"nhash_per_usd_mil"`
}