From b809ddff1b26713a87aa6ddf97e2b9c47d81c3b2 Mon Sep 17 00:00:00 2001 From: Dave de Fijter Date: Thu, 15 Sep 2022 17:08:01 +0200 Subject: [PATCH] Bumped version and updated to first draft of testnet docs --- .../docs/guide/chains_and_nodes/testnet.md | 97 +++++-------------- packages/wasp/constants.go | 2 +- 2 files changed, 25 insertions(+), 74 deletions(-) diff --git a/documentation/docs/guide/chains_and_nodes/testnet.md b/documentation/docs/guide/chains_and_nodes/testnet.md index 6d493a25a2..13d93d47a9 100644 --- a/documentation/docs/guide/chains_and_nodes/testnet.md +++ b/documentation/docs/guide/chains_and_nodes/testnet.md @@ -12,14 +12,12 @@ keywords: The testnet is deployed for the community to use for testing and interacting with smart contracts. :::caution unscheduled network resets -To make the barrier to entry for trying out the testnet as low as possible, we decided to set all possible fees to zero. -Since we expect this decision will pollute the chain quickly, we’ll perform regular, unscheduled network resets if -needed. +While we are in active development we might update and reset this chain at any time without prior notice; Keep this in mind while testing. ::: ## Introduction -This testnet is deployed with our GoShimmer cluster that backs smart contracts. Multiple committee nodes do the work for +This testnet is deployed on the Shimmer Beta Network (testnet). Multiple committee nodes do the work for the chain and multiple access nodes are exposed via the endpoints listed below. We do throttle the endpoints to prevent overloading the testnet because we are looking for functionality testing more than stress testing. @@ -27,29 +25,21 @@ overloading the testnet because we are looking for functionality testing more th You can access the testnet via the following endpoints: -- https://wasp.sc.iota.org . **Username**: wasp **Password**: wasp +- https://sc.testnet.shimmer.network **Username**: wasp **Password**: wasp - The Wasp dashboard to explore the node configuration and view peering/chain configurations - - https://api.wasp.sc.iota.org + - https://api.sc.testnet.shimmer.network - The Wasp api to deploy and interact with smart contracts - - https://api.wasp.sc.iota.org/info + - https://api.sc.testnet.shimmer.network/info - Information about the Wasp access node - https://api.wasp.sc.iota.org/doc - API reference for the Wasp API - - https://evm.wasp.sc.iota.org + - https://evm.sc.testnet.shimmer.network - The URL to interact with the Ethereum Virtual Machine on our testnet - - https://explorer.wasp.sc.iota.org - - The URL to interact with the Ethereum Block Explorer on our testnet -- https://goshimmer.sc.iota.org - - The GoShimmer dashboard to explore the Tangle backing our smart contract testnet - - goshimmer.sc.iota.org:5000 - - The TXStream TCP port to use for the `nodeconn` address with Wasp nodes. - - https://api.goshimmer.sc.iota.org/ - - The GoShimmer api to interact with the Tangle directly - - https://api.goshimmer.sc.iota.org/info - - Information about GoShimmer via the API -- https://demo.sc.iota.org - - Our FairRoulette demo application to see a live smart contract in action -- https://wasp.sc.iota.org/metrics +- https://api.testnet.shimmer.network + - The public API exposed by Hornet for the Shimmer Beta network (testnet) +- https://faucet.testnet.shimmer.network + - The faucet for the Shimmer Beta network +- https://sc.testnet.shimmer.network/metrics - System metrics ## Configuring `wasp-cli` @@ -62,12 +52,16 @@ You will need to initialize `wasp-cli` to create a seed that will be used to gen wasp-cli init ``` -### Set the GoShimmer API URL +### Configure for the test chain -Next, you should tell `wasp-cli` how to reach our GoShimmer node. +Next, you should tell `wasp-cli` how to reach our test chain: ```shell -wasp-cli set goshimmer.api https://api.goshimmer.sc.iota.org +wasp-cli set l1.apiaddress https://api.testnet.shimmer.network +wasp-cli set l1.faucetaddress https://faucet.testnet.shimmer.network +wasp-cli set chains.testchain rms1pzmg4h3tj8n7mg46slgnsttf9pr4tsta73r5mvhq9gr02e6kj0dhkalc670 +wasp-cli set chain testchain + ``` ### Request Funds @@ -79,62 +73,19 @@ following command to request some funds. wasp-cli request-funds ``` -### Configure the Wasp API URL - -Next, you need to let `wasp-cli` know how to reach _Wasp_ by configuring the API address. - -```shell -wasp-cli set wasp.0.api https://api.wasp.sc.iota.org -``` - -### Set the Chain ID - -You will need to set the chain ID in `wasp-cli` to find the correct chain. You can find the ChainID by navigating to -the [chains](https://wasp.sc.iota.org/chains) page of the wasp dashboard. Click on the ChainID of the chain. You will be -able to copy the ChainID from the next page. It will be formatted like `jaSDxeZNtum7kLuRg8oWQ6nXKgYjb3XVq7yiwnvtUG3C`. - -Use the ChainID to tell `wasp-cli` which chain you want to interact with: - -```shell -wasp-cli set chains.testchain jaSDxeZNtum7kLuRg8oWQ6nXKgYjb3XVq7yiwnvtUG3C -wasp-cli set chain testchain -``` - -### Test Your Chain - -We have deployed a FairRoulette game on the __testchain__. You can use to ensure your configuration is correct. - -```shell -wasp-cli --verbose chain post-request fairroulete placeBet string number int 2 -``` - -### Putting It All Together - -For simplicity, here is the full set of commands to configure `wasp-cli`. - -```shell -wasp-cli init -wasp-cli set goshimmer.api https://api.goshimmer.sc.iota.org -wasp-cli request-funds -wasp-cli set wasp.0.api https://api.wasp.sc.iota.org -wasp-cli set chains.testchain jaSDxeZNtum7kLuRg8oWQ6nXKgYjb3XVq7yiwnvtUG3C -wasp-cli set chain testchain -``` - ## Interact with EVM We have deployed an experimental EVM chain that you can interact with. To begin, add a custom network to Metamask with the following configuration: -| Key | Value | -|--------------------|-----------------------------------| -| RPC URL | https://evm.wasp.sc.iota.org | -| Chain ID | 1074 | -| Block Explorer URL | https://explorer.wasp.sc.iota.org | +| Key | Value | +|--------------------|------------------------------------------| +| RPC URL | https://evm..sc.testnet.shimmer.network | +| Chain ID | 1076 | -It should look similar to this image. -![MetaMask](/img/metamask_testnet.png) +We have a faucet for you to use directly with your EVM address which can be found on ... +We also have a withdrawal interface to get any native assets deposited to a EVM chain back into your L1 address: .... :::note diff --git a/packages/wasp/constants.go b/packages/wasp/constants.go index d02a18fd07..9fb14dec1c 100644 --- a/packages/wasp/constants.go +++ b/packages/wasp/constants.go @@ -4,7 +4,7 @@ var VersionHash string const ( // Version version number - Version = "0.3.0" + Version = "0.3.1" // Name app code name Name = "Wasp"