ウォレットのネイティブ残高チェック (Check-Native-Balance-in-Wallet)

Tool
ウォレットのネイティブ残高チェック (Check-Native-Balance-in-Wallet)

ウォレットのネイティブ残高チェック (Check-Native-Balance-in-Wallet)

Pythonスクリプトで複数のEVM系ネットワーク（Ethereum、Optimism、Arbitrum、Base、BSC、Polygon）のネイティブ通貨残高をRPC経由で一括チェックするツール。wallet.txtからアドレスを読み込み、proxy.txt（任意）でプロキシを利用可能。ログを出力し、結果をbalances.xlsxに保存するシンプルかつ実用的なユーティリティ。

https://github.com/edotoday/Check-Native-Balance-in-Wallet

概要

本リポジトリは、EVM互換ネットワーク上のウォレットのネイティブ残高（ETH, BNB, MATIC など）をまとめて確認するための Python スクリプト集です。対象ネットワークは Ethereum、Optimism、Arbitrum、Base、BSC、Polygon で、各チェーンの RPC ノードに接続してアドレスごとの残高を取得します。アドレスは wallet.txt から読み込み、プロキシを使いたい場合は proxy.txt を用意するだけで簡単に切り替え可能。実行ログを残し、最終結果は balances.xlsx に保存されるため、監査や一括確認に便利です。

GitHub

リポジトリの統計情報

  • スター数: 17
  • フォーク数: 0
  • ウォッチャー数: 17
  • コミット数: 7
  • ファイル数: 4
  • メインの言語: Python

主な特徴

  • 複数の主要 EVM ネットワークに対応し、各チェーンのネイティブ残高を一括取得できる。
  • wallet.txt でアドレスを管理、proxy.txt（任意）でプロキシ経由の問い合わせに対応。
  • 実行時のログ出力を行い、処理状況やエラーを追跡しやすい設計。
  • 取得結果は balances.xlsx に保存され、Excelでの集計・共有が容易。

技術的なポイント

スクリプトは各チェーンの RPC ノードへ HTTP RPC（JSON-RPC）で照会を行い、eth_getBalance 相当の RPC 呼び出しでアドレスごとのネイティブ残高を取得する設計が想定されます。wallet.txt に記載した複数アドレスを順次読み込んで問い合わせ、応答を受けて最小単位（wei など）から通常単位への変換を行い balances.xlsx に整形して書き出します。proxy.txt の存在により、HTTP プロキシを経由して RPC を呼ぶことが可能で、IP 制限やレート制限への対処がしやすくなっています。ログ出力は処理の可視化と障害時のトラブルシュートに有効で、タイムアウトや接続失敗時のリトライやエラーハンドリングを入れることで頑健性を高められます。スクリプト自体はシンプルで導入障壁が低く、Python 3.7+ を前提に pip で依存を入れて実行するワークフローが README に示されています。将来的な拡張としては、非同期 I/O（asyncio）や並列処理を導入して大量アドレスの高速チェックに対応したり、トークン残高（ERC-20）の取得やチェーンごとのカスタム RPC 管理、Rate Limit 管理・エクスポート形式の多様化（CSV/JSON）などが考えられます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • README.md: file — インストール方法や簡単な使い方が記載されています。
  • main.py: file — 残高チェックのメインスクリプト。wallet.txt/proxy.txt を読み込み、RPC に問い合わせて balances.xlsx を出力します。
  • proxy.txt: file — 任意のプロキシリスト。プロキシを使う場合はここにエントリを追加します。
  • wallet.txt: file — チェック対象のウォレットアドレスを1行ごとに記載します。

ファイル構成は非常にシンプルで、導入と動作確認が容易です。まず Python 3.7+ を用意し、README の手順に沿って依存をインストール、wallet.txt にチェックしたいアドレスを準備し、必要なら proxy.txt にプロキシを記載した上で main.py を実行するだけで結果が balances.xlsx として得られます。ファイルベースの構成は小規模運用やスクリプト実行型の一括チェックに適しています。

使い方と改善提案

基本的な使い方は README に従いますが、実運用では以下の点を検討すると良いでしょう。

  • 大量アドレスを扱う場合は並列化（スレッド/プロセス/asyncio）で高速化する。
  • RPC のレート制限に備えてキューや間引き、バックオフ戦略を実装する。
  • プロキシは信頼できるものを使い、認証や TLS の扱いに注意する。
  • 出力形式に JSON/CSV を追加すれば自動集計や他ツールとの連携が容易になる。
  • トークン残高取得やトランザクション照会を追加すると、より詳細なウォレット監査ツールになる。

注意点

  • スクリプトは公開鍵アドレスのみを扱う想定で、秘密鍵を扱わないため鍵漏洩リスクは低いですが、proxy.txt の内容や出力ファイルの取り扱いには注意してください。
  • 公式 RPC を大量に叩くと利用規約に違反する場合があるため、専用ノードや有料 RPC を利用することを推奨します。

まとめ

シンプルで導入が容易なネイティブ残高一括チェックツール。運用・拡張性も高い。

リポジトリ情報：

READMEの抜粋：

Check-Native-Balance-in-Wallet

Описание

Скрипт на Python предназначен для проверки балансов криптовалютных кошельков в сетях Ethereum, Optimism, Arbitrum, Base, BSC и Polygon. Он использует RPC-ноды для подключения к блокчейнам, поддерживает работу через прокси, логирует процесс и сохраняет результаты в файл balances.xlsx. Адреса кошельков читаются из файла wallet.txt, прокси (опционально) — из файла proxy.txt.

Установка

  1. Установите Python (версия 3.7+).
  2. **Установите з…