hcAutonomywwwcli

hcAutonomywwwcli

hcAutonomywwwcli is a command line tool that allows you to interact with the hcAutonomywww API.

Available Commands

You can view the available commands and application options by using the help flag.

$ hcAutonomywwwcli -h

You can view details about a specific command, including required arguments, by putting the help flag after the command.

$ hcAutonomywwwcli <command> -h

Persisting Data Between Commands

hcAutonomywwwcli stores user identity data (the user's public/private key pair), session cookies, and CSRF tokens in the AppData/HcAutonomywww/cli/ directory. This allows you to login with a user and use the same session data for subsequent commands. The data is segmented by host, allowing you to login and interact with multiple hosts simultaneously.

The location of the AppData directory varies based on your operating system.

macOS

/Users/<username>/Library/Application Support/HcAutonomywwww/cli/

Windows

C:\Users\<username>\AppData\Local\HcAutonomywww/cli/

Ubuntu

~/.hcAutonomywww/cli/

Setup Configuration File

hcAutonomywwwcli has a configuration file that you can setup to make execution easier. You should create the configuration file under the following paths.

macOS

/Users/<username>/Library/Application Support/HcAutonomywww/cli/hcAutonomywwwcli.conf

Windows

C:\Users\<username>\AppData\Local\HcAutonomywww/cli/hcAutonomywwwcli.conf

Ubuntu

~/.hcAutonomywww/cli/hcAutonomywwwcli.conf

If you're developing locally, you'll want to set the hcAutonomywww host in the configuration file since the default hcAutonomywww host is https://proposals.HcashOrg.org. Copy this line into your hcAutonomywwwcli.conf file.

host=https://127.0.0.1:4443

Usage

Create a new user

$ hcAutonomywwwcli newuser email@example.com username password --verify --paywall

--verify and --paywall are options that can be used when running hcAutonomywww on testnet to make the user registration process a little simpler.

--verify will satisfy the email verification requirement for the user.

--paywall will use the Hc testnet faucet to satisfy the user registration fee requirement.

If you use the --paywall flag, you will still need to wait for block confirmations before you'll be allowed to submit proposals.

Login with the user

$ hcAutonomywwwcli login email@example.com password

Give your user admin privileges and add proposal credits to their account

Proposal credits are required in order to submit a proposal. They are a spam prevention measure that would normally need to be purchased using HC, but if you're running hcAutonomywww locally, you can use the hcAutonomywww_dbutil tool to add proposal credits to your account. You'll also need to give your user admin privileges if you want to be able to start proposal votes.

You need to stop hcAutonomywww in order to run these commands. You'll get a resource temporarily unavailable error if you don't.

$ hcAutonomywww_dbutil -testnet -setadmin email@example.com true
$ hcAutonomywww_dbutil -testnet -adhcedits email@example.com 50

Start hcAutonomywww back up.

Submit a new proposal

When submitting a proposal, you can either specify a markdown file or you can use the --random flag to have hcAutonomywwwcli generate a random proposal for you.

$ hcAutonomywwwcli newproposal --random
{
  "files": [
    {
      "name": "index.md",
      "mime": "text/plain; charset=utf-8",
      "digest": "362ca2a93194ebee058640f36b0ba74955760cd495f2626d740334de2cbb2a8d",
      "payload": "VGhpcyBpcyB0aGUgcHJvcG9zYWwgdGl0bGUKaFlOWll3NklzaE0rUVlWcU91aU45YThXdzdJUnRBYmVxSDV6dERTZkk0bz0KaXBTOUIwTmRNSHZEU3QrRkdHZFhoRHFMQ2RmQjF4eWFCTHJvTU01c1FnTT0KVXpHK2l3S0drZHhjaGRmdFMrYlpqZ0xsc1I4bGVmWDVnUCsxLy90ZXdJRT0KZWFvd1hNNkNGeVc4Z3dxRUVlc0J5aXNwbDNPSW9WemdyVlJZZ1ZEK1UzND0Kb3Q5WVlncGY0NGRFVlJ3ckdPb3FXQXJGaCtlUm1zemhZaGdnWEtkRTRhMD0KZWZXNmNwNTlCd05taS95b1Z0Zk5HU0dvWldrZzgvTUFFMllCMGZqcEREaz0KTUFicVVobW9WMFpIZ3NzNEpOMFBvU1F1V0pubWxNd3lrKzFIMUovSzVpQT0KWDlxQ3ZUcWZEbk1iTW1rV0V3bzNuSmtlL1dlaEN3dU1QMTdFYnczUi9HWT0KbUNPZ0ZpZEtGUmJKWTBnUCtrbGZUZUxUS3JSODBsSW92UGxVcjEvWjVjRT0KYWFzc04wWHZSZkdFM0ZIbHpXVFhTQlJ4ZVhCY2c5dmk1Wm5YUEhKWElUQT0K"
    }
  ],
  "publickey": "c2c2ea7f24733983bf8037c189f32b5da49e6396b7d21cb69efe09d290b3cb6d",
  "signature": "d4f38ee60e3032e67264732b13081ac36554fefd70079d40dcf7eb179e7cc4b2c80acc6460e9de1e816255bccfade659df6766c7371bd68592f010e3179feb0e"
}
{
  "censorshiprecord": {
    "token": "299d6defa32b77f0a5534168256c6712a02c0de8037747ac213f650065529043",
    "merkle": "362ca2a93194ebee058640f36b0ba74955760cd495f2626d740334de2cbb2a8d",
    "signature": "729269ef6bb45003a4728c40ff5c7f1ecbc44bfcff459d43274155e42e971a0ef8830e692eb833b049df5460edd850c77f21353fe24fd43a454388b7b89d7e00"
  }
}

The proposal must first be vetted by an admin before it is publicily viewable. Proposals are identified by their censorship record token, which can be found in the output of the newproposal command.

Make a proposal public (admin privileges required)

$ hcAutonomywwwcli setproposalstatus [censorshipRecordToken] 4

Now that the proposal has been vetted and is publicly available, you can comment on the proposal or an admin can start the voting period for the proposal.

Start a proposal vote (admin privileges required)

$ hcAutonomywwwcli startvote [censorhipRecordToken]

Voting on a proposal - hcAutonomyvoter

Voting on a proposal can be done using the hcAutonomyvoter tool.

Voting on a proposal - hcAutonomywwwcli

You can also vote on proposals using hcAutonomywwwcli, but for right now, it only works on testnet and you have to be running your hcwallet locally using the default port. If you are doing these things, then you can use the inventory, vote, and tally commands.

inventory will fetch all of the active proposal votes and print the details for the proposal votes in which you have eligible tickets.

$ hcAutonomywwwcli inventory
Token: ee42e2e231c02b3d202de9f5df7b2d361a5ab078f675a8823e3db73afb799899
  Proposal        : This is the proposal title
  Eligible tickets: 3
  Start block     : 30938
  End block       : 32954
  Mask            : 3
  Vote Option:
    ID                   : no
    Description          : Don't approve proposal
    Bits                 : 1
  Vote Option:
    ID                   : yes
    Description          : Approve proposal
    Bits                 : 2
    To choose this option: hcAutonomywwwcli vote ee42e2e231c02b3d202de9f5df7b2d361a5ab078f675a8823e3db73afb799899 yes

vote will cast votes using your eligible tickets. You'll be asked to enter your wallet password.

$ hcAutonomywwwcli vote ee42e2e231c02b3d202de9f5df7b2d361a5ab078f675a8823e3db73afb799899 yes
Enter the private passphrase of your wallet:
Votes succeeded: 3
Votes failed   : 0

tally will return the current voting resuts the for passed in proposal.

$ hcAutonomywwwcli tally ee42e2e231c02b3d202de9f5df7b2d361a5ab078f675a8823e3db73afb799899
Vote Option:
  ID                   : no
  Description          : Don't approve proposal
  Bits                 : 1
  Votes received       : 0
  Percentage           : 0%
Vote Option:
  ID                   : yes
  Description          : Approve proposal
  Bits                 : 2
  Votes received       : 3
  Percentage           : 100%

Proposal Status Codes

A proposal record will include a numeric staus code to represent the status of the proposal. These status codes are listed below.

PropStatusInvalid           = 0 // Invalid status
PropStatusNotFound          = 1 // Proposal not found
PropStatusNotReviewed       = 2 // Proposal has not been reviewed
PropStatusCensored          = 3 // Proposal has been censored
PropStatusPublic            = 4 // Proposal is publicly visible
PropStatusUnreviewedChanges = 5 // Proposal is not public and has unreviewed changes
PropStatusAbandoned         = 6 // Proposal has been declared abandoned by an admin