Skip to content

Commit

Permalink
Wiki Reorg: Renaming Statemin* -> Asset Hub (#4960)
Browse files Browse the repository at this point in the history
* added redenomination

- partial, build pages

* end renomination build pages

* major renomination

* modified keywords

* renamed files, additional edits

* edits vault tutorial

* Update docs/build/build-integrate-assets.md

Co-authored-by: joe petrowski <25483142+joepetrowski@users.noreply.github.com>

* minor edits articles

---------

Co-authored-by: joe petrowski <25483142+joepetrowski@users.noreply.github.com>
  • Loading branch information
filippoweb3 and joepetrowski committed Jun 30, 2023
1 parent 7521c27 commit 6231e06
Show file tree
Hide file tree
Showing 24 changed files with 218 additions and 241 deletions.
Binary file added docs/assets/asset-hub/hub-asset-0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file removed docs/assets/statemint/Statemint-asset-0.png
Binary file not shown.
12 changes: 6 additions & 6 deletions docs/build/build-hrmp-channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: build-hrmp-channels
title: Opening HRMP Channels
sidebar_label: Opening HRMP Channels
description: Steps on how to open HRMP channels between parachains.
keywords: [HRMP, parachain, Statemint, proposal]
keywords: [HRMP, parachain, statemint, proposal, asset hub, statemine]
slug: ../build-hrmp-channels
---

Expand Down Expand Up @@ -59,27 +59,27 @@ identity.
Your proposal should contain the following sections to be considered complete for the community to
review and ultimately vote:

1. A request on what the proposal aims to do (opening an HRMP channel with Statemint);
1. A request on what the proposal aims to do (opening an HRMP channel with the Asset Hub);
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) :

- A force transfer from Polkadot treasury to Statemint as deposit to accept and open an HRMP
- 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 Statemint to execute a transaction with superuser (root) permission.
- Send XCM message to the Asset Hub to execute a transaction with superuser (root) permission.

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).

4. The XCM message to Statemint, which can be decoded on the network;
4. The XCM message to the Asset Hub, which can be decoded on the network;
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.

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

