ADA ステーキング報酬は、2 回課税対象となります。プロトコルは、エポック境界でステーキング アドレスに報酬を計上します。ユーザーは、別のオンチェーン引き出しトランザクションで報酬を支払いアドレスに引き出します。管轄区域によって、一方または両方を課税対象とみなす場合があります。どちらに該当するかにかかわらず、税務エンジンがインポートする CSV には、両方のタイムスタンプと、それぞれの時点での ADA 価格が必要です。この記事は、既存のカストディアル Cardano シリーズの税務および会計に関する補足資料です。Cardano のステーキングおよび報酬残高を大規模にポーリングする に関する補足ガイドでは、基盤となる Cardano ステーキング クエリ と、繰り返し読み取りを無料にするキャッシュ エコノミクスについて説明しています。 フルノードを実行せずにCardanoの預金を検出するに関する付随ガイドでは、チェーン上の引き出しトランザクションを監視するブロック範囲ウォーカーについて説明しています。この記事は、仮想通貨税プラットフォーム (Koinly、CoinTracker、Cryptio、ZenLedger) にフィードするユーザーごとの報酬明細書を作成するエンジニア、または年末明細書を作成するカストディアルバックオフィス向けです。同じ5つの列が両方の対象者に回答します。この記事では、それらを生成する2つのクエリ、エポックの計算、法定通貨変換ステップ、CSVの形状、および税務報告に特有の運用上の懸念事項について説明します。## 報酬ごとの2つの税務イベント Cardanoには2つの報酬イベントがあります。ほとんどの税務フレームワークは少なくとも1つに関心を持ちます。多くは両方に関心を持ちます。最初のイベントは獲得です。各エポック境界で、Shelley報酬計算は、2エポック前の報酬をステーキングアドレスにクレジットします。報酬はユーザーの操作なしで届きます。一部の法域では、このクレジットを通常の所得として扱います。クレジット時点のADA価格が、新しいADAの取得原価となります。2番目のイベントは引き出しです。ユーザーは、累積報酬を報酬アカウントから支払いアドレスに移動させるオンチェーン取引に署名します。これは、独自の取引ハッシュとタイムスタンプを持つ個別のイベントです。他の法域では、引き出しを課税時点として扱います。引き出し時のADA価格が実現価値となります。ユーザーごとの正当な報酬明細書には、両方が記録されます。獲得ストリームは、所得認識のタイムラインを示します。引き出しストリームは、現金化のタイムラインを示します。どちらのモデルも受け入れる税務プラットフォームは、それらを別々の行として必要とします。 ## Bitquery API の Cardano ステーキングフィールド Cardano address API は、任意の Shelley アドレスまたはステーキング アドレス (stake1...) に対して stake ブロックを返します。 Bitquery GraphQL IDE で Cardano ステーキング スナップショット クエリ を開いて実行します。 5 つのフィールドが税務エクスポートを制御します。 rewardsAmount は、このステーキング キーに報酬としてクレジットされた ADA の生涯合計です。 rewardsAvailable は、クレジットされているがまだ引き出されていない部分です。 withdrawnAmount は、報酬アカウントから移動された生涯合計です。 stakedAmount は現在委任されている元本で、アクティブな委任期間を検証するために使用されます。 stakedAmountWithRewards は結合されたポジションです。rewardsAmount と withdrawnAmount はどちらも単調です。今日スナップショットを取得し、次のエポック境界で別のスナップショットを取得すると、その差がそのウィンドウ内のアクティビティになります。これが、以下のスナップショット アプローチが機能する理由です。 ## パターン 1: キャッシュされた読み取りを使用したエポックごとの報酬スナップショット Cardano プロトコルは、すべてのエポック境界で報酬を付与します。メインネットのエポックは 5 日です。エポック N の報酬は、エポック N+1 の終了時に計算され、エポック N+2 の開始時に付与されます。各エポック境界の直後に取得されたスナップショットは、新しいクレジットをキャプチャします。手順は簡単です。各エポック境界で、すべてのステーク キーの rewardsAmount をスナップショットします。新しいスナップショットから前のスナップショットを減算します。デルタは、そのエポックで付与された報酬です。各デルタにエポックの開始時刻をタグ付けします。これは、ユーザー ステートメントの収入イベント タイムスタンプになります。このような読み取り負荷の高い作業は、Bitquery キャッシュが構築された目的です。繰り返し行われる (stake_address, snapshot_time) 読み取りはキャッシュから提供され、API ポイントを消費しません。Bitquery 上の本番環境のカストディアンで観察されたポーリング プロファイルはこれを裏付けています。複数のエポックにわたってポーリングされた数千のステーク キーは、最初のパスの後、ほぼ完全にキャッシュから解決されます。税務ワークフローでは、これは 2 つの点で重要です。年次報告の実行は安価です。数か月後に監査または修正されたステートメントのために同じ期間を再実行すると、まったく同じスナップショットがゼロ コストで再現されます。## パターン 2: オン チェーン引き出しイベント 引き出しは明示的なトランザクションです。Cardano の transactions API は、トランザクション レベルで withdrawalValue と withdrawalCount を公開します。Bitquery GraphQL IDE で Cardano の引き出しトランザクション クエリ を開いて実行します。引き出しを特定のステーク キーに関連付けるには、トランザクションの引き出し証明書で使用されているステーク アドレスで結合します。実際には、カストディアンはどのステーク キーがどのユーザーに属しているかを既に知っているため、トランザクション ハッシュとファイル内のステーク キーからアプリケーション コードで結合が行われます。仮想通貨税プラットフォームは通常、オンボーディング中にユーザーからステーク アドレスを受け取り、同じ結合を実行します。出力は、引き出しごとに 1 行です。ステーク キー、タイムスタンプ、ADA 金額、トランザクション ハッシュ。タイムスタンプに ADA/USD 価格を追加すると、税エンジンが必要とする現金化イベントが得られます。## パターン 3: 法定通貨への変換に ADA 価格を添付する 価格を取得する 2 つの方法があります。最も安価な方法は、トランザクション API で inputValue(in: USD) または outputValue(in: USD) を使用することです。Bitquery は、同じクエリ内でトランザクションのタイムスタンプで USD に変換された値を返します。2 回目の API 呼び出しや、維持管理する別の価格フィードはありません。監査要件で固定価格ソース (特定の取引所、日々の決済価格、社内オラクル) が必要な場合は、エポック開始時刻でインデックス付けされた独自の価格テーブルを保持します。スナップショットまたは引き出しトランザクションのタイムスタンプで結合します。監査担当者は一般的に、検証できない埋め込み変換よりも、検証できる文書化された価格ソースを好みます。## 税務エクスポート用の CSV フォーマット ほとんどの税務プラットフォームは、以下の形式の汎用 CSV を受け入れます。列は、パターン 1 および 2 によって生成されるフィールドに直接マッピングされます。event_type は 2 つのストリームを分離し、税務エンジンが行ごとに正しいルールを適用できるようにします。引き出しはエポックに同期したイベントではないため、引き出し行の epoch は空です。獲得イベントはエポック境界でのプロトコルレベルのクレジットであり、トランザクションハッシュを持たないため、獲得行の tx_hash は空です。Koinly と Cryptio はどちらも、汎用 CSV インポーターを介してこの形式を受け入れます。CoinTracker は、列名を変更した後に受け入れます。同じファイルは、CFO のレビュー用に Excel で正常に開きます。## エポック N のエポック N+2 遅延と明細タイミング報酬は、エポック N の終了時に付与されません。これらは、約 10 日後のエポック N+2 の開始時に付与されます。ユーザー明細の収入タイムスタンプは、作業時間ではなく、クレジット時間です。これには、報告ポリシーに文書化しておくべき 2 つの結果があります。エポックの途中でステーキングを解除するユーザーの場合、最後の報酬は委任を停止してから 2 エポック後に届きます。ほとんどの税務プラットフォームは、クレジットのタイムスタンプを所得日として想定しています。それに従い、理由を文書化してください。年末の明細書の場合、12 月の最終エポックからの報酬は 1 月の初めに届きます。事前にポリシーを決定してください。IRS スタイルの立場では、所得イベントはクレジットの時点であり、報酬は翌年の課税年度に配置されます。ユーザーの会計士に確認してください。Bitquery のスナップショット方式では、スナップショットのタイムスタンプがすべての行で明示されているため、どちらのポリシーも簡単に実装できます。## 報酬レポートのための Bitquery とセルフホストの cardano-db-sync の自然な代替案は、Cardano ノードに対して cardano-db-sync を実行し、Postgres で報酬スキーマを直接クエリすることです。これは一部のチームにとっては正当な選択肢です。ほとんどの税務および会計のユースケースには不適切な選択肢です。db-sync の利点は、プライベートクエリのレイテンシが 50 ミリ秒未満で、Postgres スキーマを完全に制御できることです。税務報告における db-sync の反対理由は、ワークフローが再実行 (監査の修正、修正されたステートメント、期間の再ステートメント) によって支配されており、Bitquery キャッシュがそれらの再実行をフリー リードに変えてしまうことです。## これを税務または会計バックエンドに接続する 一般的な報酬報告パイプラインには 4 つのコンポーネントがあります。スナップショット スケジューラは、各エポック境界ですべてのステーク キーのステーキング クエリを実行し、結果を (stake_address, epoch) でインデックス付けされたスナップショット テーブルに書き込みます。デルタ コンピュータは、ステーク キーごとに連続するスナップショットを読み取り、ゼロ以外のデルタごとに 1 つの earned-event 行を出力します。引き出し監視者は、ローリング ウィンドウにわたってトランザクション API に対して withdrawalCount: {gt: 0} をクエリし、各結果を内部のステーク キーとユーザーのマッピングに結合し、属性付き引き出しごとに 1 つの withdrawn-event 行を出力します。 CSV ビルダーは、要求された明細期間の獲得行と引き出し行を読み取り、ADA/USD 価格列を添付して、CSV ファイルを生成します。 4 つのコンポーネントは独立しています。スナップショット スケジューラはエポック クロックで実行されます。引き出し監視機能はチェーン クロックで実行されます。デルタ コンピューターと CSV ビルダーはレポート クロックで実行されます。 1 つのコンポーネントに障害が発生しても他のコンポーネントは破損せず、基盤となる API の読み取りがキャッシュされているため、どのコンポーネントの再実行も安価です。 ## まとめ 対象者に関係なく、ユーザーごとの ADA ステーキング報酬を報告するカストディアル Cardano 製品または暗号通貨税プラットフォームは、同じデータの問題を抱えています。CSVファイルには、獲得時と引き出し時の両方について、イベントのタイムスタンプ、ADAの金額、イベント時のADA価格、およびステーキングキーのアトリビューションが必要です。2つのGraphQLクエリで両方の時点をカバーできます。CardanoアドレスAPIのステーキングスナップショットは獲得タイムラインを提供し、CardanoトランザクションAPIは引き出しタイムラインを提供します。(in: USD)アグリゲーターは法定通貨への換算を提供します。キャッシュは監査の再実行と修正されたステートメントをゼロポイント読み取りに変換します。[Bitquery]