Skip to content

Commit

Permalink
Merge branch 'develop' into feature/improve-project-structure
Browse files Browse the repository at this point in the history
  • Loading branch information
WRRicht3r authored Sep 19, 2024
2 parents 0553872 + 485f1fa commit 7e1ffae
Show file tree
Hide file tree
Showing 12 changed files with 87 additions and 14 deletions.
2 changes: 1 addition & 1 deletion .vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ export default withMermaid(
},
{ text: "Transfer Assets", link: "transfer" },
{ text: "Check Balance", link: "check-balance" },
{ text: "Register an Asset", link: "register-an-asset" },
{ text: "Create token in SORA", link: "create-token" },
{ text: "On-ramp", link: "on-ramp" },
{
text: "Staking",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 8 additions & 4 deletions src/adding-tokens-to-hashi-bridge.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,15 +34,19 @@ Refer to [Registration](/register-an-asset.md) for the instructions on registeri

3. Copy the preimage hash of your created preimage and submit a proposal in _Governance > Democracy_. Alternatively, you can reach out to a council member for the Council to directly create a motion to add the asset to the bridge with the preimage you created. This will fast-track the process of adding the asset to the bridge.

4. Once the proposal goes through, acquire the signatures of the bridge’s peers via the `ethBridge.getAccountRequests` RPC with your account as the first argument and status `ApprovalsReady`.
4. You should get the authorityAccount for the Bridge

![](.gitbook/assets/hashi-acquire-authority-account.png)

5. Once the proposal goes through, acquire the signatures of the bridge’s peers via the `ethBridge.getAccountRequests` RPC with your account as the first argument and status `ApprovalsReady`.

![](.gitbook/assets/hashi-acquire-signatures.png)

5. The RPC will return a bunch of hashes. These are off-chain request hashes; the last one should be the `OutgoingAddAsset` request. To determine if the asset was added successfully, use the `getRequests` RPC.
6. The RPC will return a bunch of hashes. These are off-chain request hashes; the last one should be the `OutgoingAddAsset` request. To determine if the asset was added successfully, use the `getRequests` RPC.

6. After finding your hash, use the `getApprovedRequests` RPC to get the approvals.
7. After finding your hash, use the `getApprovedRequests` RPC to get the approvals.

7. Call `addEthSidechainToken` in the bridge's smart contract.
8. Call `addEthSidechainToken` in the bridge's smart contract.

### Using Remix

Expand Down
Binary file added src/assets/account-button-create.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/button-create-token.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/confrim-create-token.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/create-token.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/new-token-details.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/new-token-in-portfolio.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 77 additions & 0 deletions src/create-token.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
title: "Create a new token in SORA Network | SORA Docs"
head:
- - meta
- name: description
content: Explore the process of creating a token on the SORA network. Learn how community members can create a new token and contribute to the development of the SORA ecosystem by submitting their ideas and collaborating with the SORA team.
- - meta
- name: keywords
content: adding tokens, Polkaswap, SORA network, listing tokens, requirements, procedures, blockchain networks, whitelist, create token, create a new token, register a new token
---

# How to Create a Token on the SORA Network

## TL;DR

- This guide provides a step-by-step process for creating tokens on the SORA network, ensuring a smooth and straightforward experience.
- As a decentralized network, SORA invites everyone to participate in the growth of the new economy, and creating a new token is one of the many ways to get involved.

## Connect Your Wallet

Before creating a new token, you need to connect your crypto wallet with Polkaswap. Please follow the instructions on this page: [Connect Your Wallet to Polkaswap](./polkaswap-connect-wallet.md)

Alternatively, you can create an account and wallet on the SORA network using your Google account. Instructions for this process are available here: [Connect With Google](./polkaswap-connect-with-google.md)

We recommend to add XOR to the account to pay the fee for token creation. For that, you can [move either XOR or another ERC-20 token](https://wiki.sora.org/guides/how-to-transfer-from-ethereum-mainnet-to-sora-v2-hashi-bridge), such as ETH or DAI, that you can then exchange to XOR on [Polkaswap](https://polkaswap.io/#/swap).

## Create a New Token

Open the Account page from the menu on the right. In the top-right corner of the central panel, find and click the "Create" button, which is represented by a star icon.

![](./assets/account-button-create.jpg)

A new panel will appear where you can select your token and enter the required information. Fill in the following details:

- `Token Symbol`: A unique identifier for the token, which can be between 1 and 7 characters.
- `Token Name`: The name of the token, which can be between 1 and 33 characters.
- `Token Supply`: The total number of tokens you will receive upon creation.

::: info
If you want the option to mint more tokens in the future, enable the **Extensible Supply** toggle. Otherwise, leave it turned off.
:::

![](./assets/create-token.jpg)

Below the "Create" button, you will see the Network Fee displayed in XOR, calculated based on the current USD price.

![](./assets/button-create-token.jpg)

After clicking the "Create" button, a central panel will display a confirmation of your action along with all the information you provided.

![](./assets/confrim-create-token.jpg)

The process of creating and minting your new token will begin. Within a few seconds, your token will appear in your portfolio and will have an address on the SORA network.

![](./assets/new-token-in-portfolio.jpg)

Open your token to view its details, operation history, and available functions such as send, swap, add liquidity, bridge transfer, and QR code transactions.

![](./assets/new-token-details.jpg)

Note: Initially, your token might display a question mark instead of an icon, and it may lack additional information. Follow the next steps to address this.

## Next Steps

After creating your new token on the SORA network, you need to add it to Polkaswap. For detailed instructions, please refer to this page: [Whitelist a Token on Polkaswap](./whitelist-token-to-polkaswap.md)

::: info
Please note that adding token to SORA network does not mean that it
will automatically be allowed to be transferred through the HASHI
bridge. To add your token to the HASHI bridge, please, check out
[Adding a Token to the HASHI Bridge](../snippets/../adding-tokens-to-hashi-bridge).
:::

## Learn More

- [Whitelist a Token on Polkaswap](./whitelist-token-to-polkaswap.md)
- [SORA Builders Programme](/sora-builders)
8 changes: 0 additions & 8 deletions src/kensetsu-vaults.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,10 +66,6 @@ The stability fee that will be charged from these vaults will be used in a stabi

![](/.gitbook/assets/ken-vaults-intro.png)

::: info
Kensetsu has not been released on the mainnet yet. You can test the features on the [Polkaswap Testnet](https://test.polkaswap.io/#/vaults/).
:::

![](/.gitbook/assets/ken-vaults-borrow.png)

The vault creation interface has several input fields:
Expand Down Expand Up @@ -102,10 +98,6 @@ These are the parameters visible on the Open Position interface:

Congratulations, you have successfully set up your Kensetsu vault.

:::info
The images provided in this tutorial correspond to the Kensetsu Testnet and may be subject to change once released on the mainnet.
:::

## Learn More

- [KEN Tokenomics](/ken.md)
Expand Down
2 changes: 1 addition & 1 deletion src/whitelist-token-to-polkaswap.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ head:
content: Learn how to add tokens to the Polkaswap on the SORA network. Discover the step-by-step process of listing new tokens on Polkaswap, including the requirements, procedures, and considerations for adding tokens.
- - meta
- name: keywords
content: adding tokens, Polkaswap, SORA network, listing tokens, requirements, procedures, asset bridging, interoperability, blockchain networks, whitelist
content: adding tokens, Polkaswap, SORA network, listing tokens, requirements, procedures, asset bridging, interoperability, blockchain networks, whitelist, create token
---

# Whitelist a Token on Polkaswap
Expand Down

0 comments on commit 7e1ffae

Please sign in to comment.