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.