Skip to content

docs(wallets): correct BSO sponsorship expiry behavior - #1688

Open
jakehobbs wants to merge 2 commits into
mainfrom
jake/bso-expiry-docs-not-applicable
Open

jakehobbs wants to merge 2 commits into
mainfrom
jake/bso-expiry-docs-not-applicable

Conversation

@jakehobbs

@jakehobbs jakehobbs commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • The "Sponsorship expiry" row in the BSO vs paymaster table said "Not applicable" for BSO. That's incorrect.
  • For BSO, the policy's sponsorship expiry period starts when the bundler accepts the user operation. If the operation isn't bundled within it, the bundler drops it.
  • Clarified the paymaster column (window starts when paymaster data is generated) and added a sentence below the table.
  • Fixed the sponsorshipExpiryMs description in the Admin API spec ("from signing" → "after the sponsorship is issued").

Verified against source

  • wallet-server: eth_sendUserOperation calls sponsorBundlerOperation for BSO policies and forwards bundlerSponsorship.validUntil to rundler.
  • paymaster-services: validUntil is the current time plus the policy's sponsorship_expiry_ms.
  • rundler: expired ops are removed from the pool and rejected at bundling time.

I did not include a default expiry value in the docs.

🤖 Generated with Claude Code

BSO user operations do expire: the policy's sponsorship expiry period starts when the bundler accepts the operation, and the operation is dropped if not bundled within it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-07T19:24:49.768471Z a1fcf88 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

github-actions Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Oct 7, 2026, 7:29 PM

The value is added to the time the sponsorship is issued, not the time of signing, which doesn't apply to BSO.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@jakehobbs
jakehobbs requested a review from a team as a code owner October 7, 2026 19:28

This branch has not been deployed

No deployments
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.

2 participants