handle hyperlane messages from Zero Network

[clemsos]

script to handle messages that were stuck during Zero network downtime and never went through

➜  smart-contracts git:(zero-process-handler) ✗ yarn hardhat process-failed-handlers --network zero
⚠️ Using account from DEPLOYER_PRIVATE_KEY environment variable.
Processing 10 transactions from Zero network...

[1/10] Processing 0xbe0edd9cad76e17c16a92adc3b060072eeb82334d1e576a5fed88f027320b3b2...
  Value: 41.11439703472677748 ETH
  DispatchId: 0xc59d605ac224c645ec89369eaca35bb8a8c7bdbeed13ef49592e1d1b0ab4a566
  Decoded HyperlaneMessage:
    Nonce: 36
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 41.107423022671406329 ETH
    Timestamp: 2026-01-19T16:10:06.000Z
  ✅ Processed successfully

[2/10] Processing 0x71192acc62d17e614e6120d92d37ae174d7c98d990018431be1c0bbddd35045a...
  Value: 34.279975396711964711 ETH
  DispatchId: 0x167e84a811f911e74e07f3eb22463342afdc5b11dfd737fa9c4114a7b0b16e57
  Decoded HyperlaneMessage:
    Nonce: 35
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 34.273001384998314642 ETH
    Timestamp: 2026-01-19T15:50:04.000Z
  ✅ Processed successfully

[3/10] Processing 0xe179972961598ca921a1b8a93f84140634a97f0d41772300d4088a76363801df...
  Value: 30.020130681805450166 ETH
  DispatchId: 0x4a610f5989d8fc271a1607845a86cc67333b12bb594a1dfef4a96b63893a48c8
  Decoded HyperlaneMessage:
    Nonce: 34
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 30.013156670304792333 ETH
    Timestamp: 2026-01-19T15:40:05.000Z
  ✅ Processed successfully

[4/10] Processing 0x9e90cc842f020a0eae641c799bf476ab9dd58630ed9314bf1d179b046aecdecc...
  Value: 14.98831862857306723 ETH
  DispatchId: 0xbcd0a96a545740ca9d5fa028c1df0a73b135213f92b291e9f5398f26962dc069
  Decoded HyperlaneMessage:
    Nonce: 33
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 14.981344617824 ETH
    Timestamp: 2026-01-19T14:20:02.000Z
  ✅ Processed successfully

[5/10] Processing 0x38952f6d9097b48b38b44d52eb4d085fc4f28171f1a643d42268d4136bbeac72...
  Value: 14.988552286789078913 ETH
  DispatchId: 0x46bfeed0c01f57570c1a0519d649ed28d141173086cd5443f586f4819846ad25
  Decoded HyperlaneMessage:
    Nonce: 32
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 14.98157827604 ETH
    Timestamp: 2026-01-19T14:10:07.000Z
  ✅ Processed successfully

[6/10] Processing 0xa632c4600c320d2998a7a65132d2ab0723498d81fc3471526cc966594f35f764...
  Value: 28.475824431317683742 ETH
  DispatchId: 0xb6fee7080506dff9d3ccf39744c100f83956718d2a0fe4d827f33f97a18a1fd0
  Decoded HyperlaneMessage:
    Nonce: 31
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 28.468850419894241222 ETH
    Timestamp: 2026-01-19T13:40:06.000Z
  ✅ Processed successfully

[7/10] Processing 0xa1e55f141c9c3446f91b334a67b7d30c179e1f5479210ca6b2284cb47984c272...
  Value: 21.005382454866370422 ETH
  DispatchId: 0x6ef8d2f9cd3e7d03a80908e0f64815b85a84cc2d1fc86152495ebb22f71af321
  Decoded HyperlaneMessage:
    Nonce: 30
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 20.99840844381645 ETH
    Timestamp: 2026-01-19T13:00:03.000Z
  ✅ Processed successfully

[8/10] Processing 0xaf789f9aa4f3328aab2dc0ce4db2144aafed965cd1d4d9085ec7931716074223...
  Value: 26.747898480955150122 ETH
  DispatchId: 0xc009e6f234f55e5411f47189c5c188b4ba29df8c46c385da227f754de1fde2d5
  Decoded HyperlaneMessage:
    Nonce: 27
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 26.740924469618103899 ETH
    Timestamp: 2026-01-18T17:10:05.000Z
  ✅ Processed successfully

[9/10] Processing 0x847d360821203e0e949222d9286b6804d36d14139c4ad61d1f9c2ec37fbad7e9...
  Value: 19.941927914066179056 ETH
  DispatchId: 0xfeebd9028e2154edcc2457b0bf1690728272857f19fb09153f4cfa3b191e7262
  Decoded HyperlaneMessage:
    Nonce: 28
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 19.934953903069431361 ETH
    Timestamp: 2026-01-19T12:40:05.000Z
  ✅ Processed successfully

[10/10] Processing 0x3ed204775f93268a8d1df26abe1e04eaa69b634a9c76be45f87b303ba6e26b1e...
  Value: 19.811455992565607204 ETH
  DispatchId: 0x05de12b5883efa9fd22d375418d306cf468b3120be531cb6278db10d610981a5
  Decoded HyperlaneMessage:
    Nonce: 29
    Recipient: 0xf70da97812CB96acDF810712Aa562db8dfA3dbEF
    Amount: 19.804481981575383105 ETH
    Timestamp: 2026-01-19T12:50:02.000Z
  ✅ Processed successfully


=== Summary ===
Total transactions processed: 10/10
Total amount sent from Zero: 251.373863302377329046 ETH

Prepared 10 processFailedHandler calls
Total amount prepared for processFailedHandler: 251.304123189812122891 ETH
Pool address: 0x57B68c4EA221ee8Da6eb14ebdfcCEE5177567771

=== Getting timelock address ===
Timelock address: 0xf55A9f74e46A667E7CC56180D9669CAeCFB3A2Ce

=== Preparing processFailedHandler calls for pool 0x57B68c4EA221ee8Da6eb14ebdfcCEE5177567771 ===
Prepared 10 processFailedHandler calls for batched submission

=== Submitting batched transactions through timelock ===
Using Safe: 0x1f06b7dd281Ca4D19d3E0f74281dAfDeC3D43963

[julien51]

did you try with the hyperlane cli before?

[clemsos]

did you try with the hyperlane cli before?

Yes but the Hyperlane cli does not support retries. It just show status. I asked in the Hyperlane chat on tg too for them to trigger it but no answer atm

[julien51]

No it does support retries I am pretty sure I did this in the past.

[julien51]

If for any reason the Hyperlane message takes too much time to be processed or it needs to be triggered manually after failures, you can use their cli: hyperlane status --id <hyperlane message id> --relay. You can get the hyperlane message id by looking at the event triggered on the bridging transaction. NB: Hyperlane performs retries but they may take a while.

[clemsos]

ok all processed by retrying

[julien51]

yay! Thx!