Open In App

Flutter and Blockchain – Hello World Dapp

Flutter and Blockchain

This tutorial will take you through the process of building your first mobile dapp – Hello World Dapp!

This tutorial is meant for those with a basic knowledge of Ethereum and smart contracts, who have some knowledge of the Flutter framework but are new to mobile dapps.

In this tutorial we will be covering:

  1. Setting up the development environment
  2. Creating a Truffle Project
  3. Writing your first Smart Contract
  4. Compiling and Migrating the Smart Contract
  5. Testing the Smart Contract
  6. Contract linking with Flutter
  7. Creating a UI to interact with the smart contract
  8. Interacting with the complete Dapp

Setting up the development environment

Truffle is the most popular development framework for Ethereum with a mission to make your life a whole lot easier. But before we install truffle make sure to install node .

Once we have node installed, we only need one command to install Truffle:

npm install -g truffle

We will also be using Ganache, a personal blockchain for Ethereum development you can use to deploy smart contracts, develop applications, and run tests. You can download Ganache by navigating to and clicking the “Download” button.

Creating a Truffle Project

  1. Create a basic Flutter project in your favorite IDE
  2. Initialize Truffle in the flutter project directory by running
truffle init

Directory Structure

Writing your first Smart Contract

The Smart Contract actually acts as the back-end logic and storage for our Dapp.

  1. Create a new file named HelloWorld.sol in the contracts/ directory.
  2. Add the following content to the file:

