🏗️Technical Architecture

📋 Table des Matières

1. Vue d'ensemble

2. Architecture Système

3. Composants Principaux

4. Flux de Données

5. Sécurité et Cryptographie

6. Économie et Paiements

7. Stockage et Cache

8. APIs et Services

9. Maintenance et Monitoring

10. Déploiement

11. Intégration NOSTR

12. Système UPassport

---

🌟 Vue d'ensemble

Astroport.ONE est une plateforme décentralisée qui combine monnaie libre (Ğ1), stockage IPFS, identité numérique NOSTR et automatisation intelligente pour créer un écosystème Web3 complet.

🎯 Objectifs

• Souveraineté Numérique : Contrôle total des données utilisateur

• Économie Libre : Transactions sans intermédiaires via Ğ1

• Identité Décentralisée : Gestion d'identité basée sur NOSTR et IPFS

• Résilience : Architecture distribuée sans point de défaillance unique

• Automatisation Intelligente : Système AstroBot avec Vœux

🌍 Écosystème UPlanet

Astroport.ONE alimente l'écosystème UPlanet qui fonctionne sur deux niveaux :

🌐 UPlanet ORIGIN (Niveau X)

• Accès public pour tous les utilisateurs

• Sécurité standard avec surveillance Ğ1

• Token fixe : 1 Ẑen = 0.1 Ğ1

• Services : MULTIPASS, ZENCARD de base

🛡️ UPlanet Ẑen (Niveau Y/Z)

• Réseau privé avec clés SSH<->IPFS jumelles

• Sécurité avancée avec détection d'intrusion

• Tokens personnalisables : 1 Ẑen = valeur d'actif (€, m², kWh, etc.)

• Services avancés : DeFi, actifs réels, coopératives

---

🏗️ Architecture Système

Diagramme d'Architecture Générale

┌─────────────────────────────────────────────────────────────────┐
│                        Astroport.ONE                           │
│                    Écosystème Décentralisé                     │
└─────────────────────────────────────────────────────────────────┘
                                │
                ┌───────────────┼───────────────┐
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Interface  │ │   Services  │ │ Stockage  │
        │     Web      │ │   Métier    │ │Décentralisé│
        └──────────────┘ └─────────────┘ └───────────┘
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Port 54321  │ │  RUNTIME/   │ │   IPFS    │
        │  API Gateway │ │  Services   │ │  Storage  │
        └──────────────┘ └─────────────┘ └───────────┘
                │               │               │
        ┌───────▼──────┐ ┌──────▼──────┐ ┌─────▼─────┐
        │   Port 12345 │ │  ASTROBOT/  │ │  ~/.zen/  │
        │ Station Map  │ │ Automation  │ │   Cache   │
        └──────────────┘ └─────────────┘ └───────────┘

Architecture en Couches

Couche	Composants	Description
Présentation	Ports 12345, 54321	Interfaces web et APIs
Application	API/, RUNTIME/, ASTROBOT/	Services métier et automatisation
Données	IPFS, ~/.zen/game/	Stockage décentralisé et cache
Réseau	Ğ1, NOSTR, IPFS	Protocoles de communication

---

🔧 Composants Principaux

1. Scripts de Gestion Principaux

Script	Taille	Port	Rôle
command.sh	51KB	-	Interface principale de gestion
12345.sh	10KB	1234	Launcher principal
_12345.sh	23KB	12345	Cartographie des stations
20h12.process.sh	11KB	-	Maintenance quotidienne
NOSTRCARD.refresh.sh	34KB	-	Gestion des cartes NOSTR

2. Services et Ports

Port	Service	Description	Protocole
1234	Twist API	Twist BASH API (deprecated)	HTTP
12345	Station Map	Cartographie UPlanet	HTTP
45780-90	Twist API Response	Ports de réponse twist uniques	HTTP
33101	G1Billet	Service fabrication Ğ1 BILLETS	HTTP
54321	UPassport	UPassport 'FastApi' API	HTTP
8080, 4001, 5001	IPFS Gateway	Accès stockage décentralisé	HTTP
7777	NOSTR Relay	Réseau social décentralisé	HTTP/WebSocket
80, 443	Proxy SSL	Nginx Proxy Manager (docker n°1)	HTTP

