Events

Examples

In [1]:

from ctc import evm

In [3]:

contract_address = '0x956f47f50a910163d8bf957cf5846d573e7f87ca'

Get events by name¶

In [4]:

events = await evm.async_get_events(
    contract_address=contract_address,
    event_name='Transfer',
    verbose=False,
)

events

loading events (92.74MB across 22 files)
getting events from node, block range: [14658263, 14658591]
saving events to file: /home/storm/ctc_data/mainnet/events/contract__0x956f47f50a910163d8bf957cf5846d573e7f87ca/event__0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef/14658263__to__14658591.csv
loading events (92.75MB across 23 files)

Out[4]:

			address	transaction_hash	block_hash	contract_address	event_name	event_hash	arg__from	arg__to	arg__amount	arg__value
block_number	transaction_index	log_index
12168368	61	29	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0xbffb152b9392e38cddc275d818a3db7fe364596b	1302613195326042426081658189	NaN
		32	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	1315770904369739824324907262	NaN
		34	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	0x94b0a3d511b6ecdb17ebf877278ab030acb0a878	1315770904369739824324907262	NaN
		42	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	0x0000000000000000000000000000000000000000	0	NaN
		46	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0xbffb152b9392e38cddc275d818a3db7fe364596b	500000000000000000000	NaN
...	...	...	...	...	...	...	...	...	...	...	...	...
14658400	115	117	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xda65f32b5e6242108395c3068cc2b7e82942348a8b65...	0xfa07d99f6da056a03d3938a6fa546d5151af47390975...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x50e077e4adfddcc376df4e927cd9caeefc860f33	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	NaN	36371791420118343195266
		119	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xda65f32b5e6242108395c3068cc2b7e82942348a8b65...	0xfa07d99f6da056a03d3938a6fa546d5151af47390975...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x50e077e4adfddcc376df4e927cd9caeefc860f33	0x3b983b701406010866bd68331aaed374fb9f50c9	NaN	36997041420118343195
14658404	50	193	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x4bcde413ec849ef04d6b2b8d5dc6e70e28d6c48446eb...	0xb7f374448ed1f7229cb17bc5a3bf8c73977f9b08fd3c...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	0x50e077e4adfddcc376df4e927cd9caeefc860f33	NaN	36371791420118343195266
		195	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x4bcde413ec849ef04d6b2b8d5dc6e70e28d6c48446eb...	0xb7f374448ed1f7229cb17bc5a3bf8c73977f9b08fd3c...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	0x3b983b701406010866bd68331aaed374fb9f50c9	NaN	36997041420118343195
14658570	15	38	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x8dfbbc57f89213b2f49a48bf90b65147fa3bf51479b5...	0xf78f607a339754ff2d897ab91f2c8b63fd9325690e19...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x6481659f0eb0faf4efa8adf4aae45a0b3358b3a1	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	NaN	35000000000000000000000

230832 rows × 10 columns

Get events by hash¶

In [7]:

events = await evm.async_get_events(
    contract_address=contract_address,
    event_hash='0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
    verbose=False,
)

events

Out[7]:

			address	transaction_hash	block_hash	contract_address	event_name	event_hash	arg__from	arg__to	arg__amount	arg__value
block_number	transaction_index	log_index
12168368	61	29	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0xbffb152b9392e38cddc275d818a3db7fe364596b	1302613195326042426081658189	NaN
		32	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	1315770904369739824324907262	NaN
		34	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	0x94b0a3d511b6ecdb17ebf877278ab030acb0a878	1315770904369739824324907262	NaN
		42	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9b0c6299d08fe823f2c0598d97a1141507e4ad86	0x0000000000000000000000000000000000000000	0	NaN
		46	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xc9851f374701f76024c1f44f7166e0ef8a9945675046...	0x3bce142af146fec596340d67569a44688690955a065f...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x0000000000000000000000000000000000000000	0xbffb152b9392e38cddc275d818a3db7fe364596b	500000000000000000000	NaN
...	...	...	...	...	...	...	...	...	...	...	...	...
14658400	115	117	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xda65f32b5e6242108395c3068cc2b7e82942348a8b65...	0xfa07d99f6da056a03d3938a6fa546d5151af47390975...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x50e077e4adfddcc376df4e927cd9caeefc860f33	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	NaN	36371791420118343195266
		119	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xda65f32b5e6242108395c3068cc2b7e82942348a8b65...	0xfa07d99f6da056a03d3938a6fa546d5151af47390975...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x50e077e4adfddcc376df4e927cd9caeefc860f33	0x3b983b701406010866bd68331aaed374fb9f50c9	NaN	36997041420118343195
