Announcement: deprecating faucet v1 API

[stefan-mysten]

The Faucet v1 API will be deprecated April 18, and replaced with Faucet v2 API.

• If you used /v1/gas → use v2/gas — note that the server response has changed
• If you used /gas → use v2/gas — note that the server response has changed
• If you used /v1/status → nothing to replace it. The /v2/gas will give you directly a success/failure response.

The new server response is:
Success

{
 "status":"Success",
 "coin_sent": {
   "amount":5500000000,
   "id":"0xac8b8afbc9074465bf799d0f590e17176b7a05514b9434b338e38f49be14d574",
   "transferTxDigest":"DSHGocWx57BtYDE5Xv4AefeRBBMizPb3LTqRMegx14Ym"
  }
}

Failure

{
 "status":{
   "Failure": {
     "ErrorType": "message"
	 }
 },
 "coin_sent": null
}

where ErrorType is Internal | InvalidUserAgent | TooManyRequests | MissingTurnstileTokenHeader

The response status codes are:
Success --> 200 OK
Internal --> 500 error code
InvalidUserAgent | MissingTurnstileTokenHeader --> 400 error code
TooManyRequest --> 429 error code

[github-actions]

Thank you for opening this issue, a team member will review it shortly. Until then, please do not interact with any users that claim to be from Sui support and do not click on any links!