Skip to content

Request: Add native Stellar (XLM) network support #614

@AlexanderPhilippov

Description

@AlexanderPhilippov

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions