viem統合

TypeScript/JavaScriptアプリケーション用のviemを使用してEVMブロックチェーンを統合します。

クイック決定ガイド

構築内容	使用するもの
Node.jsスクリプト/バックエンド	httpトランスポート付きviem
React/Next.jsフロントエンド	wagmiフック（viemをベースに構築）
リアルタイムイベント監視	webSocketトランスポート付きviem
ブラウザウォレット統合	wagmiまたはviemカスタムトランスポート

インストール

# コアライブラリ
npm install viem

# Reactアプリの場合、wagmiもインストール
npm install wagmi viem @tanstack/react-query

コアコンセプト

クライアント

viemは2つのクライアントタイプを使用します：

クライアント	目的	使用例
PublicClient	読み取り専用操作	残高取得、コントラクト読み取り、ログ取得
WalletClient	書き込み操作	トランザクション送信、メッセージ署名

トランスポート

トランスポート	ユースケース
http()	標準RPC呼び出し（最も一般的）
webSocket()	リアルタイムイベント購読
custom()	ブラウザウォレット（window.ethereum）

チェーン

viemには50以上のチェーン定義が含まれています。viem/chainsからインポートします：

import { mainnet, arbitrum, optimism, base, polygon } from 'viem/chains';

---

入力検証ルール

生成されたTypeScriptコードにユーザー提供の値を挿入する前に：

• Ethereumアドレス：^0x[a-fA-F0-9]{40}$と一致する必要があります。検証にはviemのisAddress()を使用してください
• チェーンID：viemでサポートされているチェーン定義から取得する必要があります
• 秘密鍵：絶対にハードコーディングしてはいけません。常にprocess.env.PRIVATE_KEYをランタイム検証と共に使用してください
• RPC URL：https://またはwss://プロトコルのみを使用する必要があります
• ABI入力：エンコード前に型が期待されるSolidityタイプと一致することを検証してください

クイックスタート例

残高を読み取る

import { createPublicClient, http, formatEther } from 'viem';
import { mainnet } from 'viem/chains';

const client = createPublicClient({
  chain: mainnet,
  transport: http(),
});

const balance = await client.getBalance({
  address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
});

console.log(`Balance: ${formatEther(balance)} ETH`);

コントラクトを読み取る

import { createPublicClient, http, parseAbi } from 'viem';
import { mainnet } from 'viem/chains';

const client = createPublicClient({
  chain: mainnet,
  transport: http(),
});

const abi = parseAbi([
  'function balanceOf(address) view returns (uint256)',
  'function decimals() view returns (uint8)',
]);

const balance = await client.readContract({
  address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  abi,
  functionName: 'balanceOf',
  args: ['0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'],
});

トランザクションを送信する

import { createWalletClient, http, parseEther } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { mainnet } from 'viem/chains';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);

const client = createWalletClient({
  account,
  chain: mainnet,
  transport: http(),
});

const hash = await client.sendTransaction({
  to: '0x...',
  value: parseEther('0.1'),
});

console.log(`Transaction hash: ${hash}`);

コントラクトに書き込む

import { createWalletClient, createPublicClient, http, parseAbi, parseUnits } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { mainnet } from 'viem/chains';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);

const walletClient = createWalletClient({
  account,
  chain: mainnet,
  transport: http(),
});

const publicClient = createPublicClient({
  chain: mainnet,
  transport: http(),
});

const abi = parseAbi(['function transfer(address to, uint256 amount) returns (bool)']);

// エラーをキャッチするために先にシミュレート
const { request } = await publicClient.simulateContract({
  address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  abi,
  functionName: 'transfer',
  args: ['0x...', parseUnits('100', 6)],
  account,
});

// トランザクションを実行
const hash = await walletClient.writeContract(request);

// 確認を待つ
const receipt = await publicClient.waitForTransactionReceipt({ hash });
console.log(`Confirmed in block ${receipt.blockNumber}`);

---

リファレンスドキュメント

特定トピックの詳細情報は以下を参照してください：

トピック	リファレンスファイル
クライアントセットアップ、トランスポート、チェーン	Clients & Transports
ブロックチェーンデータの読み取り	Reading Data
トランザクションの送信	Writing Transactions
秘密鍵、HDウォレット	Accounts & Keys
ABI処理、マルチコール	Contract Patterns
React/wagmiフック	Wagmi React

---

関連プラグイン

viemの基本に慣れたら、uniswap-tradingプラグインは包括的なUniswapスワップ統合を提供します：

• Uniswap Trading API統合
• Universal Router SDK使用
• トークンスワップ実装

インストールコマンド：claude plugin add @uniswap/uniswap-trading

---

一般的なユーティリティ

ユニット変換

import { parseEther, formatEther, parseUnits, formatUnits } from 'viem';

// ETH
parseEther('1.5'); // 1500000000000000000n (wei)
formatEther(1500000000000000000n); // "1.5"

// トークン（例：6小数点のUSDC）
parseUnits('100', 6); // 100000000n
formatUnits(100000000n, 6); // "100"

アドレスユーティリティ

import { getAddress, isAddress } from 'viem';

isAddress('0x...'); // true/false
getAddress('0x...'); // チェックサム済みアドレス

ハッシング

import { keccak256, toHex } from 'viem';

keccak256(toHex('hello')); // 0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8

---

エラーハンドリング

viemは型付きエラーをスローするため、これらをキャッチして処理できます：

import { ContractFunctionExecutionError, InsufficientFundsError } from 'viem'

try {
  await client.writeContract(...)
} catch (error) {
  if (error instanceof ContractFunctionExecutionError) {
    console.error('Contract call failed:', error.shortMessage)
  }
  if (error instanceof InsufficientFundsError) {
    console.error('Not enough ETH for gas')
  }
}

---

リソース

• viemドキュメント
• wagmiドキュメント
• viem GitHub
• wagmi GitHub