#unc #command-line #validation #proposal #helps #human-friendly #companion

app unc-validator

unc-validator is your human-friendly companion that helps to interact with Utility Validators from command line

10 releases (5 breaking)

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

#695 in Command line utilities

Download history 179/week @ 2024-03-15 395/week @ 2024-03-22 71/week @ 2024-03-29 2/week @ 2024-04-05 111/week @ 2024-05-03 149/week @ 2024-05-10 153/week @ 2024-05-17 13/week @ 2024-05-24

426 downloads per month

MIT/Apache and GPL-2.0-or-later

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

~55–77MB
~1.5M SLoC