Measuring Time In Cadence

[Previous << JSON-Cadence format](https://qiita.com/flowcadence/items/24135a1ea2f755e7fd19)
[Next >> Testing](https://qiita.com/flowcadence/items/831eeb4521c4b645fb04)

https://qiita.com/flowcadence/items/3073d69c6e9895e68b5a#cadenceの言語仕様を学ぶ

<h1 id="Accessing-Time-From-Cadence">Accessing Time From Cadence</h1>
<br>

[Block Height と Block Timestamp](https://qiita.com/flowcadence/items/f7b6150b33edb466f58b#block-information) はどちらも、Cadenceコード内からアクセス可能です。

つまり、将来のある時点までリソースをロックする必要がある場合や、ある期間の間の値を計算する必要がある場合、あるいは、時間の経過に対処する必要がある場合など、Flow上のスマートコントラクトで日付や期間を計算するために使用できるということです。

ブロックチェーン上で時間を測定する事を利用した一般的戦略が2つあります。

   1. Block Timestampを使用して、攻撃が起きなくするために、直近のnブロックの平均生成時間がブロック目標生成時間に十分に近いことを、任意で確認します。

   2. Block Heightを直接使用します。ブロック高さは直感的に扱うことが出来ます（100ブロック、1000ブロックのように）し、この記事で説明されている方法により、予測タイムスタンプと関連付け、それによってオフチェーンの時間に関連づけます。

<h1 id="Time-On-The-Flow-Blockchain">Time On The Flow Blockchain</h1>


>Flowのブロック生成目標時間は1秒ですが、プロトコルがまだ開発初期段階であり、それを達成する為にさらなる最適化を必要としています。2021年2月現在、メインネット上のブロック確定(block finalization)速度は0.5ブロック/秒以上であり、標準偏差は±0.1ブロック/秒です。したがって、新しいブロックは平均して2秒ごとに確定します。 ブロック確定速度は当然変動するため、ブロックの高さは時間と緩やかな相関関係しか持たないことに注意してください。

上述の自然なばらつきに加え、この関係をさらに歪める可能性があるブロック生成攻撃が理論上いくつか存在します。しかし、Flowではビザンチンノードが存在しないため、これらの攻撃が起きる可能性は低いでしょう。タイムスタンプは、前のブロックのタイムスタンプよりも前になることはできませんし、またあまりにも未来([現在は10秒に設定](https://github.com/onflow/flow-go/blob/master/module/builder/consensus/builder.go#L60))になることも出来ません。

(補足: というチェック処理があるというだけで、タイムスタンプ自体はごく普通のUNIXタイムスタンプです。ブロック高さは揺らぎがあるので、それを敬遠したい場合はタイムスタンプを使用してください)

* これらの条件を満たさないブロック生成の提案は、Flowのコンセンサスアルゴリズムによって拒否されます。しかし、こうした攻撃の可能性があるので、ブロック高さやブロックのタイムスタンプを使用した、オンチェーンのプロトコルレベルのデータからオフチェーンの時間を決定することに、これら追加の信頼の限界があることをここに述べています。

ブロックタイムスタンプは、オフチェーンの時間経過の中でブロックを識別する唯一の方法ではありません。各ブロックは「height」によって連続的に番号付けされ、ブロック70000はブロック70001、70002、70003と続きます。Flowのコンセンサスアルゴリズムでは、連続していない高さのブロックは拒否されます。理論的には、ブロックのタイムスタンプは、Flowの創生ブロックのタイムスタンプとほぼ同等で、さらにブロックの高さに目標ブロック生成速度を掛けたものになるはずです。しかし、これまで見てきたように、目標とチェーン上のブロック生成速度は、時間とともに変動する可能性があります。そのため、このような計算はより難しくなります。

<h1 id="Using-The-Timestamp">Using The Timestamp</h1>

Flowコンセンサスでは、[前のブロックから10秒以上先のタイムスタンプを持つ新しいブロックは拒否される](https://github.com/onflow/flow-go/blob/1e8a2256171d5fd576f442d0c335c9bcc06e1e09/module/builder/consensus/builder.go#L525-L536)ため、10秒未満の精度が必要でない限り、ブロック目標生成速度に変更がない限り、数日間のイベントにはブロックタイムスタンプを使用しても問題ないでしょう。あるいは、より直感的に言えば、タイムスタンプは正しい時間である可能性が高く、正しい分である可能性も高く、正しい秒から10秒以内である可能性も高いでしょう。 これらのスケールのうち、どの程度まで許容できるかは、表現したいイベントがどの程度の期間にわたるかによります。 数日間にわたるオークションであれば、10秒以上の精度があれば十分でしょう。(補足: ブロックタイムスタンプ自体はごく普通のUNIXタイムスタンプです。但し、*秒*以下は削除されています。)
```ruby
/* To get the timestamp of the block that the code is being executed in */
getCurrentBlock().timestamp

/* To get the timestamp of a known previous block, if available */
getBlock(at: 70001)?.timestamp
```

<h1 id="Using-The-Block-Height">Using The Block Height</h1>

理論上、ブロック番号はタイムスタンプよりも信頼性が高い。なぜなら、フォークの各ブロックでブロック高がインクリメントされるからだ。しかし実際には、ブロック番号をオフチェーンの時間値に関連付ける必要があり、そのためには平均的なブロック生成時間が維持されると仮定する必要がある。これは攻撃以外の要因によって変動する可能性がある。ブロック生成時間の目標はFlowの開発が継続するにつれて変化するため、ブロック生成番号を暦時間に関連付けるために行うあらゆる計算に影響を与えることになる。

```ruby
/* To get the block number of the block that the code is being executed in */
getCurrentBlock().height

/* To get the block number of a known previous block, if available */
getBlock(at: 70001)?.height
```

<h1 id="Recommendations">Recommendations</h1>

もし、スマートコントラクトのコードが上記の制限を許容できるのであれば、ブロックタイムスタンプを使用してください。そうでない場合は、より特殊なソリューション（time oracles, etc.）を検討する必要があるかもしれません。

いずれの方法を使用する場合でも、オンチェーン、オフチェーンに関わらず、ブロック生成速度を想定したコードを、後で更新できないやり方でハードコードしないように注意してください。

オンチェーンオークションや類似のメカニズムには、常に延長メカニズムが備わっているべきです。もし誰かが最後の瞬間に入札した場合（これはブロック生成攻撃により容易に行えます）、オークションの終了時間は（必要に応じて）最後の入札からN分間延長されるべきです（10分、30分、1時間）。Nが大きくなるにつれ、この安全性は高まります。N=5は十分すぎるほどです(Flowブロックチェーンの現在のパラメータでは)。

翻訳元

https://cadence-lang.org/docs/measuring-time

***
<b>[Previous << JSON-Cadence format](https://qiita.com/flowcadence/items/24135a1ea2f755e7fd19)
</b>

[Flow blockchain / Cadence version1.0ドキュメント](https://qiita.com/flowcadence/items/3073d69c6e9895e68b5a) (Measuring Time In Cadence)

<b>[Next >> Testing](https://qiita.com/flowcadence/items/831eeb4521c4b645fb04)</b>