ceremonyclient/go-libp2p/examples/p2p-ping/README.md
Cassandra Heart 53f7c2b5c9
v2.1.0.2 (#442)
* v2.1.0.2

* restore tweaks to simlibp2p

* fix: nil ref on size calc

* fix: panic should induce shutdown from event_distributor

* fix: friendlier initialization that requires less manual kickstarting for test/devnets

* fix: fewer available shards than provers should choose shard length

* fix: update stored worker registry, improve logging for debug mode

* fix: shut the fuck up, peer log

* qol: log value should be snake cased

* fix:non-archive snap sync issues

* fix: separate X448/Decaf448 signed keys, add onion key to registry

* fix: overflow arithmetic on frame number comparison

* fix: worker registration should be idempotent if inputs are same, otherwise permit updated records

* fix: remove global prover state from size calculation

* fix: divide by zero case

* fix: eager prover

* fix: broadcast listener default

* qol: diagnostic data for peer authenticator

* fix: master/worker connectivity issue in sparse networks

tight coupling of peer and workers can sometimes interfere if mesh is sparse, so give workers a pseudoidentity but publish messages with the proper peer key

* fix: reorder steps of join creation

* fix: join verify frame source + ensure domain is properly padded (unnecessary but good for consistency)

* fix: add delegate to protobuf <-> reified join conversion

* fix: preempt prover from planning with no workers

* fix: use the unallocated workers to generate a proof

* qol: underflow causes join fail in first ten frames on test/devnets

* qol: small logging tweaks for easier log correlation in debug mode

* qol: use fisher-yates shuffle to ensure prover allocations are evenly distributed when scores are equal

* qol: separate decisional logic on post-enrollment confirmation into consensus engine, proposer, and worker manager where relevant, refactor out scoring

* reuse shard descriptors for both join planning and confirm/reject decisions

* fix: add missing interface method and amend test blossomsub to use new peer id basis

* fix: only check allocations if they exist

* fix: pomw mint proof data needs to be hierarchically under global intrinsic domain

* staging temporary state under diagnostics

* fix: first phase of distributed lock refactoring

* fix: compute intrinsic locking

* fix: hypergraph intrinsic locking

* fix: token intrinsic locking

* fix: update execution engines to support new locking model

* fix: adjust tests with new execution shape

* fix: weave in lock/unlock semantics to liveness provider

* fix lock fallthrough, add missing allocation update

* qol: additional logging for diagnostics, also testnet/devnet handling for confirmations

* fix: establish grace period on halt scenario to permit recovery

* fix: support test/devnet defaults for coverage scenarios

* fix: nil ref on consensus halts for non-archive nodes

* fix: remove unnecessary prefix from prover ref

* add test coverage for fork choice behaviors and replay – once passing, blocker (2) is resolved

* fix: no fork replay on repeat for non-archive nodes, snap now behaves correctly

* rollup of pre-liveness check lock interactions

* ahead of tests, get the protobuf/metrics-related changes out so teams can prepare

* add test coverage for distributed lock behaviors – once passing, blocker (3) is resolved

* fix: blocker (3)

* Dev docs improvements (#445)

* Make install deps script more robust

* Improve testing instructions

* Worker node should stop upon OS SIGINT/SIGTERM signal (#447)

* move pebble close to Stop()

* move deferred Stop() to Start()

* add core id to worker stop log message

* create done os signal channel and stop worker upon message to it

---------

Co-authored-by: Cassandra Heart <7929478+CassOnMars@users.noreply.github.com>

---------

Co-authored-by: Daz <daz_the_corgi@proton.me>
Co-authored-by: Black Swan <3999712+blacks1ne@users.noreply.github.com>
2025-10-23 01:03:06 -05:00

2.1 KiB

P2P Ping Tool

A libp2p client tool for testing peer connectivity by pinging multiple peers from a list of multiaddresses.

Features

  • Batch ping testing: Read multiaddresses from stdin and ping each once
  • DNS resolution: Supports DNS-based multiaddresses (e.g., /dns/example.com/...)
  • Real-time reporting: Shows success/failure for each address immediately
  • Summary statistics: Displays overall success rate
  • Client-only: Lightweight client that doesn't listen for incoming connections

Usage

From stdin (interactive)

go run .
# Enter multiaddresses one per line, then Ctrl+D

From file

go run . < addresses.txt

From command line

echo "/ip4/127.0.0.1/tcp/4001/p2p/12D3KooW..." | go run .

Multiple addresses

cat << EOF | go run . -timeout 5s
/ip4/127.0.0.1/tcp/4001/p2p/12D3KooWExample1
/dns/bootstrap.example.com/udp/8336/quic-v1/p2p/12D3KooWExample2
/ip6/::1/tcp/4001/p2p/12D3KooWExample3
EOF

Options

  • -timeout duration: Connection and ping timeout (default: 10s)

Output Format

P2P Ping Tool - Reading multiaddresses from stdin...
Client started (ID: 12D3KooW...)
=============================================================
[1] Testing: /ip4/127.0.0.1/tcp/4001/p2p/12D3KooWExample
    ✓ SUCCESS - RTT: 15ms

[2] Testing: /dns/unreachable.com/tcp/4001/p2p/12D3KooWBad
    ✗ FAILED - DNS resolution failed: lookup unreachable.com...

=============================================================
Summary: 2 addresses tested
Successful: 1/2 (50.0%)

Supported Multiaddr Formats

  • IPv4: /ip4/127.0.0.1/tcp/4001/p2p/[PEER_ID]
  • IPv6: /ip6/::1/tcp/4001/p2p/[PEER_ID]
  • DNS: /dns/example.com/tcp/4001/p2p/[PEER_ID]
  • DNS with QUIC: /dns/example.com/udp/8336/quic-v1/p2p/[PEER_ID]

Error Handling

The tool provides detailed error messages for common failure scenarios:

  • Invalid multiaddr: Malformed multiaddress syntax
  • DNS resolution failed: DNS hostname cannot be resolved
  • Connection failed: Cannot establish connection to peer
  • Ping failed: Connected but ping protocol failed