3. Structure des Répertoires

Astroport.ONE/
├── command.sh              # Interface principale
├── 12345.sh               # Serveur API
├── _12345.sh              # Cartographie stations
├── 20h12.process.sh       # Maintenance quotidienne
├── install.sh             # Installation automatique
├── tools/                 # Utilitaires système
│   ├── my.sh             # Bibliothèque de fonctions
│   ├── keygen            # Générateur de clés
│   └── heartbox_analysis.sh # Analyse système
├── API/                   # API Sandbox Examples
│   ├── QRCODE.sh         # Gestion QR codes
│   ├── SALT.sh           # Authentification
│   └── UPLANET.sh        # Données UPlanet
├── RUNTIME/               # Services en arrière-plan
│   ├── G1PalPay.sh       # Surveillance Ğ1
│   ├── NOSTRCARD.refresh.sh # Comptes MULTIPASS
│   └── PLAYER.refresh.sh # Comptes ZEN Cards
├── ASTROBOT/              # Automatisation  (Players Smart Contract)
│   └── N1*.sh            # Commandes N1
├── templates/             # Templates HTML
└── _DOCKER/               # Official Docker Compose (Duniter, NextCloud, PeerTube, ...)

---

🔄 Flux de Données

1. Flux de Synchronisation Swarm

flowchart TD
    A[_12345.sh Start] --> B[Initialisation Clés]
    B --> C[Boucle de Synchronisation]
    C --> D{1 heure écoulée?}
    D -->|Non| E[Attente]
    E --> C
    D -->|Oui| F[Scan Bootstrap Nodes]
    F --> G[Récupération Données Distantes]
    G --> H{Données Modifiées?}
    H -->|Non| I[Cache Local]
    H -->|Oui| J[Mise à Jour Cache]
    J --> K[Publication IPNS]
    K --> L[Publication Swarm]
    L --> M[Attente Prochaine Cycle]
    M --> C

2. Flux de Maintenance Quotidienne

flowchart TD
    A[20h12.process.sh] --> B[Vérification IPFS]
    B --> C{IPFS OK?}
    C -->|Non| D[Redémarrage IPFS]
    C -->|Oui| E[Nettoyage Cache]
    D --> E
    E --> F[Sauvegarde Caches Critiques]
    F --> G[Suppression Cache Temp]
    G --> H[Mise à Jour Code]
    H --> I[Rafraîchissement Données]
    I --> J[Redémarrage Services]
    J --> K[Analyse Système]
    K --> L[Rapport Email]

3. Flux de Requête API Typique

cf. Dépot de code /UPassport

---

🔐 Sécurité et Cryptographie

1. Gestion des Clés

