Eth PeerFlow

Eth PeerFlow is a decentralized emergency coordination and payment network built across Ethereum, PyUSD, Hedera, and Filecoin/IPFS, using Hardhat v3 and libp2p to keep responders, healthcare providers, and insurers connected — even when centralized systems fail.

In real-world crises, centralized APIs, cloud servers, and banking rails often collapse under load. Eth PeerFlow solves this by creating a resilient, peer-to-peer coordination mesh that enables verified responders and institutions to communicate, log incidents, and process stable payments — all without depending on a single centralized service.

Payments are stabilized through PayPal USD (PyUSD), providing instant, low-fee, and dollar-pegged reimbursements to responders and healthcare providers. Hedera Hashgraph serves as a high-throughput trust and reputation layer, anchoring verified incidents and ensuring transparency through verifiable, low-cost smart contract interactions.

At its foundation, Hardhat v3 powers the smart contract infrastructure, managing cross-chain invoice settlement, programmable disbursements, and verification workflows

Built on libp2p, Eth PeerFlow establishes a censorship-resistant communication layer that allows hospitals, responders, and TPAs (Third-Party Administrators) to exchange verified data even during outages. Verified incident reports and claims are stored immutably on Filecoin/IPFS, ensuring permanence, traceability, and auditability.

Every action — from incident creation to payout — is verifiable on-chain, enabling end-to-end transparency and cross-chain accountability. The system is fully programmable, supporting decentralized workflows for insurance automation, disaster relief coordination, and humanitarian finance.

Eth PeerFlow demonstrates how Web3 infrastructure can remain online when the web cannot, delivering a trustless, cross-chain communication and payment fabric that ensures coordination, transparency, and financial integrity — even in moments of global disruption.

Eth PeerFlow was built as a modular, multi-chain system that integrates decentralized networking, smart contract automation, and stablecoin payments to ensure emergency coordination remains functional under real-world stress. The architecture combines Hardhat v3, PayPal USD (PyUSD), Hedera Hashgraph, libp2p, and Filecoin/IPFS, each providing a distinct reliability layer in the stack.

The core smart contracts were developed and deployed using Hardhat v3, which served as the orchestration framework for compiling, testing, and verifying Solidity code. Hardhat’s upgraded task runner, network forking, and deployment pipelines allowed rapid iteration across Ethereum and Hedera EVM testnets.

Payments are stabilized through PayPal USD (PyUSD), enabling instant, low-fee, and dollar-pegged reimbursements to responders and healthcare providers. The InvoiceManager contract manages the entire claims lifecycle—creation, verification, settlement, and audit logging—while integrating with PayPal USD (PyUSD) for on-chain, dollar-pegged disbursements. These PyUSD settlements are handled through escrow contracts to ensure that responders and healthcare providers receive instant, low-volatility payouts.

Hedera Hashgraph was implemented as a high-throughput verification and reputation layer. Incident hashes and verification proofs are anchored via Hedera Consensus Service (HCS), providing timestamped, immutable attestations that complement Ethereum’s financial logic. This hybrid design allows cost-efficient reputation updates and audit trails without overloading EVM gas limits.

For communication resilience, the system uses libp2p, which creates a peer-to-peer mesh network connecting field responders, hospitals, and TPAs. This decentralized messaging layer allows coordination even when APIs or cloud relays fail. Nodes discover each other using libp2p’s pubsub protocol, exchange signed incident data, and route messages over QUIC and WebRTC, maintaining a trustless network fabric.

All evidence and metadata are stored on Filecoin/IPFS, ensuring immutability and long-term accessibility. When incidents are logged, data is serialized, signed, and uploaded to IPFS. The resulting content identifier (CID) is referenced on-chain and optionally backed by Filecoin storage deals for permanence. This design separates high-volume data storage from settlement logic, keeping transactions lightweight while preserving verifiability. The frontend, built with React, Wagmi, and RainbowKit, connects users to Ethereum and Hedera networks, allowing them to log incidents, monitor payments, and verify records directly from the browser. Relayer services bridge events between chains, ensuring that verification results from Hedera trigger PyUSD settlements on Ethereum without manual intervention.

Partner technologies were chosen for reliability and interoperability. Hardhat v3 streamlined development across multiple chains, PyUSD provided stable, real-world value transfers, Hedera offered cost-effective and fast consensus anchoring, libp2p enabled offline-first communication, and Filecoin/IPFS ensured data permanence and integrity.

A notable engineering challenge was achieving smooth communication between Hedera and Ethereum without centralized middleware. This was solved through a lightweight relayer service that listens to on-chain events and writes verification proofs across networks using cryptographic hashes. Another hacky but effective implementation was running local libp2p bootstrap nodes on Dockerized edge devices, allowing responders to create temporary peer networks even in low-connectivity environments.

Overall, Eth PeerFlow integrates on-chain logic, peer-to-peer networking, and decentralized storage into a single, resilient coordination layer. It demonstrates how open Web3 tools—when composed thoughtfully—can maintain verifiable, real-time collaboration and payments even under extreme network constraints.