跳转至

Eth 2.0 信标 API

原文:https://web3py.readthedocs.io/en/stable/web3.beacon.html

警告

这个 API 是实验性的。客户端支持是不完整的，API 本身仍在发展。

要使用这个 API，您需要一个本地或远程运行的信标节点。要进行设置，请参考您的特定客户端的文档。

有了正在运行的信标节点后，导入并配置信标实例:

>>> from web3.beacon import Beacon
>>> beacon = Beacon("http://localhost:5051")

方法

Beacon.get_genesis()

>>> beacon.get_genesis()
{
 'data': {
 'genesis_time': '1605700807',
 'genesis_validators_root': '0x9436e8a630e3162b7ed4f449b12b8a5a368a4b95bc46b941ae65c11613bfa4c1',
 'genesis_fork_version': '0x00002009'
 }
} 

Beacon.get_hash_root(*state_id="head"*)

>>> beacon.get_hash_root()
{
 "data": {
 "root":"0xbb399fda70617a6f198b3d9f1c1cdbd70077677231b84f34e58568c9dc903558"
 }
} 

Beacon.get_fork_data(*state_id="head"*)

>>> beacon.get_fork_data()
{
 'data': {
 'previous_version': '0x00002009',
 'current_version': '0x00002009',
 'epoch': '0'
 }
} 

Beacon.get_finality_checkpoint(*state_id="head"*)

>>> beacon.get_finality_checkpoint()
{
 'data': {
 'previous_justified': {
 'epoch': '5024',
 'root': '0x499ba555e8e8be639dd84be1be6d54409738facefc662f37d97065aa91a1a8d4'
 },
 'current_justified': {
 'epoch': '5025',
 'root': '0x34e8a230f11536ab2ec56a0956e1f3b3fd703861f96d4695877eaa48fbacc241'
 },
 'finalized': {
 'epoch': '5024',
 'root': '0x499ba555e8e8be639dd84be1be6d54409738facefc662f37d97065aa91a1a8d4'
 }
 }
} 

Beacon.get_validators(*state_id="head"*)

>>> beacon.get_validators()
 {
 'data': [
 {
 'index': '110280',
 'balance': '32000000000',
 'status': 'pending_queued',
 'validator': {
 'pubkey': '0x99d37d1f7dd15859995330f75c158346f86d298e2ffeedfbf1b38dcf3df89a7dbd1b34815f3bcd1b2a5588592a35b783',
 'withdrawal_credentials': '0x00f338cfdb0c22bb85beed9042bd19fff58ad6421c8a833f8bc902b7cca06f5f',
 'effective_balance': '32000000000',
 'slashed': False,
 'activation_eligibility_epoch': '5029',
 'activation_epoch': '18446744073709551615',
 'exit_epoch': '18446744073709551615',
 'withdrawable_epoch': '18446744073709551615'
 }
 },
 ...
 ]
 } 

Beacon.get_validator(*validator_id*, *state_id="head"*)

>>> beacon.get_validator(110280)
{
 'data': {
 'index': '110280',
 'balance': '32000000000',
 'status': 'pending_queued',
 'validator': {
 'pubkey': '0x99d37d1f7dd15859995330f75c158346f86d298e2ffeedfbf1b38dcf3df89a7dbd1b34815f3bcd1b2a5588592a35b783',
 'withdrawal_credentials': '0x00f338cfdb0c22bb85beed9042bd19fff58ad6421c8a833f8bc902b7cca06f5f',
 'effective_balance': '32000000000',
 'slashed': False,
 'activation_eligibility_epoch': '5029',
 'activation_epoch': '18446744073709551615',
 'exit_epoch': '18446744073709551615',
 'withdrawable_epoch': '18446744073709551615'
 }
 }
} 

Beacon.get_validator_balances(*state_id="head"*)

>>> beacon.get_validator_balances()
{
 'data': [
 {
 'index': '110278',
 'balance': '32000000000'
 },
 ...
 ]
} 

Beacon.get_epoch_committees(*state_id="head"*)

