controller-signers

What problem does it solve?

Simplifies implementing flexible, secure authentication for Cartridge Controller by documenting supported signer types, configuration patterns, and recovery flows so teams can onboard users and manage account access across web, native, and wallet environments.

Core Features & Use Cases

• Passkeys (webauthn): Primary, highly secure user authentication with platform-backed backup (iCloud, Google, Windows).
• Social OAuth: Easy onboarding via Google, Discord, and Twitter with Turnkey wallet creation and OIDC validation.
• External Wallets & Chain Handling: Integrate Starknet wallets (Argent, Braavos) and desktop EVM wallets (MetaMask, Phantom, Rabby) with walletconnect cross-platform support and optional chain switching/transaction confirmation.
• Multi-Signer Management & Recovery: Add backup signers for account recovery, test signers periodically, and remove compromised signers from settings.
• Use Case: Offer a single-signup flow that shows a branded Phantom button on desktop, fall back to passkeys on mobile, and register an Argent backup signer for recovery on mainnet.

Quick Start

Configure the Controller to enable webauthn, google, and argent signers, present a branded Phantom option on desktop, and add Argent as a backup signer for recovery.