عقد بناء السوق

سنقوم الآن بتحويل عقد العنصر البسيط الخاص بنا إلى عقد Marketplace أكثر تعقيدًا. سيحتفظ عقد Marketplace بقائمة العناصر المعروضة للبيع، ويوفر طريقة للمستخدمين لإدراج عناصر جديدة للبيع، ويوفر طريقة للمستخدمين لشراء العناصر.

للقيام بذلك، سنضيف بعض الميزات الجديدة إلى عقدنا:

1. سيكون لكل منتج الآن عنوان بائع يمثل مالك السلعة.

2. سنقدم وظيفة جديدة ListItemForSale تسمح للمستخدمين بإدراج عناصر جديدة للبيع.

3. سنقدم وظيفة BuyItem الجديدة التي تتيح للمستخدمين شراء عنصر.

إليك ما يبدو عليه عقد Marketplace:

صلابة
//معرف ترخيص SPDX: معهد ماساتشوستس للتكنولوجيا
صلابة البراغما ^0.8.6؛

سوق العقود {
 //تحديد هيكل جديد للعناصر
 عنصر الهيكل {
        string name;
        uint price;
        address payable seller;
        bool forSale;
    }

    //مصفوفة لاستيعاب جميع العناصر
 البند [] البنود العامة؛

 //الحدث الذي سيتم إصداره عند إنشاء عنصر جديد
 العنصر الجديد للحدث (معرف عنصر الوحدة، اسم عنصر السلسلة، سعر عنصر الوحدة، عنوان البائع)؛

 //الحدث الذي سينبعث عندما يتم إدراج عنصر للبيع
 عنصر الحدث المدرج (معرف عنصر الوحدة، اسم عنصر السلسلة، سعر عنصر الوحدة، عنوان البائع)؛

 //الحدث الذي سينبعث عند شراء عنصر
 عنصر الحدث الذي تم شراؤه (معرف عنصر الوحدة، اسم عنصر السلسلة، سعر عنصر الوحدة، عنوان البائع، العنوان، المشتري)؛

 //وظيفة لإنشاء عنصر جديد ولكن لا يتم إدراجه للبيع على الفور
 وظيفة createItem (ذاكرة السلسلة _الاسم، uint _price) عامة {
    items.push(Item(_name, _price, payable(msg.sender), false)); // We need to explicitly convert msg.sender to 'address payable'
    emit NewItem(items.length - 1, _name, _price, msg.sender);
    }


    //وظيفة لإدراج عنصر للبيع
 عنصر قائمة الوظائف للبيع (uint _itemID) عام {
        Item storage item = items[_itemId];
        require(msg.sender == item.seller, "Only the owner can list the item for sale");
        item.forSale = true;
        emit ItemListed(_itemId, item.name, item.price, item.seller);
    }

    //وظيفة لشراء عنصر
 وظيفة buyItem (uint _itemID) قابلة للدفع العام {
        Item storage item = items[_itemId];
        require(msg.sender != item.seller, "Seller cannot buy their own item");
        require(item.forSale, "Item is not for sale");
        require(msg.value == item.price, "Incorrect price sent");
        item.seller.transfer(msg.value);
        item.forSale = false;
        emit ItemBought(_itemId, item.name, item.price, item.seller, msg.sender);
    }
}

في هذا العقد، لدينا:

1. هيكل عنصر يتضمن الآن عنوان البائع ومنطقًا منطقيًا لـ ForSale. البائع هو مالك السلعة، ويشير ForSale إلى ما إذا كان العنصر مدرجًا حاليًا للبيع.

2. وظيفة createItem التي تنشئ عنصرًا جديدًا وتعين msg.sender كبائع. msg.sender هو متغير عالمي في Solidity يمثل عنوان الشخص (أو العقد الذكي) الذي يسمى الوظيفة الحالية. ومع ذلك، لم يتم إدراج العنصر للبيع على الفور.

3. وظيفة ListItemForSale التي تسمح لبائع السلعة بإدراجها للبيع. نحن نستخدم وظيفة الطلب للتأكد من أن البائع فقط يمكنه إدراج العنصر للبيع.

4. وظيفة BuyItem التي تسمح لشخص ما بشراء عنصر. تتحقق الوظيفة من أن السلعة معروضة للبيع، وأن المشتري ليس البائع، وأن السعر الصحيح قد تم إرساله. في حالة استيفاء هذه الشروط، ترسل الوظيفة الأموال إلى البائع وتضع علامة على السلعة على أنها ليست للبيع.

نشر عقد السوق والتفاعل معه

بعد كتابة عقد Marketplace ، فإن الخطوة التالية هي تجميعه ونشره. يمكنك استخدام المكون الإضافي Solidity Compiler في Remix لتجميع العقد، تمامًا كما فعلنا في الدرس 1.

لنشر العقد، انتقل إلى المكون الإضافي Deploy & Run Transactions (الذي يحتوي على رمز المكعب) على اللوحة اليمنى. اختر البيئة المناسبة (JavaScript VM للمحاكاة)، وحدد عقد Marketplace من القائمة المنسدلة للعقد، وانقر فوق زر النشر.

بمجرد نشر العقد، سيظهر ضمن قسم العقود المنشورة. يمكنك توسيعه لرؤية متغيرات ووظائف الحالة العامة الخاصة به. يمكنك إنشاء العناصر وإدراجها وشرائها عن طريق استدعاء هذه الوظائف.

لإنشاء عنصر، أدخل اسمًا وسعرًا، وانقر زر CreateItem. لإدراج عنصر للبيع، أدخل معرف العنصر وانقر على زر ListItemForSale. لشراء عنصر، أدخل معرف العنصر، وأرسل الكمية الصحيحة من الإيثر، وانقر على زر BuyItem.

تهانينا! أنت تعرف الآن كيفية إنشاء سوق لامركزي أساسي على بلوكشين الإيثيريوم.

في الدرس التالي، سنقوم بتحسين سوقنا من خلال إضافة وظائف لإزالة العناصر من البيع وتحديث سعر السلعة. ترقبوا!