> For the complete documentation index, see [llms.txt](https://constitutionalcouncil.docs.intersectmbo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://constitutionalcouncil.docs.intersectmbo.org/council-toolkit/user-guide.md).

# User guide

### To sign a vote with the Council Toolkit , you will need:

* A Chromium Browser.
* A Windows or Apple computer.
* A compatible wallet, controlling a voter key.
  * We currently recommend Lace and Eternl.
* [`council-toolkit.gov.tool`](https://council-toolkit.gov.tools/)

### Instructions

* Toolkit is compatible with two environments : Pre-Prod and Mainnet
* Visit Council Toolkit: [Council Toolkit ](https://council-toolkit.gov.tools/)
* Have a unsigned voting transaction ready (provided by the orchestrator)
* You are ready to produce a witness (a signature) !!

### Step-by-step guide to produce a signature 

* Click 'Connect Wallet' 

  * Establish a connection between the wallet and the toolkit 

  <figure><img src="/files/MmPvS5LVJA4nvcPl0Lw7" alt=""><figcaption></figcaption></figure>

  * Make sure you allow wallet to be used by Dapp on wallet's settings
  * Once connection is established, your ***voter key hash*** and ***wallet network*** will be displayed.

  <div align="left"><figure><img src="/files/LUAwQ2014hWzPQwt3RTE" alt=""><figcaption></figcaption></figure></div>

  * Upload your unsigned voter transaction (that has been sent by the 'orchestrator') by clicking UPLOAD button.

  <figure><img src="/files/yekb1zbNbsG5i2AY8EJt" alt=""><figcaption></figcaption></figure>

  * Upon selecting the unsigned voter transaction file , the transaction hex will be displayed.

  <figure><img src="/files/8tK6Rt0fR6sxyOtpSk3B" alt=""><figcaption></figcaption></figure>

  * Validation checks are done by clicking "CHECK TRANSACTION" button .

  <figure><img src="/files/TvNAT3heUMWLvo5gx75s" alt=""><figcaption></figcaption></figure>

  * A total of 8 validation check are preformed that confirm:
    * you are a required signer.
    * you have an  un-signed transaction, needed to be signed.
    * both the unsigned transaction and the wallet are in the same network.
    * the uploaded transaction is un-signed, in need for a signature(a witness).
    * the vote transaction refers Intersect's ICC credentials.
    * you are signing only one vote in the vote transaction.
    * no certificates are part of the vote transaction.
    * your key is in the Intersect's ICC hierarchy.
    * the metadata document on the hosted at the provided URL , matches the provided hash.
  * Voting details are displayed and the user needs to confirm they are correct before proceeding to sign the vote transaction.

  <figure><img src="/files/hbJY9DHzvTa2BcM73gxF" alt=""><figcaption></figcaption></figure>

  * After confirming the governance action ID you are voting on , the vote choice and the metadata you can proceed with signing the transaction.

  <figure><img src="/files/w74zLsn7MjmxjiapJlS6" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/NRyovx8zTWiVYCs1BaJg" alt=""><figcaption></figcaption></figure>

  * Upon clicking on the 'SIGN TRANSACTION" button , your soft wallet is going to request you the spending password in order for the wallet to sign the transaction and create a signature (a witness)
  * Signature(the witness) then will be retrieved by our app where you can download it by clicking "DOWNLOAD" button and ready to send it to the 'orchestrator'

  <figure><img src="/files/38szZnzn6rYx7Lyvm3WY" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://constitutionalcouncil.docs.intersectmbo.org/council-toolkit/user-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.