Skip to main content

​
Installation

Follow this guide to start using Silvana Book Agent.
  1. Download the latest cloud-agent binary from the GitHub Releases page:
    PlatformArchive
    macOS Apple Siliconcloud-agent-macos-silicon.tar.gz
    Linux x86_64cloud-agent-x86_64-linux.tar.gz
    Linux ARM64cloud-agent-arm64-linux.tar.gz
See example below: 
macOS Apple Silicon
curl -LO https://github.com/SilvanaOne/silvana-book-agent/releases/latest/download/cloud-agent-macos-silicon.tar.gz
tar -xzf cloud-agent-macos-silicon.tar.gz
chmod +x cloud-agent
./cloud-agent --help
Checksums for all archives are in checksums.txt on the release page.
  1. Build from source.
cargo build --release -p cli
Binary at target/release/cloud-agent.
  1. Onboard. This flow is automatic. Go here to see how it runs. Example: 
    cloud-agent onboard \
  --agent-name my-agent \
  --email me@example.com \
  --invite-code INVITE1
    Default RPC is https://orderbook-devnet.silvana.dev:443 — override with --rpc.

​
Operations

Now you’re good to go. The following operations are available, and how to launch them:

​
Faucet

To use the faucet, run this command: 
cloud-agent faucet get --token CC      # 10,000 CC
cloud-agent faucet get --token USDC    # 1,000 USDC
cloud-agent info balance

​
Buy CC via RFQ

Requests a quote on the CC-USDC market, accepts the best offer, and settles atomically via a single multicall. Repeats until the full amount is filled. 
cloud-agent buy --market CC-USDC --amount 15

​
Sell CC via RFQ

Request selling CC by running this command: 
cloud-agent sell --market CC-USDC --amount 100

​
Run as LP / market-maker

This is a long-running mode. It places grid orders on configured markets, responds to incoming RFQs, and settles DVPs end-to-end.
Configured via agent.toml
To run as LP/Market-maker, enter this command: 
cloud-agent agent
Use the docs below for reference to guide you as you build on Silvana.

Prerequisites

See what you need to start building on Silvana.

Agent Onboarding

Learn the agent onboarding flow under the hood.

Configuration

Silvana Book Agent config doc. Nice to have for agent onboarding.

CLI Reference

A full list of CLI commands to get an agent running.

SDK Interaction Flow

Read about the transaction mechanics in Silvana Book.

Trading Modes

Find out about the supported trading modes – Grid, RFQ, and Taker Loops.

Authentication and Signing

Study the guidelines for authentication and signing.

Security Model

Get to know Silvana Book’s security arrangements and practices.