Moca Network Docs

Appearance

Release Notes ​

Version 1.8.0 (Unreleased) ​

✨ New Features ​

  • Credential payment support
  • Issue credentials on behalf of users
  • Compliance encryption keys support for credential issuance and verification
  • Display currency configuration (USD, EUR, CNY, KRW, TRY)
  • New air_accounts RPC method to check account status across all supported chains
  • wallet_sendCalls RPC method for batch transaction execution
  • New chainNetwork option to temporarily use Devnet during migration

➕ Improvements ​

  • Credential issuance and verification UI improvements and bug fixes
  • Swap and OnRamp UI improvements and bug fixes
  • WalletConnect stability improvements

⚠️ Breaking Changes ​

  • Sandbox environment now defaults to Moca Chain Testnet instead of Devnet
  • Credentials issued on Devnet will not be available on Testnet
  • Devnet support continues to be available alongside Testnet but will be deprecated later

📋 Migration Guide ​

After upgrading to 1.8.0, Sandbox will connect to Testnet by default. If your integration is not ready, you can temporarily stay on Devnet:

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

const airService = new AirService({
  partnerId: YOUR_PARTNER_ID
});
await airService.init({
  buildEnv: BUILD_ENV.SANDBOX,
  chainNetwork: CHAIN_NETWORK.DEVNET, // Stay on Devnet if needed
  enableLogging: true
});

We recommend migrating to Testnet as soon as possible. Re-issue any test credentials on Testnet.

Version 1.7.0 (Nov 18, 2025) ​

✨ New Features ​

  • Cross-chain credential verification support
  • Transaction payment token support
  • Custom RPC URL configuration
  • Automatic in-wallet login flow

➕ Improvements ​

  • Credential UI updates
  • Passkey UI updates
  • Significant Air Services performance improvements
  • Improved Credential error handling
  • Swap UI improvements and bug fixes

Version 1.6.0 (Sept 16, 2025) ​

✨ New Features ​

  • Initial Air Credential support
  • Flutter SDK released (version 1.5.0)
  • Swap beta support
  • OnRamp beta support
  • Account deletion (via air3.com/recovery)
  • Additional chains added:
    • Ethereum Testnet & Mainnet
    • Moca Testnet
    • Gnosis Testnet & Mainnet
    • Edu Testnet & Mainnet

➕ Improvements ​

  • Air theme update
  • Improved wallet login and mobile support
  • Improved i18n support
  • Improved error handling
  • Overall Air Services stability

⚠️ Notes ​

  • Air theme uses light theme only now

Version 1.5.0 (July 30, 2025) ​

✨ New Features ​

  • Flutter SDK beta released (version 1.5.0-beta.x)
  • Account email update and recovery (via air3.com/recovery)
  • Additional chains added:
    • BNB Smart Chain
    • Kaia and Kairos

➕ Improvements ​

  • Improved iOS Safari PWA support

⚠️ Notes ​

  • eth_accounts will only return AA from now on

Version 1.4.0 (June 26, 2025) ​

✨ New Features ​

  • Moca Devnet chain added

➕ Improvements ​

  • New SANDBOX environment for development and testing

Version 1.3.0 (June 5, 2025) ​

➕ Improvements ​

  • Captcha required during OTP for enhanced security
  • Signing screen shows actual message
  • Improved security by moving signing and transaction screens into separate window
  • Improved Passkey provider suggestions
  • Wagmi connect method now exposes authToken parameter
  • Access token contains sourcePartnerId in case of cross partner rehydration
  • Many small stabilization improvements

⚠️ Notes ​

  • Signing and transaction screens are now shown in a separate browser window instead of iframe modals

Version 1.2.0 (May 7, 2025) ​

✨ New Features ​

  • User login token refresh support

➕ Improvements ​

  • Improved MFA setup and verification flow
  • More user-friendly transaction screen
  • Bottom sheet instead of modal on mobile screens
  • Animations for smoother transitions
  • Support of small mobile screens
  • Improved session key support
  • Improved provider error handling

Version 1.1.0 (March 27, 2025) ​

✨ New Features ​

  • Persistent user sessions across AIR Kit dApps
  • Protect user accounts with MFA via Passkey
  • Login via EoA wallet
  • Soneium chain support (Testnet / Mainnet)

➕ Improvements ​

  • Simplified transaction screens
  • Improved modal UI
  • Wallet can be preloaded in the background
  • Provider can be retrieved and subscribed to before wallet initialization
  • Paymaster policies can be defined per chain
  • Various minor bug fixes and optimizations

⚠️ Notes ​

  • The AA will only be returned after the user has MFA set up
  • MFA setup will automatically trigger on any wallet action

Version 1.0.0 (Feb 27, 2025) ​

✨ New Features ​

  • Smart accounts (AA) can be checked for deployment
  • Smart accounts (AA) can be deployed without minting an Air Id
  • Experimental session key support

➕ Improvements ​

  • Full wallet services support
  • Improved token refresh mechanism
  • Login rehydration across partners

⚠️ Notes ​

  • The getUserInfo() and getPartnerUserInfo() methods have been merged into getUserInfo()

Version 0.6.0 (Feb 17, 2025) ​

✨ New Features ​

  • Beta version of wallet services

➕ Improvements ​

  • Small UI updates
  • More helpful error messages

⚠️ Notes ​

  • The wallet initialized event also returns the Smart Account (AA) address from now on

Version 0.5.0 (Feb 11, 2025) ​

The first official release of AIR Kit, rebranded from Realm SDK, focuses on drastic performance and UX improvements and sets the foundation for upcoming features.

✨ New Features ​

  • Customizable language support, including localized emails
  • Toggleable email input field
  • Support for custom authentication (Bring Your Own Auth)
  • Optional partner user linking flow
  • Introduction of a Global User ID to unify multiple Air IDs

➕ Improvements ​

  • Simplified design tokens for UI customization
  • Significantly faster initialization time and login experience
  • Keep login session alive by automatic token refresh
  • Backward compatibility down to ES2020
  • Various minor bug fixes and optimizations

⚠️ Notes ​

  • The MPC Signer address is no longer being returned
  • External wallet login (e.g. MetaMask) is not yet supported
  • Wallet-related services, including EIP1193 provider support, are unavailable in this version
  • Smart Account (AA) addresses created in this version are different from previous versions