Agentic API

Give agents Canton execution.

Use one gRPC interface to prepare, sign, and execute payments, transfers, DvP, CIP-56, multicall, and service workflows on Canton.

Define the logic. Keep keys local. Let agents execute.

One gRPC surface

Agents and backend applications transact on Canton through a unified Silvana Ledger interface.

Local signing

Transactions are prepared before execution, and private keys stay under agent or client control.

Typed operations

Transfers, DvP, CIP-56, recurring payments, user services, and multicall flows use explicit operation types.

Reconciliation-ready

Every executed transaction returns structured status, update ID, contract data, traffic, and errors.

Why Agentic API exists

Canton needs agent infrastructure

Tokenized assets already exist on Canton, but applications still need execution logic, signing flows, settlement automation, workflow coordination, and reliable reconciliation. Agentic API turns those requirements into a developer-ready execution layer.

Ledger complexity

BeforeRebuild contract handling, party coordination, fees, and confirmations for every app.
WithManage assets and workflows while the API handles contracts, parties, fees, and confirmations.

Unsafe automation

BeforeHand agents blind signing authority or uncontrolled access to user assets.
WithAgents act through typed operations they prepare, verify, and sign locally.

Fragmented workflows

BeforeWire payments, transfers, DvP, recurring ops, and multicall through separate paths.
WithRun every operation through one structured Silvana Ledger interface.

Hard reconciliation

BeforeStitch together transaction state from scattered, unstable signals.
WithTrack update IDs, status, traffic, created contracts, and structured errors.
Transaction flow

Prepare. Sign locally. Execute.

Every state-changing operation follows a controlled transaction flow, so agents can verify what they are about to execute before anything reaches Canton.

  1. 1

    Prepare

    The agent calls PrepareTransaction with a TransactionOperation and matching params. Silvana Ledger returns transaction_id, prepared_transaction_hash, prepared_transaction, command_id, and traffic_estimate.

  2. 2

    Verify

    The agent checks the operation, params, hash, traffic estimate, recipient, asset, and expected outcome before signing.

  3. 3

    Sign locally

    The agent signs prepared_transaction_hash with its Ed25519 private key. The key stays inside the client or controlled agent environment.

    Private keys stay local
  4. 4

    Execute

    The agent submits transaction_id and the signature through ExecuteTransaction. Silvana Ledger sends it to Canton and returns success, update_id, created_contracts, traffic, rewards, and structured errors.

  5. 5

    Reconcile

    The application stores update_id, transaction_status, created contracts, traffic usage, and provider errors for tracking, accounting, reporting, and recovery.

// 1. Prepare — the API builds the tx and returns payload + hashlet prepared = ledger.prepare_transaction(op).await?; // 2. Sign locally — private keys never leave the clientlet sig = signer.sign(&prepared.prepared_transaction_hash); // 3. Execute — submit the signature, get update_id + statuslet res = ledger.execute_transaction(prepared.transaction_id, sig).await?;println!("{} {:?}", res.update_id, res.transaction_status);
Core capabilities

Ship real Canton workflows

Agentic API gives agents and applications the primitives required to move assets, coordinate settlement, automate payments, and compose multi-step operations.

Payments

CIP-56 payments

Programmable, verifiable payments using Canton's CIP-56 standard.

CC transfers

Transfer Canton Coin directly, in bulk, or through split operations.

Recurring payments

Execute prepaid or pay-as-you-go recurring payment workflows.

Settlement

DvP execution

Propose, accept, allocate, and settle Delivery-versus-Payment workflows.

Allocation handling

Coordinate settlement readiness by checking and submitting allocations.

Settlement tracking

Read settlement contracts and track lifecycle updates to final execution.

Automation

Multicall

Execute multi-step workflows through one atomic batch operation.

Request user service

Engage providers to perform actions inside provider-defined user flows.

Preapproval

Request and manage approvals before a later operation is executed.

Connectivity

Live updates

Subscribe to Canton updates, balances, amulets, active contracts, and ledger state.

Bridge operations

Run bridge-related operations through the DAppBridgeService where enabled.

Agent onboarding

Register agents, get onboarding status, and connect them to workflows.

Functional groups

Enable only what your app needs

Agentic API operations are organized into functional groups, so services can expose only the capabilities required by a specific application, agent, or environment. Core is always enabled; other groups can be enabled or disabled independently.

Core

Enabled

Read-only queries: service info, ledger end, balances, amulets, active contracts, and updates.

Transfer

Optional

Canton Coin transfers and split operations.

DvP

Optional

Settlement contracts, DvP fees, proposals, acceptance, allocation fees, and allocations.

CIP-56

Optional

Token transfers and acceptance flows.

Recurring

Optional

Prepaid and pay-as-you-go recurring payment requests.

Onboarding

Optional

Agent registration, onboarding status, configuration, and onboarding signatures.

Multicall

Optional

Atomic multi-step execution through ExecuteMultiCall.

User service

Server-defined

Provider-defined service requests for custom application flows.

Bridge

Server-defined

Cross-network operations through the bridge service.

GetServiceInfosupported_operations
TRANSFER_CCTRANSFER_CIP56DVP_EXECUTERECURRINGEXECUTE_MULTICALLREQUEST_USER_SERVICE
Developer workflow

From schema to execution

Agentic API is built for developers who want structured access to Canton without manually rebuilding signing, settlement, and reconciliation infrastructure.

$grpcurl list01

Inspect the service

Use gRPC reflection with grpcurl, Postman, BloomRPC, or another reflection-aware client.

$protoc gen02

Generate the client

Use proto definitions from silvana.ledger.v1 to generate client code in the language of your choice.

$select op03

Choose the operation

Select a TransactionOperation and pass the matching params oneof for the workflow you need.

$prepare tx04

Prepare the transaction

Receive transaction hash, prepared transaction, command ID, transaction ID, and traffic estimate.

$sign hash05

Sign inside your environment

Sign the prepared transaction hash locally using Ed25519.

$execute tx06

Execute and reconcile

Submit the signature, receive status and update ID, then reconcile contracts, traffic, rewards, or errors.

Safety model

Automate inside clear boundaries

Agentic API lets agents perform real operations while every state-changing action remains typed, prepared, signed, and explicitly authorized.

TransactionOperation

One typed, prepared, locally-signed, explicitly-authorized action — surrounded by six structural checks.

Typed operation

Each state-changing flow uses a specific TransactionOperation instead of an open-ended instruction.

Prepared hash

The server returns the exact transaction hash that must be signed before execution.

Local signature

The agent signs inside its own controlled environment, keeping private keys out of the platform.

Traffic estimate

The response includes expected traffic cost before execution, so apps can reason about fees.

Idempotency

The command ID helps applications avoid duplicate or inconsistent execution flows.

Structured result

Execution returns status, update ID, created contracts, traffic consumed, rewards, and provider errors.

Use cases

Build workflows agents can actually run

Agentic API is designed for financial applications where agents do more than observe. They move assets, coordinate settlement, trigger services, and keep systems synchronized.

Agentic payments

CIP56_PAYMENTTRANSFER_CCRECURRINGPREAPPROVAL
Output
update_id, traffic

Treasury automation

TRANSFER_CCTRANSFER_CIP56EXECUTE_MULTICALL
Output
update_id, traffic, created_contracts

Payroll

RECURRING
Output
execution records

DvP settlement

DVP_PROPOSEDVP_ALLOCATEDVP_EXECUTE
Output
settlement contracts, update_id

Application workflows

REQUEST_USER_SERVICEEXECUTE_MULTICALL
Output
provider results, update_id

Reconciliation

SUBSCRIBEGET_ACTIVE_CONTRACTS
Output
update_ids, statuses, traffic

Agent onboarding

REGISTER_AGENTONBOARDING_STATUS
Output
Canton party, permitted ops

Bridge flows

BRIDGE_TRANSFER
Output
update_id, status
Any language, any stack

Proto in. Agents out.

Agentic API is defined through proto, supports gRPC reflection, and can be consumed from any language that works with gRPC. Agents can run in secure environments while web applications connect through SDKs and typed clients.

01

Use any language

Generate clients from proto definitions and integrate Agentic API into your backend stack.

02

Build with SDKs

Use SDKs for faster integration when you want typed helpers, examples, and agent-ready flows.

03

Run secure agents

Keep signing inside controlled local, server, or TEE-backed agent environments.

04

Inspect live services

Use GetServiceInfo and reflection to discover enabled groups and supported operations.

API response layer

Get results your systems can trust

Execution does not end when a transaction is submitted. Agentic API returns the fields applications need to track, audit, retry, and reconcile operations.

ExecuteTransaction · response200 OK
{"update_id": "0192…aa","transaction_status": "EXECUTED","contract_id": "00ab…","created_contracts": [ … ],"traffic": { read, write },"provider_error": null,"rewards_amount": 0,}
update_id
Canton update ID for the committed transaction.
transaction_status
Execution state such as EXECUTED or FAILED.
contract_id
Primary contract created by the transaction when available.
created_contracts
All contracts created — useful for change, split flows, and new assets.
traffic
Actual read, write, and total traffic consumed.
provider_error
Structured error when execution fails.
rewards_amount
Rewards data (amount and round) when applicable.
Connected products

Connect the rest of the stack

Agentic API sits between agents, applications, and Silvana execution products.

Silvana Book

Use Agentic API to connect agents to private orderbook workflows, settlement events, RFQ logic, and trading automation.

SDK

Use the SDK to onboard agents, configure logic, simulate flows, and integrate Agentic API faster.

EarnHub

Connect successfully settled activity to rewards, challenges, leaderboard progress, and seasonal participation where available.

Not sure where to start?

Tell us whether you are building an agent, a Canton app, a wallet flow, a treasury workflow, or a settlement product, and we'll point you to the right API path.

Find your fit
Get started

Build agents that execute

Start with the API reference, generate a client from proto, or use the SDK to move faster.

Start with docs

Review service setup, authentication, transaction flow, and operation references.

Start with SDK

Use ready-made tools to onboard agents, configure flows, and call Agentic API faster.