- Proposal to open HRMP channel between Bifrost and Statemine: the motion can be found
- Proposal to open HRMP channel between Bifrost and the Asset Hub: the motion can be found
[here](https://kusama.polkassembly.io/motion/418).

## Preimage submission on democracy tab (Polkadot JS Apps)
Expand Down
48 changes: 19 additions & 29 deletions docs/build/build-integrate-assets.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,14 @@ slug: ../build-integrate-assets

The {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Relay Chain does not natively
support assets beyond {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} This functionality
exists in parachains. On Polkadot, this parachain is called Statemint, and on Kusama it is called
Statemine. All information in this guide applies equally to Kusama/Statemine.
exists in parachains. On both Polkadot and Kusama, this parachain is called Asset Hub.

Statemint provides a first-class interface for creating, managing, and using both fungible and
The Asset Hub provides a first-class interface for creating, managing, and using both fungible and
non-fungible assets. The fungible interface is similar to Ethereum's ERC-20 standard. However, the
data structures and stateful operations are encoded directly into the chain's runtime, making
operations fast and fee-efficient.

Beyond merely supporting assets, integrating Statemint into your systems has several benefits for
Beyond merely supporting assets, integrating an Asset Hub into your systems has several benefits for
infrastructure providers and users:

- Support for on-chain assets.
Expand All @@ -27,13 +26,13 @@ infrastructure providers and users:
- Ability to pay transaction fees in certain assets. As in, accounts would **not** need DOT in order
to exist on-chain nor to pay fees.

Statemint will use DOT as its native currency. Users can transfer DOT from the Relay Chain into
Statemint and use it natively. The Relay Chain will also accept DOT transfers from Statemint back to
the Relay Chain to use for staking, governance, or any other activity taking place there.
The Asset Hub will use DOT as its native currency. Users can transfer DOT from the Relay Chain into
the Asset Hub and use it natively. The Relay Chain will also accept DOT transfers from the Asset Hub
back to the Relay Chain to use for staking, governance, or any other activity taking place there.

Using Statemint for DOT/KSM balance transfers will be much more efficient than the Relay Chain and
is highly recommended. Until domain specific parachains are built, the Relay Chain will still need
to be used for staking and governance.
Using the Asset Hub for DOT/KSM balance transfers will be much more efficient than the Relay Chain
and is highly recommended. Until domain specific parachains are built, the Relay Chain will still
need to be used for staking and governance.

## Assets Basics

Expand Down Expand Up @@ -70,40 +69,31 @@ Asset transfers will result in an `assets.transferred` event. The same instructi
[monitoring events and **not** transactions](build-protocol-info.md#events) applies to asset
transfers.

Note that you can use the same addresses (except anonymous proxies!) on Statemint that you use on
the Relay Chain. The SS58 encodings are the same, only the chain information (genesis hash, etc.)
Note that you can use the same addresses (except
[pure proxies](../learn/learn-proxies.md#anonymous-proxy-pure-proxy)!) on the Asset Hub that you use
on the Relay Chain. The SS58 encodings are the same, only the chain information (genesis hash, etc.)
will change on transaction construction.

## Integration

Statemint will come with the same tooling suite that Parity Technologies provides for the Relay
The Asset Hub will come with the same tooling suite that Parity Technologies provides for the Relay
Chain, namely [API Sidecar](https://github.com/paritytech/substrate-api-sidecar) and
[TxWrapper Polkadot](https://github.com/paritytech/txwrapper-core/tree/main/packages/txwrapper-polkadot).
If you have a technical question or issue about how to use one of the integration tools please file
a GitHub issue so a developer can help.

### Parachain Node

Using Statemint will require running a parachain node to sync the chain. This is very similar to
Using the Asset Hub will require running a parachain node to sync the chain. This is very similar to
running a {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} node, with the addition of
some extra flags. The basic format looks like this:

```bash
./statemint $STATEMINT_CLI_ARGS --collator -- $POLKADOT_CLI_ARGS
```

where both `$STATEMINT_CLI_ARGS` and `$POLKADOT_CLI_ARGS` consist of regular Polkadot node flags.
Flags can be used twice, one for the collating component and one for the Relay Chain component.
Additional ports that will be used are (by default) 9934, 9616, and 30334 (Relay Chain RPC,
Prometheus endpoint, and libp2p respectively). As usual, any of these ports can be adjusted through
flags. To deploy a Statemint RPC node, one would use the same flags as a Polkadot RPC node in place
of `$STATEMINT_CLI_ARGS`. The node will keep both the database for Polkadot and for Statemint in its
database directory, so provision disks accordingly.
some extra flags. You can follow
[these guidelines](https://github.com/paritytech/cumulus/blob/master/README.md#asset-hub-) to set up
an Asset Hub node.

### Sidecar

API Sidecar is a REST service for Relay Chain and parachain nodes; It comes with endpoints to query
info about assets and asset balances on Statemint.
info about assets and asset balances on the Asset Hub.

- Asset lookups will always use the `AssetId` to refer to an asset class. On-chain metadata is
subject to change and thus not suitable as a canonical index.
Expand All @@ -113,7 +103,7 @@ info about assets and asset balances on Statemint.
### Tx Wrapper Polkadot

TxWrapper Polkadot is a library designed to facilitate transaction construction and signing in
offline environments; it comes with a set of asset-specific functions to use on Statemint. When
offline environments; it comes with a set of asset-specific functions to use on the Asset Hub. When
constructing parachain transactions, you can use `txwrapper-polkadot` exactly as on the Relay Chain,
but would construct transactions with the appropriate parachain metadata like genesis hash, spec
version, and type registry.
2 changes: 1 addition & 1 deletion docs/build/build-parachains.md
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@ Relay-routed Message Passing) in order to send transfers and messages between pa
Chain. Every message is sent to the Relay Chain, then from the Relay Chain to the desired parachain.

Rococo runs a few test system parachains:
[Rockmine](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frococo-statemint-rpc.polkadot.io#/explorer),
[Rockmine](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frococo-asset-hub-rpc.polkadot.io#/explorer),
and
[Contracts](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frococo-contracts-rpc.polkadot.io#/explorer).
It also runs several externally developed parachains.
Expand Down
8 changes: 4 additions & 4 deletions docs/build/build-protocol-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,11 +112,11 @@ is seperate to that of the Relay Chain ED.

:::

:::note Existential deposit for Statemint
:::note Existential deposit for the Asset Hub

The Statemint parachain has a lower existential deposit (0.1 DOT) than the Relay Chain (1 DOT) as
well as lower transaction fees. It is highly recommended to handle balance transfers on Statemint.
Statemint integration is discussed in the next page of the guide.
The Asset Hub parachain has a lower existential deposit (0.1 DOT) than the Relay Chain (1 DOT) as
well as lower transaction fees. It is highly recommended to handle balance transfers on the Asset
Hub. Asset Hub integration is discussed in the next page of the guide.

:::

Expand Down
9 changes: 4 additions & 5 deletions docs/general/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ potentially receive staking rewards in return for doing so.

The fourth (now defunct) proof of concept (PoC-4) [testnet](#testnet) for Polkadot.

## Asset Hub

A system parachain used for asset management.

## Attestation

In the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} validity system, an
Expand Down Expand Up @@ -662,11 +666,6 @@ valid block (and thus obtain a block reward). Validators and nominators stake th
A function that describes how the state of a blockchain can be transformed. For example, it may
describe how tokens can be transferred from one account to another.

## Statemint

A system parachain used for asset management. The Kusama version is called Statemine; the Westend
version is called Westmint.

## Substrate

A modular framework for building blockchains.
Expand Down
6 changes: 3 additions & 3 deletions docs/general/how-to-dyor.md
Original file line number Diff line number Diff line change
Expand Up @@ -205,9 +205,9 @@ Kusama or directly on Polkadot.

However, building a potential parachain is not the only way to build on
{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} and expand its ecosystem. A project
might aim to build a DeFi platform on a parachain, launch a stablecoin or other token on Statemint,
build a decentralized exchange, or any other dApp that one might think of, without ever touching the
Relay Chain. And that's the beauty of
might aim to build a DeFi platform on a parachain, launch a stablecoin or other token on the Asset
Hub, build a decentralized exchange, or any other dApp that one might think of, without ever
touching the Relay Chain. And that's the beauty of
{{ polkadot: Polkadot! :Polkadot }}{{ kusama: Kusama! :kusama }}

But in all of those cases, their plans to build on
Expand Down
Loading

0 comments on commit 6231e06

Please sign in to comment.