feat: use factory proxy address as AA wallet deriviation to remain unchanged during implemenation upgrades

[chrisli30]

This pull request introduces several improvements and fixes related to smart wallet management, configuration, and operator support. The main changes enhance the stability and configurability of smart wallet address derivation, improve the handling of wallet storage limits, and add support for new operator commands in the build system.

Smart wallet address derivation and configuration

• Refactored smart wallet address computation in core/chainio/aa/aa.go to use a deterministic approach based on the factory proxy address, owner address, and salt, ensuring stability across factory upgrades. Added SetFactoryAddress, getFactoryAddress, and related locking for thread safety. ([[1]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-46ee80d910393736234820d6ef77ee18db6b60ef524efe5dce7c9645d31a2aaeR30-R57), [[2]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-46ee80d910393736234820d6ef77ee18db6b60ef524efe5dce7c9645d31a2aaeL65-R145))
• Updated wallet address derivation logic to fall back to on-chain computation if local calculation fails, improving reliability. ([core/chainio/aa/aa.goL65-R145](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-46ee80d910393736234820d6ef77ee18db6b60ef524efe5dce7c9645d31a2aaeL65-R145))
• Changed authentication logic in aggregator/auth.go to use the smart wallet chain ID (r.chainID) instead of a global chain ID, ensuring correct chain selection for authentication. ([aggregator/auth.goL316-R321](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-cc9769ad88ccae45b8ffdb6a6fe9524ac9a7f4db2d82dadf6fbdc269f58eea58L316-R321))

Wallet storage and limits

• Improved logic in core/taskengine/engine.go for storing smart wallets when listing wallets: enforces maximum wallet count per owner, logs warnings when limits are reached, and ensures the default wallet is always included in responses. ([core/taskengine/engine.goL456-R529](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-77494b7116e328f80878e42128327bd124ab4ef1d7394c1d51109a5a5e93c4bcL456-R529))

Build system and operator support

• Added a new operator-base-sepolia command to the Makefile, allowing operators to start with the Base Sepolia configuration, including usage documentation and log output. ([[1]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-76ed074a9305c04054cdebb9e9aad2d818052b07091de1f20cad0bbac34ffb52L176-R184), [[2]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-76ed074a9305c04054cdebb9e9aad2d818052b07091de1f20cad0bbac34ffb52R202-R206))

Miscellaneous

• Added missing imports and improved error messages for ABI parsing and wallet address computation in core/chainio/aa/aa.go. ([[1]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-46ee80d910393736234820d6ef77ee18db6b60ef524efe5dce7c9645d31a2aaeR8-R18), [[2]](https://github.com/AvaProtocol/EigenLayer-AVS/pull/431/files#diff-46ee80d910393736234820d6ef77ee18db6b60ef524efe5dce7c9645d31a2aaeL40-R77))

[Copilot]

Pull Request Overview

This pull request introduces improvements to smart wallet address derivation, wallet storage management with limits enforcement, and operator tooling support. The main changes focus on making wallet address computation more deterministic, adding storage limits for wallets per owner, and expanding build system support for Base Sepolia operations.

Key Changes:

• Refactored smart wallet address computation to use factory proxy address for deterministic derivation
• Added wallet storage limits per owner with configurable maximums
• Introduced Base Sepolia operator commands in the Makefile

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/Contract.md	Updated contract addresses for Factory Implementation and Paymaster contracts across networks, clarifying which addresses are used for each network
core/testutil/utils.go	Added loadTestConfigOnce() calls to Tenderly-related functions for defensive initialization
core/taskengine/vm_runner_contract_write_simulation_test.go	Removed redundant factory address setting calls, relying on automatic initialization by engine
core/taskengine/list_wallets_storage_test.go	Added comprehensive test suite for wallet storage behavior in ListWallets operation
core/taskengine/engine.go	Implemented wallet storage logic in ListWallets with limit enforcement and default wallet persistence
core/chainio/aa/aa.go	Refactored address derivation with local computation and on-chain fallback, added thread-safe factory address management
aggregator/auth.go	Changed authentication to use smart wallet chain ID instead of global EigenLayer chain ID
Makefile	Added operator-base-sepolia command for Base Sepolia network operations

Comments suppressed due to low confidence (1)

core/taskengine/engine.go:535

• When the wallet limit is reached (line 477-479), the default wallet is skipped from storage but still added to the response (lines 530-535). This creates an inconsistency where the client receives a wallet address that doesn't exist in the database.

This could cause issues if:

1. The client tries to use this wallet for subsequent operations
2. Other operations expect the wallet to be in the database

Consider either:

• Not returning the wallet at all if it can't be stored (remove from response when limit reached)
• OR storing it anyway but marking it with a special flag
• OR returning an error to the client indicating the limit has been reached

The current behavior of silently returning an unstored wallet may lead to confusing errors later.

						if len(unique) >= maxAllowed {
							// Skip adding the default wallet if limit is reached, but log a warning
							n.logger.Warn("Max wallet count reached for owner in ListWallets, skipping default wallet storage", "owner", owner.Hex(), "limit", maxAllowed)
						} else {
							// Store the default wallet since we're returning it to the client
							n.logger.Info("Default wallet not found in DB for ListWallets, storing it", "owner", owner.Hex(), "walletAddress", defaultDerivedAddress.Hex())
							newModelWallet := &model.SmartWallet{
								Owner:    &owner,
								Address:  defaultDerivedAddress,
								Factory:  &defaultSystemFactory,
								Salt:     defaultSalt,
								IsHidden: false,
							}
							if storeErr := StoreWallet(n.db, owner, newModelWallet); storeErr != nil {
								n.logger.Error("Error storing default wallet to DB for ListWallets", "owner", owner.Hex(), "walletAddress", defaultDerivedAddress.Hex(), "error", storeErr)
								// Continue and return the wallet anyway, but log the error
							} else {
								// Successfully stored, update modelWallet for response
								modelWallet = newModelWallet
							}
						}
					}
				} else {
					// No config but wallet not in DB - store it anyway
					n.logger.Info("Default wallet not found in DB for ListWallets, storing it", "owner", owner.Hex(), "walletAddress", defaultDerivedAddress.Hex())
					newModelWallet := &model.SmartWallet{
						Owner:    &owner,
						Address:  defaultDerivedAddress,
						Factory:  &defaultSystemFactory,
						Salt:     defaultSalt,
						IsHidden: false,
					}
					if storeErr := StoreWallet(n.db, owner, newModelWallet); storeErr != nil {
						n.logger.Error("Error storing default wallet to DB for ListWallets", "owner", owner.Hex(), "walletAddress", defaultDerivedAddress.Hex(), "error", storeErr)
						// Continue and return the wallet anyway, but log the error
					} else {
						// Successfully stored, update modelWallet for response
						modelWallet = newModelWallet
					}
				}
			} else {
				n.logger.Warn("DB error fetching default derived wallet for ListWallets", "address", defaultDerivedAddress.Hex(), "error", dbGetErr)
			}

			// Always include the default wallet in the response (even if storage failed)
			if modelWallet != nil {
				isHidden = modelWallet.IsHidden
				actualSalt = modelWallet.Salt.String()
				if modelWallet.Factory != nil {
					actualFactory = modelWallet.Factory.Hex()
				}
			}

			walletsToReturnProto = append(walletsToReturnProto, &avsproto.SmartWallet{
				Address:  defaultDerivedAddress.Hex(),
				Salt:     actualSalt,
				Factory:  actualFactory,
				IsHidden: isHidden,
			})

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.