controller-setup

What problem does it solve?

This Skill helps developers integrate the Cartridge Controller smart-contract wallet into Starknet applications, eliminating guesswork and common pitfalls when installing packages, instantiating Controller, selecting connectors, configuring chains and RPCs, and preparing local Katana environments for testing.

Core Features & Use Cases

• Installation guidance: Which packages to install and compatible versions to avoid runtime errors.
• Connector selection: When to use ControllerConnector for web apps versus SessionConnector for native/mobile flows.
• Session policy requirements: Explain why session policies are required for execute() and how to configure them.
• Chain and Katana configuration: How to register RPC endpoints, set defaultChainId, and enable paymaster/controllers in Katana genesis.
• Developer ergonomics: Lazy-loading iframe behavior, cookie and HTTPS requirements, and common troubleshooting tips for local dev.
• Use Case: Set up a web frontend to authenticate users via Cartridge, obtain session keys, and send signed transactions to a local Katana instance for end-to-end testing.

Quick Start

Install the @cartridge/controller and @cartridge/connector packages, configure Controller with the desired chains and session policies, then call controller.connect() to obtain an account and begin executing transactions.