HN 日本語サマリー

← 一覧へ戻る
プログラミング

フィンテック・エンジニアリング・ハンドブック

Fintech Engineering Handbook (w.pitula.me)

595 pointsby signa11182 コメント

要約

このハンドブックは、金融システムにおけるソフトウェアエンジニアリングの重要なパターンをまとめたものです。お金を扱うシステムで信頼性を確保するための原則として、「データを作り出さない」「データを失わない」「信頼しない」の3つを掲げ、具体的な実装方法(金額の表現、通貨の取り扱い、為替レートなど)を解説しています。金融分野に参入する人、既に携わっている人、あるいは外部の人が、金融システムの構築がいかに異なるかを理解するための生きたドキュメントとして機能します。

全文翻訳

Fintechエンジニアリングハンドブック

Fintechエンジニアリングハンドブックへようこそ。このリソースは、システムにおいてお金が主要な焦点となるソフトウェアエンジニアリングで用いられる最も重要なパターンを説明することを目的としています。全体を通して読むことで包括的な理解を得たり、特定の問題に対処する際に部分的に参照したりすることができます。

対象者は?
  • Fintech業界に参入する人々。 ドメインと、お金のシステムを信頼できるものにするパターンに慣れるため。
  • 既にFintech業界にいる人々。 特定の問題に直面した際の参照資料として、また同僚に示すための共通語彙として。
  • Fintech業界外の人々。 お金のための構築が、慣れ親しんだものとどう異なるのか、そしてその理由を理解するため。

この本の背景についてさらに学ぶには、付録Cを参照してください。

原則

以下に読むすべては、3つの原則を遵守するための方法です。

  1. データの捏造なし。 お金はどこからともなく生まれるものではないため、重複や任意の残高更新を容認できません。これを冪等性、重複排除、および照合によって強制します。
  2. データの消失なし。 お金に起こるすべては追跡され、永続化されなければなりません。これを完全な精度、少なくとも1回の配信、イベントソーシング、監査証跡、および不変性によって保護します。
  3. 信頼しない。 外部プロバイダー、内部コンポーネント、あるいは世界さえも信頼しません。ウェブフックの検証、複数のソース間でのデータのクロスチェック、壊れた仮定に対する大きな失敗によってこれを維持します。

お金の表現

お金を移動または記録する前に、それを表現する必要があります。これらは、金額がどのようにモデル化、保存、計算、変換されるかについての決定です。これらを間違えると、上のすべてのレイヤーがそのエラーを引き継ぎます。

精度処理

お金の表現は、金融システムにおける最も基本的な決定の一つです。これを行うための4つの主要な方法があります。

  1. 浮動小数点数。 組み込みのfloatまたはdouble型。これは予期しない精度損失を引き起こす可能性があり、ほとんどの場合良い考えではありません。しかし、最も速く、メモリ効率が最も高く、追加のライブラリやデータ構造を必要としません。
  2. 任意精度。 JavaのBigDecimalのような型は、計算の精度を正確に制御できます。コードは予測可能であり、丸めがどこでどのように行われるかを決定できます。これは、FXや価格設定の数学など、多くの操作が連鎖する中間作業に適しています。
  3. 最小単位精度。 ほとんどの法定通貨では、接続されている中央銀行システムで使用されている固定精度のみを保持すれば十分です。桁数はISO 4217によって記述されています(常に2桁であると仮定しないでください、そうではありません!)。実際には、これは金額を最小単位の整数として保存することを意味します - €12.34は1234になります。仮想通貨も同じ整数-最小単位の考え方を使用しますが(BTCのサトシ、ETHのウェイ)、2つのひねりがあります:精度はアセットごとであり、トークン自体によって定義されます(例:ERC-20のdecimals)、しばしば18桁です。そして、結果の桁数は64ビット整数をオーバーフローするため、それらを保持するには任意幅の整数が必要です。
  4. 有理数。 精度損失が許容されない場合。これは最も強力なアプローチですが、独自の注意点があります。第一に、他のアプローチよりも遅いです。第二に、精度を失うことなく他の形式に変換することはできません。第三に、通常はカスタムデータ型またはライブラリが必要です。

どちらを選択するかは、システムのクラスとその責任に依存します。浮動小数点数を使用しないという以外に、経験則はありません。これらの表現は相互に排他的でもありません - 金額をどのように保存するかと、それを使ってどのように計算するかは別々の決定であり、システムはしばしばそれらを組み合わせます。例えば、整数ストレージと中間計算のためのBigDecimalなどです。

金額がシリアライズされる際にも、同じ注意が必要です。ほとんどのパーサーでは、生のJSON数値はIEEE-754倍精度浮動小数点数であるため、内部でどれほど注意深く表現しても、数としてお金をシリアライズするとエッジで浮動小数点数の問題が再導入されます。お金は、文字列("12.34")または最小単位の整数として送信してください。

影響を受けた原則:

  • データの消失なし。 不適切な表現は、回復不可能な精度を静かに失わせます。
丸め戦略
  1. 丸めは避けられない。 明示的に行う必要があります:あらゆる除算、通貨換算、手数料、利息、またはレートの適用、あるいは精度間の移動は丸めを必要とする可能性があります。
  2. ビジネス上の決定である。 異なる丸め戦略は異なる意味合いを持ちます。時には保守的である必要があります(例:持っていないお金を使わないように)そして切り捨てる。時には統計的効果を気にかけ、偶数丸めを使用します。端数を誰に渡すかの決定は、法的/税務上の影響を与える可能性があります。
  3. 可能な限り少なく丸める。 完全な精度を長く保つほど、適切なコンテキストで正しい決定を下すための選択肢が増えます。丸めは通常、境界で行われるべきです。例えば、永続化される前やユーザーに表示される前などです。
  4. 丸めは合計を壊す。 数値が部分に分割され、丸めが適用されると、部分の合計は元の数値と等しくなくなる可能性があります。コンテキストによっては、明示的な処理が必要になる場合があります。例えば、明示的な丸め口座などです。

影響を受けた原則:

  • データの消失なし。 残差はドロップされるのではなく、追跡されなければなりません。
  • データの捏造なし。 丸めは、存在しなかったお金を生み出してはなりません。
通貨処理

お金は単なる数値では表現できません - 通貨とペアになっています。通貨を扱う際にはいくつかのニュアンスがあります。

  1. 金額と通貨を一緒にパックする。 Moneyニュータイプ(構造体、クラス、レコードなど)は、エラーの可能性を最小限に抑えます。
  2. 通貨間の算術演算は行わない。 システムは、異なる通貨の2つの金額を加算することを禁止すべきです。換算は、厳密に制御されたレートで非常に明示的に行う必要があります。
  3. 制御された通貨セットを使用する。 カスタム設定エントリ、JDKデータベース、専用サービス。任意の通貨コードを受け入れないでください。システムの境界で検証してください。
  4. コードは法定通貨のみを識別する。 通貨コードは、法定通貨に対してのみ一意で識別子として使用できます。仮想通貨の場合、(ネットワーク, コントラクトアドレス)のような、より複雑なアプローチを使用する必要があります。
  5. 通貨はメタデータを運ぶ。 シンボル、精度、名前など。通常、これらの詳細は表示目的で必要ですが、ビジネスロジックではほとんど必要ありません。
  6. ペッグされていることは、基盤ではない。 ペッグ、ブリッジ、ラップされた仮想通貨は、基盤となる通貨と同等ではありません。

影響を受けた原則:

  • 信頼しない。 境界で制御されたセットに対して通貨を検証します。
  • データの捏造なし。 異なる通貨/アセットを相互に交換可能として扱うことは、価値を創り出すことになります。
FXレート

FX(外国為替市場)レートは、通貨間でお金を換算することを可能にします。

  1. レートは常に方向性がある。 EUR/USDレートは、逆のUSD/EURレートと同じではありません。取引所では、買いと売りは異なる価格(ビッド/アスクスプレッド)での2つの異なる注文であるため、2つの方向は単純に反転しません。
  2. レートの時間は重要である。 技術的には任意の時点のレートを使用できますが、最も一般的に使用されるのは次のとおりです。
    • 現在時刻レート。 現在の保有量またはトランザクションの価値を、あたかも今起こったかのように計算するために使用されます。
    • 評価日レート。 価値の変動または税額を計算するために使用されます。
  3. 換算には2種類のレートが重要である:
    1. 取引レート。 実際の換算が行われたレート。これを直接保存するのではなく、元の金額と結果の金額から導き出されます。
    2. 参照レート(ミッドマーケットまたは中央銀行)。評価と等価性(現在の保有量の価値、または評価日における税基)に使用され、実際に取引される価格ではありません。
  4. 標準的なレートは存在しない。 レートは市場から来ており、会場や計算方法によって異なります。最も標準に近いのは中央銀行レートですが、これは参照レートとしてのみ使用でき、それさえも代替ソースが存在する可能性があります。

影響を受けた原則:

  • データの消失なし。 金額(参照レートの場合はソースへの復帰方法)を保持します。
  • 信頼しない。 標準的なレートは存在しないため、ソースはデータの一部であるべきです。

お金の記録:元帳

表現されたら、お金の移動は、バランスが取れ、監査に耐え、数年後に再構築できる方法で記録されなければなりません。ここに帳簿、そのタイムスタンプ、およびその履歴が存在します。

複式簿記

