Examples

Implementation starting points covering the most common MOSS flows. They assume production-minded defaults: explicit user intent, restrictive permission scopes, and backend-controlled trust decisions. Adapt to your own app state, analytics, and error handling before shipping.

Vanilla TS Bootstrap

import { mega } from '@megaeth-labs/wallet-sdk';

await mega.initialise({ network: 'mainnet', logging: 'error' });

const status = await mega.status();
if (status.status !== 'connected') {
  await mega.connect();
}

Sponsored Gas Bootstrap

await mega.initialise({
  network: 'mainnet',
  logging: 'error',
  sponsorUrl: 'https://api.example.com/paymaster/approve',
  sponsorMode: 'app-only',
  sponsorToken: 'native',
});

React Bootstrap

import { MegaProvider } from '@megaeth-labs/wallet-sdk-react';

export function Root() {
  return (
    <MegaProvider config={{ network: 'mainnet', logging: 'error' }}>
      <App />
    </MegaProvider>
  );
}

Connect and Sign

await mega.connect();
const signed = await mega.signMessage('Sign in to Example App');

Transfer with Permissions-Aware UX

const permissionState = await mega.getPermissions();

if (!permissionState?.permissions) {
  await mega.grantPermissions({
    permissions: {
      expiry: 10 * 60,
      permissions: {
        calls: [{ to: '0xTokenContractAddress', signature: 'approve(address,uint256)' }],
        spend: [{ limit: 1000000000000000n, period: 'day' }],
      },
    },
  });
}

await mega.transfer({
  amount: '500000000000000000',
  to: '0xabc123abc123abc123abc123abc123abc123abcd',
  type: 'native',
});

Contract Interaction

const name = await mega.getFromContract<string>({
  address: '0xfeedfeedfeedfeedfeedfeedfeedfeedfeedfeed',
  abi: erc20Abi,
  functionName: 'name',
  args: [],
});

await mega.callContract({
  address: '0xfeedfeedfeedfeedfeedfeedfeedfeedfeedfeed',
  abi: erc20Abi,
  functionName: 'approve',
  args: ['0xspender0000000000000000000000000000000000', '1000000'],
});

Server-Side Verification

import {
  getMessageToSign,
  type MessageToConfirm,
  verifySignature,
} from '@megaeth-labs/wallet-server-verify';

const walletAddress = '0xYourWalletAddress';
const challenge = getMessageToSign(config, walletAddress);

const signedMessage: MessageToConfirm = {
  ...challenge,
  signature: '0xSignature',
};

await verifySignature(config, signedMessage);