Type de Clé	Format	Usage	Stockage
Zen Card	Ẑen	Paiements et transactions	~/.zen/game/players/*/secret.dunikey
IPFS Key	IPFS	Identité décentralisée	~/.ipfs/keystore/
MULTIPASS Key	NOSTR	Réseau social	~/.zen/game/nostr/*/.secret.nostr
SSSS Keys	Shamir	Seed source	~/.zen/game/nostr/*/.secret.disco

2. Validation des Transactions

# Vérification des transactions primaires
function validate_primal_transaction() {
    local transaction="$1"
    local primal_source="$2"
    
    # Vérification de la source primaire
    if [[ "$primal_source" == "UPlanet_ORIGIN" ]]; then
        # Accepte toute source primaire
        return 0
    elif [[ "$primal_source" == "UPlanet_ZEN" ]]; then
        # Vérification stricte avec détection d'intrusion
        check_intrusion_detection "$transaction"
        return $?
    fi
}

3. Système de Chiffrement

• Clés Géographiques : Génération basée sur coordonnées GPS (UMAP 1km, SECTOR 10km, REGION 100km)

• Stargates : Distribution des messages NOSTR (protocole N²)

• Communs Cryptographiques : Partage de ressources cryptographiques

---

💰 Économie et Paiements

1. Système Multi-Tokens

Tokens Ẑen (MULTIPASS & ZENCARD)

• UPlanet ORIGIN : 1 Ẑen = 0.1 Ğ1 (taux fixe)

• UPlanet Ẑen : 1 Ẑen = valeur personnalisable (€, terrain, énergie, etc.)

Tokens NEẐ (uPASSPORT ZEROCARD)

• Valeur : 1 NEẐ = 1 Ğ1 (équivalent direct Ğ1)

• Usage : Actions dans l'infrastructure coopérative

Made In Zen Tokens

• Usage : Gouvernance coopérative et propriété d'infrastructure

• Accès : Disponible aux détenteurs de ZENCARD et dépositaires uPASSPORT

2. G1PalPay.sh - Surveillance "TW" quotidienne (avec ZEN.ECONOMY.sh, NOSTRCARD.refresh.sh, PLAYERS.refresh.sh, ...)

# Surveillance des transactions Ğ1
function monitor_g1_transactions() {
    local player="$1"
    local g1pub="$2"
    
    # Surveillance continue des transactions
    while true; do
        # Récupération des nouvelles transactions
        local new_transactions=$(get_new_transactions "$g1pub")
        
        # Traitement des transactions
        for transaction in $new_transactions; do
            process_transaction "$transaction" "$player"
        done
        
        sleep 30
    done
}

3. Économie des Likes

• Chaque like reçu = 1 Ẑ automatiquement transféré

• Système de gratitude : Récompense directe pour les interactions

• Capitalisation automatique : Gestion des tokens en temps réel

---

💾 Stockage et Cache

1. Structure IPFS

~/.zen/game/
├── players/              # Données des joueurs
│   ├── .current/        # Capitaine actuel
│   └── */               # Données par joueur
│       ├── secret.dunikey
│       ├── ipfs/        # Stockage IPFS TW personnel
├── nostr/               # Données NOSTR
│   └── */               # Données par MULTIPASS (@, UMAP, ZCARD, ...)
└── tmp/                 # Cache temporaire
│   ├── coucou/          # Cache Metadonnées Profil : .COINS, .primal, .2nd, .cesium, .gchange, ...
│   ├── ${IPFSNODEID]/   # Balise IPNS de la Station
│   ├── swarm/           # Capture des balises des stations de l'essaim

2. Système de Cache

• Cache Local : ~/.zen/tmp/ pour les données temporaires

• Cache IPFS : Stockage local IPFS du TW de la ZenCard

• Cache NOSTR : Stockage local + synchro N² des événements NOSTR

3. Synchronisation

• Synchronisation Swarm : Partage des données entre stations UPlanet

• Publication IPNS : Mise à jour des références IPNS

• Cache Invalidation : Gestion automatique de l'expiration des caches

---

🔌 APIs et Services

1. API Gateway (Port 1234) - script example zone - you can break it ;)

# Point d'entrée principal
GET /?cmd=action&param=value

# Redirection vers ports dynamiques (45780-90)
# Exécution des services API/

2. Station Map (Port 12345) - /12345 ssl mapping (Node Swarm Info)

# Cartographie des stations UPlanet
GET / - Interface de cartographie
Données JSON des stations

3. UPassport API (Port 54321) - u. ssl mapping - (Production API)

# API d'identité numérique
POST /api/upload - Upload de fichiers vers IPFS
POST /api/delete - Suppression de fichiers
GET /api/test-nostr - Test d'authentification NOSTR

---

🔧 Maintenance et Monitoring

1. Maintenance Quotidienne (20h12.process.sh) - evolutive

# Vérification IPFS
check_ipfs_status

# Nettoyage cache
cleanup_temp_files

# Sauvegarde caches critiques
backup_critical_caches

# Mise à jour code
update_code

# Redémarrage services
restart_services

# Analyse système
system_analysis

# Rapport email
send_maintenance_report

2. Monitoring Système - work in progress

• heartbox_analysis.sh : Analyse complète du système

• heartbox_control.sh : Contrôle et gestion du système

• heartbox_prometheus_analysis.sh : Métriques Prometheus

3. Logs et Debugging

• Logs UPassport API : journalctl -fu upassport

• Logs NOSTR : ~/.zen/tmp/nostr_*.log

• Logs UPlanet : ~/.zen/tmp/uplanet_*.log

• Logs IA : ~/.zen/tmp/IA.log

---

🚀 Déploiement

1. Installation Automatique

