Links

Hallmark Operations

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)
Example: Refer to Decode Hallmark example.

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: Refer to Mark Host example.

Generate Hallmark

Refer to Mark Host.