feat: allow for multiple keys in snap_getState

[hmalik88]

Description

Updates snap_getState to accept an array of keys in the key parameter, allowing a Snap to fetch multiple state values in a single call.

Before

// Only one key at a time
const value = await snap.request({
  method: 'snap_getState',
  params: { key: 'user.name' },
});
// → "Alice"

After

// Multiple keys in one call
const values = await snap.request({
  method: 'snap_getState',
  params: { key: ['user.name', 'user.age', 'settings.theme'] },
});
// → { 'user.name': 'Alice', 'user.age': 42, 'settings.theme': 'dark' }

Behavior

• When key is a string[], the result is a Record<string, Json> mapping each key to its resolved value. Keys not found in state map to null.
• All existing validation rules apply to each element in the array (dot-path syntax, forbidden keys).

---

Note

Medium Risk
Changes permitted state-read RPC and validation for encrypted Snap storage, but behavior is additive and reuses existing single-key lookup and security checks.

Overview
Extends snap_getState so params.key can be a string[], not just a single path. With an array, the RPC returns a Record<string, Json> keyed by each requested path; paths that are missing resolve to null. Single-key and whole-state behavior is unchanged.

Implementation updates get() in getState.ts to map over array keys (including empty array → {}), adds StateKeysStruct validation, and keeps existing dot-path and forbidden-segment rules per element. GetStateParams in the SDK is updated accordingly.

Example Snap, RPC tests, manage-state integration tests, and the test-snaps GetState UI (comma-separated keys) exercise the new behavior; changelogs note the addition.

^{Reviewed by Cursor Bugbot for commit 7ab29d5. Bugbot is set up for automated code reviews on this repo. Configure here.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.59%. Comparing base (2c8a299) to head (7ab29d5).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4125   +/-   ##
=======================================
  Coverage   98.59%   98.59%           
=======================================
  Files         429      429           
  Lines       12495    12498    +3     
  Branches     1976     1977    +1     
=======================================
+ Hits        12320    12323    +3     
  Misses        175      175           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[FrederikBolding]

Can we use a selective union so we get better error messaging? We can branch on isArray()

[FrederikBolding]

I can't remember why we chose to use a classic loop below, this will likely be slower. Can you @Mrtenz