-
Notifications
You must be signed in to change notification settings - Fork 60
Open
Description
Summary
Add native support for the Stellar network (XLM) to OneKey so users can hold, send, receive, and view Stellar assets (native XLM and Stellar tokens/Assets).
Use cases
- Store and transfer XLM (Lumens) natively.
- Manage Stellar-issued assets (custom assets) and trustlines.
- View transaction history and balances from Horizon.
- Sign Stellar transactions from mnemonic/private key managed by OneKey.
Proposed scope
- Integrate Stellar SDK (e.g., stellar-sdk) for keypair generation, transaction building and signing, and Horizon API interactions.
- UI: add Stellar to network list, wallet balance view, send/receive flows, asset/trustline management, and transaction history.
- Support import of existing Stellar accounts via seed/private key and export/backup flows compatible with OneKey's seed phrase system.
- Basic security: local signing, no secret exfiltration, same UX for passphrase/biometrics as other networks.
Technical notes
- Stellar uses ed25519 keypairs and Horizon API (not EVM RPC). Recommended libraries: stellar-sdk (JS), js-stellar-sdk.
- Transaction flow requires creating and funding trustlines for non-native assets; UI should prompt users to add trustline when receiving tokens.
- Fee structure: network fees are in XLM (base fee); consider fee estimation using Horizon.
- Optional: support SEP-0007/SEP-0005 if useful for dApp integrations.
Backwards compatibility & security
- No changes to existing seed format required if using BIP39/BIP44 compatible derivation — document derivation path used (e.g., m/44'/148'/0').
- Ensure consistent key derivation and display of Stellar addresses (G... account IDs).
- Tests: unit tests for derivation, signing, and integration tests with Horizon testnet.
Acceptance criteria
- Users can create/import Stellar accounts and view XLM balance.
- Users can send/receive XLM and add trustlines for Stellar assets.
- Transaction history visible and correct for recent operations.
- All private keys remain stored/signed locally with same security guarantees as other networks.
Additional context / resources
- Stellar SDK: https://github.com/stellar/js-stellar-sdk
- Horizon API docs: https://developers.stellar.org/api/
- Stellar key derivation BIP44 coin type: 148 (m/44'/148'/n')
- Example wallets: Lobstr, StellarTerm, Freighter (for UX references)
Metadata
Metadata
Assignees
Labels
No labels