The Basics
Flat API#
Flat API creates a new connection to the Flat Subsocial API (with a wrapper which returns flat structs). Thus, using the Flat, we abstract from the blockchain and can use the usual JavaScript types.
🆃 NewSubsocialApiProps: Omit<SubsocialApiProps, 'substrateApi'> & { substrateNodeUrl: string, substrateApi?: ApiPromise }
SubsocialApi#
SubsocialApi creates a new connection to the Subsocial API (includes Substrate and IPFS connections).
Using this class, you can get all the data of posts, spaces and profiles from IPFS and the blockchain's storage with appropriate methods.
🆃 SubsocialApiProps: SubsocialContext & { ipfsNodeUrl: string, offchainUrl: string, substrateApi: SubstrateApi }
SubsocialSubstrateApi#
SubsocialSubstrateApi is a wrapper for connecting to a Subsocial Node with functions from Subsocial Pallets wrapped in convenient methods to call.
🆃 SubstrateApiProps: SubsocialContext & { api: SubstrateApi }
SubsocialIpfsApi#
Aggregated API to work with IPFS: This gets the contents of spaces, posts, and profiles.
🆃 SubsocialIpfsProps: SubsocialContext & { ipfsNodeUrl: IpfsUrl; offchainUrl: string }
Off-chain#
Off-chain is a storage where data is built on the basis of blockchain events. This allows you to conveniently perform work that the blockchain itself does not allow.
It saves text data of blogs, posts and comments to IPFS, builds user feeds and notifications in Postgres, and supports full text search by indexing text data into an ElasticSeach database.
IPFS#
The InterPlanetary File System (IPFS) is a decentralized storage network commonly used by blockchain projects looking for a storage solution. It is similar to a torrent network where users download content to their machines, and upload it to people that wish to access it. IPFS node operators are able to choose what content they host on their node. Subsocial uses IPFS for multimedia storage.