> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# onWalletAdded

> [card] Recommended: JavaScript SDK with React Hooks
>
> For new React apps, we recommend the JavaScript SDK with React Hooks (`@dynamic-labs-sdk/react-hooks`) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the [React quickstart (JavaScript SDK)](https://docs.dynamic.xyz/docs/javascript/reference/react-quickstart.md) to get started.

### Summary

This callback will be called when a new wallet is added to the userWallets when signing in with a wallet, linking a new wallet (`connect-and-sign` mode) or connecting a new wallet (`connect-only` mode).

### Usage

```TypeScript theme={"system"}
<DynamicContextProvider
  settings={{
    events: {
      onWalletAdded: (args) => {
        console.log('onWalletAdded was called', args);
      }
    }
  }}
>
 {/* ... rest of your app ... */}
</DynamicContextProvider>
```

### Callback Argument Value

```TypeScript theme={"system"}
{
  wallet: Wallet;
  userWallets: Wallet[];
}
```

This is called with the wallet that was just added and the updated list of wallets.

> [!NOTE]
>
> For details about userWallets, see
> [here](https://docs.dynamic.xyz/docs/react/reference/hooks/wallets/useuserwallets.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.