ruvnet/ruflo · error

[Discovery] IPNS resolution via ${gateway} failed:

Error message

[Discovery] IPNS resolution via ${gateway} failed:

What it means

Log warning in resolveIPNS (discovery): resolving the IPNS name through one public gateway threw; the method logs the gateway error and continues trying the remaining gateways.

Source

Thrown at v3/@claude-flow/cli/src/transfer/store/discovery.ts:205

          // Extract CID from final URL if redirected
          const finalUrl = ipnsResponse.url;
          const cidMatch = finalUrl.match(/\/ipfs\/([a-zA-Z0-9]+)/);
          if (cidMatch) {
            const cid = cidMatch[1];
            const resolution: IPNSResolution = {
              ipnsName,
              cid,
              resolvedAt: new Date().toISOString(),
              expiresAt: new Date(Date.now() + 3600000).toISOString(),
            };

            this.ipnsCache.set(ipnsName, resolution);
            console.log(`[Discovery] Resolved IPNS via redirect to CID: ${cid}`);
            return resolution;
          }
        }
      } catch (error) {
        console.warn(`[Discovery] IPNS resolution via ${gateway} failed:`, error);
        // Continue to next gateway
      }
    }

    // Fallback: Generate deterministic CID for well-known registries
    console.warn(`⚠ [Discovery] OFFLINE MODE - Could not resolve IPNS: ${ipnsName}`);
    console.warn(`⚠ [Discovery] Using built-in fallback registry (may be outdated)`);
    const fallbackCid = this.generateFallbackCID(ipnsName);
    const resolution: IPNSResolution = {
      ipnsName,
      cid: fallbackCid,
      resolvedAt: new Date().toISOString(),
      expiresAt: new Date(Date.now() + 3600000).toISOString(),
    };

    this.ipnsCache.set(ipnsName, resolution);
    return resolution;
  }

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the gateway-specific error; other gateways are tried automatically, so persistent failure across all gateways indicates an invalid IPNS name or network issue.

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/transfer/store/discovery.ts:205 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/a0cfc131fa3f8e5f. Report an issue: GitHub.