Asset/formatting

[Damola-Sodiq]

Summary

Document asset formatting rules and display guidelines for SDK consumers across mobile and web applications to ensure consistent, secure, and clear presentation of Stellar assets.

Key Changes

• Added Asset Formatting Guide (docs/asset-formatting.md):
  • Native vs. Issued Assets: Rules for displaying XLM vs. issued tokens (credit_alphanum4 / credit_alphanum12).
  • Issuer Display & Security: Truncation pattern (GABC...XYZ1), full address copyability, and guidance against hiding issuer keys to prevent spoofing.
  • Balance & Decimal Formatting: 2-decimal default display, truncation over rounding for spendable balances, and clear breakdown of available, reserved, and total balances.
  • Unknown Assets & Warnings: Visual warning states for unauthorized trustlines (isAuthorized === false) and safe fallback for unknown assets.
  • SDK Helper Integration: Code examples using formatAssetBalanceDisplay and findAssetInMultiBalance.
• Updated README (README.md): Linked the new documentation in the main Documentation section.

Acceptance Criteria

• Asset formatting rules are documented.
• Native and issued asset display is covered.
• Issuer display guidance is included.
• Balance formatting is explained.
• README links to the document.

closes #185