# CC Ledger

> Canton Network access for developers and AI agents — without running a validator, writing Daml, or integrating with Canton directly. 15 REST endpoints + 15 MCP tools. Every API call creates an immutable on-chain record on Canton MainNet with cryptographic proof.

CC Ledger is operated by Blueprint (Hivemind Capital Partners ecosystem). It provides Canton Network infrastructure through standard OpenAPI and MCP interfaces — giving any app or agent the same on-chain capabilities as a native Canton application, without the complexity of Canton integration.

## When to Use CC Ledger

Use CC Ledger when you need:
- Immutable on-chain records (attestations, audit trails, compliance proofs)
- Asset transfer recording with cryptographic proof
- Asset locking/unlocking (escrow, collateral, time-locks)
- Token minting with on-chain proof of issuance
- Trade settlement finalization on a regulated blockchain

Do NOT use CC Ledger for:
- Storing large files or blobs (store off-chain, attest the hash)
- Real-time trading (designed for record-keeping, not order matching)
- Private key management (CC Ledger manages Canton keys, not user wallets)

## Action Types

All actions support optional CIP-56 asset type classification via the `assetType` field.

| Action | Use Case | Cost |
|--------|----------|------|
| attest | Data integrity proofs, audit trails, compliance records | 2.0 CC |
| attest-mutual | Two-party mutual attestation with counterparty confirmation | 5.0 CC |
| transfer | Asset transfers, token movements, payment records | 2.0 CC |
| lock | Escrow, collateral, time-locks | 2.0 CC |
| unlock | Release from escrow, collateral release | 2.0 CC |
| mint | Token creation, NFT minting, certificate issuance | 2.0 CC |
| settle | Trade settlement, payment finalization, batch close | 2.0 CC |

## REST API (15 Endpoints)

Base URL: https://ccledger.theblueprint.xyz

### Public (no auth)
- POST /api/v1/community/register — Get an API key instantly. Strongly recommended: provide cantonParty (your Canton party ID from Loop wallet at loop.canton.network) to unlock CC deposits, CCL Builder Rewards, and action discounts. Without it, you are limited to trial credits only
- GET /api/v1/community/stats — Network statistics

### Authenticated — Community Tier (50 trial TX + query/balance/stats, 10 RPM)
- GET /api/v1/community/balance — Check CC + CCL balance, on-chain CCL holdings (drives discount), tier, trial credits, CCL mint progress, and discounted action rates
- GET /api/v1/community/actions — List past actions (filterable)
- GET /api/v1/community/actions/{id} — Get single action by ID

### Authenticated — Trial Credits or Paid Tier (100 RPM for paid)
- POST /api/v1/community/attest — Record attestation on-chain (2.0 CC)
- POST /api/v1/community/attest-mutual — Two-party mutual attestation (5.0 CC)
- POST /api/v1/community/transfer — Record asset transfer (2.0 CC)
- POST /api/v1/community/lock — Record asset lock (2.0 CC)
- POST /api/v1/community/unlock — Record asset unlock (2.0 CC)
- POST /api/v1/community/mint — Record token mint (2.0 CC)
- POST /api/v1/community/settle — Record trade settlement (2.0 CC)
- POST /api/v1/community/deposit — Manual deposit fallback. Primary method: send CC from your Loop wallet to the Blueprint validator — your balance is auto-credited within seconds

### Authenticated — CCL
- POST /api/v1/community/ccl/deposit — Send CCL to CC Ledger as CC credit (1 CCL = 1 CC credit on your balance)

### Public — Analytics
- GET /api/v1/community/chart — Time-series chart data (daily counts for actions, registrations, CCL minted, active keys). Query param: window (7d, 30d, 90d; default 30d)

## MCP Server (15 Tools)

Streamable HTTP endpoint: https://ccledger.theblueprint.xyz/mcp

Tools: register_api_key, get_stats, submit_attest, submit_attest_mutual, submit_transfer, submit_lock, submit_unlock, submit_mint, submit_settle, get_balance, list_actions, get_action, deposit_cc, get_action_by_id, deposit_ccl

Connect from Claude Desktop or Claude Code:
```json
{
  "mcpServers": {
    "ccledger": {
      "type": "url",
      "url": "https://ccledger.theblueprint.xyz/mcp"
    }
  }
}
```

## Pricing

