UTXOReceivedEvent class

Event fired when a UTXO is received

Inheritance

Constructors

UTXOReceivedEvent({required String walletId, required String txid, required int vout, required int satoshis, required String scriptPubKey, required String address, int? blockHeight, int? confirmations, UTXOStatus initialStatus = UTXOStatus.pending, int? derivationIndex, Map<String, dynamic>? pluginMetadata, String? counterpartyMarker, String? eventId, DateTime? timestamp, int? version, Map<String, dynamic>? metadata})

Properties

address → String
final
aggregateId → String
The ID of the aggregate this event belongs to
no setterinherited
aggregateType → String
The type of aggregate this event belongs to
no setterinherited
blockHeight → int?
final
confirmations → int?
final
correlationId → String
The correlation ID of the message.
no setterinherited
counterpartyMarker → String?
The app's opaque marker for the counterparty this payment was with (bead libspiffy-cq16, spv-understanding.md "Core Data Management" requirement 5): an Ed25519 identity key, an email address, a peer id, an internal account id. libspiffy stores it and never interprets it. It is not an address and not the address-derived counterparty columns of the read model. Null when the app supplied none, and on rows journaled before the field existed, which replay unchanged: the key is written only when there is a marker, so an event without one serializes exactly as before.
final
derivationIndex → int?
final
eventId → String
Unique identifier for this event Used for deduplication and correlation
no setterinherited
hashCode → int
The hash code for this object.
no setterinherited
initialStatus → UTXOStatus
final
metadata → Map<String, dynamic>
Additional metadata for the event Can include correlation IDs, causation IDs, user context, etc.
no setterinherited
persistableMetadata → Map<String, dynamic>
metadata as it is persisted: transient ActorRef entries removed.
no setterinherited
pluginMetadata → Map<String, dynamic>?
final
replyTo → ActorRef?
The actor to reply to, if a live ActorRef was placed in metadata['replyTo'].
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
satoshis → int
final
scriptPubKey → String
final
timestamp → DateTime
Timestamp when the event occurred
no setterinherited
txid → String
final
typeName → String
Stable identity of this event type in storage.
no setter
version → int
Version/sequence number of this event within its aggregate Used for ordering and optimistic concurrency control
no setterinherited
vout → int
final
walletId → String
ID of the wallet this event belongs to (same as aggregateId)
no setterinherited

Methods

getEventData() → Map<String, dynamic>
Implementation of SerializableEvent.getEventData
inherited
getValidationErrors() → List<String>
Get validation errors Override in subclasses to provide specific error messages
inherited
getWalletEventData() → Map<String, dynamic>
Wallet-specific event data (to be implemented by concrete events)
override
isValid() → bool
Validate the event Override in subclasses for custom validation
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toCbor() → List<int>
Serialize event to CBOR bytes
inherited
toMap() → Map<String, dynamic>
Convert event to a map for serialization Override in subclasses to include event-specific data
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

fromMap(Map<String, dynamic> map) → UTXOReceivedEvent
Create event from a map during deserialization This is a factory method that should be implemented by concrete event classes

Constants

stableTypeName → const String
Journal identifier of this event type. Stored with every event and independent of the class name; never change it (audit 2026-09-14 M8).