As a follow up to #1621: Several tutorials depend on CLI tools, packages, or SDKs that have since been renamed, deprecated, or majorly upgraded upstream. The tutorials have been edited for writing style, but the exact commands, prompts, and terminal output shown probably no longer match what a reader will see if they follow the steps today. This issue tracks re-testing each tutorial end-to-end and updating tooling references.
1. MetaMask SDK → MetaMask Connect
MetaMask SDK is deprecated, replaced by MetaMask Connect (@metamask/connect-evm / @metamask/connect-multichain).
Affected:
marketplace-dapp.mdx — step 6, wagmi/connectors's metaMask()voting-dapp.mdx — step 7, same pattern, plus references "MetaMask SDK" in prosefirst-dapp.mdx — indirectly, via RainbowKit's default connector set
Action: decide whether to move these tutorials to MetaMask Connect directly, or to a connector-agnostic pattern (see network/how-to/connect-wallet.mdx, which already uses a plain injected() wagmi connector instead of MetaMask-specific code).
2. wagmi v2 → v3
wagmi v3 unbundles connector SDKs (no longer ships wallet SDKs by default) and introduces API changes (e.g., useConnection). eip-7702.mdx already uses useConnection, but marketplace-dapp.mdx, voting-dapp.mdx, and first-dapp.mdx still use v2-era patterns (useAccount, bundled metaMask() connector). Need to confirm which wagmi major version we want to standardize on across all tutorials and update accordingly.
3. shadcn CLI rename
The CLI package was renamed from shadcn-ui to shadcn; npx shadcn-ui@latest ... no longer resolves.
first-dapp.mdx still uses npx shadcn-ui@latest init and pnpm dlx shadcn-ui@atest add ... (also has a typo: @atest instead of @latest).
4. Hardhat 3
Hardhat 3 dropped the old interactive Hardhat 2 vs Hardhat 3 template chooser from npx hardhat --init. The prompt/output shown in marketplace-dapp.mdx (step 1) and voting-dapp.mdx (implied via Create Web3 Template) should be re-run and the screenshots/terminal output updated to match current output. Hardhat 3 also added non-interactive flags (--init --template <name>) that may be worth using instead of an interactive walkthrough.
5. Stale Consensys scaffolding packages
@consensys/create-web3-template (used in voting-dapp.mdx step 1) last published to npm in Nov 2024. Given wagmi v3 and MetaMask SDK's deprecation, this generated project is likely to install outdated/incompatible dependencies out of the box.@consensys/connect-button (used in voting-dapp.mdx step 9) last published ~2 years ago (v1.0.3).
These may be fine to keep as is for now, but should be tested to ensure the tutorial works as written.
6. ElizaOS
The framework has changed a lot since this tutorial was written (character schema v1 → v2, plugin loading conventions, etc.), so it needs a full re-run against the current main branch of eliza, or using the updated ElizaOS docs. Also spotted what looks like a malformed CLI flag: pnpm start --character-"characters/yourcharactername.character.json" (missing space after --character, and stray hyphen).
As a follow up to #1621: Several tutorials depend on CLI tools, packages, or SDKs that have since been renamed, deprecated, or majorly upgraded upstream. The tutorials have been edited for writing style, but the exact commands, prompts, and terminal output shown probably no longer match what a reader will see if they follow the steps today. This issue tracks re-testing each tutorial end-to-end and updating tooling references.
1. MetaMask SDK → MetaMask Connect
MetaMask SDK is deprecated, replaced by MetaMask Connect (
@metamask/connect-evm/@metamask/connect-multichain).Affected:
marketplace-dapp.mdx— step 6,wagmi/connectors'smetaMask()voting-dapp.mdx— step 7, same pattern, plus references "MetaMask SDK" in prosefirst-dapp.mdx— indirectly, via RainbowKit's default connector setAction: decide whether to move these tutorials to MetaMask Connect directly, or to a connector-agnostic pattern (see
network/how-to/connect-wallet.mdx, which already uses a plaininjected()wagmi connector instead of MetaMask-specific code).2. wagmi v2 → v3
wagmi v3 unbundles connector SDKs (no longer ships wallet SDKs by default) and introduces API changes (e.g.,
useConnection).eip-7702.mdxalready usesuseConnection, butmarketplace-dapp.mdx,voting-dapp.mdx, andfirst-dapp.mdxstill use v2-era patterns (useAccount, bundledmetaMask()connector). Need to confirm which wagmi major version we want to standardize on across all tutorials and update accordingly.3. shadcn CLI rename
The CLI package was renamed from
shadcn-uitoshadcn;npx shadcn-ui@latest ...no longer resolves.first-dapp.mdxstill usesnpx shadcn-ui@latest initandpnpm dlx shadcn-ui@atest add ...(also has a typo:@atestinstead of@latest).4. Hardhat 3
Hardhat 3 dropped the old interactive Hardhat 2 vs Hardhat 3 template chooser from
npx hardhat --init. The prompt/output shown inmarketplace-dapp.mdx(step 1) andvoting-dapp.mdx(implied via Create Web3 Template) should be re-run and the screenshots/terminal output updated to match current output. Hardhat 3 also added non-interactive flags (--init --template <name>) that may be worth using instead of an interactive walkthrough.5. Stale Consensys scaffolding packages
@consensys/create-web3-template(used invoting-dapp.mdxstep 1) last published to npm in Nov 2024. Given wagmi v3 and MetaMask SDK's deprecation, this generated project is likely to install outdated/incompatible dependencies out of the box.@consensys/connect-button(used invoting-dapp.mdxstep 9) last published ~2 years ago (v1.0.3).These may be fine to keep as is for now, but should be tested to ensure the tutorial works as written.
6. ElizaOS
The framework has changed a lot since this tutorial was written (character schema v1 → v2, plugin loading conventions, etc.), so it needs a full re-run against the current
mainbranch of eliza, or using the updated ElizaOS docs. Also spotted what looks like a malformed CLI flag:pnpm start --character-"characters/yourcharactername.character.json"(missing space after--character, and stray hyphen).