複式簿記は、金融取引を (貸方勘定、借方勘定、金額) の形式のエントリリストとして保存する広く使用されている方法です(これはコンパクトな形式です。古典的な表現では、移動ごとに個別の借方と貸方の行を使用します)。各エントリは同じ金額を一方の勘定から移動させ、もう一方の勘定に移動させるため、帳簿は常にバランスが取れます。お金は移動されるだけで、作成または破壊されることはありません。

  • お金には常にソースとデスティネーションがある。 外部プロバイダーにも専用の勘定が用意されているため、システムに出入りするお金も追跡されます。
  • 残高は決して保存されない。 移動から派生されます。
  • 勘定にはタイプがある。 資産、負債、または資本。これにより、会計方程式(資産 = 負債 + 資本)が維持され、各勘定は増加する側が定義されます。実際には、収益(収入)勘定と費用勘定も必要です。例えば、手数料を収益として記録したり、貸倒を損失として記録したりします(資産 = 負債 + 資本 + 収益 - 費用)。
  • 1つのトランザクション、複数の移動。 単一のトランザクションは通常、複数の移動を作成します。例えば、正味金額用、手数料用などです。
  • 転記されたエントリは不変である。 慣例として、修正は元のエントリを相殺する新しい補償エントリを追加することによって行われます。

影響を受けた原則:

  • データの捏造なし。 お金は勘定間を移動するだけで、総量は保存されます。
評価時刻 vs 記帳時刻 vs 決済時刻

トランザクションには通常、少なくとも2つ、場合によっては3つのタイムスタンプが関連付けられます。

  1. 評価時刻(Value time)。 トランザクションが発生した時刻。
  2. 記帳時刻(Booking time)。 トランザクションがシステムに記録された時刻。
  3. 決済時刻(Settlement time)。 お金が実際に転送または具現化された時刻。すべてのトランザクションにこれがあるわけではありません。通常、T+Xとして表されます。ここでXは評価日からの日数です(例:T+2は評価日の2日後を意味します)。

最初の2つはほぼ常に異なります。

  • 遡及日(backdated)(記帳 > 評価)。技術的にはほとんどすべてのトランザクションが遡及日ですが、記帳時刻と評価時刻が異なる報告期間(日、月、年など)にまたがる場合に、この用語は最も影響力があります。
  • 将来日(forward-dated)(記帳 < 評価)。あまり頻繁ではありませんが、例えばスケジュールされたまたは将来の日付の支払いの場合に発生します。今日記録されたが来週有効になる定期注文などです。

例:カード決済はT1(評価時刻)に発生し、あなたはT2(記帳時刻)にそれを記録しましたが、決済プロバイダーはT3(決済時刻)にあなたのアカウントに送金しました。

ビジネスおよびビジネス消費レポートは通常、評価時刻または決済時刻を気にしますが、記帳時刻は追跡可能性に役立ちます。

影響を受けた原則:

  • データの消失なし。 すべての関連タイムスタンプを記録します。それらを単一のcreated_atに折りたたむと、後で再構築できない情報が失われます。
監査と監査証跡

金融システムは、さまざまな監査の形で規制当局の精査を受けます。監査中に検証される可能性のあることのいくつかを次に示します。

  • 会社の資金がユーザーの資金と混同されていないか、または会社の経費に使用されていないか?
  • すべての収益が登録、報告され、説明可能か? 例えば、特定の期間における特定の収益源に貢献したトランザクションを特定できますか?
  • 外部世界(例:ユーザーまたは税務署)に提供される情報が現実に一致しているか? 例えば、会社がユーザーに負っている金額と同じだけの資産を保有しているか?
  • 資金は外部の脅威から保護されているか?(例:誰が資金にアクセスでき、どのようにアクセスできるか)

これらの質問やその他の多くの質問に答えるために、金融システムは現在の状態だけでなく、その状態がどのようにして生まれたかの完全な履歴を追跡する必要があります。この履歴が監査証跡です。これは、あらゆる残高、レポート、または決定を説明および再現できるほど詳細な、発生したすべてのことの記録です。

有用な監査証跡は、すべての変更について以下をキャプチャします。

  • 何が起こったか。
  • いつ起こったか(評価時刻 vs 記帳時刻を参照)。
  • 誰または何がそれをトリガーしたか - ユーザー、オペレーター、自動化されたジョブ。
  • なぜ起こったか - 原因となった注文、指示、またはインシデントへの参照。

お金の移動は明白な対象ですが、手動の介入、設定変更(手数料スケジュール、レートソース、制限)、および権限変更も追跡が必要です。

なぜはしばしば決定の出力自体です(例:コンプライアンスチェックまたはリスクスコア)。結果だけを記録する(「ブロックされた」)ことは、監査を満たすことはめったにありません。なぜなら、その結果がどのように達成されたかを尋ねられるからです。そのロジックが命令型コードに埋め込まれるのではなく、決定テーブルまたはルールエンジン(DMN、Drools、Decisions4s)に存在する場合、その決定は構造化され、再生可能な成果物となり、どのルールがどの入力に対して、どのような結果で発火したかを示します。

影響を受けた原則:

  • データの消失なし。 現在の状態だけでは、監査の質問に答えることはできません。完全な履歴だけが可能です。
イベントソーシング

イベントソーシングは、おそらく監査証跡を構築するための最も原則的かつ体系的なアプローチです。ESでは、現在の状態をログの横に保存するのではなく、イベントのみを保存し、それらから状態を導き出します。複式簿記は、お金に適用されたこのパターンの例です。残高は決して保存されず、保存されたエントリから計算されます。このアプローチでは、追跡は主要な成果物であり、現実から乖離することはありません。

いくつかの実用的な注意点:

  1. すべてに必要というわけではない。 元帳はお金をすでにカバーしています。周辺ドメインには、信頼性の高い変更ログを備えた従来のモデルで十分な場合があります。
  2. 派生状態はキャッシュできる。 残高や予測は、パフォーマンスのためにキャッシュまたはスナップショット化できます。
  3. 予測の構築は手間がかかる。 多くの予測が必要になる場合があり、プライマリデータセット(イベント)に対して効果的にクエリを実行することはできないため、データを確認するための専用または汎用的な予測を構築する必要があります。
  4. スキーマ進化のために計画する。 イベントは何年も存続するため、今日のコードは長年前に書かれたイベントを読み取る必要があります。

言い換えれば、イベントソーシングは監査証跡が必要な場合に非常に良いソリューションですが、システムの複雑さという点で非常に高いコストがかかります。

影響を受けた原則:

  • データの消失なし。 状態がイベントから導き出されると、追跡は現実と同期から外れることはありません。なぜなら、それは真実のソースだからです。
不変性

監査証跡が編集可能である場合、何も証明しないため、レコードは更新または削除できません。私たちのログは追記専用でなければならず、すべての修正は新しいレコードであるべきです(下記参照)。

不変性は不変条件であり、通常のツールボックスが適用されます。

  1. 構造による。 追記専用テーブル、データベース権限レベルでのUPDATE/DELETEの取り消し。
  2. 実行時チェック。 アプリケーションレイヤーは、投稿済みレコードに対する変更操作を公開しません。
  3. 事後。 改ざん証拠:レコードのチェックサムまたはハッシュチェーンを定期的に検証し、事後の変更が検出可能になるようにします。

実際のシステムを構築する際にはバグは避けられず、イベントログ/監査証跡を修正する必要がある場合があります。その場合、厳密に不変に保つよりも、トレイルをインプレースで更新する方が簡単な場合があります。この2つの世界をバランスさせるためには、レポートのスケジュールと義務を理解することが重要です。通常、データは報告された後にのみ石に刻まれる必要があります。例えば、月末に財務諸表が共有されたときなどです。それまでは、システムから離れる前に問題を発見して修正できれば、データをインプレースで変更できる場合があります。

影響を受けた原則:

  • 信頼しない。 編集可能な履歴は何も証明しません。不変性と改ざん証拠は、外部の者、さらにはインシデントを調査しているあなた自身にとっても、追跡を信頼できるものにします。
逆転と修正

間違いは依然として発生します。例えば、間違った金額が転記されたり、トランザクションが間違った勘定に着金したりします。不変性は、前方修正を意味します。新しい補償エントリを転記し、それを修正対象のレコードに双方向にリンクします。

  1. 逆転。 元のレコードを経済的に無かったことにするために完全に無効化します。しかし、それは履歴に元のレコードとともに表示されたままになります。
  2. 修正(調整)。 記録されたものと記録されるべきだったものの差額を記帳するか、または逆転させて正しい値で再転記します。
  3. 報告期間に注意。 修正は、元の期間とは異なる報告期間に着地することがよくあります(評価時刻 vs 記帳時刻を参照)。リンクにより、レポートがそれらを正しく帰属させ、実際の活動とクリーンアップを区別できます。

最後の点は特に重要です。修正/逆転を転記する際には、イベントを遡及日(過去の評価時刻を指定)にするかどうかを決定する必要があります。ここでも報告スケジュールに大きく依存します。通常、すでに報告された期間には何も遡及日を適用することは許可されません。なぜなら、それはすでに外部世界に報告されているからです。

影響を受けた原則:

  • データの捏造なし。 間違いは、元のレコードを相殺する補償エントリを転記することによって修正されます。

お金の流れの実行

お金の操作は、単一の書き込みであることはめったにありません。それはステップ、同時実行性、および失敗にまたがり、それらすべてを通じて、お金を生成したり失ったりすることなく、正しい状態を維持する必要があります。これらは、単一の流れを正しい状態に保つためのパターンであり、維持しなければならない不変条件から、途中でクラッシュしても生き残ることまでです。

不変条件

どのようなシステムにも、常に保持されなければならない特別なプロパティが存在します。それらを不変条件と呼びます。そのような不変条件の1つは、前述の会計方程式です。ビジネスステークホルダーは、多くのそのような条件を定義する可能性があり、それらは強制されなければなりません。