>>> beacon.get_epoch_committees()
{
 'data': [
 {
 'slot': '162367',
 'index': '25',
 'validators': ['50233', '36829', '84635', ...],
 },
 ...
 ]
} 

Beacon.get_block_headers()

>>> beacon.get_block_headers()
{
 'data': [
 {
 'root': '0xa3873e7b1e0bcc7c59013340cfea59dff16e42e79825e7b8ab6c243dbafd4fe0',
 'canonical': True,
 'header': {
 'message': {
 'slot': '163587',
 'proposer_index': '69198',
 'parent_root': '0xc32558881dbb791ef045c48e3709a0978dc445abee4ae34d30df600eb5fbbb3d',
 'state_root': '0x4dc0a72959803a84ee0231160b05dda76a91b8f8b77220b4cfc7db160840b8a8',
 'body_root': '0xa3873e7b1e0bcc7c59013340cfea59dff16e42e79825e7b8ab6c243dbafd4fe0'
 },
 'signature': '0x87b549448d36e5e8b1783944b5511a05f34bb78ad3fcbf71a1adb346eed363d46e50d51ac53cd23bd03d0107d064e05913a6ef10f465f9171aba3b2b8a7a4d621c9e18d5f148813295a2d5aa5053029ccbd88cec72130833de2b4b7addf7faca'
 }
 }
 ]
} 

Beacon.get_block_header(*block_id*)

>>> beacon.get_block_header(1)
{
 'data': {
 root': '0x30c04689dd4f6cd4d56eb78f72727d2d16d8b6346724e4a88f546875f11b750d',
 'canonical': True,
 'header': {
 'message': {
 'slot': '1',
 'proposer_index': '61090',
 'parent_root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87',
 'state_root': '0x7773ed5a7e944c6238cd0a5c32170663ef2be9efc594fb43ad0f07ecf4c09d2b',
 'body_root': '0x30c04689dd4f6cd4d56eb78f72727d2d16d8b6346724e4a88f546875f11b750d'
 },
 'signature': '0xa30d70b3e62ff776fe97f7f8b3472194af66849238a958880510e698ec3b8a470916680b1a82f9d4753c023153fbe6db10c464ac532c1c9c8919adb242b05ef7152ba3e6cd08b730eac2154b9802203ead6079c8dfb87f1e900595e6c00b4a9a'
 }
 }
} 

Beacon.get_block(*block_id*)

>>> beacon.get_block(1)
{
 'data': {
 'message': {
 'slot': '1',
 'proposer_index': '61090',
 'parent_root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87',
 'state_root': '0x7773ed5a7e944c6238cd0a5c32170663ef2be9efc594fb43ad0f07ecf4c09d2b',
 'body': {
 'randao_reveal': '0x8e245a52a0a680fcfe789013e123880c321f237de10cad108dc55dd47290d7cfe50cdaa003c6f783405efdac48cef44e152493abba40d9f9815a060dd6151cb0635906c9e3c1ad4859cada73ccd2d6b8747e4aeeada7d75d454bcc8672afa813',
 'eth1_data': {
 'deposit_root': '0x4e910ac762815c13e316e72506141f5b6b441d58af8e0a049cd3341c25728752',
 'deposit_count': '100596',
 'block_hash': '0x89cb78044843805fb4dab8abd743fc96c2b8e955c58f9b7224d468d85ef57130'
 },
 'graffiti': '0x74656b752f76302e31322e31342b34342d673863656562663600000000000000',
 'proposer_slashings': [],
 'attester_slashings': [],
 'attestations': [
 {
 'aggregation_bits': '0x0080020004000000008208000102000905',
 'data': {
 'slot': '0',
 'index': '7',
 'beacon_block_root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87',
 'source': {
 'epoch': '0',
 'root': '0x0000000000000000000000000000000000000000000000000000000000000000'
 },
 'target': {
 'epoch': '0',
 'root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87'
 }
 },
 'signature': '0x967dd2946358db7e426ed19d4576bc75123520ef6a489ca50002222070ee4611f9cef394e5e3071236a93b825f18a4ad07f1d5a1405e6c984f1d71e03f535d13a2156d6ba22cb0c2b148df23a7b8a7293315d6e74b9a26b64283e8393f2ad4c5'
 }
 ],
 'deposits': [],
 'voluntary_exits': []
 }
 },
 'signature': '0xa30d70b3e62ff776fe97f7f8b3472194af66849238a958880510e698ec3b8a470916680b1a82f9d4753c023153fbe6db10c464ac532c1c9c8919adb242b05ef7152ba3e6cd08b730eac2154b9802203ead6079c8dfb87f1e900595e6c00b4a9a'
 }
} 

