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

# Getting Started

> Programmatic access to the Canton Network through the Modo Ledger gRPC service

The **Modo Ledger** service exposes a **gRPC** interface for agents and backend applications that need to transact on the Canton Network.

Follow on to start using the **Agentic API**.

<Card title="Proto definitions" icon="github" href="https://github.com/SilvanaOne/silvana-book-agent/tree/proto/proto/silvana/ledger/v1">
  Canonical `.proto` files for `silvana.ledger.v1` — service, enum, and message definitions.
</Card>

## Endpoint

<CodeGroup>
  ```bash DevNet theme={null}
  rpc-devnet.modo-api.app:443
  ```
</CodeGroup>

## Services

The package `silvana.ledger.v1` exposes two services:

<CardGroup cols={2}>
  <Card title="DAppProviderService" icon="server">
    Main service for agentic operations: queries, transaction preparation and execution, onboarding.
  </Card>

  <Card title="DAppBridgeService" icon="link">
    Bridge operations between networks.
  </Card>
</CardGroup>

## Reflection

The server supports gRPC reflection, so you can introspect the schema with any reflection-aware client (grpcurl, Postman, BloomRPC):

```bash theme={null}
grpcurl rpc-devnet.modo-api.app:443 list
grpcurl rpc-devnet.modo-api.app:443 list silvana.ledger.v1.DAppProviderService
grpcurl rpc-devnet.modo-api.app:443 describe silvana.ledger.v1.DAppProviderService
```

## Functional groups

Operations are organised into **functional groups**. Each group can be enabled or disabled independently on the server — disabled groups respond with `UNIMPLEMENTED`. The `core` group is always enabled.

| Group          | Methods                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `core`         | Read-only queries — always available ([GetServiceInfo](/agentic-api/core/get-service-info), [GetLedgerEnd](/agentic-api/core/get-ledger-end), [GetDsoRates](/agentic-api/core/get-dso-rates), [GetBalances](/agentic-api/core/get-balances), [GetAmulets](/agentic-api/core/get-amulets), [GetActiveContracts](/agentic-api/core/get-active-contracts), [GetUpdates](/agentic-api/core/get-updates)) |
| `transfer`     | [TransferCc](/agentic-api/transfer/transfer-cc), [SplitCc](/agentic-api/transfer/split-cc)                                                                                                                                                                                                                                                                                                           |
| `preapproval`  | [GetPreapprovals](/agentic-api/preapproval/get-preapprovals), [RequestPreapproval](/agentic-api/preapproval/request-preapproval)                                                                                                                                                                                                                                                                     |
| `dvp`          | [GetSettlementContracts](/agentic-api/dvp/get-settlement-contracts), [PayDvpFee](/agentic-api/dvp/pay-dvp-fee), [ProposeDvp](/agentic-api/dvp/propose-dvp), [AcceptDvp](/agentic-api/dvp/accept-dvp), [PayAllocFee](/agentic-api/dvp/pay-alloc-fee), [Allocate](/agentic-api/dvp/allocate)                                                                                                           |
| `cip56`        | [TransferCip56](/agentic-api/cip56/transfer-cip56), [AcceptCip56](/agentic-api/cip56/accept-cip56)                                                                                                                                                                                                                                                                                                   |
| `recurring`    | [RequestRecurringPrepaid](/agentic-api/recurring/request-recurring-prepaid), [RequestRecurringPayasyougo](/agentic-api/recurring/request-recurring-payasyougo)                                                                                                                                                                                                                                       |
| `onboarding`   | [GetAgentConfig](/agentic-api/onboarding/get-agent-config), [RegisterAgent](/agentic-api/onboarding/register-agent), [GetOnboardingStatus](/agentic-api/onboarding/get-onboarding-status), [SubmitOnboardingSignature](/agentic-api/onboarding/submit-onboarding-signature)                                                                                                                          |
| `multicall`    | [ExecuteMultiCall](/agentic-api/multicall/execute-multicall)                                                                                                                                                                                                                                                                                                                                         |
| `user_service` | [RequestUserService](/agentic-api/user-service/request-user-service)                                                                                                                                                                                                                                                                                                                                 |

<Note>
  Check which operations are supported on a specific server by calling [`GetServiceInfo`](/agentic-api/core/get-service-info). The response includes a `supported_operations` list of [`TransactionOperation`](/agentic-api/transaction-flow#transactionoperation) enum values.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/agentic-api/authentication">
    How Ed25519 request signing works and which methods require it.
  </Card>

  <Card title="Transaction flow" icon="arrows-rotate" href="/agentic-api/transaction-flow">
    The full two-phase prepare → sign → execute model with enum and oneof references.
  </Card>

  <Card title="Onboarding" icon="user-plus" href="/agentic-api/onboarding/get-agent-config">
    Register a new agent and obtain a Canton party.
  </Card>

  <Card title="GetServiceInfo" icon="circle-info" href="/agentic-api/core/get-service-info">
    Discover which functional groups are enabled on a specific server.
  </Card>
</CardGroup>