ISBP - IPFS Station Beacon Protocol

Version: 1.0
License: AGPL-3.0
Authors: UPlanet ẐEN Community

ISBP is a simple, elegant protocol for IPFS node auto-discovery using standardized JSON beacons published on port 12345. It enables decentralized swarm formation without central coordination.

• Simple HTTP beacon on port 12345
• Twin cryptographic keys (SSH/IPFS/Duniter/Nostr) from single seed
• Transitive discovery via bootstrap nodes
• Cryptographic identity verification (G1PUB ↔ IPFSNODEID binding)
• Self-organizing swarm with hourly synchronization

# 1. Generate twin keys from salt/pepper
./tools/keygen -t ipfs "mysalt" "mypepper"    # IPFS PeerID
./tools/keygen -t duniter "mysalt" "mypepper" # G1 Wallet
./tools/keygen -t ssh "mysalt" "mypepper"     # SSH Key
./tools/keygen -t nostr "mysalt" "mypepper"   # Nostr npub/nsec

# 2. Start beacon
./beacon.sh

# 3. Query any node
curl http://node-ip:12345/

Detailed usage guide: docs/HOWTO_USE.md

{
  "version": "1.0",
  "created": "20260126120000",
  "ipfsnodeid": "12D3KooW...",
  "g1pub": "DsEx1pS...",
  "g1station": "/ipns/12D3KooW...",
  "g1swarm": "/ipns/QmSwarm...",
  "swarm_members": 5,
  "myIP": "1.2.3.4",
  "hostname": "my-station",
  "services": {
    "ipfs": { "active": true },
    "beacon": { "active": true, "port": 12345 }
  }
}

Each node publishes TWO IPNS addresses:

The g1swarm IPNS key is deterministically derived from:

SECRET1 = SHA512(machine_identity)  # CPU info or hostname
SECRET2 = IPFSNODEID
KEY = keygen -t ipfs "${SECRET1}" "${SECRET2}"

This ensures:

• Each node has a unique swarm key
• The key is reproducible (survives restarts)
• The key cannot be forged by other nodes

When a node contacts another node's beacon, it can trigger mutual discovery:

GET /:12345/?{G1PUB}={IPFSNODEID}

Validation:

1. Server converts G1PUB to IPFS PeerID using g1_to_ipfs.py
2. Verifies result matches provided IPFSNODEID
3. If valid, downloads /ipns/{IPFSNODEID}/ to local swarm cache

    NEW_NODE                    BOOTSTRAP                  EXISTING_NODE
        │                           │                            │
        │──(1) GET :12345/─────────▶│                            │
        │◀── beacon.json ───────────│                            │
        │                           │                            │
        │──(2) GET /?G1PUB=IPFSID──▶│                            │
        │                           │──(3) ipfs get /ipns/NEW/──▶│
        │                           │     (adds to swarm)        │
        │                           │                            │
        │──(4) ipfs get /ipns/EXISTING/─────────────────────────▶│
        │◀── beacon data ────────────────────────────────────────│
        │                           │                            │

All keys are derived from a single seed (SALT + PEPPER) using NaCl/libsodium:

                    SALT + PEPPER
                         │
                    ┌────┴────┐
                    │ scrypt  │
                    │ KDF     │
                    └────┬────┘
                         │
                    ED25519 SEED
                         │
         ┌───────┬───────┼───────┬───────┐
         │       │       │       │       │
        SSH    IPFS   Duniter  Nostr  Bitcoin
       ed25519 PeerID   G1PUB   npub    WIF

# IPFS PeerID → G1 Public Key
ipfs_to_g1.py 12D3KooWxxxxxx  # → DsEx1pS...

# G1 Public Key → IPFS PeerID  
g1_to_ipfs.py DsEx1pSxxxxxx   # → 12D3KooW...

Inspired by quantum entanglement, nodes can operate at different commitment levels:

# Activate Y-Level (twin SSH/IPFS identity)
./tools/ylevel.sh

This creates cryptographic entanglement where:

• SSH public key derives IPFS PeerID
• Same seed generates all protocol keys
• Enables secure P2P tunneling via ipfs p2p

Bootstrap nodes are listed in bootstrap.txt:

# Format: /ip4/{IP}/tcp/4001/p2p/{IPFSNODEID}
/ip4/149.102.158.67/tcp/4001/p2p/12D3KooWL2FcDJ41U9SyLuvDmA5qGzyoaj2RoEHiJPpCvY8jvx9u

For nodes with DNS names, map /12345/ to the beacon port:

Nginx:

location /12345/ {
    proxy_pass http://127.0.0.1:12345/;
}

Caddy:

