TajNet
Documentation

Introduction

TajNet est un nœud souverain qui combine stockage IPFS, micro-paiements Tajcoin et un panel web pour publier, annoncer et monétiser du contenu sans cloud centralisé.

Démarrage rapide

Installation locale

git clone <url-du-depot> tajnet
cd tajnet
cp .env.example .env
docker compose up -d --build

Accès aux interfaces

Accès distant (tunnel SSH)

ssh -N -L 8090:127.0.0.1:8090 user@serveur
# Puis : http://localhost:8090

État du nœud

Données en direct depuis GET /api/status (rafraîchi toutes les 20 s).

Architecture

Le moteur core/bridge.js orchestre les services et expose l'API REST.

Structure du dépôt

tajnet/
├── core/              Moteur Express (bridge.js, lib/, routes/)
├── panel/
│   ├── landing/       Page d'accueil (/) — doc (full) ou thèmes (public)
│   │   ├── themes/    Thèmes music · heritage (édition public)
│   │   └── presets/   Profils JSON (lastfm, raspberry, …)
│   ├── src/           TajPanel (/panel/)
│   ├── editor/        Éditeur GrapesJS
│   ├── futuremen/     Futuremen HQ — chronique Discover live
│   ├── view/          Fiche contenu
│   └── wallet/        Wallet UI
├── data/              Persistance (Discover, pins, metrics, landing)
├── plugins/           Extensions (super-cv, bran-web)
├── scripts/           deploy-vps.sh, deploy-public-node.sh, enable-vps-domain.sh
└── docker-compose.yml

Interfaces & URLs

Headers HTTP utiles

Page d'accueil & thèmes

La route / sert une page HTML selon l'édition du nœud et le champ theme du profil landing (data/landing/profile.json).

Thèmes landing (édition public)

Si theme vaut music ou heritage, le core sert panel/landing/themes/<theme>/index.html au lieu de la doc ou de la landing i18n générique.

Appliquer un preset

# Sur le nœud cible (localhost ou via deploy-public-node.sh)
./scripts/apply-landing-preset.sh lastfm
./scripts/apply-landing-preset.sh raspberry [data_dir]

Le déploiement public applique automatiquement le preset selon le slug du fichier credentials (secrets/nodes/lastfm.env → thème music, etc.).

Personnalisation

• Panel → Administration opérateur → Page d'accueil (localhost / tunnel SSH)
• API : GET /api/landing/profile · PUT /api/landing/profile (localhost)
• Champs clés : nodeName, heroTitle, primaryCtaUrl, theme, agents[]

Zones réseau & sécurité

Détection par IP client dans core/lib/request-local.js : localhost, lan (RFC1918) ou wan.

* Sauf WALLET_LOCAL_LAN=true (dev uniquement).

Variables réseau

Économie contenu

Quatre profils complémentaires autour du contenu épinglé sur le nœud. Un même acteur peut en cumuler plusieurs — par exemple un hébergeur qui crée son contenu, stake dessus pour le mettre en avant et perçoit à long terme les parts créateur, hébergeur et investisseur.

Score contenu

Indicateur interne (visites, soutiens payants, réclamants). Alimente le rendement staking et le classement Discover.

Ratio de valorisation (boostScore = score ÷ vues) : TajNet met en avant les contenus les mieux valorisés par rapport à leur audience — un créateur-hébergeur qui investit sur son propre contenu peut remonter même avec peu de vues initiales.

Mise en avant Discover

Tri : d'abord cagnottes / réclamations disponibles, puis boostScore décroissant, puis hauteur de bloc.

Compteur de vues

• +1 sur fiche /view/resolve
• +1 sur accès direct gateway /ipfs/<CID> (hors iframe aperçu)
• recordViewer n'incrémente pas les vues (attestation MetaMask seulement)

Répartition des revenus (0,5 TAJ)

Chaque réclamation depuis la cagnotte distribue 0,5 TAJ en quatre parts égales. Les contributeurs donateurs (don pinning) alimentent cette cagnotte — ce ne sont pas les bénéficiaires de la part « créateur ».

Éligibilité réclamation

1. Contenu épinglé localement (getLocalPin)
2. Adresse a consulté le contenu (hasViewer)
3. Cagnotte ≥ 0,5 TAJ
4. Pas déjà réclamé pour cette adresse

