Smart Account Module Installer

WHAT IT DOES

Smart Account Module Installer is a developer tool that lets you install or uninstall modules in smart accounts (such as ERC-4337 smart accounts, Safe, or other modular account abstractions). Modules are pluggable components that extend the functionality of a smart account — adding features like social recovery, session keys, automation, or custom logic. This tool reads the currently installed modules and their permissions from the smart account, then allows you to install a new module with specified permissions and optional configuration data, or uninstall an existing module. The tool provides a preview of the module address, action, permissions, and estimated gas cost before you execute the transaction, enabling secure and efficient module management.

HOW TO USE

Connect your EVM wallet via the BGWallet bridge. Enter your smart account address and the module address you want to manage. Select the action — Install or Uninstall. Enter the module permissions as a comma-separated list (e.g., transfer, swap, stake). Optionally, provide module configuration data as a hex string. Click "Preview Module" to see the smart account address, module address, action, permissions, and estimated gas cost. Review the details carefully. Click "Install/Uninstall" to sign and broadcast the transaction. The tool provides a transaction hash for tracking and confirms the module action.

TECHNICAL MECHANISM

The tool reads the currently installed modules from the smart account using view functions like `getModules()` or `isModuleInstalled(module)`. It validates that the module address is properly formatted and that permissions are recognized by the smart account implementation. When executing, the tool encodes a transaction to the smart account's module management functions — typically `installModule(module, permissions, config)` or `uninstallModule(module)`. The tool uses the smart account's ABI to encode the call and submits it via the connected wallet. The entire operation is atomic — if the module installation or uninstallation fails, the transaction reverts and the module state remains unchanged. The tool estimates gas using `estimateGas` and displays the estimated cost before execution.

WHAT IT CANNOT SEE

This tool cannot guarantee that the installed module will be compatible with all dApps or that the module permissions will be enforced if the smart account implementation changes. Different smart account implementations have different module standards — some may not support granular permissions, while others may use different module interfaces. The tool cannot predict upgrades to the smart account contract that may change the module management interface. Additionally, the tool cannot verify that the module address is correct or that the module will function as expected. Always test modules with the specific smart account implementation and check the module's documentation. This tool is an aid for module management, not a guarantee of compatibility with all dApps.

PLEASE NOTE

EVM chains only. This tool relies on the BGWallet connector and will not function on Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The user is responsible for ensuring the supplied smart account address is correct and that the contract supports module management functions. Not all smart account implementations support modules — check your protocol's documentation first. Installing untrusted modules can compromise account security — only install modules from trusted sources.