Portal’s iOS SDK provides EVM Account Type management through the portal.evmAccountType API. This enables checking wallet account types and upgrading EOA wallets to EIP-7702 on supported EVM chains.
Overview
The EVM Account Type functionality allows you to:
- Check wallet status to determine the current account type
- Get wallet addresses to retrieve the EOA address and (if applicable) the smart contract address
- Upgrade to EIP-7702 to enable ejecting the Portal wallet’s EOA private key
Prerequisites
Before using EVM Account Type operations, ensure you have:
Checking Wallet Status
Use getStatus to check the current account type of your wallet. The response includes both the account status and metadata about the wallet addresses.
Response (EvmAccountTypeResponse):
data.status: One of EIP_155_EOA, SMART_CONTRACT, or EIP_7702_EOA
metadata.eoaAddress: The EOA address associated with the wallet
metadata.smartContractAddress: Your smart contract wallet address (optional, may be nil for EOA-only accounts)
metadata.chainId: The chain identifier
Getting Wallet Addresses
Use getAddresses to retrieve the EOA and smart contract addresses for your wallet on a given chain. This is a convenience method that returns the EOA and optional smart contract address, equivalent to the address metadata returned by getStatus.
Parameters:
chainId (String): A CAIP-2 chain identifier (e.g., "eip155:10143")
Response (EvmAccountTypeAddresses):
eoaAddress (String): The EOA address associated with the wallet
smartContractAddress (String?): The smart contract wallet address (optional, nil for EOA-only accounts)
Upgrading to EIP-7702
Use upgradeTo7702 to upgrade an EOA wallet to EIP-7702. This method automatically handles the entire upgrade process, including gas subsidization, and returns the transaction hash directly.
What happens during the upgrade:
- Chain validation: Verifies the chain uses the
eip155 namespace
- Status check: Confirms the wallet is currently an
EIP_155_EOA
- Authorization building: Creates the EIP-7702 authorization list
- Signature: Signs the authorization hash with your wallet
- Transaction submission: Submits the subsidized upgrade transaction (gas is paid by Portal)
- Transaction hash: Returns the on-chain transaction hash
Response:
The method returns a String containing the transaction hash of the submitted upgrade transaction.
Error handling:
The method throws typed EvmAccountTypeError errors:
invalidAccountType(status): The wallet is not an EIP_155_EOA (e.g., already upgraded to EIP_7702_EOA or is a SMART_CONTRACT)
unsupportedChainNamespace(chainId): The chain does not use the eip155 namespace
portalNotInitialized: The Portal instance is not available
invalidSignatureResponse: The signing operation returned an invalid result
invalidTransactionResponse: The transaction hash was not returned from the API
The upgrade process is irreversible per wallet. Once upgraded to EIP-7702, the wallet cannot be reverted to a standard EOA on that chain.
Supported Networks
EVM Account Type upgrades are currently available on:
- Monad Testnet (
eip155:10143)
For a complete list of supported chains, reach out to the Portal team.
Next Steps