14658404	50	193	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x4bcde413ec849ef04d6b2b8d5dc6e70e28d6c48446eb...	0xb7f374448ed1f7229cb17bc5a3bf8c73977f9b08fd3c...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	0x50e077e4adfddcc376df4e927cd9caeefc860f33	NaN	36371791420118343195266
		195	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x4bcde413ec849ef04d6b2b8d5dc6e70e28d6c48446eb...	0xb7f374448ed1f7229cb17bc5a3bf8c73977f9b08fd3c...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xbad695d1e786ebb49676b2b7e5eb0ba5e9380dcf	0x3b983b701406010866bd68331aaed374fb9f50c9	NaN	36997041420118343195
14658570	15	38	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x8dfbbc57f89213b2f49a48bf90b65147fa3bf51479b5...	0xf78f607a339754ff2d897ab91f2c8b63fd9325690e19...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x6481659f0eb0faf4efa8adf4aae45a0b3358b3a1	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	NaN	35000000000000000000000

230832 rows × 10 columns

Get events from specific block range¶

In [9]:

events = await evm.async_get_events(
    contract_address=contract_address,
    event_hash='0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
    verbose=False,
    start_block=14000000,
    end_block=14100000,
)

events

Out[9]:

			address	block_hash	transaction_hash	contract_address	event_name	event_hash	arg__from	arg__to	arg__amount
block_number	transaction_index	log_index
14000000	0	25	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x9bff49171de27924fa958faf7b7ce605c1ff0fdee86f...	0x3dac2080b4c423029fcc9c916bc430cde441badfe736...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xbb2e5c2ff298fd96e166f90c8abacaf714df14f8	0x27239549dd40e1d60f5b80b0c4196923745b1fd2	58823967281975952181439
		28	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x9bff49171de27924fa958faf7b7ce605c1ff0fdee86f...	0x3dac2080b4c423029fcc9c916bc430cde441badfe736...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x27239549dd40e1d60f5b80b0c4196923745b1fd2	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	58823967281975952181439
14000003	60	62	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xcd22a09bfd8469b1925d9e19a74cd1c39e07d0806c4c...	0x1582ce5345df47d797d5b80c2cbb38ee0375b2875a61...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x94b0a3d511b6ecdb17ebf877278ab030acb0a878	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	73435661712369422675474
14000005	181	313	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x30cfbe428ed1968e1231798adf0b2ed6b07eeaaab627...	0xd09cf5bfab64ea8e01003ffbe5733e3eaf4f1eaa0f3d...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x94b0a3d511b6ecdb17ebf877278ab030acb0a878	0x9e2336aef4157944f201becd90ccb24e298660cb	14767355748583855822194
14000007	131	139	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x60fff3a3c4b64841f7ead1e4d8b4475fd0b82e79feb9...	0xdf6ef40edf4fd93945fad02033c9eef8445f4430d3d8...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x94b0a3d511b6ecdb17ebf877278ab030acb0a878	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	25820219943704516282552
...	...	...	...	...	...	...	...	...	...	...	...
14099877	158	264	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x1d7f74366a55c8ae48649bab4d1103cbfff27c3cba10...	0x9d6d8a7147e439efa1898a41bc4150b5edad338ead72...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	0xad7575aefd4d64520c3269fd24eae1b0e13dbe7b	531497726956320332900
14099895	92	179	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x30e7fabe4aa9037c9fea24328586b2b8dfa6b87291d3...	0x17ec4301bc5bcc6198edb5883106b79220483c2ee216...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xdf50fbde8180c8785842c8e316ebe06f542d3443	0x220bda5c8994804ac96ebe4df184d25e5c2196d4	39986350026354596022200
		182	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0x30e7fabe4aa9037c9fea24328586b2b8dfa6b87291d3...	0x17ec4301bc5bcc6198edb5883106b79220483c2ee216...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x220bda5c8994804ac96ebe4df184d25e5c2196d4	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	39986350026354596022200
14099898	83	173	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xb2ca06b6226be54c59ff3a47911b0e18e86e2d866a22...	0x5835247355b0797573934bef143ce26396d557c366df...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0x9928e4046d7c6513326ccea028cd3e7a91c7590a	0xfad2a068f5765b7a3fdeef40f98beba5ed346839	24991357207226385107527
		177	0x956f47f50a910163d8bf957cf5846d573e7f87ca	0xb2ca06b6226be54c59ff3a47911b0e18e86e2d866a22...	0x5835247355b0797573934bef143ce26396d557c366df...	0x956f47f50a910163d8bf957cf5846d573e7f87ca	Transfer	0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4...	0xfad2a068f5765b7a3fdeef40f98beba5ed346839	0xdf50fbde8180c8785842c8e316ebe06f542d3443	24972371054263013467815

11996 rows × 9 columns

Reference

async ctc.evm.async_get_events(*, contract_address, start_block=None, end_block=None, backend_order=None, keep_multiindex=True, **query)

Parameters

• contract_address (Address) –

• start_block (BlockNumberReference | None) –

• end_block (BlockNumberReference | None) –

• backend_order (Sequence[str] | None) –

• keep_multiindex (bool) –

• query (Any) –

Return type

DataFrame