@agntn/puzzles

सार्वजनिक क्रिप्टो पहेलियाँ और इनाम, टाइप्ड रिकॉर्ड के रूप में। आप एक पहेली माँगते हैं, आपको उसका पता, उसकी कुंजी सामग्री और चेन पर क्या हुआ, मिलता है।

क्यों?

हर पहेली थ्रेड में वही तीन चीज़ें होती हैं: पते, इनाम, और किसने क्या हल किया। हर स्कैनर और ट्रैकर उन्हें थ्रेड से दोबारा टाइप करता है, हर बार थोड़ा अलग तरीके से। इसलिए वे यहाँ एक बार, कोड के रूप में रहते हैं। एक पहेली एक TypeScript रिकॉर्ड है। टाइप चेकर इसे टेस्ट से पहले पढ़ता है। CLI, MCP सर्वर और Pi तथा OMP एक्सटेंशन एक ही रजिस्ट्री पढ़ते हैं।

डॉक्स, प्रति पहेली एक पेज और एक लाइव प्लेग्राउंड: puzzles.agntn.dev।

[!WARNING] Pre-1.0। API, CLI फ़्लैग और डेटा मॉडल अभी भी बदल सकते हैं। यदि आप इस पर निर्माण करते हैं तो एक सटीक संस्करण पिन करें।

✨ विशेषताएँ

• 🧾 डेटा कोड के रूप में। प्रति पहेली एक PuzzleSpec लिटरल, हर चेन के लिए एक puzzle() फ़ैक्टरी द्वारा निर्मित। कोई JSON नहीं, कोई बिल्ड स्टेप नहीं।
• 🕳️ अनुपस्थित का अर्थ अनुपस्थित। बिना सॉल्वर या इनाम वाली पहेली में ऐसी कोई कुंजी नहीं होती। कुछ भी null के रूप में सीरियलाइज़ नहीं होता।
• 🔑 हर आकार में कुंजी सामग्री। Hex, WIF, एक BIP38 पेलोड, एक सीड फ़्रेज़, सीक्रेट शेयर, एक सीलबंद Arweave keyfile, या बस एक बिट चौड़ाई। मल्टीसिग की हर कुंजी भी। एक बिल्डर।
• 💤 लेज़ी रजिस्ट्री। पैकेज आयात करने से कोई रिकॉर्ड लोड नहीं होता। get("bits/71") एक कलेक्शन मॉड्यूल आयात करता है।
• ✅ सत्यापन एक मान है। एक प्रकाशित कुंजी पता व्युत्पन्न करती है या नहीं। खराब रिकॉर्ड के लिए कुछ भी थ्रो नहीं करता।
• 💰 लाइव बैलेंस। @agntn/explorers के माध्यम से puzzle.balance()। बेस यूनिट bigint के रूप में, त्रुटियों से API कुंजियाँ छिपाई गईं।
• 👀 रिकॉर्ड पर एक नज़र। puzzles watch उन जमा और खर्चों को सूचीबद्ध करता है जो एक रिकॉर्ड से छूट गए, एक इनाम जो स्थानांतरित हुआ, एक सार्वजनिक कुंजी जो एक खर्च ने उजागर कर दी, एक स्रोत पेज जो बदल गया। यह कभी रिकॉर्ड संपादित नहीं करता। आप करते हैं।
• 📋 सप्ताहांत से पहले एक चेकलिस्ट। puzzles eligibility स्रोत, पता, एक्सप्लोरर से लाइफ़टाइम कुल, साक्ष्य के साथ स्थिति और समाधान के रूप में क्या गिना जाता है, एकत्र करता है। जो कोई भी नहीं भर सकता वह missing पंक्ति के रूप में वापस आता है, कभी अनुमान नहीं।
• 🖼️ पहेली स्वयं, उसका लिंक नहीं। puzzles_assets एक मॉडल को छवि, स्टेज फ़ाइलें और संकेतों के पीछे के संग्रहीत पोस्ट सौंपता है, जिन्हें रिकॉर्ड द्वारा पिन किए गए SHA-256 के विरुद्ध जाँचा जाता है। लिंक सड़ जाते हैं। ये नहीं।
• 🤖 पंद्रह एजेंट टूल्स। MCP, Pi और OMP के पीछे एक एक्ज़ीक्यूटर। हर जगह एक ही उत्तर।
• 🌐 कहीं भी चलता है। Fetch API पर न्यूट्रल ESM। Node, ब्राउज़र, एज वर्कर्स।

📦 इंस्टॉल

pnpm add @agntn/puzzles

CLI के लिए Node.js 26 या नया।

🚀 पहला कॉल

npx @agntn/puzzles stats

