عن المشروع

Unicity AgentSphere هي منصة محفظة ووكلاء Web3 مبنية لشبكة Unicity. تجمع بين وظائف محفظة العملات المشفرة والمراسلة والدردشة الجماعية وميزات السوق في تطبيق موحد. تشمل ميزات المحفظة الأساسية تحويلات رمزية سريعة ومنخفضة التكلفة، وإدارة الرموز وتتبع الأرصدة، وإشعارات الدفع الواردة، ونظام علامات أسماء لتحديد المستخدمين. تدعم المحفظة رموز QR، وتبديل المحافظ، وإدارة عبارة الاسترداد، وبيانات السوق في الوقت الفعلي. تنفذ المنصة بروتوكول Sphere Connect، الذي يتيح للتطبيقات اللامركزية الخارجية الاتصال بالمحفظة وطلب العمليات. يتم دعم وضعي اتصال: وضع iframe، حيث يتم تضمين التطبيق اللامركزي داخل Sphere ويتواصل عبر PostMessageTransport، ووضع النافذة المنبثقة، حيث يفتح التطبيق اللامركزي Sphere كنافذة منبثقة لموافقة المستخدم. الوصول قائم على الأذونات، حيث تطلب التطبيقات اللامركزية نطاقات محددة يمكن للمستخدمين الموافقة عليها أو رفضها. يدعم البروتوكول أيضًا معالجة النوايا، مما يتيح للتطبيقات اللامركزية تشغيل تدفقات الإرسال والتوقيع والرسائل المباشرة داخل واجهة المحفظة. يدعم Sphere بروتوكول روابط عميقة مخصص (unicity-connect://) للربط بين التطبيقات داخل الرسائل المباشرة. عندما يرسل تطبيق لامركزي رابطًا عميقًا في رسالة مباشرة، يعرضه Sphere كزر تفاعلي مع خيارات لفتح الرابط داخل Sphere كعامل iframe أو في علامة تبويب متصفح خارجية. يتم حل البروتوكول إلى عناوين HTTP/HTTPS قياسية، مع معالجة خاصة لعناوين localhost. يتيح نظام الوكلاء تحميل واجهات متخصصة كعلامات تبويب داخل التطبيق. تشمل الوكلاء النشطون حاليًا الرسائل المباشرة (DM) للمحادثات الخاصة عبر Nostr، والدردشة الجماعية للقنوات العامة عبر NIP-29، ووكلاء Sphere لتحميل أي تطبيق لامركزي خارجي عبر iframe بعنوان URL مخصص. يمكن إضافة أنواع وكلاء إضافية من خلال التكوين. تم بناء وظيفة الدردشة الجماعية على NIP-29، وهو مواصفات بروتوكول Nostr للمراسلة الجماعية القائمة على المرحلات. تشمل الميزات مجموعات عامة وخاصة مع رموز دعوة، ومراسلة في الوقت الفعلي عبر WebSocket، واكتشاف المجموعات، وعمليات الانضمام/المغادرة، وتتبع الرسائل غير المقروءة. يتوفر مرحل مخصص على wss://sphere-relay.unicity.network. تم بناء التطبيق باستخدام React 19 وTypeScript، مع Vite 7 كأداة بناء. يستخدم TanStack Query v5 لإدارة حالة الخادم، وTailwind CSS 4 للتصميم، وFramer Motion للرسوم المتحركة، وReact Router DOM v7 للتوجيه. تتم جميع عمليات المحفظة من خلال حزمة @unicitylabs/sphere-sdk، التي تغطي وظائف L3 وNostr وIPFS. يتم الاختبار باستخدام Vitest وjsdom. يمكن تشغيل المشروع في وضع التطوير باستخدام npm run dev، وبناؤه للإنتاج باستخدام npm run build، ونشره عبر Docker Compose على المنفذ 3010. تتحكم متغيرات البيئة في التكوين مثل علامة اسم وكيل الترحيب، وتأخير الترحيب، وشهادات SSL، ومسار النشر الأساسي. المشروع مرخص كمشروع خاص من قبل Unicity Labs.