Quickstart: Integrating AIR Kit for login

​

Before you start

• An AIR Developer Dashboard account and Partner ID
• A web app running in the browser, with its origin added in Account → Domains
• A supported Node.js version for your framework and AIR Kit

​

Step 1: Install the SDK

npm i @mocanetwork/airkit

​

Step 2: Get your Partner ID

1. Go to the Developer Dashboard and sign in by connecting your EVM wallet.
2. Open Account → General Settings and copy your Partner ID.

​

Step 3: Initialize and log in

import { AirService, BUILD_ENV } from "@mocanetwork/airkit";

const service = new AirService({
  partnerId: "<your-partner-id>"
});

export async function loginToAir() {
  if (!service.isInitialized) {
    await service.init({ buildEnv: BUILD_ENV.SANDBOX });
  }
  if (!service.isLoggedIn) {
    await service.login();
  }
  return service.isLoggedIn;
}

• Initialize the AirService within the sandbox environment
• Present the SSO Login screen of AIR Kit for users to log in
• Handle authentication and session setup
• Establish the user session used by Account Services and subsequent credential flows

​

Session lifecycle

await service.logout();

​

Next steps

• Issuing your first credential and Verifying your first credential, if your app needs credentials
• Smart accounts, to use the user’s embedded wallet
• Customization options, to change the theme, login methods, and language