Hallmark

Decode Hallmark

Decode a node hallmark.

Request:

• requestType is decodeHallmark
• hallmark is the hallmark value

Response:

• valid (B) is true if host is less than 100 characters, weight > 0 and the embedded signature is verified
• weight (N) is the weight assigned to the hallmark
• host (S) is the IP address or domain name associated with the hallmark
• account (S) is the account number associated with the hallmark
• accountRS (S) is the Reed-Solomon address of the account
• date (S) is the date the hallmark was created, in YYYY-MM-DD format
• requestProcessingTime (N) is the API request processing time (in millisec)

Decode Hallmark Example

Request

Test request

http://localhost:7876/nxt?
  requestType=decodeHallmark&
  hallmark=827ed8cf83bbd36419002759d960a1bec952f2209db8ed3be958...

Response

{
 "date": "2013-12-10",
 "valid": true,
 "accountRS": "NXT-FEJ5-H4YB-QD3D-2L3W2",
 "host": "nxttyclub.info",
 "weight": 100,
 "requestProcessingTime": 2,
 "account": "31580691533050371"
}

Mark Host

Generates a node hallmark. POST only.

Request:

• requestType is markHost
• secretPhrase is the secret passphrase for the account that will be hallmarked on the node
• host is the IP address or domain name of the node
• weight is the weight to assign to the node
• date is the current date in YYYY-MM-DD format

Note: Refer to Create Hallmark for details.

Response:

• hallmark (S) is the hallmark hex string
• requestProcessingTime (N) is the API request processing time (in millisec)

Note: Refer to Create Hallmark for instructions for applying the hallmark to a public node.

Example

Request

Test request

http://localhost:7876/nxt?
  requestType=markHost&
  secretPhrase=IWontTellYou&
  host=iwonttellyou.com&
  weight=1&
  date=2014-11-22

Response

{
 "hallmark": "57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c...",
 "requestProcessingTime": 5
}

Generate Hallmark

Refer to Mark Host.