{"record":{"id":"446b30ab4b54ef7b","repo":"FuelLabs/fuels-ts","slug":"version-fuelcoreversion-not-found-n-at-p","errorCode":null,"errorMessage":"Version '${fuelCoreVersion}' not found\\n    at ${pkgUrl}","messagePattern":"Version '(.+?)' not found\\\\n    at (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"internal/fuel-core/lib/install.js","lineNumber":64,"sourceCode":"    versionMatches = binVersion === fuelCoreVersion;\n    info({\n      expected: fuelCoreVersion,\n      received: binVersion,\n      isGitBranch: isGitBranch(fuelCoreVersion),\n    });\n  }\n\n  if (versionMatches) {\n    info(`fuel-core binary already installed, skipping.`);\n  } else {\n    // Empty the `fuel-core-binaries` directory if it exists\n    rmSync(binDir, { recursive: true, force: true });\n\n    // Download\n    const buf = await fetch(pkgUrl).then((r) => r.buffer());\n\n    if (/not found/i.test(buf.toString())) {\n      throw new Error(`Version '${fuelCoreVersion}' not found\\n    at ${pkgUrl}`);\n    }\n\n    writeFileSync(pkgPath, buf);\n\n    // Extract\n    spawnSync('tar', ['xzf', pkgPath, '-C', rootDir]);\n\n    // Take the contents of the directory containing the extracted\n    // binaries and move them to the `fuel-core-binaries` directory\n    renameSync(`${fileName}`, binDir);\n    cpSync(versionFilePath, binVersionPath);\n\n    // Cleanup\n    rmSync(fileName, {\n      recursive: true,\n      force: true,\n    });\n    rmSync(pkgPath);","sourceCodeStart":46,"sourceCodeEnd":82,"githubUrl":"https://github.com/FuelLabs/fuels-ts/blob/b3f37c91aca4aa9d5e4c0d3967f66237190826ea/internal/fuel-core/lib/install.js#L46-L82","documentation":"Thrown by the fuel-core binary install script when the body fetched from `https://github.com/FuelLabs/fuel-core/releases/download/v<version>/<pkg>` contains 'not found' (GitHub's 404 body). The `fuelCoreVersion` is read from `internal/fuel-core/VERSION`. Mirrors the forc installer's check and runs during the fuel-core postinstall.","triggerScenarios":"The `internal/fuel-core/VERSION` pin references a fuel-core tag that lacks a `fuel-core-<version>-<platform>.tar.gz` asset; a fork pinned an unreleased version; a proxy returns a 404 HTML page that satisfies the `/not found/i` test.","commonSituations":"Upgrading fuels to a commit whose VERSION references an unreleased fuel-core; platform asset missing for `aarch64-unknown-linux-gnu`; transient GitHub release/publishing delay right after a tag.","solutions":["Verify `internal/fuel-core/VERSION` and confirm the `fuel-core-<version>-<platform>.tar.gz` asset exists at the corresponding GitHub release page.","Bump or downgrade fuels to a release whose pinned fuel-core version ships assets for your platform.","Switch VERSION to `git:<branch>` to build fuel-core from source via `buildFromGitBranch`.","Route the install through a proxy/mirror that can actually reach GitHub release assets and returns the real tarball bytes."],"exampleFix":"// before: internal/fuel-core/VERSION\n0.40.0\n// after: pin to a tag with the asset, or build from source\ngit:master","handlingStrategy":"validation","validationCode":"import { getCurrentVersion, getPkgPlatform } from './shared.js';\nconst version = getCurrentVersion().trim();\nconst platform = getPkgPlatform();\nconst url = `https://github.com/FuelLabs/fuel-core/releases/download/v${version}/fuel-core-${version}-${platform}.tar.gz`;\nconst ok = await fetch(url, { method: 'HEAD' }).then((r) => r.status === 200);\nif (!ok) throw new Error(`fuel-core ${version} asset not found at ${url}`);","typeGuard":null,"tryCatchPattern":"try {\n  // run the installer\n} catch (e) {\n  if (/Version '.*' not found/.test(e.message)) {\n    console.error('Pinned fuel-core version has no GitHub release asset for this platform. Edit internal/fuel-core/VERSION or build via git:<branch>.');\n  }\n  throw e;\n}","preventionTips":["Pin `internal/fuel-core/VERSION` only to tags that publish all platform assets.","Add a CI pre-check that HEADs the asset URL.","Use `git:<branch>` to build fuel-core from source when iterating on unreleased versions."],"tags":["install","fuel-core","toolchain","network","version-mismatch"],"backgroundTag":null,"analyzedSha":"b3f37c91aca4aa9d5e4c0d3967f66237190826ea","analyzedAt":"2026-08-12T20:30:56.448Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}