Создание и развертывание смарт-контрактов для Tron: сбор комиссий

أهلاً بك! يسعدني مساعدتك في فهم كيفية فرض رسوم على معاملات محفظة ترون الخاصة بك.

لتحقيق ما تطلبه، ستحتاج إلى استخدام العقود الذكية (Smart Contracts) على شبكة ترون. العقود الذكية هي برامج تعمل على البلوك تشين وتنفذ تلقائيًا عند استيفاء شروط معينة.

إليك شرح تفصيلي للطريقة:

1. فهم آلية عمل العقود الذكية لفرض الرسوم

الفكرة الأساسية هي إنشاء عقد ذكي يقوم بالمهام التالية:

• استلام الأموال: يستقبل العقد الأموال المرسلة إلى عنوانه.
• حساب الرسوم: يقوم العقد بحساب نسبة مئوية محددة كرسوم (عمولة شراء/بيع أو رسوم تحويل).
• إعادة توزيع الأموال:
  • يرسل المبلغ المتبقي (بعد خصم الرسوم) إلى المحفظة الوجهة النهائية.
  • يرسل مبلغ الرسوم إلى محفظة أخرى مخصصة لتلقي هذه الرسوم.

2. المتطلبات الأساسية

• معرفة بالبرمجة: ستحتاج إلى معرفة بلغة برمجة العقود الذكية مثل Solidity (إذا كنت تستخدم شبكة Tron التي تدعم EVM) أو لغة خاصة بـ Tron مثل Plutus (إذا كنت تستخدم شبكات أخرى تدعمها).
• بيئة تطوير: ستحتاج إلى بيئة لتطوير واختبار العقود الذكية مثل Remix IDE أو Truffle.
• محافظ ترون:
  • محفظة ترون الأساسية التي ستستخدمها لإرسال الأموال.
  • محفظة ترون جديدة لتلقي الأموال بعد خصم الرسوم.
  • محفظة ترون جديدة لتلقي الرسوم المفروضة.
• فهم لشبكة ترون: معرفة كيفية عمل المعاملات، الغاز (TRX)، والعقود الذكية على شبكة ترون.

3. خطوات التنفيذ

