# 概覽

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>
