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
| State | Display and handling |
|---|---|
| Fresh quote | Show quantity and valuation, with observation time where useful |
| Cache still allowed for display | Preserve its reference nature and refresh under the application's freshness policy |
| Expired or unavailable | Keep asset quantity visible and mark valuation unavailable |
| Some assets lack prices | Label a partial valuation rather than treating unknown assets as worthless |
| Test-network mapping | A 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.