GET STARTED
最初のAPIリクエスト
公開APIから登録済みトークンの一覧を取得します。SDKのインストールからAPIへの接続、レスポンスの読み方、エラーへの対応までを紹介します。
01環境を準備
02SDKを入れる
03APIを呼ぶ
04結果を確かめる
1. 実行環境を準備する
この手順はNode.js 22を使います。ターミナルでバージョンを確認し、新しいディレクトリを作成してください。APIの利用先は既定の https://api.hazbase.com です。
Terminal
node --version
npm --version
mkdir hazbase-day1
cd hazbase-day1
npm init -y
npm pkg set type=module
npm install --save-exact @hazbase/kit@0.9.0TypeScriptの設定やtsxの追加は不要です。まずJavaScriptで接続を確認し、その後で必要に応じてTypeScriptやReactへ展開できます。
2. 最初のリクエストを実行する
次のコードを index.mjs として保存し、実行します。chainId=11155111はSepoliaを指定します。取得する一覧は、その環境に登録されたトークンです。チェーン全体のトークン検索ではありません。
index.mjs
import { createHazbaseWalletClient, HazbaseWalletApiError } from "@hazbase/kit/wallet";
// Read-only: no private key, signature, transfer, or transaction is used.
const apiEndpoint = process.env.HAZBASE_API_ENDPOINT || "https://api.hazbase.com";
const chainId = Number(process.env.CHAIN_ID || "11155111");
if (!Number.isSafeInteger(chainId) || chainId <= 0)
throw new Error("CHAIN_ID must be a positive integer.");
const wallet = createHazbaseWalletClient({
apiEndpoint,
fetcher: (url, options) => {
const headers = new Headers(options?.headers);
if (process.env.HAZBASE_API_KEY) headers.set("X-Hazbase-Api-Key", process.env.HAZBASE_API_KEY);
return fetch(url, { ...options, headers, signal: AbortSignal.timeout(15000) });
},
});
try {
const result = await wallet.listTokens({ chainId });
console.log("Connected to:", apiEndpoint);
console.log("Chain ID:", chainId);
console.log("Tokens returned:", result.tokens.length);
console.table(
result.tokens.map(({ name, symbol, standard, decimals, transferable }) => ({
name,
symbol,
standard,
decimals,
transferable,
})),
);
if (result.tokens.length === 0)
console.log("Connection succeeded. No tokens are configured for this chain.");
} catch (error) {
if (error instanceof HazbaseWalletApiError) {
console.error("HTTP status:", error.status, "Code:", error.code ?? "not provided");
}
console.error(error instanceof Error ? error.message : String(error));
process.exitCode = 1;
}
Terminal
node index.mjs3. 成功したことを確認する
「Connected to」「Chain ID」「Tokens returned」が表示され、取得したトークンが表で出力されれば成功です。件数と名称は環境の登録内容によって変わります。0件でもAPIへの接続は成功しています。
応答構造の例(0件の場合)
{
"tokens": []
}tokensにはname、symbol、address、standard、decimals、transferableなどが含まれます。返却項目と型はHTTP APIリファレンスで確認できます。
GET /api/wallet/tokensSDKを使わずHTTPで確認する
同じ読み取りはcurlでも実行できます。このリクエストにはAuthorizationヘッダーや秘密鍵を付けません。
bash
curl --fail-with-body --max-time 15 \
"https://api.hazbase.com/api/wallet/tokens?chainId=11155111" \
-H "Accept: application/json"次に進む
ここまででSDKから実APIへの接続を確認できました。発行・移転を行う場合には、利用する環境、権限、コントラクトやウォレットの準備を次のガイドで確認してください。