Fluence Network

The Fluence Labs Developer Hub

Welcome to the Fluence Labs developer hub. You'll find comprehensive guides and documentation to help you start working with Fluence Labs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Should you have any questions, feel free to join our Discord or Telegram!

Get Started    API Reference

Publishing a Backend app

Deploying your Wasm code to Fluence

In the Fluence network, applications are deployed by uploading WebAssembly code to IPFS, and publishing hashes of the uploaded code to the Fluence smart contract.

All this happens under the hood in the Fluence Dashboard. The dashboard allows you to deploy one of the existing apps, or upload your own Wasm backend.

Test your app without deploying

Use a debugging tool to keep your developing cycles short.

Demo and Account modes

Dashboard operates in two modes.

The first one, demo mode, uses a predefined Ethereum account. It allows you to deploy & delete applications shared by all demo-mode users without any ETH whatsoever.

The second, account mode, gives you control over your apps, and requires you to use Metamask, with an Ethereum Rinkeby wallet and some Rinkeby ETH on the balance. Apps you have deployed in this mode belongs to you, and can't be deleted by other users.

Getting on the Rinkeby

To register and top up your rinkeby wallet, follow instructions here

Deploying an app

Whether you're in Demo or Account mode, you can deploy apps from Instant Deploy. There's a list of existing apps, and an option to upload your own Wasm backend:

After you click Deploy app, it will signal miners to run this app on a cluster of 4 nodes.

Network capacity

Note that the application might need to wait in the queue until there are enough free nodes to host it. Current capacity of the network could be seen in the Nodes menu.

App status

To check if application work fine, you can use Check cluster button in every app's menu. If app is working fine, and you have a network access to all of it's nodes, you will see 4 green boxes with the current blockchain height of the app inside them.

If there's a red box next to the node's address, it means this node hasn't yet been initialized successfully, and you might need to wait a bit for it to be initialized.

If there's no green or red box, that means you don't have a network access to this node. For example, your ISP might be blocking it. That is fine though, you can access your cluster via any of the nodes hosting it.

Deleting an app

You can delete any application deployed by your current Ethereum account. For demo mode, that account is shared and accessible by everyone.

To delete an app that you own, go to the app's menu, and you will see a red Delete app button at the bottom of the app's card. App deletion frees up network capacity, so don't forget to clean your apps after you've finished playing with them.

However, if you wish your app to live long and happy, use Account mode by authorizing through a Metamask, so no one except you could delete your apps.

Trying existing apps

Apps like Redis fork (NoSQL database), and LlamaDB fork (SQL), provide a simple web interface right in the dashboard. To access it, go to Applications -> Redis fork, click it, and you will see the following on the right:

Here you can use predefined queries, or write your own. Remember that data is shared with other users, and can be deleted or modified by them.

Updated 9 months ago

Publishing a Backend app

Deploying your Wasm code to Fluence

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.