Events

Wander DOM events

Wander provides useful custom events to track the state of the extension. These events implement the CustomEvent browser API.

arweaveWalletLoaded event

This event is dispatched once the Wander Injected API has been initialized in the window object. Before this event is fired, you cannot interact with Wander and the window.arweaveWallet object will be undefined.

Example

addEventListener("arweaveWalletLoaded", (e) => {
  const { permissions } = e.detail;

  if (permissions === 0) {
    await window.arweaveWallet.connect(["ACCESS_ADDRESS"]);
  } else {
    // We can already interact with the wallet...
  }
});

walletSwitch event

This event is fired when the user manually switches their active wallet. The even also includes the new active wallet's address, if the user allowed the ACCESS_ADDRESS and the ACCESS_ALL_ADDRESSES permissions.

Example

addEventListener("walletSwitch", (e) => {
  const { address } = e.detail;

  // Handle wallet switch...
});

Event emitter

The event emitter is available under window.arweaveWallet.events as a more advanced event system for the extension.

Note: This documentation is incomplete and the feature is experimental.