ברז testnet
הברז (faucet) הוא נקודת הכניסה המקוונת לפיתוח על TensorCash. הוא שולח כמות קטנה של מטבעות testnet לכל כתובת testnet תקינה, כך שאפשר לממן ארנק, להתנסות ב-JSON-RPC ולבדוק תהליכי מודלים או נכסים מול שרשרת חיה ומשותפת. למטבעות אין ערך. לסביבת ניסוי לא מקוונת לחלוטין, עם מטבעות מיידיים וללא הגבלה, ראו את מדריך regtest.
קבלת מטבעות
שלחו בבקשת POST את כתובת ה-testnet שלכם כ-JSON. בלי מפתח API ובלי חשבון. אם הבקשה מצליחה, התגובה היא מזהה הטרנזקציה ששודרה; אפשר לעקוב אחריה בסייר ה-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, או מסך הקבלה בארנק השולחני או בארנק לנייד.
מגבלות קצב
הברז קטן בכוונה: מספיק כדי לשחרר חסימות בפיתוח, לא מספיק כדי לרוקן אותו. אם צריך יותר ממה שזמן ההמתנה מאפשר, עברו למדריך regtest וכרו מטבעות משלכם ללא הגבלה.
| מגבלה | ערך | פרטים |
|---|---|---|
| מנה | 0.05 TSC | הסכום הקבוע שנשלח בכל בקשה מוצלחת. |
| זמן המתנה | 24 שעות | לכל כתובת ולכל כתובת IP מקור, לפי מה שנעשה בו שימוש מאוחר יותר. תגובת 429 כוללת כותרת Retry-After. |
| תקרה יומית | 5 TSC | הסכום הכולל שהברז מחלק בכל יום UTC. אחרי שמגיעים לתקרה, בקשות מקבלות 429 עד היום הבא. |
| רשת | testnet בלבד | הכתובת נבדקת מול הפרמטרים של שרשרת ה-testnet, ולכן כתובת mainnet נדחית. אין ברז ל-mainnet. |
תגובות
כל תגובה היא JSON. זמן ההמתנה נרשם רק אחרי שליחה מאושרת, כך שכשל זמני אף פעם לא מנצל את התור שלכם.
| HTTP | גוף | מתי |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | המטבעות שודרו. זמן ההמתנה מתחיל עכשיו. |
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." } | בארנק הברז יש פחות ממנה אחת בתוספת עמלה. הוא ממולא מחדש ידנית. |
סטטוס
הברז רץ בתוך ה-API של שרת ה-seed של ה-testnet. אם השירות הזה פועל באופן חלקי, צפו לתגובות 503 מהברז.
לאן עכשיו
- מדריך regtestהמסלול הלא מקוון: שרשרת מקומית משלכם, מטבעות מיידיים, בלי מגבלות ובלי צורך ברשת.
- תיעוד JSON-RPCאינדקס המתודות המלא, כולל
getnewaddressליצירת הכתובת שאותה מממנים כאן.