From 8e46b9ea5d294e44035a47fe763c9aba4d07d42e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 20:33:49 +0100
Subject: [PATCH 01/24] paych: API to pre-fund channels

---
 api/api_full.go                    |  6 +-
 api/proxy_gen.go                   |  8 +--
 api/v0api/v1_wrapper.go            |  5 ++
 markets/retrievaladapter/client.go |  2 +-
 node/impl/paych/paych.go           |  6 +-
 paychmgr/cbor_gen.go               | 54 ++++++++++++++++-
 paychmgr/manager.go                |  4 +-
 paychmgr/simple.go                 | 97 +++++++++++++++++++++++++-----
 paychmgr/store.go                  | 19 +++---
 9 files changed, 168 insertions(+), 33 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index cf58a3cc6ee..cf9a1f22ef2 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -689,7 +689,11 @@ type FullNode interface {
 	// MethodGroup: Paych
 	// The Paych methods are for interacting with and managing payment channels
 
-	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt) (*ChannelInfo, error)                     //perm:sign
+	// PaychGet gets or creates a payment channel between address pair
+	//  - If reserve is false, the specified amount will be added to the channel through on-chain send for future use
+	//  - If reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+	//    available, funds will be added through an on-chain message.
+	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (*ChannelInfo, error)       //perm:sign
 	PaychGetWaitReady(context.Context, cid.Cid) (address.Address, error)                                                //perm:sign
 	PaychAvailableFunds(ctx context.Context, ch address.Address) (*ChannelAvailableFunds, error)                        //perm:sign
 	PaychAvailableFundsByFromTo(ctx context.Context, from, to address.Address) (*ChannelAvailableFunds, error)          //perm:sign
diff --git a/api/proxy_gen.go b/api/proxy_gen.go
index e353a7c6e89..9a134cec91b 100644
--- a/api/proxy_gen.go
+++ b/api/proxy_gen.go
@@ -306,7 +306,7 @@ type FullNodeStruct struct {
 
 		PaychCollect func(p0 context.Context, p1 address.Address) (cid.Cid, error) `perm:"sign"`
 
-		PaychGet func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) `perm:"sign"`
+		PaychGet func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) `perm:"sign"`
 
 		PaychGetWaitReady func(p0 context.Context, p1 cid.Cid) (address.Address, error) `perm:"sign"`
 
@@ -2179,14 +2179,14 @@ func (s *FullNodeStub) PaychCollect(p0 context.Context, p1 address.Address) (cid
 	return *new(cid.Cid), ErrNotSupported
 }
 
-func (s *FullNodeStruct) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) {
+func (s *FullNodeStruct) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) {
 	if s.Internal.PaychGet == nil {
 		return nil, ErrNotSupported
 	}
-	return s.Internal.PaychGet(p0, p1, p2, p3)
+	return s.Internal.PaychGet(p0, p1, p2, p3, p4)
 }
 
-func (s *FullNodeStub) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) {
+func (s *FullNodeStub) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) {
 	return nil, ErrNotSupported
 }
 
diff --git a/api/v0api/v1_wrapper.go b/api/v0api/v1_wrapper.go
index 7e0d7a94ab6..605b27b0c9f 100644
--- a/api/v0api/v1_wrapper.go
+++ b/api/v0api/v1_wrapper.go
@@ -337,4 +337,9 @@ func (w *WrapperV1Full) clientRetrieve(ctx context.Context, order RetrievalOrder
 	finish(w.ClientExport(ctx, eref, *ref))
 }
 
+func (w *WrapperV1Full) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
+	// v0 always reserves
+	return w.FullNode.PaychGet(ctx, from, to, amt, true)
+}
+
 var _ FullNode = &WrapperV1Full{}
diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 1bef23e1296..4ed2e905ab4 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -34,7 +34,7 @@ func NewRetrievalClientNode(payAPI payapi.PaychAPI, chainAPI full.ChainAPI, stat
 func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, clientAddress address.Address, minerAddress address.Address, clientFundsAvailable abi.TokenAmount, tok shared.TipSetToken) (address.Address, cid.Cid, error) {
 	// TODO: respect the provided TipSetToken (a serialized TipSetKey) when
 	// querying the chain
-	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable)
+	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable, true)
 	if err != nil {
 		return address.Undef, cid.Undef, err
 	}
diff --git a/node/impl/paych/paych.go b/node/impl/paych/paych.go
index df3b1e3e490..d308f6248ac 100644
--- a/node/impl/paych/paych.go
+++ b/node/impl/paych/paych.go
@@ -22,8 +22,8 @@ type PaychAPI struct {
 	PaychMgr *paychmgr.Manager
 }
 
-func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
-	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt)
+func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (*api.ChannelInfo, error) {
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, reserve)
 	if err != nil {
 		return nil, err
 	}
