Extension Wallet
Integration
SOLANA Network
Event

Events

Wallet events allow a dApp to react to state changes initiated by the wallet without requiring a page reload.

Cosmostation implements wallet events using the Solana Wallet Standard StandardEvents feature, following the same behavior model as Phantom and other standard-compliant wallets.

Currently supported events:

  • Account change
  • Disconnect

These events are critical for keeping application state in sync with the user’s wallet.

Supported Events

EventDescription
changeFired when the active account changes or is cleared
disconnectFired when the wallet disconnects from the dApp

Using Wallet Adapter

When using Solana Wallet Adapter, wallet events are exposed as reactive state.

Account Change

import { useWallet } from '@solana/wallet-adapter-react';
import { useEffect } from 'react';
 
export function WalletWatcher() {
  const { publicKey, connected } = useWallet();
 
  useEffect(() => {
    if (!connected) {
      console.log('Wallet disconnected');
      return;
    }
 
    console.log('Active account changed:', publicKey?.toBase58());
  }, [publicKey, connected]);
 
  return null;
}

Using Vanilla Provider

If you are not using Wallet Adapter, Cosmostation exposes wallet events through the wallet-standard event interface.

Accessing the Provider

const solana = () => {
  if ('cosmostation' in window) {
    return window.cosmostation.solana;
  }
 
  window.open('https://cosmostation.io/wallet/#extension');
};
 
const provider = solana();

Listening for Account Changes

const unsubscribe = provider.on('change', ({ accounts }) => {
  if (accounts.length === 0) {
    console.log('Wallet disconnected');
    return;
  }
 
  console.log('Active account:', accounts[0].address);
});

Event Payload

type ChangeEventPayload = {
  accounts: WalletAccount[];
};

  • accounts will be:

    • An array with one account when connected
    • An empty array when disconnected

Handling Disconnect Events

In addition to account changes, a dedicated disconnect event may be fired.

provider.on('disconnect', () => {
  console.log('Wallet disconnected');
});

When Disconnect Fires

  • User manually disconnects from the wallet UI
  • Wallet clears the active session

Cleaning Up Event Listeners

Always unsubscribe from events when they are no longer needed.

const off = provider.on('change', handler);
 
// later
off();

References

Sign MessageGetting Started