sn_auditor

Crates.iosn_auditor
lib.rssn_auditor
version0.2.2
sourcesrc
created_at2024-03-27 14:52:13.824239
updated_at2024-07-08 15:59:23.170034
descriptionSafe Network Auditor
homepagehttps://maidsafe.net
repositoryhttps://github.com/maidsafe/safe_network
max_upload_size
id1188066
size203,579
MaidSafe-QA (MaidSafe-QA)

documentation

README

sn_auditor

This is a small webserver application that allows you to audit the SAFE Network Currency by gathering a DAG of Spends on the Network.

Usage

Running an auditor instance:

# on a Network with known peers
cargo run --release --peer "/ip4/<network_peer_addr>"

# on a local testnet
cargo run --release --features=local-discovery

It can be run with the following flags:

  -f, --force-from-genesis
          Force the spend DAG to be updated from genesis

  -c, --clean
          Clear the local spend DAG and start from scratch

  -o, --offline-viewer <dag_file>
          Visualize a local DAG file offline, does not connect to the Network

  -b, --beta-participants <discord_names_file>
          Beta rewards program participants to track
          Provide a file with a list of Discord
          usernames as argument

  -k, --beta-encryption-key <hex_secret_key>
          Secret encryption key of the beta rewards to decypher
          discord usernames of the beta participants

The following env var:

# time in seconds UTXOs are refetched in DAG crawl
UTXO_REATTEMPT_INTERVAL=3600

Endpoints

The webserver listens on port 4242 and has the following endpoints:

route description
"/" svg representation of the DAG
"/spend/<addr>" json information about the spend at this addr
"/beta-rewards" json list of beta rewards participants

Note that for the "/" endpoint to work properly you need:

  • to have graphviz installed
  • to enable the svg-dag feature flag (with cargo run --release --features=svg-dag)
Commit count: 4014

cargo fmt