Oracle integration (Chainlink) in Blockchain / Solidity - Mini Project: Build & Apply

Oracle Integration with Chainlink

📖 Scenario: You are building a simple smart contract that fetches external data using Chainlink oracles. This is useful when your contract needs real-world information, like the current price of ETH in USD.

🎯 Goal: Create a smart contract that requests the latest ETH price from a Chainlink oracle and stores it on the blockchain.

📋 What You'll Learn

Create a mapping to store the latest price

Add a Chainlink oracle address and job ID as configuration variables

Write a function to request the price from the oracle

Write a callback function to receive and store the price

Print the stored price

💡 Why This Matters

🌍 Real World

Smart contracts often need real-world data like prices, weather, or sports scores. Chainlink oracles provide this data securely.

💼 Career

Understanding oracle integration is key for blockchain developers building decentralized finance (DeFi) apps or other smart contracts that rely on external data.

1

Set up the price storage mapping

Create a public mapping called prices that maps address to uint256 to store the latest price for each requester.

Blockchain / Solidity

// Your code here

Hint

Use mapping(address => uint256) public prices; inside the contract.

2

Add Chainlink oracle configuration

Add two public variables: oracle of type address and jobId of type bytes32. Set oracle to 0x1234567890abcdef1234567890abcdef12345678 and jobId to "0x4c7b7ffb66e34d408b2f264769c6d0b2".

Blockchain / Solidity

pragma solidity ^0.8.7;

contract PriceConsumer {
    mapping(address => uint256) public prices;
    // Your code here
}

Hint

Declare oracle as address public and jobId as bytes32 public with the given values.

3

Write the requestPrice function

Write a public function called requestPrice that takes no arguments. Inside, emit an event RequestPrice(address requester) with msg.sender as the requester. (This simulates sending a request to the oracle.)

Blockchain / Solidity

pragma solidity ^0.8.7;

contract PriceConsumer {
    mapping(address => uint256) public prices;
    address public oracle = 0x1234567890abcdef1234567890abcdef12345678;
    bytes32 public jobId = 0x4c7b7ffb66e34d408b2f264769c6d0b2;

    // Your code here
}

Hint

Define an event RequestPrice and emit it inside requestPrice with msg.sender.

4

Store and print the price

Write a public function called fulfillPrice that takes address requester and uint256 price as arguments. Inside, store price in prices[requester]. Then, write a public view function called getPrice that takes address requester and returns the stored price. Finally, add a line to print the price for msg.sender by calling getPrice(msg.sender).

Blockchain / Solidity

pragma solidity ^0.8.7;

contract PriceConsumer {
    mapping(address => uint256) public prices;
    address public oracle = 0x1234567890abcdef1234567890abcdef12345678;
    bytes32 public jobId = 0x4c7b7ffb66e34d408b2f264769c6d0b2;

    event RequestPrice(address requester);

    function requestPrice() public {
        emit RequestPrice(msg.sender);
    }

    // Your code here
}

Hint

Store the price in prices[requester] and create a getter function. Then add a function to return the price for msg.sender.

Practice

1. What is the main purpose of using Chainlink oracles in smart contracts?

easy

A. To encrypt data stored on the blockchain

B. To fetch real-world data securely into the blockchain

C. To create new tokens automatically

D. To speed up transaction processing on the blockchain

Solution

1. Step 1: Understand what oracles do

   Oracles connect smart contracts to external data sources outside the blockchain.

2. Step 2: Identify the main use of Chainlink oracles

   Chainlink oracles securely fetch real-world data like prices or weather into smart contracts.

3. Final Answer:

   To fetch real-world data securely into the blockchain -> Option B

4. Quick Check:

   Oracle purpose = fetch external data [OK]

Hint: Oracles bring outside data inside smart contracts [OK]

Common Mistakes:

• Thinking oracles speed up blockchain transactions
• Confusing oracles with token creation
• Assuming oracles encrypt blockchain data

2. Which of the following is the correct way to declare a Chainlink request in Solidity?

easy

A. Chainlink.Request memory req = buildChainlinkRequest(jobId, address(this), this.fulfill.selector);

