Skip to content

docs: add a Canton DevKit case study (running Canton locally) - #316

Merged
zheli merged 3 commits into
mainfrom
docs/case-study-cip0112
Aug 18, 2026
Merged

zheli merged 3 commits into
mainfrom
docs/case-study-cip0112

Conversation

@srikanth-bitdynamics

@srikanth-bitdynamics srikanth-bitdynamics commented Aug 17, 2026 •

Copy link
Copy Markdown
Collaborator

Adds a published case study to the docs site — the Canton Dev Fund milestone deliverable for a case study / blog post.

What it is

A Canton DevKit case study: standing up a full local Canton + Splice network with DevKit, then working an end-to-end Token Standard flow (CIP-0056 and CIP-0112) from both the CLI and the Web UI as the worked example — including the cross-participant --no-wait → transfer accept flow, the Amulet faucet, and burn. It's a DevKit adoption piece, not a token-only tutorial.

How it's wired

Rendered as a normal docs/*.md source page so it inherits the Starlight theme, fonts, and code styling — no bespoke layout:

  • docs/case-study-canton-devkit.md — the content (single source of truth)
  • website/docs-map.mjs — maps it to case-studies/running-canton-locally with a site description
  • website/astro.config.mjs — a new Case studies sidebar group (label: "Running Canton locally")
  • website/.gitignore — ignores the generated mirror, matching the other synced pages

Accuracy

Every command is verified against the shipped v0.17.2 CLI: stable V2 from Splice 0.6.11+ (no alpha profile), endpoint auto-resolution, --no-wait / transfer accept --party, burn confirmation, and --format json.

Verification

npm ci && npm run build succeeds (18 pages); previewed locally — the page renders in the docs theme with the sidebar entry and an auto-generated "On this page" TOC.

Note: the byline says "Built under a Canton Dev Fund grant" as plain text; happy to link a public proposal URL if we have one.

A worked, end-to-end example: boot a Splice LocalNet with Canton DevKit
and issue, mint, and transfer a CIP-0112 (Token Standard V2) instrument
from both the CLI and the Web UI, including the cross-participant accept
flow. This is the grant deliverable for a published case study / blog
post.

Wired as a normal docs/ source page so it renders in the Starlight theme:
a docs-map entry places it at case-studies/cip0112-token with a site
description, a new "Case studies" sidebar group surfaces it, and the
generated mirror is gitignored like the other synced pages.
The piece is a Canton DevKit case study — standing up a local Canton
network — with the Token Standard flow as the worked example, not a
CIP-0112 tutorial. Retitle to "Running a local Canton network with
Canton DevKit", move it to case-studies/running-canton-locally, and
relabel the sidebar entry so the framing matches the content.
@srikanth-bitdynamics srikanth-bitdynamics changed the title docs: add CIP-0112 token case study to the site docs: add a Canton DevKit case study (running Canton locally) Aug 17, 2026
@zheli
zheli force-pushed the docs/case-study-cip0112 branch from ad4831c to 5d10e6e Compare August 18, 2026 16:04
Focus the article on current local-development workflows and trim
outdated setup details so the guide is easier to follow.
@zheli
zheli merged commit 2c44ff0 into main Aug 18, 2026
@zheli
zheli deleted the docs/case-study-cip0112 branch August 18, 2026 16:29
zheli added a commit that referenced this pull request Aug 19, 2026
* docs: add CIP-0112 token case study to the site

A worked, end-to-end example: boot a Splice LocalNet with Canton DevKit
and issue, mint, and transfer a CIP-0112 (Token Standard V2) instrument
from both the CLI and the Web UI, including the cross-participant accept
flow. This is the grant deliverable for a published case study / blog
post.

Wired as a normal docs/ source page so it renders in the Starlight theme:
a docs-map entry places it at case-studies/cip0112-token with a site
description, a new "Case studies" sidebar group surfaces it, and the
generated mirror is gitignored like the other synced pages.

* docs: frame the case study around Canton DevKit, not just CIP-0112

The piece is a Canton DevKit case study — standing up a local Canton
network — with the Token Standard flow as the worked example, not a
CIP-0112 tutorial. Retitle to "Running a local Canton network with
Canton DevKit", move it to case-studies/running-canton-locally, and
relabel the sidebar entry so the framing matches the content.

* docs: rewrite Canton DevKit case study for clarity

Focus the article on current local-development workflows and trim
outdated setup details so the guide is easier to follow.

---------

Co-authored-by: Zhe Li <linuxcity.jn@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants