ZecHub

Mɔfialawo

Nunyala siwo woɖo ɖe ɖoɖo nu be nàse Zcash ƒe ɖoɖowo gɔme

Mɔfialawo:

Zcash Network Ƒe Nɔnɔmetata

Esia nye mɔfiame tso ale si nàwɔ Ziggurat 3.0 Crawler na Zcash kple ɖoɖowɔwɔ siwo do ɖeka kplii, Crunchy kple P2P-Viz, le Ubuntu 22.04 dzi be nàxɔ eye nàɖe Zcash network ƒe nyatakakawo fia.
Video si ƒe link le ete la wɔa mɔnu ma ke.

Ɖo Hiahiãwo:

Rust -> https://rustup.rs/

Esi Wodi O:

jq -> https://jqlang.github.io/jq/download/ (be nàɖe json nyatakakawo fia le terminal me)

curl -> https://everything.curl.dev/install/linux.html (be nàbia nyatakaka tso crawler RPC dzi)

npm (kple nvm) -> https://medium.com/@iam_vinojan/how-to-install-node-js-and-npm-using-node-version-manager-nvm-143165b16ce1 (be nàɖe P2P-Viz fia le browser me)

Ziggurat 3.0 Ƒe Repository | https://github.com/runziggurat

Crawler Ƒe Repo | https://github.com/runziggurat/zcash.git

Crunchy Ƒe Repo | https://github.com/runziggurat/crunchy.git

P2P-Viz Ƒe Repo | https://github.com/runziggurat/p2p-viz.git

Dze egɔme kple update siwo wozãna ɣesiaɣi.

Wɔ seɖoɖowo:

Code-highlight

sudo apt update
sudo apt upgrade

Zcash Network Crawler

Zcash Crawler le folder si woyɔ be 'zcash' me, eyata anyo be nàwɔ directory yeye hafi nàclone crawler la (runziggurat/zcash repo).

Tso /Home directory me, wɔ seɖoɖowo:

Code-highlight

mkdir runziggurat
cd runziggurat
git clone https://github.com/runziggurat/zcash.git
cd zcash

Yi browser me ɖe https://github.com/runziggurat/zcash/blob/main/src/tools/crawler/README.md

Alo ʋu readme le '/runziggurat/zcash/src/tools/crawler/README.md'

Axa sia me nya le ale si nàzãe tɔxɛ.

Code-highlight

$ cargo run --release --features crawler --bin crawler -- --help

OPTIONS:
    -c, --crawl-interval <CRAWL_INTERVAL>
            The main crawling loop interval in seconds [default: 5]

    -h, --help
            Print help information

    -r, --rpc-addr <RPC_ADDR>
            If present, start an RPC server at the specified address

    -s, --seed-addrs <SEED_ADDRS>...
            A list of initial standalone IP addresses and/or DNS servers to connect to

    -n, --node-listening-port <NODE_LISTENING_PORT>
            Default port used for connecting to the nodes [default: 8233]

    -V, --version
            Print version information

--seed-addrs \ --dns-seed nye argument si wodi ɖeka pɛ, eye ele be gaɖoƒe ƒe dzesi Ɖeka aɖe nàɖo ɖe eme hafi wòate ŋu adu.

Seɖoɖo 'cargo run --release --features crawler --bin crawler -- --help' nye seɖoɖo tututɔ si nadzɔ, eye wòaɖe kpekpeɖeŋu menu si wowɔ fia la afia.

Wɔ seɖoɖo

Code-highlight

cargo run --release --features crawler --bin crawler -- --help

Esia aɖo program la ƒe akpa siwo hiã eye wòaɖe kpe edzi be nu sia nu le dɔ wɔm nyuie.

Be nàdu Crawler la, ele be nàtsɔ '--seed-addrs' flag akpe ɖe seɖoɖo si dzɔna la ŋu, si me gaɖoƒe ƒe dzesi Ɖeka le sue wu, si le vavã, si nye Zcash ɣaɣla dzesi ŋɔŋlɔ ƒe IP gaɖoƒe ƒe dzesi. Ele be nàna Crawler la naƒo du ɣeyiɣi si nam akpa be nàxɔ emetsonu si sɔ. Àte ŋu akpɔ ɣaɣla dzesi ŋɔŋlɔ ƒe IP gaɖoƒe ƒe dzesi ƒe kpɔɖeŋu aɖewo le https://mainnet.zcashexplorer.app/nodes.

Be nàxɔ nyatakaka tso Crawler la gbɔ esi wòle dɔ wɔm la, ele be nàtsɔ '--rpc-addr' flag akpe ɖe seɖoɖo si dzɔna la ŋu. Menye be ele vevie be nàwɔ esia hafi Crawler la aɖe du o, gake ne mèwɔe o la, ele be nàtɔ Crawler la (ctrl+c alo SIGKILL) hafi àte ŋu aɖe nyatakaka aɖeke fia.

Wɔ seɖoɖo

Code-highlight

cargo run --release --features crawler --bin crawler -- --seed-addrs 157.245.172.190:8233 194.135.81.61:8233 35.233.224.178:8233 --rpc-addr 127.0.0.1:54321

