README
¶
v1.4.1
SiaPrime is a decentralized cloud storage platform based on the Sia core protocol. Leveraging smart contracts, client-side encryption, and sophisticated redundancy (via Reed-Solomon codes), SiaPrime allows users to safely store their data with hosts that they do not know or trust. The result is a cloud storage marketplace where hosts compete to offer the best service at the lowest price. Hosts can include everyone from individual hobbyists up to enterprise-scale datacenters with excess capacity to sell.
The SiaPrime protocol currently provides very basic storage capability. We expect the SiaPrime product suite will begin to roll out in 2020 as we work in parallel with Sia core developers to deliver live products as soon as the protocol can support them. As time passes, we expect the SiaPrime protocol to diverge from the Sia protocol in some ways as we build an industrial strength version.
Traditional cloud storage is dominated by a small number of companies. SiaPrime is an initiative to provide small and medium sized business (SMB) a comprehensive cloud storage environment uncompromised by inside or outside interference. This is achieved through fragmenting user data and spreading it across a distributed network of hosts. No single datacenter has access to your complete data.
These fragments are duplicated over enough hosts that even if several hosts disappear, your data is still accessible. Switching to different hosts for better geographic coverage, price, speed or reliability is easy as hosts compete with each other to provide the best service offering.
SiaPrime will offer a complete cloud storage solution for file backup, long term archival needs, CDN use cases as well as bridging the gap between online and offline strategies. The SiaPrime network allows for highly parallel data transfer, which when coupled with geographic targeting can significantly reduce latency and access to your data no matter if you are storing family photos or large database backups.
The process of choosing hosts on the SiaPrime network allows customers to choose based on latency, lowest price, widest geographic coverage, or even a strict whitelist of IP addresses or public keys. We expect to provide customers multiple ways to purchase storage on the SiaPrime network, including simple Dropbox-like web interfaces up to sophisticated client dashboards for enterprise clients.
Purchasing storage on the network will have several variants, though all ultimately use our core cryptocurrency utility coin called a SiaPrime Coin. SiaPrime Coins will be available on cryptocurrency exchanges. We will also be creating fiat to storage gateways to encourage broad adoption of the SiaPrime storage model.
Usage
This release comes with 2 binaries, spd and spc. spd is a background
service, or "daemon," that runs the SiaPrime protocol and exposes an HTTP API on
port 4280. spc is a command-line client that can be used to interact with
spd in a user-friendly way. There is also a graphical client, SiaPrime-UI,
which is the preferred way of using SiaPrime for most users. For interested
developers, the spd API is documented here.
On Windows, double-click spd.exe. For command line operation, navigate to the
containing folder and click File->Open command prompt. Start the spd service
by entering spd and pressing Enter. The command prompt may appear to freeze;
this means spd is waiting for requests. Windows users may see a warning from
Windows Firewall; be sure to check both boxes ("Private networks" and "Public
networks") and click "Allow access." You can now run spc (in a separate command
prompt) or SiaPrime-UI to interact with spd.
Building From Source
To build from source, Go 1.11 or above must be installed
on the system. Make sure your $GOPATH is set, and then simply use go get:
go get -u gitlab.com/SiaPrime/SiaPrime/...
This will download the SiaPrime repo to your $GOPATH/src folder and install
thespd and spc binaries in your $GOPATH/bin folder.
To stay up-to-date, run the previous go get command again. Alternatively, you
can use the Makefile provided in this repo. Run git pull origin master to
pull the latest changes, and make release to build the new binaries. You
can also run make test and make test-long to run the short and full test
suites, respectively. Finally, make cover will generate code coverage reports
for each package; they are stored in the cover folder and can be viewed in
your browser.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
Package compatibility contains a bunch of tests to make sure that compatibility has been preserved with previous versions.
|
Package compatibility contains a bunch of tests to make sure that compatibility has been preserved with previous versions. |
|
Package encoding converts arbitrary objects into byte slices, and vis versa.
|
Package encoding converts arbitrary objects into byte slices, and vis versa. |
|
Package modules contains definitions for all of the major modules of Sia, as well as some helper functions for performing actions that are common to multiple modules.
|
Package modules contains definitions for all of the major modules of Sia, as well as some helper functions for performing actions that are common to multiple modules. |
|
explorer
Package explorer provides a glimpse into what the Sia network currently looks like.
|
Package explorer provides a glimpse into what the Sia network currently looks like. |
|
gateway
Package gateway connects a Sia node to the Sia flood network.
|
Package gateway connects a Sia node to the Sia flood network. |
|
host
Package host is an implementation of the host module, and is responsible for participating in the storage ecosystem, turning available disk space an internet bandwidth into profit for the user.
|
Package host is an implementation of the host module, and is responsible for participating in the storage ecosystem, turning available disk space an internet bandwidth into profit for the user. |
|
miner
Package miner is responsible for creating and submitting siacoin blocks
|
Package miner is responsible for creating and submitting siacoin blocks |
|
miningpool
Package pool is an implementation of the pool module, and is responsible for creating a mining pool, accepting incoming potential block solutions and rewarding the submitters proportionally for their shares.
|
Package pool is an implementation of the pool module, and is responsible for creating a mining pool, accepting incoming potential block solutions and rewarding the submitters proportionally for their shares. |
|
renter
Package renter is responsible for uploading and downloading files on the sia network.
|
Package renter is responsible for uploading and downloading files on the sia network. |
|
renter/contractor
Package contractor is responsible for forming and renewing file contracts with hosts.
|
Package contractor is responsible for forming and renewing file contracts with hosts. |
|
renter/hostdb
Package hostdb provides a HostDB object that implements the renter.hostDB interface.
|
Package hostdb provides a HostDB object that implements the renter.hostDB interface. |
|
stratumminer
Package stratumminer provides some utilities and common code for specific client implementations Package stratumminer is responsible for finding valid block headers and submitting them to a stratum server Package stratumminer implements the basic stratum protocol.
|
Package stratumminer provides some utilities and common code for specific client implementations Package stratumminer is responsible for finding valid block headers and submitting them to a stratum server Package stratumminer implements the basic stratum protocol. |
|
Package node provides tooling for creating a Sia node.
|
Package node provides tooling for creating a Sia node. |
|
api/server
Package server provides a server that can wrap a node and serve an http api for interacting with the node.
|
Package server provides a server that can wrap a node and serve an http api for interacting with the node. |
|
daemon
Package daemon contains tests related to the /daemon endpoints.
|
Package daemon contains tests related to the /daemon endpoints. |