Skip to content

feat: allow payer to settle payment rails #54

Description

@SgtPooki

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIenhancementNew feature or requestgood first issueGood for newcomershelp wantedExtra attention is neededready-for-workTriaged: scope, plan, and DoD are clear; contributor can pick upteam/filecoin-pin"Filecoin Pin" project is a stakeholder for this work.team/fs-wgFOC working group is a stakeholder for this work, and thus wants to track it on their project board.

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions