L1 और L2 के लिए एक बिटकॉइन वॉलेट MCP सर्वर

इस सप्ताह के अंत में मैंने बिटकॉइन वॉलेट के लिए एक एमसीपी सर्वर तैयार किया: ऐसे उपकरण जिन्हें एआई एजेंट मॉडल कॉन्टेक्स्ट प्रोटोकॉल पर कॉल कर सकते हैं। रेपो लेयर 1 और लेयर 2 में 93 टूल को उजागर करता है। एक निमोनिक दोनों को संचालित करता है।

मैं पहले लेदर का महाप्रबंधक था, एक क्रिप्टो वॉलेट जो बिटकॉइन और स्टैक का भी समर्थन करता है। लेदर में मैंने देखा कि मानव-सामना वाले स्व-अभिरक्षा वाले बटुए ज्यादातर ध्यान और जटिलता को अवशोषित करने के इच्छुक लोगों तक पहुंचते हैं (उदाहरण के लिए डीजेन्स और डेवलपर्स)। इसका मतलब मुख्य स्वच्छता, शुल्क जागरूकता, पुष्टिकरण प्रवाह और बाकी चीजें थीं। संज्ञानात्मक भार ने वास्तविक पता योग्य बाज़ार को संकीर्ण बनाए रखा।

एजेंट वॉलेट इसे बदल देते हैं। जब प्राथमिक इंटरफ़ेस एजेंट होता है जो नीति के भीतर तर्क करता है और निष्पादित करता है, तो उपयोगकर्ता केवल वही स्वीकार करता है जो मायने रखता है। घर्षण कम हो जाता है और ऐसे लोगों का समूह बढ़ता है जो व्यावहारिक रूप से अपनी चाबियाँ स्वयं पकड़ सकते हैं।

वही दो जंजीरें. अलग सतह.

सर्वर क्या प्रदर्शित करता है (एक सतह में L1 और L2)

सर्वर एक एकल एमसीपी प्रक्रिया है। ग्राहक stdio पर टूल नाम और JSON तर्क भेजते हैं और संरचित परिणाम प्राप्त करते हैं। विनाशकारी क्रियाएं (भेजें, साइन-एंड-ब्रॉडकास्ट, तैनाती) dry_run का समर्थन करती हैं और डिफ़ॉल्ट रूप से प्रसारित नहीं होती हैं। सर्वर कभी भी कुंजियाँ या निमोनिक्स नहीं लौटाता।

परत 1 (बिटकॉइन)

कोर बिटकॉइन:

सार्वजनिक कुंजी और पथ के साथ P2PKH, P2SH-P2WPKH, P2WPKH और P2TR के लिए पता व्युत्पत्ति।
प्रति पता प्रकार शेष राशि वाले खाते (mempool.space UTXO डेटा के लिए); वॉलेट बैलेंस और बीटीसी कीमतें (यूएसडी, यूरो)।
एकल और बहु-प्राप्तकर्ता भेजता है (राशि बीटीसी या यूरो में); भेजने से पहले शुल्क अनुमान के साथ स्थानांतरण का पूर्वावलोकन करें।
स्वीप (अधिकतम भेजें) और UTXO समेकन।
पीएसबीटी साइन, डिकोड और बैच साइन; संदेश पर हस्ताक्षर करें और सत्यापित करें (ईसीडीएसए विरासत और बीआईपी-322)।
mempool.space से शुल्क स्तर और इनपुट/आउटपुट गणना और पता प्रकार के आधार पर शुल्क अनुमान।
फिल्टर के साथ UTXO लिस्टिंग (पता प्रकार, न्यूनतम मूल्य, केवल पुष्टि) और प्रति-UTXO विवरण।

अध्यादेश और शिलालेख:

पेजिनेशन के साथ शिलालेखों की सूची बनाएं; शिलालेख विवरण (उत्पत्ति, सामग्री प्रकार, सैट क्रमसूचक, दुर्लभता, स्थान)।
शिलालेख भेजें (पूर्ण यूटीएक्सओ या विभाजित ताकि केवल शिलालेख की सैट सीमा ही प्राप्तकर्ता तक जाए)।
मिश्रित यूटीएक्सओ से ऑर्डिनल्स निकालें; ऑर्डिनल्स पते से बीटीसी पुनर्प्राप्त करें (स्वीप गैर-शिलालेख यूटीएक्सओ); भुगतान पते पर आए ऑर्डिनल्स को वापस टैपरूट पते पर पुनर्प्राप्त करें।
प्रतिबद्ध/प्रकटीकरण शुल्क अनुमान के साथ एकल या बैच शिलालेख बनाएं।

