มาตรฐานเปิด · รุ่น 1.0

Bob SPV Helper API v1

ข้อกำหนดที่ไม่ผูกผู้ให้บริการ สำหรับเชื่อมกระเป๋าเงิน SPV แบบเบาของ Bob กับข้อมูลอ่านอย่างเดียวจากโหนด Handshake ที่ตรวจสอบเต็มรูปแบบ

ตัวช่วยทำอะไร

โหมด SPV ตรวจสอบส่วนหัวและกิจกรรมกระเป๋าเงินโดยไม่เก็บสถานะเชน Handshake ทั้งหมด ตัวช่วยให้ข้อมูลบล็อกที่มีดัชนี ธุรกรรม เหรียญ ประมาณค่าธรรมเนียม และสถานะชื่อ ที่ Bob สร้างกลับมาในเครื่องอย่างเชื่อถือไม่ได้

ตัวช่วยไม่รับวลีกู้คืนหรือคีย์ส่วนตัว ไม่ลงนามแทนผู้ใช้ และไม่เผยแพร่ธุรกรรมสู่เครือข่าย Bob ลงนามในเครื่องและเผยแพร่ผ่านเพียร์ Handshake ของตนเอง

ข้อกำหนดผู้ให้บริการ

ให้บริการ API ผ่าน HTTPS จาก URL ฐานที่คงที่
ใช้โหนดเต็ม HSD บน mainnet ที่ซิงค์ครบและไม่ตัดทอนข้อมูล
เปิดดัชนีธุรกรรมและที่อยู่
เปิดเฉพาะเส้นทาง REST และเมธอด JSON-RPC แบบอ่านอย่างเดียวที่มีเอกสารระบุ
คงความหมายการตอบกลับมาตรฐาน HSD และจำนวนเงินหน่วย dollary แบบจำนวนเต็ม
ปฏิเสธเมธอด RPC ด้านกระเป๋าเงิน การขุด การดูแลระบบ และการเปลี่ยนสถานะ
ปกป้องคีย์ API ส่วนตัวของ HSD และวางเกตเวย์ที่จำกัดการเข้าถึงไว้หน้า HSD

API ที่ต้องรองรับ

วิธี	พาธ	วัตถุประสงค์
GET	`/hsd`	ข้อมูลโหนด
GET	`/hsd/block/:id`	ค้นหาบล็อก
GET	`/hsd/tx/:hash`	ค้นหาธุรกรรม
GET	`/hsd/coin/:hash/:index`	ค้นหาเหรียญปัจจุบัน
POST	`/hsd/tx/address`	ประวัติที่อยู่
POST	`/hsd`	JSON-RPC แบบอ่านอย่างเดียวที่อนุญาต

เมธอด JSON-RPC ที่จำเป็นคือ estimatesmartfee, getblockbyheight, getblockchaininfo, getnamebyhash, getnameinfo และ verifymessage

การจดทะเบียนชื่ออย่างปลอดภัย

ก่อน Bob จัดหาเงินหรือลงนามธุรกรรม REGISTER ต้องเรียก getnameinfo ผ่านตัวช่วยที่ตั้งค่าไว้และตรวจสอบชื่อ แฮชชื่อ สถานะ CLOSED ความสูงประมูล outpoint ที่ชนะ สถานะจดทะเบียน และมูลค่าประมูลสุดท้าย

เอาต์พุต REGISTER ต้องเท่ากับ result.info.value ทุกประการ ค่านั้นเป็นจำนวนเต็มหน่วย dollary ห้ามใช้ info.highest ป้ายข้อความของตัวสำรวจ HTML ที่แสดงผล หรือสตริงทศนิยมแทนค่านี้ การชนะที่มูลค่าศูนย์ยังใช้ได้

หากไม่มีคำตอบจากตัวช่วยหรือขัดกับสถานะกระเป๋าเงินในเครื่องของ Bob, Bob ต้องหยุดก่อนลงนามหรือเผยแพร่สู่เครือข่าย

การทำงานร่วมกันและการปฏิบัติตามข้อกำหนด

Bob ต้องทำงานกับผู้ให้บริการทุกรายที่ตรงข้อกำหนด กฎธุรกรรมต้องไม่ขึ้นกับชื่อโฮสต์ผู้ให้บริการ อนุญาตฟิลด์ตอบกลับเพิ่มเติมที่ไม่รู้จักได้ แต่การเปลี่ยนความหมายฟิลด์หรือหน่วยเงินต้องใช้รุ่นหลักใหม่

ผู้ให้บริการ HandshakeAPI เดิมและ LearnHNS ส่งข้อมูลชื่อที่สำคัญต่อฉันทามติเหมือนกันในการเปรียบเทียบจริงเมื่อ 7 สิงหาคม 2026 LearnHNS เพิ่มเพียงฟิลด์ทางเลือก start.locked

อ่านหรือดาวน์โหลด มาตรฐาน Markdown ธรรมดา (ภาษาอังกฤษ) เกตเวย์อ้างอิงมีการตรวจสอบผู้ให้บริการและทดสอบความเข้ากันได้อัตโนมัติตามข้อกำหนดนี้

ผู้ให้บริการปัจจุบัน

LearnHNS: https://spv.learnhns.com/hsd
บริการเดิม: https://api.handshakeapi.com/hsd คาดว่าจะยุติบริการหลัง 31 สิงหาคม 2026

การมีรายชื่อผู้ให้บริการเป็นการบันทึกความเข้ากันได้ ไม่ใช่การรับฝากสินทรัพย์หรือรับรอง ใน Bob LearnHNS ผู้ใช้ตั้งค่าผู้ให้บริการ v1 อื่นที่ผ่านการตรวจสอบได้ที่ Settings → Network & Connection → SPV Helper API ส่วน Bob รุ่นดั้งเดิม 2.1.0 ไม่มีการตั้งค่า URL ตัวช่วยและเปลี่ยนมาใช้ไม่ได้

ตำแหน่งตรวจสอบตัวช่วยใน Bob LearnHNS