測試網水龍頭

水龍頭是在 TensorCash 上開發的線上入口。它會將少量測試網代幣發送到任何有效的測試網地址，讓你為錢包注資、測試 JSON-RPC，並在一條共用的線上鏈上測試模型或資產流程。這些代幣沒有任何價值。若需要完全離線、可即時取得無限代幣的沙盒，請改看Regtest 指南。

僅限測試網 · 每次請求 0.05 TSC · 冷卻 24 小時

領取測試幣

以 JSON 格式 POST 你的測試網地址。不需要 API 金鑰，也不需要帳號。成功時，回應內容是已廣播的交易 ID；可在測試網區塊瀏覽器上追蹤。

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 錢包都能產生一個：透過 JSON-RPC 呼叫 getnewaddress，或使用桌面版或行動版錢包的收款畫面。

速率限制

水龍頭刻意設計得很小：足以讓開發順利進行，但不足以被掏空。如果你需要的量超過冷卻時間所允許的，請依照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 }`	此地址或 IP 仍在 24 小時冷卻時間內。
`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." }`	水龍頭錢包的餘額不足一次發放量加上手續費，需由人工補充。

狀態

水龍頭在測試網 seed API 內執行。若該服務效能降低，水龍頭可能會回傳 503。

下一步

Regtest 指南離線方案：在本機執行你自己的鏈，代幣即時取得、沒有限制，也不需要連網。
JSON-RPC 參考完整的方法索引，包括用來建立你在這裡注資之地址的 getnewaddress。