fraud

type AckResp struct {
	actor.BaseMessage
}

type Msg interface {
	actor.Message
	// contains filtered or unexported methods
}

type Resp interface {
	actor.Message
	// contains filtered or unexported methods
}

type SpendObservedMsg struct {
	actor.BaseMessage

	// Outpoint is the watched outpoint that was spent.
	Outpoint wire.OutPoint

	// SpendingTxid is the transaction that spent Outpoint.
	SpendingTxid chainhash.Hash

	// SpendingTx is the full spending transaction. Its witness is what
	// establishes which taproot path the spend took, which is the only
	// way to tell the operator's legitimate batch sweep apart from a
	// sender materializing ancestry.
	SpendingTx *wire.MsgTx

	// SpenderInputIndex is the input of SpendingTx that consumes Outpoint.
	SpenderInputIndex uint32

	// Height is the confirmation height of SpendingTxid.
	Height int32
}

type TrackVTXOsRequest struct {
	actor.BaseMessage

	// VTXOs are locally materialized descriptors to consider for tracking.
	VTXOs []*vtxo.Descriptor
}

type TrackVTXOsResp struct {
	actor.BaseMessage

	// Tracked is the number of descriptors that resulted in active watches.
	Tracked int
}

type UntrackRequest struct {
	actor.BaseMessage

	// TargetOutpoint identifies the no-longer-live target VTXO.
	TargetOutpoint wire.OutPoint
}

type UntrackResp struct {
	actor.BaseMessage

	// Removed reports whether an active target was removed.
	Removed bool
}

type WatchPlan struct {
	// TargetOutpoint is the VTXO to unroll if any watched ancestor spends.
	TargetOutpoint wire.OutPoint

	// Watches are the ancestor outpoints that indicate materialization has
	// started.
	Watches []WatchPoint
}

type WatchPoint struct {
	// Outpoint is the ancestor output to watch for a spend.
	Outpoint wire.OutPoint

	// PkScript is the script committed to Outpoint.
	PkScript []byte

	// HeightHint is the earliest plausible spend height.
	HeightHint uint32

	// SweepLeafHash is the tap hash of the operator's unilateral-CSV
	// timeout leaf committed in this output's taproot. A spend that
	// reveals exactly this leaf is the operator's legitimate batch sweep
	// rather than a sender materializing ancestry, so it is what
	// distinguishes the two. Empty when the tree carries no sweep script
	// (connector trees), in which case no spend can be attributed to the
	// operator and every spend escalates.
	SweepLeafHash []byte
}

type WatcherActor struct {
	// contains filtered or unexported fields
}

type WatcherConfig struct {
	// ChainSource provides passive ancestor spend watches.
	ChainSource actor.ActorRef[
		chainsource.ChainSourceMsg, chainsource.ChainSourceResp,
	]

	// VTXOManagerRef drives affected targets into unilateral exit through
	// the VTXO manager's single admission gate. The manager transitions
	// the VTXO to UnilateralExitState (persisting it out of the live set)
	// and emits the chain-resolver notification that starts the durable
	// unroll job under TriggerFraudSpend, so fraud escalation converges on
	// the same path as manual and critical-expiry exits rather than
	// admitting the registry job behind the manager's back.
	VTXOManagerRef actor.ActorRef[vtxo.ManagerMsg, vtxo.ManagerResp]

	// Log is an optional logger.
	Log fn.Option[btclog.Logger]

	// MailboxSize overrides the watcher's actor mailbox capacity.
	// Zero or negative applies defaultWatcherMailboxSize. Sized to
	// absorb a burst of per-target spend notifications during a
	// chain reorganization without blocking the chainsource
	// publisher.
	MailboxSize int
}