Skip to content

Commit

Permalink
Merge branch 'main' of github.com:mrodriguez3313/fula-docs
Browse files Browse the repository at this point in the history
  • Loading branch information
mrodriguez3313 committed Jul 25, 2024
2 parents 6059d78 + 19b190e commit 88d8584
Show file tree
Hide file tree
Showing 4 changed files with 110 additions and 1 deletion.
10 changes: 9 additions & 1 deletion docs/functionyard/hardware/fxblox-hardware-rk1.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,24 @@
title: FxBlox Lite Plus (RK1)
id: fxblox-hardware-rk1
---
import ReactPlayer from 'react-player';

## Updating Your FxBlox Lite Plus (RK1)

:::warning
If you were helping test nightly firmware releases **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. **See more [details here.](../fxblox-app.md/#format-drive)**
:::

## Video Guide

<center>
<ReactPlayer controls url="https://youtu.be/O4-PoQ5wCqs" />
</center>

## Written Guide
### Step 1: Download the Firmware

- **Download**: Find `minimal_update.zip` in the [latest release](https://github.com/functionland/rk1-image/releases/latest) under the Assets section on GitHub. As of 13/APR/2024, this is the latest file: https://github.com/functionland/rk1-image/releases/download/v1.54.3/minimal_update.zip
- **Download**: Find `minimal_update.zip` in the [latest release](https://github.com/functionland/rk1-image/releases/latest) under the Assets section on GitHub. As of 22/JUNE/2024, this is the latest file: https://github.com/functionland/rk1-image/releases/download/v1.54.18/minimal_update.zip
- **Options**:
- Download files with `minimal_` prefix if you do not need a desktop interface (access via Terminal, smaller file size).

Expand Down
10 changes: 10 additions & 0 deletions docs/pinning-service/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: Welcome
id: index
---
# Welcome to Functionland

Functionland was founded on a core set of Web3 principles. At the heart of these principles is a simple premise: **<u>We each have an inalienable right to own our own data.</u>**

We set out to build a better future around this simple premise. We started by developing an app that liberates a set of "own data" we think is particularly important to people: personal home photos and video.
We also provide and ipfs compatible pinning service, which is the first true decentralized pinning service for ipfs data
80 changes: 80 additions & 0 deletions docs/pinning-service/ipfs-pinning-service-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
title: "IPFS Pinning Service API"
id: ipfs-pinning-service-api
slug: "ipfs-pinning-service-api"
excerpt: ""
hidden: false
createdAt: "Fri JUN 28 2024 15:02:42 GMT+0000 (Coordinated Universal Time)"
updatedAt: "Fri JUN 28 2024 18:39:16 GMT+0000 (Coordinated Universal Time)"
---
<Note>Not to be confused with the Fula API, the Pinning Service API allows you to create a link between your local IPFS node and Functionland Fula Network</Note>

## IPFS Pinning Services API Spec Compatibility

The [IPFS Pinning Services API Spec](https://ipfs.github.io/pinning-services-api-spec/) is a standardized specification for developers building on top of IPFS that allows an application to integrate a pinning service without needing to learn that pinning service's unique API.

### Introduction

Functionland Fula network is the only available true decentralized network for pinning ipfs data. It currently includes 900 globally distributed nodes. These nodes are individually owned and are rewarded using Fula blockchain based on the storage they provide. Since it is an open network, anyone can join and start providing the service and earns. For more information please visit https://fx.land

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://fx.land/igg%20sales%20map.png" />

### Endpoints

Functionland Fula users looking to utilize the IPFS Pinning Services API can do so from our dedicated API endpoint:

`https://api.cloud.fx.land`


### Authentication

To authenticate with Functionland through the Pinning Services API spec, you'll first need to have an `accessToken`. You can create this API token on the [Fula Cloud Page](https://cloud.fx.land/) (FREE 20GB pinning!)

If you ever revoke the API key, it will no longer be valid for authenticating to the Pinning Services API.

**Configuring Functionland Fula in the IPFS Desktop App**

If you are running the IPFS desktop app, you can configure your pinning service of choice within the user interface. To do so, open the app, go to your Preferences, then click Add Service:

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://bafybeidvzrjgjigmagzlan77hzpqbxpdc3ixount6v4y3ojcbja3e2ol3a.ipfs.dweb.link/" />

Select Functionland as the pinning service, and then configure with your secret access token (JWT):

<!-- Image -->

From there you can upload files and have the option to pin locally as well as remotely to Functionland Fula network!


### Configuring Functionland Fula in the IPFS CLI

You can also pin to Functionland Fula directly from the IPFS CLI using the `ipfs` command.

To add Functionland Fula credentials, use the following command (where YOUR\_JWT is the JWT token described in the “Authentication” section above):

```bash
ipfs pin remote service add functionland https://api.cloud.fx.land YOUR_JWT
```

To pin a CID to Functionland Fula under a human-readable name:

```bash
ipfs pin remote add --service=functionland --name=war-and-peace.txt bafybeib32tuqzs2wrc52rdt56cz73sqe3qu2deqdudssspnu4gbezmhig4
```

To list successful pins:

```bash
ipfs pin remote ls --service=functionland
```

To list pending pins:

```bash
ipfs pin remote ls --service=functionland --status=queued,pinning,failed
```

For more commands and general help:

```bash
ipfs pin remote --help
```
11 changes: 11 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,17 @@ const sidebars = {
'functionyard/support',
]
},
{
type: 'category',
label: 'Pinning Service API',
link: {
type:'doc',
id:'pinning-service/index'
},
items:[
'pinning-service/ipfs-pinning-service-api',
]
},
{
type: 'category',
label: 'Fula API',
Expand Down

0 comments on commit 88d8584

Please sign in to comment.