Hallmark

From Nxtwiki
Revision as of 21:14, 23 January 2020 by Almonte (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

http://localhost:7876/nxt?
  requestType=decodeHallmark&
  hallmark=827ed8cf83bbd36419002759d960a1bec952f2209db8ed3be958...
{
 "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

http://localhost:7876/nxt?
  requestType=markHost&
  secretPhrase=IWontTellYou&
  host=iwonttellyou.com&
  weight=1&
  date=2014-11-22
{
 "hallmark": "57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c...",
 "requestProcessingTime": 5
}


Generate Hallmark

Refer to Mark Host.