# gRPC Services

This page describes the gRPC surface exposed by `antd` on `localhost:50051` by default.

Unlike the REST API, the gRPC API carries raw bytes in protobuf fields rather than base64 strings in JSON.

## Health Service

### Check

**Signature:** `Check(HealthCheckRequest) -> HealthCheckResponse`

Checks daemon health and network selection.

**Response fields:**

| Name                    | Type   | Description                                                                    |
| ----------------------- | ------ | ------------------------------------------------------------------------------ |
| `status`                | string | Expected `ok` on success                                                       |
| `network`               | string | Network name: `default`, `local`, or `alpha`                                   |
| `version`               | string | antd crate version (e.g. `0.4.0`)                                              |
| `evm_network`           | string | EVM preset: `arbitrum-one`, `arbitrum-sepolia`, `local`, or `custom`           |
| `uptime_seconds`        | uint64 | Seconds since the daemon process started                                       |
| `build_commit`          | string | Short git SHA captured at build time, or empty if built outside a git checkout |
| `payment_token_address` | string | Payment token contract address, or empty if unconfigured                       |
| `payment_vault_address` | string | Payment vault contract address, or empty if unconfigured                       |

## Data Service

### Get Public

**Signature:** `GetPublic(GetPublicDataRequest) -> GetPublicDataResponse`

Fetches public data by address.

### Put Public

**Signature:** `PutPublic(PutPublicDataRequest) -> PutPublicDataResponse`

Stores public data.

### Stream Public

**Signature:** `StreamPublic(StreamPublicDataRequest) -> stream DataChunk`

This RPC is exposed, but the handler returns `UNIMPLEMENTED`.

### Get Private

**Signature:** `GetPrivate(GetPrivateDataRequest) -> GetPrivateDataResponse`

Fetches private data using a `data_map` string.

### Put Private

**Signature:** `PutPrivate(PutPrivateDataRequest) -> PutPrivateDataResponse`

Stores private data and returns a `data_map` string.

### Get Cost

**Signature:** `GetCost(DataCostRequest) -> Cost`

Estimates storage cost for a byte payload.

## Chunk Service

### Get

**Signature:** `Get(GetChunkRequest) -> GetChunkResponse`

Fetches a chunk by address.

### Put

**Signature:** `Put(PutChunkRequest) -> PutChunkResponse`

Stores a raw chunk.

## File Service

### Upload Public

**Signature:** `UploadPublic(UploadFileRequest) -> UploadPublicResponse`

Uploads a local file path.

`UploadPublicResponse` returns `address`, `storage_cost_atto`, `gas_cost_wei`, `chunks_stored`, and `payment_mode_used`.

### Download Public

**Signature:** `DownloadPublic(DownloadPublicRequest) -> DownloadResponse`

Downloads a public file to a local destination path.

### Get File Cost

**Signature:** `GetFileCost(FileCostRequest) -> Cost`

Estimates file upload cost.

## Event Service

### Subscribe

**Signature:** `Subscribe(SubscribeRequest) -> stream ClientEventProto`

This RPC is exposed, but the stream stays open without emitting events.

`ClientEventProto` includes:

| Name                   | Type   | Description                    |
| ---------------------- | ------ | ------------------------------ |
| `kind`                 | string | Event kind                     |
| `records_paid`         | uint64 | Number of paid records         |
| `records_already_paid` | uint64 | Number of already-paid records |
| `tokens_spent`         | string | Tokens spent                   |

## Common messages

The proto files define these shared shapes:

| Message                  | Fields                                                                                                                            |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `Cost`                   | `atto_tokens`                                                                                                                     |
| `HealthCheckResponse`    | `status`, `network`, `version`, `evm_network`, `uptime_seconds`, `build_commit`, `payment_token_address`, `payment_vault_address` |
| `PutPublicDataResponse`  | `cost`, `address`                                                                                                                 |
| `PutPrivateDataResponse` | `cost`, `data_map`                                                                                                                |
| `UploadPublicResponse`   | `address`, `storage_cost_atto`, `gas_cost_wei`, `chunks_stored`, `payment_mode_used`                                              |

## Related pages

* [REST API](/developers/sdk/install/reference/rest-api.md)
* [SDK Overview](/developers/sdk/install/reference/overview.md)
* [How Language Bindings Work](/developers/sdk/install/reference/language-bindings/overview.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autonomi.com/developers/sdk/install/reference/grpc-services.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.