Skip to content

docs: add permissionless 0.x → 1.0.0 migration guide - #177

Draft
plusminushalf wants to merge 1 commit into
mainfrom
docs/permissionless-1.0-migration-guide
Draft

docs: add permissionless 0.x → 1.0.0 migration guide#177
plusminushalf wants to merge 1 commit into
mainfrom
docs/permissionless-1.0-migration-guide

Conversation

@plusminushalf

Copy link
Copy Markdown
Member

Adds the 0.x → 1.0.0 migration guide as a new ## 1.0.0 section at the top of the existing Migration Guide page (/references/permissionless/how-to/migration-guide).

Draft for review — do not merge before the 1.0.0 GA docs push. Opened so Vercel deploys a preview.

Structure (imitating viem's v2→v3 guide):

  • Migrate incrementally — npm-alias coexistence recipe: permissionless@0.x + viem@2 keep their real names, the new pair rides permissionless-v1/viem-v3 aliases with an overrides entry pointing the alias's viem peer at v3 (pnpm variant included).
  • Notable changes — viem 3 / no ox peer, ESM-only, 23→5 entrypoints, namespace grammar (SafeSmartAccount.from, SmartAccountClient.create), unified constructor convention with the frozen-defaults table, the Simple EntryPoint 0.7→0.8 counterfactual-address warning, unified nonce-key precedence, eip7702: true, Erc20Paymaster graduation, named error classes, new-in-1.0 list.
  • Removed APIs — kill-list with replacements.
  • Quick reference — alphabetized per-symbol tables for every renamed export and type.

Three GA-gated follow-ups are embedded as invisible {/* TODO */} MDX comments (frozen 0.x docs URL, prerelease install note, Safe setupTransactions address-reproduction gate).

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 18, 2026 10:23pm

Request Review

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.

1 participant