Norsh
HomeNTPNCLAPI
HomeNTPNCLAPI
  1. Crypto
  • Norsh
    • Usage Guide
      • Cryptographic Identity
    • API
      • Crypto
        • Generates a public and private key pair
          GET
        • Generates an address from a public key.
          POST
  • NTP - Norsh Technical Paper
    • LICENSE-NCL-11
    • Published
      • NTP-1: Norsh Technical Paper Specification
      • NTP-2: Standards for Encoding, Time and Localization
      • NTP-3: Cryptography and Hash Specification
      • NTP-4: Interchangeable Data Standard
      • NTP-5: Temporal Time-Step Model
      • NTP-6: Modular Prime Fragmentation
      • NTP-7: The End of Mining - PoW
      • NTP-8: The Fallacy of Stake - PoS
      • NTP-9: The Myth of Absolute Non-Censorship
      • NTP-10: Structural Failures of Decentralization
  • NCL - Norsh Commons License
    • NCL-0: Norsh Commons License
    • NCL-1: Attribution Requirement
    • NCL-2: Restricted Commercialization
    • NCL-4: Commercialization with Agreement or Royalties
    • NCL-8: Educational Use Permission
    • NCL-16: Complementary Use and Integration Permission
    • NCL-32: Pre-Approval for Application Publication
    • NCL-64: Restricted or Authorized Derivatives
    • NCL-128: Contribution Terms
  1. Crypto

Generates an address from a public key.

POST
https://sandnet.norsh.org/v1/crypto/address
API
Last modified:2025-06-05 20:32:30
This API generates a unique cryptographic address derived from a provided public key. The address is calculated using the SHA3-256 hashing algorithm and can be used as an identifier within the Norsh ecosystem.
For full cryptographic specifications and compliance requirements, refer to NTP-3: Cryptography and Hash Specification.

Request Format#

Content-Type: application/json
Body Parameters:
{
  "publicKey": "BASE64_OR_HEX_ENCODED_PUBLIC_KEY"
}
publicKey (string, required): The public key in Base64 or Hexadecimal format.

Response Format#

Success Response (200 OK):
{
  "address": "GENERATED_CRYPTOGRAPHIC_ADDRESS"
}
address (string): The SHA3-256 hashed address derived from the public key.
Error Response (400 Bad Request):
{
  "error": true,
  "message": "Invalid request: publicKey cannot be null or empty.",
  "timestamp": 1737059076672
}
Error Response (500 Internal Server Error):
{
  "error": true,
  "message": "An unexpected error occurred while processing the request.",
  "timestamp": 1737059076672
}

Notes#

The input publicKey must be properly formatted in Base64 or Hexadecimal encoding.
If the provided key is invalid or empty, the API will return a 400 Bad Request error.
Any unexpected server issues will return a 500 Internal Server Error response.

How This API Works#

1.
The API receives a publicKey in Base64 or Hexadecimal format.
2.
It converts the key into bytes.
3.
It computes the SHA3-256 hash of the public key.
4.
The hashed result is returned as a unique cryptographic address.
This address can be used as a unique identifier in transactions, smart elements, or other blockchain operations within the Norsh ecosystem.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandnet.norsh.org/v1/crypto/address' \
--header 'Content-Type: application/json' \
--data-raw '{
    "publicKey": "MFYwEAYHKoZIzj0CAQYFK4EEAAoDQgAEP+GH+0DkcMkgNvypFvXPIAJWdJaZgLICsZ6xqQUdyb6jyFmg9rZnepZlPyodeS26r1MKJ8qFcJ47l29DNaeZ9Q=="
}'
Response Response Example
200 - Success
{
    "address": "cea7299a2d1263598e2255f7363f711d63ec2b6ce7b5d3daed0b573b580ba954"
}

Request

Body Params application/json
publicKey
string 
required
The public key of the sender, used to verify the signature. Must be provided in either Base64 or Hexadecimal format.
Example:
QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Examples

Responses

🟢200Success
application/json
Body
address
string 
required
The address is derived using a SHA3-256 hash of the public key in either Base64 or Hexadecimal format.
Example:
efde19a53da392f36c80a3ff4c3676c81f9a37fce7b019ee08e693727620c93f
🟠400Bad Request
Modified at 2025-06-05 20:32:30
Previous
Generates a public and private key pair
Next
LICENSE-NCL-11
Built with