docs/user-guides/asset-hosting
Jamie Hewitt 659570cda0
The Uploader Docs (#1256)
* Adding initial page as a user guide on interacting witht the DBS

* Updating steps and instructions for the DBS user guide

* updating the navigation

* updating arweave user guide

* Adding links to the dbs upload instructions

* Adding images

* Adding images into the guide

* CHanging DBS to Uploader in user guide

* moved uploader (ex dbs) pages from gitbook

* remove all refs to dbs

* change DBSClient to UploaderClient

* removed more dbs refs

* Update README.md

- adjust some links
- fix some texts

* updated images uploader

* adding format to codeblocks

* updated images

* added uploader to asset hosting

* fix some text

* fix typo

* fix link

* replaced more images

* added text to asset hosting section related to uploader

* changed "Using Arweave with Uploader"

* removed references to "storage management"

* added missing link

* move uploader.js section from main page

* added to uploader's main readme

* rewrite uploader ui docs

* added expandable component to api calls in uploader.js

* rewrite API main paragraph in uploader.js

* fix some dbs refs

* added more to uploader ui

* moved uploader in the summary page

* added arcade to "How to store an asset on Arweave with the Uploader UI"

* added uploader links

* Update uploader.md

update arcade link

* Update uploader.md

* Updating diagrams

* Update to mention IPFS support

* Minor change in README.md

---------

Co-authored-by: Lcdo-Jeremy <enzo-vezzaro@live.it>
Co-authored-by: Ana Loznianu <ana@oceanprotocol.com>
Co-authored-by: mihaisc <mihai@oceanprotocol.com>
2024-02-09 15:27:14 +03:00
..
README.md Updated the general questions FAQ 2023-10-06 15:58:34 +03:00
arweave.md The Uploader Docs (#1256) 2024-02-09 15:27:14 +03:00
aws.md Fix broken links 2023-06-29 18:52:01 +03:00
azure-cloud.md Revert "GITBOOK-652: Fix roles arcade links" 2023-07-15 16:49:05 +03:00
github.md Final cleanup 2023-07-16 10:19:03 +03:00
google-storage.md Cleanup image assets file structure and the broken links 2023-07-15 14:52:48 +03:00
uploader.md The Uploader Docs (#1256) 2024-02-09 15:27:14 +03:00

README.md

description
How to host your data and algorithm NFT assets like a champ 🏆 😎

Host Assets

The most important thing to remember is that wherever you host your asset... it needs to be reachable & downloadable. It cannot live behind a private firewall such as a private Github repo. You need to use a proper hosting service!

The URL to your asset is encrypted in the publishing process!

Publish. Cool. Things.

If you want to publish cool things on the Ocean Marketplace, then you'll first need a place to host your assets as Ocean doesn't store data; you're responsible for hosting it on your chosen service and providing the necessary details for publication. You have SO many options where to host your asset including centralized and decentralized storage systems. Places to host may include: Github, IPFS, Arweave, AWS, Azure, Google Cloud, and your own personal home server (if that's you, then you probably don't need a tutorial on hosting assets). Really, anywhere with a downloadable link to your asset is fine.

In this section, we'll walk you through three options to store your assets: Arweave (decentralized storage), AWS (centralized storage), and Azure (centralized storage). Let's goooooo!

Read on, if you are interested in the security details!

Security Considerations

{% embed url="https://media.giphy.com/media/81xwEHX23zhvy/giphy.gif" %} These guys know what's up {% endembed %}

When you publish your asset as an NFT, then the URL/TX ID/CID required to access the asset is encrypted and stored as a part of the NFT's DDO on the blockchain. Buyers don't have access directly to this information, but they interact with the Provider, which decrypts the DDO and acts as a proxy to serve the asset.

We recommend implementing a security policy that allows only the Provider's IP address to access the file and blocks requests from other unauthorized actors is recommended. Since not all hosting services provide this feature, you must carefully consider the security features while choosing a hosting service.

{% hint style="warning" %} Please use a proper hosting solution to keep your files. Systems like Google Drive are not specifically designed for this use case. They include various virus checks and rate limiters that prevent the Providerdownloading the asset once it was purchased. {% endhint %}