"CCC - CKBers' Codebase" is the next step of "Common Chains Connector".
Empower yourself with CCC to discover the unlimited potential of CKB.
Interoperate with wallets from different chain ecosystems.
Fully enabling CKB's Turing completeness and cryptographic freedom power.

This project is still under active development, and we are looking forward to your feedback. Try its demo now here. It showcases how to use CCC for some basic scenarios in CKB.

We design CCC for both front-end and back-end developers. You need only one package to fulfil all your needs:

• NodeJS: npm install @ckb-ccc/core
• Custom UI: npm install @ckb-ccc/ccc
• Web Component: npm install @ckb-ccc/connector
• React (Docs): npm install @ckb-ccc/connector-react

CCC exports everything on the ccc object:

import { ccc } from "@ckb-ccc/<package-name>";

For advanced developers, we provided the cccA object to fulfil all your needs. You should notice that these interfaces are not stable:

import { cccA } from "@ckb-ccc/<package-name>/advanced";

Here's an example for transferring CKB:

const tx = ccc.Transaction.from({
  outputs: [{ lock: toLock, capacity: ccc.fixedPointFrom(amount) }],
});

Tell CCC what you need, and then...

await tx.completeInputsByCapacity(signer);
await tx.completeFeeBy(signer, 1000); // Transaction fee rate
const txHash = await signer.sendTransaction(tx);

We have done everything!

Check our full documents for all detailed APIs.

The demo source code contains some basic examples:

• Sign and verify any message.
• Transfer native CKB token.
• Transfer xUDT token.
• See Misc: Single-Use-Seals to learn how token issuing works in the cell model.
  • Issue xUDT token with the Single-Use Lock.
  • Issue xUDT token controlled by a Type ID cell.
• Manage Nervos DAO.
• Calculate the CKB hash of any messages.
• Generate mnemonic and keypairs. Encrypt to a keystore.
• Decrypt a keystore.
• Transfer the native CKB token with the old Lumos SDK.

Run the demo of CCC in two steps:

1. Install packages and build the project

# Navigate to the project directory and run the following commands to install all necessary packages and build the project:
pnpm install
pnpm build

2. Run the demo in development mode

# Go to the demo directory and start the development server:
cd packages/demo
pnpm run dev

CCC uses JS's Package Entry Points feature to help tree shaking while exporting everything on the ccc object. Ensure in your tsconfig.json, moduleResolution is set to node16, nodenext, or bundler, and resolvePackageJsonExports is not disabled.

Read the TypeScript's Guide for more.

CCC UI only works on the client side. If you are using the React Server Component, add

"use client";

at the beginning of files using ccc.Provider.

While we recommend using CCC for composing transactions, we also provide Lumos patches to:

• Support the JoyID Wallet.
• Support the Nostr Wallet.
• Support the Portal Wallet.

See lumos-patches: npm install @ckb-ccc/lumos-patches

You can apply patches by:

import { generateDefaultScriptInfos } from "@ckb-ccc/lumos-patches";

// Before using Lumos. You don't need @ckb-lumos/joyid anymore.
registerCustomLockScriptInfos(generateDefaultScriptInfos());

• Nervos CKB Docs is the documentation website of Nervos CKB.
• Lumos and its Docs: Lumos provides utils to help compose CKB transactions.
• RGB++ SDK and its Design: RGB++ is a protocol for issuing assets with Turing-completed VM on BTC L1.
• Spore SDK and its Docs: The on-chain digital object (DOBs) protocol designed to empower ownership, distribution, and value capture.
• PW SDK is not maintained anymore. It is the early-age wallet connector and a brave pioneer of the CKB ecosystem.