Skip to content

Add Openfort signer guide for Smart Accounts Kit#2956

Open
joalavedra wants to merge 5 commits into
MetaMask:mainfrom
joalavedra:2955-add-openfort-signer-guide
Open

Add Openfort signer guide for Smart Accounts Kit#2956
joalavedra wants to merge 5 commits into
MetaMask:mainfrom
joalavedra:2955-add-openfort-signer-guide

Conversation

@joalavedra

@joalavedra joalavedra commented Jun 10, 2026

Copy link
Copy Markdown

Description

Adds a "Use Openfort with MetaMask Smart Accounts" guide to the Configure signers section of the Smart Accounts Kit docs, following the structure of the existing Privy and Dynamic guides.

Openfort provides embedded wallets with social, email, and passkey sign-in via the @openfort/react SDK. Configured with accountType: AccountTypeEnum.EOA, the embedded wallet is an EOA that works as a smart account signer through the standard Wagmi Wallet Client — step 3 (toMetaMaskSmartAccount) is identical to the Privy and Dynamic guides.

Changes:

  • New page smart-accounts-kit/guides/smart-accounts/signers/openfort.md (and the same page in gator_versioned_docs/version-1.6.0/, since the existing signer guides are identical in both).
  • Adds Openfort to the signers index card list and keywords (both versions).
  • Adds the sidebar entry in gator-sidebar.js and gator_versioned_sidebars/version-1.6.0-sidebars.json.

Code samples are written against current SDK versions (@openfort/react@1.1.1, wagmi 3.x, viem 2.x) and verified against working integrations. Prettier passes on all changed files.

Disclosure: I'm a founder at Openfort and happy to keep this guide up to date as the SDK evolves.

Issue(s) fixed

Fixes #2955

Preview

  • /smart-accounts-kit/guides/smart-accounts/signers/openfort (and /smart-accounts-kit/development/guides/smart-accounts/signers/openfort)

Checklist

  • If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
  • If this PR updates or adds documentation content, it has received an approval from a technical writer.

External contributor checklist

  • I've read the contribution guidelines.
  • I've created a new issue (or assigned myself to an existing issue) describing what this PR addresses.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only additions with no application, auth, or infrastructure changes; factual accuracy of SDK snippets should be reviewed per contributor workflow.

Overview
Adds Openfort to the Smart Accounts Kit Configure signers docs so developers can wire Openfort’s embedded EOA wallet into MetaMask Smart Accounts the same way as Privy and Dynamic.

A new how-to page (openfort.md) covers installing @openfort/react, setting up OpenfortProvider with OpenfortWagmiBridge and accountType: AccountTypeEnum.EOA, and creating the smart account via Wagmi’s walletClient and toMetaMaskSmartAccount. The same page is duplicated under gator_versioned_docs/version-1.6.0/ to match other signer guides.

Navigation and discovery are updated in gator-sidebar.js, version-1.6.0-sidebars.json, and both signers index.mdx files (Openfort card plus openfort in frontmatter keywords). No vercel.json redirects are required because this is a new route only.

Reviewed by Cursor Bugbot for commit a9e75fc. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds a Configure signers guide for using Openfort embedded wallets
(EOA account type) as a MetaMask smart account signer, mirroring the
existing Privy and Dynamic guides. Updates the signers index card
list and sidebar in both the development docs and version 1.6.0.

Fixes MetaMask#2955

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@joalavedra joalavedra requested review from a team as code owners June 10, 2026 19:25
@vercel

vercel Bot commented Jun 10, 2026

Copy link
Copy Markdown

@joalavedra is attempting to deploy a commit to the Consensys Team on Vercel.

A member of the Team first needs to authorize it.

@AyushBherwani1998 AyushBherwani1998 self-assigned this Jun 22, 2026
Set `accountType` to `AccountTypeEnum.EOA` so that the embedded wallet is created as an EOA, which
acts as the signer for the smart account.

For an advanced configuration, see Openfort's [documentation](https://www.openfort.io/docs) for configuring appearance, login methods, and wallet recovery.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you link to the configuration docs? The doc points to overview.

You can keep the sentence to be

`See [Openfort's documentation](link to configuration docs) for an advanced configuration.

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.

Done — updated both copies of the guide to link to the React UI configuration page (https://www.openfort.io/docs/products/embedded-wallet/react/ui/configuration), which covers login methods, wallet recovery, and appearance/customization, instead of the docs overview. Pushed in 1b7a8b9.

joalavedra and others added 2 commits June 29, 2026 18:29
Point the advanced-configuration link at the React UI configuration docs
instead of the docs overview, per review feedback.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

Add Openfort signer guide to Smart Accounts Kit docs

3 participants