stronghold_flutter_sdk 0.0.4-dev

Native Flutter/Dart SDK for the SHx token ecosystem on Stellar. SHx asset operations, governance voting, and escrow contract bindings.

English | Español

stronghold_flutter_sdk

Native Flutter/Dart SDK for the SHx token ecosystem on Stellar. Composition layer over stellar_flutter_sdk, not a fork · MIT · pub.dev

Status: Early Development. API is not stable. Current phase: Phase 2 - SHx asset operations.

SHx does not have its own blockchain: it is an asset issued on Stellar. This SDK adds SHx-specific asset operations, ManageData-based governance voting, and bindings for Stronghold's on-chain escrow contract, on top of the actively-maintained stellar_flutter_sdk.

Roadmap (v1.0.0)

Phase	Focus	Version	Status
1	Architecture & core setup	0.0.1-dev	✅ Done
2	SHx asset operations (trustline, payment, path payment)	0.1.0-dev	🔄 In progress
3	Governance (ManageData voting)	0.2.0-dev	⏳ Planned
4	Escrow contract client (60B SHx lock/unlock)	0.3.0-dev	⏳ Planned
5	Bridge Status & Tracking	0.4.0-dev	⏳ Planned
6	Docs, testing & pub.dev v1.0	1.0.0	⏳ Planned

Full roadmap with tasks and milestones: see ROADMAP.md.

Documentation & Knowledge Base

This SDK is built on top of the Stronghold/SHx Knowledge Base, covering the SHx token, governance mechanics, the escrow contract, and StrongholdNET. Recommended reading before diving into the SDK internals.

Every implementation decision behind this SDK - library choices, encoding standards, verification against official specs - is documented in docs-sdk/.

Installation

# pubspec.yaml
dependencies:
  stronghold_flutter_sdk: ^0.0.4-dev

flutter pub get

Quick Start

Available today: generating an identity and funding it on Testnet, free, no real XLM required.

import 'package:stronghold_flutter_sdk/stronghold_flutter_sdk.dart';

Future<void> main() async {
  // Generate a new identity and fund it on Testnet via Friendbot.
  final account = await ShxWallet.fundOnTestnet(ShxWallet.createPending());

  print('New Testnet account: ${account.accountId}');
  print('Status: ${account.status}'); // ShxAccountStatus.funded
}

Creating and funding an account on Mainnet follows the same pattern, but requires a funding source with real XLM:

final account = await ShxWallet.createAndFund(
  account: ShxWallet.createPending(),
  sdk: StellarSDK.PUBLIC,
  network: Network.PUBLIC,
  fundingSourceKeyPair: myFundingKeyPair,
  startingBalance: '5',
);

Once funded, an account needs a trustline before it can hold SHx (this only works on Mainnet, since the real SHx issuer does not exist on Testnet):

final ready = await ShxWallet.establishShxTrustline(
  account: myFundedAccount,
  sdk: StellarSDK.PUBLIC,
  network: Network.PUBLIC,
);
// ready.status == ShxAccountStatus.shxReady

SHx trustlines, payments, and governance voting are next on the roadmap. See the Roadmap table above for current status.

Networks

Network	Horizon URL	Soroban RPC
Mainnet	https://horizon.stellar.org	No official public RPC, bring your own provider
Testnet	https://horizon-testnet.stellar.org	https://soroban-testnet.stellar.org

Contributing

The SDK is not ready for external contributions yet. Follow this repository for updates; contributions will be welcome starting with v1.0.0.

See CONTRIBUTING.md for future guidelines.

License

Licensed under MIT.

For LATAM developers

This SDK is being developed with native support for the region in mind:

• Bilingual documentation (English / Spanish) from the very first module.
• Part of Nemorix Group's SDK ecosystem for financial infrastructure in LATAM (Hedera, Avalanche, XRPL, Stellar, Stronghold).
• Developed by Nemorix Group, Ohio, USA.

Follow us for updates: [e-mail]

Support This Project

If this SDK is useful to you or your team, consider supporting its development. Every contribution helps cover infrastructure, documentation, and the time invested in building and maintaining this open source tool for the SHx and Flutter community. Thank you!

---

Built by Nemorix Group · MIT