# 基本用法

本指南将引导您完成 OCAP Client 的基本入门步骤。您将学习如何初始化客户端、连接到 ArcBlock Beta Chain，并执行基本查询以确保一切设置正确。

遵循本指南，您应该能在几分钟内拥有一个可以与区块链交互的正常工作的客户端实例。


## 1. 初始化客户端

首先，您需要导入 `@ocap/client` 包并创建一个 `GraphQLClient` 实例。构造函数接收您想要连接的区块链节点的 GraphQL 端点。在本指南中，我们将使用 ArcBlock Beta Chain 的公共端点。

```javascript Initialize Client icon=logos:javascript
const GraphQLClient = require('@ocap/client');

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

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

这将创建一个客户端实例，该实例已预先配置了用于查询链、发送交易等方法。


## 2. 查询区块链

客户端初始化后，您可以执行一个简单的只读操作来验证连接。`getChainInfo` 方法非常适合此目的，因为它会获取所连接区块链的基本信息，且无需任何身份验证。

```javascript Query Chain Info 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 Create a Wallet 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 Chain 的免费测试代币（`TBA`）：

<x-card data-title="ArcBlock 水龙头" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="获取测试代币">
  访问水龙头，向您新生成的地址发送一些 TBA 来激活它。
</x-card>


## 4. 查询账户状态

当您使用水龙头为新账户充值后，您可以查询其状态以验证余额。

```javascript Query Account State 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) 以学习如何执行转账代币、管理资产等常见任务。
