Developer Center

Developer Center

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

›Built-in Features

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

Multisig Account

Editable on-chain contracts, the most powerful way to secure funds and enable joint accounts.

Cosignatories

A Sirius Chain account can be converted to multisig. The cosignatories - other accounts - of the multisig will become the account managers.

From that moment on, the multisig account cannot announce transactions by itself. A multisig cosignatory has to propose a transaction involving the multisig, wrapping it in an aggregate transaction.

To record the transaction in the block, the other cosignatories will have to agree.

Minimum approval and removal

It is not always necessary to force all cosignatories to cosign transactions associated with the multisig account. With Sirius Chain, setting up the minimum number of cosignatory agreements is allowed. These properties can also be edited afterward to suit almost all needs.

Sirius Chain’s current implementation of multisig is “M-of-N”. This means that M can be any number equal to or less than N, i.e., 1-of-4, 2-of-2, 4-of-9, 9-of-10 and so on.

Similarly, cosignatories can invite other accounts to take part in the multisig, or propose to remove others when the defined conditions are fulfilled.

Note:

Multisig accounts are a powerful tool, but please use this tool with caution. If the cosignatories' keys get lost and minimum approval is not reached, it would result in the permanent loss of access to the funds held by the multisig account. Choose wisely minimum removal parameter to avoid this situation.

Constraints

  • Multisig accounts can have up to 10 cosignatories.
  • An account can be cosigner of up to 5 multisig accounts.
  • Multisig accounts can have as a cosigner another multisig, up to 3 levels. Multi-level multisig accounts add “AND/OR” logic to multi-signature transactions.
  • Multisig modification transactions must be wrapped in an aggregate transaction. New cosignatories added to the multisig must opt-in by cosigning the aggregate.

Examples of Using Multisig Accounts

There is a broad range of useful applications for multisig accounts. Let’s take a look at some of the most common use cases.

Shared accounts

Several families are members of the local philatelist society and use a shared account to buy stamps.

To ensure that all agree on which educational material they should buy and at the right price, they use a multisig account. This way, all members need to approve the transaction before it is included in the blockchain.

Multisig 2-of-3

M-of-N multisig account

Multi-factor authorization

Alice wants to make sure her funds are not totally compromised. Therefore, she sets up a multisig account with her funds and attaches two accounts called "signer accounts" to control her multisig account as a form of two-factor authentication.

Both of her "signer accounts" need to approve the transaction, and her signer accounts are located on different computer platforms with different passwords. This means that when a hacker or computer virus compromise one of her accounts, the funds will be kept secure.

Multisig multifactor auth

Multi-factor authorisation using multisig accounts

Example of Assets Ownership

Multisig accounts can be used to represent the ownership of assets.

A company could create a 1-of-1 multisig account for each of their products, adding themselves as the cosignatory. When the company sells the product to Alice, she becomes the owner through the action of being added as the cosigner, and the company is removed in the same transaction.

Multisig asset ownership

Transferring an account

Manufacturing and supply chains

A manufacturer delivers a a pharmaceutical product by freight.

The product receives its quality approval mosaic only when its blockchain record shows it has a production date, safety inspection date, and shipping condition at the correct temperature.

Sensors in the shipping container report the temperature data every five minutes and consolidate them into a daily report.

Multi-level supply chain

Manufacturing and Supply Chains

Example of Fraud Detection

Transactions are only approved from a hardware wallet or your phone and a fraud detection artificial intelligence (AI) system. Multi-level multisig account or MLMA allows a variety of security configurations at the protocol level to keep businesses and their customers free from hackers.

Multi-level fraud detection

Fraud Detection

Guides for Using Multisig Accounts

  • Signing announced aggregate bonded transactions

    What to do when all required consigners have not signed the aggregate bonded transaction.

  • Converting an account to multisig

    How to create a one-of-two multisig account adding two co-signatories.

  • Modifying a multisig account

    How to modify an existing multisig account.

  • Creating a multi-level multisig account (MLMA)

    How to create a multi-level multisig account.

  • Sending a multisig transaction

    How to send a transaction involving a multisig. How an aggregate bonded transaction works.

Schemas

Note:

Configuration parameters are editable . Public network configuration may differ.

Modify Multisig Transaction

Ways of how announcing a modify multisig account transaction to:

  1. Transform an account to multisig.

  2. Change the configurable properties of a multisig account.

Version: 0x03

Entity type: 0x4155

Inlines:

  • Transaction or EmbeddedTransaction
PropertyTypeDescription
minRemovalDeltaint8The number of signatures needed to remove a cosignatory. If we are modifying an existing multisig account, this indicates the relative change of the minimum cosignatories.
minApprovalDeltaint8The number of signatures needed to approve a transaction. If we are modifying an existing multisig account, this indicates the relative change of the minimum cosignatories.
modificationsCountuint8The number of modifications.
modificationarray(CosignatoryModification, modificationsCount)The array of cosignatory accounts to add or delete.

CosignatoryModification

PropertyTypeDescription
modificationTypeCosignatoryModificationTypeThe cosignatory modification type.
cosignatoryPublicKey32 bytes (binary)The public key of the cosignatory.

CosignatoryModificationType

Enumeration: uint8

IdDescription
0Add cosignatory.
1Remove cosignatory.
← Aggregate TransactionMetadata →
  • Cosignatories
  • Minimum approval and removal
  • Constraints
  • Examples of Using Multisig Accounts
  • Shared accounts
  • Multi-factor authorization
  • Example of Assets Ownership
  • Manufacturing and supply chains
  • Example of Fraud Detection
  • Guides for Using Multisig Accounts
  • Schemas
    • Modify Multisig Transaction
    • CosignatoryModification
    • CosignatoryModificationType
  • 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