🪐KAVA DApps Integration

Welcome to MapNode Extension Wallet Developer Guide. This documentation contains guides for developers to get started developing on MapNode Extension Wallet.‌

To detect MapNode Extension with KAVA Base Chain

To detect whether your browser is running MapNode Extension, please use:

if (window.MapNode) {
  console.log('MapNode Extension is installed!');
}

Notice: MapNode Extension Testnet is under development and not available now.

To connect MapNode Extension Wallet

To connect MapNode Extension means to access the user's [blockchain - like KAVA] account(s).

// Connect only
const connection = window.MapNode.cosmos('<chain: String>');
// Connect & get accounts
connection.request({ method: 'cosmos_accounts' });
// Check whether dapp connected or not
connection.isConnected();

Currently chains support: ['terra','kava']


To disconnect MapNode Extension Wallet

To disconnect MapNode Extension, please use:

connection.disconnect();

To experience functions

Once your account is connected, let's start experiencing more functions.‌

Get Current Account

return Promise<Array[String]>

  • If wallet can not be found, return [] instead of throw Error

connection.request({ method: 'cosmos_accounts' }).then((accounts) => {
  if (accounts[0]) {
    // Do something with accounts
  } else {
    // Wallet not found
  }
});

Check wallet whether exists or not

return Promise<{data: Boolean}>

const hasWallet = connection.request({ method: 'has_wallet', params: ['<chain>'] });

Execute contract function

return: Promise<Hash>

const signature = connection.request({
  method: 'cosmos_execute',
  params: ['<contractAddres: string>', '<executeMsg: string>'],
});

// Example Execute Contract
let cw20Contract =
  'juno10rktvmllvgctcmhl5vv8kl3mdksukyqf2tdveh8drpn0sppugwwqjzz30z';
let execMsg =
  '{"transfer":{"amount":"1","recipient":"juno1cx4nq77x3unvl2xsa9fmm9drxkexzkjnzwt2y7"}}';

const response = await connection.request({
  method: 'cosmos_execute',
  params: [cw20Contract, execMsg],
});

To handle events

List of events

Currently we only support some action event from wallet extension

connection.on('event_name', callback);
//Example
connection.on('close', () => window.location.reload());
connection.on('accountsChanged', () => window.location.reload());

EventsTrigger

accountsChanged

Receive when active account changed in Extension

networkChanged

Receive when active network changed in Extension

chainChanged

Receive when active chain changed in Extension

disconnect

Receive when disconnect from Extension

close

Alias for disconnect event

MethodDescription

on(event, callback)

Add event listener

off(event, callback)

Remove event listener

Last updated