{"record":{"id":"fbff84b27cfc9085","repo":"FuelLabs/fuels-ts","slug":"unsupported-arch-process-arch-fbff84","errorCode":null,"errorMessage":"Unsupported arch ${process.arch}","messagePattern":"Unsupported arch (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"internal/fuel-core/lib/shared.js","lineNumber":40,"sourceCode":"    arm64: 'aarch64-apple-darwin',\n    x64: 'x86_64-apple-darwin',\n  },\n  linux: {\n    arm64: 'aarch64-unknown-linux-gnu',\n    x64: 'x86_64-unknown-linux-gnu',\n  },\n};\n\nexport const getPkgPlatform = () => {\n  if (process.platform !== 'darwin' && process.platform !== 'linux') {\n    throw new Error(\n      `Unsupported platform ${process.platform}.${\n        process.platform === 'win32' ? ' If you are on Windows, please use WSL.' : ''\n      }`\n    );\n  }\n  if (process.arch !== 'arm64' && process.arch !== 'x64') {\n    throw new Error(`Unsupported arch ${process.arch}`);\n  }\n  return platforms[process.platform][process.arch];\n};\n\nexport const versionFilePath = join(__dirname, '../VERSION');\n\nexport const getCurrentVersion = () => {\n  const fuelCoreVersion = readFileSync(versionFilePath, 'utf8');\n  return fuelCoreVersion.trim();\n};\n\nexport const setCurrentVersion = (version) => {\n  writeFileSync(versionFilePath, version);\n};\n\nexport const isGitBranch = (versionFileContents) => versionFileContents.indexOf('git:') !== -1;\n\nconst fuelCoreRepoUrl = 'https://github.com/fuellabs/fuel-core.git';","sourceCodeStart":22,"sourceCodeEnd":58,"githubUrl":"https://github.com/FuelLabs/fuels-ts/blob/b3f37c91aca4aa9d5e4c0d3967f66237190826ea/internal/fuel-core/lib/shared.js#L22-L58","documentation":"Thrown by `getPkgPlatform()` in the fuel-core installer when `process.arch` is not `arm64` or `x64`. The published fuel-core binaries target only aarch64 and x86_64.","triggerScenarios":"Running on `ia32`, `arm`/`armv7l`, `mips`, `riscv64`, or any other architecture outside {arm64, x64}.","commonSituations":"32-bit Node.js builds on 64-bit hosts; embedded boards on 32-bit ARM; uncommon-arch CI emulators.","solutions":["Install a 64-bit Node.js build (`x64` or `arm64`) matching the host CPU.","On 32-bit ARM boards, move to a 64-bit kernel/userland.","Build fuel-core from source via `git:<branch>` in VERSION and extend the `platforms` map if you need a new arch."],"exampleFix":"// before\n$ node -p process.arch\narmv7l\n// after: use a 64-bit capable image/board, then\n$ node -p process.arch\narm64","handlingStrategy":"validation","validationCode":"const SUPPORTED_ARCHS = new Set(['arm64', 'x64']);\nif (!SUPPORTED_ARCHS.has(process.arch)) {\n  throw new Error(`Refusing to install fuel-core on arch ${process.arch}; use x64 or arm64 Node.js.`);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Install 64-bit Node.js (`x64`/`arm64`).","Pin CI runners to supported archs.","Build fuel-core from source via `git:<branch>` for unsupported archs."],"tags":["install","fuel-core","architecture","environment"],"backgroundTag":null,"analyzedSha":"b3f37c91aca4aa9d5e4c0d3967f66237190826ea","analyzedAt":"2026-08-12T20:30:56.448Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}