@@ -55,7 +55,7 @@ func (a *PaychAPI) PaychNewPayment(ctx context.Context, from, to address.Address
 
 	// TODO: Fix free fund tracking in PaychGet
 	// TODO: validate voucher spec before locking funds
-	ch, err := a.PaychGet(ctx, from, to, amount)
+	ch, err := a.PaychGet(ctx, from, to, amount, true)
 	if err != nil {
 		return nil, err
 	}
diff --git a/paychmgr/cbor_gen.go b/paychmgr/cbor_gen.go
index caa4143a257..428c09a9e05 100644
--- a/paychmgr/cbor_gen.go
+++ b/paychmgr/cbor_gen.go
@@ -196,7 +196,7 @@ func (t *ChannelInfo) MarshalCBOR(w io.Writer) error {
 		_, err := w.Write(cbg.CborNull)
 		return err
 	}
-	if _, err := w.Write([]byte{172}); err != nil {
+	if _, err := w.Write([]byte{174}); err != nil {
 		return err
 	}
 
@@ -346,6 +346,38 @@ func (t *ChannelInfo) MarshalCBOR(w io.Writer) error {
 		return err
 	}
 
+	// t.AvailableAmount (big.Int) (struct)
+	if len("AvailableAmount") > cbg.MaxLength {
+		return xerrors.Errorf("Value in field \"AvailableAmount\" was too long")
+	}
+
+	if err := cbg.WriteMajorTypeHeaderBuf(scratch, w, cbg.MajTextString, uint64(len("AvailableAmount"))); err != nil {
+		return err
+	}
+	if _, err := io.WriteString(w, string("AvailableAmount")); err != nil {
+		return err
+	}
+
+	if err := t.AvailableAmount.MarshalCBOR(w); err != nil {
+		return err
+	}
+
+	// t.PendingAvailableAmount (big.Int) (struct)
+	if len("PendingAvailableAmount") > cbg.MaxLength {
+		return xerrors.Errorf("Value in field \"PendingAvailableAmount\" was too long")
+	}
+
+	if err := cbg.WriteMajorTypeHeaderBuf(scratch, w, cbg.MajTextString, uint64(len("PendingAvailableAmount"))); err != nil {
+		return err
+	}
+	if _, err := io.WriteString(w, string("PendingAvailableAmount")); err != nil {
+		return err
+	}
+
+	if err := t.PendingAvailableAmount.MarshalCBOR(w); err != nil {
+		return err
+	}
+
 	// t.PendingAmount (big.Int) (struct)
 	if len("PendingAmount") > cbg.MaxLength {
 		return xerrors.Errorf("Value in field \"PendingAmount\" was too long")
@@ -577,6 +609,26 @@ func (t *ChannelInfo) UnmarshalCBOR(r io.Reader) error {
 					return xerrors.Errorf("unmarshaling t.Amount: %w", err)
 				}
 
+			}
+			// t.AvailableAmount (big.Int) (struct)
+		case "AvailableAmount":
+
+			{
+
+				if err := t.AvailableAmount.UnmarshalCBOR(br); err != nil {
+					return xerrors.Errorf("unmarshaling t.AvailableAmount: %w", err)
+				}
+
+			}
+			// t.PendingAvailableAmount (big.Int) (struct)
+		case "PendingAvailableAmount":
+
+			{
+
+				if err := t.PendingAvailableAmount.UnmarshalCBOR(br); err != nil {
+					return xerrors.Errorf("unmarshaling t.PendingAvailableAmount: %w", err)
+				}
+
 			}
 			// t.PendingAmount (big.Int) (struct)
 		case "PendingAmount":
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index e0fcd7a754c..eed475547aa 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -101,13 +101,13 @@ func (pm *Manager) Stop() error {
 	return nil
 }
 
-func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt) (address.Address, cid.Cid, error) {
+func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (address.Address, cid.Cid, error) {
 	chanAccessor, err := pm.accessorByFromTo(from, to)
 	if err != nil {
 		return address.Undef, cid.Undef, err
 	}
 
-	return chanAccessor.getPaych(ctx, amt)
+	return chanAccessor.getPaych(ctx, amt, reserve)
 }
 
 func (pm *Manager) AvailableFunds(ctx context.Context, ch address.Address) (*api.ChannelAvailableFunds, error) {
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 502338e2953..fd849d3aed7 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"context"
 	"fmt"
+	"sort"
 	"sync"
 
 	"github.com/ipfs/go-cid"
@@ -32,18 +33,20 @@ type fundsReq struct {
 	ctx     context.Context
 	promise chan *paychFundsRes
 	amt     types.BigInt
+	reserve bool
 
 	lk sync.Mutex
 	// merge parent, if this req is part of a merge
 	merge *mergedFundsReq
 }
 
-func newFundsReq(ctx context.Context, amt types.BigInt) *fundsReq {
+func newFundsReq(ctx context.Context, amt types.BigInt, reserve bool) *fundsReq {
 	promise := make(chan *paychFundsRes)
 	return &fundsReq{
 		ctx:     ctx,
 		promise: promise,
 		amt:     amt,
+		reserve: reserve,
 	}
 }
 
@@ -104,6 +107,15 @@ func newMergedFundsReq(reqs []*fundsReq) *mergedFundsReq {
 		r.setMergeParent(m)
 	}
 
+	sort.Slice(m.reqs, func(i, j int) bool {
+		if m.reqs[i].reserve != m.reqs[j].reserve { // non-reserve first
+			return m.reqs[j].reserve
+		}
+
+		// sort by amount asc (reducing latency for smaller requests)
+		return m.reqs[i].amt.LessThan(m.reqs[j].amt)
+	})
+
 	// If the requests were all cancelled while being added, cancel the context
 	// immediately
 	m.checkActive()
@@ -135,18 +147,24 @@ func (m *mergedFundsReq) onComplete(res *paychFundsRes) {
 }
 
 // sum is the sum of the amounts in all requests in the merge
-func (m *mergedFundsReq) sum() types.BigInt {
+func (m *mergedFundsReq) sum() (types.BigInt, types.BigInt) {
 	sum := types.NewInt(0)
+	avail := types.NewInt(0)
+
 	for _, r := range m.reqs {
 		if r.isActive() {
 			sum = types.BigAdd(sum, r.amt)
+			if !r.reserve {
+				avail = types.BigAdd(avail, r.amt)
+			}
 		}
 	}
-	return sum
+
+	return sum, avail
 }
 
 // getPaych ensures that a channel exists between the from and to addresses,
-// and adds the given amount of funds.
+// and reserves (or adds as available) the given amount of funds.
 // If the channel does not exist a create channel message is sent and the
 // message CID is returned.
 // If the channel does exist an add funds message is sent and both the channel
@@ -156,9 +174,9 @@ func (m *mergedFundsReq) sum() types.BigInt {
 // address and the CID of the new add funds message.
 // If an operation returns an error, subsequent waiting operations will still
 // be attempted.
-func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt) (address.Address, cid.Cid, error) {
+func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, reserve bool) (address.Address, cid.Cid, error) {
 	// Add the request to add funds to a queue and wait for the result
-	freq := newFundsReq(ctx, amt)
+	freq := newFundsReq(ctx, amt, reserve)
 	ca.enqueue(ctx, freq)
 	select {
 	case res := <-freq.promise:
@@ -195,14 +213,57 @@ func (ca *channelAccessor) processQueue(ctx context.Context, channelID string) (
 	// For example if there are pending requests for 3, 2, 4 then
 	// amt = 3 + 2 + 4 = 9
 	merged := newMergedFundsReq(ca.fundsReqQueue)
-	amt := merged.sum()
+	amt, avail := merged.sum()
 	if amt.IsZero() {
 		// Note: The amount can be zero if requests are cancelled as we're
 		// building the mergedFundsReq
 		return ca.currentAvailableFunds(ctx, channelID, amt)
 	}
 
-	res := ca.processTask(merged.ctx, amt)
+	{
+		toReserve := types.BigSub(amt, avail)
+		avail := types.NewInt(0)
+
+		// reserve at most what we need
+		ca.mutateChannelInfo(ctx, channelID, func(ci *ChannelInfo) {
+			avail = ci.AvailableAmount
+			if avail.GreaterThan(toReserve) {
+				avail = toReserve
+			}
+			ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
+		})
+
+		used := types.NewInt(0)
+
+		next := 0
+		for i, r := range merged.reqs {
+			if !r.reserve {
+				// non-reserving request are put after reserving requests, so we are done here
+				break
+			}
+
+			if r.amt.GreaterThan(types.BigSub(avail, used)) {
+				// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
+			}
+
+			// don't try to fill inactive requests
+			if !r.isActive() {
+				continue
+			}
+
+			used = types.BigAdd(used, r.amt)
+			r.onComplete(&paychFundsRes{})
+			next = i + 1
+		}
+		merged.reqs = merged.reqs[next:]
+
+		// return any unused reserved funds (e.g. from cancelled requests)
+		ca.mutateChannelInfo(ctx, channelID, func(ci *ChannelInfo) {
+			ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
+		})
+	}
+
+	res := ca.processTask(merged.ctx, amt, avail)
 
 	// If the task is waiting on an external event (eg something to appear on
 	// chain) it will return nil
@@ -333,7 +394,7 @@ func (ca *channelAccessor) currentAvailableFunds(ctx context.Context, channelID
 // Note that processTask may be called repeatedly in the same state, and should
 // return nil if there is no state change to be made (eg when waiting for a
 // message to be confirmed on chain)
-func (ca *channelAccessor) processTask(ctx context.Context, amt types.BigInt) *paychFundsRes {
+func (ca *channelAccessor) processTask(ctx context.Context, amt, avail types.BigInt) *paychFundsRes {
 	// Get the payment channel for the from/to addresses.
 	// Note: It's ok if we get ErrChannelNotTracked. It just means we need to
 	// create a channel.
@@ -344,7 +405,7 @@ func (ca *channelAccessor) processTask(ctx context.Context, amt types.BigInt) *p
 
 	// If a channel has not yet been created, create one.
 	if channelInfo == nil {
-		mcid, err := ca.createPaych(ctx, amt)
+		mcid, err := ca.createPaych(ctx, amt, avail)
 		if err != nil {
 			return &paychFundsRes{err: err}
 		}
@@ -368,7 +429,7 @@ func (ca *channelAccessor) processTask(ctx context.Context, amt types.BigInt) *p
 
 	// We need to add more funds, so send an add funds message to
 	// cover the amount for this request
-	mcid, err := ca.addFunds(ctx, channelInfo, amt)
+	mcid, err := ca.addFunds(ctx, channelInfo, amt, avail)
 	if err != nil {
 		return &paychFundsRes{err: err}
 	}
@@ -376,7 +437,7 @@ func (ca *channelAccessor) processTask(ctx context.Context, amt types.BigInt) *p
 }
 
 // createPaych sends a message to create the channel and returns the message cid
-func (ca *channelAccessor) createPaych(ctx context.Context, amt types.BigInt) (cid.Cid, error) {
+func (ca *channelAccessor) createPaych(ctx context.Context, amt, avail types.BigInt) (cid.Cid, error) {
 	mb, err := ca.messageBuilder(ctx, ca.from)
 	if err != nil {
 		return cid.Undef, err
@@ -393,7 +454,7 @@ func (ca *channelAccessor) createPaych(ctx context.Context, amt types.BigInt) (c
 	mcid := smsg.Cid()
 
 	// Create a new channel in the store
-	ci, err := ca.store.CreateChannel(ctx, ca.from, ca.to, mcid, amt)
+	ci, err := ca.store.CreateChannel(ctx, ca.from, ca.to, mcid, amt, avail)
 	if err != nil {
 		log.Errorf("creating channel: %s", err)
 		return cid.Undef, err
@@ -452,7 +513,9 @@ func (ca *channelAccessor) waitPaychCreateMsg(ctx context.Context, channelID str
 	ca.mutateChannelInfo(ctx, channelID, func(channelInfo *ChannelInfo) {
 		channelInfo.Channel = &decodedReturn.RobustAddress
 		channelInfo.Amount = channelInfo.PendingAmount
+		channelInfo.AvailableAmount = channelInfo.PendingAvailableAmount
 		channelInfo.PendingAmount = big.NewInt(0)
+		channelInfo.PendingAvailableAmount = big.NewInt(0)
 		channelInfo.CreateMsg = nil
 	})
 
@@ -460,7 +523,7 @@ func (ca *channelAccessor) waitPaychCreateMsg(ctx context.Context, channelID str
 }
 
 // addFunds sends a message to add funds to the channel and returns the message cid
-func (ca *channelAccessor) addFunds(ctx context.Context, channelInfo *ChannelInfo, amt types.BigInt) (*cid.Cid, error) {
+func (ca *channelAccessor) addFunds(ctx context.Context, channelInfo *ChannelInfo, amt, avail types.BigInt) (*cid.Cid, error) {
 	msg := &types.Message{
 		To:     *channelInfo.Channel,
 		From:   channelInfo.Control,
@@ -477,6 +540,7 @@ func (ca *channelAccessor) addFunds(ctx context.Context, channelInfo *ChannelInf
 	// Store the add funds message CID on the channel
 	ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
 		ci.PendingAmount = amt
+		ci.PendingAvailableAmount = avail
 		ci.AddFundsMsg = &mcid
 	})
 
@@ -492,6 +556,8 @@ func (ca *channelAccessor) addFunds(ctx context.Context, channelInfo *ChannelInf
 	return &mcid, nil
 }
 
+// TODO func (ca *channelAccessor) freeFunds(ctx context.Context, channelInfo *ChannelInfo, amt, avail types.BigInt) (*cid.Cid, error) {
+
 // waitForAddFundsMsg waits for mcid to appear on chain and returns error, if any
 func (ca *channelAccessor) waitForAddFundsMsg(ctx context.Context, channelID string, mcid cid.Cid) {
 	err := ca.waitAddFundsMsg(ctx, channelID, mcid)
@@ -514,6 +580,7 @@ func (ca *channelAccessor) waitAddFundsMsg(ctx context.Context, channelID string
 
 		ca.mutateChannelInfo(ctx, channelID, func(channelInfo *ChannelInfo) {
 			channelInfo.PendingAmount = big.NewInt(0)
+			channelInfo.PendingAvailableAmount = big.NewInt(0)
 			channelInfo.AddFundsMsg = nil
 		})
 
@@ -526,7 +593,9 @@ func (ca *channelAccessor) waitAddFundsMsg(ctx context.Context, channelID string
 	// Store updated amount
 	ca.mutateChannelInfo(ctx, channelID, func(channelInfo *ChannelInfo) {
 		channelInfo.Amount = types.BigAdd(channelInfo.Amount, channelInfo.PendingAmount)
+		channelInfo.AvailableAmount = types.BigAdd(channelInfo.AvailableAmount, channelInfo.PendingAvailableAmount)
 		channelInfo.PendingAmount = big.NewInt(0)
+		channelInfo.PendingAvailableAmount = big.NewInt(0)
 		channelInfo.AddFundsMsg = nil
 	})
 
diff --git a/paychmgr/store.go b/paychmgr/store.go
index 62849e6bedd..bbc549b862c 100644
--- a/paychmgr/store.go
+++ b/paychmgr/store.go
@@ -74,6 +74,10 @@ type ChannelInfo struct {
 	// has locally been added to the channel. It should reflect the channel's
 	// Balance on chain as long as all operations occur on the same datastore.
 	Amount types.BigInt
+	// AvailableAmount indicates how much afil is non-reverved
+	AvailableAmount types.BigInt
+	// PendingAvailableAmount is available amount that we're awaiting confirmation of
+	PendingAvailableAmount types.BigInt
 	// PendingAmount is the amount that we're awaiting confirmation of
 	PendingAmount types.BigInt
 	// CreateMsg is the CID of a pending create message (while waiting for confirmation)
@@ -416,14 +420,15 @@ func (ps *Store) ByChannelID(ctx context.Context, channelID string) (*ChannelInf
 }
 
 // CreateChannel creates an outbound channel for the given from / to
-func (ps *Store) CreateChannel(ctx context.Context, from address.Address, to address.Address, createMsgCid cid.Cid, amt types.BigInt) (*ChannelInfo, error) {
+func (ps *Store) CreateChannel(ctx context.Context, from address.Address, to address.Address, createMsgCid cid.Cid, amt, avail types.BigInt) (*ChannelInfo, error) {
 	ci := &ChannelInfo{
-		Direction:     DirOutbound,
-		NextLane:      0,
-		Control:       from,
-		Target:        to,
-		CreateMsg:     &createMsgCid,
-		PendingAmount: amt,
+		Direction:              DirOutbound,
+		NextLane:               0,
+		Control:                from,
+		Target:                 to,
+		CreateMsg:              &createMsgCid,
+		PendingAmount:          amt,
+		PendingAvailableAmount: avail,
 	}
 
 	// Save the new channel

From 97151138984b312d64d2679fa8d6d536ff84abaa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 21:34:27 +0100
Subject: [PATCH 02/24] paych: Test pre-funding

---
 api/mocks/mock_full.go                      |   8 +-
 documentation/en/api-v1-unstable-methods.md |   9 +-
 paychmgr/paychget_test.go                   | 319 ++++++++++++++++++--
 paychmgr/paychvoucherfunds_test.go          |   4 +-
 paychmgr/settle_test.go                     |   4 +-
 paychmgr/simple.go                          | 101 ++++---
 6 files changed, 360 insertions(+), 85 deletions(-)

diff --git a/api/mocks/mock_full.go b/api/mocks/mock_full.go
index e985a794d0c..c745f26fcd4 100644
--- a/api/mocks/mock_full.go
+++ b/api/mocks/mock_full.go
@@ -1976,18 +1976,18 @@ func (mr *MockFullNodeMockRecorder) PaychCollect(arg0, arg1 interface{}) *gomock
 }
 
 // PaychGet mocks base method.
-func (m *MockFullNode) PaychGet(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int) (*api.ChannelInfo, error) {
+func (m *MockFullNode) PaychGet(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int, arg4 bool) (*api.ChannelInfo, error) {
 	m.ctrl.T.Helper()
-	ret := m.ctrl.Call(m, "PaychGet", arg0, arg1, arg2, arg3)
+	ret := m.ctrl.Call(m, "PaychGet", arg0, arg1, arg2, arg3, arg4)
 	ret0, _ := ret[0].(*api.ChannelInfo)
 	ret1, _ := ret[1].(error)
 	return ret0, ret1
 }
 
 // PaychGet indicates an expected call of PaychGet.
-func (mr *MockFullNodeMockRecorder) PaychGet(arg0, arg1, arg2, arg3 interface{}) *gomock.Call {
+func (mr *MockFullNodeMockRecorder) PaychGet(arg0, arg1, arg2, arg3, arg4 interface{}) *gomock.Call {
 	mr.mock.ctrl.T.Helper()
-	return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "PaychGet", reflect.TypeOf((*MockFullNode)(nil).PaychGet), arg0, arg1, arg2, arg3)
+	return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "PaychGet", reflect.TypeOf((*MockFullNode)(nil).PaychGet), arg0, arg1, arg2, arg3, arg4)
 }
 
 // PaychGetWaitReady mocks base method.
diff --git a/documentation/en/api-v1-unstable-methods.md b/documentation/en/api-v1-unstable-methods.md
index a5fdd999429..ce0ceadcdfd 100644
--- a/documentation/en/api-v1-unstable-methods.md
+++ b/documentation/en/api-v1-unstable-methods.md
@@ -4509,7 +4509,11 @@ Response:
 ```
 
 ### PaychGet
-There are not yet any comments for this method.
+PaychGet gets or creates a payment channel between address pair
+ - If reserve is false, the specified amount will be added to the channel through on-chain send for future use
+ - If reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+   available, funds will be added through an on-chain message.
+
 
 Perms: sign
 
@@ -4518,7 +4522,8 @@ Inputs:
 [
   "f01234",
   "f01234",
-  "0"
+  "0",
+  true
 ]
 ```
 
diff --git a/paychmgr/paychget_test.go b/paychmgr/paychget_test.go
index 2aacaf6c287..31207917721 100644
--- a/paychmgr/paychget_test.go
+++ b/paychmgr/paychget_test.go
@@ -55,7 +55,7 @@ func TestPaychGetCreateChannelMsg(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	ch, mcid, err := mgr.GetPaych(ctx, from, to, amt)
+	ch, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 	require.Equal(t, address.Undef, ch)
 
@@ -83,7 +83,7 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Should have no channels yet (message sent but channel not created)
@@ -100,7 +100,7 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 
 		// 2. Request add funds - should block until create channel has completed
 		amt2 := big.NewInt(5)
-		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2)
+		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
 
 		// 4. This GetPaych should return after create channel from first
 		//    GetPaych completes
@@ -154,6 +154,74 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 	<-done
 }
 
+func TestPaychGetCreatePrefundedChannelThenAddFunds(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	amt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, false)
+	require.NoError(t, err)
+
+	// Should have no channels yet (message sent but channel not created)
+	cis, err := mgr.ListChannels(ctx)
+	require.NoError(t, err)
+	require.Len(t, cis, 0)
+
+	// 1. Set up create channel response (sent in response to WaitForMsg())
+	response := testChannelResponse(t, ch)
+
+	done := make(chan struct{})
+	go func() {
+		defer close(done)
+
+		// 2. Request add funds - shouldn't block
+		amt2 := big.NewInt(3)
+		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
+
+		// 4. This GetPaych should return after create channel from first
+		//    GetPaych completes
+		require.NoError(t, err)
+
+		// Expect the channel to be the same
+		require.Equal(t, ch, ch2)
+		require.Equal(t, cid.Undef, addFundsMsgCid)
+
+		// Should have one channel, whose address is the channel that was created
+		cis, err := mgr.ListChannels(ctx)
+		require.NoError(t, err)
+		require.Len(t, cis, 1)
+		require.Equal(t, ch, cis[0])
+
+		// Amount should be amount sent to first GetPaych (to create
+		// channel).
+		// PendingAmount should be zero, AvailableAmount should be Amount minus what we requested
+
+		ci, err := mgr.GetChannelInfo(ctx, ch)
+		require.NoError(t, err)
+		require.EqualValues(t, 10, ci.Amount.Int64())
+		require.EqualValues(t, 0, ci.PendingAmount.Int64())
+		require.EqualValues(t, 7, ci.AvailableAmount.Int64())
+		require.Nil(t, ci.CreateMsg)
+		require.Nil(t, ci.AddFundsMsg)
+	}()
+
+	// 3. Send create channel response
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	<-done
+}
+
 // TestPaychGetCreateChannelWithErrorThenCreateAgain tests that if an
 // operation is queued up behind a create channel operation, and the create
 // channel fails, then the waiting operation can succeed.
@@ -172,7 +240,7 @@ func TestPaychGetCreateChannelWithErrorThenCreateAgain(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// 1. Set up create channel response (sent in response to WaitForMsg())
@@ -190,7 +258,7 @@ func TestPaychGetCreateChannelWithErrorThenCreateAgain(t *testing.T) {
 		//    Because first channel create fails, this request
 		//    should be for channel create again.
 		amt2 := big.NewInt(5)
-		ch2, mcid2, err := mgr.GetPaych(ctx, from, to, amt2)
+		ch2, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
 		require.NoError(t, err)
 		require.Equal(t, address.Undef, ch2)
 
@@ -237,7 +305,7 @@ func TestPaychGetRecoverAfterError(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Send error create channel response
@@ -248,7 +316,7 @@ func TestPaychGetRecoverAfterError(t *testing.T) {
 
 	// Send create message for a channel again
 	amt2 := big.NewInt(7)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -289,7 +357,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -298,7 +366,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send add funds message for channel
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
 	require.NoError(t, err)
 
 	// Send error add funds response
@@ -325,7 +393,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send add funds message for channel again
 	amt3 := big.NewInt(2)
-	_, mcid3, err := mgr.GetPaych(ctx, from, to, amt3)
+	_, mcid3, err := mgr.GetPaych(ctx, from, to, amt3, true)
 	require.NoError(t, err)
 
 	// Send success add funds response
@@ -370,7 +438,7 @@ func TestPaychGetRestartAfterCreateChannelMsg(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Simulate shutting down system
@@ -397,7 +465,7 @@ func TestPaychGetRestartAfterCreateChannelMsg(t *testing.T) {
 
 		// 2. Request add funds - should block until create channel has completed
 		amt2 := big.NewInt(5)
-		ch2, addFundsMsgCid, err := mgr2.GetPaych(ctx, from, to, amt2)
+		ch2, addFundsMsgCid, err := mgr2.GetPaych(ctx, from, to, amt2, true)
 
 		// 4. This GetPaych should return after create channel from first
 		//    GetPaych completes
@@ -449,7 +517,7 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -458,7 +526,7 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 
 	// Send add funds message for channel
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
 	require.NoError(t, err)
 
 	// Simulate shutting down system
@@ -512,7 +580,7 @@ func TestPaychGetWait(t *testing.T) {
 
 	// 1. Get
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	expch := tutils.NewIDAddr(t, 100)
@@ -535,7 +603,7 @@ func TestPaychGetWait(t *testing.T) {
 
 	// Request add funds
 	amt2 := big.NewInt(15)
-	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2)
+	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
 	require.NoError(t, err)
 
 	go func() {
@@ -569,7 +637,7 @@ func TestPaychGetWaitErr(t *testing.T) {
 
 	// 1. Create channel
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	done := make(chan address.Address)
@@ -615,7 +683,7 @@ func TestPaychGetWaitCtx(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// When the context is cancelled, should unblock wait
@@ -646,7 +714,7 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -664,7 +732,103 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1)
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, true)
+		require.NoError(t, err)
+	}()
+
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds again - should merge with waiting add funds request
+		var err error
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		require.NoError(t, err)
+	}()
+	// Wait for add funds requests to be queued up
+	waitForQueueSize(t, mgr, from, to, 2)
+
+	// Send create channel response
+	response := testChannelResponse(t, ch)
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	// Wait for create channel response
+	chres, err := mgr.GetPaychWaitReady(ctx, createMsgCid)
+	require.NoError(t, err)
+	require.Equal(t, ch, chres)
+
+	// Wait for add funds requests to be sent
+	addFundsSent.Wait()
+
+	// Expect add funds requests to have same channel as create channel and
+	// same message cid as each other (because they should have been merged)
+	require.Equal(t, ch, addFundsCh1)
+	require.Equal(t, ch, addFundsCh2)
+	require.Equal(t, addFundsMcid1, addFundsMcid2)
+
+	// Send success add funds response
+	mock.receiveMsgResponse(addFundsMcid1, types.MessageReceipt{
+		ExitCode: 0,
+		Return:   []byte{},
+	})
+
+	// Wait for add funds response
+	addFundsCh, err := mgr.GetPaychWaitReady(ctx, addFundsMcid1)
+	require.NoError(t, err)
+	require.Equal(t, ch, addFundsCh)
+
+	// Make sure that one create channel message and one add funds message was
+	// sent
+	require.Equal(t, 2, mock.pushedMessageCount())
+
+	// Check create message amount is correct
+	createMsg := mock.pushedMessages(createMsgCid)
+	require.Equal(t, from, createMsg.Message.From)
+	require.Equal(t, lotusinit.Address, createMsg.Message.To)
+	require.Equal(t, createAmt, createMsg.Message.Value)
+
+	// Check merged add funds amount is the sum of the individual
+	// amounts
+	addFundsMsg := mock.pushedMessages(addFundsMcid1)
+	require.Equal(t, from, addFundsMsg.Message.From)
+	require.Equal(t, ch, addFundsMsg.Message.To)
+	require.Equal(t, types.BigAdd(addFundsAmt1, addFundsAmt2), addFundsMsg.Message.Value)
+}
+
+func TestPaychGetMergePrefundAndReserve(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	createAmt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	require.NoError(t, err)
+
+	// Queue up two add funds requests behind create channel
+	var addFundsSent sync.WaitGroup
+	addFundsSent.Add(2)
+
+	addFundsAmt1 := big.NewInt(5) // 1 prefunds
+	addFundsAmt2 := big.NewInt(3) // 2 reserves
+	var addFundsCh1 address.Address
+	var addFundsCh2 address.Address
+	var addFundsMcid1 cid.Cid
+	var addFundsMcid2 cid.Cid
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds - should block until create channel has completed
+		var err error
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, false)
 		require.NoError(t, err)
 	}()
 
@@ -673,7 +837,7 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -726,6 +890,103 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 	require.Equal(t, types.BigAdd(addFundsAmt1, addFundsAmt2), addFundsMsg.Message.Value)
 }
 
+func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	createAmt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, false)
+	require.NoError(t, err)
+
+	// Queue up two add funds requests behind create channel
+	var addFundsSent sync.WaitGroup
+	addFundsSent.Add(2)
+
+	addFundsAmt1 := big.NewInt(5) // 1 prefunds
+	addFundsAmt2 := big.NewInt(3) // 2 reserves
+	var addFundsCh1 address.Address
+	var addFundsCh2 address.Address
+	var addFundsMcid1 cid.Cid
+	var addFundsMcid2 cid.Cid
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds - should block until create channel has completed
+		var err error
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, false)
+		require.NoError(t, err)
+	}()
+
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds again - should merge with waiting add funds request
+		var err error
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		require.NoError(t, err)
+	}()
+	// Wait for add funds requests to be queued up
+	waitForQueueSize(t, mgr, from, to, 2)
+
+	// Send create channel response
+	response := testChannelResponse(t, ch)
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	// Wait for create channel response
+	chres, err := mgr.GetPaychWaitReady(ctx, createMsgCid)
+	require.NoError(t, err)
+	require.Equal(t, ch, chres)
+
+	// Wait for add funds requests to be sent
+	addFundsSent.Wait()
+
+	// Expect add funds requests to have same channel as create channel and
+	// same message cid as each other (because they should have been merged)
+	require.Equal(t, ch, addFundsCh1)
+	require.Equal(t, ch, addFundsCh2)
+	require.NotEqual(t, cid.Undef, addFundsMcid1)
+	require.Equal(t, cid.Undef, addFundsMcid2)
+
+	// Send success add funds response
+	mock.receiveMsgResponse(addFundsMcid1, types.MessageReceipt{
+		ExitCode: 0,
+		Return:   []byte{},
+	})
+
+	// Wait for add funds response
+	addFundsCh, err := mgr.GetPaychWaitReady(ctx, addFundsMcid1)
+	require.NoError(t, err)
+	require.Equal(t, ch, addFundsCh)
+
+	// Make sure that one create channel message and one add funds message was
+	// sent
+	require.Equal(t, 2, mock.pushedMessageCount())
+
+	// Check create message amount is correct
+	createMsg := mock.pushedMessages(createMsgCid)
+	require.Equal(t, from, createMsg.Message.From)
+	require.Equal(t, lotusinit.Address, createMsg.Message.To)
+	require.Equal(t, createAmt, createMsg.Message.Value)
+
+	// Check merged add funds amount is the sum of the individual
+	// amounts
+	addFundsMsg := mock.pushedMessages(addFundsMcid1)
+	require.Equal(t, from, addFundsMsg.Message.From)
+	require.Equal(t, ch, addFundsMsg.Message.To)
+	require.Equal(t, addFundsAmt1, addFundsMsg.Message.Value)
+}
+
 // TestPaychGetMergeAddFundsCtxCancelOne tests that when a queued add funds
 // request is cancelled, its amount is removed from the total merged add funds
 func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
@@ -744,7 +1005,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -761,7 +1022,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 		defer addFundsSent.Done()
 
 		// Request add funds - should block until create channel has completed
-		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, addFundsAmt1)
+		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, addFundsAmt1, true)
 	}()
 
 	go func() {
@@ -769,7 +1030,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -841,7 +1102,7 @@ func TestPaychGetMergeAddFundsCtxCancelAll(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -856,14 +1117,14 @@ func TestPaychGetMergeAddFundsCtxCancelAll(t *testing.T) {
 		defer addFundsSent.Done()
 
 		// Request add funds - should block until create channel has completed
-		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, big.NewInt(5))
+		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, big.NewInt(5), true)
 	}()
 
 	go func() {
 		defer addFundsSent.Done()
 
 		// Request add funds again - should merge with waiting add funds request
-		_, _, addFundsErr2 = mgr.GetPaych(addFundsCtx2, from, to, big.NewInt(3))
+		_, _, addFundsErr2 = mgr.GetPaych(addFundsCtx2, from, to, big.NewInt(3), true)
 	}()
 	// Wait for add funds requests to be queued up
 	waitForQueueSize(t, mgr, from, to, 2)
@@ -928,7 +1189,7 @@ func TestPaychAvailableFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
 	require.NoError(t, err)
 
 	// Available funds should reflect create channel message sent
@@ -953,7 +1214,7 @@ func TestPaychAvailableFunds(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		_, addFundsMcid, err = mgr.GetPaych(ctx, from, to, addFundsAmt)
+		_, addFundsMcid, err = mgr.GetPaych(ctx, from, to, addFundsAmt, true)
 		require.NoError(t, err)
 	}()
 
diff --git a/paychmgr/paychvoucherfunds_test.go b/paychmgr/paychvoucherfunds_test.go
index f83a7cd623e..d13a5815eb4 100644
--- a/paychmgr/paychvoucherfunds_test.go
+++ b/paychmgr/paychvoucherfunds_test.go
@@ -46,7 +46,7 @@ func TestPaychAddVoucherAfterAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
 	require.NoError(t, err)
 
 	// Send create channel response
@@ -82,7 +82,7 @@ func TestPaychAddVoucherAfterAddFunds(t *testing.T) {
 	require.Equal(t, res.Shortfall, excessAmt)
 
 	// Add funds so as to cover the voucher shortfall
-	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, excessAmt)
+	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, excessAmt, true)
 	require.NoError(t, err)
 
 	// Trigger add funds confirmation
diff --git a/paychmgr/settle_test.go b/paychmgr/settle_test.go
index 43a0062000b..e674d63f4e0 100644
--- a/paychmgr/settle_test.go
+++ b/paychmgr/settle_test.go
@@ -29,7 +29,7 @@ func TestPaychSettle(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
 	require.NoError(t, err)
 
 	// Send channel create response
@@ -49,7 +49,7 @@ func TestPaychSettle(t *testing.T) {
 	// (should create a new channel because the previous channel
 	// is settling)
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
 	require.NoError(t, err)
 	require.NotEqual(t, cid.Undef, mcid2)
 
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index fd849d3aed7..b9c70a7f3fd 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -109,7 +109,7 @@ func newMergedFundsReq(reqs []*fundsReq) *mergedFundsReq {
 
 	sort.Slice(m.reqs, func(i, j int) bool {
 		if m.reqs[i].reserve != m.reqs[j].reserve { // non-reserve first
-			return m.reqs[j].reserve
+			return m.reqs[i].reserve
 		}
 
 		// sort by amount asc (reducing latency for smaller requests)
@@ -220,50 +220,7 @@ func (ca *channelAccessor) processQueue(ctx context.Context, channelID string) (
 		return ca.currentAvailableFunds(ctx, channelID, amt)
 	}
 
-	{
-		toReserve := types.BigSub(amt, avail)
-		avail := types.NewInt(0)
-
-		// reserve at most what we need
-		ca.mutateChannelInfo(ctx, channelID, func(ci *ChannelInfo) {
-			avail = ci.AvailableAmount
-			if avail.GreaterThan(toReserve) {
-				avail = toReserve
-			}
-			ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
-		})
-
-		used := types.NewInt(0)
-
-		next := 0
-		for i, r := range merged.reqs {
-			if !r.reserve {
-				// non-reserving request are put after reserving requests, so we are done here
-				break
-			}
-
-			if r.amt.GreaterThan(types.BigSub(avail, used)) {
-				// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
-			}
-
-			// don't try to fill inactive requests
-			if !r.isActive() {
-				continue
-			}
-
-			used = types.BigAdd(used, r.amt)
-			r.onComplete(&paychFundsRes{})
-			next = i + 1
-		}
-		merged.reqs = merged.reqs[next:]
-
-		// return any unused reserved funds (e.g. from cancelled requests)
-		ca.mutateChannelInfo(ctx, channelID, func(ci *ChannelInfo) {
-			ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
-		})
-	}
-
-	res := ca.processTask(merged.ctx, amt, avail)
+	res := ca.processTask(merged, amt, avail)
 
 	// If the task is waiting on an external event (eg something to appear on
 	// chain) it will return nil
@@ -394,7 +351,9 @@ func (ca *channelAccessor) currentAvailableFunds(ctx context.Context, channelID
 // Note that processTask may be called repeatedly in the same state, and should
 // return nil if there is no state change to be made (eg when waiting for a
 // message to be confirmed on chain)
-func (ca *channelAccessor) processTask(ctx context.Context, amt, avail types.BigInt) *paychFundsRes {
+func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.BigInt) *paychFundsRes {
+	ctx := merged.ctx
+
 	// Get the payment channel for the from/to addresses.
 	// Note: It's ok if we get ErrChannelNotTracked. It just means we need to
 	// create a channel.
@@ -427,6 +386,56 @@ func (ca *channelAccessor) processTask(ctx context.Context, amt, avail types.Big
 		return nil
 	}
 
+	{
+		toReserve := types.BigSub(amt, avail)
+		avail := types.NewInt(0)
+
+		// reserve at most what we need
+		ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
+			avail = ci.AvailableAmount
+			if avail.GreaterThan(toReserve) {
+				avail = toReserve
+			}
+			ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
+		})
+
+		used := types.NewInt(0)
+
+		next := 0
+		for i, r := range merged.reqs {
+			if !r.reserve {
+				// non-reserving request are put after reserving requests, so we are done here
+				break
+			}
+
+			if r.amt.GreaterThan(types.BigSub(avail, used)) {
+				// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
+				break
+			}
+
+			// don't try to fill inactive requests
+			if !r.isActive() {
+				continue
+			}
+
+			used = types.BigAdd(used, r.amt)
+			r.onComplete(&paychFundsRes{channel: *channelInfo.Channel})
+			next = i + 1
+		}
+		merged.reqs = merged.reqs[next:]
+
+		// return any unused reserved funds (e.g. from cancelled requests)
+		ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
+			ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
+		})
+
+		amt = types.BigSub(amt, used)
+	}
+
+	if amt.LessThanEqual(types.NewInt(0)) {
+		return nil
+	}
+
 	// We need to add more funds, so send an add funds message to
 	// cover the amount for this request
 	mcid, err := ca.addFunds(ctx, channelInfo, amt, avail)

From 2e76375e8aa230a2a2182c0737ec6eb63b3b1896 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 21:41:57 +0100
Subject: [PATCH 03/24] Fix paych itests

---
 itests/paych_api_test.go             | 2 +-
 testplans/lotus-soup/deals_e2e.go    | 4 ++--
 testplans/lotus-soup/paych/stress.go | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/itests/paych_api_test.go b/itests/paych_api_test.go
index 49c23545b44..fb2233d9043 100644
--- a/itests/paych_api_test.go
+++ b/itests/paych_api_test.go
@@ -58,7 +58,7 @@ func TestPaymentChannelsAPI(t *testing.T) {
 	require.NoError(t, err)
 
 	channelAmt := int64(7000)
-	channelInfo, err := paymentCreator.PaychGet(ctx, createrAddr, receiverAddr, abi.NewTokenAmount(channelAmt))
+	channelInfo, err := paymentCreator.PaychGet(ctx, createrAddr, receiverAddr, abi.NewTokenAmount(channelAmt), true)
 	require.NoError(t, err)
 
 	channel, err := paymentCreator.PaychGetWaitReady(ctx, channelInfo.WaitSentinel)
diff --git a/testplans/lotus-soup/deals_e2e.go b/testplans/lotus-soup/deals_e2e.go
index 6737bdae226..bc970350837 100644
--- a/testplans/lotus-soup/deals_e2e.go
+++ b/testplans/lotus-soup/deals_e2e.go
@@ -207,7 +207,7 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 	t.RecordMessage("my balance: %d", balance)
 	t.RecordMessage("creating payment channel; from=%s, to=%s, funds=%d", cl.Wallet.Address, recv.WalletAddr, balance)
 
-	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, balance)
+	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, balance, true)
 	if err != nil {
 		return fmt.Errorf("failed to create payment channel: %w", err)
 	}
@@ -230,7 +230,7 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 	// we wait for 2 confirmations, so we have the assurance the channel is tracked.
 
 	t.RecordMessage("reloading paych; now it should have an address")
-	channel, err = cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, big.Zero())
+	channel, err = cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, big.Zero(), true)
 	if err != nil {
 		return fmt.Errorf("failed to reload payment channel: %w", err)
 	}
diff --git a/testplans/lotus-soup/paych/stress.go b/testplans/lotus-soup/paych/stress.go
index 85246603f0f..e0d324f03e9 100644
--- a/testplans/lotus-soup/paych/stress.go
+++ b/testplans/lotus-soup/paych/stress.go
@@ -124,7 +124,7 @@ func runSender(ctx context.Context, t *testkit.TestEnvironment, clients []*testk
 
 	time.Sleep(20 * time.Second)
 
-	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, channelAmt)
+	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, channelAmt, true)
 	if err != nil {
 		return fmt.Errorf("failed to create payment channel: %w", err)
 	}

From 7a938b2dea63793c35598e239385ad0a46baef21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 22:53:59 +0100
Subject: [PATCH 04/24] paych: Output FIL in cli

---
 cli/paych.go | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/cli/paych.go b/cli/paych.go
index 1d5e304c383..03fd1cd6e5b 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -169,7 +169,7 @@ func paychStatus(writer io.Writer, avail *api.ChannelAvailableFunds) {
 			fmt.Fprint(writer, "Creating channel\n")
 			fmt.Fprintf(writer, "  From:          %s\n", avail.From)
 			fmt.Fprintf(writer, "  To:            %s\n", avail.To)
-			fmt.Fprintf(writer, "  Pending Amt:   %d\n", avail.PendingAmt)
+			fmt.Fprintf(writer, "  Pending Amt:   %s\n", types.FIL(avail.PendingAmt))
 			fmt.Fprintf(writer, "  Wait Sentinel: %s\n", avail.PendingWaitSentinel)
 			return
 		}
@@ -189,10 +189,10 @@ func paychStatus(writer io.Writer, avail *api.ChannelAvailableFunds) {
 		{"Channel", avail.Channel.String()},
 		{"From", avail.From.String()},
 		{"To", avail.To.String()},
-		{"Confirmed Amt", fmt.Sprintf("%d", avail.ConfirmedAmt)},
-		{"Pending Amt", fmt.Sprintf("%d", avail.PendingAmt)},
-		{"Queued Amt", fmt.Sprintf("%d", avail.QueuedAmt)},
-		{"Voucher Redeemed Amt", fmt.Sprintf("%d", avail.VoucherReedeemedAmt)},
+		{"Confirmed Amt", fmt.Sprintf("%s", types.FIL(avail.ConfirmedAmt))},
+		{"Pending Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAmt))},
+		{"Queued Amt", fmt.Sprintf("%s", types.FIL(avail.QueuedAmt))},
+		{"Voucher Redeemed Amt", fmt.Sprintf("%s", types.FIL(avail.VoucherReedeemedAmt))},
 	}
 	if avail.PendingWaitSentinel != nil {
 		nameValues = append(nameValues, []string{
@@ -576,7 +576,7 @@ func outputVoucher(w io.Writer, v *paych.SignedVoucher, export bool) error {
 		}
 	}
 
-	fmt.Fprintf(w, "Lane %d, Nonce %d: %s", v.Lane, v.Nonce, v.Amount.String())
+	fmt.Fprintf(w, "Lane %d, Nonce %d: %s", v.Lane, v.Nonce, types.FIL(v.Amount))
 	if export {
 		fmt.Fprintf(w, "; %s", enc)
 	}

From 8f6f21c94cee6b3bc0c596ee87bbd5b21ee45edd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 23:20:11 +0100
Subject: [PATCH 05/24] paych: Print available amounts in paych status

---
 api/api_full.go     | 4 ++++
 cli/paych.go        | 2 ++
 paychmgr/manager.go | 2 ++
 paychmgr/simple.go  | 2 ++
 4 files changed, 10 insertions(+)

diff --git a/api/api_full.go b/api/api_full.go
index cf9a1f22ef2..47f05fb7976 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -854,6 +854,10 @@ type ChannelAvailableFunds struct {
 	ConfirmedAmt types.BigInt
 	// PendingAmt is the amount of funds that are pending confirmation on-chain
 	PendingAmt types.BigInt
+	// AvailableAmt is part of ConfirmedAmt that is available for use (pre-allocated)
+	AvailableAmt types.BigInt
+	// PendingAvailableAmt is the amount of available funds that are pending confirmation on-chain
+	PendingAvailableAmt types.BigInt
 	// PendingWaitSentinel can be used with PaychGetWaitReady to wait for
 	// confirmation of pending funds
 	PendingWaitSentinel *cid.Cid
diff --git a/cli/paych.go b/cli/paych.go
index 03fd1cd6e5b..eef26227231 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -191,6 +191,8 @@ func paychStatus(writer io.Writer, avail *api.ChannelAvailableFunds) {
 		{"To", avail.To.String()},
 		{"Confirmed Amt", fmt.Sprintf("%s", types.FIL(avail.ConfirmedAmt))},
 		{"Pending Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAmt))},
+		{"Available Amt", fmt.Sprintf("%s", types.FIL(avail.AvailableAmt))},
+		{"Pending Available Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAvailableAmt))},
 		{"Queued Amt", fmt.Sprintf("%s", types.FIL(avail.QueuedAmt))},
 		{"Voucher Redeemed Amt", fmt.Sprintf("%s", types.FIL(avail.VoucherReedeemedAmt))},
 	}
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index eed475547aa..612cb6678a8 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -142,6 +142,8 @@ func (pm *Manager) AvailableFundsByFromTo(ctx context.Context, from address.Addr
 			To:                  to,
 			ConfirmedAmt:        types.NewInt(0),
 			PendingAmt:          types.NewInt(0),
+			AvailableAmt:        types.NewInt(0),
+			PendingAvailableAmt: types.NewInt(0),
 			PendingWaitSentinel: nil,
 			QueuedAmt:           types.NewInt(0),
 			VoucherReedeemedAmt: types.NewInt(0),
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index b9c70a7f3fd..45a522ba41d 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -340,6 +340,8 @@ func (ca *channelAccessor) currentAvailableFunds(ctx context.Context, channelID
 		To:                  channelInfo.to(),
 		ConfirmedAmt:        channelInfo.Amount,
 		PendingAmt:          channelInfo.PendingAmount,
+		AvailableAmt:        channelInfo.AvailableAmount,
+		PendingAvailableAmt: channelInfo.PendingAvailableAmount,
 		PendingWaitSentinel: waitSentinel,
 		QueuedAmt:           queuedAmt,
 		VoucherReedeemedAmt: totalRedeemed,

From ff8b95df934264f9c85bb0ecb82bb7cf7b277176 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Tue, 4 Jan 2022 23:31:22 +0100
Subject: [PATCH 06/24] paych: Reserve flag for add-funds cli

---
 cli/paych.go      | 9 ++++++---
 paychmgr/store.go | 6 ++++++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/cli/paych.go b/cli/paych.go
index eef26227231..171ab38abfc 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -39,12 +39,15 @@ var paychAddFundsCmd = &cli.Command{
 	Usage:     "Add funds to the payment channel between fromAddress and toAddress. Creates the payment channel if it doesn't already exist.",
 	ArgsUsage: "[fromAddress toAddress amount]",
 	Flags: []cli.Flag{
-
 		&cli.BoolFlag{
 			Name:  "restart-retrievals",
 			Usage: "restart stalled retrieval deals on this payment channel",
 			Value: true,
 		},
+		&cli.BoolFlag{
+			Name:  "reserve",
+			Usage: "mark funds as reserved",
+		},
 	},
 	Action: func(cctx *cli.Context) error {
 		if cctx.Args().Len() != 3 {
@@ -66,7 +69,7 @@ var paychAddFundsCmd = &cli.Command{
 			return ShowHelp(cctx, fmt.Errorf("parsing amount failed: %s", err))
 		}
 
-		api, closer, err := GetFullNodeAPI(cctx)
+		api, closer, err := GetFullNodeAPIV1(cctx)
 		if err != nil {
 			return err
 		}
@@ -76,7 +79,7 @@ var paychAddFundsCmd = &cli.Command{
 
 		// Send a message to chain to create channel / add funds to existing
 		// channel
-		info, err := api.PaychGet(ctx, from, to, types.BigInt(amt))
+		info, err := api.PaychGet(ctx, from, to, types.BigInt(amt), cctx.Bool("reserve"))
 		if err != nil {
 			return err
 		}
diff --git a/paychmgr/store.go b/paychmgr/store.go
index bbc549b862c..d5c8e198049 100644
--- a/paychmgr/store.go
+++ b/paychmgr/store.go
@@ -502,5 +502,11 @@ func unmarshallChannelInfo(stored *ChannelInfo, value []byte) (*ChannelInfo, err
 		stored.Channel = nil
 	}
 
+	// backwards compat
+	if stored.AvailableAmount.Int == nil {
+		stored.AvailableAmount = types.NewInt(0)
+		stored.PendingAvailableAmount = types.NewInt(0)
+	}
+
 	return stored, nil
 }

From 1f2621b57430e024910a33bf6da3d19c92fdcdb8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 5 Jan 2022 00:09:19 +0100
Subject: [PATCH 07/24] Make retrieval work with reused channels

---
 markets/retrievaladapter/client.go | 34 ++++++++++++++++++++++++++++++
 paychmgr/simple.go                 |  2 +-
 2 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 4ed2e905ab4..88fcb7ba1e3 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -9,6 +9,8 @@ import (
 	"github.com/filecoin-project/go-state-types/abi"
 	"github.com/ipfs/go-cid"
 	"github.com/multiformats/go-multiaddr"
+	mh "github.com/multiformats/go-multihash"
+	"golang.org/x/xerrors"
 
 	"github.com/filecoin-project/lotus/chain/actors/builtin/paych"
 	"github.com/filecoin-project/lotus/chain/types"
@@ -16,6 +18,27 @@ import (
 	payapi "github.com/filecoin-project/lotus/node/impl/paych"
 )
 
+func mkPaychReusedCid(addr address.Address) cid.Cid {
+	c, err := cid.V1Builder{Codec: cid.Raw, MhType: mh.IDENTITY}.Sum(addr.Bytes())
+	if err != nil {
+		panic(err)
+	}
+	return c
+}
+
+func extractPaychReusedCid(c cid.Cid) (address.Address, error) {
+	if c.Prefix().Codec != cid.Raw {
+		return address.Undef, nil
+	}
+
+	h, err := mh.Decode(c.Hash())
+	if err != nil {
+		return address.Address{}, err
+	}
+
+	return address.NewFromBytes(h.Digest)
+}
+
 type retrievalClientNode struct {
 	chainAPI full.ChainAPI
 	payAPI   payapi.PaychAPI
@@ -38,6 +61,10 @@ func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, c
 	if err != nil {
 		return address.Undef, cid.Undef, err
 	}
+	if ci.WaitSentinel == cid.Undef {
+		return ci.Channel, mkPaychReusedCid(ci.Channel), nil
+	}
+
 	return ci.Channel, ci.WaitSentinel, nil
 }
 
@@ -74,6 +101,13 @@ func (rcn *retrievalClientNode) GetChainHead(ctx context.Context) (shared.TipSet
 }
 
 func (rcn *retrievalClientNode) WaitForPaymentChannelReady(ctx context.Context, messageCID cid.Cid) (address.Address, error) {
+	maybeAddr, err := extractPaychReusedCid(messageCID)
+	if err != nil {
+		return address.Address{}, xerrors.Errorf("extract paych reused CID: %w", err)
+	}
+	if maybeAddr != address.Undef {
+		return maybeAddr, nil
+	}
 	return rcn.payAPI.PaychGetWaitReady(ctx, messageCID)
 }
 
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 45a522ba41d..d06cb870df4 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -41,7 +41,7 @@ type fundsReq struct {
 }
 
 func newFundsReq(ctx context.Context, amt types.BigInt, reserve bool) *fundsReq {
-	promise := make(chan *paychFundsRes)
+	promise := make(chan *paychFundsRes, 1)
 	return &fundsReq{
 		ctx:     ctx,
 		promise: promise,

From eab8fecd2631766e29a5e1f7bce8d3eac858f321 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 5 Jan 2022 00:17:03 +0100
Subject: [PATCH 08/24] gen stuff

---
 documentation/en/api-v0-methods.md          | 4 ++++
 documentation/en/api-v1-unstable-methods.md | 4 ++++
 documentation/en/cli-lotus.md               | 1 +
 3 files changed, 9 insertions(+)

diff --git a/documentation/en/api-v0-methods.md b/documentation/en/api-v0-methods.md
index 883d4d27499..2061d7fadb7 100644
--- a/documentation/en/api-v0-methods.md
+++ b/documentation/en/api-v0-methods.md
@@ -4061,6 +4061,8 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
+  "AvailableAmt": "0",
+  "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
   "VoucherReedeemedAmt": "0"
@@ -4088,6 +4090,8 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
+  "AvailableAmt": "0",
+  "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
   "VoucherReedeemedAmt": "0"
diff --git a/documentation/en/api-v1-unstable-methods.md b/documentation/en/api-v1-unstable-methods.md
index ce0ceadcdfd..b84877b97a5 100644
--- a/documentation/en/api-v1-unstable-methods.md
+++ b/documentation/en/api-v1-unstable-methods.md
@@ -4456,6 +4456,8 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
+  "AvailableAmt": "0",
+  "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
   "VoucherReedeemedAmt": "0"
@@ -4483,6 +4485,8 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
+  "AvailableAmt": "0",
+  "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
   "VoucherReedeemedAmt": "0"
diff --git a/documentation/en/cli-lotus.md b/documentation/en/cli-lotus.md
index 54c0d36dfe6..46e481b0879 100644
--- a/documentation/en/cli-lotus.md
+++ b/documentation/en/cli-lotus.md
@@ -1347,6 +1347,7 @@ USAGE:
 
 OPTIONS:
    --restart-retrievals  restart stalled retrieval deals on this payment channel (default: true)
+   --reserve             mark funds as reserved (default: false)
    --help, -h            show help (default: false)
    
 ```

From 533349cc0d0d13de84531e2deb822b2f3a51a210 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 5 Jan 2022 12:11:19 +0100
Subject: [PATCH 09/24] paych: Fix cli tests

---
 cli/paych.go             | 4 ++--
 itests/paych_cli_test.go | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/cli/paych.go b/cli/paych.go
index 171ab38abfc..29e8c640719 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -193,11 +193,11 @@ func paychStatus(writer io.Writer, avail *api.ChannelAvailableFunds) {
 		{"From", avail.From.String()},
 		{"To", avail.To.String()},
 		{"Confirmed Amt", fmt.Sprintf("%s", types.FIL(avail.ConfirmedAmt))},
-		{"Pending Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAmt))},
 		{"Available Amt", fmt.Sprintf("%s", types.FIL(avail.AvailableAmt))},
+		{"Voucher Redeemed Amt", fmt.Sprintf("%s", types.FIL(avail.VoucherReedeemedAmt))},
+		{"Pending Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAmt))},
 		{"Pending Available Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAvailableAmt))},
 		{"Queued Amt", fmt.Sprintf("%s", types.FIL(avail.QueuedAmt))},
-		{"Voucher Redeemed Amt", fmt.Sprintf("%s", types.FIL(avail.VoucherReedeemedAmt))},
 	}
 	if avail.PendingWaitSentinel != nil {
 		nameValues = append(nameValues, []string{
diff --git a/itests/paych_cli_test.go b/itests/paych_cli_test.go
index a4ad1920b6e..f964d781384 100644
--- a/itests/paych_cli_test.go
+++ b/itests/paych_cli_test.go
@@ -133,10 +133,10 @@ func TestPaymentChannelStatus(t *testing.T) {
 	require.True(t, stateCreating || stateCreated)
 
 	channelAmtAtto := types.BigMul(types.NewInt(channelAmt), types.NewInt(build.FilecoinPrecision))
-	channelAmtStr := fmt.Sprintf("%d", channelAmtAtto)
+	channelAmtStr := fmt.Sprintf("%s", types.FIL(channelAmtAtto))
 	if stateCreating {
 		// If we're in the creating state (most likely) the amount should be pending
-		require.Regexp(t, regexp.MustCompile("Pending.*"+channelAmtStr), out)
+		require.Regexp(t, regexp.MustCompile("Pending Amt.*"+channelAmtStr), out)
 	}
 
 	// Wait for create channel to complete
@@ -159,7 +159,7 @@ func TestPaymentChannelStatus(t *testing.T) {
 	out = creatorCLI.RunCmd("paych", "status", chstr)
 	fmt.Println(out)
 	voucherAmtAtto := types.BigMul(types.NewInt(voucherAmt), types.NewInt(build.FilecoinPrecision))
-	voucherAmtStr := fmt.Sprintf("%d", voucherAmtAtto)
+	voucherAmtStr := fmt.Sprintf("%s", types.FIL(voucherAmtAtto))
 	// Output should include voucher amount
 	require.Regexp(t, regexp.MustCompile("Voucher.*"+voucherAmtStr), out)
 }

From b0e7bc15c2f664dc96053ed4f70c61e3421bfe68 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 5 Jan 2022 16:11:32 +0100
Subject: [PATCH 10/24] paych: Cleanup available fund logic

---
 paychmgr/simple.go | 100 +++++++++++++++++++++++++--------------------
 1 file changed, 55 insertions(+), 45 deletions(-)

diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index d06cb870df4..747eac58509 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -163,6 +163,35 @@ func (m *mergedFundsReq) sum() (types.BigInt, types.BigInt) {
 	return sum, avail
 }
 
+// completeAmount completes first non-reserving requests up to the available amount
+func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *ChannelInfo) types.BigInt {
+	used := types.NewInt(0)
+	next := 0
+	for i, r := range m.reqs {
+		if !r.reserve {
+			// non-reserving request are put after reserving requests, so we are done here
+			break
+		}
+
+		if r.amt.GreaterThan(types.BigSub(avail, used)) {
+			// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
+			break
+		}
+
+		// don't try to fill inactive requests
+		if !r.isActive() {
+			continue
+		}
+
+		used = types.BigAdd(used, r.amt)
+		r.onComplete(&paychFundsRes{channel: *channelInfo.Channel})
+		next = i + 1
+	}
+
+	m.reqs = m.reqs[next:]
+	return used
+}
+
 // getPaych ensures that a channel exists between the from and to addresses,
 // and reserves (or adds as available) the given amount of funds.
 // If the channel does not exist a create channel message is sent and the
@@ -388,51 +417,8 @@ func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.
 		return nil
 	}
 
-	{
-		toReserve := types.BigSub(amt, avail)
-		avail := types.NewInt(0)
-
-		// reserve at most what we need
-		ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
-			avail = ci.AvailableAmount
-			if avail.GreaterThan(toReserve) {
-				avail = toReserve
-			}
-			ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
-		})
-
-		used := types.NewInt(0)
-
-		next := 0
-		for i, r := range merged.reqs {
-			if !r.reserve {
-				// non-reserving request are put after reserving requests, so we are done here
-				break
-			}
-
-			if r.amt.GreaterThan(types.BigSub(avail, used)) {
-				// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
-				break
-			}
-
-			// don't try to fill inactive requests
-			if !r.isActive() {
-				continue
-			}
-
-			used = types.BigAdd(used, r.amt)
-			r.onComplete(&paychFundsRes{channel: *channelInfo.Channel})
-			next = i + 1
-		}
-		merged.reqs = merged.reqs[next:]
-
-		// return any unused reserved funds (e.g. from cancelled requests)
-		ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
-			ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
-		})
-
-		amt = types.BigSub(amt, used)
-	}
+	// Try to fill requests using available funds, without going to the chain
+	amt = ca.completeAvailable(ctx, merged, channelInfo, amt, avail)
 
 	if amt.LessThanEqual(types.NewInt(0)) {
 		return nil
@@ -533,6 +519,30 @@ func (ca *channelAccessor) waitPaychCreateMsg(ctx context.Context, channelID str
 	return nil
 }
 
+// completeAvailable fills reserving fund requests using already available funds, without interacting with the chain
+func (ca *channelAccessor) completeAvailable(ctx context.Context, merged *mergedFundsReq, channelInfo *ChannelInfo, amt, av types.BigInt) types.BigInt {
+	toReserve := types.BigSub(amt, av)
+	avail := types.NewInt(0)
+
+	// reserve at most what we need
+	ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
+		avail = ci.AvailableAmount
+		if avail.GreaterThan(toReserve) {
+			avail = toReserve
+		}
+		ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
+	})
+
+	used := merged.completeAmount(avail, channelInfo)
+
+	// return any unused reserved funds (e.g. from cancelled requests)
+	ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
+		ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
+	})
+
+	return types.BigSub(amt, used)
+}
+
 // addFunds sends a message to add funds to the channel and returns the message cid
 func (ca *channelAccessor) addFunds(ctx context.Context, channelInfo *ChannelInfo, amt, avail types.BigInt) (*cid.Cid, error) {
 	msg := &types.Message{

From 5b585c0285f22d26d8c50db909b12cf2cd479f49 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 5 Jan 2022 21:49:26 +0100
Subject: [PATCH 11/24] paych: reset fundsReqQueue correctly

---
 paychmgr/simple.go | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 747eac58509..def24d1cf5c 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -164,7 +164,7 @@ func (m *mergedFundsReq) sum() (types.BigInt, types.BigInt) {
 }
 
 // completeAmount completes first non-reserving requests up to the available amount
-func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *ChannelInfo) types.BigInt {
+func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *ChannelInfo) (*paychFundsRes, types.BigInt) {
 	used := types.NewInt(0)
 	next := 0
 	for i, r := range m.reqs {
@@ -189,7 +189,10 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 	}
 
 	m.reqs = m.reqs[next:]
-	return used
+	if len(m.reqs) == 0 {
+		return &paychFundsRes{channel: *channelInfo.Channel}, used
+	}
+	return nil, used
 }
 
 // getPaych ensures that a channel exists between the from and to addresses,
@@ -418,10 +421,10 @@ func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.
 	}
 
 	// Try to fill requests using available funds, without going to the chain
-	amt = ca.completeAvailable(ctx, merged, channelInfo, amt, avail)
+	res, amt := ca.completeAvailable(ctx, merged, channelInfo, amt, avail)
 
-	if amt.LessThanEqual(types.NewInt(0)) {
-		return nil
+	if res != nil || amt.LessThanEqual(types.NewInt(0)) {
+		return res
 	}
 
 	// We need to add more funds, so send an add funds message to
@@ -520,7 +523,7 @@ func (ca *channelAccessor) waitPaychCreateMsg(ctx context.Context, channelID str
 }
 
 // completeAvailable fills reserving fund requests using already available funds, without interacting with the chain
-func (ca *channelAccessor) completeAvailable(ctx context.Context, merged *mergedFundsReq, channelInfo *ChannelInfo, amt, av types.BigInt) types.BigInt {
+func (ca *channelAccessor) completeAvailable(ctx context.Context, merged *mergedFundsReq, channelInfo *ChannelInfo, amt, av types.BigInt) (*paychFundsRes, types.BigInt) {
 	toReserve := types.BigSub(amt, av)
 	avail := types.NewInt(0)
 
@@ -533,14 +536,14 @@ func (ca *channelAccessor) completeAvailable(ctx context.Context, merged *merged
 		ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
 	})
 
-	used := merged.completeAmount(avail, channelInfo)
+	res, used := merged.completeAmount(avail, channelInfo)
 
 	// return any unused reserved funds (e.g. from cancelled requests)
 	ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
 		ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
 	})
 
-	return types.BigSub(amt, used)
+	return res, types.BigSub(amt, used)
 }
 
 // addFunds sends a message to add funds to the channel and returns the message cid

From 8b19b84140ee432eb5ea0c93f8c5a8c1dd5dbf19 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Thu, 6 Jan 2022 16:04:39 +0100
Subject: [PATCH 12/24] paych: option to force off-chain get

---
 api/api_full.go                             |  15 +-
 api/mocks/mock_full.go                      |   2 +-
 api/proxy_gen.go                            |   6 +-
 api/v0api/v1_wrapper.go                     |   6 +-
 cli/paych.go                                |   9 +-
 documentation/en/api-v1-unstable-methods.md |  13 +-
 itests/paych_api_test.go                    |   5 +-
 markets/retrievaladapter/client.go          |   6 +-
 node/impl/paych/paych.go                    |   9 +-
 paychmgr/manager.go                         |   8 +-
 paychmgr/paychget_test.go                   | 369 ++++++++++++++++++--
 paychmgr/paychvoucherfunds_test.go          |   4 +-
 paychmgr/settle_test.go                     |   4 +-
 paychmgr/simple.go                          |  78 ++++-
 testplans/lotus-soup/deals_e2e.go           |  10 +-
 testplans/lotus-soup/paych/stress.go        |   5 +-
 16 files changed, 468 insertions(+), 81 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index 47f05fb7976..853d4928390 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -690,10 +690,14 @@ type FullNode interface {
 	// The Paych methods are for interacting with and managing payment channels
 
 	// PaychGet gets or creates a payment channel between address pair
-	//  - If reserve is false, the specified amount will be added to the channel through on-chain send for future use
-	//  - If reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+	//  - If opts.Reserve is false, the specified amount will be added to the channel through on-chain send for future use
+	//  - If opts.Reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
 	//    available, funds will be added through an on-chain message.
-	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (*ChannelInfo, error)       //perm:sign
+	//  - When opts.OffChain is true, this call will not cause any messages to be sent to the chain (no automatic
+	//    channel creation/funds adding). If the operation can't be performed without sending a message an error will be
+	//    returned. Note that even when this option is specified, this call can be blocked by previous operations on the
+	//    channel waiting for on-chain operations.
+	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts PaychGetOpts) (*ChannelInfo, error)  //perm:sign
 	PaychGetWaitReady(context.Context, cid.Cid) (address.Address, error)                                                //perm:sign
 	PaychAvailableFunds(ctx context.Context, ch address.Address) (*ChannelAvailableFunds, error)                        //perm:sign
 	PaychAvailableFundsByFromTo(ctx context.Context, from, to address.Address) (*ChannelAvailableFunds, error)          //perm:sign
@@ -832,6 +836,11 @@ const (
 	PCHOutbound
 )
 
+type PaychGetOpts struct {
+	Reserve  bool
+	OffChain bool
+}
+
 type PaychStatus struct {
 	ControlAddr address.Address
 	Direction   PCHDir
diff --git a/api/mocks/mock_full.go b/api/mocks/mock_full.go
index c745f26fcd4..5d42ba3c918 100644
--- a/api/mocks/mock_full.go
+++ b/api/mocks/mock_full.go
@@ -1976,7 +1976,7 @@ func (mr *MockFullNodeMockRecorder) PaychCollect(arg0, arg1 interface{}) *gomock
 }
 
 // PaychGet mocks base method.
-func (m *MockFullNode) PaychGet(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int, arg4 bool) (*api.ChannelInfo, error) {
+func (m *MockFullNode) PaychGet(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int, arg4 api.PaychGetOpts) (*api.ChannelInfo, error) {
 	m.ctrl.T.Helper()
 	ret := m.ctrl.Call(m, "PaychGet", arg0, arg1, arg2, arg3, arg4)
 	ret0, _ := ret[0].(*api.ChannelInfo)
diff --git a/api/proxy_gen.go b/api/proxy_gen.go
index 9a134cec91b..9615181f58c 100644
--- a/api/proxy_gen.go
+++ b/api/proxy_gen.go
@@ -306,7 +306,7 @@ type FullNodeStruct struct {
 
 		PaychCollect func(p0 context.Context, p1 address.Address) (cid.Cid, error) `perm:"sign"`
 
-		PaychGet func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) `perm:"sign"`
+		PaychGet func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 PaychGetOpts) (*ChannelInfo, error) `perm:"sign"`
 
 		PaychGetWaitReady func(p0 context.Context, p1 cid.Cid) (address.Address, error) `perm:"sign"`
 
@@ -2179,14 +2179,14 @@ func (s *FullNodeStub) PaychCollect(p0 context.Context, p1 address.Address) (cid
 	return *new(cid.Cid), ErrNotSupported
 }
 
-func (s *FullNodeStruct) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) {
+func (s *FullNodeStruct) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 PaychGetOpts) (*ChannelInfo, error) {
 	if s.Internal.PaychGet == nil {
 		return nil, ErrNotSupported
 	}
 	return s.Internal.PaychGet(p0, p1, p2, p3, p4)
 }
 
-func (s *FullNodeStub) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 bool) (*ChannelInfo, error) {
+func (s *FullNodeStub) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 PaychGetOpts) (*ChannelInfo, error) {
 	return nil, ErrNotSupported
 }
 
diff --git a/api/v0api/v1_wrapper.go b/api/v0api/v1_wrapper.go
index 605b27b0c9f..1c22eb920ad 100644
--- a/api/v0api/v1_wrapper.go
+++ b/api/v0api/v1_wrapper.go
@@ -338,8 +338,10 @@ func (w *WrapperV1Full) clientRetrieve(ctx context.Context, order RetrievalOrder
 }
 
 func (w *WrapperV1Full) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
-	// v0 always reserves
-	return w.FullNode.PaychGet(ctx, from, to, amt, true)
+	return w.FullNode.PaychGet(ctx, from, to, amt, api.PaychGetOpts{
+		Reserve:  true, // v0 always reserves
+		OffChain: false,
+	})
 }
 
 var _ FullNode = &WrapperV1Full{}
diff --git a/cli/paych.go b/cli/paych.go
index 29e8c640719..78e661d155f 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -8,7 +8,7 @@ import (
 	"sort"
 	"strings"
 
-	"github.com/filecoin-project/lotus/api"
+	lapi "github.com/filecoin-project/lotus/api"
 
 	"github.com/filecoin-project/lotus/paychmgr"
 
@@ -79,7 +79,10 @@ var paychAddFundsCmd = &cli.Command{
 
 		// Send a message to chain to create channel / add funds to existing
 		// channel
-		info, err := api.PaychGet(ctx, from, to, types.BigInt(amt), cctx.Bool("reserve"))
+		info, err := api.PaychGet(ctx, from, to, types.BigInt(amt), lapi.PaychGetOpts{
+			Reserve:  cctx.Bool("reserve"),
+			OffChain: false,
+		})
 		if err != nil {
 			return err
 		}
@@ -166,7 +169,7 @@ var paychStatusCmd = &cli.Command{
 	},
 }
 
-func paychStatus(writer io.Writer, avail *api.ChannelAvailableFunds) {
+func paychStatus(writer io.Writer, avail *lapi.ChannelAvailableFunds) {
 	if avail.Channel == nil {
 		if avail.PendingWaitSentinel != nil {
 			fmt.Fprint(writer, "Creating channel\n")
diff --git a/documentation/en/api-v1-unstable-methods.md b/documentation/en/api-v1-unstable-methods.md
index b84877b97a5..2926faab7c8 100644
--- a/documentation/en/api-v1-unstable-methods.md
+++ b/documentation/en/api-v1-unstable-methods.md
@@ -4514,9 +4514,13 @@ Response:
 
 ### PaychGet
 PaychGet gets or creates a payment channel between address pair
- - If reserve is false, the specified amount will be added to the channel through on-chain send for future use
- - If reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+ - If opts.Reserve is false, the specified amount will be added to the channel through on-chain send for future use
+ - If opts.Reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
    available, funds will be added through an on-chain message.
+ - When opts.OffChain is true, this call will not cause any messages to be sent to the chain (no automatic
+   channel creation/funds adding). If the operation can't be performed without sending a message an error will be
+   returned. Note that even when this option is specified, this call can be blocked by previous operations on the
+   channel waiting for on-chain operations.
 
 
 Perms: sign
@@ -4527,7 +4531,10 @@ Inputs:
   "f01234",
   "f01234",
   "0",
-  true
+  {
+    "Reserve": true,
+    "OffChain": true
+  }
 ]
 ```
 
diff --git a/itests/paych_api_test.go b/itests/paych_api_test.go
index fb2233d9043..c2d14aeb8cb 100644
--- a/itests/paych_api_test.go
+++ b/itests/paych_api_test.go
@@ -58,7 +58,10 @@ func TestPaymentChannelsAPI(t *testing.T) {
 	require.NoError(t, err)
 
 	channelAmt := int64(7000)
-	channelInfo, err := paymentCreator.PaychGet(ctx, createrAddr, receiverAddr, abi.NewTokenAmount(channelAmt), true)
+	channelInfo, err := paymentCreator.PaychGet(ctx, createrAddr, receiverAddr, abi.NewTokenAmount(channelAmt), api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	require.NoError(t, err)
 
 	channel, err := paymentCreator.PaychGetWaitReady(ctx, channelInfo.WaitSentinel)
diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 88fcb7ba1e3..601f9f2550f 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -12,6 +12,7 @@ import (
 	mh "github.com/multiformats/go-multihash"
 	"golang.org/x/xerrors"
 
+	"github.com/filecoin-project/lotus/api"
 	"github.com/filecoin-project/lotus/chain/actors/builtin/paych"
 	"github.com/filecoin-project/lotus/chain/types"
 	"github.com/filecoin-project/lotus/node/impl/full"
@@ -57,7 +58,10 @@ func NewRetrievalClientNode(payAPI payapi.PaychAPI, chainAPI full.ChainAPI, stat
 func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, clientAddress address.Address, minerAddress address.Address, clientFundsAvailable abi.TokenAmount, tok shared.TipSetToken) (address.Address, cid.Cid, error) {
 	// TODO: respect the provided TipSetToken (a serialized TipSetKey) when
 	// querying the chain
-	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable, true)
+	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable, api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	if err != nil {
 		return address.Undef, cid.Undef, err
 	}
diff --git a/node/impl/paych/paych.go b/node/impl/paych/paych.go
index d308f6248ac..2d8777dbb9a 100644
--- a/node/impl/paych/paych.go
+++ b/node/impl/paych/paych.go
@@ -22,8 +22,8 @@ type PaychAPI struct {
 	PaychMgr *paychmgr.Manager
 }
 
-func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (*api.ChannelInfo, error) {
-	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, reserve)
+func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts api.PaychGetOpts) (*api.ChannelInfo, error) {
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, opts)
 	if err != nil {
 		return nil, err
 	}
@@ -55,7 +55,10 @@ func (a *PaychAPI) PaychNewPayment(ctx context.Context, from, to address.Address
 
 	// TODO: Fix free fund tracking in PaychGet
 	// TODO: validate voucher spec before locking funds
-	ch, err := a.PaychGet(ctx, from, to, amount, true)
+	ch, err := a.PaychGet(ctx, from, to, amount, api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	if err != nil {
 		return nil, err
 	}
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index 612cb6678a8..7045a7dcd23 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -101,13 +101,17 @@ func (pm *Manager) Stop() error {
 	return nil
 }
 
-func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool) (address.Address, cid.Cid, error) {
+func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, opts api.PaychGetOpts) (address.Address, cid.Cid, error) {
+	if !opts.Reserve && opts.OffChain {
+		return address.Undef, cid.Undef, xerrors.Errorf("can't fund payment channels without on-chain operations")
+	}
+
 	chanAccessor, err := pm.accessorByFromTo(from, to)
 	if err != nil {
 		return address.Undef, cid.Undef, err
 	}
 
-	return chanAccessor.getPaych(ctx, amt, reserve)
+	return chanAccessor.getPaych(ctx, amt, opts)
 }
 
 func (pm *Manager) AvailableFunds(ctx context.Context, ch address.Address) (*api.ChannelAvailableFunds, error) {
diff --git a/paychmgr/paychget_test.go b/paychmgr/paychget_test.go
index 31207917721..f16b146f627 100644
--- a/paychmgr/paychget_test.go
+++ b/paychmgr/paychget_test.go
@@ -19,12 +19,30 @@ import (
 	init2 "github.com/filecoin-project/specs-actors/v2/actors/builtin/init"
 	tutils "github.com/filecoin-project/specs-actors/v2/support/testing"
 
+	"github.com/filecoin-project/lotus/api"
 	lotusinit "github.com/filecoin-project/lotus/chain/actors/builtin/init"
 	"github.com/filecoin-project/lotus/chain/actors/builtin/paych"
 	paychmock "github.com/filecoin-project/lotus/chain/actors/builtin/paych/mock"
 	"github.com/filecoin-project/lotus/chain/types"
 )
 
+var onChainReserve = api.PaychGetOpts{
+	Reserve:  true,
+	OffChain: false,
+}
+var onChainNoReserve = api.PaychGetOpts{
+	Reserve:  false,
+	OffChain: false,
+}
+var offChainReserve = api.PaychGetOpts{
+	Reserve:  true,
+	OffChain: true,
+}
+var offChainNoReserve = api.PaychGetOpts{
+	Reserve:  false,
+	OffChain: true,
+}
+
 func testChannelResponse(t *testing.T, ch address.Address) types.MessageReceipt {
 	createChannelRet := init2.ExecReturn{
 		IDAddress:     ch,
@@ -55,7 +73,7 @@ func TestPaychGetCreateChannelMsg(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	ch, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	ch, mcid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 	require.Equal(t, address.Undef, ch)
 
@@ -65,6 +83,42 @@ func TestPaychGetCreateChannelMsg(t *testing.T) {
 	require.Equal(t, amt, pushedMsg.Message.Value)
 }
 
+func TestPaychGetOffchainNoReserveFails(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	amt := big.NewInt(10)
+	_, _, err = mgr.GetPaych(ctx, from, to, amt, offChainNoReserve)
+	require.Error(t, err)
+}
+
+func TestPaychGetCreateOffchainReserveFails(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	amt := big.NewInt(10)
+	_, _, err = mgr.GetPaych(ctx, from, to, amt, offChainReserve)
+	require.Error(t, err)
+}
+
 // TestPaychGetCreateChannelThenAddFunds tests creating a channel and then
 // adding funds to it
 func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
@@ -83,7 +137,7 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Should have no channels yet (message sent but channel not created)
@@ -100,7 +154,7 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 
 		// 2. Request add funds - should block until create channel has completed
 		amt2 := big.NewInt(5)
-		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
+		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 
 		// 4. This GetPaych should return after create channel from first
 		//    GetPaych completes
@@ -170,7 +224,7 @@ func TestPaychGetCreatePrefundedChannelThenAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, false)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, onChainNoReserve)
 	require.NoError(t, err)
 
 	// Should have no channels yet (message sent but channel not created)
@@ -187,7 +241,7 @@ func TestPaychGetCreatePrefundedChannelThenAddFunds(t *testing.T) {
 
 		// 2. Request add funds - shouldn't block
 		amt2 := big.NewInt(3)
-		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
+		ch2, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, offChainReserve)
 
 		// 4. This GetPaych should return after create channel from first
 		//    GetPaych completes
@@ -240,7 +294,7 @@ func TestPaychGetCreateChannelWithErrorThenCreateAgain(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// 1. Set up create channel response (sent in response to WaitForMsg())
@@ -258,7 +312,7 @@ func TestPaychGetCreateChannelWithErrorThenCreateAgain(t *testing.T) {
 		//    Because first channel create fails, this request
 		//    should be for channel create again.
 		amt2 := big.NewInt(5)
-		ch2, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
+		ch2, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 		require.NoError(t, err)
 		require.Equal(t, address.Undef, ch2)
 
@@ -305,7 +359,7 @@ func TestPaychGetRecoverAfterError(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Send error create channel response
@@ -316,7 +370,7 @@ func TestPaychGetRecoverAfterError(t *testing.T) {
 
 	// Send create message for a channel again
 	amt2 := big.NewInt(7)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -357,7 +411,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -366,7 +420,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send add funds message for channel
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 	require.NoError(t, err)
 
 	// Send error add funds response
@@ -393,7 +447,7 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 
 	// Send add funds message for channel again
 	amt3 := big.NewInt(2)
-	_, mcid3, err := mgr.GetPaych(ctx, from, to, amt3, true)
+	_, mcid3, err := mgr.GetPaych(ctx, from, to, amt3, onChainReserve)
 	require.NoError(t, err)
 
 	// Send success add funds response
@@ -438,7 +492,7 @@ func TestPaychGetRestartAfterCreateChannelMsg(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Simulate shutting down system
@@ -465,7 +519,7 @@ func TestPaychGetRestartAfterCreateChannelMsg(t *testing.T) {
 
 		// 2. Request add funds - should block until create channel has completed
 		amt2 := big.NewInt(5)
-		ch2, addFundsMsgCid, err := mgr2.GetPaych(ctx, from, to, amt2, true)
+		ch2, addFundsMsgCid, err := mgr2.GetPaych(ctx, from, to, amt2, onChainReserve)
 
 		// 4. This GetPaych should return after create channel from first
 		//    GetPaych completes
@@ -517,7 +571,7 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 
 	// Send create message for a channel
 	amt := big.NewInt(10)
-	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid1, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Send success create channel response
@@ -526,7 +580,7 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 
 	// Send add funds message for channel
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 	require.NoError(t, err)
 
 	// Simulate shutting down system
@@ -580,7 +634,7 @@ func TestPaychGetWait(t *testing.T) {
 
 	// 1. Get
 	amt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	expch := tutils.NewIDAddr(t, 100)
@@ -603,7 +657,7 @@ func TestPaychGetWait(t *testing.T) {
 
 	// Request add funds
 	amt2 := big.NewInt(15)
-	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, true)
+	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 	require.NoError(t, err)
 
 	go func() {
@@ -637,7 +691,7 @@ func TestPaychGetWaitErr(t *testing.T) {
 
 	// 1. Create channel
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	done := make(chan address.Address)
@@ -683,7 +737,7 @@ func TestPaychGetWaitCtx(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// When the context is cancelled, should unblock wait
@@ -714,7 +768,7 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -732,7 +786,7 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, true)
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, onChainReserve)
 		require.NoError(t, err)
 	}()
 
@@ -741,7 +795,7 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, onChainReserve)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -810,7 +864,7 @@ func TestPaychGetMergePrefundAndReserve(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -828,7 +882,7 @@ func TestPaychGetMergePrefundAndReserve(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, false)
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, onChainNoReserve)
 		require.NoError(t, err)
 	}()
 
@@ -837,7 +891,7 @@ func TestPaychGetMergePrefundAndReserve(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, onChainReserve)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -906,7 +960,7 @@ func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, false)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainNoReserve)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -924,7 +978,7 @@ func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, false)
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, onChainNoReserve)
 		require.NoError(t, err)
 	}()
 
@@ -933,7 +987,7 @@ func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, onChainReserve)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -987,6 +1041,247 @@ func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
 	require.Equal(t, addFundsAmt1, addFundsMsg.Message.Value)
 }
 
+func TestPaychGetMergePrefundAndReservePrefundedOneOffchain(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	createAmt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainNoReserve)
+	require.NoError(t, err)
+
+	// Queue up two add funds requests behind create channel
+	var addFundsSent sync.WaitGroup
+	addFundsSent.Add(2)
+
+	addFundsAmt1 := big.NewInt(5) // 1 reserves
+	addFundsAmt2 := big.NewInt(3) // 2 reserves
+	var addFundsCh1 address.Address
+	var addFundsCh2 address.Address
+	var addFundsMcid1 cid.Cid
+	var addFundsMcid2 cid.Cid
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds - should block until create channel has completed
+		var err error
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, offChainReserve)
+		require.NoError(t, err)
+	}()
+
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds again - should merge with waiting add funds request
+		var err error
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, onChainReserve)
+		require.NoError(t, err)
+	}()
+	// Wait for add funds requests to be queued up
+	waitForQueueSize(t, mgr, from, to, 2)
+
+	// Send create channel response
+	response := testChannelResponse(t, ch)
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	// Wait for create channel response
+	chres, err := mgr.GetPaychWaitReady(ctx, createMsgCid)
+	require.NoError(t, err)
+	require.Equal(t, ch, chres)
+
+	// Wait for add funds requests to be sent
+	addFundsSent.Wait()
+
+	// Expect add funds requests to have same channel as create channel and
+	// same message cid as each other (because they should have been merged)
+	require.Equal(t, ch, addFundsCh1)
+	require.Equal(t, ch, addFundsCh2)
+	require.Equal(t, cid.Undef, addFundsMcid1)
+	require.Equal(t, cid.Undef, addFundsMcid2)
+
+	// Make sure that one create channel message was sent
+	require.Equal(t, 1, mock.pushedMessageCount())
+
+	// Check create message amount is correct
+	createMsg := mock.pushedMessages(createMsgCid)
+	require.Equal(t, from, createMsg.Message.From)
+	require.Equal(t, lotusinit.Address, createMsg.Message.To)
+	require.Equal(t, createAmt, createMsg.Message.Value)
+}
+
+func TestPaychGetMergePrefundAndReservePrefundedBothOffchainOneFail(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	createAmt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainNoReserve)
+	require.NoError(t, err)
+
+	// Queue up two add funds requests behind create channel
+	var addFundsSent sync.WaitGroup
+	addFundsSent.Add(2)
+
+	addFundsAmt1 := big.NewInt(5) // 1 reserves
+	addFundsAmt2 := big.NewInt(6) // 2 reserves too much
+	var addFundsCh1 address.Address
+	var addFundsCh2 address.Address
+	var addFundsMcid1 cid.Cid
+	var addFundsMcid2 cid.Cid
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds - should block until create channel has completed
+		var err error
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, offChainReserve)
+		require.NoError(t, err)
+	}()
+
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds again - should merge with waiting add funds request
+		var err error
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, offChainReserve)
+		require.Error(t, err)
+	}()
+	// Wait for add funds requests to be queued up
+	waitForQueueSize(t, mgr, from, to, 2)
+
+	// Send create channel response
+	response := testChannelResponse(t, ch)
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	// Wait for create channel response
+	chres, err := mgr.GetPaychWaitReady(ctx, createMsgCid)
+	require.NoError(t, err)
+	require.Equal(t, ch, chres)
+
+	// Wait for add funds requests to be sent
+	addFundsSent.Wait()
+
+	// Expect add funds requests to have same channel as create channel and
+	// same message cid as each other (because they should have been merged)
+	require.Equal(t, ch, addFundsCh1)
+	require.Equal(t, ch, addFundsCh2)
+	require.Equal(t, cid.Undef, addFundsMcid1)
+	require.Equal(t, cid.Undef, addFundsMcid2)
+
+	// Make sure that one create channel message was sent
+	require.Equal(t, 1, mock.pushedMessageCount())
+
+	// Check create message amount is correct
+	createMsg := mock.pushedMessages(createMsgCid)
+	require.Equal(t, from, createMsg.Message.From)
+	require.Equal(t, lotusinit.Address, createMsg.Message.To)
+	require.Equal(t, createAmt, createMsg.Message.Value)
+}
+
+func TestPaychGetMergePrefundAndReserveOneOffchainOneFail(t *testing.T) {
+	ctx := context.Background()
+	store := NewStore(ds_sync.MutexWrap(ds.NewMapDatastore()))
+
+	ch := tutils.NewIDAddr(t, 100)
+	from := tutils.NewIDAddr(t, 101)
+	to := tutils.NewIDAddr(t, 102)
+
+	mock := newMockManagerAPI()
+	defer mock.close()
+
+	mgr, err := newManager(store, mock)
+	require.NoError(t, err)
+
+	// Send create message for a channel with value 10
+	createAmt := big.NewInt(10)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
+	require.NoError(t, err)
+
+	// Queue up two add funds requests behind create channel
+	var addFundsSent sync.WaitGroup
+	addFundsSent.Add(2)
+
+	addFundsAmt1 := big.NewInt(5) // 1 reserves
+	addFundsAmt2 := big.NewInt(6) // 2 reserves
+	var addFundsCh1 address.Address
+	var addFundsCh2 address.Address
+	var addFundsMcid1 cid.Cid
+	var addFundsMcid2 cid.Cid
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds - should block until create channel has completed
+		var err error
+		addFundsCh1, addFundsMcid1, err = mgr.GetPaych(ctx, from, to, addFundsAmt1, onChainReserve)
+		require.NoError(t, err)
+	}()
+
+	go func() {
+		defer addFundsSent.Done()
+
+		// Request add funds again - should merge with waiting add funds request
+		var err error
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, offChainReserve)
+		require.Error(t, err)
+	}()
+	// Wait for add funds requests to be queued up
+	waitForQueueSize(t, mgr, from, to, 2)
+
+	// Send create channel response
+	response := testChannelResponse(t, ch)
+	mock.receiveMsgResponse(createMsgCid, response)
+
+	// Wait for create channel response
+	chres, err := mgr.GetPaychWaitReady(ctx, createMsgCid)
+	require.NoError(t, err)
+	require.Equal(t, ch, chres)
+
+	// Wait for add funds requests to be sent
+	addFundsSent.Wait()
+
+	// Expect add funds requests to have same channel as create channel and
+	// same message cid as each other (because they should have been merged)
+	require.Equal(t, ch, addFundsCh1)
+	require.Equal(t, ch, addFundsCh2)
+	require.NotEqual(t, cid.Undef, addFundsMcid1)
+	require.Equal(t, cid.Undef, addFundsMcid2)
+
+	// Make sure that one create channel message was sent
+	require.Equal(t, 2, mock.pushedMessageCount())
+
+	// Check create message amount is correct
+	createMsg := mock.pushedMessages(createMsgCid)
+	require.Equal(t, from, createMsg.Message.From)
+	require.Equal(t, lotusinit.Address, createMsg.Message.To)
+	require.Equal(t, createAmt, createMsg.Message.Value)
+
+	// Check merged add funds amount is the sum of the individual
+	// amounts
+	addFundsMsg := mock.pushedMessages(addFundsMcid1)
+	require.Equal(t, from, addFundsMsg.Message.From)
+	require.Equal(t, ch, addFundsMsg.Message.To)
+	require.Equal(t, addFundsAmt1, addFundsMsg.Message.Value)
+}
+
 // TestPaychGetMergeAddFundsCtxCancelOne tests that when a queued add funds
 // request is cancelled, its amount is removed from the total merged add funds
 func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
@@ -1005,7 +1300,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -1022,7 +1317,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 		defer addFundsSent.Done()
 
 		// Request add funds - should block until create channel has completed
-		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, addFundsAmt1, true)
+		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, addFundsAmt1, onChainReserve)
 	}()
 
 	go func() {
@@ -1030,7 +1325,7 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 
 		// Request add funds again - should merge with waiting add funds request
 		var err error
-		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, true)
+		addFundsCh2, addFundsMcid2, err = mgr.GetPaych(ctx, from, to, addFundsAmt2, onChainReserve)
 		require.NoError(t, err)
 	}()
 	// Wait for add funds requests to be queued up
@@ -1102,7 +1397,7 @@ func TestPaychGetMergeAddFundsCtxCancelAll(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Queue up two add funds requests behind create channel
@@ -1117,14 +1412,14 @@ func TestPaychGetMergeAddFundsCtxCancelAll(t *testing.T) {
 		defer addFundsSent.Done()
 
 		// Request add funds - should block until create channel has completed
-		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, big.NewInt(5), true)
+		_, _, addFundsErr1 = mgr.GetPaych(addFundsCtx1, from, to, big.NewInt(5), onChainReserve)
 	}()
 
 	go func() {
 		defer addFundsSent.Done()
 
 		// Request add funds again - should merge with waiting add funds request
-		_, _, addFundsErr2 = mgr.GetPaych(addFundsCtx2, from, to, big.NewInt(3), true)
+		_, _, addFundsErr2 = mgr.GetPaych(addFundsCtx2, from, to, big.NewInt(3), onChainReserve)
 	}()
 	// Wait for add funds requests to be queued up
 	waitForQueueSize(t, mgr, from, to, 2)
@@ -1189,7 +1484,7 @@ func TestPaychAvailableFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Available funds should reflect create channel message sent
@@ -1214,7 +1509,7 @@ func TestPaychAvailableFunds(t *testing.T) {
 
 		// Request add funds - should block until create channel has completed
 		var err error
-		_, addFundsMcid, err = mgr.GetPaych(ctx, from, to, addFundsAmt, true)
+		_, addFundsMcid, err = mgr.GetPaych(ctx, from, to, addFundsAmt, onChainReserve)
 		require.NoError(t, err)
 	}()
 
diff --git a/paychmgr/paychvoucherfunds_test.go b/paychmgr/paychvoucherfunds_test.go
index d13a5815eb4..4a2f7e31a83 100644
--- a/paychmgr/paychvoucherfunds_test.go
+++ b/paychmgr/paychvoucherfunds_test.go
@@ -46,7 +46,7 @@ func TestPaychAddVoucherAfterAddFunds(t *testing.T) {
 
 	// Send create message for a channel with value 10
 	createAmt := big.NewInt(10)
-	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, true)
+	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, createAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Send create channel response
@@ -82,7 +82,7 @@ func TestPaychAddVoucherAfterAddFunds(t *testing.T) {
 	require.Equal(t, res.Shortfall, excessAmt)
 
 	// Add funds so as to cover the voucher shortfall
-	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, excessAmt, true)
+	_, addFundsMsgCid, err := mgr.GetPaych(ctx, from, to, excessAmt, onChainReserve)
 	require.NoError(t, err)
 
 	// Trigger add funds confirmation
diff --git a/paychmgr/settle_test.go b/paychmgr/settle_test.go
index e674d63f4e0..bc88df2f0d6 100644
--- a/paychmgr/settle_test.go
+++ b/paychmgr/settle_test.go
@@ -29,7 +29,7 @@ func TestPaychSettle(t *testing.T) {
 	require.NoError(t, err)
 
 	amt := big.NewInt(10)
-	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, true)
+	_, mcid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
 	// Send channel create response
@@ -49,7 +49,7 @@ func TestPaychSettle(t *testing.T) {
 	// (should create a new channel because the previous channel
 	// is settling)
 	amt2 := big.NewInt(5)
-	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, true)
+	_, mcid2, err := mgr.GetPaych(ctx, from, to, amt2, onChainReserve)
 	require.NoError(t, err)
 	require.NotEqual(t, cid.Undef, mcid2)
 
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index def24d1cf5c..ffb13b6c233 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -33,20 +33,20 @@ type fundsReq struct {
 	ctx     context.Context
 	promise chan *paychFundsRes
 	amt     types.BigInt
-	reserve bool
+	opts    api.PaychGetOpts
 
 	lk sync.Mutex
 	// merge parent, if this req is part of a merge
 	merge *mergedFundsReq
 }
 
-func newFundsReq(ctx context.Context, amt types.BigInt, reserve bool) *fundsReq {
+func newFundsReq(ctx context.Context, amt types.BigInt, opts api.PaychGetOpts) *fundsReq {
 	promise := make(chan *paychFundsRes, 1)
 	return &fundsReq{
 		ctx:     ctx,
 		promise: promise,
 		amt:     amt,
-		reserve: reserve,
+		opts:    opts,
 	}
 }
 
@@ -108,8 +108,12 @@ func newMergedFundsReq(reqs []*fundsReq) *mergedFundsReq {
 	}
 
 	sort.Slice(m.reqs, func(i, j int) bool {
-		if m.reqs[i].reserve != m.reqs[j].reserve { // non-reserve first
-			return m.reqs[i].reserve
+		if m.reqs[i].opts.OffChain != m.reqs[j].opts.OffChain { // off-chain first
+			return m.reqs[i].opts.OffChain
+		}
+
+		if m.reqs[i].opts.Reserve != m.reqs[j].opts.Reserve { // non-reserve after off-chain
+			return m.reqs[i].opts.Reserve
 		}
 
 		// sort by amount asc (reducing latency for smaller requests)
@@ -154,7 +158,7 @@ func (m *mergedFundsReq) sum() (types.BigInt, types.BigInt) {
 	for _, r := range m.reqs {
 		if r.isActive() {
 			sum = types.BigAdd(sum, r.amt)
-			if !r.reserve {
+			if !r.opts.Reserve {
 				avail = types.BigAdd(avail, r.amt)
 			}
 		}
@@ -164,17 +168,30 @@ func (m *mergedFundsReq) sum() (types.BigInt, types.BigInt) {
 }
 
 // completeAmount completes first non-reserving requests up to the available amount
-func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *ChannelInfo) (*paychFundsRes, types.BigInt) {
-	used := types.NewInt(0)
+func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *ChannelInfo) (*paychFundsRes, types.BigInt, types.BigInt) {
+	used, failed := types.NewInt(0), types.NewInt(0)
 	next := 0
+
+	// order: [offchain+reserve, !offchain+reserve, !offchain+!reserve]
 	for i, r := range m.reqs {
-		if !r.reserve {
+		if !r.opts.Reserve {
 			// non-reserving request are put after reserving requests, so we are done here
 			break
 		}
 
 		if r.amt.GreaterThan(types.BigSub(avail, used)) {
 			// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
+
+			if r.opts.OffChain {
+				// can't fill, so OffChain want an error
+				if r.isActive() {
+					failed = types.BigAdd(failed, r.amt)
+					r.onComplete(&paychFundsRes{channel: *channelInfo.Channel, err: xerrors.Errorf("not enough available funds in the payment channel")})
+				}
+				next = i + 1
+				continue
+			}
+
 			break
 		}
 
@@ -190,9 +207,34 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 
 	m.reqs = m.reqs[next:]
 	if len(m.reqs) == 0 {
-		return &paychFundsRes{channel: *channelInfo.Channel}, used
+		return &paychFundsRes{channel: *channelInfo.Channel}, used, failed
 	}
-	return nil, used
+	return nil, used, failed
+}
+
+func (m *mergedFundsReq) failOffChain(msg string) (*paychFundsRes, types.BigInt) {
+	next := 0
+	freed := types.NewInt(0)
+
+	for i, r := range m.reqs {
+		if !r.opts.OffChain {
+			break
+		}
+
+		freed = types.BigAdd(freed, r.amt)
+		if !r.isActive() {
+			continue
+		}
+		r.onComplete(&paychFundsRes{err: xerrors.New(msg)})
+		next = i + 1
+	}
+
+	m.reqs = m.reqs[next:]
+	if len(m.reqs) == 0 {
+		return &paychFundsRes{err: xerrors.New(msg)}, freed
+	}
+
+	return nil, freed
 }
 
 // getPaych ensures that a channel exists between the from and to addresses,
@@ -206,9 +248,9 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 // address and the CID of the new add funds message.
 // If an operation returns an error, subsequent waiting operations will still
 // be attempted.
-func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, reserve bool) (address.Address, cid.Cid, error) {
+func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, opts api.PaychGetOpts) (address.Address, cid.Cid, error) {
 	// Add the request to add funds to a queue and wait for the result
-	freq := newFundsReq(ctx, amt, reserve)
+	freq := newFundsReq(ctx, amt, opts)
 	ca.enqueue(ctx, freq)
 	select {
 	case res := <-freq.promise:
@@ -398,6 +440,12 @@ func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.
 
 	// If a channel has not yet been created, create one.
 	if channelInfo == nil {
+		res, freed := merged.failOffChain("payment channel doesn't exist")
+		if res != nil {
+			return res
+		}
+		amt = types.BigSub(amt, freed)
+
 		mcid, err := ca.createPaych(ctx, amt, avail)
 		if err != nil {
 			return &paychFundsRes{err: err}
@@ -536,14 +584,14 @@ func (ca *channelAccessor) completeAvailable(ctx context.Context, merged *merged
 		ci.AvailableAmount = big.Sub(ci.AvailableAmount, avail)
 	})
 
-	res, used := merged.completeAmount(avail, channelInfo)
+	res, used, failed := merged.completeAmount(avail, channelInfo)
 
 	// return any unused reserved funds (e.g. from cancelled requests)
 	ca.mutateChannelInfo(ctx, channelInfo.ChannelID, func(ci *ChannelInfo) {
 		ci.AvailableAmount = types.BigAdd(ci.AvailableAmount, types.BigSub(avail, used))
 	})
 
-	return res, types.BigSub(amt, used)
+	return res, types.BigSub(amt, types.BigAdd(used, failed))
 }
 
 // addFunds sends a message to add funds to the channel and returns the message cid
diff --git a/testplans/lotus-soup/deals_e2e.go b/testplans/lotus-soup/deals_e2e.go
index bc970350837..d9be97f6cae 100644
--- a/testplans/lotus-soup/deals_e2e.go
+++ b/testplans/lotus-soup/deals_e2e.go
@@ -207,7 +207,10 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 	t.RecordMessage("my balance: %d", balance)
 	t.RecordMessage("creating payment channel; from=%s, to=%s, funds=%d", cl.Wallet.Address, recv.WalletAddr, balance)
 
-	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, balance, true)
+	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, balance, api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	if err != nil {
 		return fmt.Errorf("failed to create payment channel: %w", err)
 	}
@@ -230,7 +233,10 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 	// we wait for 2 confirmations, so we have the assurance the channel is tracked.
 
 	t.RecordMessage("reloading paych; now it should have an address")
-	channel, err = cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, big.Zero(), true)
+	channel, err = cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, big.Zero(), api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	if err != nil {
 		return fmt.Errorf("failed to reload payment channel: %w", err)
 	}
diff --git a/testplans/lotus-soup/paych/stress.go b/testplans/lotus-soup/paych/stress.go
index e0d324f03e9..2f90308d8ee 100644
--- a/testplans/lotus-soup/paych/stress.go
+++ b/testplans/lotus-soup/paych/stress.go
@@ -124,7 +124,10 @@ func runSender(ctx context.Context, t *testkit.TestEnvironment, clients []*testk
 
 	time.Sleep(20 * time.Second)
 
-	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, channelAmt, true)
+	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, channelAmt, api.PaychGetOpts{
+		Reserve:  true,
+		OffChain: false,
+	})
 	if err != nil {
 		return fmt.Errorf("failed to create payment channel: %w", err)
 	}

From 4235a97cf4f7f485c02b090cee9f5b70cdcdf77c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Thu, 6 Jan 2022 16:26:25 +0100
Subject: [PATCH 13/24] retrieval: OffChainRetrieval config

---
 markets/retrievaladapter/client.go | 13 ++++++---
 node/builder_chain.go              |  4 ++-
 node/config/doc_gen.go             |  8 ++++++
 node/config/types.go               |  5 ++++
 node/modules/client.go             | 42 ++++++++++++++++--------------
 5 files changed, 48 insertions(+), 24 deletions(-)

diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 601f9f2550f..60f41ca296d 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -41,6 +41,8 @@ func extractPaychReusedCid(c cid.Cid) (address.Address, error) {
 }
 
 type retrievalClientNode struct {
+	forceOffChain bool
+
 	chainAPI full.ChainAPI
 	payAPI   payapi.PaychAPI
 	stateAPI full.StateAPI
@@ -48,8 +50,13 @@ type retrievalClientNode struct {
 
 // NewRetrievalClientNode returns a new node adapter for a retrieval client that talks to the
 // Lotus Node
-func NewRetrievalClientNode(payAPI payapi.PaychAPI, chainAPI full.ChainAPI, stateAPI full.StateAPI) retrievalmarket.RetrievalClientNode {
-	return &retrievalClientNode{payAPI: payAPI, chainAPI: chainAPI, stateAPI: stateAPI}
+func NewRetrievalClientNode(forceOffChain bool, payAPI payapi.PaychAPI, chainAPI full.ChainAPI, stateAPI full.StateAPI) retrievalmarket.RetrievalClientNode {
+	return &retrievalClientNode{
+		forceOffChain: forceOffChain,
+		chainAPI:      chainAPI,
+		payAPI:        payAPI,
+		stateAPI:      stateAPI,
+	}
 }
 
 // GetOrCreatePaymentChannel sets up a new payment channel if one does not exist
@@ -60,7 +67,7 @@ func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, c
 	// querying the chain
 	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable, api.PaychGetOpts{
 		Reserve:  true,
-		OffChain: false,
+		OffChain: rcn.forceOffChain,
 	})
 	if err != nil {
 		return address.Undef, cid.Undef, err
diff --git a/node/builder_chain.go b/node/builder_chain.go
index 11283ec3a09..0d10dcb9b22 100644
--- a/node/builder_chain.go
+++ b/node/builder_chain.go
@@ -121,7 +121,7 @@ var ChainNode = Options(
 	// Markets (retrieval)
 	Override(new(discovery.PeerResolver), modules.RetrievalResolver),
 	Override(new(retrievalmarket.BlockstoreAccessor), modules.RetrievalBlockstoreAccessor),
-	Override(new(retrievalmarket.RetrievalClient), modules.RetrievalClient),
+	Override(new(retrievalmarket.RetrievalClient), modules.RetrievalClient(false)),
 	Override(new(dtypes.ClientDataTransfer), modules.NewClientGraphsyncDataTransfer),
 
 	// Markets (storage)
@@ -221,6 +221,8 @@ func ConfigFullNode(c interface{}) Option {
 		),
 		Override(new(dtypes.Graphsync), modules.Graphsync(cfg.Client.SimultaneousTransfersForStorage, cfg.Client.SimultaneousTransfersForRetrieval)),
 
+		Override(new(retrievalmarket.RetrievalClient), modules.RetrievalClient(cfg.Client.OffChainRetrieval)),
+
 		If(cfg.Wallet.RemoteBackend != "",
 			Override(new(*remotewallet.RemoteWallet), remotewallet.SetupRemoteWallet(cfg.Wallet.RemoteBackend)),
 		),
diff --git a/node/config/doc_gen.go b/node/config/doc_gen.go
index c3730cbace6..59181f9f625 100644
--- a/node/config/doc_gen.go
+++ b/node/config/doc_gen.go
@@ -105,6 +105,14 @@ and storage providers for storage deals`,
 			Comment: `The maximum number of simultaneous data transfers between the client
 and storage providers for retrieval deals`,
 		},
+		{
+			Name: "OffChainRetrieval",
+			Type: "bool",
+
+			Comment: `Require that retrievals perform no on-chain retrievals. Paid retrievals
+without existing payment channels with available funds will fail instead
+of automatically performing on-chain operations.`,
+		},
 	},
 	"Common": []DocField{
 		{
diff --git a/node/config/types.go b/node/config/types.go
index 715f4824861..7e9064614f5 100644
--- a/node/config/types.go
+++ b/node/config/types.go
@@ -383,6 +383,11 @@ type Client struct {
 	// The maximum number of simultaneous data transfers between the client
 	// and storage providers for retrieval deals
 	SimultaneousTransfersForRetrieval uint64
+
+	// Require that retrievals perform no on-chain retrievals. Paid retrievals
+	// without existing payment channels with available funds will fail instead
+	// of automatically performing on-chain operations.
+	OffChainRetrieval bool
 }
 
 type Wallet struct {
diff --git a/node/modules/client.go b/node/modules/client.go
index 48f9dc3d778..1e74182041d 100644
--- a/node/modules/client.go
+++ b/node/modules/client.go
@@ -202,26 +202,28 @@ func StorageClient(lc fx.Lifecycle, h host.Host, dataTransfer dtypes.ClientDataT
 }
 
 // RetrievalClient creates a new retrieval client attached to the client blockstore
-func RetrievalClient(lc fx.Lifecycle, h host.Host, r repo.LockedRepo, dt dtypes.ClientDataTransfer, payAPI payapi.PaychAPI, resolver discovery.PeerResolver,
+func RetrievalClient(forceOffChain bool) func(lc fx.Lifecycle, h host.Host, r repo.LockedRepo, dt dtypes.ClientDataTransfer, payAPI payapi.PaychAPI, resolver discovery.PeerResolver,
 	ds dtypes.MetadataDS, chainAPI full.ChainAPI, stateAPI full.StateAPI, accessor retrievalmarket.BlockstoreAccessor, j journal.Journal) (retrievalmarket.RetrievalClient, error) {
-
-	adapter := retrievaladapter.NewRetrievalClientNode(payAPI, chainAPI, stateAPI)
-	network := rmnet.NewFromLibp2pHost(h)
-	ds = namespace.Wrap(ds, datastore.NewKey("/retrievals/client"))
-	client, err := retrievalimpl.NewClient(network, dt, adapter, resolver, ds, accessor)
-	if err != nil {
-		return nil, err
+	return func(lc fx.Lifecycle, h host.Host, r repo.LockedRepo, dt dtypes.ClientDataTransfer, payAPI payapi.PaychAPI, resolver discovery.PeerResolver,
+		ds dtypes.MetadataDS, chainAPI full.ChainAPI, stateAPI full.StateAPI, accessor retrievalmarket.BlockstoreAccessor, j journal.Journal) (retrievalmarket.RetrievalClient, error) {
+		adapter := retrievaladapter.NewRetrievalClientNode(forceOffChain, payAPI, chainAPI, stateAPI)
+		network := rmnet.NewFromLibp2pHost(h)
+		ds = namespace.Wrap(ds, datastore.NewKey("/retrievals/client"))
+		client, err := retrievalimpl.NewClient(network, dt, adapter, resolver, ds, accessor)
+		if err != nil {
+			return nil, err
+		}
+		client.OnReady(marketevents.ReadyLogger("retrieval client"))
+		lc.Append(fx.Hook{
+			OnStart: func(ctx context.Context) error {
+				client.SubscribeToEvents(marketevents.RetrievalClientLogger)
+
+				evtType := j.RegisterEventType("markets/retrieval/client", "state_change")
+				client.SubscribeToEvents(markets.RetrievalClientJournaler(j, evtType))
+
+				return client.Start(ctx)
+			},
+		})
+		return client, nil
 	}
-	client.OnReady(marketevents.ReadyLogger("retrieval client"))
-	lc.Append(fx.Hook{
-		OnStart: func(ctx context.Context) error {
-			client.SubscribeToEvents(marketevents.RetrievalClientLogger)
-
-			evtType := j.RegisterEventType("markets/retrieval/client", "state_change")
-			client.SubscribeToEvents(markets.RetrievalClientJournaler(j, evtType))
-
-			return client.Start(ctx)
-		},
-	})
-	return client, nil
 }

From 8f9e730ad66d7d3d973dc4204a6645cb09f31c01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Thu, 6 Jan 2022 18:02:34 +0100
Subject: [PATCH 14/24] paych: Better off-chain errors

---
 markets/retrievaladapter/client.go |  1 +
 paychmgr/simple.go                 | 13 ++++++++-----
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 60f41ca296d..97a157b19cd 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -70,6 +70,7 @@ func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, c
 		OffChain: rcn.forceOffChain,
 	})
 	if err != nil {
+		log.Errorw("paych get failed", "error", err)
 		return address.Undef, cid.Undef, err
 	}
 	if ci.WaitSentinel == cid.Undef {
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index ffb13b6c233..ef0f81b8748 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -186,7 +186,10 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 				// can't fill, so OffChain want an error
 				if r.isActive() {
 					failed = types.BigAdd(failed, r.amt)
-					r.onComplete(&paychFundsRes{channel: *channelInfo.Channel, err: xerrors.Errorf("not enough available funds in the payment channel")})
+					r.onComplete(&paychFundsRes{
+						channel: *channelInfo.Channel,
+						err:     xerrors.Errorf("not enough funds available in the payment channel %s; add funds with 'lotus paych add-funds %s %s %s'", channelInfo.Channel, channelInfo.from(), channelInfo.to(), types.FIL(r.amt).Unitless()),
+					})
 				}
 				next = i + 1
 				continue
@@ -212,7 +215,7 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 	return nil, used, failed
 }
 
-func (m *mergedFundsReq) failOffChain(msg string) (*paychFundsRes, types.BigInt) {
+func (m *mergedFundsReq) failOffChainNoChannel(from, to address.Address) (*paychFundsRes, types.BigInt) {
 	next := 0
 	freed := types.NewInt(0)
 
@@ -225,13 +228,13 @@ func (m *mergedFundsReq) failOffChain(msg string) (*paychFundsRes, types.BigInt)
 		if !r.isActive() {
 			continue
 		}
-		r.onComplete(&paychFundsRes{err: xerrors.New(msg)})
+		r.onComplete(&paychFundsRes{err: xerrors.Errorf("payment channel doesn't exist, create with 'lotus paych add-funds %s %s %s'", from, to, types.FIL(r.amt).Unitless())})
 		next = i + 1
 	}
 
 	m.reqs = m.reqs[next:]
 	if len(m.reqs) == 0 {
-		return &paychFundsRes{err: xerrors.New(msg)}, freed
+		return &paychFundsRes{err: xerrors.Errorf("payment channel doesn't exist, create with 'lotus paych add-funds %s %s 0'", from, to)}, freed
 	}
 
 	return nil, freed
@@ -440,7 +443,7 @@ func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.
 
 	// If a channel has not yet been created, create one.
 	if channelInfo == nil {
-		res, freed := merged.failOffChain("payment channel doesn't exist")
+		res, freed := merged.failOffChainNoChannel(ca.from, ca.to)
 		if res != nil {
 			return res
 		}

From 550e2743d727f5322ccfc7261d42c7509a2b185d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Thu, 6 Jan 2022 19:51:26 +0100
Subject: [PATCH 15/24] paych: Don't return settling/collected chennals from
 OutboundActiveByFromTo

---
 build/openrpc/full.json.gz                 | Bin 26594 -> 26976 bytes
 documentation/en/default-lotus-config.toml |   8 ++
 paychmgr/paych.go                          |   2 +-
 paychmgr/paych_test.go                     |  12 +--
 paychmgr/paychget_test.go                  | 108 ++++++++++++++++++++-
 paychmgr/simple.go                         |   2 +-
 paychmgr/store.go                          |  20 +++-
 7 files changed, 140 insertions(+), 12 deletions(-)

diff --git a/build/openrpc/full.json.gz b/build/openrpc/full.json.gz
index ae8f0b86655688ef335478f8abf47bf58d1ca299..55e96a3aa48e38cb9febb44d3c03b0c3bbc5f34b 100644
GIT binary patch
literal 26976
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%0AXoSG^T#Z%E
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

literal 26594
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
GVE+e$XyMKP

diff --git a/documentation/en/default-lotus-config.toml b/documentation/en/default-lotus-config.toml
index 3cb8977b290..016e1290cb9 100644
--- a/documentation/en/default-lotus-config.toml
+++ b/documentation/en/default-lotus-config.toml
@@ -121,6 +121,14 @@
   # env var: LOTUS_CLIENT_SIMULTANEOUSTRANSFERSFORRETRIEVAL
   #SimultaneousTransfersForRetrieval = 20
 
+  # Require that retrievals perform no on-chain retrievals. Paid retrievals
+  # without existing payment channels with available funds will fail instead
+  # of automatically performing on-chain operations.
+  #
+  # type: bool
+  # env var: LOTUS_CLIENT_OFFCHAINRETRIEVAL
+  #OffChainRetrieval = false
+
 
 [Wallet]
   # type: string
diff --git a/paychmgr/paych.go b/paychmgr/paych.go
index 16c6604c6ca..5fdb4d8842e 100644
--- a/paychmgr/paych.go
+++ b/paychmgr/paych.go
@@ -106,7 +106,7 @@ func (ca *channelAccessor) outboundActiveByFromTo(ctx context.Context, from, to
 	ca.lk.Lock()
 	defer ca.lk.Unlock()
 
-	return ca.store.OutboundActiveByFromTo(ctx, from, to)
+	return ca.store.OutboundActiveByFromTo(ctx, ca.api, from, to)
 }
 
 // createVoucher creates a voucher with the given specification, setting its
diff --git a/paychmgr/paych_test.go b/paychmgr/paych_test.go
index 165c945b8cb..24214d1b585 100644
--- a/paychmgr/paych_test.go
+++ b/paychmgr/paych_test.go
@@ -465,18 +465,18 @@ func TestAddVoucherInboundWalletKey(t *testing.T) {
 	toAcct := tutils.NewActorAddr(t, "toAct")
 
 	// Create an actor for the channel in state
-	act := &types.Actor{
-		Code:    builtin.AccountActorCodeID,
-		Head:    cid.Cid{},
-		Nonce:   0,
-		Balance: types.NewInt(20),
-	}
 
 	mock := newMockManagerAPI()
 
 	mock.setAccountAddress(fromAcct, from)
 	mock.setAccountAddress(toAcct, to)
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
 	mock.setPaychState(ch, act, paychmock.NewMockPayChState(fromAcct, toAcct, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
 
 	// Create a manager
diff --git a/paychmgr/paychget_test.go b/paychmgr/paychget_test.go
index f16b146f627..c53a85d86a0 100644
--- a/paychmgr/paychget_test.go
+++ b/paychmgr/paychget_test.go
@@ -132,6 +132,14 @@ func TestPaychGetCreateChannelThenAddFunds(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -219,6 +227,14 @@ func TestPaychGetCreatePrefundedChannelThenAddFunds(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -406,6 +422,14 @@ func TestPaychGetRecoverAfterAddFundsError(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -502,6 +526,14 @@ func TestPaychGetRestartAfterCreateChannelMsg(t *testing.T) {
 	mock2 := newMockManagerAPI()
 	defer mock2.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock2.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr2, err := newManager(store, mock2)
 	require.NoError(t, err)
 
@@ -566,6 +598,14 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 
 	mock := newMockManagerAPI()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -590,6 +630,8 @@ func TestPaychGetRestartAfterAddFundsMsg(t *testing.T) {
 	mock2 := newMockManagerAPI()
 	defer mock2.close()
 
+	mock2.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr2, err := newManager(store, mock2)
 	require.NoError(t, err)
 
@@ -625,10 +667,19 @@ func TestPaychGetWait(t *testing.T) {
 
 	from := tutils.NewIDAddr(t, 101)
 	to := tutils.NewIDAddr(t, 102)
+	expch := tutils.NewIDAddr(t, 100)
 
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(expch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -637,7 +688,6 @@ func TestPaychGetWait(t *testing.T) {
 	_, createMsgCid, err := mgr.GetPaych(ctx, from, to, amt, onChainReserve)
 	require.NoError(t, err)
 
-	expch := tutils.NewIDAddr(t, 100)
 	go func() {
 		// 3. Send response
 		response := testChannelResponse(t, expch)
@@ -763,6 +813,14 @@ func TestPaychGetMergeAddFunds(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -859,6 +917,14 @@ func TestPaychGetMergePrefundAndReserve(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -955,6 +1021,14 @@ func TestPaychGetMergePrefundAndReservePrefunded(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -1052,6 +1126,14 @@ func TestPaychGetMergePrefundAndReservePrefundedOneOffchain(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -1130,6 +1212,14 @@ func TestPaychGetMergePrefundAndReservePrefundedBothOffchainOneFail(t *testing.T
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -1208,6 +1298,14 @@ func TestPaychGetMergePrefundAndReserveOneOffchainOneFail(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
@@ -1295,6 +1393,14 @@ func TestPaychGetMergeAddFundsCtxCancelOne(t *testing.T) {
 	mock := newMockManagerAPI()
 	defer mock.close()
 
+	act := &types.Actor{
+		Code:    builtin.AccountActorCodeID,
+		Head:    cid.Cid{},
+		Nonce:   0,
+		Balance: types.NewInt(20),
+	}
+	mock.setPaychState(ch, act, paychmock.NewMockPayChState(from, to, abi.ChainEpoch(0), make(map[uint64]paych.LaneState)))
+
 	mgr, err := newManager(store, mock)
 	require.NoError(t, err)
 
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index ef0f81b8748..56bea0d27f8 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -436,7 +436,7 @@ func (ca *channelAccessor) processTask(merged *mergedFundsReq, amt, avail types.
 	// Get the payment channel for the from/to addresses.
 	// Note: It's ok if we get ErrChannelNotTracked. It just means we need to
 	// create a channel.
-	channelInfo, err := ca.store.OutboundActiveByFromTo(ctx, ca.from, ca.to)
+	channelInfo, err := ca.store.OutboundActiveByFromTo(ctx, ca.api, ca.from, ca.to)
 	if err != nil && err != ErrChannelNotTracked {
 		return &paychFundsRes{err: err}
 	}
diff --git a/paychmgr/store.go b/paychmgr/store.go
index d5c8e198049..7d6ee32be67 100644
--- a/paychmgr/store.go
+++ b/paychmgr/store.go
@@ -6,9 +6,8 @@ import (
 	"errors"
 	"fmt"
 
-	"golang.org/x/xerrors"
-
 	"github.com/google/uuid"
+	"golang.org/x/xerrors"
 
 	"github.com/filecoin-project/lotus/chain/types"
 
@@ -380,7 +379,7 @@ func (ps *Store) GetMessage(ctx context.Context, mcid cid.Cid) (*MsgInfo, error)
 
 // OutboundActiveByFromTo looks for outbound channels that have not been
 // settled, with the given from / to addresses
-func (ps *Store) OutboundActiveByFromTo(ctx context.Context, from address.Address, to address.Address) (*ChannelInfo, error) {
+func (ps *Store) OutboundActiveByFromTo(ctx context.Context, sma stateManagerAPI, from address.Address, to address.Address) (*ChannelInfo, error) {
 	return ps.findChan(ctx, func(ci *ChannelInfo) bool {
 		if ci.Direction != DirOutbound {
 			return false
@@ -388,6 +387,21 @@ func (ps *Store) OutboundActiveByFromTo(ctx context.Context, from address.Addres
 		if ci.Settling {
 			return false
 		}
+
+		if ci.Channel != nil {
+			_, st, err := sma.GetPaychState(ctx, *ci.Channel, nil)
+			if err != nil {
+				return false
+			}
+			sat, err := st.SettlingAt()
+			if err != nil {
+				return false
+			}
+			if sat != 0 {
+				return false
+			}
+		}
+
 		return ci.Control == from && ci.Target == to
 	})
 }

From f61eb23f8f6ff69af8b83fe3e398c6a40177eada Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Mon, 14 Feb 2022 19:56:02 +0100
Subject: [PATCH 16/24] api: separate method for paych funding

---
 api/api_full.go                             |   9 +++---
 api/mocks/mock_full.go                      |  15 ++++++++++
 api/proxy_gen.go                            |  13 ++++++++
 api/v0api/v1_wrapper.go                     |   5 +---
 build/openrpc/full.json.gz                  | Bin 26979 -> 27021 bytes
 build/openrpc/miner.json.gz                 | Bin 12903 -> 12906 bytes
 build/openrpc/worker.json.gz                | Bin 3960 -> 3959 bytes
 cli/paych.go                                |  12 +++++---
 documentation/en/api-v1-unstable-methods.md |  31 ++++++++++++++++++--
 markets/retrievaladapter/client.go          |   1 -
 node/impl/paych/paych.go                    |  19 ++++++++----
 paychmgr/manager.go                         |  12 +++++++-
 paychmgr/simple.go                          |   6 ++--
 13 files changed, 98 insertions(+), 25 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index 853d4928390..6fd34ddfbab 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -690,14 +690,16 @@ type FullNode interface {
 	// The Paych methods are for interacting with and managing payment channels
 
 	// PaychGet gets or creates a payment channel between address pair
-	//  - If opts.Reserve is false, the specified amount will be added to the channel through on-chain send for future use
-	//  - If opts.Reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+	//  The specified amount will be reserved for use. If there aren't enough non-reserved funds
 	//    available, funds will be added through an on-chain message.
 	//  - When opts.OffChain is true, this call will not cause any messages to be sent to the chain (no automatic
 	//    channel creation/funds adding). If the operation can't be performed without sending a message an error will be
 	//    returned. Note that even when this option is specified, this call can be blocked by previous operations on the
 	//    channel waiting for on-chain operations.
-	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts PaychGetOpts) (*ChannelInfo, error)  //perm:sign
+	PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts PaychGetOpts) (*ChannelInfo, error) //perm:sign
+	// PaychFund gets or creates a payment channel between address pair.
+	// The specified amount will be added to the channel through on-chain send for future use
+	PaychFund(ctx context.Context, from, to address.Address, amt types.BigInt) (*ChannelInfo, error)                    //perm:sign
 	PaychGetWaitReady(context.Context, cid.Cid) (address.Address, error)                                                //perm:sign
 	PaychAvailableFunds(ctx context.Context, ch address.Address) (*ChannelAvailableFunds, error)                        //perm:sign
 	PaychAvailableFundsByFromTo(ctx context.Context, from, to address.Address) (*ChannelAvailableFunds, error)          //perm:sign
@@ -837,7 +839,6 @@ const (
 )
 
 type PaychGetOpts struct {
-	Reserve  bool
 	OffChain bool
 }
 
diff --git a/api/mocks/mock_full.go b/api/mocks/mock_full.go
index 5d42ba3c918..ab120abdd22 100644
--- a/api/mocks/mock_full.go
+++ b/api/mocks/mock_full.go
@@ -1975,6 +1975,21 @@ func (mr *MockFullNodeMockRecorder) PaychCollect(arg0, arg1 interface{}) *gomock
 	return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "PaychCollect", reflect.TypeOf((*MockFullNode)(nil).PaychCollect), arg0, arg1)
 }
 
+// PaychFund mocks base method.
+func (m *MockFullNode) PaychFund(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int) (*api.ChannelInfo, error) {
+	m.ctrl.T.Helper()
+	ret := m.ctrl.Call(m, "PaychFund", arg0, arg1, arg2, arg3)
+	ret0, _ := ret[0].(*api.ChannelInfo)
+	ret1, _ := ret[1].(error)
+	return ret0, ret1
+}
+
+// PaychFund indicates an expected call of PaychFund.
+func (mr *MockFullNodeMockRecorder) PaychFund(arg0, arg1, arg2, arg3 interface{}) *gomock.Call {
+	mr.mock.ctrl.T.Helper()
+	return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "PaychFund", reflect.TypeOf((*MockFullNode)(nil).PaychFund), arg0, arg1, arg2, arg3)
+}
+
 // PaychGet mocks base method.
 func (m *MockFullNode) PaychGet(arg0 context.Context, arg1, arg2 address.Address, arg3 big.Int, arg4 api.PaychGetOpts) (*api.ChannelInfo, error) {
 	m.ctrl.T.Helper()
diff --git a/api/proxy_gen.go b/api/proxy_gen.go
index c90ec4cddb5..0f849343058 100644
--- a/api/proxy_gen.go
+++ b/api/proxy_gen.go
@@ -306,6 +306,8 @@ type FullNodeStruct struct {
 
 		PaychCollect func(p0 context.Context, p1 address.Address) (cid.Cid, error) `perm:"sign"`
 
+		PaychFund func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) `perm:"sign"`
+
 		PaychGet func(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 PaychGetOpts) (*ChannelInfo, error) `perm:"sign"`
 
 		PaychGetWaitReady func(p0 context.Context, p1 cid.Cid) (address.Address, error) `perm:"sign"`
@@ -2185,6 +2187,17 @@ func (s *FullNodeStub) PaychCollect(p0 context.Context, p1 address.Address) (cid
 	return *new(cid.Cid), ErrNotSupported
 }
 
+func (s *FullNodeStruct) PaychFund(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) {
+	if s.Internal.PaychFund == nil {
+		return nil, ErrNotSupported
+	}
+	return s.Internal.PaychFund(p0, p1, p2, p3)
+}
+
+func (s *FullNodeStub) PaychFund(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt) (*ChannelInfo, error) {
+	return nil, ErrNotSupported
+}
+
 func (s *FullNodeStruct) PaychGet(p0 context.Context, p1 address.Address, p2 address.Address, p3 types.BigInt, p4 PaychGetOpts) (*ChannelInfo, error) {
 	if s.Internal.PaychGet == nil {
 		return nil, ErrNotSupported
diff --git a/api/v0api/v1_wrapper.go b/api/v0api/v1_wrapper.go
index 1c22eb920ad..3f2dd837391 100644
--- a/api/v0api/v1_wrapper.go
+++ b/api/v0api/v1_wrapper.go
@@ -338,10 +338,7 @@ func (w *WrapperV1Full) clientRetrieve(ctx context.Context, order RetrievalOrder
 }
 
 func (w *WrapperV1Full) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
-	return w.FullNode.PaychGet(ctx, from, to, amt, api.PaychGetOpts{
-		Reserve:  true, // v0 always reserves
-		OffChain: false,
-	})
+	return w.FullNode.PaychFund(ctx, from, to, amt)
 }
 
 var _ FullNode = &WrapperV1Full{}
diff --git a/build/openrpc/full.json.gz b/build/openrpc/full.json.gz
index b486a5123c56815d472f15994443f8b2b91bb98b..676ffbf4fe668ccd3033379c9a6d6d2fbafb78c8 100644
GIT binary patch
delta 23020
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

delta 22996
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
bs7O=V`{O5aBzyf6009609MB4oXG{eEiOJL`

diff --git a/build/openrpc/miner.json.gz b/build/openrpc/miner.json.gz
index 5e9c824f58ab6dd0fcb0a1415e25b8e609bb088a..eef2701f28055a067fc6541177f878cc1d65172b 100644
GIT binary patch
delta 9997
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
X6Yc5g_UZoz00960Msc}WWOxDq3qE*}

delta 9994
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
U)9us$4*&rF{}2rT1Y~#u016+R00000

diff --git a/build/openrpc/worker.json.gz b/build/openrpc/worker.json.gz
index 6eb21407b9538c0a1e3aaa4635df52b081c6b03e..9eb0c4c010bbe1f4c518f7a1e7510dbedfd7103e 100644
GIT binary patch
delta 2861
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
L16T(u2Ic?&TbQ6;

delta 2862
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
M{}si&qXy;x0Q~c!O#lD@

diff --git a/cli/paych.go b/cli/paych.go
index 78e661d155f..cb9035024fd 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -79,10 +79,14 @@ var paychAddFundsCmd = &cli.Command{
 
 		// Send a message to chain to create channel / add funds to existing
 		// channel
-		info, err := api.PaychGet(ctx, from, to, types.BigInt(amt), lapi.PaychGetOpts{
-			Reserve:  cctx.Bool("reserve"),
-			OffChain: false,
-		})
+		var info *lapi.ChannelInfo
+		if cctx.Bool("reserve") {
+			info, err = api.PaychGet(ctx, from, to, types.BigInt(amt), lapi.PaychGetOpts{
+				OffChain: false,
+			})
+		} else {
+			info, err = api.PaychFund(ctx, from, to, types.BigInt(amt))
+		}
 		if err != nil {
 			return err
 		}
diff --git a/documentation/en/api-v1-unstable-methods.md b/documentation/en/api-v1-unstable-methods.md
index 2926faab7c8..966a0348c49 100644
--- a/documentation/en/api-v1-unstable-methods.md
+++ b/documentation/en/api-v1-unstable-methods.md
@@ -147,6 +147,7 @@
   * [PaychAvailableFunds](#PaychAvailableFunds)
   * [PaychAvailableFundsByFromTo](#PaychAvailableFundsByFromTo)
   * [PaychCollect](#PaychCollect)
+  * [PaychFund](#PaychFund)
   * [PaychGet](#PaychGet)
   * [PaychGetWaitReady](#PaychGetWaitReady)
   * [PaychList](#PaychList)
@@ -4512,10 +4513,35 @@ Response:
 }
 ```
 
+### PaychFund
+PaychFund gets or creates a payment channel between address pair.
+The specified amount will be added to the channel through on-chain send for future use
+
+
+Perms: sign
+
+Inputs:
+```json
+[
+  "f01234",
+  "f01234",
+  "0"
+]
+```
+
+Response:
+```json
+{
+  "Channel": "f01234",
+  "WaitSentinel": {
+    "/": "bafy2bzacea3wsdh6y3a36tb3skempjoxqpuyompjbmfeyf34fi3uy6uue42v4"
+  }
+}
+```
+
 ### PaychGet
 PaychGet gets or creates a payment channel between address pair
- - If opts.Reserve is false, the specified amount will be added to the channel through on-chain send for future use
- - If opts.Reserve is true, the specified amount will be reserved for use. If there aren't enough non-reserved funds
+ The specified amount will be reserved for use. If there aren't enough non-reserved funds
    available, funds will be added through an on-chain message.
  - When opts.OffChain is true, this call will not cause any messages to be sent to the chain (no automatic
    channel creation/funds adding). If the operation can't be performed without sending a message an error will be
@@ -4532,7 +4558,6 @@ Inputs:
   "f01234",
   "0",
   {
-    "Reserve": true,
     "OffChain": true
   }
 ]
diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index 97a157b19cd..b5535bcfc43 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -66,7 +66,6 @@ func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, c
 	// TODO: respect the provided TipSetToken (a serialized TipSetKey) when
 	// querying the chain
 	ci, err := rcn.payAPI.PaychGet(ctx, clientAddress, minerAddress, clientFundsAvailable, api.PaychGetOpts{
-		Reserve:  true,
 		OffChain: rcn.forceOffChain,
 	})
 	if err != nil {
diff --git a/node/impl/paych/paych.go b/node/impl/paych/paych.go
index 2d8777dbb9a..28e50625e93 100644
--- a/node/impl/paych/paych.go
+++ b/node/impl/paych/paych.go
@@ -23,7 +23,19 @@ type PaychAPI struct {
 }
 
 func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts api.PaychGetOpts) (*api.ChannelInfo, error) {
-	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, opts)
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, true, opts)
+	if err != nil {
+		return nil, err
+	}
+
+	return &api.ChannelInfo{
+		Channel:      ch,
+		WaitSentinel: mcid,
+	}, nil
+}
+
+func (a *PaychAPI) PaychFund(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, false, api.PaychGetOpts{OffChain: false})
 	if err != nil {
 		return nil, err
 	}
@@ -55,10 +67,7 @@ func (a *PaychAPI) PaychNewPayment(ctx context.Context, from, to address.Address
 
 	// TODO: Fix free fund tracking in PaychGet
 	// TODO: validate voucher spec before locking funds
-	ch, err := a.PaychGet(ctx, from, to, amount, api.PaychGetOpts{
-		Reserve:  true,
-		OffChain: false,
-	})
+	ch, err := a.PaychGet(ctx, from, to, amount, api.PaychGetOpts{OffChain: false})
 	if err != nil {
 		return nil, err
 	}
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index 7045a7dcd23..46466266d7b 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -101,7 +101,17 @@ func (pm *Manager) Stop() error {
 	return nil
 }
 
-func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, opts api.PaychGetOpts) (address.Address, cid.Cid, error) {
+type getOpts struct {
+	Reserve  bool
+	OffChain bool
+}
+
+func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool, o api.PaychGetOpts) (address.Address, cid.Cid, error) {
+	opts := getOpts{
+		Reserve:  reserve,
+		OffChain: o.OffChain,
+	}
+
 	if !opts.Reserve && opts.OffChain {
 		return address.Undef, cid.Undef, xerrors.Errorf("can't fund payment channels without on-chain operations")
 	}
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 56bea0d27f8..cc6a9286180 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -33,14 +33,14 @@ type fundsReq struct {
 	ctx     context.Context
 	promise chan *paychFundsRes
 	amt     types.BigInt
-	opts    api.PaychGetOpts
+	opts    getOpts
 
 	lk sync.Mutex
 	// merge parent, if this req is part of a merge
 	merge *mergedFundsReq
 }
 
-func newFundsReq(ctx context.Context, amt types.BigInt, opts api.PaychGetOpts) *fundsReq {
+func newFundsReq(ctx context.Context, amt types.BigInt, opts getOpts) *fundsReq {
 	promise := make(chan *paychFundsRes, 1)
 	return &fundsReq{
 		ctx:     ctx,
@@ -251,7 +251,7 @@ func (m *mergedFundsReq) failOffChainNoChannel(from, to address.Address) (*paych
 // address and the CID of the new add funds message.
 // If an operation returns an error, subsequent waiting operations will still
 // be attempted.
-func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, opts api.PaychGetOpts) (address.Address, cid.Cid, error) {
+func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, opts getOpts) (address.Address, cid.Cid, error) {
 	// Add the request to add funds to a queue and wait for the result
 	freq := newFundsReq(ctx, amt, opts)
 	ca.enqueue(ctx, freq)

From df5bd147fadc63060187aa8795644e22402781a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@users.noreply.github.com>
Date: Mon, 14 Feb 2022 20:07:13 +0100
Subject: [PATCH 17/24] paychmgr: Review comments

Co-authored-by: Hannah Howard <hannah@hannahhoward.net>
Co-authored-by: dirkmc <dirkmdev@gmail.com>
---
 api/api_full.go                            | 2 +-
 documentation/en/default-lotus-config.toml | 2 +-
 node/config/types.go                       | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index 6fd34ddfbab..d6f657ad01e 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -866,7 +866,7 @@ type ChannelAvailableFunds struct {
 	PendingAmt types.BigInt
 	// AvailableAmt is part of ConfirmedAmt that is available for use (pre-allocated)
 	AvailableAmt types.BigInt
-	// PendingAvailableAmt is the amount of available funds that are pending confirmation on-chain
+// PendingAvailableAmt is the amount of funds that are pending confirmation on-chain that will become available once confirmed
 	PendingAvailableAmt types.BigInt
 	// PendingWaitSentinel can be used with PaychGetWaitReady to wait for
 	// confirmation of pending funds
diff --git a/documentation/en/default-lotus-config.toml b/documentation/en/default-lotus-config.toml
index 7ef8f6309a1..ad917814b0d 100644
--- a/documentation/en/default-lotus-config.toml
+++ b/documentation/en/default-lotus-config.toml
@@ -121,7 +121,7 @@
   # env var: LOTUS_CLIENT_SIMULTANEOUSTRANSFERSFORRETRIEVAL
   #SimultaneousTransfersForRetrieval = 20
 
-  # Require that retrievals perform no on-chain retrievals. Paid retrievals
+  # Require that retrievals perform no on-chain operations. Paid retrievals
   # without existing payment channels with available funds will fail instead
   # of automatically performing on-chain operations.
   #
diff --git a/node/config/types.go b/node/config/types.go
index 762b8b6eb27..b073735d32e 100644
--- a/node/config/types.go
+++ b/node/config/types.go
@@ -388,7 +388,7 @@ type Client struct {
 	// and storage providers for retrieval deals
 	SimultaneousTransfersForRetrieval uint64
 
-	// Require that retrievals perform no on-chain retrievals. Paid retrievals
+	// Require that retrievals perform no on-chain operations. Paid retrievals
 	// without existing payment channels with available funds will fail instead
 	// of automatically performing on-chain operations.
 	OffChainRetrieval bool

From 36a193484568ecbbf59763239c9943683f1bfff4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Mon, 14 Feb 2022 20:16:30 +0100
Subject: [PATCH 18/24] paychmgr: Fix tests after api changes

---
 itests/paych_api_test.go  |  1 -
 node/impl/paych/paych.go  | 10 ++++++++--
 paychmgr/manager.go       |  9 ++-------
 paychmgr/paychget_test.go |  9 ++++-----
 paychmgr/simple.go        |  6 +++---
 5 files changed, 17 insertions(+), 18 deletions(-)

diff --git a/itests/paych_api_test.go b/itests/paych_api_test.go
index 074551a8376..1a39fd606a7 100644
--- a/itests/paych_api_test.go
+++ b/itests/paych_api_test.go
@@ -66,7 +66,6 @@ func TestPaymentChannelsAPI(t *testing.T) {
 
 	channelAmt := int64(7000)
 	channelInfo, err := paymentCreator.PaychGet(ctx, createrAddr, receiverAddr, abi.NewTokenAmount(channelAmt), api.PaychGetOpts{
-		Reserve:  true,
 		OffChain: false,
 	})
 	require.NoError(t, err)
diff --git a/node/impl/paych/paych.go b/node/impl/paych/paych.go
index 28e50625e93..d338c6032fd 100644
--- a/node/impl/paych/paych.go
+++ b/node/impl/paych/paych.go
@@ -23,7 +23,10 @@ type PaychAPI struct {
 }
 
 func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt types.BigInt, opts api.PaychGetOpts) (*api.ChannelInfo, error) {
-	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, true, opts)
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, paychmgr.GetOpts{
+		Reserve:  true,
+		OffChain: opts.OffChain,
+	})
 	if err != nil {
 		return nil, err
 	}
@@ -35,7 +38,10 @@ func (a *PaychAPI) PaychGet(ctx context.Context, from, to address.Address, amt t
 }
 
 func (a *PaychAPI) PaychFund(ctx context.Context, from, to address.Address, amt types.BigInt) (*api.ChannelInfo, error) {
-	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, false, api.PaychGetOpts{OffChain: false})
+	ch, mcid, err := a.PaychMgr.GetPaych(ctx, from, to, amt, paychmgr.GetOpts{
+		Reserve:  false,
+		OffChain: false,
+	})
 	if err != nil {
 		return nil, err
 	}
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index 46466266d7b..081ef4c5d19 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -101,17 +101,12 @@ func (pm *Manager) Stop() error {
 	return nil
 }
 
-type getOpts struct {
+type GetOpts struct {
 	Reserve  bool
 	OffChain bool
 }
 
-func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, reserve bool, o api.PaychGetOpts) (address.Address, cid.Cid, error) {
-	opts := getOpts{
-		Reserve:  reserve,
-		OffChain: o.OffChain,
-	}
-
+func (pm *Manager) GetPaych(ctx context.Context, from, to address.Address, amt types.BigInt, opts GetOpts) (address.Address, cid.Cid, error) {
 	if !opts.Reserve && opts.OffChain {
 		return address.Undef, cid.Undef, xerrors.Errorf("can't fund payment channels without on-chain operations")
 	}
diff --git a/paychmgr/paychget_test.go b/paychmgr/paychget_test.go
index a508fdfc96a..0688301e883 100644
--- a/paychmgr/paychget_test.go
+++ b/paychmgr/paychget_test.go
@@ -19,26 +19,25 @@ import (
 	init2 "github.com/filecoin-project/specs-actors/v2/actors/builtin/init"
 	tutils "github.com/filecoin-project/specs-actors/v2/support/testing"
 
-	"github.com/filecoin-project/lotus/api"
 	lotusinit "github.com/filecoin-project/lotus/chain/actors/builtin/init"
 	"github.com/filecoin-project/lotus/chain/actors/builtin/paych"
 	paychmock "github.com/filecoin-project/lotus/chain/actors/builtin/paych/mock"
 	"github.com/filecoin-project/lotus/chain/types"
 )
 
-var onChainReserve = api.PaychGetOpts{
+var onChainReserve = GetOpts{
 	Reserve:  true,
 	OffChain: false,
 }
-var onChainNoReserve = api.PaychGetOpts{
+var onChainNoReserve = GetOpts{
 	Reserve:  false,
 	OffChain: false,
 }
-var offChainReserve = api.PaychGetOpts{
+var offChainReserve = GetOpts{
 	Reserve:  true,
 	OffChain: true,
 }
-var offChainNoReserve = api.PaychGetOpts{
+var offChainNoReserve = GetOpts{
 	Reserve:  false,
 	OffChain: true,
 }
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index cc6a9286180..0eb1316af57 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -33,14 +33,14 @@ type fundsReq struct {
 	ctx     context.Context
 	promise chan *paychFundsRes
 	amt     types.BigInt
-	opts    getOpts
+	opts    GetOpts
 
 	lk sync.Mutex
 	// merge parent, if this req is part of a merge
 	merge *mergedFundsReq
 }
 
-func newFundsReq(ctx context.Context, amt types.BigInt, opts getOpts) *fundsReq {
+func newFundsReq(ctx context.Context, amt types.BigInt, opts GetOpts) *fundsReq {
 	promise := make(chan *paychFundsRes, 1)
 	return &fundsReq{
 		ctx:     ctx,
@@ -251,7 +251,7 @@ func (m *mergedFundsReq) failOffChainNoChannel(from, to address.Address) (*paych
 // address and the CID of the new add funds message.
 // If an operation returns an error, subsequent waiting operations will still
 // be attempted.
-func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, opts getOpts) (address.Address, cid.Cid, error) {
+func (ca *channelAccessor) getPaych(ctx context.Context, amt types.BigInt, opts GetOpts) (address.Address, cid.Cid, error) {
 	// Add the request to add funds to a queue and wait for the result
 	freq := newFundsReq(ctx, amt, opts)
 	ca.enqueue(ctx, freq)

From f9485eb9c253e3faa9304d7ec963233a14e66867 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@users.noreply.github.com>
Date: Mon, 14 Feb 2022 20:42:45 +0100
Subject: [PATCH 19/24] Update paychmgr/store.go

Co-authored-by: dirkmc <dirkmdev@gmail.com>
---
 paychmgr/store.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/paychmgr/store.go b/paychmgr/store.go
index 7d6ee32be67..f3c67e5650b 100644
--- a/paychmgr/store.go
+++ b/paychmgr/store.go
@@ -73,7 +73,7 @@ type ChannelInfo struct {
 	// has locally been added to the channel. It should reflect the channel's
 	// Balance on chain as long as all operations occur on the same datastore.
 	Amount types.BigInt
-	// AvailableAmount indicates how much afil is non-reverved
+	// AvailableAmount indicates how much afil is non-reserved
 	AvailableAmount types.BigInt
 	// PendingAvailableAmount is available amount that we're awaiting confirmation of
 	PendingAvailableAmount types.BigInt

From da5ae1efe178717f1c97401f67e3fd298cb74f03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Mon, 14 Feb 2022 21:11:31 +0100
Subject: [PATCH 20/24] paychmgr: erlier checks in completeAmount

---
 paychmgr/simple.go | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 0eb1316af57..5a23c7f2c05 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -179,6 +179,11 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 			break
 		}
 
+		// don't try to fill inactive requests
+		if !r.isActive() {
+			continue
+		}
+
 		if r.amt.GreaterThan(types.BigSub(avail, used)) {
 			// requests are sorted by amount ascending, so if we hit this, there aren't any more requests we can fill
 
@@ -198,11 +203,6 @@ func (m *mergedFundsReq) completeAmount(avail types.BigInt, channelInfo *Channel
 			break
 		}
 
-		// don't try to fill inactive requests
-		if !r.isActive() {
-			continue
-		}
-
 		used = types.BigAdd(used, r.amt)
 		r.onComplete(&paychFundsRes{channel: *channelInfo.Channel})
 		next = i + 1

From 60b9acc09d7d7fea061ce89ba1c6ae3fe5ae1ccf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Mon, 14 Feb 2022 21:16:41 +0100
Subject: [PATCH 21/24] gen

---
 api/api_full.go        | 2 +-
 node/config/doc_gen.go | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index d6f657ad01e..b621dd9fbb9 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -866,7 +866,7 @@ type ChannelAvailableFunds struct {
 	PendingAmt types.BigInt
 	// AvailableAmt is part of ConfirmedAmt that is available for use (pre-allocated)
 	AvailableAmt types.BigInt
-// PendingAvailableAmt is the amount of funds that are pending confirmation on-chain that will become available once confirmed
+	// PendingAvailableAmt is the amount of funds that are pending confirmation on-chain that will become available once confirmed
 	PendingAvailableAmt types.BigInt
 	// PendingWaitSentinel can be used with PaychGetWaitReady to wait for
 	// confirmation of pending funds
diff --git a/node/config/doc_gen.go b/node/config/doc_gen.go
index d160643c271..2a7f63180ce 100644
--- a/node/config/doc_gen.go
+++ b/node/config/doc_gen.go
@@ -109,7 +109,7 @@ and storage providers for retrieval deals`,
 			Name: "OffChainRetrieval",
 			Type: "bool",
 
-			Comment: `Require that retrievals perform no on-chain retrievals. Paid retrievals
+			Comment: `Require that retrievals perform no on-chain operations. Paid retrievals
 without existing payment channels with available funds will fail instead
 of automatically performing on-chain operations.`,
 		},

From e1a36058b44089ce1da97f3a85eaf07491057cf8 Mon Sep 17 00:00:00 2001
From: hannahhoward <hannah@hannahhoward.net>
Date: Tue, 15 Feb 2022 21:52:06 -0800
Subject: [PATCH 22/24] feat(markets): update markets to simplify client
 adapter

---
 go.mod                             |  2 +-
 go.sum                             |  4 ++--
 markets/retrievaladapter/client.go | 33 ------------------------------
 3 files changed, 3 insertions(+), 36 deletions(-)

diff --git a/go.mod b/go.mod
index f22400ded5a..6b6191de617 100644
--- a/go.mod
+++ b/go.mod
@@ -36,7 +36,7 @@ require (
 	github.com/filecoin-project/go-data-transfer v1.14.0
 	github.com/filecoin-project/go-fil-commcid v0.1.0
 	github.com/filecoin-project/go-fil-commp-hashhash v0.1.0
-	github.com/filecoin-project/go-fil-markets v1.19.0
+	github.com/filecoin-project/go-fil-markets v1.19.1
 	github.com/filecoin-project/go-jsonrpc v0.1.5
 	github.com/filecoin-project/go-padreader v0.0.1
 	github.com/filecoin-project/go-paramfetch v0.0.4
diff --git a/go.sum b/go.sum
index 6b725b5df74..3df9f4eb069 100644
--- a/go.sum
+++ b/go.sum
@@ -327,8 +327,8 @@ github.com/filecoin-project/go-fil-commcid v0.1.0 h1:3R4ds1A9r6cr8mvZBfMYxTS88Oq
 github.com/filecoin-project/go-fil-commcid v0.1.0/go.mod h1:Eaox7Hvus1JgPrL5+M3+h7aSPHc0cVqpSxA+TxIEpZQ=
 github.com/filecoin-project/go-fil-commp-hashhash v0.1.0 h1:imrrpZWEHRnNqqv0tN7LXep5bFEVOVmQWHJvl2mgsGo=
 github.com/filecoin-project/go-fil-commp-hashhash v0.1.0/go.mod h1:73S8WSEWh9vr0fDJVnKADhfIv/d6dCbAGaAGWbdJEI8=
-github.com/filecoin-project/go-fil-markets v1.19.0 h1:kap2q2wTM6tfkVO5gMA5DD9GUeTvkDhMfhjCtEwMDM8=
-github.com/filecoin-project/go-fil-markets v1.19.0/go.mod h1:qsb3apmo4RSJYCEq40QxVdU7UZospN6nFJLOBHuaIbc=
+github.com/filecoin-project/go-fil-markets v1.19.1 h1:o5sziAp8zCsvIg3KYMgIpwm8gyOl4MDzEKEf0Qq5L3U=
+github.com/filecoin-project/go-fil-markets v1.19.1/go.mod h1:qsb3apmo4RSJYCEq40QxVdU7UZospN6nFJLOBHuaIbc=
 github.com/filecoin-project/go-hamt-ipld v0.1.5 h1:uoXrKbCQZ49OHpsTCkrThPNelC4W3LPEk0OrS/ytIBM=
 github.com/filecoin-project/go-hamt-ipld v0.1.5/go.mod h1:6Is+ONR5Cd5R6XZoCse1CWaXZc0Hdb/JeX+EQCQzX24=
 github.com/filecoin-project/go-hamt-ipld/v2 v2.0.0 h1:b3UDemBYN2HNfk3KOXNuxgTTxlWi3xVvbQP0IT38fvM=
diff --git a/markets/retrievaladapter/client.go b/markets/retrievaladapter/client.go
index b5535bcfc43..74f02570b9e 100644
--- a/markets/retrievaladapter/client.go
+++ b/markets/retrievaladapter/client.go
@@ -9,8 +9,6 @@ import (
 	"github.com/filecoin-project/go-state-types/abi"
 	"github.com/ipfs/go-cid"
 	"github.com/multiformats/go-multiaddr"
-	mh "github.com/multiformats/go-multihash"
-	"golang.org/x/xerrors"
 
 	"github.com/filecoin-project/lotus/api"
 	"github.com/filecoin-project/lotus/chain/actors/builtin/paych"
@@ -19,27 +17,6 @@ import (
 	payapi "github.com/filecoin-project/lotus/node/impl/paych"
 )
 
-func mkPaychReusedCid(addr address.Address) cid.Cid {
-	c, err := cid.V1Builder{Codec: cid.Raw, MhType: mh.IDENTITY}.Sum(addr.Bytes())
-	if err != nil {
-		panic(err)
-	}
-	return c
-}
-
-func extractPaychReusedCid(c cid.Cid) (address.Address, error) {
-	if c.Prefix().Codec != cid.Raw {
-		return address.Undef, nil
-	}
-
-	h, err := mh.Decode(c.Hash())
-	if err != nil {
-		return address.Address{}, err
-	}
-
-	return address.NewFromBytes(h.Digest)
-}
-
 type retrievalClientNode struct {
 	forceOffChain bool
 
@@ -72,9 +49,6 @@ func (rcn *retrievalClientNode) GetOrCreatePaymentChannel(ctx context.Context, c
 		log.Errorw("paych get failed", "error", err)
 		return address.Undef, cid.Undef, err
 	}
-	if ci.WaitSentinel == cid.Undef {
-		return ci.Channel, mkPaychReusedCid(ci.Channel), nil
-	}
 
 	return ci.Channel, ci.WaitSentinel, nil
 }
@@ -112,13 +86,6 @@ func (rcn *retrievalClientNode) GetChainHead(ctx context.Context) (shared.TipSet
 }
 
 func (rcn *retrievalClientNode) WaitForPaymentChannelReady(ctx context.Context, messageCID cid.Cid) (address.Address, error) {
-	maybeAddr, err := extractPaychReusedCid(messageCID)
-	if err != nil {
-		return address.Address{}, xerrors.Errorf("extract paych reused CID: %w", err)
-	}
-	if maybeAddr != address.Undef {
-		return maybeAddr, nil
-	}
 	return rcn.payAPI.PaychGetWaitReady(ctx, messageCID)
 }
 

From e961766e4b7c8813816371e8cda1d2e490160a48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 16 Feb 2022 10:08:44 +0100
Subject: [PATCH 23/24] fix lotus-soup build

---
 testplans/lotus-soup/deals_e2e.go    |  2 --
 testplans/lotus-soup/go.mod          |  2 +-
 testplans/lotus-soup/go.sum          | 13 +++++++------
 testplans/lotus-soup/paych/stress.go |  1 -
 4 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/testplans/lotus-soup/deals_e2e.go b/testplans/lotus-soup/deals_e2e.go
index d9be97f6cae..44eec2d7ab1 100644
--- a/testplans/lotus-soup/deals_e2e.go
+++ b/testplans/lotus-soup/deals_e2e.go
@@ -208,7 +208,6 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 	t.RecordMessage("creating payment channel; from=%s, to=%s, funds=%d", cl.Wallet.Address, recv.WalletAddr, balance)
 
 	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, balance, api.PaychGetOpts{
-		Reserve:  true,
 		OffChain: false,
 	})
 	if err != nil {
@@ -234,7 +233,6 @@ func initPaymentChannel(t *testkit.TestEnvironment, ctx context.Context, cl *tes
 
 	t.RecordMessage("reloading paych; now it should have an address")
 	channel, err = cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, big.Zero(), api.PaychGetOpts{
-		Reserve:  true,
 		OffChain: false,
 	})
 	if err != nil {
diff --git a/testplans/lotus-soup/go.mod b/testplans/lotus-soup/go.mod
index f227452e7ae..94673c08119 100644
--- a/testplans/lotus-soup/go.mod
+++ b/testplans/lotus-soup/go.mod
@@ -9,7 +9,7 @@ require (
 	github.com/drand/drand v1.3.0
 	github.com/filecoin-project/go-address v0.0.6
 	github.com/filecoin-project/go-data-transfer v1.14.0
-	github.com/filecoin-project/go-fil-markets v1.19.0
+	github.com/filecoin-project/go-fil-markets v1.19.1
 	github.com/filecoin-project/go-jsonrpc v0.1.5
 	github.com/filecoin-project/go-state-types v0.1.3
 	github.com/filecoin-project/go-storedcounter v0.1.0
diff --git a/testplans/lotus-soup/go.sum b/testplans/lotus-soup/go.sum
index 23877f87b44..62a41703a05 100644
--- a/testplans/lotus-soup/go.sum
+++ b/testplans/lotus-soup/go.sum
@@ -418,8 +418,8 @@ github.com/filecoin-project/go-fil-commcid v0.1.0 h1:3R4ds1A9r6cr8mvZBfMYxTS88Oq
 github.com/filecoin-project/go-fil-commcid v0.1.0/go.mod h1:Eaox7Hvus1JgPrL5+M3+h7aSPHc0cVqpSxA+TxIEpZQ=
 github.com/filecoin-project/go-fil-commp-hashhash v0.1.0 h1:imrrpZWEHRnNqqv0tN7LXep5bFEVOVmQWHJvl2mgsGo=
 github.com/filecoin-project/go-fil-commp-hashhash v0.1.0/go.mod h1:73S8WSEWh9vr0fDJVnKADhfIv/d6dCbAGaAGWbdJEI8=
-github.com/filecoin-project/go-fil-markets v1.19.0 h1:kap2q2wTM6tfkVO5gMA5DD9GUeTvkDhMfhjCtEwMDM8=
-github.com/filecoin-project/go-fil-markets v1.19.0/go.mod h1:qsb3apmo4RSJYCEq40QxVdU7UZospN6nFJLOBHuaIbc=
+github.com/filecoin-project/go-fil-markets v1.19.1 h1:o5sziAp8zCsvIg3KYMgIpwm8gyOl4MDzEKEf0Qq5L3U=
+github.com/filecoin-project/go-fil-markets v1.19.1/go.mod h1:qsb3apmo4RSJYCEq40QxVdU7UZospN6nFJLOBHuaIbc=
 github.com/filecoin-project/go-hamt-ipld v0.1.5 h1:uoXrKbCQZ49OHpsTCkrThPNelC4W3LPEk0OrS/ytIBM=
 github.com/filecoin-project/go-hamt-ipld v0.1.5/go.mod h1:6Is+ONR5Cd5R6XZoCse1CWaXZc0Hdb/JeX+EQCQzX24=
 github.com/filecoin-project/go-hamt-ipld/v2 v2.0.0 h1:b3UDemBYN2HNfk3KOXNuxgTTxlWi3xVvbQP0IT38fvM=
@@ -473,8 +473,8 @@ github.com/filecoin-project/specs-actors/v7 v7.0.0-20211117170924-fd07a4c7dff9/g
 github.com/filecoin-project/specs-actors/v7 v7.0.0-20211222192039-c83bea50c402/go.mod h1:p6LIOFezA1rgRLMewbvdi3Pp6SAu+q9FtJ9CAleSjrE=
 github.com/filecoin-project/specs-actors/v7 v7.0.0-rc1 h1:FuDaXIbcw2hRsFI8SDTmsGGCE+NumpF6aiBoU/2X5W4=
 github.com/filecoin-project/specs-actors/v7 v7.0.0-rc1/go.mod h1:TA5FwCna+Yi36POaT7SLKXsgEDvJwc0V/L6ZsO19B9M=
-github.com/filecoin-project/specs-storage v0.1.1-0.20211228030229-6d460d25a0c9 h1:oUYOvF7EvdXS0Zmk9mNkaB6Bu0l+WXBYPzVodKMiLug=
-github.com/filecoin-project/specs-storage v0.1.1-0.20211228030229-6d460d25a0c9/go.mod h1:Tb88Zq+IBJbvAn3mS89GYj3jdRThBTE/771HCVZdRJU=
+github.com/filecoin-project/specs-storage v0.2.0 h1:Y4UDv0apRQ3zI2GiPPubi8JblpUZZphEdaJUxCutfyg=
+github.com/filecoin-project/specs-storage v0.2.0/go.mod h1:Tb88Zq+IBJbvAn3mS89GYj3jdRThBTE/771HCVZdRJU=
 github.com/filecoin-project/test-vectors/schema v0.0.5/go.mod h1:iQ9QXLpYWL3m7warwvK1JC/pTri8mnfEmKygNDqqY6E=
 github.com/flynn/go-shlex v0.0.0-20150515145356-3f9db97f8568/go.mod h1:xEzjJPgXI435gkrCt3MPfRiAkVrwSbHsst4LCFVfpJc=
 github.com/flynn/noise v1.0.0 h1:DlTHqmzmvcEiKj+4RYo/imoswx/4r6iBlCMfVtrMXpQ=
@@ -1411,8 +1411,9 @@ github.com/libp2p/go-libp2p-record v0.1.2/go.mod h1:pal0eNcT5nqZaTV7UGhqeGqxFgGd
 github.com/libp2p/go-libp2p-record v0.1.3 h1:R27hoScIhQf/A8XJZ8lYpnqh9LatJ5YbHs28kCIfql0=
 github.com/libp2p/go-libp2p-record v0.1.3/go.mod h1:yNUff/adKIfPnYQXgp6FQmNu3gLJ6EMg7+/vv2+9pY4=
 github.com/libp2p/go-libp2p-resource-manager v0.1.0/go.mod h1:wJPNjeE4XQlxeidwqVY5G6DLOKqFK33u2n8blpl0I6Y=
-github.com/libp2p/go-libp2p-resource-manager v0.1.3 h1:Umf0tW6WNXSb6Uoma0YT56azB5iikL/aeGAP7s7+f5o=
 github.com/libp2p/go-libp2p-resource-manager v0.1.3/go.mod h1:wJPNjeE4XQlxeidwqVY5G6DLOKqFK33u2n8blpl0I6Y=
+github.com/libp2p/go-libp2p-resource-manager v0.1.4 h1:RcxMD0pytOUimx3BqTVs6IqItb3H5Qg44SD7XyT68lw=
+github.com/libp2p/go-libp2p-resource-manager v0.1.4/go.mod h1:wJPNjeE4XQlxeidwqVY5G6DLOKqFK33u2n8blpl0I6Y=
 github.com/libp2p/go-libp2p-routing v0.0.1/go.mod h1:N51q3yTr4Zdr7V8Jt2JIktVU+3xBBylx1MZeVA6t1Ys=
 github.com/libp2p/go-libp2p-routing v0.1.0/go.mod h1:zfLhI1RI8RLEzmEaaPwzonRvXeeSHddONWkcTcB54nE=
 github.com/libp2p/go-libp2p-routing-helpers v0.2.3 h1:xY61alxJ6PurSi+MXbywZpelvuU4U4p/gPTxjqCqTzY=
@@ -2941,4 +2942,4 @@ sigs.k8s.io/yaml v1.1.0/go.mod h1:UJmg0vDUVViEyp3mgSv9WPwZCDxu4rQW1olrI1uml+o=
 sigs.k8s.io/yaml v1.2.0/go.mod h1:yfXDCHCao9+ENCvLSE62v9VSji2MKu5jeNfTrofGhJc=
 sourcegraph.com/sourcegraph/appdash v0.0.0-20190731080439-ebfcffb1b5c0/go.mod h1:hI742Nqp5OhwiqlzhgfbWU4mW4yO10fP+LoT9WOswdU=
 sourcegraph.com/sourcegraph/go-diff v0.5.0/go.mod h1:kuch7UrkMzY0X+p9CRK03kfuPQ2zzQcaEFbx8wA8rck=
-sourcegraph.com/sqs/pbtypes v0.0.0-20180604144634-d3ebe8f20ae4/go.mod h1:ketZ/q3QxT9HOBeFhu6RdvsftgpsbFHBF5Cas6cDKZ0=
\ No newline at end of file
+sourcegraph.com/sqs/pbtypes v0.0.0-20180604144634-d3ebe8f20ae4/go.mod h1:ketZ/q3QxT9HOBeFhu6RdvsftgpsbFHBF5Cas6cDKZ0=
diff --git a/testplans/lotus-soup/paych/stress.go b/testplans/lotus-soup/paych/stress.go
index 2f90308d8ee..4f107bf5b67 100644
--- a/testplans/lotus-soup/paych/stress.go
+++ b/testplans/lotus-soup/paych/stress.go
@@ -125,7 +125,6 @@ func runSender(ctx context.Context, t *testkit.TestEnvironment, clients []*testk
 	time.Sleep(20 * time.Second)
 
 	channel, err := cl.FullApi.PaychGet(ctx, cl.Wallet.Address, recv.WalletAddr, channelAmt, api.PaychGetOpts{
-		Reserve:  true,
 		OffChain: false,
 	})
 	if err != nil {

From 384999556c95b2638f1b5f17a3456c781bc90936 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Magiera?= <magik6k@gmail.com>
Date: Wed, 16 Feb 2022 20:39:43 +0100
Subject: [PATCH 24/24] paychmgr: AvailableAmt -> NonReservedAmt

---
 api/api_full.go                             |  11 +++++++----
 build/openrpc/full.json.gz                  | Bin 27021 -> 27027 bytes
 cli/paych.go                                |   2 +-
 documentation/en/api-v0-methods.md          |   4 ++--
 documentation/en/api-v1-unstable-methods.md |   4 ++--
 paychmgr/manager.go                         |   2 +-
 paychmgr/simple.go                          |   2 +-
 7 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/api/api_full.go b/api/api_full.go
index b621dd9fbb9..4c4d6ebf936 100644
--- a/api/api_full.go
+++ b/api/api_full.go
@@ -859,20 +859,23 @@ type ChannelAvailableFunds struct {
 	From address.Address
 	// To is the to address of the channel
 	To address.Address
-	// ConfirmedAmt is the amount of funds that have been confirmed on-chain
-	// for the channel
+
+	// ConfirmedAmt is the total amount of funds that have been confirmed on-chain for the channel
 	ConfirmedAmt types.BigInt
 	// PendingAmt is the amount of funds that are pending confirmation on-chain
 	PendingAmt types.BigInt
-	// AvailableAmt is part of ConfirmedAmt that is available for use (pre-allocated)
-	AvailableAmt types.BigInt
+
+	// NonReservedAmt is part of ConfirmedAmt that is available for use (e.g. when the payment channel was pre-funded)
+	NonReservedAmt types.BigInt
 	// PendingAvailableAmt is the amount of funds that are pending confirmation on-chain that will become available once confirmed
 	PendingAvailableAmt types.BigInt
+
 	// PendingWaitSentinel can be used with PaychGetWaitReady to wait for
 	// confirmation of pending funds
 	PendingWaitSentinel *cid.Cid
 	// QueuedAmt is the amount that is queued up behind a pending request
 	QueuedAmt types.BigInt
+
 	// VoucherRedeemedAmt is the amount that is redeemed by vouchers on-chain
 	// and in the local datastore
 	VoucherReedeemedAmt types.BigInt
diff --git a/build/openrpc/full.json.gz b/build/openrpc/full.json.gz
index 53dbbc6c5cb8486ce2acc67f62bf4689c0f171bf..db9366703169bb100e0c4bd04e6047b4f8dee184 100644
GIT binary patch
delta 26956
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

delta 26995
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
Ww&{`V<!=B00RR7nTG>heQ3U|rd8rHl

diff --git a/cli/paych.go b/cli/paych.go
index cb9035024fd..92c1a13e31f 100644
--- a/cli/paych.go
+++ b/cli/paych.go
@@ -200,7 +200,7 @@ func paychStatus(writer io.Writer, avail *lapi.ChannelAvailableFunds) {
 		{"From", avail.From.String()},
 		{"To", avail.To.String()},
 		{"Confirmed Amt", fmt.Sprintf("%s", types.FIL(avail.ConfirmedAmt))},
-		{"Available Amt", fmt.Sprintf("%s", types.FIL(avail.AvailableAmt))},
+		{"Available Amt", fmt.Sprintf("%s", types.FIL(avail.NonReservedAmt))},
 		{"Voucher Redeemed Amt", fmt.Sprintf("%s", types.FIL(avail.VoucherReedeemedAmt))},
 		{"Pending Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAmt))},
 		{"Pending Available Amt", fmt.Sprintf("%s", types.FIL(avail.PendingAvailableAmt))},
diff --git a/documentation/en/api-v0-methods.md b/documentation/en/api-v0-methods.md
index 2061d7fadb7..9444444f569 100644
--- a/documentation/en/api-v0-methods.md
+++ b/documentation/en/api-v0-methods.md
@@ -4061,7 +4061,7 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
-  "AvailableAmt": "0",
+  "NonReservedAmt": "0",
   "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
@@ -4090,7 +4090,7 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
-  "AvailableAmt": "0",
+  "NonReservedAmt": "0",
   "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
diff --git a/documentation/en/api-v1-unstable-methods.md b/documentation/en/api-v1-unstable-methods.md
index 966a0348c49..22e85901c9a 100644
--- a/documentation/en/api-v1-unstable-methods.md
+++ b/documentation/en/api-v1-unstable-methods.md
@@ -4457,7 +4457,7 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
-  "AvailableAmt": "0",
+  "NonReservedAmt": "0",
   "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
@@ -4486,7 +4486,7 @@ Response:
   "To": "f01234",
   "ConfirmedAmt": "0",
   "PendingAmt": "0",
-  "AvailableAmt": "0",
+  "NonReservedAmt": "0",
   "PendingAvailableAmt": "0",
   "PendingWaitSentinel": null,
   "QueuedAmt": "0",
diff --git a/paychmgr/manager.go b/paychmgr/manager.go
index 081ef4c5d19..ea77c67efbe 100644
--- a/paychmgr/manager.go
+++ b/paychmgr/manager.go
@@ -151,7 +151,7 @@ func (pm *Manager) AvailableFundsByFromTo(ctx context.Context, from address.Addr
 			To:                  to,
 			ConfirmedAmt:        types.NewInt(0),
 			PendingAmt:          types.NewInt(0),
-			AvailableAmt:        types.NewInt(0),
+			NonReservedAmt:      types.NewInt(0),
 			PendingAvailableAmt: types.NewInt(0),
 			PendingWaitSentinel: nil,
 			QueuedAmt:           types.NewInt(0),
diff --git a/paychmgr/simple.go b/paychmgr/simple.go
index 5a23c7f2c05..3d0992efec7 100644
--- a/paychmgr/simple.go
+++ b/paychmgr/simple.go
@@ -417,7 +417,7 @@ func (ca *channelAccessor) currentAvailableFunds(ctx context.Context, channelID
 		To:                  channelInfo.to(),
 		ConfirmedAmt:        channelInfo.Amount,
 		PendingAmt:          channelInfo.PendingAmount,
-		AvailableAmt:        channelInfo.AvailableAmount,
+		NonReservedAmt:      channelInfo.AvailableAmount,
 		PendingAvailableAmt: channelInfo.PendingAvailableAmount,
 		PendingWaitSentinel: waitSentinel,
 		QueuedAmt:           queuedAmt,