Get Events

[Previous << Get Block](https://qiita.com/flowcadence/items/023eaeb0632a3ad2b653)
[Next >> Get Collection](https://qiita.com/flowcadence/items/d8a09cefcb361a99826e)

https://qiita.com/flowcadence/items/3073d69c6e9895e68b5a#flow-cli-と-fcl

eventコマンドを使用して、特定の範囲のブロックから単一または複数のイベントを取得することができます。開始ブロック高さと終了ブロック高さの範囲を指定することができますし、特定イベントを検索するために最新ブロックの番号を指定することもできます。イベントは、複数のworkerを使って同時に取得されます。オプションのフラグを指定して制御することもできます。
```ruby
flow events get <event_name>
```

<h1>Example Usage</h1>

イベント名`A.0b2a3299cc857e29.TopShot.Deposit`をメインネット上の最後の20ブロックから取得します。
```ruby
> flow events get A.0b2a3299cc857e29.TopShot.Deposit --last 20 --network mainnet

  Events Block #12913388:
	 Index	 2
	 Type	 A.0b2a3299cc857e29.TopShot.Deposit
	 Tx ID	 0a1e6cdc4eeda0e23402193d7ad5ba01a175df4c08f48fa7ac8d53e811c5357c
	 Values
		 id (UInt64)	3102159
		 to ({}?)	24214cf0faa7844d

	 Index	 2
	 Type	 A.0b2a3299cc857e29.TopShot.Deposit
	 Tx ID	 1fa5e64dcdc8ed5dad87ba58207ee4c058feb38fa271fff659ab992dc2ec2645
	 Values
		 id (UInt64)	5178448
		 to ({}?)	26c96b6c2c31e419

	 Index	 9
	 Type	 A.0b2a3299cc857e29.TopShot.Deposit
	 Tx ID	 262ab3996bdf98f5f15804c12b4e5d4e89c0fa9b71d57be4d7c6e8288c507c4a
	 Values
		 id (UInt64)	1530408
		 to ({}?)	2da5c6d1a541971b

...
```
メインネット上でブロック高の範囲から、`A.1654653399040a61.FlowToken.TokensDeposited`と`A.1654653399040a61.FlowToken.TokensWithdrawn`の2つのイベントを取得します。
```ruby
> flow events get \
  A.1654653399040a61.FlowToken.TokensDeposited \
  A.1654653399040a61.FlowToken.TokensWithdrawn \ 
  --start 11559500 --end 11559600 --network mainnet
  
  Events Block #17015045:
    Index	0
    Type	A.1654653399040a61.FlowToken.TokensWithdrawn
    Tx ID	6dcf60d54036acb52b2e01e69890ce34c3146849998d64364200e4b21e9ac7f1
    Values
		- amount (UFix64): 0.00100000 
		- from (Address?): 0x9e06eebf494e2d78 

    Index	1
    Type	A.1654653399040a61.FlowToken.TokensWithdrawn
    Tx ID	6dcf60d54036acb52b2e01e69890ce34c3146849998d64364200e4b21e9ac7f1
    Values
		- amount (UFix64): 0.00100000 
		- from (Never?): nil 

  Events Block #17015047:
    Index	0
    Type	A.1654653399040a61.FlowToken.TokensWithdrawn
    Tx ID	24979a3c0203f514f7f5822cc8ae7046e24f25d4a775bef697a654898fb7673e
    Values
		- amount (UFix64): 0.00100000 
		- from (Address?): 0x18eb4ee6b3c026d2 

    Index	1
    Type	A.1654653399040a61.FlowToken.TokensWithdrawn
    Tx ID	24979a3c0203f514f7f5822cc8ae7046e24f25d4a775bef697a654898fb7673e
    Values
		- amount (UFix64): 0.00100000 
		- from (Never?): nil
```

<h1>Arguments</h1>

<h3>Event Name</h3>

* Name: `event_name`
* Valid Input: String

イベントの完全識別子。複数のイベント名をスペースで区切って指定することができます。

<h1>Flags</h1>

<h3>Start</h3>

* Flag: `--start`
* Valid inputs: valid block height

開始ブロックの高さをendフラグとともに使用して指定します。これは、ブロック範囲の下限を定義します。

<h3>End</h3>

* Flag: `--end`
* Valid inputs: valid block height

終了ブロックの高さをstartフラグとともに使用して指定します。これは、ブロック範囲の上限を定義します。

<h3>Last</h3>

* lag: `--last`
* Valid inputs: number
* Default: `10`

最後のブロックから起点としたブロック数を指定します。startフラグがセットされている場合は無視されます。何もフラグが指定されていない場合はデフォルト値が使われています。

<h3>Batch</h3>

* Flag: `--batch`
* Valid inputs: number
* Default: `25`

各workerが取得するブロック数。

<h3>Workers</h3>

* Flag: `--workers`
* Valid inputs: number
* Default: `10`

並行してイベントを取得する際に使用するworkerの数。

<h3>Host</h3>

* Flag: `--host`
* Valid inputs: an IP address or hostname.
* Default: `127.0.0.1:3569` (Flow Emulator)

コマンドの実行に使用する Access API のホスト名を指定します。このフラグは、`--network` フラグで定義されたホストをすべて上書きします。

<h3>Network Key</h3>

* Flag: `--network-key`
* Valid inputs: ホストの有効なネットワーク公開鍵の 16 進数文字列

コマンドを実行する際に、セキュアなGRPCクライアントを作成するために使用するAccess APIのネットワーク公開鍵を指定します。

<h3>Network</h3>

* Flag: `--network`
* Short Flag: `-n`
* Valid inputs: the name of a network defined in the configuration (`flow.json`)
* Default: `emulator`

どのネットワークに対してコマンドを実行するのかを指定します。

<h3>Filter</h3>

* Flag: `--filter`
* Short Flag: `-x`
* Valid inputs: a case-sensitive name of the result property.

結果から、唯一の値として取得したいプロパティの名前を指定します。

<h3>Output</h3>

* Flag: `--output`
* Short Flag: `-o`
* Valid inputs: `json`, `inline`

コマンド結果のフォーマットを指定します。

<h3>Save</h3>

* Flag: `--save`
* Short Flag: `-s`
* Valid inputs: a path in the current filesystem.

結果を保存したいファイル名を指定してください。

<h3>Log</h3>

* Flag: `--log`
* Short Flag: `-l`
* Valid inputs: `none`, `error`, `debug`
* Default: `info`

ログレベルを指定します。コマンド実行中に表示する出力を制御します。

<h3>Configuration</h3>

* Flag: `--config-path`
* Short Flag: `-f`
* Valid inputs: a path in the current filesystem.
* Default: `flow.json`

`flow.json` コンフィギュレーションファイルへのパスを指定します。`-f` フラグを複数回使用して複数のコンフィグレーションファイルをマージすることもできます。

<h3>Version Check</h3>

* Flag: `--skip-version-check`
* Default: `false`

低速な接続を避けて処理を高速化するために、起動時のバージョンチェックをスキップします。

*Last updated on **Dec 17, 2024** by **j pimmel***

翻訳元

https://developers.flow.com/tools/flow-cli/get-flow-data/get-events

***
<b>[Previous << Get Block](https://qiita.com/flowcadence/items/023eaeb0632a3ad2b653)
</b>

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

<b>[Next >> Get Collection](https://qiita.com/flowcadence/items/d8a09cefcb361a99826e)</b>