[SDK] feat: Support account overrides in engineAccount()

[joaquim-verges]

---

PR-Codex overview

This PR introduces support for account overrides in the engineAccount() function, allowing transactions to be executed on behalf of smart accounts. It adds new options for account management and includes a test case for sending a session key transaction.

Detailed summary

• Added overrides option to EngineAccountOptions in index.ts.
• Implemented handling for accountAddress, accountFactoryAddress, and accountSalt in engineAccount().
• Introduced a test case in engine-account.test.ts for sending a session key transaction.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs-v2	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 19, 2025 8:02am
login	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 19, 2025 8:02am
thirdweb_playground	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 19, 2025 8:02am
thirdweb-www	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 19, 2025 8:02am
wallet-ui	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Mar 19, 2025 8:02am

[changeset-bot]

🦋 Changeset detected

Latest commit: c9837e5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
thirdweb	Patch
@thirdweb-dev/wagmi-adapter	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[joaquim-verges]

• [SDK] feat: Support account overrides in engineAccount() #6496 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• merge-queue - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

size-limit report 📦

Path	Size	Loading time (3g)	Running time (snapdragon)	Total time
thirdweb (esm)	46.94 KB (+0.16% 🔺)	939 ms (+0.16% 🔺)	132 ms (+83.37% 🔺)	1.1 s
thirdweb (cjs)	127.18 KB (0%)	2.6 s (0%)	198 ms (+21.93% 🔺)	2.8 s
thirdweb (minimal + tree-shaking)	5.6 KB (0%)	113 ms (0%)	67 ms (+1230.94% 🔺)	179 ms
thirdweb/chains (tree-shaking)	506 B (0%)	10 ms (0%)	17 ms (+931.84% 🔺)	27 ms
thirdweb/react (minimal + tree-shaking)	19.34 KB (0%)	387 ms (0%)	83 ms (+507.69% 🔺)	470 ms

[codecov]

Codecov Report

Attention: Patch coverage is 7.14286% with 13 lines in your changes missing coverage. Please review.

Project coverage is 54.78%. Comparing base (56bc4ae) to head (c9837e5).
Report is 5 commits behind head on main.

Files with missing lines	Patch %	Lines
packages/thirdweb/src/wallets/engine/index.ts	7.14%	13 Missing ⚠️

❌ Your patch status has failed because the patch coverage (7.14%) is below the target coverage (80.00%). You can increase the patch coverage or adjust the target coverage.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #6496      +/-   ##
==========================================
- Coverage   54.78%   54.78%   -0.01%     
==========================================
  Files         875      875              
  Lines       54891    54902      +11     
  Branches     3739     3740       +1     
==========================================
+ Hits        30072    30076       +4     
- Misses      24725    24731       +6     
- Partials       94       95       +1     

Flag	Coverage Δ
packages	54.78% <7.14%> (-0.01%)	⬇️

Files with missing lines	Coverage Δ
packages/thirdweb/src/wallets/engine/index.ts	12.19% <7.14%> (-1.20%)	⬇️

... and 2 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.