# 概述

OCAP Client 是一个功能强大且通用的 JavaScript 库，旨在将您的应用程序连接到由 OCAP 驱动的区块链。它提供了一个精简、对开发者友好的界面，用于读取和写入数据、管理数字资产以及监听链上事件。该客户端可用于任何 Node.js 或基于浏览器的环境，为后端服务和前端应用程序提供统一的解决方案。

该客户端的核心功能是通过抽象交易编码和签名的复杂性来简化区块链交互。它使用 GraphQL API 通过 HTTP/S 与区块链节点进行所有通信，使得查询链上数据和提交交易变得简单。

<!-- DIAGRAM_IMAGE_START:architecture:4:3 -->

![Overview](assets/diagram/overview-01.jpg)

<!-- DIAGRAM_IMAGE_END -->

### 主要功能

OCAP Client 分为几个不同的方法组，以处理区块链通信的不同方面：

<x-cards data-columns="2">
  <x-card data-title="查询" data-icon="lucide:search">
    从区块链读取任何数据，包括区块、交易、账户状态、资产详情和常规链信息。
  </x-card>
  <x-card data-title="变更与发送器" data-icon="lucide:send">
    向区块链写入数据。使用 `transfer` 或 `createAsset` 等高阶辅助方法可轻松准备、签名和发送交易。
  </x-card>
  <x-card data-title="订阅" data-icon="lucide:radio-tower">
    监听实时链上事件。通过 WebSocket 连接订阅主题并接收实时更新。
  </x-card>
  <x-card data-title="编码器与签名器" data-icon="lucide:edit">
    对于高级用例，您可以手动编码和签名交易，从而完全控制交易的生命周期。
  </x-card>
</x-cards>

### 重要概念

* **自动创建账户**：在由 OCAP 驱动的链上，当一个新账户收到第一笔入账交易（例如，接收通证）时，它会自动在链上创建。你无需通过单独的交易来初始化账户。

* **无 Gas 费交易**：该客户端支持一种 Gas 费支付机制，即由指定的“Gas 费支付方”钱包为其他用户赞助交易费用。这使您能够为应用程序的用户创建无缝、免 Gas 费的体验。

### 下一步

准备好开始构建了吗？以下是一些有用的链接，可以帮助您快速入门：

<x-cards data-columns="3">
  <x-card data-title="入门指南" data-icon="lucide:rocket" data-href="/getting-started">
    安装客户端，连接到 Beta 链，并在 30 分钟内完成您的第一次查询。
  </x-card>
  <x-card data-title="操作指南" data-icon="lucide:book-open" data-href="/how-to-guides">
    遵循分步教程，完成创建 NFT、转移通证和质押等常见任务。
  </x-card>
  <x-card data-title="API 参考" data-icon="lucide:code" data-href="/api-reference">
    深入了解完整的 API 文档，获取有关每个方法、参数和数据类型的详细信息。
  </x-card>
</x-cards>
