Pharos Network Integration

[Wizdave97]

Pharos is an upcoming EVM-compatible L1.

This describes the implementation details for integrating Pharos network with Hyperbridge.
Network Info

1. The active validator set for the network is stored on-chain in a system contract at address 0x4100000000000000000000000000000000000000. More information in the link
   https://silken-muskox-24e.notion.site/Pharos-Staking-Contract-2b18ec314f7580c1b885e2fa8d8a70e9

Mainnet Epoch length: 4 hours
Testnet Epoch Length: 0.5 hours
The validator set is updated in the last block of each epoch, and these changes take effect in the next block, that is, the first block of the new epoch.

A proof for a block can be fetched using the debug_getBlockProof api https://docs.pharosnetwork.xyz/api-and-sdk/json-rpc-api-methods#debug_getblockproof
The response contains the aggregated BLS signature for the block and the public keys of participating validators.

Authority set rotation:
Authority-set rotations occur at the last block of an epoch, so a consensus update for that block must be submitted to the consensus client.

The consensus update for the last block in an epoch should be accompanied by a state proof of the new validator set as recorded in the staking contract described above.

You can check how the Pharos blocks should be verified here
https://github.com/PharosNetwork/examples/blob/main/block-bls-verification/main.go

• Pharos prover
  Fetch block proofs from the debug_BlockProof Api
  For the last block in an epoch fetch a state proof of the new validator set
• Pharos verifier
  Verify bls signature of the block
  Vwerify authority set state proof if the block is an epoch boundary block
• Pharos Ismp Consensus Client
• Pharos tesseract Consensus Client

[Wizdave97]

@dharjeezy will pick this up while @royvardhan works on intent gateway v2

[PolkadotDom]

Was working on this for some practice.. it looks like the debug_getBlockProof RPC call is disabled on both Zan (their suggested provider) and their own RPCs (from the Go snippet) for their Atlantic testnet.

Was looking into parsing extraData from eth_getBlockByNumber myself, but with no specification to be found, I figured it'd just be safer to ask the Pharos team. Does Hyperbridge have a contact there? Alternatively, I could post on the forums.

Or is there something simple Im missing here?

[Wizdave97]

Was working on this for some practice.. it looks like the debug_getBlockProof RPC call is disabled on both Zan (their suggested provider) and their own RPCs (from the Go snippet) for their Atlantic testnet.

Was looking into parsing extraData from eth_getBlockByNumber myself, but with no specification to be found, I figured it'd just be safer to ask the Pharos team. Does Hyperbridge have a contact there? Alternatively, I could post on the forums.

Or is there something simple Im missing here?

The Pharos RPCs are not live yet, we are working based on the specification they provided for when the rpcs will be available.