B. Chainlink.Request req = new Chainlink.Request(jobId, address(this), fulfill);

C. Request memory req = Chainlink.buildRequest(jobId, this, fulfill);

D. ChainlinkRequest req = buildRequest(jobId, this, fulfill.selector);

Solution

1. Step 1: Recall Chainlink request syntax

   The correct syntax uses Chainlink.Request memory and buildChainlinkRequest function.

2. Step 2: Match the correct parameters

   Parameters are jobId, contract address (address(this)), and fulfill function selector (this.fulfill.selector).

3. Final Answer:

   Chainlink.Request memory req = buildChainlinkRequest(jobId, address(this), this.fulfill.selector); -> Option A

4. Quick Check:

   Correct request syntax = Chainlink.Request memory req = buildChainlinkRequest(jobId, address(this), this.fulfill.selector); [OK]

Hint: Use buildChainlinkRequest with memory and fulfill.selector [OK]

Common Mistakes:

• Omitting 'memory' keyword
• Using 'new' keyword incorrectly
• Wrong function selector syntax

3. Given this Solidity snippet, what will be the value of data after fulfillment?

uint256 public data;

function fulfill(bytes32 _requestId, uint256 _value) public recordChainlinkFulfillment(_requestId) {
    data = _value;
}

// Assume fulfill is called with _value = 42

medium

A. 0

B. RequestId bytes32 value

C. Compilation error

D. 42

Solution

1. Step 1: Understand fulfill function behavior

   The fulfill function sets the contract's data variable to the passed _value.

2. Step 2: Apply given input value

   Since fulfill is called with _value = 42, data becomes 42.

3. Final Answer:

   42 -> Option D

4. Quick Check:

   fulfill sets data = _value = 42 [OK]

Hint: fulfill sets data to passed _value parameter [OK]

Common Mistakes:

• Confusing _requestId with _value
• Assuming data stays zero
• Thinking function causes error

4. Identify the error in this Chainlink oracle request code snippet:

Chainlink.Request memory req = buildChainlinkRequest(jobId, address(this), this.fulfill.selector);
req.add("get", "https://api.example.com/data");
req.add("path", "price");
sendChainlinkRequest(req, fee);

medium

A. Missing LINK token approval before sending request

B. Incorrect function name: should be sendChainlinkRequestTo

C. Missing import for Chainlink library

D. Using 'add' instead of 'addString' for parameters

Solution

1. Step 1: Review Chainlink request sending requirements

   Before sending a request, the contract must have LINK tokens approved to pay the oracle fee.

2. Step 2: Check code for LINK approval

   The snippet does not show LINK token approval, which is required to avoid failure.

3. Final Answer:

   Missing LINK token approval before sending request -> Option A

4. Quick Check:

   LINK approval needed before sendChainlinkRequest [OK]

Hint: Always approve LINK tokens before sending requests [OK]

Common Mistakes:

• Assuming sendChainlinkRequestTo is correct function
• Confusing add and addString methods
• Ignoring LINK token approval step

5. You want to fetch the current ETH/USD price using Chainlink in your smart contract. Which steps must you combine to do this correctly?

hard

A. Use Chainlink request but omit fulfill function to save gas

B. Directly call the price feed contract without Chainlink oracles

C. Build a Chainlink request with jobId and URL, send request with fee, implement fulfill to store price

D. Send request without specifying jobId and rely on default oracle

Solution

1. Step 1: Build and send Chainlink request

   Create a request specifying jobId and data source URL, then send it with the required fee.

2. Step 2: Implement fulfill function

   Define fulfill to receive the oracle response and store the ETH/USD price in your contract.

3. Final Answer:

   Build a Chainlink request with jobId and URL, send request with fee, implement fulfill to store price -> Option C

4. Quick Check:

   Request + fee + fulfill = correct Chainlink usage [OK]

Hint: Request data, pay fee, handle response in fulfill [OK]

Common Mistakes:

• Skipping fulfill function implementation
• Not specifying jobId in request
• Assuming default oracle without jobId