Skip to content

Conversation

@avarobinson
Copy link
Contributor

Motivation

  • Make sponsorship options and limits easier to understand by providing a dedicated guide that explains built-in spending controls and conditional sponsorship use cases.
  • Consolidate scattered webhook documentation into a single, clear reference for webhook-based custom rules and expected request/response payloads.
  • Help teams choose a safe, practical setup pattern (dashboard vs Admin API, failure modes, and recommended defaults) so they can roll out sponsorship with predictable cost controls.

Description

  • Add a new page fern/wallets/pages/transactions/sponsor-gas/conditional-sponsorship-rules.mdx that documents built-in policy limits, webhook-based custom rules, request/response examples, and recommended setup patterns.
  • Update the Sponsor gas overview so the Conditional Sponsorship card links to the new rules page by changing fern/wallets/pages/transactions/sponsor-gas/overview.mdx.
  • Insert the new page into site navigation by updating fern/docs.yml under the Transactions → Sponsor gas section.

Testing

  • Ran pnpm -s prettier --check against the changed files (fern/wallets/pages/transactions/sponsor-gas/conditional-sponsorship-rules.mdx, fern/wallets/pages/transactions/sponsor-gas/overview.mdx, fern/docs.yml) and it passed.
  • Ran pnpm -s fern:check which failed in this environment due to external/network-related Fern telemetry and missing pre-generated specs unrelated to the docs edits, so it did not indicate issues with the content changes.

Codex Task

@avarobinson avarobinson requested a review from a team as a code owner February 11, 2026 05:47
@github-actions
Copy link

github-actions bot commented Feb 11, 2026

🌿 Documentation Preview

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Feb 12, 2026, 7:23 PM

@github-actions github-actions bot temporarily deployed to docs-preview February 11, 2026 05:48 Destroyed
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bcb2221862

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

* **Max transactions per user**: Limit number of sponsored transactions per user
* **Sender allowlist / blocklist**: Explicitly allow or deny sponsorship for selected senders

These limits are ideal for growth campaigns, onboarding credits, and controlled rollouts.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
These limits are ideal for growth campaigns, onboarding credits, and controlled rollouts.


1. Start with built-in limits for immediate spend protection
2. Add webhook rules for business-specific checks
3. Decide your failure mode (`approveOnFailure`) based on risk tolerance:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
3. Decide your failure mode (`approveOnFailure`) based on risk tolerance:

1. Start with built-in limits for immediate spend protection
2. Add webhook rules for business-specific checks
3. Decide your failure mode (`approveOnFailure`) based on risk tolerance:
* Prefer uptime: set to `true`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
* Prefer uptime: set to `true`

2. Add webhook rules for business-specific checks
3. Decide your failure mode (`approveOnFailure`) based on risk tolerance:
* Prefer uptime: set to `true`
* Prefer strict control: set to `false`
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
* Prefer strict control: set to `false`

@github-actions github-actions bot temporarily deployed to docs-preview February 12, 2026 19:20 Destroyed
@github-actions github-actions bot temporarily deployed to docs-preview February 12, 2026 19:20 Destroyed
@github-actions github-actions bot temporarily deployed to docs-preview February 12, 2026 19:21 Destroyed
@github-actions github-actions bot temporarily deployed to docs-preview February 12, 2026 19:21 Destroyed
@avarobinson avarobinson merged commit 7b63439 into main Feb 12, 2026
8 of 9 checks passed
@avarobinson avarobinson deleted the codex/create-documentation-for-sponsorship-rules branch February 12, 2026 20:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants