API Reference

See the full execution surface.

Silvana exposes typed services for market access, transaction execution, settlement, pricing, and agent inputs. Use this page to understand how the pieces fit, then move into the full technical reference for exact methods and schemas.

Typed services. Explicit authorization. Structured results.

The Silvana service surface

Five service families. One operating model.

The public service map should match current proto definitions and documentation. Names, methods, and availability must be reviewed against the maintained schema before every release.

Orderbook Service

Submit and manage orders, read market data, initiate private RFQ workflows, and subscribe to order and execution events.

Best starting point

Agents and applications interacting with Silvana Book.

Order submissionOrder cancellation and updatesMarket dataPrivate RFQOrder stateExecution subscriptions
Settlement Service

Coordinate settlement proposals, preconfirmations, allocation readiness, lifecycle events, and final outcomes for supported DvP workflows.

Best starting point

Applications that need to follow the trade beyond matching.

Settlement proposalsPreconfirmationAllocation statusLifecycle eventsFinal settlement stateFailure or expiry handling
Ledger and Execution

Read supported Canton state, onboard agents, prepare transactions, execute signed operations, and return structured results for reconciliation.

Best starting point

Agents and backend applications performing state changing Canton operations.

Service informationBalances and active stateAgent onboardingTransaction preparationSigned executionUpdate and contract results
Pricing Service

Receive supported price and quote data for strategy evaluation, RFQ logic, monitoring, and execution decisions.

Best starting point

Agents that require approved external price context.

Price subscriptionsSource normalizationQuote inputsMarket contextStrategy signals
News and Signal Services

Receive supported product, protocol, or event information through feed or streaming interfaces where available.

Best starting point

Workflows that use approved informational inputs as part of a wider decision model.

Event feedsLive streamsProduct updatesProtocol signalsAgent triggers
State changing operations

Prepare what will happen before it happens.

01

Prepare

Send the typed operation and parameters. Silvana returns the prepared payload, hash, identifiers, and available estimates.

02

Verify

Confirm the operation, asset, amount, recipient, fees, permissions, and expected outcome inside the client environment.

03

Sign

Sign the prepared transaction hash inside the approved environment. Private key material remains there.

04

Execute

Submit the transaction identifier and signature through the relevant execution service.

05

Reconcile

Store the returned update identifier, status, created records, usage information, and errors.

The platform prepares the operation. The client verifies and authorizes it. The resulting status is returned in a form the application can track.

One model across stacks

The language changes. The authorization model does not.

Prepare, verify, sign, execute.

Examples should be synchronized from maintained documentation or repositories. Exact clients, types, method names, and arguments must match the current release before publication.

Representative Rust flowCurrent flow
let prepared = ledger.prepare_transaction(operation).await?;
verify_transaction(&prepared)?;

let signature = signer.sign(
    &prepared.prepared_transaction_hash
);

let result = ledger.execute_transaction(
    prepared.transaction_id,
    signature
).await?;
Identity and authorization

Keep identity, access, and signing explicit.

Service discovery

Inspect the active service, enabled capability groups, supported operations, and environment information before a workflow starts.

Agent onboarding

Register the agent and obtain the identifiers and configuration required by the selected environment.

Authenticated sessions

Use the current authentication model for methods that require an approved identity or signed session.

Prepared transaction hash

Sign the exact hash returned for the prepared transaction rather than reconstructing the operation independently.

Local authorization

Keep private key material inside the approved application, agent, server, cloud, or secure execution environment.

Permission scope

Expose only the operations required by the application or agent, using supported capability groups where available.

Event driven by design

Build around lifecycle events, not blind polling.

Silvana services expose streams and structured state that let agents and applications follow activity as it changes.

Market data

Receive the supported orderbook, quote, and market information required by the strategy or product experience.

Order state

Follow submission, acceptance, updates, fills, cancellations, and other supported order events.

Settlement lifecycle

Track proposals, readiness, allocations, state changes, finalization, expiry, or failure according to the active workflow.

Ledger updates

Receive supported Canton updates, active state changes, balances, and execution results.

Price and signal inputs

Subscribe to approved pricing or informational feeds where those services are available.

Reconnect and recovery

Use the current cursor, update identifier, or recovery model to resume without losing important workflow state.

Structured in. Structured out.

Give the application enough information to act and reconcile.

01

Operation

A typed action that identifies the workflow being requested.

02

Parameters

Operation specific values for the selected asset, participant, amount, service, or settlement flow.

03

Transaction identifier

The reference that connects preparation, signing, execution, and retry handling.

04

Command identifier

The identifier used by the supported workflow to help manage duplicate or inconsistent submissions.

05

Signature

The authorization created inside the approved signing environment.

06

Update identifier

The canonical reference returned for the committed Canton update when available.

07

Transaction status

The structured state that tells the client whether execution completed, failed, or requires lifecycle tracking.

08

Structured error

A machine readable error that helps the application decide whether to stop, correct, retry, or reconcile.

Design for the unhappy path

A production integration must know what to do next.

Idempotency

Use the current command and transaction identifiers to avoid accidental duplicate execution.

Explicit status

Do not infer success from submission alone. Store and evaluate the status returned by the service.

Structured errors

Handle validation, authorization, environment, provider, settlement, and network errors according to documentation.

Retry policy

Retry only when the operation and error class permit it. Do not treat every failed request as safe to repeat.

Lifecycle recovery

Resume from the latest durable identifier or state supported by the relevant service.

Observability

Log identifiers and state transitions that help operators understand what action is safe next.

Start with the surface

Choose the service. Build the first call.

Open the full reference for exact schemas, or follow the SDK Guide when the goal is a running agent rather than a direct service integration.