Beacon.get_block_root(*block_id*)

>>> beacon.get_block_root(1)
{
 'data': {
 'root': '0x30c04689dd4f6cd4d56eb78f72727d2d16d8b6346724e4a88f546875f11b750d'
 }
} 

Beacon.get_block_attestations(*block_id*)

>>> beacon.get_block_attestations(1)
{
 'data': [
 {
 'aggregation_bits': '0x0080020004000000008208000102000905',
 'data': {
 'slot': '0',
 'index': '7',
 'beacon_block_root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87',
 'source': {
 'epoch': '0',
 'root': '0x0000000000000000000000000000000000000000000000000000000000000000'
 },
 'target': {
 'epoch': '0',
 'root': '0x6a89af5df908893eedbed10ba4c13fc13d5653ce57db637e3bfded73a987bb87'
 }
 },
 'signature': '0x967dd2946358db7e426ed19d4576bc75123520ef6a489ca50002222070ee4611f9cef394e5e3071236a93b825f18a4ad07f1d5a1405e6c984f1d71e03f535d13a2156d6ba22cb0c2b148df23a7b8a7293315d6e74b9a26b64283e8393f2ad4c5'
 },
 ...
 ]
} 

Beacon.get_attestations()

>>> beacon.get_attestations()
{'data': []} 

Beacon.get_attester_slashings()

>>> beacon.get_attester_slashings()
{'data': []} 

Beacon.get_proposer_slashings()

>>> beacon.get_proposer_slashings()
{'data': []} 

Beacon.get_voluntary_exits()

>>> beacon.get_voluntary_exits()
{'data': []} 

Beacon.get_fork_schedule()

>>> beacon.get_fork_schedule()
{
 'data': [
 {
 'previous_version': '0x00002009',
 'current_version': '0x00002009',
 'epoch': '0'
 }
 ]
} 

Beacon.get_spec()

>>> beacon.get_spec()
{
 'data': {
 'DEPOSIT_CONTRACT_ADDRESS': '0x8c5fecdC472E27Bc447696F431E425D02dd46a8c',
 'MIN_ATTESTATION_INCLUSION_DELAY': '1',
 'SLOTS_PER_EPOCH': '32',
 'SHUFFLE_ROUND_COUNT': '90',
 'MAX_EFFECTIVE_BALANCE': '32000000000',
 'DOMAIN_BEACON_PROPOSER': '0x00000000',
 'MAX_ATTESTER_SLASHINGS': '2',
 'DOMAIN_SELECTION_PROOF': '0x05000000',
 ...
 }
} 

Beacon.get_deposit_contract()

>>> beacon.get_deposit_contract()
{
 'data': {
 'chain_id': '5',
 'address': '0x8c5fecdc472e27bc447696f431e425d02dd46a8c'
 }
} 

Beacon.get_beacon_state(*state_id="head"*)