Crawler la ade asi adi alɔ̃lɔ̃ kple network la (le ɣeyiɣi 20 sia 20 me le gɔmedzedze me) eye wòaxɔ network ƒe nyatakaka. Àte ŋu aɖe nyatakaka tso Crawler la gbɔ afia ne nàzã curl abia ɣaɣla dzesi ŋɔŋlɔ la (esia hia jq be nàɖe nyatakaka ma fia). Crawler RPC ƒe gaɖoƒe ƒe dzesi le kpɔɖeŋu sia me nye '127.0.0.1:54321'

Le Terminal bubu me, wɔ seɖoɖo

Code-highlight

curl --data-binary '{"jsonrpc": "2.0", "id":0, "method": "getmetrics", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:54321/ | jq .result.protocol_versions

Esia aɖe '.protocol_version' ƒe nyatakaka si woƒo ƒu fifia le '.result' field me afia. '.result' field la gã ŋutɔ, eyata wòanyo be nàyɔ eƒe akpa tɔxɛwo ɖe eteƒe. Nyatakaka ƒe ƒomevi bubu siwo hã naa viɖe nye '.num_known_nodes', '.num_good_nodes', '.user_agents' kple bubuwo. Kpɔ metrics ƒe akpa le Afisia

Be nàdu Crunchy kple P2P-Viz, ele be nàtsɔ '.result' la aɖo .json file me.

Wɔ seɖoɖo

Code-highlight

curl --data-binary '{"jsonrpc": "2.0", "id":0, "method": "getmetrics", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:54321/ > latest.json

Esia awɔ 'latest.json' file le directory si me nèle fifia. Wozã 'latest.json' file sia kple Crunchy.

Le afi sia la, àte ŋu atɔ Crawler la kple 'ctrl+c' ne mèhia nyatakaka bubu o. Crawler la aɖe nyatakaka siwo naa viɖe afia le terminal la me.

Crunchy

Wohĩa Crunchy be woaƒo output json file la ƒe nyatakaka ƒu be P2P-Viz nate ŋu azãe.

Be nàtu Crunchy, yi wò '/runziggurat' folder me

Be nàclone ɖe Crunchy repo me, wɔ seɖoɖowo

Code-highlight

git clone https://github.com/runziggurat/crunchy.git
cd crunchy

Kpɔ 'latest.json' file la ɖe 'crunchy/testdata/' folder me.

Wɔ seɖoɖowo

Code-highlight

cargo run --release -- -i testdata/latest.json -o testdata/state.json -g testdata/geoip-cache.json -f Zcash

Esia awɔ Zcash ɣaɣla dzesi ŋɔŋlɔ si woƒe ŋutinya wotia ƒe 'state.json' file le 'crunchy/testdata/' folder me, si wozãna kple P2P-Viz.

P2P-Viz

Be nàtu P2P-Viz, ele be npm nanɔ asiwò.

Be nàɖo npm kple nvm, wɔ seɖoɖowo:

Code-highlight

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

Tu terminal la eye nàɖoe gake.

Wɔ seɖoɖo:

Code-highlight

nvm install --lts

Yi wò '/runziggurat' folder me

Be nàclone ɖe P2P-Viz repo me eye nàdzee egɔme, wɔ seɖoɖowo

Code-highlight

git clone https://github.com/runziggurat/p2p-viz.git
cd p2p-viz
npm i
npm run build
npm run start http

Ʋu browser le http://localhost:3000.

Tia 'Geolocation' eye nàtia 'Choose state file'.

Tso file explorer pop-up la me, tia 'state.json' file la.

Ɣaɣla dzesi ŋɔŋlɔ ƒe nɔnɔmetata World Map la aɖe file ƒe nyatakakawo fia. Kpɔ readme la le Afisia be nànya bubu tso ale si nàzãe kple ɖoɖowo ŋu.

NUVEVIWO!

Àte ŋu aɖo Crawler la be wòawɔ crawl le ɣeyiɣi si nàtia me kple 'timeout' seɖoɖo ko, si aɖe kill seɖoɖo aɖe ɖa le ɣeyiɣi si nàɖo megbe. Wɔ 'timeout --help' be nànya bubu. Seɖoɖo si gbɔna la aɖe asi adu crawler la eye wòatɔe le minuti 50 megbe.

Wɔ seɖoɖo

Code-highlight

timeout --signal=2 50m cargo run --release --features crawler --bin crawler -- --seed-addrs 157.245.172.190:8233 194.135.81.61:8233 35.233.224.178:8233 --rpc-addr 127.0.0.1:54321

NUVEVIWO!

Àte ŋu ayɔ 'latest.json' la eye nàŋlɔe ɖe '/testdata' me, ale be mèhia be nàkɔe eye nàtsɔe aɖo afi bubu o.

NUVEVIWO!

Àte ŋu axɔ IP Address ƒe nyatakaka tso output la me eye nàzãe atsɔ aɖo Crawler la ƒe seed gake le gɔmedzedze (--seed-addrs). Esia atrɔ ɣeyiɣi si hia be nàwɔ crawl blibo!

Tɔdziʋuɖoɖo

Mɔfialawo:

Zcash Network Ƒe Nɔnɔmetata

Ɖo Hiahiãwo:

Esi Wodi O:

Zcash Network Crawler

Crunchy

P2P-Viz

Zcash Network Ƒe Nɔnɔmetata

Ɖo Hiahiãwo:

Esi Wodi O:

Zcash Network Crawler

Crunchy

P2P-Viz