Skip to main content

Valuation, networks and fee display

Asset identity comes before price​

Do not apply a symbol-based quote to arbitrary tokens sharing a name. Public balances, private inventory and prices need a common network and asset identity. Native and wrapped assets are different assets; deployment and SDK capabilities determine eligibility for a private operation, not an icon.

Separate reference valuation from an executable swap quote. Valuation supports portfolio display; execution must account for the actual trade size, route, liquidity, fees and slippage. A displayed dollar price is not a guarantee of execution at that price.

Price states and portfolio totals​

StateDisplay and handling
Fresh quoteShow quantity and valuation, with observation time where useful
Cache still allowed for displayPreserve its reference nature and refresh under the application's freshness policy
Expired or unavailableKeep asset quantity visible and mark valuation unavailable
Some assets lack pricesLabel a partial valuation rather than treating unknown assets as worthless
Test-network mappingA reference dollar value does not imply redeemable test-token value

Private-inventory and price refreshes fail independently. A valid quote does not prove inventory is synchronized, and synchronized inventory does not guarantee a quote. Market change, account deposits and personal investment returns are different concepts.

Networks and RPC failures​

Switch balances, token identity, Core deployment, Gas asset, explorer links and pending-operation context together when networks change. Editing an RPC URL does not change chain ID. Verify the network actually served; HTTP 200 does not establish chain identity or trust.

Separate read failover from payment resubmission. A timeout can justify retrying a query, not constructing another payment. Broadcasting the same signed transaction also differs from asking for a new signature. See transaction recovery.

Show funds, network fees and service charges separately​

Before signing, display the payment amount, estimated native network fee, optional sponsorship charge and debit asset. If payment-token fee conversion is supported, show quote validity and the token amount. Fee changes must recompute available balance, selected Note coverage and final terms.

  • Estimates are not final on-chain costs; reconcile against actual execution.
  • Enough tokens for payment does not imply enough native Gas.
  • Sponsorship is not automatically free or available for every network and asset.
  • Local portfolio valuation is not an executable sponsorship quote.
  • Reject unknown decimals and failed quotes rather than silently using 18 decimals or a fixed exchange rate.

See Broadcaster for quotation and authorization boundaries, and request conventions for merchant amounts.