यह कुल, प्रति स्थिति एक गणना और कितनी पहेलियों की सार्वजनिक कुंजी ज्ञात है, यह प्रिंट करता है। कोई कुंजी नहीं, कोई कॉन्फ़िग नहीं, कोई नेटवर्क नहीं। रिकॉर्ड पैकेज के अंदर ही शिप होते हैं। नीचे दिया गया बेयर puzzles लोकल pnpm add के बाद pnpm exec puzzles है, या pnpm add -g @agntn/puzzles के बाद सिर्फ़ puzzles है।

puzzles show hash-collision/sha256

hash-collision/sha256	unsolved	0.27734251 BTC	35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
chain: bitcoin  address kind: p2sh
hash160: 292fb39df7cd619a396069383928e6bfb74ebec5
redeem script: 6e879169a87ca887 (hash 292fb39df7cd619a396069383928e6bfb74ebec5)
public key: unknown
private key: unknown
started: 2013-09-13 05:59:09
transactions: 1
	funding	2013-09-13 05:59:09	0.1 BTC	397f12ee15f8a3d2ab25c0f6bb7d3c64d2038ca056af10dd8251b98ae0f076b0
explorer: https://blockstream.info/address/35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
source: https://bitcointalk.org/index.php?topic=293382.0

कमांड

कमांड	यह क्या प्रिंट करता है
puzzles stats	कुल योग, स्थिति गणनाएँ, पुरस्कार राशियाँ और डेटा संस्करण
puzzles collections	प्रत्येक संग्रह के लिए एक पंक्ति: कुंजी, गणनाएँ, लेखक
puzzles authors [key]	प्रत्येक लेखक के लिए एक पंक्ति, या एक लेखक का रिकॉर्ड उसके स्रोत तथ्यों के साथ
puzzles author <key>	एक लेखक का रिकॉर्ड, सीधे puzzles_author टूल से
puzzles solvers [key]	प्रत्येक नामित सॉल्वर के लिए एक पंक्ति, या एक सॉल्वर का रिकॉर्ड: प्रत्येक सॉल्व, प्रोफ़ाइल और स्रोत तथ्य
puzzles solver <key>	एक सॉल्वर का रिकॉर्ड, सीधे puzzles_solver टूल से
puzzles show <id>	एक पहेली का रिकॉर्ड: कुंजी सामग्री, लेन-देन, संकेत और लिंक। डेटा के लिए --json
puzzles hints <id>	संग्रह के संकेत, फिर पहेली के अपने, फिर उसकी संकेत फ़ाइलें। दोनों के लिए --json
puzzles stages <id>	एक बहु-चरणीय पहेली के चरण उनके पृष्ठों, फ़ाइलों और प्रकाशित उत्तरों के साथ। सूची के लिए --json
puzzles assets <id>	एक पहेली के साथ आने वाली फ़ाइलें SHA-256 और आकार के साथ, और उसके द्वारा उद्धृत संग्रहित पृष्ठ। --read <path> एक लिखता है, --check/--live सत्यापित करते हैं
puzzles list [collection]	प्रति पंक्ति एक पहेली। --address, --chain, --status, --technique और --with-pubkey इसे संकीर्ण करते हैं, --limit और --offset इसे पेज करते हैं
puzzles verify [id]	एक प्रकाशित कुंजी और उसका रेसिपी पते के विरुद्ध। सेट के लिए --all या list फ़िल्टर, बेमेल पर exit 1
puzzles balance [id]	लाइव बैलेंस। list फ़िल्टर पूरे सेट की जाँच करते हैं, प्रत्येक एक पंक्ति। --api-key, या प्रति चेन एक वेरिएबल
puzzles watch [id]	जो चेन जानती है और रिकॉर्ड नहीं जानता। --since स्रोत पृष्ठों की भी जाँच करता है, किसी भी खोज पर exit 1
puzzles eligibility <query>	किसी पुरस्कार पर काम करने से पहले की चेकलिस्ट, id या पते के अनुसार। कोई भी फ़ील्ड अनुपस्थित होने पर exit 1
puzzles export	संपूर्ण डेटासेट उसके data_version के साथ
puzzles mcp	stdio पर MCP सर्वर

--json टेक्स्ट के पीछे का डेटा प्रिंट करता है, bigint स्ट्रिंग के रूप में और अनुपस्थित फ़ील्ड छोड़े गए। कमांड उन्हीं टूल परिभाषाओं से आते हैं जो एजेंट्स को मिलती हैं, इसलिए किसी फ़्लैग में टाइपो यहाँ भी वैसे ही विफल होता है जैसे किसी मॉडल के लिए विफल होता है। फ़्लैग और exit कोड CLI गाइड में हैं।