Developer Center

Developer Center

  • Getting Started
  • Built-in Features
  • REST API Endpoints
  • Guides
  • Cheat Sheet

›Protocol

Getting Started

  • What is Sirius Chain
  • Setting up your workstation
  • Writing your first application

Built-in Features

  • Account
  • Mosaic (SDA)
  • Namespace
  • Transfer Transaction
  • Aggregate Transaction
  • Multisig Account
  • Metadata
  • Account Restriction
  • Cross-Chain Swaps
  • Exchange Market
  • Decentralized Exchange Market
  • Liquidity Provider
  • Storage

Protocol

  • Node
  • Block
  • Cryptography
  • Transaction
  • Validating
  • Consensus Algorithms
  • Receipt
  • Inflation

REST API

  • Overview
  • Tools
  • Serialization
  • Websockets
  • Status Errors

SDKs

  • Overview
  • Architecture
  • Languages
  • Extending Sirius Chain Capabilities
  • SDK Development
  • SDK Documentation

Wallets & Explorers

  • Wallets & Explorers

Cheat Sheet

  • Sirius Chain Cheat Sheet

Guides

  • Overview
  • External Guides
  • Account

    • Creating and opening an account
    • Getting account information
    • Getting the amount of XPX sent to an account
    • Reading transactions from an account

    Account Restriction

    • Preventing spam attacks with account restrictions

    Aggregate Transaction

    • Sending payouts with aggregate-complete transaction
    • Creating an escrow with aggregate bonded transaction
    • Asking for mosaics with aggregate-bonded transaction
    • Signing announced aggregate-bonded transactions

    Block

    • Listening to New Blocks
    • Getting block by height

    Cross Chain Swaps

    • Atomic cross-chain swap between Sirius public and private chains

    Metadata

    • Account Metadata
    • Mosaic Metadata
    • Namespace Metadata
    • Account Metadata (Deprecated since 0.7.0 Sirius Chain release)
    • Mosaic Metadata (Deprecated since 0.7.0 Sirius Chain release)
    • Namespace Metadata (Deprecated since 0.7.0 Sirius Chain release)

    Monitoring

    • Monitor transaction

    Mosaic

    • Creating a mosaic (SDA)
    • Getting the mosaic information
    • Getting the asset identifier behind a namespace with receipts

    Mosaic Levy

    • Modifying Mosaic Supply

    Multisig Account

    • Converting an account to multisig
    • Modifying a multisig account
    • Creating a multi-level multisig-account
    • Sending a multisig transaction

    Namespace

    • Registering a namespace
    • Registering a subnamespace
    • Getting the Namespace information
    • Linking a namespace to a mosaic
    • Linking namespace to account

    Transfer Transaction

    • Transfer transaction
    • Sending an encrypted message

    Storage

    • Data Modification Cancel
    • Data Modification
    • Download Channel
    • Download Payment
    • Drive Closure
    • Finish Download Channel
    • Prepare Bc Drive
    • Replicator Offboarding
    • Replicator Onboarding
    • Storage Payment
    • Verification Payment

Storage

  • Overview
  • Participate
  • External Economy
  • Roles
  • Verification
  • Challenge
  • Rewards
  • Transaction Schemas
  • Built-In Features

    • Drive
    • Replicator
    • Verifier
    • Supercontracts

    Protocols

    • Cross-Block Protocol
    • Fair Streaming

    Storage User Application

    • Overview
    • Getting Started
    • Managing Drives
    • Managing Drive Files
    • Downloading Data

Block

The central element of every cryptocurrency is a public ledger called the blockchain, which links blocks together.

Since the blocks in the chain are ordered, the complete transaction history is held in the blockchain. Subsequent blocks in the blockchain have increased heights that differ by one.

Blocks are stored in a database as a permanent medium. Sirius Chain calls the first block in the chain the nemesis block.

Sirius Chain blocks complete every 15 seconds, making transactions confirm quickly enough for everyday use.

Note:

Configuration parameters are editable. Public network configuration may differ.

Block creation

Blocks are created by accounts. The process of creating new blocks is called validating. The validating account - called the validator - gets the fees for the transactions in the block and inflation. This gives the validator an incentive to add as many transactions to the block as possible.

Guides

  • Listening to new blocks

    Get notified when a new block is included.

  • Getting block by height

    Get the block information given a height.

Schemas

BlockHeader

Inlines:

  • VerifiableEntity
  • EntityBody
PropertyTypeDescription
heightuint64The height of the blockchain. Each blockchain has a unique height. Subsequent blocks differ in height by 1.
timestampuint64The number of seconds elapsed since the creation of the nemesis block.
difficultyuint64The block difficulty.
feeMultiplieruint32The fee multiplier applied to transactions contained in block.
previousBlockHash32 bytes (binary)The hash of the previous block.
blockTransactionHash32 bytes (binary)The transactions included in a block are hashed forming a merkle tree. The root of the tree summarizes them.
blockReceiptsHash32 bytes (binary)The collection of receipts are hashed into a merkle tree and linked to a block. The block header stores the root hash.
stateHash32 bytes (binary)The state of the blockchain is stored in RocksDB for each block, forming a patricia tree. The root of the tree summarizes the state of the blockchain for a given block.
beneficiaryPublicKey32 bytes (binary)The public key of the optional beneficiary designated by validator.
feeInterestuint32The part of the transaction fee validator is willing to get. From 0 up to feeInterestDenominator. The customer gets (feeInterest / feeInterestDenominator)'th part of the maximum transaction fee.
feeInterestDenominatoruint32Denominator of the transaction fee.

Version: The higher byte represents the network identifier.

IdDescription
0xB8 (MAIN_NET)Public main network
0xA8 (TEST_NET)Public test network
0xC8 (PRIVATE)Private network
0xB0 (PRIVATE_TEST)Private test network

Type: The type of the block.

IdDescription
0x8043Nemesis block
0x8143Block

VerifiableEntity

PropertyTypeDescription
signature64 bytes (binary)The entity signature generated by the signer.

EntityBody

PropertyTypeDescription
signer32 bytes (binary)The entity signer’s public key.
versionuint16The version of the structure.
typeuint16The entity type. For transaction types, see transaction types.
← NodeCryptography →
  • Block creation
  • Guides
  • Schemas
    • BlockHeader
    • VerifiableEntity
    • EntityBody
  • Follow our profile
  • Ask development questions
  • Join our Discord channel
  • Explore our Youtube channel
  • Explore Github
Protocol
BlockConsensus AlgorithmsCryptographyInflationNodeReceiptTransactionValidating
Built-in Features
AccountAggregate TransactionCross-Chain SwapsExchange MarketDecentralized Exchange MarketMetadataMosaicMultisig AccountNamespaceTransfer TransactionStorageLiquidity Provider
References
REST APISDKsCheat Sheet
Includes Documentation Forked from NEM
Copyright © 2025 Sirius Chain