इस प्रोजेक्ट के बारे में

Sierpe एक सेल्फ-होस्टेड सर्वर है जो उन कॉन्ट्रैक्ट्स के लिए Stellar नेटवर्क की निगरानी करता है जिन्हें उपयोगकर्ता रजिस्टर करता है और ऑपरेटर के अपने Postgres डेटाबेस में उनका पूरा इतिहास रखता है, जिसे REST API और एक एम्बेडेड मैनेजमेंट UI के माध्यम से उपलब्ध कराया जाता है। प्रोजेक्ट खुद को v1.5.2 के रूप में लेबल करता है, जिसका डिज़ाइन docs/DESIGN.md में स्थिर बताया गया है, और यह बताता है कि इवेंट्स, कॉन्ट्रैक्ट स्टेट, टोकन ट्रांसफर, ट्रस्टलाइन्स और टोकन मूवमेंट्स फीचर-कम्प्लीट हैं और टेस्टनेट पर चलते हैं। यह क्या इंडेक्स करता है - रजिस्टर्ड कॉन्ट्रैक्ट्स द्वारा उत्सर्जित इवेंट्स, जिन्हें प्रत्येक कॉन्ट्रैक्ट के ऑन-चेन स्पेसिफिकेशन से खोजा जाता है और चंक्स में बैकफिल किया जाता है, फिर चेन टिप पर फॉलो किया जाता है। - कॉन्ट्रैक्ट स्टेट: स्टोरेज प्रविष्टियों का परिवर्तन इतिहास और एक वर्तमान स्नैपशॉट। - डिकोडेड टोकन ट्रांसफर (SEP-41 डिकोडिंग, CAP-67 मक्सड) और SAC एसेट्स की क्लासिक ट्रस्टलाइन्स। - किसी कॉन्ट्रैक्ट में या उससे बाहर टोकन मूवमेंट्स, चाहे वह किसी भी कॉन्ट्रैक्ट द्वारा उत्सर्जित हो, जिसमें प्रति-प्रकार कवरेज रिपोर्टिंग शामिल है। - RPC रिटेंशन विंडो से नीचे का इतिहास: Stellar RPCs लगभग सात दिनों के इवेंट्स रखते हैं, इसलिए Sierpe वहां से बैकफिल करता है जहां स्रोत अनुमति देते हैं और उन श्रेणियों के लिए पब्लिक History Archives को रीप्ले करने के लिए डिज़ाइन किया गया है जिन्हें RPC सर्व नहीं करता; आर्काइव रीप्ले `-full` इमेज के माध्यम से प्रदान किया जाता है। इसका उपयोग कैसे किया जाता है डिप्लॉयमेंट एक खाली Postgres के बगल में एक कंटेनर है। कॉन्ट्रैक्ट्स को रनटाइम पर डेटा के रूप में रजिस्टर किया जाता है, कोड के रूप में नहीं, एक प्रमाणित कॉल जैसे POST /v1/contracts के माध्यम से जिसमें कॉन्ट्रैक्ट ID और `from: genesis` होता है; इसके बाद सर्वर कॉन्ट्रैक्ट को वर्गीकृत करता है, उसके इतिहास को बैकफिल करता है और उसका अनुसरण करता रहता है। उपयोगकर्ता getEvents-v2-स्टाइल फिल्टर (उदाहरण के लिए topic0 और कर्सर्स), किसी कुंजी के लिए वर्तमान स्टोरेज स्नैपशॉट, और किसी भी स्टोरेज प्रविष्टि के इतिहास के साथ क्वेरी कर सकते हैं। डॉक्यूमेंटेशन Railway, Docker Compose और जेनेरिक कंटेनर डिप्लॉयमेंट की सूची देता है, और README सुझाव देता है कि वही बाइनरी Railway, AWS, GCP या एक छोटे VPS पर चलती है, जिसमें एक विशिष्ट प्रोजेक्ट के लिए $10/माह से कम की लक्षित लागत है। आवश्यकताओं में Docker या Go 1.25+, और DATABASE_URL, NETWORK और ADMIN_TOKEN के माध्यम से कॉन्फ़िगरेशन शामिल है। API व्यवहार और ईमानदारी की गारंटी README इस बात पर जोर देता है कि कवरेज और गैप्स प्राथमिक डेटा हैं: प्रत्येक प्रतिक्रिया `coverage` और HAS_MORE, WAITING_FOR_LEDGERS, OLDEST_REACHED या COMPLETE का `scanStatus` घोषित करती है, इसलिए एक खाली पेज यह संकेत देता है कि या तो कुछ मौजूद नहीं है या इंडेक्सिंग उस रेंज तक नहीं पहुंची है। पेजिनेशन अपारदर्शी कर्सर्स पर निर्भर करता है जो पूरी क्वेरी को एनकोड करते हैं, जिसका उद्देश्य ड्रिफ्ट को रोकना है। पूर्ण API सरफेस docs/openapi.yaml में निर्दिष्ट है और मेट्रिक्स docs/METRICS.md में प्रलेखित हैं; एक Grafana डैशबोर्ड और स्टेटस पेज अप्लायंस डिलिवरेबल्स में सूचीबद्ध हैं। इंटरफेस और एक्सेस कंट्रोल एक मैनेजमेंट UI `/` पर एम्बेडेड है और एक कॉन्ट्रैक्ट लिस्टिंग एंडपॉइंट है। पब्लिक डोमेन पर डिप्लॉयमेंट के लिए एक वैकल्पिक होल-सरफेस Basic Auth मोड पेश किया गया है। स्पष्ट गैर-लक्ष्य README बताता है कि प्रोजेक्ट कोई होस्टेड सेवा नहीं है, कोई एनालिटिक्स प्लेटफॉर्म नहीं है (उपयोगकर्ता डेटा पर कोई एग्रीगेशन या डैशबोर्ड नहीं), कोई चेन-वाइड इंडेक्सर नहीं है (केवल रजिस्टर्ड कॉन्ट्रैक्ट्स इंडेक्स किए जाते हैं), और कोई फ्रेमवर्क नहीं है — इसे उपयोग करने के लिए कोड लिखने की आवश्यकता होना एक बग माना जाएगा। रोडमैप पूरे किए गए मील के पत्थर स्केलेटन (कॉन्फ़िगरेशन, हेल्थ, माइग्रेशन, निरंतरता जांच के साथ कर्सर लूप), एंड-टू-एंड इवेंट्स, कॉन्ट्रैक्ट स्टेट, एक अप्लायंस रिलीज़ v1.0.0, टोकन ट्रांसफर और SAC ट्रस्टलाइन्स (v1.1), आर्काइव रीप्ले (v1.2), एम्बेडेड UI और कॉन्ट्रैक्ट लिस्टिंग (v1.3), वैकल्पिक Basic Auth (v1.4) और प्रति-प्रकार कवरेज के साथ टोकन मूवमेंट्स (v1.5) को कवर करते हैं। नियोजित कार्यों में v1.6 में कॉन्ट्रैक्ट-क्लास डिस्कवरी शामिल है, जहां wasm हैश को रजिस्टर करने से उससे डिप्लॉय किए गए हर कॉन्ट्रैक्ट का इंडेक्स बन जाता है, और v2 में हस्ताक्षरित वेबहुक्स और ब्रोकर सिंक के साथ पुश डिलीवरी, जिसमें एक MCP सर्वर को अन्वेषण के अधीन बताया गया है। प्रोजेक्ट सामग्री डॉक्यूमेंटेशन में docs/DESIGN.md (आर्किटेक्चर, डेटा मॉडल, API सरफेस, कॉन्फ़िगरेशन, मील के पत्थर), docs/DEPLOY.md, docs/KNOWLEDGE.md (प्रोडक्शन इंडेक्सर्स से निकाले गए 29 सिद्धांत, जिनमें से प्रत्येक का अपना स्रोत है), CONTRIBUTING.md और SECURITY.md शामिल हैं। प्रोजेक्ट Apache-2.0 के तहत लाइसेंस प्राप्त है और इश्यूज और फीडबैक का स्वागत करता है।