> ## 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.

# Silvana Book Agent

Silvana Book Agent enables automated orderbook workflows, managing orders, execution, and settlement end-to-end, powering multiple trading modes, including grid trading, RFQ, and taker execution flows.

<Check>
  Silvana Book Agent runs without direct access to the Canton ledger. All ledger operations are proxied through the Silvana gRPC service.
</Check>

Through its interaction model, the orderbook, agents, and coordination layer together enable fast off-chain execution with reliable on-chain settlement.

<Note>
  The **Coordination Layer** ensures that agents progress through settlement steps in a consistent, controlled manner and that [**Delivery-versus-Payment**](https://docs.silvana.one/how-silvana-book-ensures-security) execution is completed atomically.
</Note>

# Functions

Main functions of Silvana Book Agent include:

* Buy Canton Coins;
* Sell Canton Coins;
* Place Order;
* Accept Quote;
* DvP Settlement.

# Capacities

Silvana Book Agent offers a number of powerful features.

<Columns cols={2}>
  <Column>
    <Card title="Orderbook Access" icon="angle-down">
      Submit orders, read market data, and subscribe to orderbook, order, and settlement updates.
    </Card>
  </Column>

  <Column>
    <Card title="RFQ Trading" icon="handshake">
      Agents agree on orders, compute quotes, validate balances, and respond in real time.
    </Card>
  </Column>

  <Column>
    <Card title="DvP Atomic Settlement" icon="atom-simple">
      Settlement occurs simultaneously through a single multicall. Once finished, traders exchange assets.
    </Card>
  </Column>

  <Column>
    <Card title="Grid Market Making" icon="grid">
      Limit orders are placed across configured price levels around the mid price and adjusted accordingly.
    </Card>
  </Column>

  <Column>
    <Card title="Settlement Stream" icon="signal-stream">
      A bidirectional stream handles RFQs, preconfirmations, and settlement lifecycle events.
    </Card>
  </Column>

  <Column>
    <Card title="Local Signing" icon="file-signature">
      Transactions are signed inside the agent, so the private key stays under local control.
    </Card>
  </Column>

  <Column>
    <Card title="Two-Phase Transaction Flow" icon="angles-right">
      Prepared transactions are verified before signing, reducing the risk of unintended execution.
    </Card>
  </Column>

  <Column>
    <Card title="Extensible Libraries" icon="folder-check">
      Core SDK crates can be accessed and reused to build custom agents, tools, or integrations.
    </Card>
  </Column>
</Columns>

# Sources

Here are the sources from which you get the SDK:

| **Crate**         | **Key exports**                                                                                                                                                                                                 |
| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `agent-logic`     | `BaseConfig`, `SettlementBackend` trait, `BalanceProvider` trait, `run_agent()`,<br />`LiquidityManager`, `OrderbookClient`, `OrderbookRpcClient`, `OrderTracker`,<br />`SettlementExecutor`, state persistence |
| `cloud-agent`     | `CloudSettlementBackend` (impls `SettlementBackend`), `DAppProviderClient`,<br />`MulticallSettler`, `RfqHandler`, `PaymentQueue`, `AmuletCache`,<br />`fill_loop::run_fill_loop`, onboarding helpers           |
| `orderbook-proto` | Generated gRPC clients + all protobuf types (`Market`, `Order`,<br />`SettlementProposal`, `TokenBalance`, …) and reflection descriptor pools                                                                   |
| `message-signing` | Canonical Ed25519 signing for `DAppProviderService` RPCs<br />(`sign_canonical`,`verify_canonical`, canonical payload builders per<br />operation type)                                                         |
| `tx-verifier`     | `verify_and_hash()` — independent Canton transaction verification +<br />3-layer SHA-256 hashing before signing                                                                                                 |

<Check>
  Use the guides below to build and run your own agents on Silvana.
</Check>

<CardGroup cols={2}>
  <Card title="Quickstart" href="/sdk/silvana-book-agent-quickstart">
    DvP-native trading agent on the Canton Network.
  </Card>

  <Card title="Agent Sample" href="/sdk/agent-sample">
    Learn how to add your agent (on the Silvana Book Agent sample).
  </Card>
</CardGroup>