[IPFS] IPNS resolution failed for ${ipnsName} on all gateway

Error message

[IPFS] IPNS resolution failed for ${ipnsName} on all gateways

What it means

Final log warning in resolveIPNS: every configured public gateway was tried and none resolved the IPNS name to a CID (per-gateway failures were logged individually); the function returns null so callers fall back to cached/other discovery.

Source

Thrown at v3/@claude-flow/cli/src/transfer/ipfs/client.ts:122

          if (cidMatch) {
            cid = cidMatch[1];
          }
        }
      }

      if (cid) {
        const latency = Date.now() - startTime;
        console.log(`[IPFS] Resolved ${ipnsName} -> ${cid} via ${gateway} (${latency}ms)`);
        return cid;
      }
    } catch (error) {
      const errorMsg = error instanceof Error ? error.message : String(error);
      console.warn(`[IPFS] Gateway ${gateway} failed: ${errorMsg}`);
      continue;
    }
  }

  console.warn(`[IPFS] IPNS resolution failed for ${ipnsName} on all gateways`);
  return null;
}

/**
 * Fetch content from IPFS by CID with fallback across multiple gateways
 *
 * @param cid - Content Identifier
 * @param preferredGateway - Optional preferred gateway to try first
 * @returns Parsed JSON content or null if fetch fails
 */
export async function fetchFromIPFS<T>(
  cid: string,
  preferredGateway?: string
): Promise<T | null> {
  if (!isValidCID(cid)) return null;
  const gateways = preferredGateway
    ? [preferredGateway, ...IPFS_GATEWAYS.filter(g => g !== preferredGateway)]
    : IPFS_GATEWAYS;

View on GitHub (pinned to fa13ee4ad6)

Solutions

Verify the IPNS name is correct and published, and that at least one gateway is reachable; publish the record again if it expired.

Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/transfer/ipfs/client.ts:122 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/d652adc9a4017d3a. Report an issue: GitHub.