primer · canton / daml

Four Daml primitives, demystified.

Every idea in this repo leans on one of four Canton primitives. Each runs against the Seaport Devnet validator — a hosted Canton 3.x participant on the Canton Devnet global synchronizer — so you can ship a verifiable demo with zero infra and zero gas.

No secrets required

Lovable provisions the AI key for you. Nothing to paste before running a mega-prompt.

LOVABLE_API_KEYAuto-provisioned by Lovable. Powers Lovable AI Gateway for any AI feature.
AISA_API_KEYOptional fallback if you exhaust your daily Lovable AI credits.

The six Canton Devnet values are baked into every project. Full reference on the Seaport access page →

Validator: https://ledger-api.validator.devnet.sandbox.fivenorth.io/

onchain logic

Daml smart contract on Seaport

250 ideas use this

kernel

a Daml template compiled into a DAR, uploaded to the Seaport Devnet validator, and instantiated through the JSON Ledger API v2

how it drives the UI

a 'live on Canton' badge with the contract id and a link to the Seaport ledger explorer

EXAMPLE IDEAS

sovereign identity

Canton party allocation

249 ideas use this

kernel

a per-user Canton party allocated on the Seaport validator so each creator has an on-ledger identity bound to their app account

how it drives the UI

a 'party allocated' chip with the fully-qualified party id and an 'act as' indicator

EXAMPLE IDEAS

live ledger feed

Active contract set stream

247 ideas use this

kernel

a websocket subscription to /v2/state/active-contracts that streams every contract the runtime party can see, rendered live in the UI

how it drives the UI

an always-fresh ledger feed that updates the instant any new contract is created or archived

EXAMPLE IDEAS

verifiable action

Exercised choice as event

250 ideas use this

kernel

exercising a Daml choice (Publish, Endorse, Mint, Log) through submit-and-wait-for-transaction and surfacing the resulting updateId

how it drives the UI

a 'signed by Canton' receipt with the choice name, updateId, and timestamp from the validator

EXAMPLE IDEAS