Norsh
Home
NTPNCLAPI
Home
NTPNCLAPI
  1. Modules
  • Norsh
    • Usage Guide
      • Identity in the Norsh Ecosystem
      • UCP Message Structure (Standard Request Format)
    • API
      • UCP Error Codes
      • Keys Identity
        • Generates a public and private key pair
      • Address
        • Register Address
        • Get Address
        • Enable TOTP
        • Disable TOTP
        • Enable Secret-Based Authentication
        • Disable Secret-Based Authentication
        • Revoke Address
      • Modules
        • Get Module
          POST
        • Create Notary
          POST
      • Statements
        • Get Statement
        • Create Notary Statement
      • BigLedger
        • Get BigLedger Statement
      • Tartarus
        • Get Tartarus Statement
      • Envelopes
        • Get Envelope
  • NTP - Norsh Technical Paper
    • 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
    • NTP-11: Universal Blockchain Protocol (UBP)
    • NTP-12: Sharded Certificate Storage for the Norsh Ecosystem
  • 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
  • Compliance
    • Terms of Use
    • Privacy Policy
    • Norsh Brand and Trademark Usage Guidelines
    • AI Content Notice
    • Credits
    • Partners
    • Legal Templates
      • Policy on Public Disclosure of Legal Templates
      • NDA - Template
      • Service Agreement - Template
  • Resources
    • Norsh Brand Guidelines
    • Academy
      • Exam Program
  • Service Operations
    • Service Level Agreement (SLA)
    • Scheduled Maintenance Notice
    • Incident Reports
  • Schemas
    • Key & Address
      • Key.Generate
      • Address.Register
      • Address.Revoke
      • Address.TOTP.Enable
      • Address.TOTP.Disable
      • Address.Secret.Enable
      • Address.Secret.Disable
    • Modules
      • Module.Notary.Create
      • Module.Meter.Create
    • Ucp Response
    • Ucp PublicKey
    • Ucp Parameters
    • Ucp Header
    • Ucp Ghost
Home
NTPNCLAPI
Home
NTPNCLAPI
  1. Modules

Create Notary

POST
https://sandbox.norsh.org/{network}/v1/ucp
Last modified:2025-11-01 20:32:14
This endpoint creates a new Notary Module within the Norsh ecosystem, in compliance with the technical standard defined in NTP-X: Notary Module Specification.
A Notary Module is a specialized module responsible for notarizing and anchoring statements, assets, or events on-chain, following strict naming and structure rules as described in the official NTP-X specification.
Request:
This endpoint uses the UCP standard request format.
In addition to the standard fields, specify the following for this operation:
command: Set to module.notary.create
parameters (object, required):
commonName (string, required): Full name of the notary element. Must be 2–64 characters long, with up to 5 segments separated by dots. Each segment must have 2–12 characters (only A–Z, 0–9, and _), start and end with a letter or number, must include at least one letter, and cannot contain consecutive underscores (__) or 4 or more identical characters in a row.
Response:
A response object containing result (with the created module’s identifiers, type, owner, name, status, timestamps).

Request

Path Params

Body Params application/vnd.ucp+json

Examples

Responses

🟢200Success
application/vnd.ucp+json
Body

🟢207Multi-Status
🟠422Unprocessable Entity
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.norsh.org//v1/ucp' \
--header 'Content-Type: application/vnd.ucp+json' \
--data-raw '[
    {
        "command": "module.notary.create",
        "version": 1,
        "parameters": {
            "name": "NAME"
        },
        "publicKey": "MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEoVOBV/Ji7NfdOA8RAqpvqLQ7qnzuUHESOL/6Oosdg4/un0+YU+7QVX5L3sjXbbxYLQeYa4XPI7n5pKKOxNn2Qu7rsvY+CkHXW+lxzGKen9JA4EfnlWteM5KI3JYvH/Pj",
        "signature": "MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEoVOBV/Ji7NfdOA8RAqpvqLQ7qnzuUHESOL/6Oosdg4/un0+YU+7QVX5L3sjXbbxYLQeYa4XPI7n5pKKOxNn2Qu7rsvY+CkHXW+lxzGKen9JA4EfnlWteM5KI3JYvH/Pj"
    }
]'
Response Response Example
200 - Success
[
    {
        "command": "module.notary.create",
        "version": 1,
        "status": 200,
        "timestamp": "2025-09-24T08:44:31.614Z",
        "success": true,
        "result": {
            "id": "7752b576-4c46-4d9a-a82a-3b920987b177",
            "type": "NOTARY",
            "owner": "28b16aeb14c96264d19244f7e54ec21a1006d03ea9d89d0ec99372476d6e769410c8f9c0f67e074e5c974f66c8c7ddd3",
            "name": "NAME",
            "status": "ENABLED",
            "createdAt": 1758703471614,
            "updatedAt": 1758703471614
        },
        "tail": {
            "ledger": "bigledger",
            "statement": "d19460e554c03a90d06d6d0bb3cb2b6393e06a57f4e88943125b54be073c3a017577224cfd2536fee250fbf9a9186842",
            "envelope": "26b2265ba012a6615d8dd27aa590bfd1dc8ebb57ebfde38b06a974a877ba6ada6e97a31afa06b3071af3e8f36a46183f",
            "duration": 31
        }
    }
]
Modified at 2025-11-01 20:32:14
Previous
Get Module
Next
Get Statement
Built with