Skip to content

fix: gasless page - #252

Open
RishabhS7 wants to merge 7 commits into
masterfrom
fix/gasless-page
Open

fix: gasless page#252
RishabhS7 wants to merge 7 commits into
masterfrom
fix/gasless-page

Conversation

@RishabhS7

@RishabhS7 RishabhS7 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

change ‘Gasless’ to ‘Pay on Behalf’

Move the entire ‘Pay on behalf’ documentation into How Tos

in Overview, add a flow diagram for users, to describe the flow of the pay on behalf (try to highlight portion done by an Admin and portion experienced by the user of the wallet)

add new page call pay on behalf functionality on TT-web, as the 4th tab. this covers the “settings” frontend and it’s usage.

Add disclaimer

state clearly that this features works on TR v5 only

Summary by CodeRabbit

  • New Features
    • Added new “Pay on Behalf (EIP-7702)” documentation covering architecture, prerequisites, and a one-time setup flow.
    • Documented gasless workflows, including token registry deployment, document minting, title escrow actions, and return-to-issuer operations (with event guidance).
    • Added a how-to for configuring Pay on Behalf via TT-web settings, including eligibility and sponsored action behavior.
    • Updated the How Tos navigation to include the new Pay on Behalf documentation pages (overview, setup, operations, TT-web settings).

RishabhS7 and others added 4 commits July 2, 2026 16:03
Adds a new "Gasless (EIP-7702)" section to the sidebar with three pages:
- overview: architecture, deployed addresses for Sepolia and Polygon Amoy, SDK install
- setup: deployPlatformPaymaster, staking, user whitelisting, building smartAccountClient
- gasless-operations: code examples for all 12 SDK functions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… settings page

Renames the EIP-7702 gasless feature to "Pay on Behalf" across titles and prose
(SDK function names keep their Gasless suffix since those are real exports),
and relocates the section from a top-level sidebar entry into a How Tos
category. Adds an admin-vs-user flow diagram, explicit Token Registry v5
requirement, and a neutral disclaimer noting Pimlico is used as an example
provider rather than an endorsed dependency. Also documents the new Pay on
Behalf tab in TT-web's Settings panel, including the whitelist eligibility
check flow.
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@RishabhS7, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 59 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c303cc94-ff83-4cc8-bb5a-c24f4d813abc

📥 Commits

Reviewing files that changed from the base of the PR and between 30cb822 and 6f523b2.

📒 Files selected for processing (4)
  • docs/how-tos/pay-on-behalf/operations.md
  • docs/how-tos/pay-on-behalf/overview.md
  • docs/how-tos/pay-on-behalf/setup.md
  • sidebars.json
📝 Walkthrough

Walkthrough

Adds four Pay on Behalf documentation pages covering EIP-7702 architecture, setup, gasless operations, TT-web settings, and sidebar navigation. The documentation applies to Token Registry v5 and describes PlatformPaymaster-based ERC-4337 flows.

Changes

Pay on Behalf documentation

