cardano-foundation/cip-0094-polls

CIP-0094 polls

This repository contains instructions and data for participating in SPO polls as proposed and defined in CIP-0094 and announced in this forum post.

Note

We will add to and improve this guidance and information in the first half of May as part of the PreProd test run.

Existing polls

Date	Network	Poll
May 2023	PreProd	d8c1b1d871a27d74fbddfa16d28ce38288411a75c5d3561bb74066bcd54689e2
May 2023	Mainnet	fae7bda85acb99c513aeab5f86986047b6f6cbd33a8e11f11c5005513a054dc8

There are CIP-0094 dashboards to keep track of the previous votes cast by the pools.

• Adastat.net [PreProd] [Mainnet]
• Cardanoscan.io [PreProd] [Mainnet]

How to participate?

Pre-requisites

To run the poll governance subcommands, a version of cardano-cli with governance poll subcommand support is required. There are few options available to you:

1. Checkout and build input-output-hk/[email protected]

2. Checkout and build CardanoSolutions/cardano-node@release/1.35+cip-0094

3. Download pre-built binaries from CardanoSolutions/cardano-node@release/1.35+cip-0094, for a standard Linux system

Steps

1. Find an available poll

Available polls are listed in the table above. Alternatively, you can use the getPoll.sh script to look for specific polls submitted on-chain.

2. Create a poll answer

Use the cardano-cli governance answer-poll command to create an answer.

3. Build a transaction with metadata

Build a transaction using the poll answer as metadata. You'll also need to indicate your pool id as an extra required signatory.

4. Sign the transaction

The transaction must be signed using your cold key.

5. Submit the transaction

Finally, submit the transaction to the network.

Tutorial

The steps above are explained in more detail in TUTORIAL.md.

cip-0094-polls's Issues

Changes to build_CCLI8.sh

In order to run successfully (on a machine using GuildOps PreProd build):

• Before running mkdir ${HOME}/.local/bin/CIP-0094

Edit build_CCLI8.sh

• Change tag to targetTag="bench-8.0pre-fix3"
• Force checkout git checkout -f ${targetTag}

Fetch user-defined comments as part of the crawler

Some SPOs have left comments as metadata (CIP-0020) with their submission. It'd be nice to fetch alongside the votes when crawling on-chain data.

Request multi-sig capabilities

Currently for pools with more than one owner, like BALNC and BERRY, the multi signature is not yet supported for voting. Requesting this feature be added in future builds.

Failure to build

Running the steps as described leads to some missing files and errors which are hidden unless examining with bash -x.

Reproduction

1. Start a Debian system or container
2. Run apt-get update ; apt-get install cabal-install
3. Obtain the build_CCLI8.sh script
4. Clone the cardano-node repository into "${repoPath}"
5. Execute the build_CCLI8.sh script

Screenshots

The below content was from executing bash -x ./build_CCLI8.sh to examine the workflow more closely.

+ echo 'Now let'\''s build and install cardano-cli ...'
Now let's build and install cardano-cli ...
+ read -p 'Press [Enter] to continue ...'
Press [Enter] to continue ...
+ cabal install --installdir /root/.local/bin/CIP-0094 --install-method=copy --constraint 'cardano-crypto-praos -external-libsodium-vrf' --minimize-conflict-set cardano-cli:exe:cardano-cli
+ tee /tmp/build.log
cabal: Error parsing project file /root/git/cardano-node/cabal.project:15:
Parse of field 'index-state' failed (index-state must be a unix-timestamps
(e.g. '@1474732068'), a ISO8601 UTC timestamp (e.g. '2016-09-24T17:47:48Z'),
or 'HEAD'): , hackage.haskell.org 2023-04-29T00:00:00Z
, cardano-haskell-packages 2023-04-30T00:28:07Z