> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moca.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Notes

> AIR Kit SDK release notes — version history, new features, breaking changes, deprecations, and migration notes for partners upgrading their integration.

## **Version 1.8.0 (Released)**

### ✨ **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 theme={null}
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