controller-native

What problem does it solve?

This guide helps developers integrate Cartridge Controller wallet functionality into native mobile apps and Capacitor-wrapped web apps so that apps can authenticate users via session flows and sign Starknet transactions locally without exposing private keys.

Core Features & Use Cases

• SessionConnector and SessionAccount: support for browser-based subscribe flows and native sessions for local signing.
• FFI and UniFFI bindings: instructions for using Controller.c or UniFFI-generated Swift and Kotlin bindings for iOS, Android, and React Native.
• Capacitor and deep links: platform-specific deep link configuration, Android manifest setup, and iOS AASA/passkey guidance to enable robust native auth flows.
• Use Case: A mobile game that opens a browser for authentication, returns via a deep link to store session credentials locally, and signs game transactions on-device.

Quick Start

Use the controller-native skill to integrate Controller into your mobile app by configuring deep links and passkeys, building or installing UniFFI/Controller.c bindings, creating a local session, and signing a test transaction.