RaaS interfaces
Specifications for RaaS interfaces.
RaaS has a base and full interface to enable replication, renew and repair of storage deals.
Self-hosted RaaS
RaaS refers to replication, renewal and repair as a service, for data stored in storage deals on Filecoin. Developers can leverage the self-hosted RaaS to provide RaaS features, within their storage solution, using the RaaS Starter Kit.
Self-hosted RaaS requires 4 components:
The Client who has data to upload
An Aggregator platform (a type of storage solution) that receives the Client’s data and makes a storage deal on Filecoin
The RaaS node, hosted by the developer, that checks if the storage deal requires replication, renewal and/or repair
The RaaS DealStatus smart contract that the RaaS node executes checks with
In the example of replication:
The client generates a
CIDfor the data and requests the RaaS node to store data.The RaaS node takes the client’s data and makes the storage deal onto Filecoin.
The client registers a replication job to the RaaS node and defines the number of replicas of their data to store, by calling the
/register_jobsAPI on the RaaS node (e.g. “This data needs to have a minimum of 10 copies on the network”).The RaaS node periodically checks the client data’s
CIDfor its deal status on Filecoin.The RaaS node requests deal status with the DealStatus smart contract, via
getActiveDeals(CID)and checks if the client’s data is stored with the accurate number of replicas.The DealStatus smart contract returns the information of active deals to the RaaS node.
If the number of replicas does not match the client’s requirements, the RaaS node is notified.
The RaaS node fetches the data via its
CIDand resubmit a request to create new storage deals (repeat step 2).When the client requests for retrieval of data, it queries the RaaS node, which will fetch the data from the storage provider on Filecoin or provide an IPFS pinned copy (depends on how RaaS node is setup to store the data).
In the example of renewal:
The client generates a
CIDfor the data and requests the RaaS node to store data.The RaaS node takes the client’s data and makes the storage deal onto Filecoin.
The client registers a renewal job to the RaaS node and defines the renewal threshold for the data’s storage deal, by calling the
/register_jobsAPI on the RaaS node (e.g. renew storage deals that are 1 month away from expiry).The RaaS node periodically checks the client data’s
CIDfor its deal status on Filecoin.The RaaS node requests deal status with the DealStatus smart contract, via
getExpiringDeals(CID)and checks if any of its active deals is expiring.The DealStatus smart contract returns the information of expiring deals to the RaaS node.
If deals with the client’s data are expiring, the RaaS node is notified.
The RaaS node fetches the data via its
CIDand resubmit a request to create new storage deals (repeat step 2).When the client requests for retrieval of data, it queries the RaaS node, which will fetch the data from the storage provider on Filecoin or provide an IPFS pinned copy (depends on how RaaS node is setup to store the data).
In the example of repair
The client generates a
CIDfor the data and requests the RaaS node to store data.The RaaS node takes the client’s data and makes the storage deal onto Filecoin.
The client registers a repair job to the RaaS node and defines the repair threshold for the data’s storage deal, by calling the
/register_jobsAPI on the RaaS node (e.g. “this deal needs repairing if it is not proven active for X epochs”).If the deal ID and corresponding deal sector are not being actively proven for X epochs, the deal will require repairing.
The RaaS node fetches the data via its
CIDand resubmit a request to create new storage deals (repeat step 2).
Aggregator-hosted RaaS
Last updated
Was this helpful?