ウォレット追跡の取引ボットは、口座の活動を観測し、有用な情報へ変えようとします。最も重要な仕事は、意味を解釈することです。アドレスへトークンが届いても、必ずしも購入ではありません。トークンが出ていっても、必ずしも売却ではありません。残高が増えても、必ずしも利益ではありません。こうした区別によって、作られた通知や保有記録が、利用者の考える意味を本当に持つかが決まります。

追跡機能は、調査、監視、または別の取引戦略を支える場合があります。どの場合も、観測した事実と、そこから推定した経済的な操作を、記録で区別するべきです。このガイドでは、架空のトランザクションと残高を使い、欠けた履歴を作り上げず、また、すべての動きを売買指示と扱わずに、活動を再構成する方法を説明します。

ウォレット追跡の取引ボットで観測対象を定める

まず、ネットワークと口座の識別情報を確かめます。アドレスの文字列だけでは、環境をまたぐと曖昧になる場合があります。また、見えている一つの口座が、ある主体の制御するすべての資源を表すとは限りません。完全な財務の全体像を示しているかのようにせず、追跡機能が観測する範囲を述べるべきです。

ネットワークによっては、トークンの保有に、単純なネイティブ資産の残高だけでなく、追加の口座やコントラクトの記録が関係します。実装は、関係する口座の仕組みと、対応するトークンプログラムや規格を理解しなければなりません。すべての資産が同じ形で保存、報告されると仮定した汎用のアドレス監視では、重要な活動を見落とす場合があります。

Solanaのコピー取引ガイドでは、観測の後に別の取引判断が必要な理由を扱っています。コピーを予定していなくても、同じ原則が当てはまります。追跡機能は、誰のチェーン上の記録を点検できるか、その記録のどの部分が対象範囲外なのかを確認するべきです。

元のイベントと解釈を別々に保存する

経済的な意味を表すラベルを加える前に、元のイベントへの参照と、関係するデータを保存します。移転のログ、命令、残高の変化は証拠です。「購入した」「売却した」「自己の口座間で移した」といったラベルは、その証拠と周囲の文脈に基づく解釈です。

両方の層を残せば、後で読み取り処理を改善したときにも、元の記録を失わず、解釈を修正できます。また、意見の違いも確認できます。売却とされたものが保管先の移動だと利用者が考えるなら、追跡機能は、そのラベルを作ったトランザクションの文脈を示せます。

ウォレットのトランザクションを分類するときは、未解決という分類を含めるべきです。すべてのイベントを購入か売却に分類しなければならない仕組みでは、対応していない経路や不完全なデータに遭遇すると、確信を持って誤った答えを出します。正直に不明だと示すほうが、推測から作った精密そうな保有履歴より役立ちます。

ウォレットの活動をコピーするガイドでは、イベントの分類が未解決であることと、追随者の資本を拘束する判断を、別々に扱う方法を示しています。

トランザクションの全体を読む

一つのトランザクションには、複数の操作が含まれる場合があります。ある要素は入力資産を移し、別の要素は出力を返し、さらに別の要素は手数料や口座の準備を処理するかもしれません。一つの要素だけを切り離して解釈すると、見かけの方向を逆にしたり、実際の経済的な交換を見落としたりする場合があります。

Solanaの公式なトランザクションの概要では、トランザクションが一つ以上の命令を含むと説明しています。Ethereumのトークンの活動も、見慣れたイベント名以上の文脈が必要です。市場での操作を割り当てる前に、同じトランザクション内の関連する変化をつなげることが重要です。

架空のスワップで、追跡する口座が一つの資産を支出し、複数の中間段階を経て別の資産を受け取るとします。保有記録は、見直しに必要な経路の詳細を残しながら、その口座に帰属する、経済的な入力と出力の正味の変化を記録するべきです。途中の移動を、それぞれウォレット所有者の独立した取引として数えるべきではありません。

スマートマネーの証拠を調べる手順では、トランザクションの分類が成績全体の分析へどう影響するかを示しています。また、移転された在庫を、架空の低原価の購入にしてしまうことを防ぐ方法も示しています。

