Stellar

Overview

StellarModule provides native Stellar blockchain operations including message signing, transaction envelope signing, XLM and asset transfers, trustlines, balance queries, and network details. Access it via DynamicSDK.instance().stellar.

Prerequisites

Dynamic SDK initialized (see Quickstart)
User authenticated (see Authentication)
Stellar enabled in the Dynamic dashboard

Get a Stellar Wallet

If Stellar is enabled in the dashboard, the user gets a Stellar wallet on signup. Find it via userWallets:

let sdk = DynamicSDK.instance()

let stellarWallet = sdk.wallets.userWallets.first(where: { $0.chain == "STELLAR" })

Get Balance

Query the XLM balance for a wallet. Returned as a string to preserve precision. Pass assetCode and assetIssuer to query a non-native asset instead.

let balance = try await sdk.stellar.getBalance(walletId: wallet.id)
print("Balance: \(balance) XLM")

Get Network

Query the Stellar network the wallet is connected to:

let network = try await sdk.stellar.getNetwork(walletId: wallet.id)
print("Network: \(network)") // e.g. "PUBLIC"

Sign a Message

Sign a message using the connected Stellar wallet:

let signature = try await sdk.stellar.signMessage(
  walletId: wallet.id,
  message: "Hello, Stellar!"
)
print("Signature: \(signature)")

Sign a Transaction

Sign a base64-encoded transaction envelope XDR. Returns the signed envelope XDR:

let signedXdr = try await sdk.stellar.signTransaction(
  walletId: wallet.id,
  transactionXdr: envelopeXdr
)
print("Signed XDR: \(signedXdr)")

Send a Balance

Send XLM, or a Stellar asset, to a recipient. Returns the transaction hash.

let hash = try await sdk.stellar.sendBalance(
  walletId: wallet.id,
  toAddress: "GBUQWP3BOUZX34ULNQG23RQ6F4BV7DVOV4SJQ6FYMJNL3LQO5QFCP5O4",
  amount: "0.01"
)
print("Hash: \(hash)")

Parameter	Type	Description
`walletId`	`String`	The wallet ID to send from
`toAddress`	`String`	Recipient Stellar address (public key)
`amount`	`String`	Amount to send
`tokenAddress`	`String?`	Optional asset in `CODE:ISSUER` form. Omit for native XLM
`tokenDecimals`	`Int?`	Optional asset decimals. Stellar uses 7 by default

Add a Trustline

Add a trustline for a non-native asset. An account must hold a trustline for an asset before it can receive it:

let hash = try await sdk.stellar.addTrustline(
  walletId: wallet.id,
  assetCode: "USDC",
  assetIssuer: "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
  limit: nil // optional
)
print("Hash: \(hash)")

Parameter	Type	Description
`walletId`	`String`	The wallet ID
`assetCode`	`String`	The asset code, e.g. `USDC`
`assetIssuer`	`String`	Public key of the asset issuer
`limit`	`String?`	Optional trustline limit

API Reference

Method	Returns	Description
`getBalance`	`String`	Get wallet balance
`getNetwork`	`String`	Get the connected network, e.g. `PUBLIC`
`signMessage`	`String`	Sign a message
`signTransaction`	`String`	Sign an envelope XDR
`sendBalance`	`String`	Send XLM or an asset, returns tx hash
`addTrustline`	`String`	Add an asset trustline, returns tx hash

Next Steps

Bitcoin Operations: Bitcoin operations
SUI Operations: SUI operations
Token Balances: Multi-chain balance queries

Getting Started

Authentication

Wallets

Gasless

Business Accounts

Customizing Our UI

SDK Reference

Overview

Prerequisites

Get a Stellar Wallet

Get Balance

Get Network

Sign a Message

Sign a Transaction

Send a Balance

Add a Trustline

API Reference

Next Steps

​Overview

​Prerequisites

​Get a Stellar Wallet

​Get Balance

​Get Network

​Sign a Message

​Sign a Transaction

​Send a Balance

​Add a Trustline

​API Reference

​Next Steps

Overview

Prerequisites

Get a Stellar Wallet

Get Balance

Get Network

Sign a Message

Sign a Transaction

Send a Balance

Add a Trustline

API Reference

Next Steps