blockchain-kit-sdk/com.cramium.blockchain.kit/BlockchainSdkService

BlockchainSdkService

@ObjCName(swiftName = "BlockchainSdkService")

class BlockchainSdkService

Main blockchain service exposed to Flutter.

This service provides a unified API for blockchain operations across different chain families (EVM, UTXO in the future). It automatically routes operations to the appropriate chain-specific service based on the network type.

This service is intended to be accessed via BlockchainKitSdk.blockchainService.

Usage from Flutter:

// Create asset and transaction
final ethAsset = NativeCoin(network: ethereumNetwork);
final tx = Transfer(asset: ethAsset, amount: BigInt.from(100000000), to: '0x...');

// Calculate fees
final fees = await BlockchainSdkService.calculateFees(tx, fromAddress);

// Get balance
final balance = await BlockchainSdkService.getBalance(ethAsset, address);

// Get transaction status
final status = await BlockchainSdkService.getTransactionStatus(network, txHash);

Types

object Companion

Properties

transactionStatusUpdates

val transactionStatusUpdates: Flow<TransactionStatusUpdate>

Shared transaction status update stream for Flutter.

Functions

suspend fun calculateFees(tx: Transaction, from: String): Result<Fee>

Calculate the fee for a transaction.

fun getAddress(asset: Asset, groupId: String): Result<String>

Get the wallet address for a given asset and MPC group.

suspend fun getBalance(asset: Asset, address: String): Result<Balance>

Get the balance of an asset for a given address.

suspend fun getBalances(assets: List<Asset>, address: String): List<Result<Balance>>

Get balances for multiple assets for a given address.

suspend fun getNonce(network: Network, address: String): Result<BigInteger>

Get the nonce (transaction count) for an address on a network.

getTransactionStatus

suspend fun getTransactionStatus(network: Network, hash: String): Result<TransactionStatus>

Get the status of a transaction by its hash.

suspend fun preImageHash(tx: Transaction, from: String, fee: Fee): Result<PreImageTx>

Build a PreImageTx for a transaction.

sendTransaction

suspend fun sendTransaction(network: Network, signedTxHex: String): Result<Broadcast>

Broadcast a signed transaction to the network.

suspend fun sign(preImageTx: PreImageTx, groupId: String): Result<String>

Sign a transaction using MPC.

suspend fun signWithHw(preImageTx: PreImageTx, groupId: String): Result<String>

Sign a transaction using threshold MPC with a hardware device via Bluetooth.

startTrackingTransaction

suspend fun startTrackingTransaction(network: Network, hash: String, pollIntervalMs: Long? = null, notFoundTimeoutMs: Long? = null): Result<Boolean>

Start polling and streaming transaction status updates for a given hash.

stopAllTracking

suspend fun stopAllTracking(): Result<Boolean>

Stop polling all transactions.

stopTrackingTransaction

suspend fun stopTrackingTransaction(network: Network, hash: String): Result<Boolean>

Stop polling a specific transaction.