不変条件を強制するための3つの主要な方法があります。

  1. 構造による。 システムが有効なオブジェクトのみを作成できるようにすることで、無効な状態が表現不可能であることを確認します。これは、ファクトリメソッド(スマートコンストラクタ)、型レベルプログラミング(例:リファインド型)、データベース制約など、さまざまなテクニックで行うことができます。
  2. 実行時チェック。 ロジックを実行するときに不変条件が満たされているかを確認します。これは、本番コード内のアサーションまたはテストです。プロパティベーステストがここで輝きます(例:「任意の投稿シーケンスに対して、帳簿はバランスが取れている」)。
  3. 事後。 システムによって永続化されたデータを分析して、違反がないか確認します。例えば、照合ジョブや、元帳の残高が会計方程式を引き続き満たしているかの夜間チェックなどです。

重要なのは、これらの方法は補完的であり、望ましい信頼レベルを達成するために通常はすべて並行して使用されるということです。構造による方法は最も強力ですが、すべてを表現できるわけではありません(特にクロス集計またはクロスシステム不変条件)。実行時チェックは発生時に違反をキャッチし、事後チェックはすでにリリースされたバグをキャッチする唯一の方法ですが、遅れてキャッチします。

影響を受けた原則:

  • 信頼しない。 不変条件は検証されるものであり、仮定されるものではありません。あなた自身のコードの出力さえもチェックされます。
資金予約

ほとんどの場合、トランザクションは外部世界とのやり取りを必要とします。例えば、ユーザーが資金を引き出すことを許可する前にコンプライアンスチェックを実行する必要がある場合や、外部システムに引き出しを登録する必要がある場合があります。

そのような場合、競合状態を回避する必要もあります。同じお金を2回使う、または外部世界とのやり取りがすでに発生した後にのみ「残高不足」を発見するなどです。

これに対処するために、システムは資金予約(ホールドアンドリリースとも呼ばれる)を実装します。これにより、外部インタラクションが開始される前に、資金が特定のトランザクションのために最初に予約されます。完了すると、予約は決済され、トランザクションは続行されます。何かがうまくいかなかった場合、予約は解放され、資金は利用可能残高に戻ります。

このパターンは、2つの残高の区別を導入します:総残高(予約済み資金を含む、ユーザーが所有するすべて)と利用可能残高(利用可能 = 総額 - 予約済み)。残高チェックと新しい予約は、利用可能残高に対して行われます。これにより、同じ資金が2つのトランザクションの裏付けとなることを防ぎます。

いくつかの実用的な注意点:

  1. 最終金額は異なる場合があります。 必ずしも事前にわかっているわけではありません。手数料やレートが見積もりと異なる場合があります。その場合、見積もり額を予約し、実際の金額を決済し、残りを解放します。
  2. 予約は常に解決されなければならない。 決済も解放もされない予約は、ユーザーの資金をロックします。そのため、それを作成するすべてのフローは、最終的に解決することを保証する必要があります。明示的な有効期限/タイムアウトはセーフティネットとして機能しますが、オプションです。内部システムの規律に依存することもできます。特に、障害モードは保守的です。孤立した予約は資金をロックしますが、資金を失ったり生成したりすることはありません。
  3. 強い一貫性が必要です。 残高のチェックと予約の記録は、線形化可能でなければなりません。古い読み取りでは、2つのトランザクションが両方ともチェックをパスし、同じ資金で支出を裏付けることができます。したがって、ここでは最終的な一貫性はありません、残念ながら。

影響を受けた原則:

  • データの捏造なし。 同じ資金が2つのトランザクションの裏付けとなることは決してありません。予約は、競合する残高チェックに依存するのではなく、これを明示的にします。
過払い(オーバードラフト)の処理

過払いとは、口座残高がマイナスになった場合を指します。過払いは2種類あります。

  1. 意図的。 過払いは、ビジネスが上限と利息を設けて明示的に提供する信用商品です。これはビジネス機能であり、異常ではありません。ほとんどの場合、ここでは範囲外です。これは、個別の過払い勘定(ユーザーにとっては負債、オペレーターにとっては売掛金)として、プラスの残高でモデル化される可能性が最も高いです。
  2. 意図しない。 ポリシーで禁止されているにもかかわらず、残高がマイナスになる場合。

意図しない過払いは、外部世界が許可を求めないため、正しいシステムでも発生します。決済が予約済み見積もりよりも高額になる場合や、資金がすでに流出した後に逆転が発生する場合などです。資金予約は過払いのウィンドウを減らしますが、排除することはできません。

禁止されていることと表現できないことは同じではありません。 型レベルまたはストレージレベルで「残高はマイナスにならない」ことを符号なし整数またはCHECK (balance >= 0)制約としてエンコードしたくなる誘惑があります。しかし、マイナスの残高を受け入れざるを得ない場合、それを表現できないシステムは、フローの途中でクラッシュするか、静かに残高をゼロにクランプする(お金を捏造する)、または同様に間違ったことを行うでしょう。

別の言い方をすれば、「残高 >= 0」は単なる不変条件であり、通常のツールボックスが適用されます。トランザクションを承認する際に実行時に強制し、監視と照合で違反を検出しますが、構造によって強制しないでください。過払いが検出された場合、それは調査のシグナルですが、必ずしもバグではありません。

過払いが実際に発生した場合、それを記帳し、例えば将来の入金との相殺、返済要求、または貸倒として明示的な費用/損失勘定への補償エントリとして回収する必要があります。

影響を受けた原則:

  • データの捏造なし。 マイナスの残高をゼロにクランプすることは、お金を鋳造することになります。
  • 信頼しない。 外部世界は、あなたのチェックが何と言おうと過払いを強制できます。
冪等性

分散システムでは、正確に1回の配信を保証することは不可能です。あらゆる呼び出しが中断される可能性があり、それが相手側に到達したかどうかを知ることはできません。メッセージが配信されたことを確認するには、すべての呼び出しを再試行する必要があります。しかし、そうすることで、複数回配信されるリスクがあるため、その処理は冪等である必要があります。同じメッセージが2回配信されても、処理は1回だけトリガーされる必要があります。

  1. 明示的なキーを優先する。 冪等性キー vs ビジネス由来の冪等性(例:ペイロードの重複排除)。明示的なキーは通常、よりシンプルで優れたソリューションです。データから導き出すのは壊れやすいです。例えば、同じ金額の2つのトランザクションが重複なのか、それとも2つの正当な操作なのかを判断するのは困難です。冪等性キーを使用する場合は、それらが特定の操作とクライアントにスコープされていることを確認してください。
  2. エラーの再生方法を決定する。 呼び出しが最初に失敗した場合、再試行は保存されたエラーを再発生させるべきか、それとも処理を再トリガーすべきか? エラーを冪等な結果として扱い、それを再生する方が通常はシンプルで理解しやすいです。クライアントは常に新しいキーで再試行できます。エラーの性質に多くが依存します。永続的なエラー(例:検証)はそのまま再生されるべきですが、一時的なエラー(例:ネットワーク障害)は再処理される可能性があります。
  3. 繰り返しペイロードの検証。 繰り返しの呼び出しが元の呼び出しと同じペイロードを運ぶことを確認するのは良い習慣です。実際には、これはコストがかかり、実装がより複雑になり、柔軟性が低下する(呼び出し元が良い理由でリクエストを変更する可能性がある)という代償を払って、わずかな信頼性しか向上しません。
  4. スケールすると困難。 信頼性の高い冪等性を構築することは複雑な事業になる可能性があるため、十分な労力を費やしてください。数十億のリクエストを重複排除する必要があるだけでなく、同時アクセス下での動作(例:同じミリ秒に到着する2つの重複呼び出し)も正しく行う必要があります。冪等性バリアはアトミックである必要があります。
  5. 時間ウィンドウに注意。 冪等性時間ウィンドウに依存したくなるかもしれません。例えば、24時間以内にのみ重複排除するなどです。これは実装を大幅に簡素化しますが(そうでなければデータ量は永遠に増加します)、正確さの代償を払います。これを行う必要がある場合は、後で必ず後悔することになるため、絶対に必要な場合にのみこのトレードオフを行ってください。
  6. 再試行のテスト。 より良いアプローチの1つは、統合テストまたはシステムテストに汎用的なミドルウェアを組み込み、すべての呼び出しを自動的に繰り返すことです。
  7. 順不同の再試行を処理する。 システムは、すでに新しい状態に移行した場合でも冪等性を維持する必要があります。例えば、資金がすでに解放されている場合でも、保留中の資金の保持を冪等に保つなどです。

冪等性は、呼び出しを行う側と受信する側の両方で重要です。操作を消費または公開するたびに、これを念頭に置いてください。

影響を受けた原則:

  • データの捏造なし。 再試行は避けられないため、処理は重複配信を単一の効果に収束させる必要があり、お金を2回移動させることはありません。
完全な再開可能性

お金の流れは、単一のステップで発生することはめったにありません。引き出しは、資金を予約し、コンプライアンスチェックを実行し、外部システムに操作を登録し、最後に決済する場合があります。そのようなシーケンスは時間をかけて広がり、どの2つのステップの間でも失敗する可能性があります。したがって、安全な仮定は、それが失敗することです。2ステップごとに失敗すると想定してください。したがって、フローは一度に完了することを決して仮定できず、半完成したフローは、一貫性のない状態ではなく、常に回復可能な状態に着地しなければなりません。

  1. 進捗を永続化し、メモリに保持しない。 フローを明示的なステートマシンとしてモデル化し、その状態を永続的に保存し、次のステップを開始する前に各ステップの完了をコミットします。再起動は、フローがどこにあったかを正確に伝える必要があります。
  2. 停止したフローを再開するものが必要。 独立したドライバー(スケジューラ、ワーカー、またはポーラー)が、不完全なフローを取得して前進させる必要があります。オーケストレーターのクラッシュがフローを永久に立ち往生させてはなりません。
  3. 各ステップは再実行可能である必要がある。 再開時に、すでに部分的に発生したステップを再実行する可能性があるため、各ステップは冪等である必要があります(冪等性を参照)。
  4. 前方ロールまたは補償。 外部効果はロールバックできません。外部世界を呼び出した後、それを元に戻すことはできません。データベースのロールバックはそれを元に戻しません。したがって、フローが完了するまで前方へ再試行するか、後続のステップが完全に失敗した場合、前のステップを巻き戻すための補償アクションを転記します(サガパターン)。

永続実行エンジン(例:Temporal、Camunda、Workflows4s、AWS Step Functions)を使用するか、独自の永続ステートマシンを手作業で構築できます。

影響を受けた原則:

  • データの消失なし。 フローの途中でクラッシュしても、進行中のお金の追跡を失うことは決してありません。永続化された進捗により、フローをピックアップして完了させることができます。
  • データの捏造なし。 再開はステップを再実行するため、二重計上せずに再適用する必要があります。フローは正確に1回完了します。

外部世界

サードパーティプロバイダー(決済、KYC、AML、銀行、カストディアンなど)の形式であれ、内部サービスであれ、外部世界とのやり取りは避けられません。私たちの仕事は、これらの依存関係がどれほど信頼性が低下しても、正しい状態を維持するシステムを構築することです。

APIの利用

遅かれ早かれ、決済プロバイダー、カストディアン、ブロックチェーンノード、またはKYCベンダーなど、誰かのAPIを呼び出す必要があります。あなたはコード、品質、または稼働時間を制御できないため、安全なデフォルトは、それが誤動作すると仮定し、その周りに防御的に構築することです。

  1. スキーマを信頼しない。 レスポンスが常に提供された契約と一致するわけではありません。フィールドが欠落したり、型が変更されたり、予期しない場所にnullが現れたりすることがあります。重要な部分を境界で検証し、予期しないものに対して大きな失敗を発生させて、不正なデータがシステムに漏洩しないようにします。同時に、必要のない部分は決して検証しないでください。サードパーティが契約を破った場合に不要な障害を引き起こす可能性があるためです。そして、彼らはそうします。
  2. 不完全なエンジニアリングを期待する。 疑問のあるエンジニアリングプラクティスと考えるすべてが、十分な時間があれば現れます。URL内のトークン、失われた精度、意味が正しくないHTTPコード(エラーボディを運ぶ200)、一貫性のないページネーション、カスタム日付フォーマット。それにイライラしないでください。例外ではなく、仕事として扱ってください。
  3. すべての呼び出しは失敗する。 システムが応答の欠如を処理できるように設計してください。再試行とタイムアウトは必要な保護です。
  4. サーキットブレーカーは通常オプションである。 それらは主に過負荷のサーバーへの配慮であり、クライアント側での複雑さの増加によって支払われます。サーバーが自身の負荷を処理し、提供できないリクエストをドロップすることを期待するのは合理的です。とはいえ、サーキットブレーカーはレイテンシーと有限リソース(スレッド、接続など)も保護するため、本当に必要な場合にのみ使用してください。
  5. クォータに注意。 レート制限と使用クォータは忘れやすいですが、週末のひどい障害の原因となる可能性があります。事前に簡単な計算(プロバイダーの制限に対する予想される呼び出し量)を行うと、問題が発生する前にそれを把握できます。
  6. すべてのリクエストとレスポンスを保存する。 過剰に聞こえるかもしれませんが、外部APIが異常なものを返し始めた場合の調査中に命綱となる可能性があります。送信したものと返ってきたものを、構造化されクエリ可能な形式(例:Redshiftテーブル)で永続化します。これは、プロバイダーの動作が争われた場合の監査証跡および証拠となり、バグ後の再処理のための資料にもなります。
  7. プロバイダーの冗長性を目指す。 最も重要な部分については、同じ目的で複数のプロバイダーの使用を検討してください。プロバイダーを完全に信頼することはできないため、最も重要な場面では、複数のソース(例:2つのブロックチェーンノード)に対してデータを検証したり、バックアップの銀行パートナー、仮想通貨カストディアン、またはKYCベンダーを持ったりすることを意味する場合があります。このアプローチは非常に高価ですが(開発、手数料、複雑さの点で)、望ましいレベルの信頼性を達成するために必要な場合があります。
  8. サンドボックスを信頼しない。 プロバイダーがテスト/サンドボックスアクセスを提供する場合、それはすでに良い兆候です。これらの環境は基本的なシナリオでは問題ありませんが、通常は本番環境と大きく異なります。本番環境でのテスト(例:カナリアリリースと小規模な影響での制御された使用)に備えてください。

影響を受けた原則:

  • 信頼しない。 プロバイダーのコード、スキーマ、稼働時間はすべてあなたの制御外にあるため、独立したソースに対して事実を検証し、境界ですべてを検証します。
  • データの消失なし。 すべてのリクエストとレスポンスを永続化することで、照合および再処理できる記録が保持されます。
ウェブフックの処理

ウェブフックは外部システムから信号を受信する最も一般的な方法ですが、安全に処理することは簡単ではありません。ここではウェブフック(外部システムがペイロードを定義して呼び出すHTTPエンドポイント)に焦点を当てていますが、多くの点は他のトランスポート方法にも適用されます。

  1. 順序を仮定しない。 メッセージは順不同で到着したり、古いデータを含んだりする可能性があるため、最後に受信したウェブフックが必ずしも最新の真実ではありません。到着したものを盲目的に上書きしないでください。すでに知っていることと照合してください(例:APIに現在の状態をクエリすることによって)。
  2. 有効性を仮定しない。 ウェブフックは発行者の二次システムから来る可能性があり、古いまたは不適切に変換されたデータを含んでいる可能性があります。良い習慣は、ウェブフックの内容を無視し、それを権威ある状態をクエリするためのトリガーとしてのみ使用することです。APIは最終的に一貫性があり、ウェブフックに遅れる可能性があることに注意してください。したがって、トリガーの直後のクエリでも古い状態が返される可能性があるため、再試行する準備をしてください。
  3. 配信を仮定しない。 発行者が約束する再配信ポリシーがどれほど強力であっても、ウェブフックはいずれ失われます。欠落したウェブフックを処理する準備ができている必要があります。これは通常、データの完全性を修正する独立したプロセスを意味します。照合を参照してください。
  4. 単一配信を仮定しない。 同じウェブフックが複数回配信されます。処理は冪等である必要があります。冪等性を参照してください。
  5. 迅速に確認し、非同期で処理する。 生のイベントを永続的に保存したらすぐに2xxを返し、実際の作業は非同期で行います。インラインで処理して遅い場合、発行者はタイムアウトして再試行する可能性があり、負荷が増加します。
  6. 生のペイロードを永続化する。 それに基づいて行動する前に、受信したものをそのまま保存します。これにより、処理がより信頼性が高まるだけでなく、プロバイダーが実際に何を言ったかの監査証跡としても機能します。また、バグ後にプロバイダーに再送信を依頼せずにメッセージを再処理することもできます。
  7. 呼び出し元を検証する。 通常のメカニズムは、発行者がペイロードの署名を提供することです。これにより、メッセージが本当に彼らから来たことを検証できます。最も一般的なのは共有秘密鍵で計算されたHMACですが、公開半分が公開されている非対称署名であることもあります。1つの注意点:再シリアライズされたペイロードではなく、受信した生のバイトに対して署名を検証します(再シリアライズはバイトを変更し、署名を壊します)。これがあっても、内容を信頼しないことを優先します(ポイント2を参照)。

ここでは繰り返しテーマがあります:ウェブフックを信頼しないでください。それを「何か」が起こったというヒントとして扱い、それが「何が」起こったかの信頼できる説明として扱わないでください。

影響を受けた原則:

  • 信頼しない。 ウェブフックは、認証されていない、順序付けされていない、失われる可能性のある、重複する可能性のあるヒントです。ソースを検証し、APIに対して実際の状態を確認してください。
  • データの消失なし。 生のイベントを永続化し、照合で配信をバックアップすることで、ドロップされたウェブフックが事実の消失を意味しないようにします。
信頼性の高い通知(アウトボックスとCDC)

私たちのシステムでの変更を、Kafkaイベントの発行、ウェブフック呼び出しのディスパッチ、またはその他の多数の方法で、信頼性の高い方法で外部に知らせることは、しばしば要件となります。問題のある部分は信頼性です。少なくとも1回の配信を保証する必要があります。これらのチャネルは、通常依存する通常のトランザクションモデルには適合しません。トランザクション性がない場合、次のいずれかのリスクがあります。

  • 発行してからロールバック。 発行は成功しましたが、ネットワークの問題で応答が得られなかったため、システムの状態をロールバックします。
  • 発行なしの状態変更。 発行は実際に失敗しましたが、ロールバックしませんでした。

教科書的な回答は2フェーズコミット/分散トランザクションですが、その複雑さと、アプローチを標準化および再利用するための良い方法がないため、めったに使用されません。実用的なオプションは次のとおりです。

  1. アウトボックスパターン。 「発行」イベントは、トランザクション的に(状態変更とともに)専用ストアに書き込まれ、そこから信頼性高く処理されます(行を取得し、成功するまで再試行)。言い換えれば、「発行意図」を確実に保存し、後で処理します。
  2. 変更データキャプチャ(CDC)。 データベースにコミットされた変更を検出する自動化されたメカニズム(通常は書き込み先頭/レプリケーションログをテールすることによって)であり、それをイベントストリームに変換します。ログから直接読み取るため、コミットされたすべての変更がキャプチャされ、アプリケーションに明示的な発行コードなしで何も見逃されません。DebeziumやAWS DMSのようなツールがこれをオフザシェルフで実装しています。トレードオフは、カップリングと運用上の重さです。生のCDCはテーブル行の形式でイベントを発行し、内部スキーマをコンシューマーに漏らさないように後処理が必要です。
  3. 自己リスニング。 順序を逆にし、最初にイベントを発行します(例:Kafkaへ)。その後、それから自身の状態を再構築します。
  4. イベントソーシング。 イベントログはすでにデータベースに存在するため、発行はそこから読み取る問題にすぎません(イベントソーシングを参照)。

どのメカニズムを選択しても、配信は少なくとも1回です。リレーまたはコネクタは、記録する前に発行してクラッシュする可能性があり、再起動時に再送信します。したがって、コンシューマーは冪等であり、安定したイベントIDで重複排除する必要があります(冪等性を参照)。

影響を受けた原則:

  • データの消失なし。 コミットされた変更は、確実にコンシューマーに到達する必要があります。アウトボックス(またはログ)は、別の発行ステップが失敗しただけで通知がドロップされないことを保証します。
  • データの捏造なし。 コミットされなかった変更に対して通知を発行することはありません。重複配信は単一の効果に収束します。
照合

外部データに依存するシステムは、データドリフト(一方のシステムがもう一方と一致しない状況)を起こしやすいです。例えば、ウェブフックを見逃したり、トランザクションが元帳に転記されたが外部プロバイダーのシステムに反映されなかったりする場合があります。そのようなすべてのケースで、照合が必要です。これは2つのシステムを整合させるプロセスです。ここでは「2つ」と言っていますが、実際にはそれ以上になる可能性があります。例えば、元帳、決済プロセッサー、および銀行ですが、問題へのアプローチは変わりません。

  1. 頻度。 正確なコンテキストと制約に応じて、照合は毎時、毎日、毎月、あるいは毎年行われる場合があります。
  2. ドリフトの性質。 データが欠落している(簡単なケース)か、または異なっている(例:異なる金額を持つ同じトランザクション、これは解決がはるかに複雑です)場合があります。タイミングも非常に重要です。決済がT+3で行われる場合、レコードは3日間未照合のままになります。そのロジックはプロセスに組み込まれるべきであり、それらのケースでアラートが出ないようにします。
  3. マッチングアルゴリズム。 2つのシステム間で何を比較するかを知ることが難しい部分です。通常は、マッチングを簡単にするために、外部プロバイダーIDをシステム内に永続化したいと考えます。そうでない場合は、ヒューリスティックアルゴリズムが登場します(例:金額と時間でマッチング)。
  4. 1対多。 場合によっては、一方の複数のレコードをもう一方の1つのレコードと照合する必要がある場合があります。例えば、単一の決済転送がいくつかのトランザクションをカバーする場合があります。
  5. 整合させることは簡単ではない。 言うまでもなく、照合を満足させるためにデータを単純に上書きすることはできません。発見された各不一致は、第一級サポートを通じて理解され、修正されるべきです。例えば、修正レコード、ウェブフックデータの再処理などです。

影響を受けた原則:

  • 信頼しない。 照合は、単一のシステムが正しいと信じるのではなく、独立したソース間で検証する方法です。
  • データの消失なし。 ドロップされた事実 - 欠落したウェブフック、未決済の転送 - が永久に消える前にキャッチするセーフティネットです。

コントロールとアクセス

これまでのパターンはデータを正しく保ちます。しかし、お金のシステムは、誰がそれに作用することを許可されているかを制限し、後でプロセスが従われたことを証明する必要もあります。ここで信頼しない原則は内向きになり、あなた自身のオペレーターやエンジニアも、外部プロバイダーや内部コンポーネントと同様に、信頼の境界となります。監査人は、これらのコントロールを帳簿自体とともに検査します。

職務分掌と4つの目

一部のアクションは、どれほど信頼されているかにかかわらず、単一の人物に任せるには機密性が高すぎます。それらを分割することは、金融における最も古いコントロールであり、2つの関連する形態をとります:職務分掌(一人の人物がプロセス全体を所有しない)と4つの目/メーカーチェッカー(特定の操作が実行される前に2人目の人物による承認が必要。デュアルコントロールとも呼ばれる)。

  1. お金の操作に適用される。 大規模または手動の引き出し、手動の元帳修正、財務およびコールドウォレットの移動、手数料スケジュールまたは制限の変更 - 資金を移動または誤記する可能性のあるものはすべて、2番目の承認者の候補となります。
  2. エンジニアリングにも適用される。 コードのマージ、本番環境へのデプロイ、インフラストラクチャの変更は、お金のシステムでは機密性の高いアクションです。したがって、通常はレビューと承認が必要です。
  3. 承認は追跡の一部である。 誰が要求し、誰が承認し、そしてそれらが異なる人物であったかを記録します。そうでなければ、コントロールは証明不可能になります(監査と監査証跡を参照)。
  4. ブレイクグラスにはパスが必要。 緊急事態は発生し、厳格なコントロールは人々をそれを迂回させるように誘います。バックドアを強制するのではなく、明示的で厳重に監査されたオーバーライドを提供します。

影響を受けた原則:

  • 信頼しない。 単一の内部アクター - 信頼されているアクターでさえ - は、機密性の高いまたは不可逆的なアクションに対する十分な権限ではありません。
アクセス制御

誰が何ができるかは、システムの状態の一部であり、人々が参加し、チームを移動し、去るにつれて時間とともに変化します。今日誰が資金に触れることができるかを知るだけでは不十分です。監査人は、彼らがどのようにしてそのアクセス権を得たかも尋ねます。

  1. 最小権限。 各アクター(人間またはサービス)に必要な最小限の権限を付与し、アクセスがレビュー可能であり続けるように、個人ごとの付与よりもロール(RBAC)を優先します。
  2. 承認変更には追跡が必要。 機能の付与または取り消しは、お金の移動と同様に機密性の高いイベントです。何が変更されたか、誰が変更したか、そしてなぜ変更したかを記録します。元帳からの監査証跡規律もここに適用されます(監査と監査証跡を参照)。
  3. 定期的にアクセスをレビューする。 権限は古くなったり不正確になったりします。定期的なアクセスレビュー(再認定)は、事後チェック(不変条件を参照)であり、ドリフトをキャッチできるようにアクセスに適用されます。

影響を受けた原則:

  • 信頼しない。 静かに蓄積される常時アクセス。最小権限と定期的なレビューがそれを抑制します。
変更追跡(SDLC)

規制環境では、コードが本番環境に到達する方法を監査し、誰が変更をレビューし、誰が承認し、いつリリースされたかなどを知る必要があります。バージョン管理とCI/CDシステムは、正しく行われればここで大いに役立ちます。

  1. ソース管理は記録である。 コミット履歴は、すべての変更を作者に帰属させ、レビューとリンクされたチケットを通じて、それが作成された理由に結び付けます(監査証跡が要求する通常の何/誰/なぜです)。署名付きコミット、保護されたブランチ、共有履歴への強制プッシュなしで、それに応じて保護してください。
  2. レビューとパイプラインは強制されなければならない。 必須(オプションではない)レビュー、ステータスチェック、「メインへの直接プッシュなし」は、規律が監査で通用しないため不可欠です。
  3. デプロイメントは追跡可能である。 どのバージョンが実行されているか、誰がリリースしたか、いつリリースしたかは再現可能であるべきです。これは、インシデントの原因となった変更に結び付けることを可能にします。

影響を受けた原則:

  • データの消失なし。 システム自体がどのようにして生まれたかの履歴は、それが保持するお金の履歴と同じくらい追跡の一部です。
  • 信頼しない。 システムは配信コントロールを強制します。人々がそれに従うことを覚えていることに依存しません。

テスト

テストはどこでも重要ですが、お金のシステムではより重要です。難しさは、期待される出力を列挙できないことが多いことです。操作シーケンスの空間が大きすぎ、興味深い失敗は組み合わせにあります。以下の方法は、システムが正しいことへの信頼を得る方法です。あなたのシステムに最も影響を与えるテクニックを選択できるレストランメニューとして扱ってください。

  1. プロパティベーステスト。 特定の出力をアサートする代わりに、生成されたすべての入力に対してプロパティが満たされることをアサートします。これは、不変条件やお金の計算に自然に適合します。フレームワークは、手作業では思いつかないような厄介なケースを生成します。
  2. ステップ間の不変条件チェック。 操作シーケンスを生成するときは、最後に不変条件をアサートするだけでなく、各ステップの後にもアサートします。これは大規模では手動で行うことは不可能なので、アサーションを自動的に注入する、より洗練されたテストハーネスが必要になります。
  3. 生成的な冪等性テスト。 外部世界に触れるすべての操作は冪等である必要があるため(冪等性を参照)、それをシステムの特徴にすることができます。上記のアプローチと同様のアプローチを使用して、宣言されたすべての操作を自動的に繰り返し、2回目の呼び出しからのシステムへの影響の欠如をアサートできます。
  4. クラッシュと再開の注入。 長いフローは、任意の2つのステップの間で生き残る必要があります(完全な再開可能性を参照)。そして、通常のプロセスに従ってそれをテストできます。各ステップで障害を注入します。
  5. ラウンドトリップテスト。 エンコードしてからデコード、シリアライズしてからデシリアライズ、変換してから元に戻す - そして開始した場所(または既知の許容範囲内)に着地することをアサートします。これは、境界での精度損失や、お金と通貨の型のシリアライズバグをキャッチする簡単な方法です。自動データ生成と非常によく合います。
  6. ゴールデンテスト。 計算または予測(手数料の内訳、明細書、レポート)の出力を保存された期待結果にピン留めし、意図しない変更が差分として表示されるようにします。複雑で推論が難しい計算で、新しく書かれたアサーションよりも一度レビューされた結果を信頼する場合に役立ちます。
  7. 後方互換性テスト。 イベントと保存されたレコードは何年も存続し、今日のコードは古いコードが書いたものを読み取る必要があります(イベントソーシングを参照)。古い形式の実際のペイロードのコーパスを保持し、現在のコードがそれらを正しくデシリアライズおよび予測できることをアサートします。これは、スキーマ変更が履歴を静かに壊すのを防ぎます。
  8. 本番環境でのテスト。 一部の信頼性は、実際のものを介してのみ得られます。プロバイダーのサンドボックスは本番環境と大きく異なります(APIの利用を参照)。したがって、統合が機能することの最終的な証明は、ライブで行う必要があります。カナリアリリース、小規模な影響範囲での制御されたロールアウト、またはシステム全体に少量の実際の金額を継続的にプッシュする合成トランザクションをヘルスチェックとして使用します。お金に特化した注意点は、これらが実際の移動であるということです。本番環境でのテストは実際のお金を移動させるため、他のすべてと同じ元帳、照合、および監査証跡を通過する必要があり、明確にタグ付けされ、通常の修正/逆転メカニズムを通じてクリーンアップされる必要があります。決して帳簿をバイパスするバックドアではありません。