# Installation complète
bash <(curl -sL https://install.astroport.com)

# Ou installation manuelle
git clone https://github.com/papiche/Astroport.ONE.git ~/.zen/Astroport.ONE
cd ~/.zen/Astroport.ONE
./install.sh

2. Configuration Système - automatiquemet réalisé par install -

# Configuration IPFS
~/.zen/Astroport.ONE/ipfs_setup.sh

# Configuration RELAI NOSTR (strfry)
~/.zen/workspace/NIP-101/setup.sh

# Configuration UPassport
~/.zen/Astroport.ONE/install_upassport.sh

3. Services Systemd

# Service Astroport
sudo systemctl enable astroport
sudo systemctl start astroport

# Service UPassport
sudo systemctl enable upassport
sudo systemctl start upassport

# Service NOSTR Relay
sudo systemctl enable strfry
sudo systemctl start strfry

---

🤖 Intégration NOSTR

1. Relay NOSTR (Port 7777)

Astroport.ONE utilise un relay NOSTR dédié avec des filtres personnalisés pour :

• Authentification NIP-42 : Vérification des identités

• IA Contextuelle : Réponses automatiques avec #BRO

• Géolocalisation : Messages liés aux coordonnées GPS

• Mémoire Privée : Stockage contrôlé avec #rec

• Événements Vidéo (NIP-71) : Support pour kind 21/22 (vidéos normales/courtes)

2. Nostr Tube - Plateforme Vidéo Décentralisée

Astroport.ONE intègre Nostr Tube, une alternative décentralisée à YouTube utilisant :

• NIP-71 : Événements vidéo (kind 21/22) avec métadonnées complètes

• IPFS : Stockage décentralisé des vidéos et miniatures

• NIP-51 : Playlists (kind 10001) pour les collections vidéo

• NIP-25 : Réactions (kind 7) pour les likes et commentaires

• UMAP : Ancrage géographique des vidéos (tags g, latitude, longitude)

Composants :

• Route /youtube : Interface de découverte et lecture

• Route /theater : Mode théâtre immersif avec commentaires en direct

• Route /playlist : Gestionnaire de playlists

• Scripts IA : Synchronisation YouTube (youtube.com.sh), traitement vidéo (process_youtube.sh)

Voir docs/README.NostrTube.md pour la documentation complète.

3. Filtres Personnalisés

# Filtre principal (all_but_blacklist.sh)
# Accepte tous les événements sauf ceux de la blacklist

# Filtre kind 1 (filter/1.sh)
# Gestion des messages texte avec IA et mémoire

# Filtre kind 21/22 (vidéos)
# Support pour les événements vidéo NIP-71

4. Système de Mémoire

• Mémoire Utilisateur : ~/.zen/tmp/flashmem/uplanet_memory/pubkey/{pubkey}.json

• Mémoire UMAP : ~/.zen/tmp/flashmem/uplanet_memory/{latitude}_{longitude}.json

• Contrôle Privé : Tag #rec requis pour stockage

---

🛡️ Système UPassport

1. API d'Identité Numérique (Port 54321)

UPassport fournit une API complète pour :

• Gestion d'Identité : Création et gestion des UPassports

• Stockage IPFS : Upload et gestion de fichiers décentralisés

• Intégration NOSTR : Authentification et gestion des cartes NOSTR

• Intégration Ğ1 : Vérification de solde et transactions

2. Authentification NIP-42

# Test d'authentification
curl -X POST http://localhost:54321/api/test-nostr \
  -F "npub=npub1..."

# Upload avec authentification
curl -F "file=@photo.jpg" \
     -F "npub=npub1..." \
     http://localhost:54321/api/upload

---

🔗 Liens et Ressources

Documentation

• README.md - Introduction principale

• WELCOME.md - Guide écosystème UPlanet

• UPASSPORT_API.md - Documentation API UPassport

• API.NOSTRAuth.readme.md - Documentation NOSTR

• docs/README.NostrTube.md - Documentation Nostr Tube (plateforme vidéo décentralisée)

Ressources Externes

• GitHub Repository - Code source

• Open Collective - Support financier

• Documentation GitBook - Guide utilisateur

Contact

• Email : [e-mail]

• Site Web : https://astroport.com

• Communauté : https://copylaradio.com

---

Astroport.ONE : L'architecture décentralisée pour un Internet libre et souverain 🌍✨