EVM

This applies to all EVM based blockchains, including Ethereum, BSC, Arbitrum, Polygon, Fantom, Moonbeam, MathChain L2, etc

The differences for these chains are the ChainID & RPC which can be found here:

https://chainlist.org/

https://chainid.network/chains.json

Integrating (Web)

Detecting the Provider

MathWallet will inject an object called ethereum on the window object of any web application the user visits.

To detect if a browser extension using this API is installed, you can check for the existence of the ethereum object.

To make it easy to detect MathWallet specifically, the extension adds an additional isMathWallet flag.

eth

const isMathWalletInstalled = window.ethereum && window.ethereum.isMathWallet

If MathWallet is not installed, we recommend you redirect your users to our website. Altogether, this may look like the following.

const getProvider = () => {
  if ("ethereum" in window) {
    const provider = window.ethereum;
    if (provider.isMathWallet) {
      return provider;
    }
  }
  window.open("https://mathwallet.org/", "_blank");
};

Establishing a Connection

In order to start interacting with MathWallet you must first establish a connection. "Connecting" to MathWallet on EVM chains effectively means "to access the user's EVM account(s)".

const accounts = await ethereum.request({ method: 'eth_requestAccounts' });
const account = accounts[0];

Sending a Transaction

Once the web application is connected to MathWallet, it can send transactions on behalf of the user, with the user's permission.

In order to send a transaction, the web application must:

Create an unsigned transaction or transactions.
Have it be signed by the user's MathWallet.
Send it to a RPC node for processing.

For more information about the nature of transactions on Ethereum, it is recommended to review the ethers docs or web3js docs

const transactionParameters = {
  nonce: '0x00', // ignored by MathWallet
  gasPrice: '0x09184e72a000', // customizable by user during MathWallet confirmation.
  gas: '0x2710', // customizable by user during MathWallet confirmation.
  to: '0x0000000000000000000000000000000000000000', // Required except during contract publications.
  from: ethereum.selectedAddress, // must match user's active address.
  value: '0x00', // Only required to send ether to the recipient from the initiating external account.
  data:
    '0x7f7465737432000000000000000000000000000000000000000000000000000000600057', // Optional, but used for defining smart contract creation and interaction.
  chainId: '0x3', // Used to prevent transaction reuse across blockchains. Auto-filled by MathWallet.
};

// txHash is a hex string
// As with any RPC call, it may throw an error
const txHash = await ethereum.request({
  method: 'eth_sendTransaction',
  params: [transactionParameters],
});

Signing a Message

When the web application is connected to MathWallet, it can also request that the user signs a given message.

// Create a SHA3 hash of the message 'Apples'
const messageHash = web3.sha3('Owner of punk #8888');

// Signs the messageHash with a given account
const signature = await web3.eth.personal.sign(messageHash, web3.eth.defaultAccount);

More details on this page