Skip to content

docs(erc-4337): document auth headers and Openfort bundler/paymaster setup - #207

Draft
joalavedra wants to merge 2 commits into
tetherto:mainfrom
joalavedra:docs/erc-4337-auth-headers
Draft

docs(erc-4337): document auth headers and Openfort bundler/paymaster setup#207
joalavedra wants to merge 2 commits into
tetherto:mainfrom
joalavedra:docs/erc-4337-auth-headers

Conversation

@joalavedra

Copy link
Copy Markdown

Description

Documents the bundlerHeaders and paymasterHeaders config options on the wallet-evm-erc-4337
Configuration page, and adds an "Authenticated Bundlers and Paymasters" section with an Openfort
example.

  • New option sections Bundler Headers and Paymaster Headers, matching the existing option style.
  • New Authenticated Bundlers and Paymasters section showing Openfort (single RPC endpoint per
    chain, publishable key as a bearer token, sponsorship via a gas policy).
  • A warning callout notes that the account's EntryPoint version must match the version the provider's
    bundler serves.

Context

Pairs with the module change that adds these options:

The EntryPoint note references tetherto/wdk-wallet-evm-erc-4337#112.

… setup

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@ihsraham ihsraham 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.

The setup reads clearly. I left two comments on release timing and keeping the limitation wording durable.

}
```

### Bundler Headers

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.

The new configuration is useful. Let's keep this change in draft until we release the ERC-4337 package version containing bundlerHeaders and paymasterHeaders, then verify the examples against that released version before moving it forward.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Converted to draft — will verify the examples against the released package version once the ERC-4337 release containing bundlerHeaders/paymasterHeaders ships, then mark ready.

```

<Callout type="warn">
The account's EntryPoint version must match the version the provider's bundler serves. This module currently creates accounts on EntryPoint v0.7; a provider that only serves other versions (e.g. v0.6/v0.8/v0.9) rejects the operation with `-32602 Unsupported EntryPoint`. Confirm your provider serves v0.7, or track [making the EntryPoint version configurable](https://github.com/tetherto/wdk-wallet-evm-erc-4337/issues/112).

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.

Wouldn't it be better to state the EntryPoint v0.7 limitation directly and leave out the tracking-issue instruction? The limitation belongs in the docs, while issue status can change independently.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Agreed — the callout now states the v0.7 limitation directly and the tracking-issue pointer is gone (ff6a950).

Per review: keep the limitation in the docs and drop the
tracking-issue pointer, whose status can change independently.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@joalavedra
joalavedra marked this pull request as draft August 12, 2026 09:42
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