From bb26f538ffe088a8c2a0b20fb6baea915461e8b1 Mon Sep 17 00:00:00 2001 From: develoQ Date: Wed, 22 Dec 2021 22:36:30 +0900 Subject: [PATCH] translate invariant-checking --- .../invariant-checking.ja.md | 157 ++++++++++++++++++ dactyl-config.yml | 4 +- 2 files changed, 160 insertions(+), 1 deletion(-) create mode 100644 content/concepts/consensus-network/invariant-checking.ja.md diff --git a/content/concepts/consensus-network/invariant-checking.ja.md b/content/concepts/consensus-network/invariant-checking.ja.md new file mode 100644 index 0000000000..6e8620dca5 --- /dev/null +++ b/content/concepts/consensus-network/invariant-checking.ja.md @@ -0,0 +1,157 @@ +--- +html: invariant-checking.html +parent: consensus-network.html +blurb: 不変性チェックとは何か、なぜ存在するのか、どのように機能するのか、どのような不変性チェックが有効なのかを理解することができます。 +labels: + - ブロックチェーン + - セキュリティ +--- +# 不変性チェック + +不変性チェックは、XRP Ledgerの安全機能です。これは、通常のトランザクション処理とは別に、すべての取引において特定の「不変量」が真であることを保証する一連のチェックで構成されています。 + +多くの安全機能がそうであるように、私たちは不変性チェックが実際に何もする必要がないことを望んでいます。しかし、XRP Ledger の不変量は XRP Ledger のトランザクション処理に対するハードリミットを定義しているため、それを理解することは有用であり、万が一不変量チェックに違反したためにトランザクションが失敗した場合に問題を認識するために有用です。 + +不変性はトリガーされるべきではありませんが、まだ発見されていない、あるいは作成されてもいないバグからXRP Ledgerの整合性を確保するものです。 + + +## なぜ存在するのか + +- XRP Ledgerのソースコードは複雑かつ膨大であり、コードが誤って実行される可能性が高いです。 +- トランザクションを誤って実行した場合のコストは高く、どのような基準でも許容されるものではありません。 + +具体的には、不正なトランザクションの実行により、無効または破損したデータが作成され、後にネットワーク上のサーバーを「動作不可能」な状態にすることで一貫してクラッシュさせ、ネットワーク全体を停止させる可能性があります。 + +不正なトランザクションの処理は、XRP Ledgerの信頼という価値を損なうことになリマス。不変性チェックは、信頼性という機能を付加するため、XRP Ledger 全体に価値を提供します。 + + + +## 仕組み + +不変性チェッカーは、各トランザクションの後にリアルタイムで自動的に実行される第2層のコードです。トランザクションの結果がレジャーにコミットされる前に、不変性チェッカーはそれらの変更が正しいかどうかを検証します。もしトランザクションの結果がXRP Ledgerの厳格なルールに沿わない場合、不変性チェッカーはそのトランザクションを拒否します。このように拒否されたトランザクションは結果コード `tecINVARIANT_FAILED` を持ち、何の効果もなくレジャーに含まれます。 + +トランザクションを `tec` クラスのコードでレジャーに含めるには、何らかの最小限の処理が必要です。この最小限の処理でも不変条件に沿わない場合、トランザクションは `tefINVARIANT_FAILED` というコードで失敗し、レジャーには一切含まれません。 + + +## 有効な不変条件 + +XRP Ledgerは、各トランザクションについて、以下のすべての不変条件をチェックします。 + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L92 "ソース") + +- [トランザクション手数料チェック](#トランザクション手数料チェック) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L118 "ソース") + +- [XRPは作成されません](#XRPは作成されません) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L146 "ソース") + +- [アカウントルートが削除されていない](#アカウントルートが削除されていない) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L173 "ソース") + +- [XRPの残高確認](#XRPの残高確認) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L197 "ソース") + +- [レジャーエントリ形式の一致](#レジャーエントリ形式の一致) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L224 "ソース") + +- [XRPのトラストラインはありません](#XRPのトラストラインはありません) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L251 "ソース") + +- [不正なオファーでない](#不正なオファーでない) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L275 "ソース") + +- [0のエスクローでない](#0のエスクローでない) + +[[ソース]](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h#L300 "ソース") + +- [有効な新規アカウントルート](#有効な新規アカウントルート) + + +### トランザクション手数料チェック + +- **不変条件:** + - [トランザクションコスト](transaction-cost.html)の金額は決してマイナスになってはならず、またトランザクションで指定されたコストより大きくなってはいけません。 + + +### XRPは作成されません + +- **不変条件:** + - トランザクションはXRPを生成してはならず、XRPを破棄するのみです[トランザクションコスト](transaction-cost.html)。 + + +### アカウントルートが削除されていない + +- **不変条件:** + - [アカウント](accounts.html)は、[AccountDeleteトランザクション][]によってのみレジャーから削除することができます。 + - AccountDelete が成功すると、常にちょうど1つのアカウントが削除されます。 + + +### XRPの残高確認 + +- **不変条件:** + - アカウントのXRP残高はXRPの形式である必要があり、0未満または1000億XRPを超えることはできません。 + + +### レジャーエントリ形式の一致 + +- **不変条件:** + - 変更されたレジャーの項目は形式が一致し、追加された項目は[有効なタイプ](ledger-object-types.html)である必要があります。 + + +### XRPのトラストラインはありません + +- **不変条件:** + - XRPを使用した[トラストライン](trust-lines-and-issuing.html)は作成できません。 + + +### 不正なオファーでない + +- **不変条件:** + - [オファー](offer.html#オファー)は負でない金額でなければならず、XRP同士であってはいけません。 + + +### 0のエスクローでない + +- **不変条件:** + - [エスクロー](escrow-object.html)エントリーは、0XRP以上1000億XRP未満を保有している必要があります。 + + +### 有効な新規アカウントルート + +- **不変条件:** + - 新しい[アカウントルート](accountroot.html)は、支払いの結果でなければなりません。 + - 新しいアカウントルートは、正しい開始[シーケンス](basic-data-types.html#アカウントシーケンス)を持たなければなりません。 + - 1つのトランザクションで複数の新しい[アカウント](accounts.html)を作成してはいけません。 + + +## 関連項目 + +- **ブログ:** + - [レジャーの保護: 不変性チェック](https://xrpl.org/blog/2017/invariant-checking.html) + +- **リポジトリ:** + - [Invariant Check.h](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.h) + - [Invariant Check.cpp](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/app/tx/impl/InvariantCheck.cpp) + - [System Parameters](https://github.com/ripple/rippled/blob/develop/src/ripple/protocol/SystemParameters.h#L43) + - [XRP Amount](https://github.com/ripple/rippled/blob/develop/src/ripple/basics/XRPAmount.h#L244) + - [Ledger Formats](https://github.com/ripple/rippled/blob/023f5704d07d09e70091f38a0d4e5df213a3144b/src/ripple/protocol/LedgerFormats.h#L36-L94) + + +- **その他:** + - [Authorized Trust Lines](authorized-trust-lines.html) + - [XRPの特性](xrp.html#XRPの特性) + - [トランザクションの残高変化の計算](https://xrpl.org/blog/2015/calculating-balance-changes-for-a-transaction.html#calculating-balance-changes-for-a-transaction) + + + + +{% include '_snippets/rippled-api-links.md' %} +{% include '_snippets/tx-type-links.md' %} +{% include '_snippets/rippled_versions.md' %} diff --git a/dactyl-config.yml b/dactyl-config.yml index 1a614e9039..e406da79b7 100644 --- a/dactyl-config.yml +++ b/dactyl-config.yml @@ -849,10 +849,12 @@ pages: targets: - ja - # TODO: translate this page and blurb - md: concepts/consensus-network/invariant-checking.md targets: - en + + - md: concepts/consensus-network/invariant-checking.ja.md + targets: - ja # TODO: translate this page and blurb