Hello World

Welcome to this Hello World with Pact Tutorial!

In this tutorial, you'll learn how to create, deploy, and run functions on a Hello World smart contract with Pact.

Topics covered in this tutorial

The goal of this tutorial is to help you get familiar with the essential Pact concepts needed to write, deploy, and run a smart contract. Learning these concepts will help you to create more complex smart contracts later in the series.

Subscribe to our YouTube channel to access the latest Pact tutorials.

To get started, navigate to the Pact online editor at (pact.kadena.io)[http://pact.kadena.io]. Once on the site, you can open the “Hello World” module. To do this, navigate to the module explorer on the tool panel and open the “Hello World” example.

You can also copy the code below and paste it into your editor.

This code can also be found here on our GitHub.

As you can see, the “Hello World” smart contract starts by defining and reading a keyset. Keysets are a way to specify credentials for a user of the smart contract. The code you write within the smart contract can restrict access to users that own the keysets you define. You will see this done in the Hello World module.

Line 16 (shown below) defines and reads a keyset named admin-keyset.

This error exists because you are reading a keyset that does not exist. To get rid of this error you need to create a keyset named admin-keyset using the panel on the right.

The error message should now be gone.

Now that you have created a keyset, it’s time to build the module for your smart contract. Modules are essential in Pact. They contain all the logic needed to run your smart contract.

The syntax used to create a module is shown below. This line defines a module named helloWorld. It also gives the admin-keyset access to the code within this module.

The next step is to create the contract functions. Functions are defined within Pact modules using the keyword (defun)[https://pact-language.readthedocs.io/en/latest/pact-reference.html#defun]. For this smart contract, you’ll define a function named hello that takes a parameter called name.

Within this function, you’ll write a formatted line to output into the REPL. You can do this using the keyword format. Format allows you to manipulate strings and will help you specify the output of the function.

This line outputs a string to the REPL that says Hello followed by the string input to the function parameter name.

The module for this smart contract is already complete! While this module is pretty simple, it gives you a great start to begin building more complex smart contracts.

The final step in this smart contract is to write “Hello World” to the REPL. To do this, write a line below the module that calls the function and provide the input for name.

The line above calls the function hello and specifies the name as “world”. You can change this input to any name you’d like.

Having written the smart contract, you are ready to load it into the REPL.

A REPL is an interactive computing environment. It stands for read, eval, print, loop. This REPL exists within the online editor allowing you to run Pact code from within the browser.

To load a contract into the REPL, select the Load into REPL button at the top of your editor.

If everything is working correctly, you will see the REPL open up on the right side of your screen with the Hello World message as shown below.

If you can see this message, your Hello World smart contract is running from within the REPL.

Loading into the REPL helps you test that your contract is working correctly, but it doesn't deploy it to a blockchain. When you're ready, you'll need to complete a few more steps to deploy your Hello World smart contract.

Here’s a quick summary of the steps needed to deploy to the blockchain.

First, you need to update the module name. This name needs to be unique across all module names that exist on the blockchain.

Choose any unique name you’d like. For example, my module name is helloWorld-tutorial (choose a unique name that is different than mine).

Along with a unique module name, you’ll also need a unique keyset name. This unique keyset ensures that only users with the keyset you define can gain access to the module. Delete the admin-keyset and create a new keyset with any unique name you like.

The example below shows a new keyset named admin-keyset-helloworld.

Having created a new keyset, you now need to update the code to match the name of the keyset you created. This name appears a few times in the smart contract so be careful to update each one.

The purpose of the keyset is to hold keys that you can use to sign and verify your identity.

When loading the contract to the REPL you were able to get away without having this key. To deploy your contract you need to make this key.

You can create a key by completing the following steps.

A simple convention for creating your key is to name it similar to the keyset.

After creating your key, you’ll see a checkbox appear under the admin-keyset with the name of the key. Select this checkbox to associate this key with the keyset.

At the top of the screen, select Deploy. This will open a box that allows you to set your deployment settings.

Once in the deployment settings, select either test-chain-01 or test-chain-02 to deploy your contract. Next, select the checkbox to sign this deployment with the key you created. Finally, select "deploy contract".

If everything worked correctly, you should now see the string “Hello World!” appear on the right panel as a message.

At this point, you have deployed your Hello World smart contract with Pact. Congratulations!

A fantastic feature of deploying to the blockchain is that anyone can now run the deployed code. You can check for yourself and run the function available on your own “Hello World” smart contract.

To do this, you’ll need to first find the contract from the module explorer.

Start by selecting the module explorer from the tool panel. Once there, navigate to the Deployed Contracts section and type the name of your contract. The name of your contract will be the same name as the module you created. After it appears, select view to see functions that are available for your smart contract.

After selecting view, you should see the function named hello as an available option. Click call to open the screen that allows you to place your inputs into this function.

Once on the Function: hello screen, you’re ready to call your function.

Steps to call a function

If everything worked out correctly, you should see the new function call appear as a new message!

Now you can you call functions on the code you’ve written, and you can call that code after it exists on the blockchain.

You can use this same idea to call functions on any other contracts that have been deployed to the blockchain. Try for yourself to see if you can make function calls on other smart contracts.

Congratulations on completing this tutorial!

Throughout this tutorial you built, deployed, and ran functions on your Hello World smart contract with Pact. You’re now prepared to play around and try anything you’d like. You can create and define new keysets, change the parameters, or add anything that comes to mind.

If you get lost, you can always go back to the module explorer to reload the original code. You can also visit the documentation using the link on the top right of the screen. Here you'll find more information about terminology, syntax, and other important ideas. If you’re up for it, you can also load in different modules using the explorer to see how a different program looks.