childstate_getStorageEntries - Bittensor RPC Method
Read multiple child storage values by key on Bittensor in a single request.
Returns the values for multiple child storage keys in a single request. This is the batch equivalent of childstate_getStorage and is useful when you need to read several entries from a child trie efficiently without making individual RPC calls for each key.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
childStorageKey | string | Yes | Hex-encoded key identifying the child trie root. |
keys | array | Yes | Array of hex-encoded storage keys to read from the child trie. |
blockHash | string | No | Hex-encoded block hash. Defaults to the best block if omitted. |
Response
| Field | Type | Description |
|---|---|---|
result | array | Array of hex-encoded SCALE-encoded values, in the same order as the input keys. null for keys that do not exist. |
Code Examples
Use Cases
- Batch child state reads -- Efficiently read multiple values from a child trie (e.g. contract storage slots) in one round-trip.
- Snapshot tooling -- Export multiple child storage entries at a specific block for state snapshots or migrations.
- Data aggregation -- Collect multiple related values from a pallet's child storage for dashboards or analytics.
Notes
- Child tries are used by pallets that isolate their storage (e.g. smart contracts on the EVM layer). Most standard Substrate storage lives in the main trie.
- Values are SCALE-encoded and must be decoded according to the pallet's storage type definitions.
- If the child trie does not exist, all entries will be
null.
Related Methods
childstate_getStorage-- Read a single value from child storagechildstate_getKeysPagedAt-- Enumerate child storage keys with paginationchildstate_getStorageSize-- Get the byte size of a child storage valuestate_getStorage-- Read from the main state trie