feat: Android WalletKit SDK implementation

.github/workflows/android.yml

@@ -0,0 +1,177 @@
+name: Android SDK CI
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'apps/androidkit/**'
+      - '.github/workflows/android.yml'
+
+jobs:
+  # Build JavaScript bundles for WebView and QuickJS
+  build-js:
+    name: Build JS Bundles
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Read .nvmrc
+        run: echo "NVMRC=$(cat .nvmrc)" >> $GITHUB_ENV
+
+      - uses: pnpm/action-setup@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '${{ env.NVMRC }}'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build all packages including @ton/walletkit
+        run: pnpm build
+
+      - name: Build JS bundles for Android
+        working-directory: apps/androidkit
+        run: pnpm run build:all
+
+      - name: Upload JS bundles
+        uses: actions/upload-artifact@v4
+        with:
+          name: js-bundles
+          path: |
+            apps/androidkit/dist-android/
+            apps/androidkit/dist-android-quickjs/
+          retention-days: 1
+
+  # Code formatting check with Spotless
+  spotless:
+    name: Spotless Check
+    runs-on: ubuntu-latest
+    needs: build-js
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+          cache: 'gradle'
+
+      - name: Download JS bundles
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundles
+          path: apps/androidkit/
+
+      - name: Grant execute permission for gradlew
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: chmod +x gradlew
+
+      - name: Run Spotless Check
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: ./gradlew spotlessCheck
+
+  # Build and test SDK
+  test-sdk:
+    name: Test & Build SDK
+    runs-on: ubuntu-latest
+    needs: build-js
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+          cache: 'gradle'
+
+      - name: Download JS bundles
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundles
+          path: apps/androidkit/
+
+      - name: Grant execute permission for gradlew
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: chmod +x gradlew
+
+      - name: Run unit tests
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: ./gradlew :bridge:testWebviewReleaseUnitTest
+
+      - name: Build WebView variant
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: ./gradlew buildWebview
+
+      - name: Upload WebView AAR
+        uses: actions/upload-artifact@v4
+        with:
+          name: bridge-webview-release
+          path: apps/androidkit/TONWalletKit-Android/bridge/build/outputs/aar/bridge-webview-release.aar
+          retention-days: 7
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: apps/androidkit/TONWalletKit-Android/bridge/build/test-results/
+          retention-days: 7
+
+  # Build Demo App
+  build-demo:
+    name: Build Demo App
+    runs-on: ubuntu-latest
+    needs: build-js
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+          cache: 'gradle'
+
+      - name: Download JS bundles
+        uses: actions/download-artifact@v4
+        with:
+          name: js-bundles
+          path: apps/androidkit/
+
+      - name: Grant execute permission for gradlew (SDK)
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: chmod +x gradlew
+
+      - name: Build SDK for Demo
+        working-directory: apps/androidkit/TONWalletKit-Android
+        run: ./gradlew buildWebview
+
+      - name: Copy AAR to Demo app libs
+        run: |
+          mkdir -p apps/androidkit/AndroidDemo/app/libs
+          cp apps/androidkit/TONWalletKit-Android/bridge/build/outputs/aar/bridge-webview-release.aar apps/androidkit/AndroidDemo/app/libs/bridge-release.aar
+
+      - name: Grant execute permission for gradlew (Demo)
+        working-directory: apps/androidkit/AndroidDemo
+        run: chmod +x gradlew
+
+      - name: Build Demo App
+        working-directory: apps/androidkit/AndroidDemo
+        run: ./gradlew assembleDebug
+
+      - name: Upload Demo APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: demo-app-debug
+          path: apps/androidkit/AndroidDemo/app/build/outputs/apk/debug/app-debug.apk
+          retention-days: 7

.gitignore

@@ -2,6 +2,7 @@ node_modules
 .env
 .DS_Store
 dist
+dist-android
 .idea
 .turbo
 apps/demo-wallet/dist-extension.pem
@@ -12,4 +13,17 @@ reports
 *-results
 *-report
 
