filecoin-project/filecoin-pin
View on GitHubfeat: allow payer to settle payment rails
Open
#54 opened on Sep 29, 2025
CLIenhancementgood first issuehelp wantedready-for-workteam/filecoin-pinteam/fs-wg
Repository metrics
- Stars
- (22 stars)
- PR merge metrics
- (PR metrics pending)
Description
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: querygetSettlementAmountsacross the payer's rails and show what is settleable. - Add a
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.- 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.