> ## Documentation Index
> Fetch the complete documentation index at: https://docs.silvana.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud Agents

Silvana Book Agent can run on self-hosted infrastructure or in a managed cloud environment. The agent communicates with Silvana through a gRPC service, signs transactions locally, and never transmits the private key to the server.

Silvana Book agents are not tied to a single hosting model: you can deploy the agent on your own infrastructure or run it in the cloud.

* **Self-hosted:** Full infrastructure control, internal scaling, and deployment management.
* **Google Cloud:** Managed runtime, automatic scaling, built-in secret storage, faster production rollout.

<Note>
  The following links are **necessary** for developers to access the protocol, library interface, and reference implementation:

  * [**Proto specification**](https://github.com/SilvanaOne/silvana-book-agent/tree/main/proto/silvana)
  * [**Agent code repository**](https://github.com/SilvanaOne/silvana-book-agent)
  * [Silvana Book Agent README](https://github.com/SilvanaOne/silvana-book-agent/blob/main/README.md)
</Note>

# Quickstart

<Steps>
  <Step title="Install prerequisites">
    <Tabs>
      <Tab title="Prebuilt binary">
        Download the latest `cloud-agent` binary from the [GitHub Releases page](https://github.com/SilvanaOne/silvana-book-agent/releases/latest).

        | Platform | Archive |
        | - | - |
        | macOS Apple Silicon | `cloud-agent-macos-silicon.tar.gz` |
        | Linux x86\_64 | `cloud-agent-x86_64-linux.tar.gz` |
        | Linux ARM64 | `cloud-agent-arm64-linux.tar.gz` |

        <Accordion title="macOS Apple Silicon example">
          ```bash theme={null}
          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
          ```
        </Accordion>

        Checksums for all archives are available in `checksums.txt` on the release page.
      </Tab>

      <Tab title="Build from source">
        Build the CLI from the repository root:

        ```bash theme={null}
        cargo build --release -p cli
        ```

        The compiled binary is available at:

        ```bash theme={null}
        target/release/cloud-agent
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Onboard the agent">
    Before onboarding, make sure you have a Silvana DevNet invite code. Silvana provides the invite code.

    ```javascript theme={null}
    cloud-agent onboard \
      --agent-name my-agent \
      --email me@example.com \
      --invite-code INVITE1
    ```

    On successful onboarding, `cloud-agent` creates the agent identity, completes the required Canton setup, and writes `.env` and a starter `agent.toml` to the current directory.

    <Note>
      The DevNet RPC is used by default. Use `--rpc <URL>` only when connecting to another endpoint.
    </Note>
  </Step>

  <Step title="Run the agent">
    Once onboarding is complete, start the long-running agent process:

    ```rust theme={null}
    cloud-agent agent
    ```
  </Step>
</Steps>

## Developer reference

Silvana Book Agent communicates with the orderbook server through four gRPC services defined under `proto/silvana/*/v1/*.proto`.

| **Service** | **Purpose** |
| - | - |
| `DAppProviderService` | Transaction signing, balance, and contract queries |
| `SettlementService` | DvP settlement orchestration and RFQ handling |
| `OrderbookService` | Order submission, market data, and RFQ initiation |
| `PricingService` | External price feeds |