> For the complete documentation index, see [llms.txt](https://docs.bifrost.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bifrost.io/for-the-community/governance/proposal-guidelines-polkadot.js.md).

# Proposal Guidelines (polkadot.js)

A proposal goes through the following rough steps from idea to implementation (some specific proposal might takes more complicated process, such as Whitelist proposal):

1. Propose and discuss your idea on Bifrost Forum - Open Discussion ([Bifrost-Polkadot](http://bifrost.subsquare.io/) or [Bifrost-Kusama](https://bifrost-kusama.subsquare.io/discussions)), maybe make adjustments based on what the community thinks of the proposal.
2. Migrate your proposal to [off-chain voting](https://voting.opensquare.io/space/bifrost), wait several days to see the reaction from community.
3. If your off-chain voting passed, you can create an on-chain preimage base on your proposal contents.
4. Submit your proposal in the corresponding track.
5. Wait for the result and enactment.

#### Open Discussion

<https://bifrost.subsquare.io/discussions>

#### Off-chain Voting

Off-chain voting process is to imitate the function of voting on the chain. Community users still need to connect their wallets and vote for BNC. Through Off-chain voting, you can test if your proposal can be agreed by the community.

Migrate your existing proposal to Off-chain channel

1. Click Off-chain in Bifrost Subsquare

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FXevljVxLjVoxAaCKMq1P%2Fimage.png?alt=media&amp;token=cf43e066-7609-478a-b6a5-7cefba1c6c12" alt=""><figcaption></figcaption></figure>

2. Connect your Wallet and propose a new proposal by using your discussed proposal contents.

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2Fh9ZKWm7lrz7KNjQ84onD%2Fimage.png?alt=media&amp;token=b8920d45-ea86-4250-a96f-c593f37d8ff1" alt=""><figcaption></figcaption></figure>

3. Simulate on-chain voting and input key information.
   1. Input your proposal title and contents.
   2. System: Set the voting choices, “Single” or “Multiple” choices.
   3. Name your choices.
   4. Period: Set the voting period (at least 5 days recommended).
   5. Snapshot: set the block stamp, which block to start voting.
   6. Connect your wallet and publish.

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FbEu6zx6yYDoCYaHdeAY6%2Fimage.png?alt=media&amp;token=60472082-1a8a-4bdc-a4f9-f038c28c194f" alt=""><figcaption></figcaption></figure>

#### Create preimage, submit proposal and on-chain voting

1. Create preimage
   1. Go to [Bifrost-Kusama](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fbifrost-rpc.liebi.com%2Fws#/explorer) or [Bifrost Polkadot](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fhk.p.bifrost-rpc.liebi.com%2Fws#/explorer), select Governance and click preimage, add your preimage.

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FwcfiHL8jkRSAmNWTULIY%2Fimage.png?alt=media&amp;token=df2b4b3b-a552-43df-9c4e-7a2bd892e64a" alt=""><figcaption></figcaption></figure>

2. Submit preimage
   1. Input your proposal parameters (it depends on what function and pallet you should call, please ensure this at the Discussion stage).
   2. Copy your preimage hash
   3. Submit preimage

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FPKbP9PxSvq0vCKTI9LPL%2Fimage.png?alt=media&amp;token=18a8a907-3aaa-4d1a-beef-123aa9db8d1b" alt=""><figcaption></figcaption></figure>

3. Double-check your preimage
   1. Find your preimage in the list
   2. Double-chain your preimage parameters
   3. You can copy the callhash again, just in case if you forgot in the previous step.

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FwnN1acgVSyRxQX12vPfu%2Fimage.png?alt=media&amp;token=f1caf054-dd7c-4278-949b-f700963756a2" alt=""><figcaption></figcaption></figure>

4. Submit your proposal
   1. Go to referenda and click “Submit proposal”
   2. According to your proposal content, choose the appropriate Track. (For example, 10/Validator Election works for VBL proposals. If your proposal passes Off-chain voting, the Bifrost team will guide you to select the corresponding Track.)
   3. Submit proposal

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FOUSbidCAbEKVFX0XR9HU%2Fimage.png?alt=media&amp;token=08d4fbf3-55d8-45fc-936e-4318c5954b07" alt=""><figcaption></figcaption></figure>

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2FTSqV9k9hRkRUQSHxc3yB%2Fimage.png?alt=media&amp;token=ec68daff-7f11-4b5c-afa4-42a1c55db3e5" alt=""><figcaption></figcaption></figure>

5. Vote and follow up your proposal status
   1. Once your proposal submitted, it is visible on the referenda page.
   2. BNC holders can vote to your proposal.
   3. Follow up with your proposal processing status, which will pass prepareing period, decision period, confirmation period and enactment period. To learn the concepts of these periods at [here](https://wiki.polkadot.network/docs/maintain-guides-opengov#opengov-terminology-and-parameters).

<figure><img src="https://757947912-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFtVsA5N3spWTWKvFvv0%2Fuploads%2F6qNGEbPcZIVQz8gEciHN%2Fimage.png?alt=media&amp;token=673f5b8f-ff7c-4126-93a5-180cae568646" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bifrost.io/for-the-community/governance/proposal-guidelines-polkadot.js.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.