All lessons · CCC (TypeScript SDK) · Start here · Glossary
Adding a wallet missing from CCC's connector via a SignersController subclassWorkingChecked by the owner
Checked by the owner · Check: partly right · Checked 2026-11-19
To list a wallet that CCC's connector does not include yet, subclass ccc.SignersController (from @ckb-ccc/connector-react) and override addRealSigners: call this.addSigners(name, icon, [{ name: "CKB", signer }], context) with a ccc.Signer for that wallet, then await super.addRealSigners(context). Pass an instance to ccc.Provider as signersController. Wallets are shown in the order they are added, so adding yours before the super call puts it ahead of CCC's own. The Khie entry is drawn by the connector above that list and is not part of it; the hide-khie attribute removes it.
Why it matters: Without a custom SignersController, users of a wallet missing from CCC's built-in list, such as Cellula, cannot connect to the dApp at all.
Order and the Khie entry checked against the CCC source at e10b99d (@ckb-ccc/ccc 1.3.7, connector 2.4.0): packages/ccc/src/signersController.ts (addSigner appends) and packages/connector/src/scenes/selecting/wallets.ts.
Pattern
await this.addSigners("Cellula", cellulaIcon, [{ name: "CKB", signer: new CellulaWalletSigner(context.client) }], context);Taken from the commit, shortened.
- Concepts
- Witnesses and signatures
- Evidence
- Checked by the owner: checked by the owner of the project it came from, who is also the publisher of these lessons
- First seen
- 2026-11-06
- Last changed
- 2026-11-06
- Last checked
- 2026-11-19
- Check against the commit
- partly right: a true core, with a part that is loose or too wide
Sources (1)
- 2026-11-06 · LusoCryptoLabs/ckb-ward · more from this project
More about CCC (TypeScript SDK)
- Re-zero the witness lock before recomputing the sign message with getSignHashInfo
- Reserve co-signer witness space before completeFeeBy in multi-signer CCC transactions
- CCC EVM and Bitcoin signers pass the exact signed text through signMessageRaw
Checked by @LusoCryptoLabs (owner of the project), 2026-11-19.
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Adding a wallet missing from CCC's connector via a SignersController subclass", CKB lessons, https://pulse.lusocryptolabs.com/learned/ccc/adding-a-wallet-missing-from-ccc-s-connector-via-a-signersco, CC BY 4.0, last changed 2026-11-06.