基本的な使い方

このガイドでは、OCAP Clientを使い始めるための基本的な手順を説明します。クライアントの初期化、ArcBlockベータチェーンへの接続、そしてすべてが正しく設定されていることを確認するための基本的なクエリの実行方法を学びます。

このガイドに従うことで、わずか数分でブロックチェーンとやり取りできる、動作可能なクライアントインスタンスを準備できます。

1. クライアントの初期化

まず、@ocap/clientパッケージをインポートし、GraphQLClientのインスタンスを作成する必要があります。コンストラクタは、接続したいブロックチェーンノードのGraphQLエンドポイントを引数に取ります。このガイドでは、ArcBlockベータチェーンの公開エンドポイントを使用します。

Initialize Client

const GraphQLClient = require('@ocap/client');

// ベータチェーンに接続
const client = new GraphQLClient('https://beta.abtnetwork.io/api');

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

これにより、チェーンへのクエリ、トランザクションの送信などのメソッドが事前設定されたクライアントインスタンスが作成されます。

2. ブロックチェーンへのクエリ

クライアントが初期化されたので、簡単な読み取り専用操作を実行して接続を確認できます。getChainInfoメソッドは、接続されたブロックチェーンに関する基本情報を取得し、認証を必要としないため、この目的に最適です。

Query Chain Info

(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. アカウントの準備

トランザクション（書き込み操作）を送信するには、ウォレットが必要です。新しいウォレットはローカルで生成できます。このウォレットは、あなたのオンチェーンアカウントのアイデンティティを表します。

Create a Wallet

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);

重要： 新しく生成されたウォレットは、単なるキーペアです。まだブロックチェーン上には存在しません。アカウントは、そのアドレスが最初の受信トランザクションを受け取ったときに、オンチェーンで自動的に作成されます。

新しいアカウントを有効にするには、テストトークンで資金を供給する必要があります。ベータチェーン用の無料テストトークン（TBA）は、公式フォーセットから入手できます：

4. アカウント状態のクエリ

フォーセットを使用して新しいアカウントに資金を供給したら、その状態をクエリして残高を確認できます。

Query Account State

(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のセットアップ、ブロックチェーンへの接続、アカウントの確認が正常に完了しました。より高度な操作を探求する準備が整いました。

トークンの転送、アセットの管理などの一般的なタスクを実行する方法については、ハウツーガイドをご覧ください。