Controller is a gaming specific smart contract wallet that enables seamless player onboarding and game interactions.
It supports transaction signing using Passkeys and Session Tokens.
It consists of the keychain which is a simple, sandboxed
application hosted at https://x.cartridge.gg/ and responsible for sensitive
operations, such as signing transactions. When an application requests to sign
or execute a transaction, keychain enforces client side authorization logic and
displays UI for user approval if necessary.
Interaction with the keychain is done throught the
controller sdk. Controller implements the account
interfaces required by starknet.js.
Underneath, the implementation communicates with an embedded sandboxed keychain
iframe.
Install pnpm via corepack:
corepack enable pnpmInstall dependencies:
pnpm iBuild dependencies:
pnpm buildRun keychain and starknet-react-next:
pnpm devOpen http://localhost:3002 in your browser.
The simplest way to then develop with your cartridge account is to port it over from the production keychain:
- Login to your account at https://x.cartridge.gg/login
- Open your console, dump your account with
window.cartridge.exportAccount()and copy it - Visting your local keychain at http://localhost:3001/
- Load your account into your local keychain
window.cartridge.importAccount("EXPORTED ACCOUNT");