Connect to a Public Blockchain
The aim of this tutorial is to transform the Demo App to let it connect to an external Ethereum Geth client connected to the Ropsten public test net provided by Chainstack. We thank them for their help and generosity! Chainstack offers a rich suite of services that are complimentary to Platform 6. Combine Chainstack and Platform 6, and you have all you need to build a full-fledged decentralized transactional application leveraging blockchain technology.
Step 1: Install a P6 Core instance and the Demo App¶
Before embarking on this journey, please make sure to carefully follow the previous tutorial Learn with the Demo App to get familiarized with the Demo App.
Before proceeding any further, you need to have an instance of P6 Core running with the Demo App. Make sure the Demo App is working properly by searching for transactions as shown below:
Step 2: Create a wallet and credit it on Ropsten¶
In this step we are going to create a wallet for test purposes. This wallet needs to be credited on Ropsten. Once credited, it will be used to deploy the Demo App’s smart contract and issue transactions on Ropsten.
First, go to the Scripts menu and create a new script called
GenerateWallet, fill the description field as you wish.
Then in the edit pane, paste the following code:
def walletPassword = "ADummyPassword" def walletJson = p6.web3ethereum.generateNewCredential(walletPassword, true) println(walletJson)
Do not change the password above because it’s used across the Demo App. Evidently this is bad practice, always store your secrets in a vault for an application in production. The Demo App is, as its name implies, only for demo purposes.
Save and run the script, it should output the created wallet JSON as shown below:
Save the JSON string in a text file on your file system.
The next step will consist in crediting the wallet you’ve just created. For that purpose, make sure the Metamask browser plugin is installed in your browser.
Once installed, click on Metamask’s logo then go to the top right menu and click on Import Account. Select the JSON File type and upload the text file you created previously as shown below:
Once created, select the new account to be used in subsequent transactions.
And most importantly, select the Ropsten network in Metamask as shown below:
To credit your wallet, you need to go to https://faucet.metamask.io/ then click on request 1 ether from faucet. At the bottom of the page a transaction id should appear in the transactions section, click on it to follow the execution of your transaction on Etherscan. After roughly a minute or two, the status should be IN.
You can also verify that your wallet was credited in Metamask.
Now we are all set to switch the Demo App from using the locally running demo blockchain node to the public Ropsten network!
Step 3: Update the Demo App’s configuration¶
Go the Configuration menu on the left, and first edit the
ethClientURL by clicking on the Edit button.
Set the value to
https://nd-080-674-678.p2pify.com. This is the URL of a Geth client running in Chainstack’s cloud connected
Also, edit the
demoWallet config entry with the JSON you saved in a text file earlier in the tutorial as shown below:
Then, add 2 new configuration entries with the following values:
The end result should look like this:
Step 4: Update the Demo App’s scripts¶
Next we are going to update scripts to read the newly introduced configuration entries.
Go to the Scripts menu and edit the
Be careful, there are 2 script resources associated to this script, select the second one on the left.
Replace lines 40 and 41 with the code below and save:
def ethClientURL = context.p6.appconfig.get('ethClientURL') def chainstackUsername = context.p6.appconfig.get('', 'chainstackUsername') def chainstackPassword = context.p6.appconfig.get('', 'chainstackPassword') this.web3j = context.p6.web3ethereum.build(ethClientURL, chainstackUsername, chainstackPassword)
Next, you need to edit the
PostInstallApplication script. Replace line 18 with the code below and save:
def ethClientURL = p6.appconfig.get('ethClientURL') def chainstackUsername = p6.appconfig.get('', 'chainstackUsername') def chainstackPassword = p6.appconfig.get('', 'chainstackPassword') def web3j = p6.web3ethereum.build(ethClientURL, chainstackUsername, chainstackPassword)
Finally, restart the Scripts service by clicking on Stop then Start in the top right corner of the screen as shown below:
Step 5: Update the Demo App’s routes¶
Go to the Routes menu and edit the
addRoutes segment replace line 1 with:
from("web3j://" + ethClientURL + "?address=" + contractAddress + "&operation=ETH_LOG_FLOWABLE" + "&username=" + chainstackUsername + "&password=" + chainstackPassword)
Then, in the
preProcessingStatement segment after line 12 add:
def chainstackUsername = p6.appconfig.get('', 'chainstackUsername') def chainstackPassword = p6.appconfig.get('', 'chainstackPassword')
Save the route and go to the Scripts menu.
Step 6: Switch to Ropsten¶
Go to the Scripts menu and run the modified
It will deploy the Demo App’s smart contract on Ropsten using your fresh demo wallet.
This will take a few minutes so be patient. Once the deployment transaction is confirmed on the blockchain, the script
will update the configuration entry
contractAddress with the address of the newly deployed smart contract.
Therefore, you need to go to the Routes service and restart the
BlockchainEventHandler route to let it load the correct
smart contract address from the configuration.
Step 7: Turn off the Demo blockchain container¶
At this stage, your Demo App is running on the Ropsten test net!
Therefore, you can safely shutdown the
demobc container by running:
docker stop demobc
The Demo App automatically creates new transactions every 10 minutes. However, you can manually create new ones by running
CreateRFQTransaction script. The execution is obviously much slower than with the local demo blockchain.
You can then search for your newly created transaction in the Transactions menu. Don’t hesitate to play with the Workflow Tasks which will generate transactions on the blockchain too.
As you play with the Demo App and create new transactions, you can monitor your Ether consumption in Metamask.