Faucet ของ testnet
faucet คือทางเข้าออนไลน์สำหรับการพัฒนาบน TensorCash โดยจะส่งเหรียญ testnet จำนวนเล็กน้อยไปยังที่อยู่ testnet ที่ถูกต้องใดก็ได้ เพื่อให้คุณเติมเงินเข้าวอลเล็ต ทดลองใช้ JSON-RPC และทดสอบ flow ของโมเดลหรือสินทรัพย์กับเชนจริงที่ใช้ร่วมกัน เหรียญเหล่านี้ไม่มีมูลค่า หากต้องการ sandbox แบบออฟไลน์ทั้งหมดที่ได้เหรียญทันทีไม่จำกัด ให้ใช้ คู่มือ regtest แทน
รับเหรียญ
ส่ง POST ที่อยู่ testnet ของคุณในรูป JSON ไม่ต้องมี API key ไม่ต้องมีบัญชี หากสำเร็จ response จะเป็น id ของธุรกรรมที่ broadcast แล้ว ติดตามได้บน explorer ของ testnet
curl -sS -X POST https://mempool-testnet.tensorcash.org/api/v1/faucet \
-H 'Content-Type: application/json' \
-d '{"address": "<your-testnet-address>"}'
# {"txid":"…","address":"<your-testnet-address>","amount":"0.05"}ยังไม่มีที่อยู่ใช่ไหม วอลเล็ต TensorCash ใดก็ได้บน testnet สร้างให้คุณได้ ผ่าน getnewaddress ทาง JSON-RPC หรือหน้ารับเงินของวอลเล็ตเดสก์ท็อปหรือมือถือ
ขีดจำกัดอัตราการขอ
faucet ตั้งใจให้แจกน้อย พอให้การพัฒนาเดินต่อได้ แต่ไม่มากพอให้ถูกดูดจนหมด หากต้องการมากกว่าที่ระยะพักอนุญาต ให้รัน คู่มือ regtest แล้วขุดเหรียญเองได้ไม่จำกัด
| ขีดจำกัด | ค่า | รายละเอียด |
|---|---|---|
| จำนวนต่อครั้ง | 0.05 TSC | จำนวนคงที่ที่ส่งต่อคำขอที่สำเร็จหนึ่งครั้ง |
| ระยะพัก | 24 ชั่วโมง | นับต่อที่อยู่และต่อ IP ต้นทาง โดยใช้อันที่ถูกใช้ล่าสุด response 429 จะมี header Retry-After |
| เพดานรายวัน | 5 TSC | ยอดรวมที่ faucet แจกต่อวันตามเวลา UTC เมื่อถึงเพดานแล้ว คำขอจะได้รับ 429 จนถึงวันถัดไป |
| เครือข่าย | testnet เท่านั้น | ที่อยู่จะถูกตรวจกับพารามิเตอร์ของเชน testnet ดังนั้นที่อยู่ mainnet จะถูกปฏิเสธ ไม่มี faucet สำหรับ mainnet |
Response
ทุก response เป็น JSON ระยะพักจะถูกบันทึกเฉพาะเมื่อการส่งได้รับการยืนยันแล้ว ดังนั้นความล้มเหลวชั่วคราวจะไม่ทำให้คุณเสียสิทธิ์รอบนั้น
| HTTP | Body | เมื่อใด |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | broadcast เหรียญแล้ว ระยะพักเริ่มนับตั้งแต่ตอนนี้ |
400 | { "error": "Provide a valid TensorCash testnet address." } | ไม่มีที่อยู่ หรือที่อยู่มีรูปแบบไม่ถูกต้อง |
400 | { "error": "That is not a valid TensorCash testnet address." } | รูปแบบถูกต้อง แต่ใช้ไม่ได้บน testnet (เช่น ที่อยู่ mainnet) |
403 | { "error": "The faucet is available on testnet only." } | คำขอถูกระบุว่าเป็น mainnet |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | ยังอยู่ในระยะพัก 24 ชม. ของที่อยู่หรือ IP นี้ |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | ใช้เพดานรายวัน 5 TSC หมดแล้ว |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | วอลเล็ตของ faucet มียอดน้อยกว่าจำนวนต่อครั้งบวกค่าธรรมเนียม และต้องเติมเงินด้วยมือ |
สถานะ
faucet ทำงานอยู่ภายใน seed API ของ testnet หากบริการนั้นมีปัญหา คาดว่าจะได้รับ response 503 จาก faucet
ไปต่อที่ไหนดี
- คู่มือ regtestเส้นทางออฟไลน์: เชนในเครื่องของคุณเอง ได้เหรียญทันที ไม่จำกัด ไม่ต้องใช้เครือข่าย
- เอกสารอ้างอิง JSON-RPCดัชนี method ทั้งหมด รวมถึง
getnewaddressสำหรับสร้างที่อยู่ที่คุณจะเติมเงินจากที่นี่