Blockchain solutions
What is a smart contract? What is a hybrid smart contract?
When deployed to a blockchain, a smart contract is a set of instructions that can be executed without intervention from third parties. The smart contract code defines how it responds to input, just like the code of any other computer program.
A valuable feature of smart contracts is that they can store and manage onchain assets (like ETH or ERC20 tokens), just like you can with an Ethereum wallet. Because they have an onchain address like a wallet, they can do everything any other address can. This enables you to program automated actions when receiving and transferring assets.
Smart contracts can connect to real-world market prices of assets to produce powerful applications. Securely connecting smart contracts with offchain data and services is what makes them hybrid smart contracts. This is done using oracles.
What language is a smart contract written in?
The most popular language for writing smart contracts on Ethereum and EVM Chains is Solidity. It was created by the Ethereum Foundation specifically for smart contract development and is constantly being updated. Other languages exist for writing smart contracts on Ethereum and EVM Chains, but Solidity is the language used for Chainlink smart contracts.
If you've ever written Javascript, Java, or other object-oriented scripting languages, Solidity should be easy to understand. Similar to object-oriented languages, Solidity is considered to be a contract-oriented language.
Some networks are not EVM-compatible and use languages other than Solidity for smart contracts:
What does a smart contract look like?
The structure of a smart contract is similar to that of a class in Javascript, with a few differences. For example, the following HelloWorld
contract is a simple smart contract that stores a single variable and includes a function to update the value of that variable.
// SPDX-License-Identifier: MIT pragma solidity 0.8.7; /** * THIS IS AN EXAMPLE CONTRACT THAT USES UN-AUDITED CODE. * DO NOT USE THIS CODE IN PRODUCTION. */ contract HelloWorld {string public message; constructor(string memory initialMessage) { message = initialMessage;} function updateMessage(string memory newMessage) public { message = newMessage;} }
Solidity versions
The first thing that every Solidity file must have is the Solidity version definition. The HelloWorld.sol
contract uses version 0.8.7
, which is defined in the contract as pragma solidity 0.8.7;
You can see the latest versions of the Solidity compiler here. You might also notice smart contracts that are compatible with a range of versions.
pragma solidity >=0.7.0 <0.9.0;
This means that the code is written for Solidity version 0.7.0, or a newer version of the language up to, but not including version 0.9.0. The pragma
selects the compiler, which defines how the code is treated.
Naming a Contract
The contract
keyword defines the name of the contract, which in this example is HelloWorld
. This is similar to declaring a class
in Javascript. The implementation of HelloWorld
is inside this definition and denoted with curly braces.
contract HelloWorld { }
Variables
Like Javascript, contracts can have state variables and local variables. State variables are variables with values that are permanently stored in contract storage. The values of local variables, however, are present only until the function is executing. There are also different types of variables you can use within Solidity, such as string
, uint256
, etc. Check out the Solidity documentation to learn more about the different kinds of variables and types.
Visibility modifiers are used to define the level of access to these variables. Here are some examples of state variables with different visibility modifiers:
string public message; uint256 internal internalVar; uint8 private privateVar;
Learn more about state variables visibility here.
Constructors
Another familiar concept to programmers is the constructor. When you deploy a contract, the constructor sets the state of the contract when it is first created.
In HelloWorld
, the constructor takes in a string
as a parameter and sets the message
state variable to that string.
constructor(string memory initialMessage) { message = initialMessage; }
Functions
Functions can access and modify the state of the contract or call other functions on external contracts. HelloWorld
has a function named updateMessage
, which updates the current message stored in the state.
constructor(string memory initialMessage) { message = initialMessage; } function updateMessage(string memory newMessage) public { message = newMessage; }
Functions use visibility modifiers to define the access level. Learn more about functions visibility here.
Interfaces
An interface is another concept that is familiar to programmers of other languages. Interfaces define functions without their implementation, which leaves inheriting contracts to define the actual implementation themselves. This makes it easier to know what functions to call in a contract. Here's an example of an interface:
// SPDX-License-Identifier: MIT pragma solidity 0.8.7; /** * THIS IS AN EXAMPLE CONTRACT THAT USES UN-AUDITED CODE. * DO NOT USE THIS CODE IN PRODUCTION. */ interface numberComparison {function isSameNum(uint a, uint b) external view returns (bool); } contract Test is numberComparison {constructor() {} function isSameNum(uint a, uint b) external pure override returns (bool) {if (a == b) {return true;} else {return false;}} }
Open in Remix
What is Remix?
For this example, override
is necessary in the Test
contract function because it overrides the base function contained in the numberComparison
interface. The contract uses pure
instead of view
because the isSameNum
function in the Test
contract does not return a storage variable.
What does "deploying" mean?
Deploying a smart contract is the process of pushing the code to the blockchain, at which point it resides with an onchain address. Once it's deployed, the code cannot be changed and is said to be immutable.
As long as the address is known, its functions can be called through an interface, on Etherscan, or through a library like web3js, web3py, ethers, and more. Contracts can also be written to interact with other contracts on the blockchain.
What is a LINK token?
The LINK token is an ERC677 token that inherits functionality from the ERC20 token standard and allows token transfers to contain a data payload. It is used to pay node operators for retrieving data for smart contracts and also for deposits placed by node operators as required by contract creators.
Any wallet that handles ERC20 tokens can store LINK tokens. The ERC677 token standard that the LINK token implements still retains all functionality of ERC20 tokens.
What are oracles?
Oracles provide a bridge between the real-world and onchain smart contracts by being a source of data that smart contracts can rely on, and act upon.
Oracles play a critical role in facilitating the full potential of smart contract utility. Without a reliable connection to real-world conditions, smart contracts cannot effectively serve the real-world.
How do smart contracts use oracles?
Oracles are most popularly used with Data Feeds. DeFi platforms like AAVE and Synthetix use Chainlink data feed oracles to obtain accurate real-time asset prices in their smart contracts.
Chainlink data feeds are sources of data aggregated from many independent Chainlink node operators. Each data feed has an onchain address and functions that enable contracts to read from that address. For example, the ETH / USD feed.
Smart contracts also use oracles to get other capabilities onchain:
- Generate Verifiable Random Numbers (VRF): Use Chainlink VRF to consume randomness in your smart contracts.
- Call External APIs (Any API): Request & Receive data from any API using the Chainlink contract library.
- Automate Smart Contracts using Chainlink Automation: Automating smart contract functions and regular contract maintenance.