Optimism Documentation

WalletNamespace

Wallet namespace that provides unified wallet operations

Methods

Function	Description
hostedWalletProvider()	Get direct access to the hosted wallet provider
smartWalletProvider()	Get direct access to the smart wallet provider
createSmartWallet()	Create a new smart wallet
createSigner()	Create a viem LocalAccount signer from the hosted wallet
toActionsWallet()	Convert a hosted wallet or local account to an Actions wallet
getSmartWallet()	Get an existing smart wallet with a provided signer

`hostedWalletProvider()`

Get direct access to the hosted wallet provider Returns: Promise resolving to the configured hosted wallet provider instance _{Source ↗}

`smartWalletProvider()`

Get direct access to the smart wallet provider Returns: Promise resolving to the configured smart wallet provider instance _{Source ↗}

`createSmartWallet()`

Create a new smart wallet

Parameter	Type	Description
`params`	`CreateSmartWalletOptions`	Smart wallet creation parameters
`params.signer`	`LocalAccount`	Primary local account used for signing transactions
`params.signers`	`Signer[]`	Optional array of additional signers for the smart wallet
`params.nonce`	`bigint`	Optional nonce for smart wallet address generation (defaults to 0)
`params.deploymentChainIds`	`SupportedChainId[]`	Optional chain IDs to deploy the wallet to.
If not provided, the wallet will be deployed to all supported chains.

Returns: Promise resolving to deployment result containing:

wallet: The created SmartWallet instance
deployments: Array of deployment results with chainId, receipt, success flag, and error

_{Source ↗}

`createSigner()`

Create a viem LocalAccount signer from the hosted wallet

Parameter	Type	Description
`params`	`TToActionsMap[THostedProviderType]`	Configuration for the signer

Returns: Promise resolving to a viem LocalAccount with the hosted wallet as the signer backend _{Source ↗}

`toActionsWallet()`

Convert a hosted wallet or local account to an Actions wallet

Parameter	Type	Description
`params`	`ToActionsWalletParam<THostedProviderType, TToActionsMap>`	Provider params or a viem LocalAccount

Returns: Promise resolving to the Actions wallet instance _{Source ↗}

`getSmartWallet()`

Get an existing smart wallet with a provided signer

Parameter	Type	Description
`params`	`GetSmartWalletOptions`	Wallet retrieval parameters
`params.signer`	`LocalAccount`	Local account to use for signing transactions on the smart wallet
`params.signers`	`Signer[]`	Optional array of additional signers for the smart wallet
`params.deploymentSigners`	`Signer[]`	Optional array of signers used during wallet deployment
`params.walletAddress`	`Address`	Optional explicit smart wallet address (skips address calculation)
`params.nonce`	`bigint`	Optional nonce used during smart wallet creation

Returns: Promise resolving to the smart wallet instance with the provided signer _{Source ↗}

Wallet

Base actions wallet class

Namespaces

Namespace	Type	Description
`lend`	`WalletLendNamespace`	Lend namespace with all lending operations
`borrow`	`WalletBorrowNamespace`	Borrow namespace with all borrow operations
`swap`	`WalletSwapNamespace`	Swap namespace with all swap operations

Properties

Property	Type	Description
`address`	`Address`	Get the address of this actions wallet
`signer`	`LocalAccount`	Get a signer for this actions wallet

Methods

Function	Description
has()	Check whether a wallet namespace (`lend`, `swap`, `borrow`) is configured on this wallet. Useful for callers that branch on capability instead of catching a `TypeError` later.
getBalance()	Get asset balances across the requested chains (or all supported chains).
send()	Send a transaction using this actions wallet
sendBatch()	Send a batch of transactions using this actions wallet

`has()`

Check whether a wallet namespace (lend, swap, borrow) is configured on this wallet. Useful for callers that branch on capability instead of catching a TypeError later.

Parameter	Type	Description
`namespace`	`ActionName`	Wallet namespace name to probe.

Returns: true when the namespace is configured. _{Source ↗}

`getBalance()`

Get asset balances across the requested chains (or all supported chains).

Parameter	Type	Description
`options`	`BalanceFetchOptions`	Optional `chainIds` filter

Returns: Promise resolving to array of token balances with chain breakdown _{Source ↗}

`send()`

Send a transaction using this actions wallet

Parameter	Type	Description
`transactionData`	`TransactionData`	The transaction data to execute
`chainId`	`SupportedChainId`	Target blockchain chain ID

Returns: Promise resolving to the transaction hash _{Source ↗}

`sendBatch()`

Send a batch of transactions using this actions wallet

Parameter	Type	Description
`transactionData`	`readonly TransactionData[]`	The transaction data to execute
`chainId`	`SupportedChainId`	Target blockchain chain ID

Returns: Promise resolving to the transaction hash _{Source ↗}

Get started

Guides

Tutorials

Tools & SDKs

Reference

Wallet Documentation

WalletNamespace

Methods

`hostedWalletProvider()`

`smartWalletProvider()`

`createSmartWallet()`

`createSigner()`

`toActionsWallet()`

`getSmartWallet()`

Wallet

Namespaces

Properties

Methods

`has()`

`getBalance()`

`send()`

`sendBatch()`

​WalletNamespace

​Methods

​hostedWalletProvider()

​smartWalletProvider()

​createSmartWallet()

​createSigner()

​toActionsWallet()

​getSmartWallet()

​Wallet

​Namespaces

​Properties

​Methods

​has()

​getBalance()

​send()

​sendBatch()

WalletNamespace

Methods

`hostedWalletProvider()`

`smartWalletProvider()`

`createSmartWallet()`

`createSigner()`

`toActionsWallet()`

`getSmartWallet()`

Wallet

Namespaces

Properties

Methods

`has()`

`getBalance()`

`send()`

`sendBatch()`