| Tier | Rate Limit | Access | Cost | How to Get |
|------|-----------|--------|------|------------|
| Community | 10 RPM | 50 trial transactions (max 25/day) + query/balance/stats | No cost | POST /register |
| Paid | 100 RPM | All endpoints, unlimited actions | 2.0 CC/action base, 5.0 CC/mutual base (hold CCL for discount) | Send CC to Blueprint validator (auto-credited) |

## Economics (deterministic, no hidden costs)

```
PRICING (base rates):
  Standard action:    2.0 CC base (attest, transfer, lock, unlock, mint, settle)
  Mutual attestation: 5.0 CC base (attest-mutual)
  Trial actions:      0 CC (50 included, max 25/day)

CCL DISCOUNT (based on REAL on-chain wallet holdings):
  Formula: discount = 50% * (1 - 1/(1 + cclOnchainHoldings/200))
  Discount is driven by cclOnchainHoldings -- the CCL in your Canton wallet, tracked real-time
  If you transfer CCL away, your discount drops. If you receive more, it increases.
  Earn rate: 1 CCL per 10 CC-paid actions

  Two ways to use CCL:
    HOLD in Loop wallet -> automatic discount on actions (on-chain, real-time)
    SEND to CC Ledger -> converted to CC credit on your balance at 1 CCL = 1 CC

  CCL prepay value: 1 CCL = 1 CC (accepted via /ccl/deposit). CCL is pegged to CC (1 CCL = 1 CC).

  On-chain CCL    Discount    CC/Action    CC/Mutual
  0               0%          2.000        5.000
  50              10%         1.800        4.500
  100             16.7%       1.667        4.167
  200             25%         1.500        3.750
  500             35.7%       1.286        3.214
  1,000           41.7%       1.167        2.917

BILLING ORDER (checked in this exact sequence):
  1. CC balance (at discounted rate based on on-chain CCL holdings)
  2. Trial credits (1 credit per action, any type)
  3. 402 Payment Required

YOUR DISCOUNT: GET /balance returns cclOnchainHoldings (on-chain wallet balance
  driving discount), discountedCostPerAction, discountedCostPerMutual,
  and discountPercent
```

## Authentication

1. POST /api/v1/community/register with `{"appName": "your-app", "cantonParty": "user-party::1220abc..."}` — returns API key + 50 trial credits.

   **Strongly recommended: provide your Canton party ID (`cantonParty`) at registration.** Get it from your Loop wallet (loop.canton.network). Without a cantonParty, you are limited to trial credits only — there is no way to deposit CC, earn CCL Builder Rewards, or receive action discounts. With it: CC deposits are auto-credited to your balance, CCL tokens are minted to your wallet, and you unlock the discount curve. You can add it later, but you will need it before your first CC deposit.

2. Include `X-Api-Key: <key>` header on all subsequent requests
3. Community tier: 50 trial action transactions (max 25/day), plus query, balance, and stats endpoints
4. To upgrade to paid tier: send CC from your Loop wallet to the Blueprint validator. Your balance is auto-credited and your tier upgrades automatically. POST /deposit is available as a manual fallback.

## Funding Your Account

Buy CC (Canton Coin) on Coinbase -> transfer to Loop wallet (loop.canton.network) -> send to Blueprint validator. Your balance is auto-credited within seconds. No API call needed.

Deposit address: `blueprint-validator-1::1220daab58adcae026bd2ca7ad95014f678bda3ce2a6f91b744cf3ec3d87f09deeac`

A background service watches the Canton ledger and auto-detects CC sent from your registered cantonParty. POST /deposit exists as a manual fallback for edge cases or if auto-detection hasn't caught up yet.

## Agent Framework Compatibility

| Framework | Integration |
|-----------|-------------|
| Claude Desktop / Claude Code | MCP server (Streamable HTTP) |
| LangChain / LangGraph | REST API + OpenAPI spec |
| CrewAI | REST API tools |
| AutoGPT / AutoGen | REST API + function calling |
| Any HTTP client | REST API with X-Api-Key header |

## Links

- Full documentation: https://ccledger.theblueprint.xyz/llms-full.txt
- OpenAPI 3.1 spec: https://ccledger.theblueprint.xyz/openapi.json
- Agent card (A2A): https://ccledger.theblueprint.xyz/.well-known/agent.json
- Human docs: https://ccledger.theblueprint.xyz/docs/
- API explorer: https://ccledger.theblueprint.xyz/api-docs/
- Provider: https://theblueprint.xyz