Blockchain Smart Contracts with Solidity · درس

تكامل Oracles من Chainlink

تعلّم استخدام Chainlink لربط عقودك الذكية بأمان بالبيانات والأحداث والحسابات الواقعية.

تكامل Oracles من Chainlink درس مجاني في Blockchain Smart Contracts with Solidity على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Blockchain Smart Contracts with Solidity، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Blockchain Smart Contracts with Solidity 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Welcome to Chainlink Oracles!

In the previous lesson, we learned about the "oracle problem" – how smart contracts can't directly access real-world data.

Chainlink solves this by acting as a bridge, securely bringing off-chain data onto the blockchain. This lesson will show you how to integrate Chainlink into your Solidity contracts.

Bridging On-Chain & Off-Chain

Chainlink is a decentralized oracle network. It allows your smart contracts to reliably connect with external data sources, APIs, and even traditional payment systems.

Decentralized: Multiple independent nodes verify data.
Secure: Cryptographic proofs ensure data integrity.
Reliable: Data is aggregated from many sources.

Power of Data Feeds

One of Chainlink's most popular features is its Data Feeds. These provide continuously updated price data for cryptocurrencies, commodities, and more.

Instead of requesting data on demand (which can be complex), Data Feeds offer a simpler way to access frequently updated information directly within your contract.

Getting Started: The Interface

To interact with Chainlink Data Feeds, your smart contract needs to know how to "talk" to them. Chainlink provides an interface called AggregatorV3Interface.

This interface defines the functions your contract can call to retrieve data. You'll typically import it into your Solidity file like this:

interface AggregatorV3Interface {
  function decimals() external view returns (uint8);
  function description() external view returns (string memory);
  function version() external view returns (uint256);

  function latestRoundData()
    external
    view
    returns (
      uint80 roundId,
      int256 answer,
      uint256 startedAt,
      uint256 updatedAt,
      uint80 answeredInRound
    );
}

Initializing the Oracle

Your contract needs to know the specific address of the Chainlink Data Feed it wants to use. This is typically set in the contract's constructor.

For example, to get the ETH/USD price on a testnet, you'd provide the corresponding Data Feed address to initialize your priceFeed variable.

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

interface AggregatorV3Interface {
  function latestRoundData()
    external
    view
    returns (
      uint80 roundId,
      int256 answer,
      uint256 startedAt,
      uint256 updatedAt,
      uint80 answeredInRound
    );
}

contract PriceConsumer {
  AggregatorV3Interface internal priceFeed;

  constructor(address _priceFeedAddress) {
    priceFeed = AggregatorV3Interface(_priceFeedAddress);
  }
}

Fetching Price Data

Once connected, you can call the latestRoundData() function on your priceFeed variable. This function returns several pieces of information.

The most important is answer, which is the actual price data. Other values provide context, like when the data was last updated.

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

interface AggregatorV3Interface {
  function latestRoundData()
    external
    view
    returns (
      uint80 roundId,
      int256 answer,
      uint256 startedAt,
      uint256 updatedAt,
      uint80 answeredInRound
    );
  function decimals() external view returns (uint8);
}

contract PriceConsumer {
  AggregatorV3Interface internal priceFeed;

  constructor(address _priceFeedAddress) {
    priceFeed = AggregatorV3Interface(_priceFeedAddress);
  }

  function getLatestPrice() public view returns (int256) {
    // We only care about the 'answer' here, so other return values are ignored.
    (, int256 price, , , ) = priceFeed.latestRoundData();
    return price;
  }
}

Deciphering the Data

The answer from latestRoundData() is an int256. For example, if ETH/USD is $2000, the answer might be 200000000000.

You need to divide this by 10 ** priceFeed.decimals() to get the human-readable value. The decimals() function from the interface tells you the scaling factor.

Full Example: ETH/USD Price

Here's a complete, runnable example of a contract that fetches the latest ETH/USD price using Chainlink. You can use a common Sepolia testnet address for demonstration.

Copy and paste this into Remix, compile, and deploy it with the correct Chainlink Data Feed address for your network.

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

// Import Chainlink's AggregatorV3Interface
interface AggregatorV3Interface {
  function decimals() external view returns (uint8);
  function description() external view returns (string memory);
  function version() external view returns (uint256);
  function latestRoundData()
    external
    view
    returns (
      uint80 roundId,
      int256 answer,
      uint256 startedAt,
      uint256 updatedAt,
      uint80 answeredInRound
    );
}

contract EthPriceConsumer {
  AggregatorV3Interface internal priceFeed;

  // Constructor takes the address of the Chainlink Data Feed
  // Example for Sepolia ETH/USD:
  // 0x694AA1769357215Ee4f0fFf93d2d05d454eBEaB8
  constructor(address _priceFeedAddress) {
    priceFeed = AggregatorV3Interface(_priceFeedAddress);
  }

  // Function to get the latest ETH/USD price
  function getLatestEthUsdPrice() public view returns (int256) {
    // latestRoundData returns (roundId, answer, startedAt, updatedAt, answeredInRound)
    (, int256 price, , , ) = priceFeed.latestRoundData();
    return price; // Price is returned with 8 decimals (e.g., $2000 becomes 200000000000)
  }

  // Function to get the number of decimals for the price feed
  function getDecimals() public view returns (uint8) {
    return priceFeed.decimals();
  }
}

Production Readiness Notes

When using Chainlink in production, always consider:

Gas Costs: Reading from Data Feeds is usually cheap (view function), but making custom requests can cost gas.
Network Addresses: Use the correct Data Feed address for your target network (e.g., Mainnet, Sepolia).
Error Handling: Implement checks for stale data (updatedAt) or zero values from the oracle for robustness.

Test Your Knowledge

You've learned how to integrate Chainlink Data Feeds. Let's check your understanding.

Integrating Chainlink: Recap

Great job! You've learned how to integrate Chainlink Data Feeds into your Solidity smart contracts.

Chainlink bridges off-chain data to the blockchain.
You use AggregatorV3Interface to interact with Data Feeds.
The contract constructor sets the oracle address.
latestRoundData() fetches the price and other info.

In the next lesson, we'll dive deeper into more complex data retrieval patterns, including how to make custom requests for data not available in standard Data Feeds.

الأسئلة الشائعة

هل درس «تكامل Oracles من Chainlink» مجاني؟

نعم — نص درس «تكامل Oracles من Chainlink» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Blockchain Smart Contracts with Solidity، انتقل إلى CoddyKit PRO. تتضمن دورة Blockchain Smart Contracts with Solidity 4 دروس في المجموع.

ماذا ستتعلم في «تكامل Oracles من Chainlink»؟

تعلّم استخدام Chainlink لربط عقودك الذكية بأمان بالبيانات والأحداث والحسابات الواقعية. تتمرن على Blockchain Smart Contracts with Solidity مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Blockchain Smart Contracts with Solidity؟

لا تُشترط خبرة سابقة. Blockchain Smart Contracts with Solidity على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «تكامل Oracles من Chainlink»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Blockchain Smart Contracts with Solidity هذا؟

نعم. كل درس في Blockchain Smart Contracts with Solidity يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

شرح مشكلة Oracle
تكامل Oracles من Chainlink
التعامل مع استرجاع البيانات خارج السلسلة
بناء عقود Oracle مخصصة

← العودة إلى Blockchain Smart Contracts with Solidity