top of page
Writer's pictureEko Lance

Solidity Programming Language Guide

Solidity programming language logo

Smart contracts are a foundational component of blockchain technology, particularly for decentralized applications (dApps). To develop these contracts on the Ethereum blockchain, Solidity is the most commonly used language. 


Following a Solidity developer survey, Solidity is the most widely used programming language for developing smart contracts on Ethereum, with adoption rates reaching over 85% among Web3 developers working on Ethereum-based projects. It was created in 2015 by Dr. Gavin Wood, and it has become very valuable to the blockchain ecosystem, powering decentralized applications (DApps) and enabling the creation of tokens, DeFi protocols, and other blockchain utilities.


According to data from GitHub and developer surveys, Solidity projects have increased by over 50% annually since 2020, reflecting its growing relevance in Web3 as Ethereum and compatible blockchains gain traction. Solidity's syntax, influenced by JavaScript and C++, makes it accessible for developers transitioning from traditional programming, helping drive this expansion.


In this article, we’ll dive into Solidity programming by exploring a simple smart contract for managing community memberships, such as one for the EkoLance community.


By the end of this guide, you’ll have a clear understanding of how to structure and deploy a basic contract on Ethereum, and how to work with key Solidity features like structs, mappings, and events.


What is Solidity?

Solidity is a statically typed, contract-oriented, high-level programming language designed for writing smart contracts on Ethereum-based blockchain platforms. It is influenced by languages such as C++, Python, and JavaScript, making it familiar to many developers.


Smart contracts in Solidity are written in files with a .sol extension. These contracts define the logic and behavior of applications that will be deployed to the Ethereum network. Like most programming languages, Solidity supports common constructs such as variables, data types, functions, loops, and conditional statements.


What are Smart Contracts?

A smart contract is a type of program stored on a blockchain that runs automatically when certain pre-defined conditions are satisfied. These digital contracts are designed to facilitate and enforce agreements without requiring a third-party intermediary, as the code itself manages every aspect of execution.

By relying on these self-executing contracts, participants can engage in transactions or agreements with the assurance that the terms will be fulfilled as intended.

Smart contracts are often used to automate complex processes across various industries, from finance and real estate to supply chain and digital identity verification, making interactions more efficient, transparent, and secure.


Building a Simple Solidity Contract: EkolanceJoin

Let’s break down how a simple Solidity contract can be built to manage the membership of the EkoLance community. This contract allows users to join the community by providing their name and email.


1. Declaring the Contract Structure

To begin, we'll define the contract EkoLanceJoin, which handles the logic for users to join the community.

In Solidity, we declare variables and data types explicitly. Since Solidity is a statically typed language, we must specify the data types of all variables.

Image defining a smart contract, declaring variables and data types

Key Components of the Contract

Structs: In Solidity, structs allow you to group related data. In this case, we used the Member struct to hold a user’s name, email, and join date.

Images depicting the components of the contracts, featuring structs, mapping, events, and functions

Mapping: Solidity provides a built-in data structure called mapping that functions like a key-value store. In this contract, we use a mapping to associate Ethereum addresses (which are unique) with member structs, allowing us to store each member's information securely.

Images depicting the mapping components of the contracts

Events: Solidity allows you to log events to the blockchain. The NewMember event is triggered every time a user successfully joins the community. This helps track new members for external applications that interact with the blockchain.


We also keep track of the total number of members using the memberCount variable:

The uint256 type represents a non-negative integer value up to 256 bits.

Images depicting the event  components of the contracts

Functions: The joinEkoLance function allows users to join the community. It takes two parameters (name and email), validates them, and stores the user’s information in the members mapping. It also emits the NewMember event and increments the memberCount.


Events in Solidity allow you to log information that can be accessed outside the blockchain.

Images showing the functions components of the contracts

When a user wants to join the EkoLance community, they call the joinEkoLance function:

The string memory parameter types indicate that the function expects string values stored in memory, not on the blockchain's storage.

Image depicting the string memory

The function first performs some validation checks to ensure the name and email are not empty and the user is not already a member:


The require statements ensure that certain conditions are met before the function can proceed.

Image showing the Require statement

The joinEkolance function then creates a new Member struct and stores it in the members mapping, using the caller's Ethereum address (msg. sender) as the key. 


The joinDate is set to the current block timestamp:

Image of codes showing the JoinEkoLance function

To retrieve a member's information, the contract provides the getMemberInfo function:


The view keyword indicates that this function does not modify the contract's state.

Image of codes indicating the get MemberInfo function

Deploying the Contract with Remix IDE


Now that we've outlined the contract, let’s move to deployment.


1. Using Remix IDE:

