用途:为 Cartridge Controller 配置用户认证方式(签名器 signer),在应用接入登录与账户管理时使用。
主要能力:支持 webauthn 通行密钥(生物识别/硬件密钥)、Google、Discord、Twitter/X 社交登录,以及 Argent、Braavos 等 Starknet 钱包,MetaMask、Phantom EVM、Rabby、WalletConnect 等 EVM 钱包(部分仅桌面端)。可用 signupOptions 配置选项,数组顺序决定 UI 顺序;仅一项时显示品牌化按钮。可通过 controller.connect([...]) 按连接动态覆盖认证选项。社交登录基于 Auth0 与 Turnkey,采用弹窗 OAuth 流程,OIDC 令牌校验。外部钱包支持链切换(externalSwitchChain)与交易确认等待(externalWaitForTransaction);Argent 和 Braavos 支持账户变更自动同步,Braavos 不支持链切换。多签名器管理可在设置中「Add Signer」(仅主网)增删。
限制与注意:password 认证不可恢复,丢失密码将永久失去账户,勿用于生产环境;EVM 钱包在移动浏览器自动隐藏;原生应用 WebView 中社交 OAuth 可能不可用,建议使用通行密钥;账户同步目前仅限 Argent 与 Braavos。其余细节暂未提供。