Description
A payer can settle their own payment rails, not just the storage provider. Today filecoin-pin neither surfaces pending settlements nor offers a way to settle from the CLI.
This is a convenience, not a necessity: SPs settle their rails at least every lockupPeriod (30 days for WarmStorage). A client may still want to settle for accounting or to keep balances current.
Scope
The SDK already supports both halves (synapse-sdk payments.settle() and payments.getSettlementAmounts()):
- Surface pending settlements in
payments status: query getSettlementAmounts across the payer's rails and show what is settleable.
- Add a
payments settle [--rail <id>] command that settles via payments.settle().
Done criteria
payments status shows pending/settleable amounts per rail for the payer.
payments settle settles a payer's rail(s): --rail <id> targets one, default settles all settleable.
- Output reports the settled amount and final settled epoch (
SettlementResult).
Notes
Low priority. SPs and Curio tooling handle settlement in the normal path; this is a client-side convenience.
Description
A payer can settle their own payment rails, not just the storage provider. Today filecoin-pin neither surfaces pending settlements nor offers a way to settle from the CLI.
This is a convenience, not a necessity: SPs settle their rails at least every
lockupPeriod(30 days for WarmStorage). A client may still want to settle for accounting or to keep balances current.Scope
The SDK already supports both halves (synapse-sdk
payments.settle()andpayments.getSettlementAmounts()):payments status: querygetSettlementAmountsacross the payer's rails and show what is settleable.payments settle [--rail <id>]command that settles viapayments.settle().Done criteria
payments statusshows pending/settleable amounts per rail for the payer.payments settlesettles a payer's rail(s):--rail <id>targets one, default settles all settleable.SettlementResult).Notes
Low priority. SPs and Curio tooling handle settlement in the normal path; this is a client-side convenience.