移転イベントから実際に分かることを理解する

ERC-20規格は、トークンの移動の動作の一部として、移転イベントを定義しています。この種類のイベントは、それ自体では、市場価格で購入が行われたとは述べていません。多くの異なる経済的な活動に伴う場合があります。

入ってくる移動は、贈与、配布、内部移転、スワップの出力かもしれません。出ていく移動は、支払い、保管先の変更、交換への入力かもしれません。どちらについても、取得原価や実現した売却代金へ変換する前に、追加の証拠が必要です。

この規格では、値がゼロの移転も表せます。そのため、イベントの件数そのものにも解釈が必要です。移転イベントが多いからといって、経済的に意味のある売買が多いとは限りません。追跡機能は数量や金額と文脈を残し、イベントが存在することだけを、コピーする価値のある活動の十分な証拠として扱わないようにするべきです。

大きな移転も、方向性を持つ売買ではなく、保管の管理かもしれません。大口ウォレット追跡ボットのガイドでは、行動につながる通知を出す前に、イベントを分類する方法を説明しています。

資産の正規の識別子を使う

同じ記号が、互いに無関係なトークンを指す場合があります。残高の変化ごとに、ネットワークとトークンの正規の識別子を保存し、名前や記号は表示用のメタデータとしてだけ使います。任意のメタデータや欠けたメタデータによって、資産を統合したり、識別子を作り上げたりしてはいけません。

トークンの小数桁数は、人が読める数量に影響します。しかし、元の数量のデータも使える形で残すべきです。小数桁数の仮定を誤ると、小さな移動が非常に大きな売買のように見える場合があります。メタデータを信頼できる形で確認できなければ、確信のある価値を計算するのではなく、不確かさを表示します。

ERC-20のミームコイン取引の記事では、この会計上の区別を詳しく説明しています。追跡機能にとって、資産の識別と単位は、その後のすべての前提です。分類、保有の規模、原価の履歴、活動から作るあらゆる通知が、それらに依存します。

残高の状態とトランザクション履歴を区別する

現在の残高から分かるのは、観測した特定の状態で、口座が何を保有しているかです。取得の方法や、支払った費用までは説明しません。トランザクションの履歴は、その説明となる可能性がありますが、履歴は不完全かもしれません。

架空のウォレットが現在50,000単位を保有し、利用できる履歴は10,000単位の売却から始まるとします。その売却から、元の在庫の取得原価を推定することはできません。開始時の残高や、不明な過去の保有分があると認識し、口座の全期間を通じた完全な利益を表示しないようにするべきです。

そのため、ミームコインのウォレットの保有分を追跡するには、対象範囲の境界が必要です。最も早く信頼できる観測を述べ、取得履歴が完全な保有分と、追跡開始時に既に存在していた保有分を分けます。この境界によって、短い監視期間が、口座の履歴全体であるかのように見えることを防げます。

同じ対象範囲の問題は、Polymarketのコピー取引にもあります。分割、統合、償還が変化の理由となる場合があり、残高だけを見ていると、それらを誤って分類してしまいます。

ネイティブ資産とトークンの変化を一緒に照合する

スワップで経済的に支出する資産は、ネットワークのネイティブ資産、ラップされた表現、別のトークンの場合があります。トランザクションの手数料や、口座に関係する移動も、ネイティブ資産の残高を変える場合があります。残高の減少全体を購入原価と扱うと、取引と運用費用の両方を誤って示す場合があります。

交換した資産と、手数料や、その他の識別できる資源の移動を分けます。利用できるデータで分けられないなら、合計の変化と、未解決の要素を示します。すべての差をトークンの取得原価に押し込むより、分かる範囲を限定した会計結果を報告するほうが適切です。

架空のトランザクションで、ネイティブ資産の残高が1.02単位減り、交換への入力は1.00、残る0.02は、記録された費用や、根拠を示せる別の調整を表すとします。説明なしに1.02でトークンを購入したと述べるのではなく、この区別を残すべきです。

所有者を断定せずに内部移転を識別する

