# 基本用法

本指南將引導您完成開始使用 OCAP Client 的基本步驟。您將學習如何初始化客戶端、連接到 ArcBlock Beta 鏈，並執行基本查詢以確保一切設定正確。

遵循本指南，您應該能在幾分鐘內擁有一個可運作的客戶端實例，準備好與區塊鏈進行互動。


## 1. 初始化客戶端

首先，您需要匯入 `@ocap/client` 套件並建立一個 `GraphQLClient` 的實例。建構函式需要傳入您想連接的區塊鏈節點的 GraphQL 端點。在本指南中，我們將使用 ArcBlock Beta 鏈的公開端點。

```javascript 初始化客戶端 icon=logos:javascript
const GraphQLClient = require('@ocap/client');

// 連接到 Beta 鏈
const client = new GraphQLClient('https://beta.abtnetwork.io/api');

console.log('OCAP Client initialized!');
```

這會建立一個客戶端實例，該實例已預先配置了查詢鏈、發送交易等方法。


## 2. 查詢區塊鏈

既然客戶端已初始化，您可以執行一個簡單的唯讀操作來驗證連接。`getChainInfo` 方法非常適合此用途，因為它會擷取有關所連接區塊鏈的基本資訊，且不需要任何身份驗證。

```javascript 查詢鏈資訊 icon=logos:javascript
(async () => {
  try {
    const { info } = await client.getChainInfo();
    console.log('Chain Info:', info);
  } catch (error) {
    console.error('Failed to get chain info:', error);
  }
})();
```

如果請求成功，`info` 物件將會被記錄到主控台，其中包含鏈的詳細資訊，例如其 ID、網路和支援的交易類型。這確認了您的客戶端已成功與區塊鏈節點通訊。


## 3. 準備帳戶

要發送交易（寫入操作），您需要一個錢包。您可以在本地產生一個新錢包。這個錢包代表您在鏈上的帳戶身份。

```javascript 建立錢包 icon=logos:javascript
const { fromRandom } = require('@ocap/wallet');

// 建立一個新的隨機錢包
const wallet = fromRandom();

console.log('New wallet created:');
console.log('Address:', wallet.address);
console.log('PublicKey:', wallet.publicKey);
console.log('SecretKey:', wallet.secretKey);
```

**重要提示：** 新產生的錢包只是一個金鑰對。它尚未存在於區塊鏈上。當其地址收到第一筆傳入交易時，帳戶將在鏈上自動建立。

為了讓您的新帳戶生效，您需要用一些測試代幣為其注資。您可以從官方水龍頭獲取 Beta 鏈的免費測試代幣（`TBA`）：

<x-card data-title="ArcBlock 水龍頭" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="獲取測試代幣">
  訪問水龍頭並發送一些 TBA 到您新產生的地址以啟動它。
</x-card>


## 4. 查詢帳戶狀態

一旦您使用水龍頭為您的新帳戶注資後，您可以查詢其狀態以驗證餘額。

```javascript 查詢帳戶狀態 icon=logos:javascript
(async () => {
  try {
    // 請替換為您從水龍頭注資的地址
    const address = wallet.address;

    const { state } = await client.getAccountState({ address });
    console.log('Account State:', state);
  } catch (error) {
    console.error('Failed to get account state:', error);
  }
})();
```

`state` 物件在回應中將包含您帳戶的地址、餘額、nonce（已發送的交易數量）以及其他詳細資訊。看到非零餘額即確認您的帳戶已從水龍頭收到代幣，並已在區塊鏈上啟用。


## 後續步驟

您已成功設定 OCAP Client、連接到區塊鏈並驗證了您的帳戶。現在，您已準備好探索更進階的操作。

查看 [操作指南](./how-to-guides.md) 以學習如何執行常見任務，例如轉移代幣、管理資產等。