Web3 & DApp Development Fundamentals · درس

مثال أساسي على DApp

ابنوا تطبيق DApp بسيطًا يقرأ البيانات من عقد ذكي منشور ويعرضها على صفحة ويب.

مثال أساسي على DApp درس مجاني في Web3 & DApp Development Fundamentals على CoddyKit. هذا هو الدرس 3 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Web3 & DApp Development Fundamentals، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Web3 & DApp Development Fundamentals 3 دروس في المجموع.

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

Building Our First DApp

Welcome to building your first Decentralized Application (DApp)! In this lesson, we'll create a simple DApp that reads a message stored on a smart contract and displays it on a web page.

This example will tie together concepts you've learned about smart contracts and front-end interaction.

The Simple Message Contract

First, let's define the smart contract. This contract will be very basic: it just stores a single string variable, myMessage, which we'll make public so its value can be easily read from outside the contract.

Remember, this contract would be compiled and deployed to a blockchain (like Ethereum).

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

contract SimpleMessage {
    string public myMessage = "Hello CoddyKit DApp!";
}

Contract Address & ABI

Once our SimpleMessage contract is deployed to a blockchain, we get two critical pieces of information:

Contract Address: This is like the contract's unique street address on the blockchain.
ABI (Application Binary Interface): This is a JSON description of the contract's functions and variables. It tells our front-end how to 'talk' to the contract.

We'll use these in our web application to connect and read data.

Front-end HTML Structure

Our DApp needs a basic web page to display the message. We'll create an index.html file with a heading and a paragraph where our contract's message will appear. We'll also link our JavaScript file (app.js) and the Web3.js library.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>CoddyKit DApp</title>
</head>
<body>
    <h1>DApp Message Reader</h1>
    <p>Message from contract: <span id="contractMessage">Loading...</span></p>
    <script src="https://cdn.jsdelivr.net/npm/web3@1.7.0/dist/web3.min.js"></script>
    <script src="app.js"></script>
</body>
</html>

Connecting with Web3.js

Now for the JavaScript (app.js)! We need to connect our web page to the Ethereum blockchain. The Web3.js library helps us do this. It will look for a provider, like MetaMask, in the user's browser.

// app.js
let web3;

async function initWeb3() {
    if (window.ethereum) {
        web3 = new Web3(window.ethereum);
        try {
            await window.ethereum.request({ method: 'eth_requestAccounts' });
            console.log("Connected to MetaMask!");
        } catch (error) {
            console.error("User denied account access");
        }
    } else if (window.web3) {
        web3 = new Web3(window.web3.currentProvider);
    } else {
        console.log('Non-Ethereum browser detected. Try MetaMask!');
        // Fallback for read-only access (e.g., Infura)
        // web3 = new Web3(new Web3.providers.HttpProvider("YOUR_INFURA_URL"));
    }
}

Instantiating the Contract Object

With Web3.js connected to a provider, we can now create a JavaScript object that represents our deployed SimpleMessage smart contract. We do this using its contract address and ABI.

The ABI tells Web3.js which functions are available on the contract.

// app.js (continued)
const contractAddress = "0xYourDeployedContractAddressHere"; // REPLACE THIS!
const contractABI = [
    {
        "inputs": [],
        "name": "myMessage",
        "outputs": [
            {
                "internalType": "string",
                "name": "",
                "type": "string"
            }
        ],
        "stateMutability": "view",
        "type": "function"
    }
];

let simpleMessageContract;

async function loadContract() {
    if (!web3) await initWeb3();
    simpleMessageContract = new web3.eth.Contract(contractABI, contractAddress);
    console.log("Contract loaded:", simpleMessageContract);
}

Reading Contract Data

Now that we have our contract object, reading the myMessage variable is straightforward. Since myMessage is a public view variable, we can call its auto-generated getter function directly without sending a transaction (which means no gas cost).

// app.js (continued)
async function readMessage() {
    if (!simpleMessageContract) await loadContract();
    try {
        // Call the auto-generated getter for 'myMessage'
        const message = await simpleMessageContract.methods.myMessage().call();
        console.log("Message from contract:", message);
        return message;
    } catch (error) {
        console.error("Error reading message:", error);
        return "Error loading message.";
    }
}

Full DApp JavaScript (app.js)

Here's the complete app.js file that ties everything together. It connects to the blockchain, loads the contract, reads the message, and then updates the HTML to display it when the page loads.

Remember to replace 0xYourDeployedContractAddressHere with your actual deployed contract address!

// app.js
let web3; // Declare web3 globally
const contractAddress = "0xYourDeployedContractAddressHere"; // REPLACE THIS!
const contractABI = [
    {
        "inputs": [],
        "name": "myMessage",
        "outputs": [
            {
                "internalType": "string",
                "name": "",
                "type": "string"
            }
        ],
        "stateMutability": "view",
        "type": "function"
    }
];
let simpleMessageContract;

async function initWeb3() {
    if (window.ethereum) { web3 = new Web3(window.ethereum); await window.ethereum.request({ method: 'eth_requestAccounts' }); }
    else if (window.web3) { web3 = new Web3(window.web3.currentProvider); }
    else { console.log('Non-Ethereum browser detected. Try MetaMask!'); }
}

async function loadContract() {
    if (!web3) await initWeb3();
    simpleMessageContract = new web3.eth.Contract(contractABI, contractAddress);
}

async function readMessage() {
    if (!simpleMessageContract) await loadContract();
    try {
        const message = await simpleMessageContract.methods.myMessage().call();
        return message;
    } catch (error) {
        console.error("Error reading message:", error);
        return "Error loading message.";
    }
}

document.addEventListener('DOMContentLoaded', async () => {
    const messageElement = document.getElementById('contractMessage');
    await initWeb3();
    await loadContract();
    const msg = await readMessage();
    messageElement.innerText = msg;
});

DApp Interaction Check

Which of the following are essential pieces of information needed by a front-end DApp to interact with a deployed smart contract?

Recap: Your First DApp

Congratulations! You've just walked through the process of building a basic DApp.

We defined a simple Solidity smart contract.
We learned about the importance of the contract's address and ABI.
We created an HTML page and used Web3.js to connect to the blockchain.
Finally, we instantiated our contract object and read data from it, displaying it on our web page.

This fundamental pattern of connecting, interacting, and displaying is at the heart of most DApps!

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

هل درس «مثال أساسي على DApp» مجاني؟

نعم — نص درس «مثال أساسي على DApp» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Web3 & DApp Development Fundamentals، انتقل إلى CoddyKit PRO. تتضمن دورة Web3 & DApp Development Fundamentals 3 دروس في المجموع.

ماذا ستتعلم في «مثال أساسي على DApp»؟

ابنوا تطبيق DApp بسيطًا يقرأ البيانات من عقد ذكي منشور ويعرضها على صفحة ويب. تتمرن على Web3 & DApp Development Fundamentals مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Web3 & DApp Development Fundamentals؟

لا تُشترط خبرة سابقة. Web3 & DApp Development Fundamentals على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 3.

كم من الوقت يستغرق درس «مثال أساسي على DApp»؟

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

هل يمكنني كتابة وتشغيل أكواد في درس Web3 & DApp Development Fundamentals هذا؟

نعم. كل درس في Web3 & DApp Development Fundamentals يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

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

الواجهة الأمامية والخلفية في Web3
الاتصال بـ Ethereum ‏(Web3.js/Ethers.js)
مثال أساسي على DApp

← العودة إلى Web3 & DApp Development Fundamentals