Remix is a web-based Solidity IDE that allows you to write, compile, and deploy Solidity contracts directly to the Ethereum network.

To start, open Remix and create a new Solidity file. Paste the contract code from above into this file.


Compile the contract by clicking the "Compile" button in Remix.

Image depicting the Remix IDE for compiling and deploying smart contracts

2. Deploy the Contract:

Once the contract is compiled, you’ll be prompted to deploy it. Remix offers several network options, including the Ethereum testnet or mainnet.


Ensure you have some Ether to deploy the contract, as deployment costs gas fees.

Remix will guide you through the deployment process, including selecting the appropriate Ethereum network and providing the necessary funds (Ether) to deploy the contract.

Image showing codes on how to deploy the contracts

3. Interacting with the Deployed Contract:

After deploying, users can interact with the contract by calling the joinEkoLance function to join the community.


You can also retrieve member details using the getMemberInfo function.

Image showing how to deploy and run transactions

Advanced Solidity Features to Explore

Once you're comfortable with the basics, there are more advanced features in Solidity to help you build more complex contracts, such as:


1. Function Modifiers

Modifiers are special functions that alter the behavior of other functions. They’re particularly useful for defining reusable code that enforces certain conditions or permissions on functions.

By applying a modifier to a function, you can restrict access (like "onlyOwner" or "onlyWhitelisted") or add pre/post conditions without duplicating code.


2. Inheritance

Solidity supports contract inheritance, where one contract can inherit properties and methods from another. This feature promotes modularity, as you can create a base contract with core functions and reuse it across different contracts.


Inheritance makes it easier to build upon existing code, allowing developers to extend functionality without rewriting code. It also facilitates efficient contract architecture by enabling a clean separation of functionalities.


3. Security Practices

Solidity has several security considerations to protect smart contracts from vulnerabilities, like reentrancy, integer overflow, and underflow.


  • Reentrancy Prevention: Reentrancy occurs when a function repeatedly calls back into itself, potentially exploiting contract states. The recommended approach is the Checks-Effects-Interactions pattern, which avoids state inconsistencies.


  • Inheritance: Solidity allows contracts to inherit from other contracts, making it easier to reuse code and build on existing contracts.


Frequently Asked Questions (FAQs)

  • What is Solidity used for?

    Solidity is primarily used to write smart contracts that run on the Ethereum blockchain. These contracts define how decentralized applications (dApps) function.


  • How do I interact with a deployed smart contract?

    Once deployed, you can interact with a contract through a blockchain explorer (e.g., Etherscan), using a JavaScript library like Web3.js, or by writing front-end code that calls your contract functions.


  • Can Solidity be used for other blockchains?

    While Solidity is primarily used for Ethereum, it can also be used on other Ethereum-compatible blockchains like Binance Smart Chain (BSC), Avalanche, and more.


  • How do I test my Solidity contracts?

    You can test your contracts using Remix IDE, which offers an environment to write, test, and debug your Solidity contracts. Alternatively, you can use testing frameworks like Truffle or Hardhat for more advanced testing.


  • What are some best practices to follow in Solidity?


    • Avoid floating-point operations: Solidity lacks floating-point arithmetic, so use integers and convert units if necessary.

    • Use the require function for validation: This helps to validate inputs and ensure only specific conditions are met before a function executes.

    • Optimise for gas efficiency: Reduce storage variables and use smaller data types when possible.


Conclusion

Solidity is a powerful language for creating decentralized applications and mastering it opens up numerous possibilities for developing innovative solutions on the Ethereum blockchain. By understanding key concepts like structs, mappings, events, and how to deploy and interact with smart contracts, you’ll be well on your way to becoming a proficient Solidity developer.


Start building today, and contribute to the decentralized future by learning Solidity!


About EkoLance

EkoLance revolutionizes the future of work by empowering Web2 and blockchain professionals through its dual offerings. The first is an educational platform that provides quality and comprehensive training programs for upskilling in the blockchain space, ensuring that professionals are equipped with the latest industry knowledge and practical experience. We currently have a diverse community of over 10,000 blockchain professionals, including developers proficient in Solidity and Rust. 


The second offering is our talent platform, Tech Fiesta. It enables companies to launch hackathons, jobs, bounties, and onboard top-tier talent into their ecosystems, fostering innovation and growth. techFiesta has successfully organized over 50 online hackathons and developer challenges for major blockchain networks such as Gnosis chain, Celo, Solana, Concordium, etc. Click here to join our Dev community now!

For updates about our training and other essential developments within EkoLance, follow us on our social handles below.

LinkedIn: EkoLance

Twitter: EkoLance

Instagram: EkoLance

Facebook: EkoLance





Comments


bottom of page