Authentication
After understanding the Address Proving flow, the next step is to authenticate your requests.
Address Proving uses a dedicated token in the X-Authorization header.
This token is different from the Bearer Token or App Token used in other GTR APIs.
How to Obtain Token
Please contact your GTR Account Manager to obtain your Address Proving token (YOUR_ADDRESS_PROVING_TOKEN) and the $BASE_URL.
How to Use Token
Send the token in the X-Authorization header.
curl --silent --location --request GET "$BASE_URL/ext/api/cosmos/v1/address/proof/generate" \
--header 'Content-Type: application/json' \
--header 'X-Authorization: [YOUR_ADDRESS_PROVING_TOKEN]'
| Header | Description |
|---|---|
X-Authorization | Address Proving token issued through the GTR Dashboard |
Authentication Scope
This token is intended for the Address Proving endpoints only.
Authentication Errors
| verifyStatus | HTTP Status | verifyMessage | Cause | Action |
|---|---|---|---|---|
100001 | 200 | unauthorized | The X-Authorization header is missing or the token is invalid | Check that you are sending the correct token from the GTR Dashboard |
100001 | 200 | missing request body, have to check all the required parameters? | The API call requires a JSON body but the request body is missing | Send a valid JSON request body |
100001 | 200 | wrong json request body format, please check if theres any additional , in the tail of key:value, the last key-value should not have , concat at the tail | The JSON body is malformed | Fix the JSON syntax and try again |
Notes
- The exact dashboard path for this feature will be shown in your Dashboard when the feature is available to your account.
- If you cannot find the Address Proving entry in the Dashboard, please contact GTR support.