10 releases (5 breaking)
| new 0.12.0 | May 21, 2024 |
|---|---|
| 0.10.2 | May 15, 2024 |
| 0.6.1 | Mar 26, 2024 |
| 0.5.2 | Mar 22, 2024 |
| 0.1.0 | Mar 20, 2024 |
#664 in Command line utilities
275 downloads per month
68KB
874 lines
Utility Node Validator CLI Extension
unc-validator is your human-friendly companion that helps to interact with Utility Node Validators from command line.
It works the best in combination with unc CLI.
Install
You can find binary releases of unc-validator CLI for your OS on the Releases page.
Install prebuilt binaries via shell script (macOS, Linux, WSL)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/utility-validator-cli-rs/releases/latest/download/unc-validator-installer.sh | sh
Install prebuilt binaries via powershell script (Windows)
irm https://github.com/utnet-org/utility-validator-cli-rs/releases/latest/download/unc-validator-installer.ps1 | iex
Run prebuilt binaries with npx (Node.js)
npx unc-validator
Install prebuilt binaries into your npm project (Node.js)
npm install unc-validator
Install from source code (Cargo)
Install it with cargo, just make sure you have Rust installed on your computer.
cargo install unc-validator
or, install the most recent version from git repository:
$ cargo install --git https://github.com/utnet-org/utility-validator-cli-rs
Available commands
validators
With this command you can lookup validators for a given epoch. Epoch can be specifyed by EpochId, BlockId, Block hight or Latest keyword.
In the terminal command line type:
unc-validator validators network-config testnet now
The result of this command will be as follows:
Validators (total: 5, seat price: 16800 unc)
+------------------------------------------------------------------+--------------+----------+-----------------+-----------------+-----------------+-----------------+
| Validator Id | Pledge | Online | Blocks produced | Blocks expected | Chunks produced | Chunks expected |
+------------------------------------------------------------------+--------------+----------+-----------------+-----------------+-----------------+-----------------+
| 441d580e88c60f78b1a08f32be137f58198d1522a3d323c383715447e29e1e5c | 50000000 unc | 100.00 % | 3 | 3 | 6 | 6 |
| 0f52ba0fe05555b33444ac1fff6b6b1e39a06e928cfc4b18803a68097d94d30e | 20000000 unc | 100.00 % | 3 | 3 | 1 | 1 |
| fd09e7537ee95fd2e7b78ee0a2b10bb9db4ebe65dc94802ce420c94ebb25bc43 | 20000000 unc | 100.00 % | 4 | 4 | 2 | 2 |
| c92fa60934dd1a5a444e171168544d30b7a9dd349786412f8a3003bfc1d126b3 | 10000000 unc | 100.00 % | 0 | 0 | 1 | 1 |
| da84f9dddb0988fa97764288d2735564f4ec450fc5c8a4dd8dfdf96e2d797174 | 5000000 unc | NaN | 0 | 0 | 0 | 0 |
+------------------------------------------------------------------+--------------+----------+-----------------+-----------------+-----------------+-----------------+
proposals
Show both new proposals in the current epoch as well as current validators who are implicitly proposing:
unc-validator proposals network-config testnet
The result of this command will be as follows:
Proposals for the epoch after next (new: 25, passing: 62, expected seat price = 54039.777430965844435406680899 unc)
+----+--------------------+-------------------------------------------+----------------------------------------+----------------------------------------+
| # | Status | Validator Id | Pledge | New Pledge |
+----+--------------------+-------------------------------------------+----------------------------------------+----------------------------------------+
| 1 | Rollover | node2 | 42463456.377087193379078729276997 unc | |
| 2 | Rollover | 01node.pool.f863973.m0 | 15719906.892540506860671479938212 unc | |
| 3 | Proposal(Accepted) | cryptogarik.pool.f863973.m0 | 14146118.880582007333099210276014 unc | 14146130.926226277756099420604526 unc |
| 4 | Rollover | everpledge.pool.f863973.m0 | 11080661.442432259407194895864464 unc | |
| 5 | Rollover | chorusone.pool.f863973.m0 | 9629377.891168433658816361005072 unc | |
| 6 | Proposal(Accepted) | nodeasy.pool.f863973.m0 | | 7934172.945372108536470046666193 unc |
| 7 | Proposal(Accepted) | kiln.pool.f863973.m0 | 6079613.843956031425391305083783 unc | 6089293.096542765174318484627714 unc |
| 8 | Rollover | pledged.pool.f863973.m0 | 4999757.888727011980090322499078 unc | |
| 21 | Proposal(Accepted) | pledgesstone.pool.f863973.m0 | 1495620.398863776083560667101079 unc | 1496166.078305000144619938927897 unc |
| 23 | Rollover | bee1pledge.pool.f863973.m0 | 1458170.384325998236160607279491 unc | |
| 24 | Rollover | alexandruast.pool.f863973.m0 | 1421069.05632136355769699266569 unc | |
| 29 | Proposal(Accepted) | chelovek_iz_naroda.pool.f863973.m0 | 814633.60270815969401901915999 unc | 814643.602843622897090819159989 unc |
| 30 | Proposal(Accepted) | optimusvalidatornetwork.pool.f863973.m0 | 814536.394051230138804706693949 unc | 814525.597100869446858861876735 unc |
| 31 | Rollover | tayang.pool.f863973.m0 | 737378.959040357990001747402769 unc | |
| 32 | Rollover | blockngine.pool.f863973.m0 | 639345.96536088610582681658546 unc | |
| 40 | Rollover | darvin.pool.f863973.m0 | 494852.176425715690951019987015 unc | |
| 41 | Proposal(Accepted) | infstones.pool.f863973.m0 | | 490042.289162263103709480311607 unc |
| 42 | Rollover | moonlet.pool.f863973.m0 | 480808.594675834324997215741764 unc | |
| 43 | Rollover | aquarius.pool.f863973.m0 | 440148.228029800480983617468605 unc | |
| 44 | Proposal(Accepted) | casualpooltest.pool.f863973.m0 | 437487.300611972413125697142006 unc | 437487.304290901270779497142006 unc |
| 45 | Rollover | pennyvalidators.pool.f863973.m0 | 405728.663157549880430291114589 unc | |
| 46 | Proposal(Accepted) | mondlicht.pool.devnet | 382179.974090138353447112728888 unc | 382518.134699398818830702935521 unc |
| 47 | Rollover | stingray.pool.f863973.m0 | 359535.994275044281045666367836 unc | |
| 48 | Rollover | nw.pool.devnet | 314305.897488098565334510551894 unc | |
| 49 | Proposal(Accepted) | infiniteloop.pool.f863973.m0 | 312813.239752153752739566624169 unc | 312813.240053274445572066624169 unc |
| 50 | Rollover | gargoyle.pool.f863973.m0 | 292432.815062289613304478068761 unc | |
| 56 | Proposal(Accepted) | kuutamocharlie.pool.devnet | | 81955.191886364504871018375552 unc |
| 57 | Rollover | blueprint.pool.f863973.m0 | 78978.68796349885502102929427 unc | |
| 58 | Rollover | hahaha.pool.devnet | 64337.498161220467461479588097 unc | |
| 59 | Proposal(Accepted) | forked.pool.f863973.m0 | | 60212.05554749766575529530327 unc |
| 60 | Rollover | jpledging.pool.f863973.m0 | 59249.07109749876737048778665 unc | |
| 61 | Rollover | derori_validator_pool.pool.f863973.m0 | 58645.575112263099871994258981 unc | |
| 62 | Rollover | ibb.pool.f863973.m0 | 54704.833517287745250191173298 unc | |
| 63 | Kicked out | happypledge.pool.f863973.m0 | 53720.240145927988351697242033 unc | |
| 64 | Kicked out | kuutamo.pool.f863973.m0 | 50898.649507219560792919189598 unc | |
| 65 | Proposal(Declined) | bgpntx.pool.f863973.m0 | 49788.123993303798255829538717 unc | 49788.124271479370135129538717 unc |
| 66 | Kicked out | grassets.pool.f863973.m0 | 48754.250378643643185317807387 unc | |
| 74 | Kicked out | commons_pnw.pool.f863973.m0 | 41307.46845724409836625299375 unc | |
| 75 | Proposal(Declined) | cryptolions.pool.f863973.m0 | 38585.308044335751252004590272 unc | 38585.308374159098843004590272 unc |
| 76 | Kicked out | omnipledge_v5.factory01.littlefarm.testnet | 38539.722508482341332079252916 unc | |
| 82 | Kicked out | dehashed.pool.f863973.m0 | 32769.300253705312947757304866 unc | |
| 83 | Proposal(Declined) | do0k13-kuutamod.pool.devnet | | 31893.204026221938212322781368 unc |
| 84 | Kicked out | dav_kuutamo.pool.f863973.m0 | 30330.117372193371695000000001 unc | |
| 85 | Proposal(Declined) | lavenderfive.pool.f863973.m0 | 30227.016444935378828600648379 unc | 30227.016817078602784800648379 unc |
| 86 | Kicked out | machfund.pool.f863973.m0 | 23570.872249580298614866762038 unc | |
| 87 | Kicked out | lusienda.pool.f863973.m0 | 14635.888149639641051205948527 unc | |
| 88 | Proposal(Declined) | 1inc4.pool.f863973.m0 | | 8970.16910365545105495283601 unc |
| 89 | Proposal(Declined) | wolfedge-capital-testnet.pool.f863973.m0 | | 4110.352445422739638628282042 unc |
+----+--------------------+-------------------------------------------+----------------------------------------+----------------------------------------+
pledging
For validators, there is an option to pledging without deploying a pledging pool smart contract.
view-pledge - View validator pledge
To view the validator's pledge on the last block, you need to enter in the terminal command line:
unc-validator pledging view-pledge miner.testnet network-config testnet now
The result of this command will be as follows:
Validator miner.testnet pledged amount 0 unc
pledge-proposal - To pledge unc directly without a pledging pool
To pledge the amount you must enter in the terminal command line:
unc-validator pledging pledge-proposal miner.testnet ed25519:AiEo5xepXjY7ChihZJ6AsfoDAaUowhPgvQp997qnFuRP '1500 unc' network-config testnet sign-with-keychain send
The result of this command will be as follows:
Validator <miner.testnet> has successfully pledged 1500 unc.
unpledge-proposal - To unpledge unc directly without a pledging pool
To unpledge you must enter in the terminal command line:
unc-validator pledging unpledge-proposal miner.testnet ed25519:AiEo5xepXjY7ChihZJ6AsfoDAaUowhPgvQp997qnFuRP network-config testnet sign-with-keychain send
The result of this command will be as follows:
Validator <miner.testnet> successfully unpledged.
Dependencies
~54–77MB
~1.5M SLoC