فاست تست‌نت

فاست، راه ورود آنلاین برای ساختن روی TensorCash است. مقدار کمی سکهٔ تست‌نت به هر آدرس معتبر تست‌نت می‌فرستد تا بتوانید یک کیف پول را شارژ کنید، JSON-RPC را امتحان کنید و جریان‌های مدل یا دارایی را روی یک زنجیرهٔ زنده و مشترک آزمایش کنید. این سکه‌ها هیچ ارزشی ندارند. برای یک محیط آزمایشی کاملاً آفلاین با سکه‌های فوری و نامحدود، به‌جای آن از راهنمایِ regtest استفاده کنید.

فقط تست‌نت · 0.05 TSC به ازای هر درخواست · فاصلهٔ انتظار 24 ساعته

دریافت سکه

آدرس تست‌نت خود را به‌صورت JSON با POST ارسال کنید. بدون کلید API، بدون حساب کاربری. در صورت موفقیت، پاسخ شناسهٔ تراکنش پخش‌شده است؛ آن را در اکسپلورر تست‌نت دنبال کنید.

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 روی تست‌نت یک آدرس به شما می‌دهد: getnewaddress از طریق JSON-RPC، یا صفحهٔ دریافت در کیف پول دسکتاپ یا موبایل.

محدودیت‌های نرخ

فاست عمداً کوچک است: به اندازه‌ای که کار توسعه را راه بیندازد، نه آن‌قدر که بشود خالی‌اش کرد. اگر بیش از آنچه فاصلهٔ انتظار اجازه می‌دهد نیاز دارید، راهنمایِ regtest را اجرا کنید و بدون هیچ محدودیتی سکه‌های خودتان را ماین کنید.

محدودیت	مقدار	جزئیات
مقدار هر ارسال	0.05 TSC	مقدار ثابتی که به ازای هر درخواست موفق ارسال می‌شود.
فاصلهٔ انتظار	24 ساعت	به ازای هر آدرس و هر IP مبدأ، هر کدام که اخیراً استفاده شده باشد. پاسخ 429 یک هدر Retry-After دارد.
سقف روزانه	5 TSC	مجموع مقداری که فاست در هر روز UTC توزیع می‌کند. پس از رسیدن به آن، درخواست‌ها تا روز بعد پاسخ 429 می‌گیرند.
شبکه	فقط تست‌نت	آدرس با پارامترهای زنجیرهٔ تست‌نت بررسی می‌شود، بنابراین آدرس مین‌نت رد می‌شود. فاستی برای مین‌نت وجود ندارد.

پاسخ‌ها

همهٔ پاسخ‌ها 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." }`	قالب درست است، اما روی تست‌نت معتبر نیست (برای مثال، یک آدرس مین‌نت).
`403`	`{ "error": "The faucet is available on testnet only." }`	مقصد درخواست، مین‌نت تشخیص داده شد.
`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) تست‌نت اجرا می‌شود. اگر آن سرویس دچار اختلال باشد، از فاست انتظار پاسخ‌های 503 داشته باشید.

قدم بعدی

راهنمایِ regtestمسیر آفلاین: زنجیرهٔ محلی خودتان، سکه‌های فوری، بدون محدودیت، بدون نیاز به شبکه.
مرجعِ JSON-RPCفهرست کامل متدها، از جمله getnewaddress برای ساختن آدرسی که این‌جا شارژش می‌کنید.