ccledger

On-chain records with one API call

Immutable records on Canton MainNet — attestations, issuance records, and co-signed proofs live today — one REST or MCP call, a verifiable on-chain proof every time. Non-custodial: your keys stay yours — sender-signed facilitated payments are live. No validator, no Daml.

Read the Docs API Explorer
Built on Canton Network
29 REST + 28 MCP Tools Non-Custodial Immutable Records Fee Credits, Fees Only Facilitated Payments — Live On-Chain Proof
--
On-Chain Writes
--
Avg Confirm
29
REST Endpoints
28
MCP Tools
// 01

Records Live. Payments Live.

Record actions are fully live on Canton MainNet — every one returns an on-chain proof: contract ID, update/transaction ID, and ledger offset. 50 trial record actions included. Value movement is live via the non-custodial delegated facilitation flow (transfers only) — you sign from your own wallet, ccledger relays. Proven end-to-end on MainNet: external party onboarding, externally-signed transfer commands, real CC settlement.

Attest & Record — Live

  • POST /attest — immutable on-chain record for audit trails (2.0 CC fee or 1 trial credit)
  • POST /attest-mutual — two-party, co-signed non-repudiation, live: pending_signature until the attestor accepts (5.0 CC fee)
  • POST /mint — issuance/certificate record (non-issuer — not Canton Coin)
  • Each returns a real on-chain proof (contract ID, update ID, ledger offset)

Know the Cost First — Live

  • POST /quote — dry-run fee preview: base fee, CCL-discounted fee, balance, affordability
  • Read-only, no side effects — agents confirm cost before spending
  • x402/p402-style 402s: fee-short responses include an accepts array so agents can top up and retry

Value Movement — Live, Non-Custodial

  • Delegated facilitation: you sign a CreateTransferCommand from your own wallet
  • ccledger relays and submits it as the application provider (the CIP-0104 confirmer role — featured-app grant pending)
  • Your keys, your CC — fee credits never fund value movement
  • Covers plain sender-signed CC transfers only — no escrow or settlement
  • Six endpoints under /facilitationread the flow

Fund On-Chain — Live

  • Send CC from your Loop wallet to the Blueprint validator party — include your key’s deposit code in the memo
  • Confirm with POST /deposit (transaction ID + amount) — credited on verification, minimum 1.0 CC
  • Your first verified deposit binds your Canton party and upgrades the key to the paid tier
  • Prepaid CC is a non-refundable fee credit — it pays per-action fees and never funds value movement
// 02

Canton Infrastructure

Production Canton validator on Global MainNet. Record actions write immutable Daml contracts; the facilitation flow exercises Splice’s audited Amulet and Canton Token Standard choices over the Ledger API — ccledger does not reimplement transfer, escrow, or settlement logic. Spring Boot backend, PostgreSQL, gRPC + JSON Ledger API. Backed by the Blueprint index — every Canton Coin transaction since the network’s June 2024 genesis, typically seconds behind the head of the chain.

Chain Tip
--
Canton MainNet head
Genesis Index
--
Every CC transaction since Jun 2024
API Status
--
29 REST · 28 MCP
Splice Version
--
Canton Network protocol
Smart Contracts
Daml
SDK --
Migration ID
4
Current network migration
Stack
Java 21 · Spring Boot
PostgreSQL 16 · OpenAPI 3.1
// 03

Developer Integration

OpenAPI 3.1 spec, an interactive API explorer, comprehensive docs, and self-service API keys. Wire Canton records into your app or AI agent in minutes.

API Explorer

  • Interactive API explorer at /api-docs/
  • Try every endpoint directly in your browser
  • Auto-generated from OpenAPI 3.1 spec

REST API

  • 29 community endpoints: register, 3 record actions, quote, balance, deposit, stats, chart, 2 query, public proof verification, 6 facilitation, plus the agentic rail (scoped agent keys + signed fee receipts) and dev on-ramp (sandbox/test mode + signed webhooks)
  • Record with /attest and /mint (including two-party /attest-mutual); preview fees with /quote
  • Sender-signed value movement via the delegated facilitation flow (transfers only) — live
  • API key auth via X-API-Key header · JSON responses with on-chain proof metadata
// 04

Non-Custodial & Secure

ccledger is non-custodial — enforced in code. Prepaid CC is a non-refundable fee credit that pays per-action fees only and never funds on-chain value movement; there is no withdrawal endpoint, and ccledger never holds your CC as a spendable balance. You keep your Loop wallet and keys. Every live action returns a verifiable on-chain proof. API key authentication, rate limiting, and security headers on every response.

On-Chain Proof

  • Every live action settles on Canton MainNet through the Global Synchronizer
  • Response returns contract ID, update/transaction ID, and ledger offset
  • A verifiable on-chain record — look it up on any Canton participant

Non-Custodial, Enforced in Code

  • Fee credits are a one-way prepayment — fees only, non-refundable, no withdrawal endpoint
  • Fee credits never fund value movement — the two are separated in code
  • Facilitated value movement is sender-signed from your own wallet — ccledger relays, never holds your CC

API Key Security

  • SHA-256 hashed keys — plaintext never stored
  • Scoped permissions and per-key rate limiting
  • Per-key tenant scoping — actions and receipts are filtered by API key, and a principal with no key is refused

