astroport/README.md

# NOUVELLE VERSION

Le développement

```
    ___         __                              __ 
   /   |  _____/ /__________  ____  ____  _____/ /_
  / /| | / ___/ __/ ___/ __ \/ __ \/ __ \/ ___/ __/
 / ___ |(__  ) /_/ /  / /_/ / /_/ / /_/ / /  / /_  
/_/  |_/____/\__/_/   \____/ .___/\____/_/   \__/  / KODI
                          /_/                      

__HyperWeb 5D - Metavers Numérique centré sur l'Humain__
```

continue sur [Astroport/KODI - astrXbian](https://git.p2p.legal/axiom-team/astrXbian)

---

> ATTENTION ce code n'est plus maintenu... nous vous invitons désormais à utilisez [Astroport/KODI](https://git.p2p.legal/axiom-team/astrXbian)

# __Human Centric Telecommunication System__

## [is Not an Astroport](./ANA)

The dream of an Internet without GAFAM, without Datacenter. Hosted and operated by all of us... 
An asynchronous, anoptic, friend of friend (P2P) network.

## [c'est quoi?](https://astroport.frama.site/)

Le rêve d'un Internet sans GAFAM, sans Datacenter. Hébergé et opéré par nous tous... 
Un réseau asynchrone, anoptique, qui fonctionne par ami d'ami (P2P).

[GROGol traduction](https://translate.google.fr/translate?sl=en&tl=fr&u=https%3A%2F%2Fgit.p2p.legal/axiom-team/astroport/src/master/README.md)

---

| FR   | EN   | DE   |  ES  |  PT  |  IT  |  NL  |  RU   |  PL  |
| ------------------------------------------------- | ---- | ---- | --- | --- | --- | --- | --- | --- |
| [Internet est cassé](./ANA/01.home/default.fr.md) | [The Internet is broken](./ANA/01.home/default.en.md) | [Das Internet ist kaputt](./ANA/01.home/default.de.md) |  [La Internet está rota](./ANA/01.home/default.es.md)   |  [A Internet está quebrada](./ANA/01.home/default.pt.md)   |  [Internet è rotto](./ANA/01.home/default.it.md)   |  [Het internet is kapot](./ANA/01.home/default.nl.md)   |  [Интернет сломан](./ANA/01.home/default.ru.md)   |  [Internet jest zepsuty](./ANA/01.home/default.pl.md)   |

---

## So what is Astroport ?

Astroport is an ecosystem of several open sources applications forming a global mesh of meshes restructuring the network from Humans point of view not Machine POV.

### It is autonomous, doesn't need permanent connectivity and is Human centered ONLY. [It behaves like The "BLOB creature"](https://git.p2p.legal/axiom-team/astroport#-help-our-open-collective-with-donations)

It's using:
- **ScuttleButt** as friendship, relative confidence, personnal blockchain & asynchronous, disconnect friendly, communication (SSB) layer, and 5Mb max file size storage. 
- **IPFS** as distributed storage, incremental backup, media transport & file sharing layer between friends through **Zen Contracts**.
- **Duniter** First Libre currency monetary layer. Based on a sidechain strict consensus blockchain producing a Libre Money called June (Ḡ1). Actual fixed conversion rate is **1 Ḡ1 = 100 Zen**

### THE FLAVORS

Each hosted astroport station will be able to have different "flavors", i.e. different software interconnected with it.

The base is a crystal with three branches, this is the Lapunta key in "The Castle in the Sky": G1 + SSB + IPFS.
The Lapunta key is the **responsible numerical identity which allows to start its relativistic #Swarm0** using the Astroport engine.

We can then add 'flavors' to the base which then becomes a Metaverse
**Metaverse is the experience of each of the interconnection of its information channels**
G1sms, Nextcloud, G1Dab, G1Tx, Cesium, Gchange, Transiscope, Oasis, Feedless, Youtube, Torrent, Minetest, etc... 
We will even be able to add new applications simply !  It's everyone's taste in Metavers.

These tastes are like doors that we open or close to data flows thanks to the astroport, by its Stations (x64, Rpi, VirtualBox), its keys and your friends.

The **Minetest flavor**, which is actively developped, will teleport you into the private digital worlds of your Scuttlebutt friends.

The **Nextcloud flavor** will allow you a nearly infinite storage in the IPFS.

Applications connected to Astroport are considered as modules, synchronized channels with push/pull capacities, step by step integrated
1. Scraper / Pusher
2. API : Read / Write
3. IPFS full index/data conversion.

### Rapid overview how an App can become an Astroport Module and then be a DApp 

In Astroport Loveland Metaverse every Station have a relative SSB view of the whole...
So many stations are part of the unique #Swarm0 relative to each "$YOU" Station.
    
Each Station have some software installed on it. Once "Fat Protocol Layer" is activated. **Your Astroport PC have new Power(S)**.
IPFS layer is always adapting to Half of your avalaible HDD space (better USB3 SSD ... technology ask @attilax)

Your LOCAL Apps can benefit from backup / replication / cryptographic file sharing / teleportation features !!
Depending on App and Data structure, different operations are requested.
    
[Get your App transformed to DApp is easy as 1, 2, 3](https://git.p2p.legal/axiom-team/astroport/src/master/g1sms/Readme.md)?

Want to join and try Alpha stage #Swarm0 ?

## #SWARM0

```
     __ __                                     ____ 
  __/ // /_______      ______ __________ ___  / __ \
 /_  _  __/ ___/ | /| / / __ `/ ___/ __ `__ \/ / / /
/_  _  __(__  )| |/ |/ / /_/ / /  / / / / / / /_/ / 
 /_//_/ /____/ |__/|__/\__,_/_/  /_/ /_/ /_/\____/  

```                                                    
Activated and meshed layers, your node will create and connect to its #Swarm0
A special view and access to its network and data through friends only.

#swarm0 is the inner IPFS Metaverse structure and shape the same way our SSB friends are.
Main Task Manager is [run every minutes via cron](https://git.p2p.legal/axiom-team/astroport/src/master/cron_MINUTE.sh) 

By default, shared ipfs data are encrypted (ed25519), but is not "private"...
- Just "invisible" from IPFS Not Friends Nodes.
- Discoverable within SSB by friends of your friends.

Share the same ~/.ipfs/swarm.key with your friends to "HARDEN" your shield

## Installation: Debian 10 (armv7/arm64/amd64) and Ubuntu/Mint 64bits ONLY !
**WARNING: This is an alpha stage development! Please FOLLOW INSTRUCTIONS!!! Open issues and help corrections. Thank you.**

### 0 - OPTIONAL : Create a new user "pi"

Only if you don't have "ipfs daemon" already running !!
continue the install with the user you are already using instead.

```
adduser pi
usermod -aG sudo pi
su - pi
```

### 1 - Automatic install
If you are sure about the code and you don't have .ssb and .ipfs folders, you can run automatic install:
```
curl -s https://git.p2p.legal/axiom-team/astroport/raw/master/install.sh | bash
```
:coffee:

Else you can follow steps 2,3 and 4 to check code gradually.

### 2 - IPFS - **Install and start “ipfs daemon”**

**WE ENCOURAGE YOU TO ALWAYS READ CODE YOU ARE DOWNLOADING AND EXECUTING or trust a friend only!!**

---

#### JOINING FOUNDATION TEAM !!! 
**IMPORTANT !!!**
- Read the [Pure bash Bible](https://github.com/dylanaraps/pure-bash-bible)
- DO NOT RUN AUTOMATIC INSTALL BUT DO "STEP BY STEP" CODE EXECUTION
- Do make your report and follow https://pad.p2p.legal/s/astroport-landing#
- Do you know https://asciinema.org/? Record your session as a movie (join it to your issues)

> WELCOME

* Semi manual (so you can run the code step by step)

```
#  to do so
curl -s https://git.p2p.legal/axiom-team/astroport/raw/master/.install/ipfs_alone.sh -o /tmp/ipfsA.sh
geany /tmp/ipfsA.sh

# If you are happy with what you read and understood. RUN it
chmod +x /tmp/ipfsA.sh && /tmp/ipfsA.sh
```
* Full automatic (you trust this script from this git depot)

```
curl -s https://git.p2p.legal/axiom-team/astroport/raw/master/.install/ipfs_alone.sh | bash
```

[How your SSB and IPFS swarm are kept in sync](https://git.p2p.legal/axiom-team/astroport/src/master/zen/ssb_IPFS_swarm.sh)?

### 3 - G1 SSB - **Create your “secrets” 🔑 from credentials and activate your Astroport Station 🛸**

[Look at the code generating your G1SSB Identity](https://git.p2p.legal/axiom-team/astroport/src/master/zen/tools/make_G1SSB_secret.sh).

```
# ONCE YOU READ, RUN step by step and AGREE !!! Run QUICK Install...
curl -s https://git.p2p.legal/axiom-team/astroport/raw/master/zen/tools/make_G1SSB_secret.sh | bash

```
**Astroport #Swarm0 makes you enter a "Virtual Private IPFS Swarm" shared with Scuttlebutt friends**

All files are located in ```~/.zen``` and ```~/.ssb_astroport``` (linked to ```~/.ssb```)

Your Astroport Station is working as a "multi-channel Switch", Apps are seen as push/pull communication channels.
Every minute, it "listens" to all its connected "channels" and run small routines to make actions between them.

During alpha period, your Station will ```git pull``` fresh code from this git every 5 mn.
**Fresh code** is located in ```~/.zen/astroport```

**IMPORTANT!! BACKUP YOUR KEYS!**

```
~/.zen/secret.astroport.key # this Station $WHOAMI "LaPunta" Key, containing login/password to create your "gchange account"
~/.zen/secret.dunikey # Cesium Key, the June G1 wallet of you Key.
~/.ssb/secret ( + ".json's" for easier SSB recovery) # ScuttleButt ID + connectors

```
KEEP them safe. 
This way you could recover your data from #Swarm0

### 4 - DEMONSTRATION _ LOVELand _ Metaverse Interface: https://oasis.astroport.com

**$YOU Local basic 100km Web Control for Zen p2p markets**
(+ coming [Minetest](https://minetest.net), [NextCloud](https://nextcloud.com/), [CopyLaRadio](https://www.copylaradio.com), .... **Adding your App is easy as "1 2 3"**)

```
curl -s https://git.p2p.legal/axiom-team/astroport/raw/master/.install/loveland.sh | bash
```

---

## Quick tour of Astroport Stations "flavours" (alpha):

- A 100 km local area Information System around your Cesium location
    - [gchange_MONITOR!!](https://git.p2p.legal/axiom-team/astroport/src/master/zen/gchange_MONITOR.sh) Connect to [Gchange](https://gchange.fr) market

- A Nextcloud / IPFS Hub [Cloud Attilax Station](https://cloudattilax.axiom-team.fr/) [Rock64 Station](https://rock64.p2p.legal/)

- Minetest Mini Worlds (SSB in sync) [Txmn.tk Station](https://diaspora.normandie-libre.fr/posts/171127)

- **Explore ScuttleButt UNIVERSE**
    - Choose your prefered ScuttleButt client to reach the Metaverse
        - [Patchwork](http://dinosaur.is/patchwork-downloader/)
        - [Oasis](https://github.com/fraction/oasis)
        - [Feedless](https://github.com/rogeriochaves/feedless)
        - [Manyverse](https://manyver.se)
        - [others](https://scuttlebot.io/apps/index.html) & plenty to come !!

- **Experimentations with SSB & G1 UNIVERSE**
    - Reward SSB likes with [ssb-g1-tip](https://git.p2p.legal/axiom-team/ssb-g1-tip)

- **Experimentations into IPFS Zen UNIVERSE**
    - Copy [Audio](https://git.p2p.legal/axiom-team/astroport/src/master/zen/ssb_GET_zenyta.sh) and [Video](https://git.p2p.legal/axiom-team/astroport/src/master/zen/ssb_GET_zenytv.sh) from Youtube.
    - Publish [contracts in ZenTag](https://git.p2p.legal/axiom-team/astroport/src/master/zen/zen_MAKE.sh) 
    - ZenTag counters, IPNS nano DHT to control ipfs availability of files.

![](https://pad.p2p.legal/uploads/upload_bfcde4526535bce2cfb12c2e0497587d.png)

Questions? Help needed? Post an issue...
Chat with us https://chat.axiom-team.fr/channel/astroport 

---
## PARTNERS

[AXIOM-TEAM](https://axiom-team.fr/) | [Made In Zion](https://madeinzion.org) | [QWANTIC](https://qwantic.com)

```
 _             ______ _ 
/ \\    //\ |\ ||  | /  
\_X \/\//--\| \|| _|_\_ #HyperWeb 5D
                        
# BUILT FROM GNU CORE BASH TECHNOLOGY
https://www.gnu.org/software/coreutils/
```

---

# [OASIS RULES, Docs and Roadmap](https://git.p2p.legal/axiom-team/astroport/src/master/g1sms/Readme.md)

Participating  @attilax @poka @josselinchevalay @ben @mlsuyt @tuxmain @qo-op @manutopik @yyy @borispaing @paulart @guenoel @jeanluc @nox @pruls @cel @andrestaltz @Dan ... I have to stop... to many people...

# EXERNAL DOCUMENTATION
- [IPFS CLI commands](https://docs.ipfs.io/reference/api/cli/)
- [sbotc documentation and examples](https://pad.p2p.legal/scuttlebot#sbotc--documentation)

KEEP COOL, BE SAFE, BE FREE
```
 _____            
/__  /  ___  ____ 
  / /  / _ \/ __ \
 / /__/  __/ / / /
/____/\___/_/ /_/ 
                  
```

### Astroport is Human centered & Nature inspired

- Similar to Organic Life Form 

[![Blob creature](https://git.p2p.legal/axiom-team/astroport/raw/master/blob.gif)](https://www.youtube.com/watch?v=W_FaOWZQdz0)
[![#Swarm0 Clusters](https://git.p2p.legal/axiom-team/astroport/raw/master/doc/images/LIFE.gif)](http://www.ventrella.com/Clusters/)

- Devil/angel Game resolver : 
    - [SSB viewer link](https://viewer.scuttlebot.io/%25TzYboJss10k83csj3khLkGGc5km9zoR%2FAx6RG6z6yEo%3D.sha256)
    - [Youtube link](https://www.youtube.com/watch?v=sxiKlOK3EJY)
    - [#Swarm0 link](http://127.0.0.1:8080/ipfs/QmXs9374jUX6y8s3rSYxHb9LtkCKCxXGGwAVMbQgWBTbJa/sxiKlOK3EJY.mp4)

# [>>>>>>> Help our Open Collective with DONATIONS](https://opencollective.com/monnaie-libre)

### Web 2.0 is dangerous!! You only have window and an apple already biten.

Actual Internet is a place full of virus. But we are lucky a **Free Software Universe is lying inside of it**.

Now you must KNOW it exists, to be SAFE!
[HOW MANY PEOPLE ARE ALREADY OWNING YOUR DATA ???](https://monitor.firefox.com/) **<<< check your "digital ghost"**

> WE are building the **"HyperWeb Cyberspace"** with Base Stations and "Spacecraft(s) UX" (ZApp)

[Discover "LOVE Land" the 1st Libre Metaverse interface, a living digital space](https://oasis.astroport.com)