CAYPO DOCS

Build with CAYPO

Documentation, API references, and integration guides for AI agent banking on Canton Network.

v0.2.0 · 312 tests · Apache 2.0 / MIT

Quick Start

Get your wallet running in 30 seconds

# Install the CLI globally$ npm install -g @caypo/canton-cli# Initialize a new wallet$ caypo init✓ Wallet created: agent_0xf3a2::1220847...✓ Canton party allocated✓ Keystore encrypted (AES-256-GCM)✓ Safeguards set: $1,000/tx, $5,000/day# Check your balance$ caypo balance  Checking    $0.00 USDCx  Savings     $0.00  Credit      $0.00  Investment  $0.00  Total: $0.00

5 packages on npm

Install any package: npm install @caypo/canton-sdk

@caypo/canton-sdkSDK

Canton JSON Ledger API v2 client, USDCxService for CIP-56 transfers, encrypted Keystore, SafeguardManager, TrafficManager, and MppPayClient.

import { CantonClient } from '@caypo/canton-sdk'

CantonClientUSDCxServiceKeystoreSafeguardManagerMppPayClient

npm GitHub

@caypo/mpp-cantonMPP

MPP payment method for Canton. cantonMethod definition, cantonClient for credentials, cantonServer for payment verification.

import { cantonMethod } from '@caypo/mpp-canton'

cantonMethodcantonClientcantonServer

npm GitHub

@caypo/canton-cliCLI

36 commands for agent wallet management. init, balance, send, pay, savings, credit, exchange, invest, and more.

$ npm install -g @caypo/canton-cli

36 commands21 top-level15 sub-commands

npm GitHub

@caypo/canton-mcpMCP

MCP server with 35 tools and 20 prompts. Works with Claude Desktop, Cursor, Windsurf, and any MCP client.

$ npx @caypo/canton-mcp

35 tools20 promptsstdio transport

npm GitHub

@caypo/canton-gatewayGateway

Hono-based MPP API proxy. 17 upstream services, 46 endpoints with TransferPreapproval payment verification.

import { app } from '@caypo/canton-gateway'

17 services46 endpointsHono framework

npm GitHub

API reference

Complete API documentation for all 5 packages.

SDK — @caypo/canton-sdk

CantonClient

├── .submitAndWait(params) → SubmitAndWaitResponse

├── .queryActiveContracts(params) → ActiveContract[]

├── .getTransactionById(id) → TransactionTree | null

├── .getLedgerEnd() → number

├── .allocateParty(hint) → PartyDetails

└── .isHealthy() → boolean

USDCxService

├── .transfer(to, amount) → UpdateId

├── .getBalance(partyId) → string

└── .getHoldings(partyId) → Holding[]

SafeguardManager

├── .get(partyId) → SafeguardConfig

├── .set(partyId, config) → void

└── .check(amount) → boolean

CLI — @caypo/canton-cli

caypo initInitialize wallet + Canton party

caypo balanceShow all account balances

caypo sendSend USDCx to another party

caypo payPay for an MPP service

caypo addressShow party ID

caypo safeguardsView/set transaction limits

caypo trafficMonitor traffic usage

caypo mcp installInstall MCP server

caypo saveDeposit to savings

caypo withdrawWithdraw from savings

caypo borrowBorrow against savings

caypo repayRepay credit balance

caypo exchangeSwap USDCx and CC

caypo invest buyBuy assets

caypo invest sellSell assets

caypo portfolioInvestment portfolio P&L

MCP — @caypo/canton-mcp (top 10 of 35)

caypo_balanceGet all account balances

caypo_sendSend USDCx transfer

caypo_payPay for an MPP API service

caypo_saveDeposit to savings account

caypo_borrowBorrow from credit account

caypo_exchangeExchange USDCx and CC

caypo_invest_buyBuy assets for investment

caypo_safeguardsView/set spending limits

caypo_historyTransaction history

caypo_portfolioInvestment portfolio P&L

Canton Network for CAYPO developers

Canton is NOT an EVM chain. Key differences:

EVM Concept	Canton Equivalent
Wallet address	Party ID (DisplayName::hex)
ERC-20 token	CIP-56 Holding contract
Transfer	TransferFactory.Transfer choice
Gas (ETH)	Traffic (CC)
Smart contract	DAML template
Block explorer	ccview.io
JSON-RPC	JSON Ledger API v2 (port 7575)
Public ledger	Privacy by default
Nonce	Command ID (UUID)
Token decimals (18)	Amount precision (10 decimals)