From 9602d6cdfc1b38f3b54ad31d91884f5677a4c1fe Mon Sep 17 00:00:00 2001 From: lightclient Date: Tue, 8 Apr 2025 07:21:31 -0600 Subject: [PATCH] core/txpool: add more docs for reserver --- core/txpool/reserver.go | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/core/txpool/reserver.go b/core/txpool/reserver.go index 60e87df608..76ead0f3bb 100644 --- a/core/txpool/reserver.go +++ b/core/txpool/reserver.go @@ -50,12 +50,16 @@ func NewReservationTracker() *ReservationTracker { } } -// NewHandle creates a named handle on the ReservationTracker. +// NewHandle creates a named handle on the ReservationTracker. The handle +// identifies the subpool so ownership of reservations can be determined. func (r *ReservationTracker) NewHandle(id int) *Reserver { return &Reserver{r, id} } -// Reserver is a named handle on ReservationTracker. +// Reserver is a named handle on ReservationTracker. It is held by subpools to +// make reservations for accounts it is tracking. The id is used to determine +// which pool owns an address and disallows non-owners to hold or release +// addresses it doesn't own. type Reserver struct { tracker *ReservationTracker id int