Transport Security

  • HTTPS with HSTS preload (2-year max-age)
  • Content Security Policy, X-Frame-Options DENY
  • All security headers verified in automated smoke tests
YOUR BLUEPRINT

How to Use ccledger

Two paths for developers. The Community API for self-service payments and records, or admin-provisioned enterprise integration for high-volume ledger submission. Both settle on Canton MainNet.

COMMUNITY TIER

Community Tier

Register, then top up fee credits by sending CC from your Loop wallet; the first top-up is claimed once via POST /deposit, later ones auto-credit. Start with 50 trial record actions; fee credits lift the trial cap on record actions. Fee credits are non-refundable and pay per-action fees only.

  • POST /community/register → get an API key + 50 trial record actions
  • Send CC from Loop wallet → the ledger watcher credits your fee credits once confirmed on-chain (POST /deposit is the manual fallback)
  • 2.0 CC fee per record action · 5.0 CC for mutual attestation
  • Hold CCL for discount — 25% off at 200 CCL, approaching 50% asymptotically
ENTERPRISE INTEGRATION

Enterprise Access

Admin-provisioned keys with submit and query scopes for high-volume ledger submission — the surface the Blueprint portfolio management system runs on.

  • Direct Daml ledger submission via the participant
  • Query submission history and on-chain status
  • On-chain proof returned for every submission
  • Provisioned by Blueprint — not self-service
Action Lifecycle
Register: instant Top up fee credits (credited on confirmation) Call a record action Settles on MainNet — proof returned

Record actions (attest, attest-mutual, mint) create immutable on-chain records. Every live response returns an on-chain proof — contract ID, update/transaction ID, and ledger offset. Sender-signed value movement via the delegated facilitation flow (transfers only) is live.

BUILT FOR BUILDERS

Developer & Agent Ready

Canton records for developers and AI agents. 29 REST endpoints, 28 MCP tools — including scoped agent keys with signed fee receipts and a sandbox mode with signed webhooks — and full agent discovery. No Canton node required. No blockchain experience necessary.

Application Developers

Write verifiable records from any application — attestations, issuance records, and co-signed proofs, each with an on-chain proof. One API key, prepaid fee credits, done. Prototype against sandbox/test mode, then subscribe signed webhooks (fees and metadata only) for event delivery. Sender-signed value movement is live.

AI Agents & MCP

28 MCP tools let any AI agent write Canton records directly — attest, mint, and co-signed mutual records — quote the exact fee before spending, and operate under scoped agent keys with signed fee receipts (spend handles on prepaid fee credits; fees and metadata only). Compatible with Claude, ChatGPT, LangChain, CrewAI, and any MCP-enabled framework. Point your agent at /mcp and go.

Portfolio Management

Admin-provisioned enterprise integration for high-volume ledger submission — the Blueprint portfolio management system submits real Canton transactions through it.

Compliance & Audit

Attest writes immutable records on Canton MainNet — a verifiable, on-chain audit trail (including two-party mutual attestation). Ideal for compliance, notary, and financial record-keeping.

QUICK START

Get Started in Seconds

Register for an API key, record on-chain, and quote fees before you spend. No Canton node, no wallet setup, no blockchain experience required.

// the request
# 1. Register — 50 trial record actions included, no payment needed
curl -X POST https://ccledger.xyz/api/v1/community/register \
  -H "Content-Type: application/json" \
  -d '{"appName":"my-app"}'

# 2. Record an attestation — uses a trial credit (no CC required)
curl -X POST https://ccledger.xyz/api/v1/community/attest \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appName":"my-app","dataHash":"abc123","description":"My first record"}'

# 3. Quote any fee before spending — read-only, no side effects
curl -X POST https://ccledger.xyz/api/v1/community/quote \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"actionType":"attest"}'
// the response — your on-chain proof
{
  "actionId": "8f41d9c2-5b7e-4c1a-9d3f-2e8a6b0c4f17",
  "actionType": "attest",
  "status": "confirmed",
  "appName": "my-app",
  "dataHash": "abc123",
  "mintedAt": "2026-08-05T07:41:22Z",
  "proof": {
    "contractId": "0043a1…9be2",
    "transactionId": "1220c47d…88aa",
    "ledgerOffset": 1834211,
    "synchronizerId": "global-domain::1220…",
    "effectiveAt": "2026-08-05T07:41:22Z"
  },
  "rewardMarkerCreated": false
}

Every confirmed action returns this proof, typically in ~3s — re-verify it any time on ccscan.xyz. Top up fee credits (min 1.0 CC) by sending CC from your Loop wallet, with your key’s deposit code in the memo, to blueprint-validator-1::1220daab58adcae026bd2ca7ad95014f678bda3ce2a6f91b744cf3ec3d87f09deeac

Full documentation at /docs/ · Interactive API explorer at /api-docs/ · OpenAPI spec at /openapi.json

CCL BUILDER REWARDS

Hold CCL. Pay less.

Every 10 CC-paid actions earns 1 CCL Builder Reward — an account-based discount credit for the ccledger ecosystem. Hold CCL to reduce your CC cost per action: 25% off at 200 CCL held, approaching 50% asymptotically but never reaching it.

Earn
1 CCL / 10 TX
Hold CCL
Lower CC cost
Pay With
CC
Max Discount
<50%

Learn more about the CCL discount curve