+apps/TONWalletApp/Packages/TONWalletKit/.swiftpm/xcode/xcuserdata/
+apps/TONWalletApp/Packages/TONWalletKit/Sources/TONWalletKit/Resources/JS/walletkit-ios-bridge.mjs
+apps/TONWalletApp/Packages/TONWalletKit/Sources/TONWalletKit/Resources/JS/walletkit-ios-bridge.mjs.map
+apps/TONWalletApp/Packages/TONWalletKit/Sources/TONWalletKit/Resources/JS/walletkit-ios-bridge.umd.js
+apps/TONWalletApp/Packages/TONWalletKit/Sources/TONWalletKit/Resources/JS/walletkit-ios-bridge.umd.js.map
+apps/TONWalletApp/TONWalletApp.xcodeproj/project.xcworkspace/xcuserdata/
+apps/TONWalletApp/TONWalletApp.xcodeproj/xcuserdata/
+apps/TONWalletApp/TONWalletApp.xcodeproj/xcuserdata/
+
+# Android QuickJS build artifacts
+apps/androidkit/AndroidDemo/bridge/.cxx/
+apps/androidkit/dist-android-quickjs/
+node.log
 packages/walletkit-ios-bridge/build/*

apps/androidkit/.gitignore

@@ -0,0 +1,53 @@
+# Build outputs (JavaScript bundles)
+dist-android/
+dist-android-quickjs/
+
+# Dependencies
+node_modules/
+
+# macOS
+.DS_Store
+
+# Turbo cache
+.turbo/
+
+# Local Maven repository (generated artifacts)
+local-maven-repo/
+
+# Android Studio / Gradle (project level)
+.gradle/
+build/
+.cxx/
+*.iml
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/gradle.xml
+.idea/assetWizardSettings.xml
+.idea/dictionaries
+.idea/libraries
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/misc.xml
+.idea/.gitignore
+.idea/caches
+.idea/modules.xml
+.idea/navEditor.xml
+.idea/deploymentTargetDropDown.xml
+
+# Local configuration files
+local.properties
+gradle.properties
+# But include gradle.properties for the SDK (contains required build config)
+!TONWalletKit-Android/gradle.properties
+
+# AAR files in libs folders (build artifacts)
+**/libs/*.aar
+
+# Temporary documentation files (can be regenerated)
+JITPACK_QUICKSTART.md
+PUBLISHING_GUIDE.md
+gradle.properties.template
+
+# Build logs
+*.log
+node.log

apps/androidkit/AndroidDemo/.gitignore

@@ -0,0 +1,10 @@
+# Gradle and build outputs
+.gradle/
+build/
+app/build/
+.idea/
+local.properties
+*.iml
+.DS_Store
+captures/
+.kotlin

apps/androidkit/AndroidDemo/META-INF/MANIFEST.MF

@@ -0,0 +1,4 @@
+Manifest-Version: 1.0
+Implementation-Title: Gradle
+Implementation-Version: 8.7
+

apps/androidkit/AndroidDemo/README.md

@@ -0,0 +1,38 @@
+# Android WalletKit Demo
+
+Demo app for TON WalletKit SDK.
+
+## Setup
+
+Build SDK first:
+
+```bash
+cd ../TONWalletKit-Android
+./gradlew buildAndCopyWebviewToDemo
+```
+
+Then open this project in Android Studio and run.
+
+## Features
+
+- Wallet creation and import
+- TON Connect integration
+- Transaction signing
+- Balance display and auto-refresh
+
+## Engine Selection
+
+Edit `WalletKitDemoApp.kt`:
+
+```kotlin
+val defaultEngineKind = WalletKitEngineKind.WEBVIEW  // Recommended
+```
+
+For QuickJS: use full variant and uncomment OkHttp in `app/build.gradle.kts`.
+
+## Structure
+
+- `ui/` - Compose screens
+- `viewmodel/` - State management  
+- `storage/` - Secure wallet storage
+- `libs/bridge-release.aar` - SDK (copied by build task)

apps/androidkit/AndroidDemo/app/build.gradle.kts

@@ -0,0 +1,72 @@
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    alias(libs.plugins.androidApplication)
+    alias(libs.plugins.kotlinAndroid)
+    alias(libs.plugins.kotlinCompose)
+}
+
+android {
+    namespace = "io.ton.walletkit.demo"
+    compileSdk = 36
+
+    defaultConfig {
+        applicationId = "io.ton.walletkit.demo"
+        minSdk = 24
+        targetSdk = 36
+        versionCode = 1
+        versionName = "1.0"
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    buildFeatures {
+        compose = true
+    }
+}
+
+kotlin {
+    compilerOptions {
+        jvmTarget.set(JvmTarget.JVM_17)
+    }
+}
+
+dependencies {
+    implementation(libs.androidxCoreKtx)
+    implementation(libs.androidxAppcompat)
+    implementation(libs.googleMaterial)
+    implementation(libs.androidxActivityKtx)
+    implementation(libs.androidxConstraintLayout)
+    implementation(libs.androidxActivityCompose)
+    implementation(platform(libs.androidxComposeBom))
+    implementation(libs.androidxComposeUi)
+    implementation(libs.androidxComposeMaterial3)
+    implementation(libs.androidxComposeMaterialIconsExtended)
+    implementation(libs.androidxComposeUiToolingPreview)
+    debugImplementation(libs.androidxComposeUiTooling)
+    implementation(libs.androidxLifecycleRuntimeKtx)
+    implementation(libs.androidxLifecycleViewmodelCompose)
+    implementation(libs.kotlinxCoroutinesAndroid)
+    implementation(libs.androidxSecurityCrypto)
+
+    // TONWalletKit SDK - AAR file
+    // Build and copy with: ./gradlew buildAndCopyWebviewToDemo (or buildAndCopyFullToDemo)
+    implementation(files("libs/bridge-release.aar"))
+
+    // Required transitive dependencies (must be declared manually with AAR files)
+    implementation(libs.androidxWebkit)
+    implementation(libs.androidxDatastorePreferences)
+    implementation(libs.kotlinxSerializationJson)
+    // OkHttp only needed if using full variant:
+    // implementation(libs.okhttp)
+}

apps/androidkit/AndroidDemo/app/proguard-rules.pro

@@ -0,0 +1 @@
+# Keep default rules