Introduction to MaidSafe: what it is, how it works, and how it compares to Bitcoin

dallyshalla · January 9, 2015, 9:15pm

maidsafe-archive/MaidSafe-Network-Filesystem/blob/next/docs/rest_api.md

# Maidsafe App REST API [DRAFT] #
> NOTE: This API is subject to change.

The Maidsafe REST API strives to be easy to use, consistent, and flexible for advanced users requiring performance.

## Storage Abstractions ##
### Blobs ###
Data on the SAFE network is stored in Blobs. A Blob can contain text or binary data, and the SAFE network has no upward limit on size. However, local system contraints may apply to maximum size. Each Blob is immutable, once it is stored it cannot be modified.

### Container ###
A Container stores Blobs at keys that have no restrictions (any sequence of bytes are valid). Each key is versioned, so past Blobs can be retrieved (which gives the appearance of mutability since a new `Blob`s can be stored at an existing key).

### Storage ###
Storage has 0 more Containers. The Storage can be public, private, or privately-shared.

### StorageID ###
A StorageID identifies a particular Storage instance on the SAFE network, and contains the necessary information to decrypt the contents.

## Behavior Overview ##
Every REST API function call that requires a network operation returns a [`Future<T>`](#futuret) object. This prevents the interface from blocking, and provides an interface for signalling completion. Every `Future<T>` object in the REST API returns an [expected](#expected) object, which either holds the result of the operation or a network related error. An expected object allows for exception-style programming, return-code style programming, or monadic style programming. When an expected object contains a successful operation, it will have the result of the operation and version information. When an expected object contains a failed operation, it will contain an error code and a retry mechanism that returns a `Future<T>` with the same type as the original `Future<T>`.

This file has been truncated. show original

for example, you can find DeleteContainer(std::string)

Then there is this, by @ned14

Topic		Replies	Views
The safe network explained using bitcoin terminology Community	66	9229	June 5, 2019
As a beginner, here is what I don't understand Beginners	56	3528	May 26, 2015
Bitcoin and Maidsafe are about freedom not making money Marketing	3	469	May 17, 2021
"Network atomic" operation Features	6	1560	July 24, 2014
Trying to understand safecoin Autonomi Network Token	3	1235	November 3, 2014

Introduction to MaidSafe: what it is, how it works, and how it compares to Bitcoin

Related Topics