Skip to content

feat: add SP settlement tooling - #15

Merged
pyropy merged 4 commits into
filbeam:mainfrom
Chaitu-Tatipamula:feat/sp-settlement-tooling
Mar 17, 2026
Merged

feat: add SP settlement tooling#15
pyropy merged 4 commits into
filbeam:mainfrom
Chaitu-Tatipamula:feat/sp-settlement-tooling

Conversation

@Chaitu-Tatipamula

@Chaitu-Tatipamula Chaitu-Tatipamula commented Jan 31, 2026

Copy link
Copy Markdown
Contributor

Adds CLI tooling for Storage Providers to settle cache-miss payments.

Changes

  • tools/settle-sp.sh - Bash script to batch settle cache-miss amounts
  • TUTORIAL.md - Setup guide for SPs
  • DEPLOYMENT.md - Updated deployment docs

How it works

  1. SPs provide dataset IDs
  2. Checks cacheMissAmount > 0 on FilBeamOperator
  3. Batches settlements (max 50 per tx) with detailed tx output

Usage

export PRIVATE_KEY=0x...
export OPERATOR_ADDRESS=0x...
./tools/settle-sp.sh

Closes #2

@pyropy pyropy left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great first pass! Let's try to optimize querying the data set ids. Also, if you're to use Synapse SDK you could also automatically detect FWSS contract address.

Comment thread tools/settle-sp.sh Outdated
Comment thread tools/settle-sp.sh Outdated
Comment thread tools/settle-sp.sh Outdated
Comment thread DEPLOYMENT.md Outdated
Comment thread TUTORIAL.md Outdated

@pyropy pyropy left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Almost there! 🎉

Comment thread tools/settle-sp.sh Outdated
Comment thread tools/settle-cache-miss-egress.sh
Comment thread tools/TUTORIAL.md
- Rename OPERATOR_ADDRESS to FILBEAM_OPERATOR_ADDRESS for clarity
- Rename settle-sp.sh to settle-cache-miss-egress.sh
- Move TUTORIAL.md into tools/ directory
@bajtos
bajtos removed their request for review March 13, 2026 15:41
@pyropy
pyropy merged commit 6ef1b43 into filbeam:main Mar 17, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement SP Settlement Tooling

2 participants