pragma solidity ^0.5.9;
contract HelloWorld {

Variable Setup

  1. Add the following variable on the next line after contract HelloWorld { 

string public yourName ;

We just defined a single variable yourName of type string, also yourName is a public modifier which means that we can access it from outside the smart contract.


  1. Add the following constructor on the next line after string public yourName ;

constructor() public {
        yourName = "Unknown" ;

Constructor in solidity executed only once, when a contract is created and it is used to initialize contract state. Here we’re just setting the initial value of variable yourName to “Unknown”.


  1. Add the following function to the smart contract after the constructor declaration we set up above.

function setName(string memory nm) public{
        yourName = nm ;

Compiling and Migrating 


  1. In a terminal, make sure you are in the root of the directory that contains the flutter and truffle project, Run the following command:
truffle compile

You should see output similar to the following:

truffle compile


You’ll see one JavaScript file already in the migrations/ directory: 1_initial_migration.js. This handles deploying the Migrations.sol contract to observe subsequent smart contract migrations, and ensures we don’t double-migrate unchanged contracts in the future.

Let’s create our own migration script :

  1. Create a new file named 2_deploy_contracts.js in the migrations/ directory.
  2. Add the following content to the 2_deploy_contracts.js file:

const HelloWorld = artifacts.require("HelloWorld");
module.exports = function (deployer) {


module.exports = {
  networks: {
     development: {
      host: "",     // Localhost (default: none)
      port: 7545,            // Standard Ethereum port (default: none)
      network_id: "*",       // Any network (default: none)
    contracts_build_directory: "./src/artifacts/",
  // Configure your compilers
  compilers: {
    solc: {    
       // See the solidity docs for advice
       // about optimization and evmVersion
        optimizer: {
          enabled: false,
          runs: 200
        evmVersion: "byzantium"

truffle migrate

You should see output similar to the following:

truffle migrate

Testing the Smart Contract

In Truffle, we can write tests either in JavaScript or Solidity, In this article, we’ll be writing our tests in Javascript using the Chai and Mocha libraries.

  1. Create a new file named helloWorld.js in the test/ directory.
  2. Add the following content to the helloWorld.js file:

const HelloWorld = artifacts.require("HelloWorld") ;
contract("HelloWorld" , () => {
    it("Hello World Testing" , async () => {
       const helloWorld = await HelloWorld.deployed() ;
       await helloWorld.setName("User Name") ;
       const result = await helloWorld.yourName() ;
       assert(result === "User Name") ;

Running the tests

truffle test

truffle test

Contract linking with Flutter

provider: ^4.3.3
web3dart: ^1.2.3
http: ^0.12.2
web_socket_channel: ^1.2.0
    - src/artifacts/HelloWorld.json
  1. Create a new file named contract_linking.dart in the lib/ directory.
  2. Add the following content to the file:

import 'package:flutter/material.dart';
class ContractLinking extends ChangeNotifier {


final String _rpcUrl = "";
final String _wsUrl = "ws://";
final String _privateKey = "Enter Private Key";

The library web3dart won’t send signed transactions to miners itself. Instead, it relies on an RPC client to do that. For the WebSocket URL just modify the RPC URL. You can get the RPC URL from the ganache :

Ganache – RPC url

Ganache – Private Key

Web3Client _client;
bool isLoading = true;
String _abiCode;
EthereumAddress _contractAddress;
Credentials _credentials;
DeployedContract _contract;
ContractFunction _yourName;
ContractFunction _setName;
String deployedName;

  1. _client variable will be used to establish a connection to the ethereum rpc node with the help of WebSocket.
  2. isLoading variable will be used to check the state of the contract.
  3. _abiCode variable will be used to, read the contract abi.
  4. _contractAddress variable will be used to store the contract address of the deployed smart contract.
  5. _credentials variable will store the credentials of the smart contract deployer.
  6. _contract variable will be used to tell Web3dart where our contract is declared.
  7. _yourName and _setName variable will be used to store the functions declared in our HelloWorld.sol smart contract.
  8. deployedName will hold the name from the smart contract.


ContractLinking() {
  initialSetup() async {
    // establish a connection to the ethereum rpc node. The socketConnector
    // property allows more efficient event streams over websocket instead of
    // http-polls. However, the socketConnector property is experimental.
    _client = Web3Client(_rpcUrl, Client(), socketConnector: () {
      return IOWebSocketChannel.connect(_wsUrl).cast<String>();
    await getAbi();
    await getCredentials();
    await getDeployedContract();
  Future<void> getAbi() async {
    // Reading the contract abi
    String abiStringFile =
        await rootBundle.loadString("src/artifacts/HelloWorld.json");
    var jsonAbi = jsonDecode(abiStringFile);
    _abiCode = jsonEncode(jsonAbi["abi"]);
    _contractAddress =
  Future<void> getCredentials() async {
    _credentials = await _client.credentialsFromPrivateKey(_privateKey);
  Future<void> getDeployedContract() async {
    // Telling Web3dart where our contract is declared.
    _contract = DeployedContract(
        ContractAbi.fromJson(_abiCode, "HelloWorld"), _contractAddress);
    // Extracting the functions, declared in contract.
    _yourName = _contract.function("yourName");
    _setName = _contract.function("setName");
  getName() async {
    // Getting the current name declared in the smart contract.
    var currentName = await _client
        .call(contract: _contract, function: _yourName, params: []);
    deployedName = currentName[0];
    isLoading = false;
  setName(String nameToSet) async {
    // Setting the name to nameToSet(name defined by user)
    isLoading = true;
    await _client.sendTransaction(
            contract: _contract, function: _setName, parameters: [nameToSet]));

Creating a UI to interact with the smart contract

  1. Create a new file named helloUI.dart in the lib/ directory.
  2. Add the following content to the file:

import 'package:flutter/material.dart';
import 'package:hello_world/contract_linking.dart';
import 'package:provider/provider.dart';
class HelloUI extends StatelessWidget {
  Widget build(BuildContext context) {
    // Getting the value and object or contract_linking
    var contractLink = Provider.of<ContractLinking>(context);
    TextEditingController yourNameController = TextEditingController();
    return Scaffold(
      appBar: AppBar(
        title: Text("Hello World !"),
        centerTitle: true,
      body: Container(
        padding: EdgeInsets.symmetric(horizontal: 20),
        child: Center(
          child: contractLink.isLoading
              ? CircularProgressIndicator()
              : SingleChildScrollView(
            child: Form(
              child: Column(
                children: [
                    children: [
                        "Hello ",
                        style: TextStyle(
                            fontWeight: FontWeight.bold, fontSize: 52),
                        style: TextStyle(
                            fontWeight: FontWeight.bold,
                            fontSize: 52,
                            color: Colors.tealAccent),
                    padding: EdgeInsets.only(top: 29),
                    child: TextFormField(
                      controller: yourNameController,
                      decoration: InputDecoration(
                          border: OutlineInputBorder(),
                          labelText: "Your Name",
                          hintText: "What is your name ?",
                          icon: Icon(Icons.drive_file_rename_outline)),
                    padding: EdgeInsets.only(top: 30),
                    child: ElevatedButton(
                      child: Text(
                        'Set Name',
                        style: TextStyle(fontSize: 30),
                      style: ElevatedButton.styleFrom(
                      onPressed: () {

import 'package:flutter/material.dart';
import 'package:hello_world/contract_linking.dart';
import 'package:hello_world/helloUI.dart';
import 'package:provider/provider.dart';
void main() {
class MyApp extends StatelessWidget {
  Widget build(BuildContext context) {
    // Inserting Provider as a parent of HelloUI()
    return ChangeNotifierProvider<ContractLinking>(
      create: (_) => ContractLinking(),
      child: MaterialApp(
        title: "Hello World",
        theme: ThemeData(
            brightness: Brightness.dark,
            primaryColor: Colors.cyan[400],
            accentColor: Colors.deepOrange[200]),
        home: HelloUI(),

Interacting with the complete Dapp

Hello World Dapp

As you can see the Hello Unknown, in the UI is actually coming from the smart contract, variable yourName .

When you type your name into the TextFormField and Press `Set Name` ElevatedButton, it will invoke the setName function from contract_linking.dart which will directly invoke the setName function of our smart contract (HelloWorld.sol).

Hello World Dapp

Hello World Dapp

Hello World Dapp

Congratulations! You have taken a huge step to become a full-fledged mobile dapp developer. For developing locally, you have all the tools you need to start making more advanced dapps.

If you stuck somewhere, do check out the GitHub repository for complete code.

Article Tags :