Skip to content

Commit

Permalink
HRMP Channel Instructions Update (w3f#4989)
Browse files Browse the repository at this point in the history
* added new instructions

* minor edits

* Update docs/build/build-hrmp-channels.md

Co-authored-by: bader y <[email protected]>

* removed deprecated section

* add section to clarify

---------

Co-authored-by: bader y <[email protected]>
  • Loading branch information
filippoweb3 and CrackTheCode016 authored Jul 3, 2023
1 parent a704443 commit 6953884
Showing 1 changed file with 15 additions and 20 deletions.
35 changes: 15 additions & 20 deletions docs/build/build-hrmp-channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,17 +56,20 @@ place to share the reasoning behind your proposal: make sure to log in with the
possible) before publishing yours, and if you can do this also make sure the address has an on-chain
identity.

Your proposal should contain the following sections to be considered complete for the community to
review and ultimately vote:
### Example: Opening an HRMP Channel with the AssetHub

1. A request on what the proposal aims to do (opening an HRMP channel with the Asset Hub);
The following highlights the steps required to submit a proposal for opening an HRMP channel with
the AssetHub. Your submission should contain the following sections to be considered complete for
the community to review and ultimately vote on:

1. A request on what the proposal aims to do (opening an HRMP channel with the AssetHub);
2. The use cases this channel will support for your chain;
3. Technical details of the proposal, including proposal parameters and technical details of this
call (On Kusama, most proposals were designed as a batchAll calls) :
call (On Kusama, most proposals were designed as a batchAll calls):

- A force transfer from Polkadot treasury to the Asset Hub as deposit to accept and open an HRMP
channel with your chain;
- Send XCM message to the Asset Hub to execute a transaction with superuser (root) permission.
- A `forceTransfer` of 20 DOT from the Treasury to AssetHub sovereign account.
- A `forceOpenhrmpchannel` from AssetHub (1,000) to ParaID.
- A `forceOpenhrmpChannel` from ParaID to AssetHub (1,000).

Please note that if governance decides to reduce the HRMP channel deposit on Polkadot to 0 DOT,
the first transaction should not be necessary (these guidelines will be updated accordingly).
Expand All @@ -75,7 +78,11 @@ review and ultimately vote:
5. The call data to verify on
[Polkadot JS Apps Decode](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.polkadot.io#/extrinsics/decode)
tab;
6. The proposal hash for the external motion submission.
6. The preimage hash to include in the proposal's submission. Note that if the proposer is planning
to
[submit a referendum on the Whitelisted Caller Track](../maintain/maintain-guides-polkadot-opengov.md#submitting-a-referendum-on-the-whitelisted-caller-track),
the preimage hash needs to be submitted to and whitelisted by the
[Technical Fellowship](../learn/learn-polkadot-opengov.md#the-technical-fellowship).

Below is an example of how teams followed this process on Kusama, as a way to:

Expand All @@ -94,18 +101,6 @@ Polkadot JS Apps, by using the "Submit Preimage" button:
On the pop up window, compose the preimage in the discussion post: making sure the proposal hash is
the same as in the post.

## Submission of the proposal as an external motion to Council

A [Council member](../maintain/maintain-guides-how-to-join-council.md) will need to assist you in
order to be able to submit an external motion: they will use the proposal hash for your preimage and
submit it to Council vote. The same contextual information you used in the discussion post will be
used for the motion post on Polkassembly.

Once the Council approves your proposal, this will move to the external queue - and soon after to be
voted by the community in the Referenda queue: make sure to discuss the proposal with your parachain
community and encourage them to vote. You can follow all announcements on these submissions in the
[Polkadot Direction channel](https://matrix.to/#/#Polkadot-Direction:parity.io).

## Vote by the community

After the community voting period, there will be an enactment period. In general, on Kusama these
Expand Down

0 comments on commit 6953884

Please sign in to comment.