Futuremen HQ — chronique live

Page corporate (timeline 2047, Michael & Olga) qui agrège le corpus Discover en direct depuis le nœud local et les nœuds partenaires (FUTUREMEN_NODE_URLS). Disponible uniquement en édition full (ex. tajnet.cloud/futuremen/).

Interface

• Organigramme des 11 agents Futuremen (portraits officiels du siège)
• Chronique triée par boostScore — badges nœud source, filtres par source
• Recherche client-side (titre, description, nœud, CID, protocole, type) — tokens multiples
• Pagination — 12 transmissions par page, navigation Précédent / Suivant
• Liens vers Documentation (/) et TajPanel (/panel/) dans la nav, le hero et le footer
• Liens fiche vers /view?txid=… sur l'origine publique (FUTUREMEN_PUBLIC_ORIGIN)
• Bouton Rafraîchir — recharge le flux sans redéployer
• Mobile : barre corporate masquée ; accès Docs / TajPanel conservé
• Liens GitHub discrets en pied de page uniquement (tajnet-public, Taj-Coin)
• Tracking Matomo injecté (MATOMO_PUBLIC_URL ou {DISCOVER_NODE_ENDPOINT}/matomo/)

Configuration multi-nœuds

FUTUREMEN_NODE_URLS=https://tajnet.cloud|São Paulo,http://127.0.0.1:8090|localhost
FUTUREMEN_PUBLIC_ORIGIN=https://tajnet.cloud

API — Système & statut

Champs notables de /api/status

API — IPFS & publication

Flux annonce : metadata JSON sur IPFS → transaction OP_RETURN (TAJ + type + CID).

API — Discover

API — Staking & métriques

Content metrics — /api/content-metrics/

Content staking — /api/content-staking/

Périodes : 1 mois (×1,0), 3 mois (×1,15), 6 mois (×1,35), 12 mois (×1,6). Min. STAKE_MIN_TAJ (défaut 1 TAJ).

API — Paiements & Guard

Guard — /api/guard/

Pin service — /api/pin-service/

Paiements unifiés — /api/payments/

Pin rewards — /api/pin-rewards/

API — Wallet & admin opérateur

Wallet MetaMask — /api/wallet/

Admin localhost — /api/tajcoin/wallet/ & peers

Variables d'environnement

Fichier modèle : .env.example. Principales variables :

Docker & VPS

Éditions & scripts

Credentials nœuds : secrets/nodes/<nom>.env (hors Git) — voir secrets/README.md.

Trois modes Docker courants

VPS public

# .env sur le serveur
TAJNODE_MODE=vps
TRUST_PROXY=1
TLS_ENABLED=true
TLS_PORT=443

# Déploiement (Discover activé sur le VPS)
./scripts/deploy-vps.sh saopaulo.env
./scripts/enable-vps-domain.sh saopaulo.env tajnet.cloud admin@tajnet.cloud
./scripts/enable-vps-tls.sh saopaulo.env   # alternative : IP seule, certificat auto-signé

TLS & Matomo

HTTPS

Génération : ./scripts/generate-tls-cert.sh — empreinte dans /api/status → tls.

Production (Let's Encrypt)

Nœud de référence : Nginx termine le TLS sur :443, TajNet core en HTTP sur :8090, TRUST_PROXY=1, DISCOVER_NODE_ENDPOINT=https://tajnet.cloud.

Matomo

• Interne : MATOMO_URL + MATOMO_HOST_PORT (8888 local, souvent 8877 sur VPS)
• Public : MATOMO_PUBLIC_URL → https://domaine/matomo/
• Proxy panel : /matomo/ — tracking WAN autorisé ; admin bloqué sur Internet
• Pages trackées : publish éditeur, /futuremen/, Bran Web publish
• Snippet fiable : TajPanel → Publication → Matomo, ou /api/status → matomo.trackingSnippet
• Accès admin : tunnel SSH — le port Matomo est dans MATOMO_HOST_PORT (affiché en fin de deploy-vps.sh)

# Vérifier le port sur le VPS :
grep MATOMO_HOST_PORT /opt/tajnet/.env

# Tunnel (exemple port 8877) :
ssh -N -L 8090:127.0.0.1:8090 -L 8877:127.0.0.1:8877 user@serveur

Ressources