system.v1.SystemService

GetVersion

Get the version and source revision of the build the environment serves. This public read supports cacheable ConnectRPC GET.

Method

POST

Path

system.v1.SystemService/GetVersion

Service

system.v1.SystemService

Visibility

Public endpoint

POST

system.v1.SystemService/GetVersion

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/system.v1.SystemService/GetVersion' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{}'

Responses

{
  "commit": "4e21a2f0967068fc944f5229eead01985df301b9",
  "environment": "testnet",
  "version": "0.10.0"
}

Request

system.v1.GetVersionRequest

Response

system.v1.GetVersionResponse

version string /^(0|[1…12})?$/

Version of the exact build. A release reports its version in MAJOR.MINOR.PATCH form, such as "0.10.0". A build made after a release appends the number of source revisions since that release and "g" with the first 12 hexadecimal digits of its own revision, such as "0.10.0-12-g4e21a2f09670": 12 revisions after release 0.10.0. Releases before mainnet are 0.MINOR.PATCH; mainnet starts at 1.0.0.

commit string /^[0-9a-f]{40}$/

Full 40-character lowercase hexadecimal source revision of the build.

environment string

Environment that answered: "devnet", "testnet" or "mainnet", or "local" for a development stack.

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.