scaffold-eth · technophile-04 · Apr 22, 2026 · Apr 21, 2026 · Apr 21, 2026 · Apr 21, 2026
diff --git a/.changeset/backmerge-21-04-26.md b/.changeset/backmerge-21-04-26.md
@@ -0,0 +1,7 @@
+---
+"create-eth": patch
+---
+
+- upgrade yarn version to 4.13.0 in base template (https://github.com/scaffold-eth/scaffold-eth-2/pull/1211)
+- update nextjs package.json packageManager to yarn@4.13.0 (https://github.com/scaffold-eth/scaffold-eth-2/pull/1274)
+- add hardhat deploy script gas-limit guidance to AGENTS.md (https://github.com/scaffold-eth/scaffold-eth-2/pull/1263)
diff --git a/templates/base/.yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs b/templates/base/.yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
diff --git a/templates/base/.yarn/plugins/@yarnpkg/plugin-typescript.cjs b/templates/base/.yarn/plugins/@yarnpkg/plugin-typescript.cjs
diff --git a/templates/base/.yarn/releases/yarn-3.2.3.cjs b/templates/base/.yarn/releases/yarn-3.2.3.cjs
diff --git a/templates/base/.yarn/releases/yarn-4.13.0.cjs b/templates/base/.yarn/releases/yarn-4.13.0.cjs
diff --git a/templates/base/.yarnrc.yml b/templates/base/.yarnrc.yml
@@ -1,13 +1,19 @@
+compressionLevel: mixed
+
 enableColors: true
 
+enableGlobalCache: true
+
 nmHoistingLimits: workspaces
 
 nodeLinker: node-modules
 
-plugins:
-  - path: .yarn/plugins/@yarnpkg/plugin-typescript.cjs
-    spec: "@yarnpkg/plugin-typescript"
-  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
-    spec: "@yarnpkg/plugin-interactive-tools"
+npmMinimalAgeGate: 7d
+
+npmPreapprovedPackages:
+  - "@scaffold-ui/components"
+  - "@scaffold-ui/debug-contracts"
+  - "@scaffold-ui/hooks"
+  - burner-connector
 
-yarnPath: .yarn/releases/yarn-3.2.3.cjs
+yarnPath: .yarn/releases/yarn-4.13.0.cjs
diff --git a/templates/base/AGENTS.md.template.mjs b/templates/base/AGENTS.md.template.mjs
@@ -81,6 +81,15 @@ yarn vercel:yolo --prod # for deployment of frontend
     deployMyContract.tags = ["MyContract"];
     \`\`\`
   - \`yarn deploy --tags MyContract\`
+  - **Gas limit in deploy scripts**: Manual post-deploy calls (e.g. \`transferOwnership\`, \`grantRole\`, \`initialize\`) can silently inherit \`blockGasLimit\` as their gas cap, causing failures. **Fix at the call site, not in \`hardhat.config.ts\`:**
+    \`\`\`typescript
+    // Preferred: estimateGas + 20% margin
+    const gas = await myContract.myMethod.estimateGas(arg1, arg2);
+    await myContract.myMethod(arg1, arg2, { gasLimit: (gas * 120n) / 100n });
+
+    // Or: explicit limit for simple admin calls
+    await myContract.transferOwnership(newOwner, { gasLimit: 100_000 });
+    \`\`\`
 
 #### Foundry Flavor
 

diff --git a/templates/base/package.json b/templates/base/package.json
@@ -22,7 +22,7 @@
     "vercel:login": "yarn workspace @se-2/nextjs vercel:login",
     "ipfs": "yarn workspace @se-2/nextjs ipfs"
   },
-  "packageManager": "yarn@3.2.3",
+  "packageManager": "yarn@4.13.0",
   "devDependencies": {
     "husky": "~9.1.6",
     "lint-staged": "~13.2.2"

diff --git a/templates/base/packages/nextjs/eslint.config.mjs b/templates/base/packages/nextjs/eslint.config.mjs
@@ -28,5 +28,6 @@ export default defineConfig([
         },
       ],
     },
+    ignores: [".next", "next-env.d.ts"],
   },
 ]);
diff --git a/templates/base/packages/nextjs/package.json b/templates/base/packages/nextjs/package.json
@@ -58,5 +58,5 @@
     "typescript": "~5.8.2",
     "vercel": "~51.2.1"
   },
-  "packageManager": "yarn@3.2.3"
+  "packageManager": "yarn@4.13.0"
 }
-Original file line number
+Diff line change
@@ Expand Up / @@ -28,5 +28,6 @@ export default defineConfig([ @@
             },
           ],
         },
+        ignores: [".next", "next-env.d.ts"],
       },
     ]);