関連するアドレス間の移転では、経済的な所有者が変わらない場合があります。ただし、その関係が公開情報から確認できるとは限りません。追跡機能は、利用者自身の分かっているウォレットをまとめる、利用者定義の口座グループを用意できます。また、外部の調査のためには、誰に属するかが不確かだと明示したグループを用意できます。

本人のものと確認したグループ内で、あるアドレスから別のアドレスへ資産を移しても、売却と、原価ゼロの新しい取得を作るべきではありません。これは、費用が生じる可能性のある内部移転です。関係のないアドレスや、関係が不確かなアドレスについては、移転があったというだけで、所有者が共通だと仮定しないようにするべきです。

この区別は、成績の計算やシグナルの生成に重要です。そうしなければ、保管先を整理しているウォレットが、すべての保有分を処分しているように見え、誤った売り通知を出すかもしれません。正しい分類は、トークンの移動の方向だけでなく、アドレスの関係とトランザクションについての証拠に依存します。

自分が制御することの分かっている口座のグループについては、複数ウォレットの会計ガイドが、売買利益を作り上げずに、内部移転、移動の途中の状態、トランザクション費用を照合する方法を示しています。

流動性の提供や引揚げを独自の分類で扱う

流動性の提供や引揚げでは、複数の資産が動き、流動性の持分を表すものが作られたり、償還されたりする場合があります。関係するすべての資産について、方向性を持つ購入や売却へ自動的に分類するべきではありません。負う経済的なリスクは、通常の現物保有より複雑な場合があります。

その活動に対応する追跡機能なら、関係する保有の仕組みを識別し、拘束した資産や受け取った資産を記録するべきです。対応していなければ、そのトランザクションを未対応、または見直しが必要だと表示します。誤解を招く単純なラベルは、保有履歴と、そこから派生する戦略のシグナルを壊す場合があります。

架空の流動性の引揚げでは、その時点で新たな購入代金を払わずに、口座が二つのトークンを受け取る場合があります。両方の受取りを、原価ゼロの新しい購入として扱うと、後の利益計算が歪みます。経済的な意味を解釈するには、元の流動性の提供と、その間の活動が重要です。

支出の承認を購入として扱わない

別のコントラクトや口座に資産の支出を認めることは、それ自体では、交換が完了したということではありません。追跡機能は、許可の変更と資産の移動を区別するべきです。この区別は、取引の活動と、口座が与えた権限の両方を利用者が理解する助けになります。

許可のイベントは、残高が変わらなくても、運用上の通知に関係する場合があります。後の操作が可能になったことを示し得ますが、その操作が行われると確認できるわけではありません。承認だけに基づく取引シグナルは、意図について推測していることになります。

許可についての観測は、資産、権限を与えられた相手、分かっている範囲を含む、適切な記録に残します。想像上の保有分を加えてはいけません。また、実現した結果を作ってもいけません。操作を可能にすること、操作を試みること、その結果の経済的な変化を観測することを区別して説明すると、追跡機能はより有用になります。

失敗したトランザクションや不完全な記録も会計処理する

送信したトランザクションは、失敗する場合があります。また、要求した観測状態では、まだ取得できない場合もあります。試みた命令だけから、資産の交換が成功したと推定するべきではありません。関係する実行結果と、その結果の状態が必要です。

SolanaのgetTransactionの文書では、指定した確認水準でトランザクションが見つからない場合、結果がnullになると説明しています。そのため、nullは観測上の状態であり、口座が何をしたかについての完全な経済的な結論ではありません。すぐに失敗した取引を作り上げるのではなく、対応するデータの仕組みに従って復旧するべきです。

取り込まれたものの失敗したトランザクションで手数料が生じた場合は、取得するつもりだった在庫を記録せず、費用を記録します。これにより、成功しなかった活動と、活動がなかったことを区別できます。ウォレットは、トークンの保有分が変わらないまま、試行に資源を使う場合があります。

ウォレット追跡の取引ボットで架空の一連の活動を再構成する

ウォレットが、取得原価の分からないExampleを20,000単位保有して、観測期間を始めたとします。その後、分かっている支払い用資産を交換して、さらに5,000単位を取得し、所有者の不確かなアドレスへ3,000単位を移し、分かっている金額で4,000単位を売却します。