>>> beacon.get_beacon_state()
{
 'data': {
 'genesis_time': '1',
 'genesis_validators_root': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2',
 'slot': '1',
 'fork': {
 'previous_version': '0x00000000',
 'current_version': '0x00000000',
 'epoch': '1'
 },
 'latest_block_header': {
 'slot': '1',
 'proposer_index': '1',
 'parent_root': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2',
 'state_root': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2',
 'body_root': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2'
 },
 'block_roots': ['0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2'],
 'state_roots': ['0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2'],
 'historical_roots': ['0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2'],
 'eth1_data': {
 'deposit_root': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2',
 'deposit_count': '1',
 'block_hash': '0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2'
 },
 'eth1_data_votes': [...],
 'eth1_deposit_index': '1',
 'validators': [...],
 'balances': [...],
 'randao_mixes': [...],
 'slashings': [...],
 'previous_epoch_attestations': [...],
 'current_epoch_attestations': [...],
 'justification_bits': '0x0f',
 'previous_justified_checkpoint': {
 'epoch': '5736',
 'root': '0xec7ef54f1fd81bada8170dd0cb6be8216f8ee2f445e6936f95f5c6894a4a3b38'
 },
 'current_justified_checkpoint': {
 'epoch': '5737',
 'root': '0x781f0166e34c361ce2c88070c1389145abba2836edcb446338a2ca2b0054826e'
 },
 'finalized_checkpoint': {
 'epoch': '5736',
 'root': '0xec7ef54f1fd81bada8170dd0cb6be8216f8ee2f445e6936f95f5c6894a4a3b38'
 }
 }
} 

Beacon.get_beacon_heads()

>>> beacon.get_beacon_heads()
{
 'data': [
 {
 'slot': '221600',
 'root': '0x9987754077fe6100a60c75d81a51b1ef457d019404d1546a66f4f5d6c23fae45'
 }
 ]
} 

Beacon.get_node_identity()

>>> beacon.get_node_identity()
{
 'data': {
 'peer_id': '16Uiu2HAmLZ1CYVFKpa3wwn4cnknZqosum8HX3GHDhUpEULQc9ixE',
 'enr': 'enr:-KG4QCIp6eCZ6hG_fd93qsw12qmbfsl2rUTfQvwVP4FOTlWeNXYo0Gg9y3WVYIdF6FQC6R0E8CbK0Ywq_6TKMx1BpGlAhGV0aDKQOwiHlQAAIAn__________4JpZIJ2NIJpcIR_AAABiXNlY3AyNTZrMaEDdVT4g1gw86BfbrtLCq2fRBlG0AnMxsXtAQgA327S5FeDdGNwgiMog3VkcIIjKA',
 'p2p_addresses': ['/ip4/127.0.0.1/tcp/9000/p2p/16Uiu2HAmLZ1CYVFKpa3wwn4cnknZqosum8HX3GHDhUpEULQc9ixE'],
 'discovery_addresses': ['/ip4/127.0.0.1/udp/9000/p2p/16Uiu2HAmLZ1CYVFKpa3wwn4cnknZqosum8HX3GHDhUpEULQc9ixE'],
 'metadata': {'seq_number': '0', 'attnets': '0x0000000000000000'}
 }
} 

Beacon.get_peers()

>>> beacon.get_peers()
{
 'data': [
 {
 'peer_id': '16Uiu2HAkw1yVqF3RtMCBHMbkLZbNhfGcTUdD6Uo4X3wfzPhGVnqv',
 'address': '/ip4/3.127.23.51/tcp/9000',
 'state': 'connected',
 'direction': 'outbound'
 },
 {
 'peer_id': '16Uiu2HAmEJHiCzgS8GwiEYLyM3d148mzvZ9iZzsz8yqayWVPANMG',
 'address': '/ip4/3.88.7.240/tcp/9000',
 'state': 'connected',
 'direction': 'outbound'
 }
 ]
} 

Beacon.get_peer(*peer_id*)

>>> beacon.get_peer('16Uiu2HAkw1yVqF3RtMCBHMbkLZbNhfGcTUdD6Uo4X3wfzPhGVnqv')
{
 'data': {
 'peer_id': '16Uiu2HAkw1yVqF3RtMCBHMbkLZbNhfGcTUdD6Uo4X3wfzPhGVnqv',
 'address': '/ip4/3.127.23.51/tcp/9000',
 'state': 'connected',
 'direction': 'outbound'
 }
} 

Beacon.get_health()

>>> beacon.get_health()
200 

Beacon.get_version()

>>> beacon.get_version()
{
 'data': {
 'version': 'teku/v20.12.0+9-g9392008/osx-x86_64/adoptopenjdk-java-15'
 }
} 

Beacon.get_syncing()

>>> beacon.get_syncing()
{
 'data': {
 'head_slot': '222270',
 'sync_distance': '190861'
 }
}
回到顶部