feat(v5): get SCA addr from EP if factory data provided w/o SCA addr

[jakehobbs]

Pull Request Checklist

• Did you add new tests and confirm existing tests pass? (yarn test)
• Did you update relevant docs? (docs are found in the site folder, and guidelines for updating/adding docs can be found in the contribution guide)
• Do your commits follow the Conventional Commits standard?
• Does your PR title also follow the Conventional Commits standard?
• If you have a breaking change, is it correctly reflected in your commit message? (e.g. feat!: breaking change)
• Did you run lint (yarn lint:check) and fix any issues? (yarn lint:write)
• Did you follow the contribution guidelines?

---

PR-Codex overview

This PR enhances the handling of factory data for deriving account addresses in the smart-accounts package. It introduces new functions to retrieve addresses from factory data, improving the prediction mechanism and ensuring fallback to RPC when necessary.

Detailed summary

• Added getLightAccountAddressFromFactoryData and getMultiOwnerLightAccountAddressFromFactoryData for address prediction.
• Updated toLightAccount and toMultiOwnerLightAccount functions to utilize new factory data methods.
• Enhanced test cases to verify address derivation using factory data.
• Refactored address prediction logic to fallback to RPC for non-default factories.
• Introduced new utility functions for decoding factory data and generating addresses.

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

[github-actions]

🌿 Documentation Preview

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Dec 16, 2025, 12:24 AM

[vercel]

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

1 Skipped Deployment

Project	Deployment	Review	Updated (UTC)
aa-sdk-ui-demo	Ignored	Preview	Dec 16, 2025 0:22am

[Copilot]

Pull request overview

This PR enhances smart account address derivation by introducing the ability to compute account addresses from factory data when the account address is not explicitly provided. The key change is adding a getSenderFromFactoryData utility function that calls the EntryPoint contract's getSenderAddress method to derive the counterfactual address.

Key Changes:

• Added getSenderFromFactoryData utility function to derive smart account addresses from factory data by calling EntryPoint's getSenderAddress
• Updated account creation functions (toLightAccount, toMultiOwnerLightAccount, toModularAccountV2, toMultiOwnerModularAccountV1) to use this new utility when factory data is provided without an account address
• Added test coverage for address derivation using factory data across all affected account types

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/smart-accounts/src/utils.ts	Added getSenderFromFactoryData function to derive addresses from factory data via EntryPoint
packages/smart-accounts/src/ma-v2/accounts/account.ts	Updated toModularAccountV2 to derive address from factory data when provided without account address
packages/smart-accounts/src/ma-v2/accounts/account.test.ts	Added test to verify address derivation from factory data
packages/smart-accounts/src/ma-v1/accounts/multi-owner-account.ts	Updated toMultiOwnerModularAccountV1 to use factory data for address derivation
packages/smart-accounts/src/ma-v1/accounts/multi-owner-account.test.ts	Added test and updated test helper to support factory data parameters
packages/smart-accounts/src/light-account/accounts/multi-owner-account.ts	Updated toMultiOwnerLightAccount to derive address from factory data
packages/smart-accounts/src/light-account/accounts/multi-owner-account.test.ts	Added test and updated test helper for factory data address derivation
packages/smart-accounts/src/light-account/accounts/account.ts	Updated toLightAccount to use factory data for address computation
packages/smart-accounts/src/light-account/accounts/account.test.ts	Added test and updated helper to verify factory data address derivation
packages/smart-accounts/src/ma-v2/utils/account.ts	Minor import formatting change
docs-site	Updated subproject commit reference

[adamegyed]

This makes sense, but we can technically be a bit stricter for the cases where using getSenderAddress is required:

• If the factory address is still the known, default address, then we should prioritize ABI-decoding the factoryData and doing local counterfactual computation, because that lets us skip the async call.

This does make it a bit harder to test, but I think it's technically a better model of when the eth_call is really necessary.

[adamegyed]

iirc, having only type imports within a regular import block caused issues for React Native

[jakehobbs]

thx, will change.

the issue w/ RN wasn't necessarily due to importing anything like this though. it was just b/c importing typebox at runtime was breaking things. viem works fine.