9.2 KiB
\ValidatorAPI
All URIs are relative to https://api.hanzo.ai
| Method | HTTP request | Description |
|---|---|---|
| GetValidator | Get /v1/validator | Returns the validator slots the caller's org has claimed. |
| GetValidatorByTokenid | Get /v1/validator/{tokenId} | Returns one claimed validator slot, scoped to the caller's org. |
| GetValidatorChallenge | Get /v1/validator/challenge | Issues the single-use nonce and the exact message a wallet must sign to claim a validator slot. |
| PostValidator | Post /v1/validator | Claims a validator slot and provisions its node, after proving the caller's wallet owns the slot's NFT. |
GetValidator
ValidatorValidatorList GetValidator(ctx).Limit(limit).Execute()
Returns the validator slots the caller's org has claimed.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
limit := "limit_example" // string | Limit is how many slots to return, as a decimal string in the `?limit=` query. Absent, unparseable or non-positive means 200; over 1000 is clamped to 1000. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two. (optional)
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.ValidatorAPI.GetValidator(context.Background()).Limit(limit).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ValidatorAPI.GetValidator``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetValidator`: ValidatorValidatorList
fmt.Fprintf(os.Stdout, "Response from `ValidatorAPI.GetValidator`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiGetValidatorRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| limit | string | Limit is how many slots to return, as a decimal string in the `?limit=` query. Absent, unparseable or non-positive means 200; over 1000 is clamped to 1000. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetValidatorByTokenid
ValidatorSlotView GetValidatorByTokenid(ctx, tokenId).Execute()
Returns one claimed validator slot, scoped to the caller's org.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
tokenId := "tokenId_example" // string | TokenID is the slot's GenesisNFT token id, from the path, as a decimal string. A value that is not a positive integer is 400. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two.
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.ValidatorAPI.GetValidatorByTokenid(context.Background(), tokenId).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ValidatorAPI.GetValidatorByTokenid``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetValidatorByTokenid`: ValidatorSlotView
fmt.Fprintf(os.Stdout, "Response from `ValidatorAPI.GetValidatorByTokenid`: %v\n", resp)
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| tokenId | string | TokenID is the slot's GenesisNFT token id, from the path, as a decimal string. A value that is not a positive integer is 400. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two. |
Other Parameters
Other parameters are passed through a pointer to a apiGetValidatorByTokenidRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetValidatorChallenge
ValidatorChallengeView GetValidatorChallenge(ctx).TokenId(tokenId).Execute()
Issues the single-use nonce and the exact message a wallet must sign to claim a validator slot.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
tokenId := "tokenId_example" // string | TokenID is the Validator-tier GenesisNFT token id, as a decimal string in the `?tokenId=` query. A value that is not a positive integer is 400. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two. (optional)
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.ValidatorAPI.GetValidatorChallenge(context.Background()).TokenId(tokenId).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ValidatorAPI.GetValidatorChallenge``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetValidatorChallenge`: ValidatorChallengeView
fmt.Fprintf(os.Stdout, "Response from `ValidatorAPI.GetValidatorChallenge`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiGetValidatorChallengeRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| tokenId | string | TokenID is the Validator-tier GenesisNFT token id, as a decimal string in the `?tokenId=` query. A value that is not a positive integer is 400. It is a string rather than a number because the parse that has always served this route trims surrounding whitespace, and one parse rule is better than two. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostValidator
ValidatorSlotView PostValidator(ctx).ValidatorValidatorClaim(validatorValidatorClaim).Execute()
Claims a validator slot and provisions its node, after proving the caller's wallet owns the slot's NFT.
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
validatorValidatorClaim := *openapiclient.NewValidatorValidatorClaim() // ValidatorValidatorClaim |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
resp, r, err := apiClient.ValidatorAPI.PostValidator(context.Background()).ValidatorValidatorClaim(validatorValidatorClaim).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `ValidatorAPI.PostValidator``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `PostValidator`: ValidatorSlotView
fmt.Fprintf(os.Stdout, "Response from `ValidatorAPI.PostValidator`: %v\n", resp)
}
Path Parameters
Other Parameters
Other parameters are passed through a pointer to a apiPostValidatorRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|---|---|---|
| validatorValidatorClaim | ValidatorValidatorClaim |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json, application/problem+json
[Back to top] [Back to API list] [Back to Model list] [Back to README]