Summary
The Astera frontend uses Stellar-specific technical terms (stroops, ledger, Horizon, XLM, Soroban) that are unfamiliar to users coming from Ethereum or traditional finance backgrounds. Adding contextual tooltips or a glossary would reduce confusion and lower the learning curve.
Terms to Explain In-Context
| Term |
Plain-language explanation |
| Stroops |
The smallest unit of XLM (like satoshis for Bitcoin). 1 XLM = 10,000,000 stroops |
| Ledger |
A single block in Stellar's blockchain. Closes every ~5 seconds |
| Horizon |
Stellar's API server for querying blockchain data |
| Soroban |
Stellar's smart contract platform |
| TTL |
Time-to-live: how long data stays stored on the blockchain |
| Collateral Ratio |
The value of your collateral vs. the amount you borrowed |
| Factoring Fee |
The protocol's fee for facilitating invoice financing |
Implementation Options
Option A: Glossary Page
- `/glossary` page with all terms and definitions
- Linked from the footer and help sections
Option B: Inline Tooltips
- Each technical term underlined with a dotted border
- Hover (or tap on mobile) shows a tooltip with the definition
Option C: Both
- Inline tooltips for frequently-used terms on the dashboard
- Full glossary page for comprehensive reference
Acceptance Criteria
References
- `frontend/app/`
- `frontend/components/`
Summary
The Astera frontend uses Stellar-specific technical terms (stroops, ledger, Horizon, XLM, Soroban) that are unfamiliar to users coming from Ethereum or traditional finance backgrounds. Adding contextual tooltips or a glossary would reduce confusion and lower the learning curve.
Terms to Explain In-Context
Implementation Options
Option A: Glossary Page
Option B: Inline Tooltips
Option C: Both
Acceptance Criteria
References