追跡機能は、開始時の保有分、文書で確認できる取得、外向きの移転、文書で確認できる処分という、いくつかの事実を確かめられます。しかし、元の20,000単位の原価を自動的に確かめることはできません。また、移転によって経済的な所有が終わったかも、自動的には分かりません。そのため、全期間の利益を計算するには、観測した記録にはない仮定が必要になります。

有用な表示では、チェーン上に残る残高を示し、原価の分かる取得分と、原価の分からない開始時の在庫を分けます。また、分析のために受取代金を取得単位ごとのまとまりへ割り当てるなら、使った会計上の規則を説明します。その規則は、ウォレット所有者の本当の意図を発見したということではありません。また、欠けた履歴の代わりにもなりません。

利益が出ているように見えるウォレットを追跡しても、観測できない入金や、損失の出ている在庫を隠してしまう場合があります。スマートマネーの証拠を評価する枠組みでは、成績評価に何を含める必要があるかを説明しています。

順序と確定の水準についての文脈を残す

イベントは順不同で届いたり、再接続後に繰り返し届いたりする場合があります。情報源の順序の情報が得られるなら残し、状態の確認水準を区別するべきです。早期の観測は監視には役立っても、永続的に保存する保有記録を更新する前には、追加の証拠が必要かもしれません。

一連の活動を再構成するとき、ローカルの到着順だけを根拠にしてはいけません。そうしなければ、取得の記録が遅れて処分の後に届くと、あり得ない負の保有数量を作ってしまう場合があります。照合では、正本となる順序と、データの情報源が対応している保証を考慮するべきです。

適切な方針は、ネットワークと用途によります。より早い暫定的な認識を優先するか、より遅くても強い確認を優先するか、どの記録が暫定のままかを述べるべきです。そうすれば、利用者は、早期の観測をすべて最終的な口座の事実と取り違えずに、通知の緊急性を解釈できます。

正当な活動を失わずに重複を除く

同じイベントについての繰り返しのメッセージは、一つの記録を更新するべきです。数量や金額が似ていても、異なるイベントは別々に残すべきです。そのため、重複排除には、トランザクションへの参照に、関係するイベントや命令の位置を組み合わせるなど、データの仕組みに合う識別子が必要です。

時刻と数量や金額だけを使うと、正当に繰り返した取引を一つにまとめてしまう場合があります。逆に、一つのトランザクションに関連する複数の操作が含まれるときには、トランザクションの識別子だけでも広すぎます。経済的な活動のまとめ方と、元のイベントの識別を別々に定義し、両方の水準を正確に残せるようにします。

繰り返し届いた通知と、実際に二回行われた同じ規模の移動を使って試します。前者では、再構成した残高を二回変えてはいけません。後者では、二回分の変化を反映するべきです。この単純な例によって、信頼できる履歴を作っているのか、それとも、もっともらしい行の流れを作っているだけなのかが分かります。

正当な活動を失わずに重複を除くToken MovementExchangeTransferUnresolvedTRADING FIELD NOTESEDUCATIONAL RESOURCE
トークンの移動は、複数の異なる経済的な活動を表す場合があります。証拠が不完全なら、未解決のまま残すべきです。

データの空白を見えるようにする

提供者の障害、対応していないトランザクションの版、不完全な過去の対象期間によって、データに空白が生じる場合があります。すべてのイベントを観測したかのように連続したチャートを出すのではなく、影響する区間や活動を示すべきです。

データが戻ったら、現在の残高と、再構成した履歴を照合します。不一致は、イベントの欠落、対応していないトークンの動作、または誤った分類を示す場合があります。数字を無理に合わせるため、架空の購入を黙って入れてはいけません。

調整の記録では、まだ説明のついていない残高の差があると述べられます。ただし、検証済みの取引とは別に残すべきです。目的は、データの来歴を正直に残しながら、口座の状態を有用なものに保つことです。利用者は、保有分の変化が、観測した証拠から生じたのか、未解決の照合の差から生じたのかを知る必要があります。