लेन-देन और वॉलेट प्रबंधन:

बीटीसी और स्टैक के लिए लेनदेन इतिहास; एकल tx के लिए स्थिति.
आरबीएफ के माध्यम से लंबित बीटीसी में तेजी लाएं; लंबित बीटीसी रद्द करें (आरबीएफ सेंड-टू-सेल्फ)।
नेटवर्क कॉन्फ़िगरेशन और एपीआई एंडपॉइंट; मेननेट/टेस्टनेट स्विच करें; कस्टम नेटवर्क जोड़ें.
सभी समर्थित टूल नाम और विवरण सूचीबद्ध करें।

लेजर (बिटकॉइन ऐप):

कनेक्टेड लेजर डिवाइस से बीटीसी पते प्राप्त करें।
लेजर बिटकॉइन ऐप के साथ पीएसबीटी पर हस्ताक्षर करें।

परत 2 (ढेर)

वही स्मरक स्टैक कुंजी (पथ m/44'/5757'/0'/0/0) प्राप्त करता है। हिरो चेन डेटा और प्रसारण के लिए स्टैक एपीआई।

ढेर:

पते और सार्वजनिक कुंजी; एसटीएक्स बैलेंस, लॉक की गई राशि, नॉनसेस वाले खाते।
परिवर्तनीय और अपूरणीय टोकन सहित संतुलन।
वैकल्पिक मेमो के साथ एसटीएक्स ट्रांसफर (माइक्रो-एसटीएक्स); शुल्क और शेष राशि की जांच के साथ पूर्वावलोकन स्थानांतरण।
अनुबंध कॉल के माध्यम से एसआईपी-10 फंजिबल और एसआईपी-9 एनएफटी ट्रांसफर।
स्पष्टता: सार्वजनिक फ़ंक्शन को कॉल करें, अनुबंध तैनात करें, केवल-पढ़ने के लिए कॉल करें।
साइन क्रमबद्ध स्टैक टीएक्स (एसआईपी-30), साइन संदेश, साइन एसआईपी-018 संरचित डेटा; गैर और शुल्क अनुमान.
बीएनएस नामों के लिए ऑन-चेन प्रोफ़ाइल अपडेट (schema.org/Person)।
फ़िल्टर के साथ लेन-देन संबंधी प्रश्न (प्रकार, ब्लॉक रेंज, अनएंकर्ड) और अनुबंध द्वारा।
मेमपूल: लंबित लेनदेन की सूची, मेमपूल आँकड़े, गिराए गए लेनदेन।
ब्लॉक एक्सप्लोरर: हाल के ब्लॉक, ऊंचाई या हैश द्वारा ब्लॉक, किसी दिए गए बिटकॉइन ब्लॉक के लिए स्टैक ब्लॉक।
अनुबंध घटनाएँ: किसी अनुबंध के लिए घटनाएँ, या किसी पते के लिए परिसंपत्ति घटनाएँ।
टोकन मेटाडेटा: SIP-10 और SIP-9 मेटाडेटा और धारक।
नेटवर्क जानकारी और स्वास्थ्य/स्थिति।

स्वैप, डेफी, और ब्रिज:

समर्थित जोड़े और प्रोटोकॉल (ALEX, बिटफ्लो, वेलार)।
तीनों के लिए स्वैप उद्धरण (अनुमानित आउटपुट, दर, शुल्क); एलेक्स डेक्स के माध्यम से स्वैप निष्पादित करें। बिटफ़्लो और वेलार उद्धरण और जोड़ी खोज का समर्थन करते हैं; आप प्रोटोकॉल एसडीके के माध्यम से निष्पादन जोड़ सकते हैं (उदाहरण के लिए वेलार एसडीके अनुबंध-कॉल पैरामीटर लौटाता है)।
ऑन-चेन गतिविधि से इतिहास बदलें।
एसबीटीसी बैलेंस और ब्रिज जमा/निकासी की जानकारी।
स्टैकिंग: वर्तमान पीओएक्स स्थिति, चक्र जानकारी (शेष ब्लॉक, प्रतिशत पूर्ण, अनुमानित समय शेष, भागीदारी दर), एकल स्टैकिंग आरंभ करें, प्रतिनिधिमंडल को रद्द करें।

बीएनएस और बाज़ार डेटा:

बीएनएस लुकअप (नाम से पता), पते के स्वामित्व वाले नाम, बीएनएस नाम पंजीकृत करें।
बहु-परिसंपत्ति कीमतें (उदाहरण के लिए CoinGecko); चार्टिंग के लिए मूल्य इतिहास।
पोर्टफोलियो सारांश (यूएसडी में बीटीसी + एसटीएक्स); सभी संपत्तियां और संग्रहणीय वस्तुएं (शिलालेख, स्टैक एनएफटी)।

लेजर (स्टैक्स ऐप):

लेजर से स्टैक पते प्राप्त करें।
लेजर स्टैक ऐप के साथ स्टैक लेनदेन पर हस्ताक्षर करें।

सुरक्षा और डिज़ाइन

⚠️ यह MCP सर्वर प्रायोगिक है और सार्थक निधियों के लिए सुरक्षित नहीं है। केवल उन बटुए के साथ उपयोग करें जिन्हें आप खोने के लिए तैयार हैं। किसी ने भी कोड का युद्ध-परीक्षण या ऑडिट नहीं किया है। मैं इसे एजेंट-नेटिव वॉलेट सतहों का पता लगाने के लिए एक शोध कलाकृति के रूप में मानता हूं।

विनाशकारी संचालन डिफ़ॉल्ट रूप से dry_run: true पर होता है। प्रत्येक प्रेषण पथ के लिए पूर्वावलोकन और अनुमान उपकरण मौजूद हैं। कुंजियाँ संस्करण नियंत्रण और टूल प्रतिक्रियाओं से बाहर रहती हैं। रन स्क्रिप्ट रेपो रूट से .env लोड करती है।

वॉलेट कुंजी चर (गुप्त रखें, कभी प्रतिबद्ध न हों):

BTC_PRIVATE_KEY - WIF-एन्कोडेड बिटकॉइन निजी कुंजी; यदि सेट किया गया है, तो स्मरक पर प्राथमिकता दी जाती है।
BTC_MNEMONIC — BIP-39 बीज वाक्यांश; सर्वर इसका उपयोग बिटकॉइन और स्टैक कुंजियाँ प्राप्त करने के लिए करता है (स्टैक के लिए समान स्मरक, पथ m/44'/5757'/0'/0/0)।
BTC_MNEMONIC_PASSPHRASE — BTC_MNEMONIC के साथ उपयोग करने के लिए वैकल्पिक BIP-39 पासफ़्रेज़।

सुरक्षा और सीमाएँ (env या .env):

BTC_NETWORK — मेननेट या टेस्टनेट (डिफ़ॉल्ट टेस्टनेट)।
BTC_MAINNET_ENABLED — मेननेट सेंड (सुरक्षा ध्वज) की अनुमति देने के लिए इसे सेट करें।
BTC_DRY_RUN - जब सेट किया जाता है (डिफ़ॉल्ट), विनाशकारी ऑप्स (भेजता है, साइन-एंड-ब्रॉडकास्ट, तैनाती) प्रसारित नहीं होता है; वास्तविक लेनदेन की अनुमति देने के लिए इसे गलत पर सेट करें।
BTC_MAX_SEND_BTC — बीटीसी में प्रेषण राशि पर वैकल्पिक सीमा; सर्वर इससे ऊपर के अनुरोधों को अस्वीकार कर देता है।
BTC_MAX_FEE_SATS - प्रति लेनदेन सातोशी में शुल्क की वैकल्पिक सीमा।
STX_ACCOUNT_INDEX — स्टैक व्युत्पत्ति खाता सूचकांक (डिफ़ॉल्ट 0)।
कॉन्फ़िगरेशन अन्यथा शुल्क स्तर (निश्चित दर या मेमपूल.स्पेस स्तर: घंटा, आधा घंटा, सबसे तेज़) चलाता है।

यह मेरे एजेंट स्टैक में कैसे फिट बैठता है

मैं एजेंटों को तीन-परत आर्किटेक्चर पर चलाता हूं। परतों को सफाई से अलग किया जाता है ताकि स्मृति, तर्क और क्रिया सही स्थान पर रहें।

सत्य परत: यह मेमोरी सब्सट्रेट है। इसमें टाइप किया हुआ, संरचित डेटा होता है: होल्डिंग्स, प्रवाह, लेनदेन, संपर्क, कार्य और बाकी। मेरे सेटअप में कैनोनिकल स्टोर नियोटोमा है। यह पूर्ण उद्गम और इकाई रिज़ॉल्यूशन के साथ इवेंट सोर्सिंग और रिड्यूसर का उपयोग करता है। एजेंट इससे पढ़ते हैं। वे कभी सीधे सच नहीं लिखते. सभी अद्यतन निष्पादन परत द्वारा उत्पादित डोमेन घटनाओं के माध्यम से प्रवाहित होते हैं।

रणनीति परत: यह वह जगह है जहां लक्ष्य, बाधाएं और रणनीति रहती हैं। रणनीति दस्तावेज़, सामरिक प्लेबुक और संचालन मैनुअल यहां मौजूद हैं। एजेंट इस परत का उपयोग तर्क करने के लिए करते हैं: वे विश्व स्थिति को पढ़ते हैं, प्राथमिकताओं और जोखिम का मूल्यांकन करते हैं, और निर्णय और आदेश देते हैं। रणनीति शुद्ध अनुभूति है. कोई दुष्प्रभाव नहीं। राज्य अंदर, निर्णय बाहर।

निष्पादन परत: यह वह जगह है जहां बाहरी क्रियाएं होती हैं। यह रणनीति परत से कमांड लेता है और एडेप्टर के माध्यम से साइड इफेक्ट करता है: ईमेल, कैलेंडर, डीएनएस, और इस मामले में बिटकॉइन और स्टैक वॉलेट एमसीपी। वॉलेट सर्वर कई में से एक निष्पादन एडाप्टर है। यह कभी भी सत्य परत को परिवर्तित नहीं करता है। यह काम करता है (भेजें, हस्ताक्षर करें, स्वैप करें) और बाकी स्टैक रिकॉर्ड करता है कि डोमेन घटनाओं के माध्यम से क्या हुआ। कमांड अंदर, इवेंट बाहर।

मैं रणनीति को परिभाषित और बनाए रखता हूं। एजेंट सत्य परत से पढ़ते हैं और निष्पादित करने के लिए एमसीपी टूल को कॉल करते हैं। मैं नियमित संचालन के लिए पॉइंट-एंड-क्लिक क्रिप्टो यूआई का उपयोग नहीं करता। मैं केवल उन कार्यों को मंजूरी देने के लिए कदम उठाता हूं जो मेरी पूर्व-निर्धारित सीमा से अधिक हैं।

अल्पकालिक मेरे उपयोग के मामले एकमुश्त हैं: सेवाओं के लिए भुगतान करना, मैन्युअल संकेतन के माध्यम से पोर्टफोलियो को पुनर्संतुलित करना। दीर्घावधि में मैं उन प्रवाहों को स्वचालित बनाना चाहता हूँ। एजेंट नीति के अंतर्गत निगरानी करेंगे, तर्क करेंगे और क्रियान्वयन करेंगे। मैं स्पष्टीकरण देखूंगा और आवश्यकता पड़ने पर अनुमोदन करूंगा।

मैं निर्माण के बारे में कैसे सोच रहा हूं

मैं पहले अपने स्वयं के वर्कफ़्लो में सर्वर को डॉगफूड कर रहा हूं। मैं प्रत्येक सतह (सेंड, पीएसबीटी, ऑर्डिनल्स, स्टैक ट्रांसफर, स्वैप) का धीरे-धीरे छोटी मात्रा और ड्राई रन के साथ परीक्षण कर रहा हूं।

मैंने इसे उसी स्टैक में जोड़ दिया है जहां मैं पहले से ही [सच्चाई और रणनीति परतों](/ पोस्ट/एजेंट-सर्च-एंड-द-ट्रुथ-लेयर#व्हेयर-इव-हिट-लिमिट्स) का उपयोग करता हूं। एजेंट वॉलेट गतिविधियों को कैलेंडर, ईमेल और डेटा के साथ जोड़ सकते हैं। बाहरी उपयोगकर्ता अभी दायरे में नहीं हैं.

मेरा लक्ष्य एक एजेंट वॉलेट सतह के आकार को मान्य करना और अपने स्वयं के बिटकॉइन और स्टैक संचालन को मैन्युअल के बजाय एजेंट-संचालित बनाना है।

इसे चलाने के लिए: क्लोन mcp-server-bitcoin (या mcp/btc_wallet/ पर सबमॉड्यूल के रूप में जोड़ें), सर्वर को अपने MCP कॉन्फ़िगरेशन में जोड़ें (run_btc_wallet_mcp.sh स्क्रिप्ट पथ का उपयोग करें), और ड्राई रन के साथ एक परीक्षण वॉलेट का उपयोग करें।

चाबी छीनना