Edit this page

Getting started as a Supplier

Updated on 08-02-2018

Who is SONM Supplier

Supplier is SONM user, that is the resourse owner. Suppliers can earn tokens by selling computing power peer-to-peer to Consumers and perform thier calculations.

Every Supplier should have his own Ethereum account, that is his unique identifier.

Main algorithm of using SONM for Supplier is:

  • Download and configure SONM components
  • Compose resource slots for rent
  • Place orders to the Marketplace
  • Monitor deals
  • Get income. All resources are bought out on the market at the best price

About application

As a Supplier you will use the following SONM components:

In this MVP release SONM Supplier may use only Lunix operation system for Hub node and Worker node. Also Supplier must have public IP-address for Hub PC.

NOTE: To start using SONM you need to have an account on Rinkeby blockchain. The keystore file to access your Rinkeby accout must be in UTC/JSON format. You may generate a new Ethereum key with SONM Wallet or CLI. Then you have to get test Ether on Rinkeby blockchain.

Install components

To install Hub node, Client node, CLI, Worker node follow the installation instructions.

To install SONM Wallet follow the SONM Wallet guide.

After that you will be able to interact with the SONM platform through SONM CLI interface. See the SONM CLI Guide for command usage details.

Manage resources

  • View your worker list: sonmcli hub worker list.
  • Get the full information about each worker and its occupied and available resources: sonmcli hub worker status.


  • View aggregated list of all your resources attached to the Hub: sonmcli hub dev list.
  • Set special device properties for the devices: sonmcli hub dev set.
  • Check device properties: sonmcli hub dev get.

Interact with Marketplace

  • Check your account balance using Wallet.
  • Create a slot configuration file to search orders in the Marketplace (see example in SONM GitHub).
  • Search for BID, ASK, or ANY orders matched to your slot: sonmcli market search
  • Create the ask plans for Hub using your slots files: sonmcli hub ask-plan create.

NOTE: Hub will automatically create "ASK" order on the Marketplace according to the ask-plan. Hub removes "ASK" order from the Marketplace when deal is accepted, and publishes it again when deal is finished.

  • Check information about your ask-plans: sonmcli hub ask-plan list.
  • When it's nesessary you can remove the ask-plan: sonmcli hub ask-plan remove.

Consumer's Client node searches ASK orders that match its BID orders. If the Consumer's Client node selects your BID order, it starts to make a deal with your automatically.

Manage deals

When the deal is opened, SONM smart contract transfers tokens from Consumer's address to contract address. Tokens remain there until the deal is closed.

  • Check your deals list to see your current deals: sonmcli deals list.
  • View you new deal details: sonmcli deal status.

When deal is accepted Consumer is able to start task execution on your resources.

View tasks

  • View your active task list: sonmcli hub task list.
  • Check your task status: sonmcli hub task status.

NOTE: Consumer can execute several tasks within one deal.

Close deal

The deal may be closed in two ways.

  • Automatically, when the deal time is over. All tokens are tranfered to Supplier's address.
  • Consumer can close deal manually before the deal time is over. Tokens are tranfered to Supplier's address in proportion to the deal duration. Rest of tokens are tranfered back to Consumer's address.

Check your balance using SONM Wallet and ensure tokens transferred.