CKB Pulse

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

Prefer
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)

More about CCC (TypeScript SDK)

All 33 in this topic

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.

Drawn from public commits and checked against the commit each one came from and the project's code today. Read the source before you rely on one. Text under CC BY 4.0: credit LusoCryptoLabs, CKB lessons, with a link to the lesson. Want a lesson changed or removed? Open an issue.