UTXOReceivedEvent class - internals library

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? memo, 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
memo → String?: The payment's note, written by the payer for the payee. libspiffy journals it and returns it and never interprets it. Null when none, and on rows journaled before the field existed, which replay unchanged: the key is written only when there is a memo.
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).