関係する数量に対して保有分の価値を評価する

流動性の薄い市場の直近の取引価格を、大きな保有数量へ掛けたドル換算の推定は、誤解を招く場合があります。参考の評価価格と、執行して得られると推定する代金を区別するラベルを使います。意味のある見積もりが得られなければ、トークンの数量を残し、価値評価の制約を明示します。

架空の保有分が100,000単位あり、最近の取引では10単位が一ドルで売買されたとしても、$100,000で退出できる証明にはなりません。大きな売却でどれだけ受け取れるかは、利用可能な経路と板の厚さで決まります。これは、見かけの成功でウォレットを順位付けするときや、大きな保有分について通知するときに重要です。

ミームコインの取引ソフトウェアのガイドでは、解釈できる記録の重要性を扱っています。追跡機能は、価値評価の仮定を点検できるようにするべきです。利用者が、表示された推定を、現金、実現利益、または保証された退出能力と混同しないためです。

通知と取引権限を別々に扱う

ウォレットの活動に基づく取引シグナルは、別の戦略で見直すための候補として扱うべきです。別の口座がトークンを買ったという観測だけでは、追随者も買うべきだとは確認できません。また、どの価格で、どれだけの規模で買うべきかも確認できません。追随者の現在の資源とリスク制限は、独立して残ります。

裏付けとなるトランザクション、分類への確信度、観測時刻を通知へ付けます。その後の戦略は、証拠が十分で、なお関係しているかを判断できます。対応していない操作や曖昧な操作が、通知の経路に現れたというだけで、取引権限を持つようにしてはいけません。

この境界は、調査だけの利用も支えます。運用者は、興味深いアドレスに口座への影響力を与えず、観測できます。後で執行を加える場合は、対象とする操作と、使える資源の範囲を限る、明示的な規則を必要とするべきです。過去のすべての通知を、自動的に認可済みの指示へ変えるべきではありません。

異なる種類の例を使って分類の質を評価する

有用な検証集合には、通常のスワップ、単純な移転、承認、失敗した試行、流動性の変化、開始時の残高、不完全な記録を含めます。証拠が足りないときの不明という扱いも含め、正しい範囲の解釈を出しているかを評価します。

確信のあるラベルを付けたイベントの割合だけで、品質を測ってはいけません。すべてへラベルを付ける仕組みは、自分の対象範囲の限界を正しく特定する仕組みより、役立たない場合があります。誤って売買と分類した事例や、まだ説明のついていない残高の差を追います。こうした誤りは、その後のすべての成績計算を歪める場合があるからです。

元のトランザクションの証拠を使い、人が例を見直します。読み取り処理を変えたら、以前正しかった分類が引き続き正しいことと、修正した解釈が活動を二重計上しないことを確認します。目標は、信頼できる経済的な履歴です。検出したトランザクションの一覧を、ただ速く増やすことではありません。

根拠を問い直せる記録を作る

ウォレット追跡の取引ボットでは、あるイベントをなぜ購入と呼んだのか、保有数量をどう計算したのか、費用の推定はどこから来たのかを、簡単に問えるようにするべきです。答えは、説明のない確信度の得点ではなく、証拠と明示した仮定を指すべきです。

原価の分からない開始時の在庫、所有者の関係の不確かさ、対応していないトランザクションの種類を残します。これらの制約は、記録の意味の一部です。ダッシュボードをすっきりさせるために消すと、利用者がシグナルを信頼するか決める、まさにそのときに、情報の有用性を下げる場合があります。

実務上の成果は、観測と解釈を区別し、解釈と取引権限も区別する追跡機能です。非公開の意図や欠けた履歴を知っていると主張せずに、移転、スワップ、保有分を説明できます。この明確さは、見えるすべての動きを、利益を出す取引者の次の指示として扱うより、調査と自動化の強い基盤になります。

AIエージェントの暗号資産ウォレットのガイドでは、観測を署名や支出の許可と区別し、その許可を、監視、失効、復旧までたどります。

関連ガイドと計算例

さらに学ぶ

すべての資料を見る