テストネット・フォーセット

フォーセットは、TensorCash で開発を始めるためのオンラインの入り口です。有効なテストネットアドレスであればどれにでも少額のテストネットコインを送るので、ウォレットに資金を入れ、JSON-RPC を試し、稼働中の共有チェーン上でモデルや資産のフローをテストできます。このコインに価値はありません。コインを即座に無制限に使える完全オフラインのサンドボックスが必要なら、代わりに Regtest ガイドの手順を使ってください。

テストネットのみ · 1 リクエストあたり 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 ヘッダーが付きます。
1 日の上限	5 TSC	フォーセットが UTC の 1 日あたりに配布する総量です。上限に達すると、翌日まではリクエストに 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." }`	1 日の上限である 5 TSC に達しています。
`503`	`{ "error": "The faucet is temporarily empty. Please try again later." }`	フォーセットのウォレット残高が、1 回分の配布量と手数料の合計を下回っています。補充は手動で行われます。

ステータス

フォーセットはテストネットのシード API の中で動いています。そのサービスが不安定なときは、フォーセットから 503 が返ることがあります。

次に読む

Regtest ガイドオフラインで進める方法。自分専用のローカルチェーンで、コインは即座に手に入り、制限もネットワークも不要です。
JSON-RPC リファレンス全メソッドの索引。ここで資金を受け取るアドレスを作成する getnewaddress も含まれます。