Chainlink for Software Engineers: Bridging On- and Off-Chain Computation

smartcontractkit/chainlink

Here's how it's useful, along with how you can get started.

Think of a Chainlink node as the "middleware" connecting smart contracts to the outside world. It solves the "oracle problem," which is the fact that smart contracts on a blockchain can't natively access data from outside their network. This is where Chainlink nodes shine. They provide

Real-world Data
A Chainlink node can retrieve data from any off-chain API, such as stock prices, weather data, sports scores, or even data from another blockchain. For example, if you're building a decentralized finance (DeFi) application, you can use Chainlink to get the latest price of an asset like Bitcoin or Ethereum.

Secure & Decentralized Oracles
The Chainlink network is a decentralized network of these nodes. This means a single point of failure is avoided. Multiple independent nodes provide the same data, and the smart contract can be configured to require a consensus among them, ensuring data integrity and reliability.

Off-chain Computation
A Chainlink node can also perform complex computations off-chain and then submit the result to a smart contract. This is great for tasks that are too expensive or complex to run directly on the blockchain, like generating a random number for a blockchain game or performing a complex calculation for a prediction market.

Provably Fair Outcomes
Chainlink's Verifiable Random Function (VRF) is a powerful tool for generating random numbers that are verifiable on-chain. This is essential for applications like games, lotteries, and NFT mints, where fairness and transparency are crucial.

To use Chainlink, you'll typically interact with it in two main ways
either running your own node or, more commonly for developers, integrating with the network through existing data feeds and services.

Running your own node is for those who want to contribute to the network, provide custom data, or perform specific off-chain computations.

Prerequisites
You'll need Docker, a blockchain node (like Geth or a managed service like Infura), and a database (PostgreSQL is recommended).

Clone the Repository

git clone https://github.com/smartcontractkit/chainlink.git
cd chainlink

Configuration
You'll need to set up a .env file with your blockchain and database connection details. The Chainlink documentation provides templates for this.

Run the Node

docker-compose up

This command will start the Chainlink node, the database, and the blockchain client (if configured) in Docker containers.

Most developers won't need to run their own node. Instead, you'll use an existing Chainlink data feed in your smart contract. Let's look at a simple example using Solidity, the language for Ethereum smart contracts.

Let's say you want to get the latest price of ETH/USD. You can use an existing Chainlink Price Feed.

Install the Chainlink Contracts
Use npm to install the Chainlink contracts package.

npm install @chainlink/contracts

Write the Smart Contract
In your Solidity contract, you'll import the AggregatorV3Interface and use it to interact with the price feed.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol";

contract PriceConsumerV3 {

    // The Chainlink Price Feed address for ETH/USD on the Rinkeby test network.
    // You'll need to find the right address for your network on the Chainlink documentation.
    AggregatorV3Interface internal priceFeed;

    constructor() {
        // Address for ETH/USD on the Sepolia testnet
        priceFeed = AggregatorV3Interface(0x694AA1769357215AD4DEaccc439BEa5Dd23E2496);
    }

    function getLatestPrice() public view returns (int) {
        (
            , // uint80 roundID
            int price,
            , // uint256 startedAt
            , // uint256 timeStamp
            , // uint80 answeredInRound
        ) = priceFeed.latestRoundData();
        return price;
    }
}

AggregatorV3Interface is the interface provided by Chainlink to interact with their data feeds.

The address 0x694AA1769357215AD4DEaccc439BEa5Dd23E2496 is the specific contract address for the ETH/USD price feed on the Sepolia test network. Always check the official Chainlink documentation for the correct addresses.

Deploy and Interact
You would then deploy this contract to a blockchain (e.g., Ethereum) and call the getLatestPrice function to get the current price.