ClaimChannelRefundCommand class
Claim the refund of an expired channel (non-cooperative close).
The client side of a channel holds a fully signed refund from the moment
the server countersigns it, valid from the channel's lockTime on. This
is the command that actually uses it: the library broadcasts the refund
through ARC — a transaction WE broadcast, so ARC has standing to answer
for it (spv-understanding.md) — journals the claim, and records the
refund and its output in the wallet as an unproven receive.
Distinct from ExpireChannelCommand, which journals that a channel passed its lockTime and records the refund WITHOUT broadcasting it (an observer of the expiry may not be the one holding the transaction). The two converge: whichever runs first records the refund, and the other records nothing new.
There is no replace-by-fee on BSV. A broadcast rejected as a double spend is a terminal answer — the response says so and nothing is journaled as claimed; it is never retried at a higher fee.
- Inheritance
-
- Object
- CoordinatorRequest<
ChannelRefundClaimedEvent> - ClaimChannelRefundCommand
Constructors
- ClaimChannelRefundCommand({required String channelId, String? refundTxHex, String? requestId})
Properties
- channelId → String
-
final
- correlationId → String
-
The correlation ID of the message.
no setterinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
-
metadata
→ Map<
String, dynamic> -
The metadata of the message.
no setter
- refundTxHex → String?
-
The refund to claim. Null uses the fully signed refund the channel
holds, which is the normal case; supply one only to name a specific
transaction (it must still spend the channel's funding output, which
the aggregate checks).
final
- replyTimeout → Duration
-
How long
WalletCoordinator.askwaits for the reply when the caller gives no timeout. A request that is still running then is not cancelled: its reply arrives on the event stream later.no setteroverride - replyTo → ActorRef?
-
The actor to reply to.
no setterinherited
- requestId → String
-
Identifies this request; its reply carries it back.
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- timestamp → DateTime
-
The timestamp of the message.
finalinherited
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited