ガイド
多通貨と為替レート
あらゆる世界の通貨でのアカウント、トランザクション単位とアカウント単位のレート、プロバイダーの自動フォールバックによるライブレート、暗号資産のサポートについて説明します。
Bluecoins は設計上、多通貨対応のアプリです。アカウントは任意の世界の通貨で建てることができ、各トランザクションは作成時に有効だった為替レートを記録し、アプリは合計とレポートのためにすべてをデフォルト通貨に換算します。暗号資産もアカウント通貨としてサポートされています。
レートの保存方法
レートは 2 つのレベルで適用されます。
- アカウントごとの換算レート — 各アカウントには独自の通貨と、デフォルト通貨に対する換算レートがあり、アカウント設定で設定します。
- トランザクションごとのレート — 外貨のトランザクションを記録すると、フォームはその記録に使用した為替レートを保存し、変更できます。
すべてのトランザクションが独自のレートを持つため、過去の記録は作成したときの値を保ちます。これこそが、EACR トグル が残高をどのように正規化するかを決めるときに考慮する点です。
ライブ為替レート
アプリは現在のレートを自動で取得でき、1 つのプロバイダーが失敗してもレートがなくなることがないように設計されています。
- プロバイダーのフォールバック — レートは一連のプロバイダーから順に試されます。まず無料のプロバイダーが(シャッフルされて)試され、次にバックストップとしてキー付きのプロバイダー、それでもすべて失敗した場合はアプリが 1.0 にフォールバックします。
- 30 秒のキャッシュ — 同じ通貨ペアの検索が短い時間内に繰り返されると、再度ネットワークにアクセスせず、キャッシュされたレートを再利用します。
- サーキットブレーカー — 失敗したプロバイダーはクールダウン期間の間スキップされるため、1 つの遅いまたは停止したサービスが検索を止めることはありません。復旧したプロバイダーは、次に成功した時点で再び試されます。
レートエンジンには 14 のプロバイダーが付属し、無料の法定通貨、キー付きの法定通貨、暗号資産をカバーしています。ベネズエラのボリバル(dolarapi の公式 BCV レートを使用)や、一部の暗号資産ペア向けの Kraken も含まれます。暗号資産から法定通貨へ、また暗号資産から暗号資産への換算がサポートされています(暗号資産のペアは USD を経由して換算されます)。
レポートでの換算
純資産と貸借対照表の合計は、アカウントのレートを使ってデフォルト通貨に換算されるため、外貨の現金でいっぱいの財布も、自分が考える通貨での純資産にきちんと数えられます。EACR トグルは、残高ビューの中で外貨の トランザクション 額をどのように正規化するかを制御します。詳細は EACR ガイド をご覧ください。
同一通貨のショートカット
2 つの実用的な仕様が動作を予測しやすくします。ある通貨をそれ自体に換算すると常に正確に 1.0 を返し(ネットワーク呼び出しはありません)、トランザクションの通貨がアカウントの通貨と一致する場合は換算がまったく不要です。
多通貨はアプリの他のすべてと連携します。異なる通貨のアカウント間のトランスファー、外貨のクレジットカード、アカウントを混在させるレポートなどです。これはレートがレポートではなく記録に付属するためです。