{ "id": "blueprint-cc-ledger", "name": "ccledger", "description": "Non-custodial Canton records and payments API for developers and AI agents. On-chain record actions (attest, attest-mutual, mint) are fully live — one REST or MCP call, no validator, no Daml — and every one returns an on-chain proof (contract ID, update/transaction ID, ledger offset). 15 REST endpoints and 15 MCP tools. Non-custodial is enforced in code: prepaid CC is a NON-REFUNDABLE fee credit that pays per-action fees only, never funds on-chain value movement, and cannot be withdrawn. The legacy balance-funded value endpoints (transfer, lock, settle) are permanently disabled and return HTTP 403 non_custodial; on-chain CC movement is moving to the delegated facilitation flow — you keep your own wallet and keys, sign a CreateTransferCommand yourself, and ccledger relays it as the featured application (CIP-0104 confirmer) — rolling out now, not yet callable. Unlock remains live and free. Fees: 2.0 CC per record action, 5.0 CC per mutual attestation (or 1 of 50 trial credits, max 25/day). Fund fee credits by sending CC from your Loop wallet to the Blueprint validator (auto-credited; minimum 1.0 CC; your Canton party is bound on the first verified top-up). CCL Builder Rewards: earn 1 CCL per 10 CC-paid actions and hold CCL to reduce your fee (up to ~50% off). Use POST /quote for a dry-run fee preview before spending; fee-insufficient 402 responses are x402/p402-style with an accepts array.", "url": "https://ccledger.xyz", "provider": { "organization": "Blueprint Infrastructure, LLC", "url": "https://theblueprint.xyz", "parentOrganization": { "name": "Hivemind Capital Partners", "url": "https://www.hivemind.capital" } }, "version": "3.4.0", "capabilities": { "streaming": false, "pushNotifications": false }, "skills": [ { "id": "register", "name": "Register API Key", "description": "Self-service API key registration. No approval needed. Returns key instantly with 50 trial record-action credits included (max 25/day). The cantonParty field is an optional echoed hint only — it is NOT bound at registration; your Canton party is bound on your first VERIFIED fee-credit top-up (the verified on-chain transfer from that party is the proof of control), which also attaches CCL Builder Rewards.", "tags": ["registration", "api-key", "onboarding", "canton-party"], "examples": [ { "input": "Register for a ccledger API key for my trading app", "output": "API key created: cb_community_... (community tier, 10 RPM, 50 trial record-action credits)" } ] }, { "id": "attest", "name": "On-Chain Attestation", "description": "LIVE. Record data integrity proofs, audit trails, and compliance records on Canton MainNet. 2.0 CC fee or 1 trial credit; returns a real on-chain proof (contractId, updateId).", "tags": ["attestation", "proof", "audit", "compliance", "canton"], "examples": [ { "input": "Attest the SHA-256 hash of this document on Canton", "output": "Attestation confirmed. Contract ID: 005a1b... Ledger offset: 2001542" } ] }, { "id": "attest-mutual", "name": "Mutual Attestation", "description": "LIVE. Create a mutual attestation proposal requiring co-signature from an attestor party for non-repudiation. 5.0 CC fee or 1 trial credit.", "tags": ["attestation", "mutual", "non-repudiation", "signing", "canton"] }, { "id": "mint", "name": "Issuance Record", "description": "LIVE. Record an issuance or certificate on-chain. ccledger is a non-issuer — this does NOT mint Canton Coin (DSO-only) or a tradeable token; it writes an immutable on-chain record. 2.0 CC fee or 1 trial credit.", "tags": ["mint", "record", "certificate", "issuance", "canton"] }, { "id": "quote", "name": "Dry-Run Fee Quote", "description": "LIVE. POST /quote previews an action's exact cost before spending: baseFee, the CCL-discounted fee, discountPercent, your fee-credit balance, and sufficientForFee. Read-only, no side effects. For transfer/lock/settle the note states the non_custodial gate (those endpoints return 403 today).", "tags": ["quote", "pricing", "fees", "dry-run", "agent-safety"] }, { "id": "unlock", "name": "Release Time-Lock", "description": "LIVE and FREE (no fee). Releases a previously created LockedAmulet back to its owner by lockId and restores the balance. Not affected by the non-custodial gate — it only unwinds an existing lock. New balance-funded locks can no longer be created.", "tags": ["unlock", "escrow", "time-lock", "locked-amulet", "canton"] }, { "id": "value-movement", "name": "Value Movement (Delegated Facilitation — rolling out)", "description": "The legacy balance-funded transfer/lock/settle endpoints are PERMANENTLY DISABLED and return HTTP 403 non_custodial: prepaid CC credits pay per-action fees only and never fund on-chain value movement. On-chain CC movement is moving to the non-custodial delegated facilitation flow: the user keeps their own wallet and keys, signs a CreateTransferCommand themselves, and ccledger relays and submits it as the featured application (CIP-0104 confirmer). Status: rolling out — not yet callable. Do not call transfer/lock/settle expecting execution.", "tags": ["transfer", "settlement", "facilitation", "non-custodial", "canton", "roadmap"] }, { "id": "balance", "name": "Fee Credits & Auto Top-Up", "description": "Check fee credits (non-refundable prepaid CC that pays per-action fees only — never a withdrawable value balance), your CCL discount balance (cclOnchainHoldings drives your discount), tier status, and discounted action rates. Top-ups are auto-detected: send CC (minimum 1.0) from your Loop wallet to the Blueprint validator and your fee credits are credited within seconds; your Canton party is bound on the first verified top-up. POST /deposit exists as a manual fallback.", "tags": ["balance", "fee-credits", "top-up", "funding", "coinbase", "loop", "canton"] }, { "id": "query", "name": "Action Query", "description": "List and retrieve past actions with full on-chain proof. Filter by app, type, and pagination.", "tags": ["query", "actions", "history", "proof", "audit"] }, { "id": "stats", "name": "Network Statistics", "description": "Public endpoint returning Canton Network statistics — total actions, active apps, and uptime. No auth required.", "tags": ["stats", "monitoring", "health", "public"] }, { "id": "ccl-discount", "name": "CCL Builder Rewards", "description": "CCL is an account-based, non-transferable discount credit. Hold CCL to reduce your CC fee per action — discount approaches ~50%. Discount based on the CCL you hold (cclOnchainHoldings). Formula: discount = 50% * (1 - 1/(1 + cclOnchainHoldings/200)). Earn 1 CCL per 10 CC-paid actions (trial actions do not count). Tracked on your ccledger account, shown in GET /balance.", "tags": ["ccl", "discount", "rewards", "canton"], "examples": [ { "input": "Check my CCL balance and discount", "output": "cclOnchainHoldings: 100.0, discount: 16.7%, discounted fee: 1.667 CC/action, 4.167 CC/mutual (via GET /balance)" } ] } ], "interfaces": [ { "type": "rest", "url": "https://ccledger.xyz/api/v1", "specUrl": "https://ccledger.xyz/openapi.json", "specType": "openapi", "specVersion": "3.1.0" }, { "type": "mcp", "url": "https://ccledger.xyz/mcp", "transport": "streamable-http", "toolCount": 15 } ], "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Self-service API key from POST /api/v1/community/register. No approval needed." } }, "documentation": { "llmsTxt": "https://ccledger.xyz/llms.txt", "llmsFullTxt": "https://ccledger.xyz/llms-full.txt", "humanDocs": "https://ccledger.xyz/docs/", "apiExplorer": "https://ccledger.xyz/api-docs/" }, "health": "https://ccledger.xyz/actuator/health", "support": { "email": "contact@theblueprint.xyz", "url": "https://theblueprint.xyz" } }