meta-transport-ipfs 1.0.0: ipfs tier split out of meta-share

2026-10-03 15:43:58 +00:00
parent f6dfbc49ce
commit eb21c607d4
35 changed files with 12867 additions and 1 deletions
@@ -1 +1,37 @@
-# meta-transport-ipfs
+# meta-transport-ipfs
+
+meta-share's **IPFS tier** as a transport plugin (`meta_feeder_sdk::transport`).
+
+- The libp2p host: identify + kad (client) + mdns + bitswap (`beetswap`,
+  `MAX_MULTIHASH_SIZE = 64`), on `P2P_LISTEN` (4001 — publish it; `PUBLIC_ADDR`
+  announces it). Identify carries the **hull's** `baseUrl`, so peers keep calling
+  meta-share's public API.
+- The blockstore (`<data>/ipfs/blocks.redb`): material blocks + **leaf refs into
+  files** (meta-core library files over WebDAV / a local `/files` mount, and cache
+  containers on the shared volume) — one copy on disk.
+- Bitswap ingress: big dag-pb fetches land in `tmp/<cid>/` and are renamed into
+  `cache/`; a genuine play commits them to a background fill.
+- Gateway discovery (identify `gateways=` → `GET {baseUrl}/api/gateway/plugins`),
+  exposed to the hull as `/ipfs-tier/directory`.
+- Serves the public `/ipfs/:cid` gateway (relayed by the hull) and the hull's
+  `/ipfs-tier/*` facade.
+
+## Configuration
+
+meta-share's variables, unchanged: `P2P_LISTEN`, `PUBLIC_ADDR`, `KAD_*`,
+`BOOTSTRAP_PEERS`, `ENABLE_MDNS`, `TARGET_PEER_COUNT`, `META_SHARE_MAX_CONNS`,
+`META_SHARE_BLOCKSTORE_CACHE_MB`, `META_SHARE_INGRESS_*`,
+`META_SHARE_LOOSE_BLOCK_MAX_BYTES`, `META_SHARE_LOCAL_FILES_PATH`,
+`META_SHARE_FILES_PATH`, `META_SHARE_SEED_DHT_PROVIDE`, `META_SHARE_DATA`, plus
+`META_SHARE_HULL_URL`. `meta_core_url` / `peer_url` come from the hull's
+`settings.json` (mount `/config` read-only), env as the first-boot fallback.
+
+Start it **after** the hull is healthy: the hull migrates its material index out
+of `ipfs/blocks.redb` on its first boot after the split (redb is single-process).
+
+## Build
+
+```bash
+docker build -t meta-transport-ipfs .
+docker build --build-context sdk=../meta-feeder-sdk -t meta-transport-ipfs .
+```