Layer / File(s) Summary
Architecture and prerequisites
docs/how-tos/pay-on-behalf/overview.md
Documents the EIP-7702/ERC-4337 flow, core contracts, deployed addresses, SDK imports, prerequisites, and beta limitations.
Platform setup and smart account construction
docs/how-tos/pay-on-behalf/setup.md
Describes bundler setup, paymaster deployment and staking, whitelisting, smart account construction, environment variables, and provider configuration.
Gasless document operations
docs/how-tos/pay-on-behalf/operations.md
Documents registry deployment, document minting, TitleEscrow actions, return-to-issuer operations, event parsing, and caller roles.
TT-web settings and navigation
docs/how-tos/pay-on-behalf/tt-web-settings.md, sidebars.json
Explains TT-web configuration and eligibility behavior, and adds the four pages to the How Tos sidebar.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers: rongquan1

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title is too generic and only loosely indicates the documentation update about Pay on Behalf/gasless flows. Use a specific title such as "docs: add Pay on Behalf (EIP-7702) how-tos" to describe the main change.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/gasless-page

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/how-tos/pay-on-behalf/operations.md`:
- Line 39: Update the UserOperation workflow before parsing RegistryDeployed and
TitleEscrowLinked events to call the bundler/permissionless
getUserOperationReceipt method with the returned UserOp hash; clarify that this
UserOperation receipt, rather than a normal transaction receipt lookup, is used
for event parsing.

In `@docs/how-tos/pay-on-behalf/overview.md`:
- Around line 149-158: Align the EIP-7702 delegation documentation with the
SDK’s actual canonical flow, choosing either separate type-4 delegation or
automatic delegation in the first UserOperation and applying it consistently.
Update the prerequisites and surrounding guidance in
docs/how-tos/pay-on-behalf/overview.md lines 149-158, then revise the
corresponding note in docs/how-tos/pay-on-behalf/setup.md lines 250-252; ensure
both pages describe the same delegation behavior.

In `@docs/how-tos/pay-on-behalf/setup.md`:
- Around line 188-200: Define the smart-account example’s configuration before
buildSmartAccountClient, sourcing the RPC endpoint from the documented
SEPOLIA_RPC_URL environment value and explicitly injecting the Pimlico API key.
Derive chainId from sepolia.id rather than leaving it undeclared, and use the
resulting configuration consistently in PIMLICO_URL, publicClient, and
walletClient setup.
- Around line 107-135: Update the staking snippet to import parseEther from viem
and replace the undefined deployerAccount in the addStake call with the
previously defined deployer symbol. Leave the existing deposit and staking
behavior unchanged.
- Around line 189-210: Update the to7702SimpleSmartAccount call in
buildSmartAccountClient to pass TrustVC’s Sepolia implementation via
accountLogicAddress set to 0xa46EC3920Ac5fc54F4bA33185A91ae250aDF59B8, instead
of relying on the Permissionless default.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8dc288c8-bb67-42a9-ba82-42ba38b9f72e

📥 Commits

Reviewing files that changed from the base of the PR and between 252c596 and 767049f.

📒 Files selected for processing (5)
  • docs/how-tos/pay-on-behalf/operations.md
  • docs/how-tos/pay-on-behalf/overview.md
  • docs/how-tos/pay-on-behalf/setup.md
  • docs/how-tos/pay-on-behalf/tt-web-settings.md
  • sidebars.json

Comment thread docs/how-tos/pay-on-behalf/operations.md Outdated
Comment thread docs/how-tos/pay-on-behalf/overview.md
Comment thread docs/how-tos/pay-on-behalf/setup.md Outdated
Comment thread docs/how-tos/pay-on-behalf/setup.md Outdated
Comment thread docs/how-tos/pay-on-behalf/setup.md Outdated
Comment thread docs/how-tos/pay-on-behalf/setup.md
RishabhS7 and others added 3 commits July 29, 2026 13:09
Replaces the Admin/User Mermaid diagrams in the Overview page with actual
product screenshots, and walks through the full TT-web eligibility-check
flow (delegation detection, pasting the PlatformPaymaster address, whitelist
check, and the signature prompt) with corresponding screenshots.
- Clarify returned value is a UserOperation hash and document the
  waitForUserOperationReceipt lookup before parsing paymaster events.
- Fix the EIP-7702 delegation flow: it's a separate one-time type-4
  transaction (user-owned wallet: user signs, platform submits; or
  platform-managed wallet: platform does both), not bundled into the
  first UserOperation.
- Add missing parseEther import and fix undefined deployerAccount ref
  in the staking snippet.
- Define chainId/PIMLICO_API_KEY/RPC_URL explicitly in the smart
  account client example instead of referencing undeclared values.
- Pass accountLogicAddress so to7702SimpleSmartAccount points at
  TrustVC's EIP7702Implementation instead of permissionless's default.
- Move the Pimlico disclaimer to the top of the Setup page.
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