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.
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
acceptsarray so agents can top up and retry
Value Movement — Live, Non-Custodial
- Delegated facilitation: you sign a
CreateTransferCommandfrom 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
/facilitation— read 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
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.
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
/attestand/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-Keyheader · JSON responses with on-chain proof metadata
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
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
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 /depositis 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 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
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.
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.
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.
# 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"}'
{
"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
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.