影響を受けた原則:

  • 信頼しない。 テストは、パターンが実際に満たされていることを検証する方法であり、それらが満たされていると仮定するのではなく、不変条件がオラクルであり、偶然期待した値ではないことです。
  • データの捏造なし。 操作の再生と障害の注入は、再試行と回復が二重計上したりお金を鋳造したりしないことを証明します。
  • データの消失なし。 ラウンドトリップおよび後方互換性テストは、精度と履歴が境界と時間の経過を生き残ることを証明します。

付録A:ドメインを理解する

Fintechに参加する上での最も難しい部分は、しばしばコードではなく、その背後にある語彙と概念です。この分野には、普通に聞こえるが正確な意味を持つ言葉、そして周りの誰もが決して展開せずに使用する頭字語がたくさんあります。

注意:一般の人がすでに知っている用語(預金、引き出し、送金、通貨)はスキップされ、そこに着いたら学べるエキゾチックなコーナーもスキップされます。最も重要な用語に焦点を当てるように努めます。ハンドブックがすでに概念を適切にカバーしている場合は、エントリはそのセクションにリンクされ、繰り返されません。

会計と元帳
  • 元帳(Ledger) - お金の移動の記録システム。残高が派生される真実のソース(複式簿記を参照)。
  • 総勘定元帳 vs 副元帳(General ledger vs sub-ledger) - 単一の統合された帳簿 vs 1つのドメイン(例:ユーザーまたは製品ごと)の詳細な帳簿で、それにロールアップされるもの。
  • 借方 / 貸方(Debit / credit) - 各エントリの両側。どちらが勘定を増加させるかは、勘定のタイプに依存し、「お金の出入り」によるものではありません(複式簿記を参照)。
  • 転記(Posting) - 元帳へのエントリのコミット。「転記済み」とは、記録され、慣例により不変であることを意味します。
  • 勘定科目表(Chart of accounts) - 転記可能な勘定のカタログ。単一のシステムが複数持つことができます(例:法人ごと、帳簿ごと、または報告基準ごと)。
  • 勘定タイプ(Account type) - 資産 / 負債 / 資本(プラス収益 / 費用)。これにより、会計方程式が維持され、各勘定は増加する側が定義されます(複式簿記を参照)。
  • 売掛金 / 買掛金(Receivable / payable) - あなたへの借金 / あなたが負っている借金。
  • IOU - 非公式には、負債:あなたが誰かにお金を借りているという記録。カストディアルプラットフォーム上のユーザーの残高は、プラットフォームからユーザーへのIOUであり、それが帳簿の負債側に位置する理由です。
  • 発生主義 vs 現金主義(Accrual vs cash basis) - お金が実際に移動したときではなく、稼いだときまたは負ったときに認識すること。
  • 試算表(Trial balance) - 元帳全体で総借方が総貸方に等しいかのチェック。
  • 仮勘定 / 決済勘定(Suspense / clearing account) - 輸送中またはまだ帰属できないお金の一時的な保管勘定。
  • 貸倒(Write-off) - 回収が期待できなくなった残高を損失として記帳すること(過払いの処理を参照)。
  • 混同(Commingling) - 会社資金とユーザー資金の混合。規制上の警告信号(監査と監査証跡を参照)。
  • 照合の不一致(Reconciliation break) - 照合によって表面化された単一の未照合の不一致。
お金とFX
  • お金(型として) - 通貨とペアになった金額(通貨処理を参照)。
  • 最小単位(Minor units) - 通貨の最小の分割不可能な単位。金額はしばしばこれらの整数として保存されます(€12.34 → 1234)(精度処理を参照)。
  • ベーシスポイント(bp / "bip") - 1パーセントの100分の1(0.01%)。手数料とレートはこれらの単位で定期的に引用されます。
  • 名目(Notional) - 計算の基盤となる額面価値。実際にやり取りされる現金よりもはるかに大きい場合があります。
  • 法定通貨 vs 仮想通貨(Fiat vs crypto) - 国家発行通貨 vs ブロックチェーンネイティブ資産。
  • ステーブルコイン(Stablecoin) - 通常はUSDのような法定通貨である参照資産にペッグされたトークン。
  • ペッグ / ラップ / ブリッジ(Pegged / wrapped / bridged) - 基盤となる資産に接続されているが、それと同等ではない表現(通貨処理を参照)。
  • ビッド / アスク / スプレッド(Bid / ask / spread) - 買い価格、売り価格、およびその間のギャップ。
  • ミッドマーケットレート(Mid-market rate) - ビッドとアスクの中間点。実際に取引できる価格ではなく、参照点(FXレートを参照)。
  • 参照レート(Reference rate) - 評価と等価性(保有量の価値、税基)に使用されるレート。実際の取引には使用されません(FXレートを参照)。
  • マークトゥマーケット(Mark-to-market) - 取得価格ではなく、現在の市場レートで保有量を再評価すること。
トランザクション、タイミング、決済
  • 評価日 / 記帳日 / 決済日(Value date / booking date / settlement date) - いつ起こったか / いつ記録したか / いつお金が実際に動いたか(評価時刻 vs 記帳時刻 vs 決済時刻を参照)。
  • T+X - 何か(例:決済)が評価日のX営業日後に発生すること(例:T+2)。
  • クリアリング vs 決済(Clearing vs settlement) - 誰が何を負っているかについて合意すること vs 実際にお金を転送すること。
  • 締め切り時間(Cut-off time) - トランザクションが次の決済ウィンドウに繰り越される毎日の締め切り時間。
  • フロート(Float) - 転送中、両方のシステムに存在する(またはどちらにも存在しない)ように見えるお金。
  • ネッティング(Netting) - 各取引を個別に決済するのではなく、多くの債務を単一の正味転送に相殺すること。
  • 遡及日(Backdating) - 記帳日より前の評価日を割り当てること(評価時刻 vs 記帳時刻 vs 決済時刻を参照)。
  • 逆転 / 修正(Reversal / correction) - 経済的に無かったことにするために投稿を完全に無効化すること vs 記録されたものと記録されるべきだったものの差額を記帳すること(逆転と修正を参照)。
決済、レール、カード
  • 決済レール(Payment rail) - 決済が移動する基盤となるネットワーク(SEPA、SWIFT、ACH、カードネットワーク、ブロックチェーン)。
  • IBAN / SWIFT / SEPA / ACH / FPS / CHAPS / wire - 銀行間でお金を移動するための識別子とネットワーク。
  • 発信者 / 受信者(Originator / beneficiary) - 送信者 / 受信者(レミッター/ペイイー、支払い人/ペイイーとも呼ばれる)。
  • PSP(決済サービスプロバイダー) - 1つ以上のレールに接続するベンダー。
  • Nostro / vostroアカウント - 「私たちの銀行にある私たちのお金」/「私たちの銀行にある彼らのお金」。銀行間送金を可能にするアカウント。
  • Omnibusアカウント - 多くのユーザーの資金をまとめて保持する単一のプールされたアカウント。ユーザーごとの残高は内部で追跡されます。混同とは対照的に、正当なプールです。
  • FBO("for benefit of")アカウント - 会社がユーザーのために保持するアカウント。
  • スイープ(Sweep) - スケジュールに基づいてアカウント間で残高を自動的に移動すること(例:コールドストレージまたは利息付きアカウントへ)。
  • チャージバック(Chargeback) - カード所有者の銀行によって開始される、カード決済の強制的な逆転。
  • 発行者 / 決済者(Issuer / acquirer) - カード所有者の銀行 / マーチャントの銀行。
  • インターチェンジ(Interchange) - カード決済ごとにアクワイアラーが発行者に支払う手数料。カード処理コストの大部分。
  • 承認 vs キャプチャ(Authorization vs capture) - 資金の保留を置くこと vs それらを実際に請求すること。カードの世界における資金予約のバージョン(資金予約を参照)。
  • ダンニング(Dunning) - 失敗した定期支払いを回収するための再試行と通知プロセス。
取引と市場
  • オーダーブック(Order book) - 各価格レベルでの未決済の買い(ビッド)と売り(アスク)注文のライブリスト。
  • 成行注文 vs 指値注文(Market vs limit order) - 利用可能な最良の価格で即時実行(流動性を取る) vs 設定した価格またはそれ以上でのみ実行(ブックに残る、流動性を提供する)。
  • メイカー / テーカー(Maker / taker) - メイカーはブックに待機注文を追加し、テーカーはスプレッドを横切り、1つを削除します。手数料は通常異なります。
  • スリッページ(Slippage) - 予想価格と実際に約定した価格との差。
  • 流動性 / 深さ(Liquidity / depth) - 価格が動く前にどれだけ取引できるか。薄いブックはより大きく動きます。
  • 現物(Spot) - 資産自体を即時引き渡しで売買すること。
  • デリバティブ(Derivative) - 資産自体ではなく、基盤となる資産から価値が派生する契約。
  • 先物 / パーペチュアル(perp)(Futures / perpetual (perp)) - 将来の日付で取引する契約 / 満期のない契約で、資金調達率によってスポット価格に近接して維持されるもの。
  • 資金調達率(Funding rate) - ロングとショートの間で定期的に行われる支払い。パーペチュアルの価格をインデックスに連動させます。
  • ロング / ショート(Long / short) - 価格が上昇/下落すると利益が出るポジション。
  • レバレッジ / マージン(Leverage / margin) - 資本よりも大きいポジションを制御すること / ポジションを開いて維持するために預けられた担保。
  • 清算(Liquidation) - マージンが維持要件を下回った場合にポジションを強制的にクローズすること。
  • ヘアカット(Haircut) - 価格変動に対するクッションとして、担保価値に適用される割引。
  • カウンターパーティ(Counterparty) - 取引または契約の相手方。「カウンターパーティリスク」は、彼らが履行しないリスクです。
  • AUM / AUC - 運用資産(プラットフォームが積極的に管理する顧客資産、通常は手数料が発生する委任下) vs 保管資産(単に保管する顧客資産)。同じ保有資産が1つ、もう1つ、または両方になる場合があります。
カストディと仮想通貨
  • カストディ(Custody) - 資産を誰が管理するか:自己カストディ(ユーザーがキーを保持する) vs カストディアル(プラットフォームまたはカストディアンが保持する)。
  • ホット / コールドウォレット(Hot / cold wallet) - キーをオンラインで保持して迅速にアクセスできるようにするもの vs セキュリティのためにオフラインで保持するもの。
  • 秘密鍵 / 公開鍵 / アドレス(Private key / public key / address) - 支出を承認する秘密 / それから派生した公開識別子 / 資金の受け取り場所。
  • シードフレーズ(Seed phrase) - ウォレットのキーを再構築する人間が読めるバックアップ。
  • マルチシグ / MPC(Multisig / MPC) - 複数のキー(またはキーシェア)が転送を承認する必要があるため、単一のデバイスでは資金を移動できないようにするもの。
  • ガス / ネットワーク手数料(Gas / network fee) - ブロックチェーン上のトランザクションを含めるために支払われる手数料。
  • 確認 / ファイナリティ(Confirmation / finality) - トランザクションが含まれるブロックの上に構築されたブロック / それが逆転できなくなる時点。確認数が多いほど、ファイナリティが高まります。
  • リオーグ(Reorg) - 最近確認されたトランザクションを元に戻す可能性のあるブロックチェーンの再編成。ファイナリティが即時でない理由です。
  • メモリプール(Mempool) - ブロックに含まれるのを待っている保留中のトランザクションのプール。
  • UTXO vs アカウントモデル(UTXO vs account model) - Bitcoinスタイルの「コイン全体を使い、お釣りを受け取る」 vs Ethereumスタイルの実行中残高。2つは異なる会計処理を要求します。
  • トークン vs コイン(Token vs coin) - チェーン上で発行された資産(例:ERC-20) vs チェーンのネイティブ資産(BTC、ETH)。
  • ダスト(Dust) - ネットワーク手数料を移動するのにその価値を超えるほど小さい金額。
  • アドレスホワイトリスティング(allow-listing) - 事前に承認されたアドレスのセットへの引き出しを制限すること。
コンプライアンスと規制
  • KYC - Know Your Customer(顧客確認)。ユーザーの身元を確認すること。
  • AML / CFT - Anti-Money-Laundering / Countering the Financing of Terrorism(マネーロンダリング防止 / テロ資金供与対策)。不正資金を検出および防止するための管理措置。
  • 制裁スクリーニング(Sanctions screening) - 当事者を制裁対象リストと照合すること。
  • PEP - politically exposed person(政治的に重要な人物)。追加のデューデリジェンスを必要とする高リスクの顧客カテゴリ。
  • SoF / SoW - source of funds / source of wealth(資金源 / 富源)。顧客のお金がどこから来たかの証拠。
  • トラベルルール(Travel Rule) - しきい値を超える送金について、発信者と受信者の情報を共有する要件。
  • VASP - Virtual Asset Service Provider(仮想資産サービスプロバイダー)。取引所やカストディアンなどの仮想通貨ビジネスの規制上のラベル。
  • MiCA - EUのMarkets in Crypto-Assets規制。
  • 職務分掌(Segregation of duties) - 単一の人物が完了できないように、機密性の高いアクションを複数人に分割すること(職務分掌と4つの目(Segregation of duties and four-eyes)を参照)。
  • 4つの目 / メーカーチェッカー / デュアルコントロール(Four-eyes / maker-checker / dual control) - 機密性の高いアクションが実行される前に、2人目の人物による承認を必要とすること(職務分掌と4つの目(Segregation of duties and four-eyes)を参照)。
  • 最小権限 / RBAC(Least privilege / RBAC) - 各アクターに必要な最小限のアクセス権を付与すること / 個人ごとの付与ではなくロールを通じて管理すること(アクセス制御(Access control)を参照)。
  • 変更管理(Change management) - コードと設定が本番環境に到達する制御された、追跡可能なプロセス(レビュー、承認、デプロイ)(変更追跡(SDLC)(The change trail (SDLC))を参照)。
  • 監査 / 監査証跡(Audit / audit trail) - 帳簿とコントロールが現実に反映されているかの外部審査 / あらゆる残高または決定を再現できる記録履歴(監査と監査証跡(Audits and audit trails)を参照)。
リソース

単一の書籍で金融システム全体を網羅することはできないため、以下のリストはレイヤーごとにグループ化されています。各エントリは、それが何をカバーしているか、そして誰を対象としているかを注記しているため、不足しているものを選択できます。

会計と元帳

決済とカード

  • Payments Systems in the U.S. - 銀行間でお金がどのように移動するか(カード、ACH、ワイヤー、小切手)の参照スタイルのツアー。米国中心。詳細でやや退屈。
  • The Anatomy of the Swipe - カードをタップしてからお金が到着するまでのプロセス。構築者と初心者向け。

市場と取引

仮想通貨

  • Mastering Bitcoin および Mastering Ethereum - 金融エンジニアが遭遇する2つのモデル(UTXOとアカウント)のエンジニアリングレベルのリファレンス。技術的。開発者向け。

エンジニアリング部分

  • Designing Data-Intensive Applications - 冪等性、ログ、一貫性、およびこのハンドブックが繰り返し言及する障害モード。システム側の視点から。

KYCとAML

これらはエンジニア向けではなくコンプライアンス専門家向けに書かれているため、ドメイン自体が必要な場合にのみ参照してください。統合のためではありません。

付録B:エンドツーエンドの例

このハンドブックの本文は各パターンを個別に扱っているため、全体的な理解と直感を構築するのが難しくなっています。この付録では、実際のシステムで見られるものを簡略化された代表的な例として扱う一般的なフローを説明します。本番実装にはより多くのステップ、より多くの障害分岐、およびより多くの簿記が必要になりますが、簡略化されたバージョンで全体像を把握できるはずです。これらは、お金が移動する3つの方向、つまりシステムから外へ(引き出し)、中へ(カード入金)、そして内側で(換算)をカバーしています。

フロー1:仮想通貨の引き出し

ユーザーが外部アドレスに0.5 ETHを引き出すように要求します。これは3つのうちで最もリッチな例です。なぜなら、お金は取り返しのつかない外部効果を通じてシステムから離れていくからです。チェーンが送信を確認したら、それを取り戻すことはできません。

  1. リクエストは冪等性キーとともに到着する。 クライアントは送信を再試行する可能性があります(ネットワークが応答を失った、ユーザーがダブルクリックした)。そのため、最初の懸念は、同じリクエストの2回の配信が1回の引き出しを作成するだけで、2回ではないということです(冪等性を参照)。キーは、このユーザーとこの操作にスコープされています。
  2. 不可逆的なことが起こる前に資金が予約される。 ユーザーの利用可能残高に対して、0.5 ETHと推定ネットワーク手数料を予約します(資金予約を参照)。残高チェックと予約は単一の線形化可能なステップです。そうでなければ、2つの同時引き出しが両方ともチェックをパスし、同じコインで支出を裏付ける可能性があります(不変条件を参照)。ここから、ユーザーの総残高には予約済み金額が含まれますが、利用可能残高には含まれません。
  3. コンプライアンスゲートが実行され、フローはここで数日間スリープする可能性がある。 ブロードキャストする前に、トランザクションをスクリーニングします(制裁、AML、宛先アドレス)。ここでいくつかのパターンを組み合わせます。
    • これは外部呼び出しであるため、遅く、失敗し、または嘘をつく可能性があり、その周りに防御的に構築します(APIの利用を参照)。
    • 手動レビューにエスカレートする可能性があり、数時間または数日かかるため、このステップと次のステップの間でフローがクラッシュしても生き残る必要があります(完全な再開可能性を参照)。その状態は永続化され、独立したドライバーがそれを再開し、その間予約はそのまま維持されます。
    • 日次引き出し限度額がここで強制されます。これは単なる不変条件です(不変条件を参照)。時間ウィンドウがあり、状態を持つ不変条件であるため、予約と同様の原子性の問題があります。2つの引き出しが限度額を競合してパスしても、両方ともパスしてはなりません。
    • すべての決定 - パス、ブロック、誰がオーバーライドしたか - は監査証跡に記録されます(監査と監査証跡を参照)。
  4. トランザクションがオンチェーンでブロードキャストされる。 クリアされたら、ノードを通じて署名してブロードキャストします。これも同様の注意点の対象となる外部呼び出しです。このステップは冪等である必要があります。クラッシュ後の再開は、2回目の送信を盲目的にブロードキャストするのではなく、チェーンを再チェックする必要があります(冪等性を参照、順不同の再試行に関するポイント7)。実際のネットワーク手数料は事前にわからないため、推定額を予約したのです。実際の金額を決済し、残りを解放します。
  5. ファイナリティを待ってから元帳に転記する。 単一の確認は終わりではありません。リオーグは、完了したと宣言した送信を元に戻す可能性があるため、十分な確認を待ちます。その後、複式簿記の移動を転記します。ユーザーのアカウントを借方、外部オンチェーンアカウントを貸方(外部世界にもアカウントが用意されます)、ネットワーク手数料を費用勘定に、サービス手数料を収益勘定に記帳します(複式簿記を参照)。
  6. 夜間ジョブがチェーンと照合する。 上記のフローとは独立して、ジョブが元帳とオンチェーンの現実、およびトランザクションのノードビューを比較します(照合を参照)。これは、ブロードキャストが確認されなかった場合、または記帳した金額と異なる手数料が発生した場合にキャッチするセーフティネットです。

興味深い点:実際のネットワーク手数料が見積もりよりも高くなった場合はどうなるでしょうか?決済はアカウントをマイナスにする可能性があります。過払いを記帳し、明示的に回収します(過払いの処理を参照)。プロセスがブロードキャスト(ステップ4)と確認(ステップ5)の間でクラッシュした場合はどうなるでしょうか?再開可能性と冪等性が、チェーンをクエリして資金を2回送信しないようにすることで、それをピックアップできるようにします。

フロー2:カード入金

ユーザーが決済サービスプロバイダー(PSP)を通じてカードでアカウントに入金します。お金が入ってくるため、ハードな部分は「2回送信しない」から「外部世界が伝えることを信頼しない、そして実際には到着していないお金をクレジットしない」にシフトします。

  1. ユーザーが入金を開始する。 金額を入力し、カード詳細を送信します。そしてPSPとの入金トランザクションを開きます。送信が再試行される可能性があるため、ここでも冪等性キーを使用します。
  2. 承認により保留が置かれる。 PSPはカードを承認し、まだお金をキャプチャせずに保留を置きます。これはカードの世界における資金予約のバージョンです(承認 vs キャプチャ)。まだお金はあなたのものになっていないため、ユーザーの残高はまだクレジットされません。
  3. ウェブフックが「キャプチャ済み」と言う - そしてあなたはそれを何も信じない。 PSPがあなたのウェブフックエンドポイントを呼び出します(ウェブフックの処理を参照)。生のバイトに対する署名を検証し、生のペイロードを永続化し、迅速に2xxで確認し、それから非同期で処理します。重要なのは、ウェブフックを真実ではなく何かが起こったというヒントとして扱うことです。ウェブフックは順不同で到着したり、古いデータを含んだり、重複したり、失われたりする可能性があるため、PSPのAPIに権威ある状態をクエリします。処理は冪等です(冪等性を参照)。再配信された「キャプチャ済み」は、ユーザーに一度だけクレジットします。
  4. クレジットはクリアリング口座を経由する。 お金は移動中です(フロート)。PSPによってキャプチャされましたが、まだあなたの銀行に決済されていません。そのため、お金が実際に到着したと仮定するのではなく、サスペンス/クリアリング口座を経由して転記します。ユーザーの残高を貸方(負債 - ユーザーの残高はあなたからユーザーへのIOUです)とし、PSPの売掛金を借方とします。インターチェンジ/処理手数料は費用として記帳されます。記帳時刻は現在、決済時刻は後で、T+Xです(評価時刻 vs 記帳時刻 vs 決済時刻を参照)。
  5. 決済はバッチとして到着し、照合は1対多である。 数日後、PSPは一度に多くの入金をカバーする単一の転送をあなたの銀行に決済します。そのバッチをクリアリング口座と照合します(照合を参照)。1つの決済を多くのトランザクションにマッチさせます。T+Xの遅延はプロセスに組み込まれているため、まだ決済されていないトランザクションでアラートを出すことはありません。そして、この同じジョブが、ウェブフックがまったく到着しなかった場合にキャッチするものです。
  6. 数週間後、チャージバックが発生する。 カード所有者が支払いに異議を唱え、銀行が逆転を強制します。元の転記を編集するのではなく、リンクされた補償エントリを転記します(逆転と修正を参照)。これは通常、入金よりも後の報告期間に着地し、ユーザーがすでに資金を使い果たしている場合、ユーザーの残高をマイナスにする可能性があります(過払いの処理に戻ります)。

興味深い点:フロー全体は、ハッピーパスのシグナルを信じないことに基づいています。ウェブフックはトリガーであり、事実ではありません。クリアリング口座は、実際にお金が動くまでお金を認識しません。照合は、お互いを信頼するのではなく、PSPとあなた自身の帳簿を照合することによって検証します。すべてのステップは信頼しないの適用です。

フロー3:アプリ内換算とキャッシュバック

ユーザーが1,000ユーロをUSDCに換算し、取引で少額のプロモーションキャッシュバックを獲得します。お金は完全にシステム内で移動するため、信頼性の低い外部レールはありません。代わりに、このフローは表現レイヤー(精度、丸め、通貨、レート)と「データ捏造なし」原則の最も厳しい形式を強調します。

  1. 方向性のある引用と予約。 EUR→USDCのレートを引用します。そのレートはそれ自体の価格であり、USDC→EURの逆ではありません。買いと売りはビッド/アスクスプレッドの両側に位置します(FXレートを参照)。1,000ユーロを予約します(資金予約を参照)。リクエストは、他のすべてのリクエストと同様に、冪等性キーを運びます。
  2. 両側は決して一緒に加えられない。 EURとUSDCは異なる通貨です。実際、USDCは(ネットワーク、コントラクトアドレス)で識別され、ベアコードではなく、それがペッグされている法定通貨とは交換できません(通貨処理を参照)。システムは通貨間の算術演算を禁止します。2つの金額間の唯一の橋は、制御されたレートでの明示的な換算です。
  3. 数学全体で完全な精度を保ち、境界でのみ丸める。 完全な精度を維持して計算し、意図的に選択された戦略で境界でのみ正確に1回丸めます(精度処理および丸め戦略を参照)。あなたが稼ぐスプレッドは収益です。それは複式簿記を通じて明示的に収益勘定に記帳されなければなりません。丸め残差に消えることは許されません(複式簿記を参照)。取引レートは別フィールドとして保存しません。それは2つの金額から導き出されます。後で保有量を評価するために使用するのは、別の参照レートです。
  4. キャッシュバックは「データ捏造なし」の最も厳しいテストである。 ボーナスを無料の残高増加として扱う誘惑がありますが、それは無からお金を鋳造することになります。キャッシュバックは実際のお金です。それは資金調達されなければなりません。つまり、会社のプロモーション/経費勘定からユーザーの残高に、適切な複式簿記転記を通じて移動されなければなりません。それを定義するパーセンテージは、他のすべてと同じように明示的な丸め決定を必要とします(丸め戦略を参照)。
  5. 決済し、信頼性の高い通知を行う。 予約を決済し、すべての移動をタイムスタンプと監査証跡とともに転記し、結果を発行して、システム内の他の部分(明細書、通知、分析)がそれを知るようにします。その発行は、別のチャネルにまたがっていても信頼性がなければなりません。これはアウトボックス(またはCDC、またはイベントログ)が対応するものです(信頼性の高い通知(アウトボックスとCDC)(Notifying reliably (Outbox and CDC))を参照)。下流のコンシューマーは、少なくとも1回の配信であるため、安定したイベントIDで重複排除します。

興味深い点:キャッシュバックとスプレッドは、同じ転記で反対方向に引っ張られます。スプレッドはお金がユーザーからあなたへの(収益)です。キャッシュバックはお金があなたからユーザーへの(費用)です。両方とも実際のお金であり、両方とも帳簿を通過し、両方とも丸められます。したがって、1つのトランザクションは、データ捏造なし(帳簿は依然としてバランスが取れ、何も鋳造されない)とデータ消失なし(すべての残差が追跡される)の両方を同時に満たす必要があります。

付録C:このハンドブックについて

執筆者

私の名前はVoytekで、このハンドブックの著者です。内容は、主に法定通貨と仮想通貨の両方の支払い、会計、管理、および財務管理を中心とした業界での経験に基づいています。また、取引および投資商品についても二次的な経験がありました。

執筆方法

本の大部分は私の手で書かれましたが、多くのこと(磨き上げ、構造化、調査、レビューなど)でAIを活用しました。

この本は生きた文書として意図されており、追加する価値のあるものを見つけたら定期的に更新する予定です。フィードバックは非常に歓迎されており、どこでも共有できますが、GitHub Issuesが最も適切な場所でしょう。

期待されること

本の大部分は「それは依存します」で始まるべきであり、基本的にあらゆる非自明なトピックも同様です。しかし、そのような免責事項は役に立ちません。代わりに、安全なデフォルトのアドバイスと、読者が特定の​​アドバイスが自分の状況に適用されるかどうかを判断するための十分なコンテキストを提供しようとします。

本のコンテンツは私が何かを知っているトピックをカバーしており、ハードコア取引、価格設定、資本市場など、多くのギャップが残っています。しかし、タイトルは一般的で意欲的です。できるだけ多くのFintech分野をカバーしたいと思っています。重要な、広く役立つものが欠けていると思われる場合は、お知らせください。

資料の多く(冪等性、順序付け、再試行、照合)は一般的な分散システムの実践ですが、ここではステークが高い場合にこれらのトピックが重要であり、すべてのFintechエンジニアにとって必須知識であるため含まれています。

この本は思考する読者を念頭に置いて書かれており、誰も盲目的に従うとは想定していません。私の共有するアドバイスよりも、あなたの内部ガイドラインとプラクティスが優先されることは言うまでもありません(ただし、後者は前者について疑問を抱かせる可能性があります)。そして、ここにあるものは法的、コンプライアンス、または財務上のアドバイスではありません。もちろん。

さらにヘルプが必要ですか?

あなたのFintechシステムに固有の何かについて直接のヘルプやアドバイスが必要な場合は、私は少しコンサルティングを行っており、喜んでお手伝いします!