GitHub Try Ginie →
Getting Started

Quick Start

The fastest way to deploy a Canton contract is through the Ginie web interface. No account, no credentials, no Daml knowledge required.

1
Go to canton.ginie.xyz
The public GinieNet sandbox is available to anyone — no sign-up required. GinieNet is a live Canton testnet where every contract you deploy has a real Contract ID.
2
Create Your Party Identity
Before deploying contracts, you need a Canton party identity. Click Add Parties or navigate to /setup. Choose a party name — Ginie allocates a unique party ID on the Canton ledger. This step is one-time; your party persists across sessions.
Party setup screen
Party setup complete · Party ID allocated on Canton sandbox · Session active 7 days
3
Describe your contract in plain English
Type what you want the contract to do. Ginie's Intent Agent converts your description into a structured contract specification. The pipeline sidebar shows what runs next.
Contract generator prompt input
Contract generator · Describe your contract · Pipeline shows 6 stages that run automatically
example prompt
Create an IOU between Alice and Bob for £10,000 GBP.
Alice can transfer the IOU to another party.
Bob can settle the IOU by paying Alice directly.
4
Wait ~35 seconds — the pipeline runs automatically
Ginie generates the Daml code, compiles it with dpm build, runs the security audit, and deploys. If compilation needs fixing, the Fix Agent handles it automatically (up to 3 retries).
Live pipeline progress
Live pipeline progress · Stage 3 Compiling active · Auto-fixing errors (attempt 1/3) · 60%
5
Receive your Contract ID and security scores
Ginie returns the deployed Contract ID, a CantonScan link, and your Enterprise Security & Compliance scores. You can then export the source, download the DAR, or iterate.
Contract deployed with security scores
Contract deployed · All 5 audit gates passed · Enterprise Security & Compliance scores returned
6
View the generated code and Contract ID
Switch between Code, Contract Flow, and Files tabs. The Contract ID and Package ID are shown at the top — copy them to verify on CantonScan or use in the Ledger Explorer.
Generated code view
Contract result · Contract ID · Package ID · Generated Daml source in Code tab

Using the Python SDK

bash
pip install ginie
python
from ginie import GinieClient

client = GinieClient(api_key="your-key")

result = client.deploy(
    prompt="Create an IOU between Alice and Bob for £10,000",
    ledger="ginienet"   # or "localnet", "mainnet"
)

print(result.contract_id)    # #1:00:abc3d7...f92a
print(result.cantonscan_url)
print(result.audit_report)   # Full 5-gate audit findings
Getting Started

Core Concepts

What Ginie is

Ginie is an AI pipeline that accepts plain English descriptions and produces deployed Canton smart contracts. It is not a code editor. It is not an AI assistant. It is a fully automated deployment system where the output is a live Contract ID on a Canton ledger — not code to copy-paste.

GinieNet

GinieNet is a public Canton sandbox operated by BlockX AI. Any user can deploy contracts to GinieNet without DevNet credentials or a Canton account. Every Contract ID on GinieNet is real — verifiable on CantonScan. GinieNet is intended for prototyping and evaluation.

Daml and Canton — brief context

Daml is a smart contract language built for financial workflows. Canton Network is the blockchain that runs Daml contracts. Normally, writing and deploying a Daml contract requires learning Daml (a Haskell-derived language with strict type rules and party semantics), installing the Canton SDK, and running several CLI commands. Ginie handles all of this for you.

⚠️
Scope
Ginie generates single-module contracts of 50–200 lines — IOUs, bonds, repos, DvP, custody, multi-party settlements. It does not generate multi-module enterprise Daml packages or daml-finance interface extensions. See Scope & Limitations.

Key terms

TermWhat it means in Ginie context
GinieNetPublic Canton sandbox at canton.ginie.xyz — free to use, no sign-up
Contract IDThe live on-ledger identifier returned after successful deployment (#1:00:abc3d7…)
DARDaml Archive — the compiled artifact uploaded to the Canton Ledger API
dpmDigital Asset Package Manager — the official Canton SDK CLI tool Ginie uses to compile
SCUSmart Contract Upgrade — Canton's on-chain upgrade mechanism; Ginie enforces compatibility by default
Audit LayerGinie's 5-gate pre-deployment security scan run on every generated contract
Canton SkillsThe npm knowledge base Ginie's agents use internally — also available standalone via npx canton-skills install

The Daml SDK Ginie uses

All contracts are compiled with Canton SDK 3.4 using dpm build and dpm test — the official Digital Asset package manager. The Canton JSON Ledger API (port 7575) handles deployment. Every generated daml.yaml targets Canton SDK 3.4.