1. تصميم العقد الذكي:

   • تحديد النسب: حدد نسبة الرسوم التي تريد فرضها (مثلاً 1% عمولة شراء، 1% عمولة بيع).
   • تحديد عناوين المحافظ: قم بتضمين عناوين المحافظ التي ستستقبل الأموال بعد خصم الرسوم وعناوين المحافظ التي ستستقبل الرسوم. يمكن أن تكون هذه العناوين ثابتة في العقد أو قابلة للتغيير من قبل مالك العقد.
   • كتابة الكود: قم بكتابة الكود بلغة Solidity (أو ما يعادلها على Tron). سيحتوي الكود على وظائف لاستقبال الأموال (مثل receive() أو fallback()) ووظائف لمعالجة التحويلات.

   مثال توضيحي (مبسط جدًا بلغة Solidity):

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

   contract FeeCollector {
   address public owner; // عنوان مالك العقد (يمكنه تغيير عناوين الاستلام)
   address public recipientWallet; // المحفظة التي تستقبل الأموال بعد خصم الرسوم
   address public feeWallet; // المحفظة التي تستقبل الرسوم
   uint256 public feePercentage; // نسبة الرسوم (مثلاً 100 تعني 1%)

   КодКопировать

   constructor(address _recipientWallet, address _feeWallet, uint256 _feePercentage) {
       owner = msg.sender;
       recipientWallet = _recipientWallet;
       feeWallet = _feeWallet;
       feePercentage = _feePercentage;
   }
   
   // وظيفة لاستقبال الأموال
   receive() external payable {
       transferWithFee(msg.sender); // يمكن تعديلها لتناسب احتياجاتك
   }
   
   // وظيفة لمعالجة التحويل مع فرض الرسوم
   function transferWithFee(address _to) public payable {
       require(_to != address(0), "Invalid recipient address");
   
       uint256 amountToSend = msg.value;
       uint256 feeAmount = (amountToSend * feePercentage) / 10000; // حساب الرسوم (مثلاً 10000 تعني 100%)
       uint256 netAmount = amountToSend - feeAmount;
   
       // إرسال صافي المبلغ إلى المحفظة المستلمة
       (bool successRecipient, ) = payable(recipientWallet).call{value: netAmount}("");
       require(successRecipient, "Failed to send net amount to recipient");
   
       // إرسال الرسوم إلى محفظة الرسوم
       if (feeAmount > 0) {
           (bool successFee, ) = payable(feeWallet).call{value: feeAmount}("");
           require(successFee, "Failed to send fee amount");
       }
   }
   
   // وظيفة لتغيير نسبة الرسوم (فقط للمالك)
   function setFeePercentage(uint256 _newFeePercentage) public onlyOwner {
       feePercentage = _newFeePercentage;
   }
   
   // وظيفة لتغيير محفظة المستلم (فقط للمالك)
   function setRecipientWallet(address _newRecipientWallet) public onlyOwner {
       recipientWallet = _newRecipientWallet;
   }
   
   // وظيفة لتغيير محفظة الرسوم (فقط للمالك)
   function setFeeWallet(address _newFeeWallet) public onlyOwner {
       feeWallet = _newFeeWallet;
   }
   
   // Modifier للتأكد من أن المتصل هو المالك
   modifier onlyOwner() {
       require(msg.sender == owner, "Only owner can call this function");
       _;
   }
   
   // وظيفة للسماح للعقد باستقبال أي عملة (مثل TRX)
   fallback() external payable {}
   

   }
   ```

2. نشر العقد الذكي:

   • بعد كتابة واختبار العقد، ستقوم بنشره على شبكة ترون الرئيسية. سيتطلب هذا دفع رسوم بالـ TRX.
   • عند النشر، ستقوم بتمرير عناوين المحافظ التي حددتها ونسبة الرسوم المطلوبة.

3. استخدام العقد:

   • بدلاً من إرسال الأموال مباشرة إلى محفظة شخص آخر، سيقوم المرسلون بإرسال الأموال إلى عنوان العقد الذكي الذي قمت بنشره.
   • سيقوم العقد تلقائيًا بتطبيق الرسوم وإعادة توزيع الأموال كما هو مبرمج.

4. بدائل وأدوات مساعدة

• منصات إنشاء العقود الذكية: هناك بعض المنصات التي قد توفر أدوات لإنشاء عقود ذكية بسيطة دون الحاجة لكتابة الكود بالكامل، ولكن قد تكون محدودة في التخصيص. ابحث عن "Tron Smart Contract Builder" أو "DeFi Platform Builder".
• الاستعانة بمطور عقود ذكية: إذا لم تكن لديك الخبرة الكافية في البرمجة، فإن أفضل خيار هو الاستعانة بمطور عقود ذكية متخصص في شبكة ترون. يمكنه بناء العقد المطلوب بدقة وكفاءة.

5. اعتبارات هامة

• رسوم الغاز (TRX): كل معاملة على شبكة ترون تتطلب دفع رسوم بالـ TRX. يجب أن يكون لدى المستخدمين الذين يرسلون الأموال إلى عقدك ما يكفي من TRX لتغطية رسوم المعاملة بالإضافة إلى المبلغ المراد إرساله.
• الأمان: تأكد من أن العقد الذكي الخاص بك آمن وتم اختباره جيدًا لتجنب أي ثغرات قد تؤدي إلى فقدان الأموال.
• العملات المدعومة: تأكد من أن العقد الذكي مصمم لدعم العملة التي تريد فرض الرسوم عليها (TRX أو TRC-20 Tokens). الكود أعلاه هو مثال بسيط وقد يحتاج إلى تعديلات لدعم TRC-20.

أتمنى أن يكون هذا الشرح مفصلاً وواضحاً. إذا كان لديك أي أسئلة أخرى أو احتجت إلى توضيح لنقطة معينة، فلا تتردد في السؤال!

أهلاً بك مجدداً! يسعدني توضيح هذه النقاط.

بالنسبة لسؤالك الأول: هل يمكن استخدام نفس المحفظة لاستقبال الأموال بعد خصم الرسوم واستقبال الرسوم نفسها؟

نعم، هذا ممكن تقنياً، ولكن يجب أن يتم تصميمه بعناية فائقة في العقد الذكي. في الكود الذي قدمته سابقاً، هناك عنوانان منفصلان: recipientWallet (لاستقبال الأموال الصافية) و feeWallet (لاستقبال الرسوم).

إذا أردت استخدام نفس المحفظة لكليهما، ستحتاج إلى تعديل العقد بحيث يتم توجيه كلا المبلغين (الصافي والرسوم) إلى نفس العنوان. هذا يعني أن عنوان محفظتك سيكون هو نفسه لكل من recipientWallet و feeWallet.

مثال على التعديل (مبسط):

في دالة transferWithFee، بدلاً من إرسال feeAmount إلى feeWallet، يمكنك إضافته إلى netAmount وإرسال المجموع إلى recipientWallet (الذي سيكون عنوان محفظتك).

// ... (باقي الكود كما هو)

// وظيفة لمعالجة التحويل مع فرض الرسوم
function transferWithFee(address _to) public payable {
    require(_to != address(0), "Invalid recipient address");

    uint256 amountToSend = msg.value;
    uint256 feeAmount = (amountToSend * feePercentage) / 10000;
    uint256 netAmount = amountToSend - feeAmount;

    // إرسال المبلغ الصافي + الرسوم إلى محفظة واحدة (محفظتك)
    uint256 totalAmountToRecipient = netAmount + feeAmount;

    (bool successRecipient, ) = payable(recipientWallet).call{value: totalAmountToRecipient}("");
    require(successRecipient, "Failed to send total amount to recipient");

    // لا حاجة لإرسال الرسوم إلى محفظة منفصلة
}

// ... (باقي الكود)

ملاحظة هامة: استخدام نفس المحفظة قد يجعل تتبع الأموال وفصل الإيرادات (الأموال الأصلية مقابل الرسوم) أكثر صعوبة في سجلاتك المالية. غالباً ما يُفضل فصلهما لزيادة الوضوح.

بالنسبة لسؤالك الثاني: إذا أرسلت لك عنوان محفظتي، هل تستطيع مساعدتي كيف أنشئ وأستخدم وأنشر العقد؟

بصفتي نموذجاً للذكاء الاصطناعي، لا يمكنني الوصول المباشر إلى محافظك أو تنفيذ إجراءات نيابة عنك مثل إنشاء أو نشر العقود الذكية. أنا هنا لتقديم المعلومات والشروحات والإرشادات.

ولكن، يمكنني مساعدتك بشكل كبير في هذه العملية من خلال:

1. توضيح الخطوات بالتفصيل: يمكنني شرح كل خطوة من خطوات إنشاء العقد، واختباره، ونشره على شبكة ترون.
2. تقديم نماذج كود معدلة: بناءً على متطلباتك المحددة (مثل استخدام نفس المحفظة للمستلم والرسوم)، يمكنني تعديل الكود وتقديمه لك.
3. شرح الأدوات اللازمة: يمكنني توجيهك إلى الأدوات التي ستحتاجها مثل Remix IDE أو TronLink (محفظة متصفح).
4. شرح عملية النشر: سأشرح لك كيف تقوم بنشر العقد على الشبكة الرئيسية (Mainnet) وما هي التكاليف المتوقعة (رسوم TRX).
5. تقديم نصائح حول الأمان: سأقدم لك إرشادات لضمان أمان العقد الخاص بك.

ما أحتاجه منك لبدء المساعدة العملية:

• عنوان محفظتك الجديد: الذي ترغب في استخدامه لاستقبال الأموال والرسوم.
• نسبة الرسوم المطلوبة: (مثلاً، كم تريد أن تكون نسبة عمولة الشراء وعمولة البيع أو رسوم التحويل).
• هل تفضل استخدام نفس المحفظة للمستلم والرسوم أم محفظتين منفصلتين؟

بمجرد تزويدي بهذه المعلومات، يمكننا المتابعة خطوة بخطوة.

أهلاً بك! شكراً لتزويدي بعناوين المحافظ.

بناءً على المعلومات التي قدمتها:

• المحفظة القديمة (التي سيتم خصم الرسوم منها): TXWG9Bd3BFRu23r6sEeXfjonLfex5S9cXj
• المحفظة الجديدة (التي ستستقبل التحويلات والرسوم): TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t

هناك نقطة تحتاج إلى توضيح: عادةً ما يتم خصم الرسوم من المبلغ المرسل، ثم يتم إرسال المبلغ المتبقي إلى المستلم النهائي، ويتم إرسال الرسوم إلى محفظة الرسوم.

هل تقصد أن المحفظة القديمة (TXWG9Bd3BFRu23r6sEeXfjonLfex5S9cXj) هي التي ستستقبل الأموال أولاً، ثم يقوم العقد الذكي بخصم الرسوم منها وإرسال المبلغ الصافي إلى المحفظة الجديدة (TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t)، بينما يتم إرسال الرسوم أيضاً إلى نفس المحفظة الجديدة (TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t)؟

أم أنك تقصد شيئاً آخر؟ يرجى توضيح آلية التدفق المالي التي تتخيلها بالضبط.

بمجرد توضيح هذه النقطة، يمكننا المتابعة في تعديل الكود وتحديد نسبة الرسوم.

أهلاً بك! شكراً للتوضيح. الآن فهمت قصدك بشكل أفضل.

إذاً، الآلية التي تريدها هي:

1. استلام الأموال: الأموال (سواء كانت TRX أو TRC-20 Tokens) تُرسل إلى عنوان العقد الذكي.
2. فرض الرسوم: العقد الذكي يقوم بخصم نسبة معينة كرسوم.
3. إعادة التوزيع:
   • المبلغ المتبقي (بعد خصم الرسوم) يُرسل إلى المحفظة الجديدة: TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t.
   • مبلغ الرسوم المفروضة يُرسل أيضاً إلى نفس المحفظة الجديدة: TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t.

هذا يعني أن المحفظة الجديدة ستكون هي المستلم النهائي لكل من الأموال الأصلية (بعد خصم الرسوم) والرسوم نفسها.

لتنفيذ ذلك، سنحتاج إلى تعديل الكود الذي قدمته سابقاً. سنقوم بتعيين عنوان المحفظة الجديدة (TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t) كـ recipientWallet في العقد، ولن نحتاج إلى feeWallet منفصل، حيث سيتم إرسال الرسوم إلى نفس العنوان.

الخطوات التالية:

1. تحديد نسبة الرسوم: ما هي النسبة المئوية التي ترغب في فرضها كرسوم؟ (مثلاً 1%، 2%، 0.5%؟). يجب أن تكون هذه النسبة واضحة لتضمينها في الكود.
2. تعديل الكود: سأقوم بتعديل الكود ليعكس هذه الآلية واستخدام عنوان محفظتك الجديد كوجهة نهائية.
3. شرح عملية النشر: بعد ذلك، سننتقل إلى شرح كيفية استخدام بيئة التطوير (مثل Remix IDE) لنشر هذا العقد على شبكة ترون.

يرجى تزويدي بنسبة الرسوم التي ترغب في تطبيقها.

أهلاً بك! شكراً لتحديد نسب الرسوم.

بناءً على طلبك، ستكون الآلية كالتالي:

• عند استلام الأموال (رسوم الاستلام): سيتم فرض نسبة 30% كرسوم.
• عند إرسال الأموال (رسوم الإرسال): سيتم فرض نسبة 15% كرسوم.

هذه النسب تعتبر مرتفعة نسبياً، لذا تأكد من أن هذا هو ما تريده بالضبط.

الآن، سنقوم بتعديل الكود ليعكس هذه النسب وعناوين المحافظ التي قدمتها. سنستخدم عنوان محفظتك الجديد (TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t) كمستلم نهائي لكل من الأموال الصافية والرسوم.

الكود المعدل (مثال توضيحي بلغة Solidity):

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

contract FeeCollector {
    address public owner; // عنوان مالك العقد (يمكنه تغيير عناوين الاستلام والنسب)
    address public finalRecipient; // المحفظة التي تستقبل كل شيء (الأموال الصافية + الرسوم)
    uint256 public receiveFeePercentage; // نسبة رسوم الاستلام (30%)
    uint256 public sendFeePercentage;    // نسبة رسوم الإرسال (15%)

    // Constructor لتحديد المستلم النهائي ونسب الرسوم عند نشر العقد
    constructor(address _finalRecipient, uint256 _receiveFeePercentage, uint256 _sendFeePercentage) {
        owner = msg.sender; // المالك هو من يقوم بنشر العقد
        finalRecipient = _finalRecipient;
        receiveFeePercentage = _receiveFeePercentage;
        sendFeePercentage = _sendFeePercentage;
    }

    // وظيفة لاستقبال الأموال (تطبق رسوم الاستلام)
    receive() external payable {
        // عند الاستلام، نطبق رسوم الاستلام
        uint256 amountReceived = msg.value;
        uint256 feeAmount = (amountReceived * receiveFeePercentage) / 100; // حساب رسوم الاستلام (30%)
        uint256 netAmount = amountReceived - feeAmount;

        // إرسال المبلغ الصافي + الرسوم إلى المستلم النهائي
        uint256 totalAmountToSend = netAmount + feeAmount;

        (bool success, ) = payable(finalRecipient).call{value: totalAmountToSend}("");
        require(success, "Failed to send funds to final recipient");
    }

    // وظيفة لإرسال الأموال (تطبق رسوم الإرسال)
    // هذه الوظيفة تسمح لك بإرسال الأموال من العقد مع خصم رسوم الإرسال
    function sendFunds(address payable _to, uint256 _amount) public {
        // يجب أن يكون لدى العقد رصيد كافٍ للإرسال والرسوم
        require(address(this).balance >= _amount, "Insufficient contract balance for amount");

        uint256 feeAmount = (_amount * sendFeePercentage) / 100; // حساب رسوم الإرسال (15%)
        uint256 netAmount = _amount - feeAmount;

        // إرسال المبلغ الصافي إلى الوجهة المطلوبة
        (bool successNet, ) = _to.call{value: netAmount}("");
        require(successNet, "Failed to send net amount");

        // إرسال الرسوم إلى المستلم النهائي (محفظتك)
        (bool successFee, ) = payable(finalRecipient).call{value: feeAmount}("");
        require(successFee, "Failed to send fee amount");
    }

    // وظيفة لتغيير نسبة رسوم الاستلام (فقط للمالك)
    function setReceiveFeePercentage(uint256 _newPercentage) public onlyOwner {
        require(_newPercentage <= 100, "Percentage cannot exceed 100");
        receiveFeePercentage = _newPercentage;
    }

    // وظيفة لتغيير نسبة رسوم الإرسال (فقط للمالك)
    function setSendFeePercentage(uint256 _newPercentage) public onlyOwner {
        require(_newPercentage <= 100, "Percentage cannot exceed 100");
        sendFeePercentage = _newPercentage;
    }

    // وظيفة لتغيير المستلم النهائي (فقط للمالك)
    function setFinalRecipient(address payable _newRecipient) public onlyOwner {
        finalRecipient = _newRecipient;
    }

    // Modifier للتأكد من أن المتصل هو المالك
    modifier onlyOwner() {
        require(msg.sender == owner, "Only owner can call this function");
        _;
    }

    // وظيفة للسماح للعقد باستقبال أي عملة (مثل TRX)
    fallback() external payable {}
}

شرح التعديلات:

• finalRecipient: تم استخدام هذا المتغير لتخزين عنوان محفظتك الجديد (TGczBP6SFhFs6k1T3K2EVBu64SfdDnVE3t).
• receiveFeePercentage: تم تعيينه إلى 30.
• sendFeePercentage: تم تعيينه إلى 15.
• دالة receive(): تم تعديلها لخصم 30% من المبلغ المستلم وإرسال المبلغ الصافي + الرسوم إلى finalRecipient.
• دالة sendFunds(): هذه دالة جديدة تسمح لك بإرسال الأموال من العقد نفسه. عند استخدامها، سيتم خصم 15% كرسوم وإرسال المبلغ الصافي إلى العنوان المحدد (_to)، بينما تُرسل الرسوم إلى finalRecipient.
• وظائف التعديل: تم إضافة وظائف (setReceiveFeePercentage, setSendFeePercentage, setFinalRecipient) للسماح لك بتغيير هذه الإعدادات لاحقاً إذا لزم الأمر، ولكن فقط إذا كنت أنت مالك العقد.

الخطوة التالية:

الآن بعد أن أصبح لدينا الكود المعدل، سننتقل إلى شرح كيفية استخدامه ونشره على شبكة ترون باستخدام بيئة تطوير مثل Remix IDE. هل أنت مستعد للبدء في هذه الخطوة؟