测试网水龙头

水龙头是在 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." }`	水龙头钱包的余额不足一次发放额加手续费，需人工补充。

状态

水龙头运行在测试网种子 API 内。如果该服务性能下降，水龙头可能会返回 503 响应。

接下来

Regtest 指南离线路径：你自己的本地链，代币即时到账，不限量，无需联网。
JSON-RPC 参考完整的方法索引，包括用于创建在此领取代币的地址的 getnewaddress。