Faucet testnet
Faucet là cửa ngõ trực tuyến để bắt đầu xây dựng trên TensorCash. Nó gửi một lượng nhỏ coin testnet tới bất kỳ địa chỉ testnet hợp lệ nào, để bạn nạp tiền cho ví, thử JSON-RPC và kiểm thử các luồng mô hình hoặc tài sản trên một chuỗi dùng chung đang chạy thật. Coin này không có giá trị. Nếu cần một sandbox hoàn toàn ngoại tuyến với coin tức thì và không giới hạn, hãy dùng Hướng dẫn regtest.
Nhận coin
Gửi POST địa chỉ testnet của bạn dưới dạng JSON. Không cần API key, không cần tài khoản. Nếu thành công, phản hồi là id của giao dịch đã phát sóng; theo dõi nó trên 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"}Chưa có địa chỉ? Bất kỳ ví TensorCash nào trên testnet cũng tạo được: gọi getnewaddress qua JSON-RPC, hoặc mở màn hình nhận tiền của ví desktop hay ví di động.
Giới hạn tần suất
Faucet được cố ý giữ nhỏ: đủ để bạn không bị kẹt khi phát triển, nhưng không đủ để bị rút cạn. Nếu cần nhiều hơn mức thời gian chờ cho phép, hãy chạy Hướng dẫn regtest và tự khai thác coin, không giới hạn.
| Giới hạn | Giá trị | Chi tiết |
|---|---|---|
| Mỗi lần nhận | 0,05 TSC | Lượng cố định được gửi cho mỗi yêu cầu thành công. |
| Thời gian chờ | 24 giờ | Tính theo địa chỉ và theo IP nguồn, lấy lần sử dụng gần nhất. Phản hồi 429 kèm header Retry-After. |
| Hạn mức mỗi ngày | 5 TSC | Tổng lượng faucet phát ra trong mỗi ngày UTC. Khi đạt mức này, các yêu cầu nhận mã 429 cho đến ngày hôm sau. |
| Mạng | Chỉ testnet | Địa chỉ được kiểm tra theo tham số chuỗi testnet, nên địa chỉ mainnet sẽ bị từ chối. Không có faucet cho mainnet. |
Phản hồi
Mọi phản hồi đều là JSON. Thời gian chờ chỉ được ghi nhận khi việc gửi đã được xác nhận, nên một lỗi tạm thời không bao giờ làm mất lượt của bạn.
| HTTP | Nội dung | Khi nào |
|---|---|---|
200 | { "txid": "…", "address": "…", "amount": "0.05" } | Coin đã được phát sóng. Thời gian chờ bắt đầu từ lúc này. |
400 | { "error": "Provide a valid TensorCash testnet address." } | Thiếu địa chỉ hoặc địa chỉ sai định dạng. |
400 | { "error": "That is not a valid TensorCash testnet address." } | Đúng định dạng nhưng không hợp lệ trên testnet (ví dụ một địa chỉ mainnet). |
403 | { "error": "The faucet is available on testnet only." } | Yêu cầu được xác định thuộc về mainnet. |
429 | { "error": "You've already used the faucet recently.", "retry_after_secs": N } | Vẫn trong thời gian chờ 24 giờ của địa chỉ hoặc IP này. |
429 | { "error": "The faucet has hit its daily limit. Try again tomorrow." } | Đã dùng hết hạn mức 5 TSC mỗi ngày. |
503 | { "error": "The faucet is temporarily empty. Please try again later." } | Ví của faucet còn ít hơn một lần nhận cộng phí. Ví được nạp lại thủ công. |
Trạng thái
Faucet chạy bên trong seed API của testnet. Nếu dịch vụ đó gặp sự cố, faucet có thể trả về phản hồi 503.
Tiếp theo
- Hướng dẫn regtestLựa chọn ngoại tuyến: chuỗi cục bộ của riêng bạn, coin tức thì, không giới hạn, không cần mạng.
- Tài liệu JSON-RPCDanh mục đầy đủ các method, bao gồm
getnewaddressđể tạo địa chỉ bạn nạp tiền tại đây.