handle_path /12345/* {
    reverse_proxy localhost:12345
}

1. Cryptographic binding: G1PUB must cryptographically derive to IPFSNODEID
2. Network isolation: Only nodes with same UPLANETG1PUB join the swarm
3. Stale node removal: Nodes silent for >3 days are pruned from swarm
4. No secrets in beacon: Only public identifiers are exposed

ISBP-spec/
├── README.md               # This specification
├── beacon.sh               # Simplified beacon server (port 12345)
├── bootstrap.txt           # Bootstrap node list
├── requirements.txt        # Python dependencies
├── LICENSE                 # GPL-3.0
│
├── docs/
│   └── ZEN_ECONOMY.md      # UPlanet ẐEN economic model
│
├── tools/
│   ├── keygen              # Multi-format key generator
│   ├── keygen.readme.md    # Keygen documentation
│   ├── ipfs_to_g1.py       # IPFS PeerID → G1 converter
│   ├── g1_to_ipfs.py       # G1 → IPFS PeerID converter
│   ├── ylevel.sh           # Y-Level activation (twin keys)
│   │
│   │  # UPlanet ẐEN Economy
│   ├── uplanet_init.sh     # Initialize cooperative wallets
│   ├── multipass_create.sh # Create MULTIPASS token (usage)
│   ├── zencard_create.sh   # Create ZEN Card token (contribution)
│   ├── nostrcard_refresh.sh # uDRIVE refresh + fee collection
│   ├── zen_economy.sh      # PAF payments (NODE + CAPTAIN)
│   └── zen_cooperative.sh  # 3x1/3 surplus allocation
│
└── examples/
    ├── query_beacon.sh     # Query a beacon
    ├── join_swarm.sh       # Join a swarm
    └── generate_keys.sh    # Generate twin keys demo

When running, each node maintains:

~/.isbp/
├── beacon.json         # Self beacon (published to /ipns/${IPFSNODEID})
├── .beacon_hash        # Cache for change detection
├── secrets/
│   ├── myswarm.june    # Derivation secrets (SALT/PEPPER)
│   └── myswarm.ipns    # MySwarm IPNS private key
└── swarm/              # Swarm view (published to /ipns/${SWARM_IPNS})
    ├── .size           # Cache for change detection
    ├── 12D3KooW.../    # Data from node A
    │   └── beacon.json
    ├── 12D3KooX.../    # Data from node B
    │   └── beacon.json
    └── ...

The swarm/ directory is published to IPNS via the MySwarm_${IPFSNODEID} key. Other nodes can discover all members by listing /ipns/${g1swarm}/.

ISBP can be extended with the UPlanet ẐEN Economy - a cooperative economic system:

All contributions are distributed equally:

• 33.33% → TREASURY (operating reserve)
• 33.33% → R&D (development)
• 33.34% → ASSETS (real assets)

# Initialize UPlanet economy
./tools/uplanet_init.sh

# Create user MULTIPASS
./tools/multipass_create.sh user@example.com

# Create sponsor ZEN Card
./tools/zencard_create.sh sponsor@example.com satellite

Full documentation: docs/ZEN_ECONOMY.md

The full implementation uses NOSTR as a synchronized signaling layer for economic transparency and swarm coordination:

Each station broadcasts its economic state to the NOSTR constellation:

{
  "kind": 30850,
  "content": {
    "health": {
      "status": "healthy",
      "bilan": 42,
      "weeks_runway": 12
    },
    "wallets": {
      "cash": 420,
      "rnd": 180,
      "assets": 250
    }
  }
}

Payments are distributed across the swarm using solar time sync (20h12 local solar time per station) to prevent concurrent blockchain transactions.

Hierarchical geographic zones with their own twin keys (G1 + NOSTR):

Managed by NOSTR.UMAP.refresh.sh and UPLANET.refresh.sh.

UPlanet implements a GPU HUB + Satellite architecture for distributed AI services:

The UPlanet_IA_Responder.sh script enables AI-powered responses via NOSTR:

Extensive research on decentralized governance mechanisms:

Co-authored territorial documents with community voting (kind 30023):

• Document types: Commons, Projects, Decisions, Gardens, Resources
• Propagation: ≥3 likes → UMAP, ≥6 → SECTOR, ≥12 → REGION

Self-proclaimed masteries with unlimited progression (X1 → X2 → ... → X144+):

• No bootstrap required (starts with 1 signature)
• Competencies revealed progressively via attestations
• NOSTR events: 30500 (definition), 30501 (request), 30502 (attestation), 30503 (credential)

Official permits with peer attestation and NIP-42 authentication.

Dual-mode asset acquisition: Commons donations (CAPITAL) or Cash sales (ASSETS).

Full R&D documentation: See Astroport.ONE/docs/ directory:

• COLLABORATIVE_COMMONS_SYSTEM.md
• WOTX2_SYSTEM.md
• ORACLE_SYSTEM.md
• UPlanet_CROWDFUNDING_CONTRACT.md

Full N² implementation: Astroport.ONE

• Duniter - Libre currency (Ğ1)
• IPFS - InterPlanetary File System
• NOSTR - Notes and Other Stuff Transmitted by Relays

This repository is a basic explanation of the Astroport.ONE & UPlanet ẐEN collaborative Web3 ecosystem.

• Astroport.ONE - Full N² implementation with Ğ1 IPFS NOSTR combination
• UPlanet ORIGIN - Origin of Decentralized ẐEN cooperative networks

AGPL-3.0 - See LICENSE file