stellar-sdk/com.soneso.stellar.sdk.smartaccount.oz/SmartAccountEvent

SmartAccountEvent

Events emitted by the Smart Account Kit during wallet lifecycle operations.

These events provide hooks for monitoring and responding to key operations:

Wallet connection and disconnection
Credential lifecycle (creation, deletion)
Transaction lifecycle (signing, submission)
Session management (expiration)

Example:

kit.events.addListener { event ->
    when (event) {
        is SmartAccountEvent.WalletConnected ->
            println("Connected to ${event.contractId}")
        is SmartAccountEvent.TransactionSubmitted ->
            println("Transaction ${event.hash} submitted")
        else -> {}
    }
}

Inheritors

Types

CredentialCreated

data class CredentialCreated(val credential: StoredCredential) : SmartAccountEvent

Emitted when a new credential is created (passkey registered).

CredentialDeleted

data class CredentialDeleted(val credentialId: String) : SmartAccountEvent

Emitted when a credential is deleted from storage.

HeadlessConnected

data class HeadlessConnected(val contractId: String) : SmartAccountEvent

Emitted when a wallet is connected headlessly (by contract address only, with no passkey credential). Used by backends and autonomous signers that operate via the multi-signer / external-signer pipeline.

SessionExpired

data class SessionExpired(val contractId: String, val credentialId: String) : SmartAccountEvent

Emitted when a session expires during connection attempt.

TransactionSigned

data class TransactionSigned(val contractId: String, val credentialId: String?) : SmartAccountEvent

Emitted when a transaction is signed.

TransactionSubmitted

data class TransactionSubmitted(val hash: String, val success: Boolean) : SmartAccountEvent

Emitted when a transaction is submitted to the network.

WalletConnected

data class WalletConnected(val contractId: String, val credentialId: String) : SmartAccountEvent

Emitted when a wallet is connected.

WalletDisconnected

data class WalletDisconnected(val contractId: String) : SmartAccountEvent

Emitted when a wallet is disconnected.