Re gen that doc

Author: masih

build/openrpc/v2/full.json

@@ -951,7 +951,7 @@
         {
             "name": "Filecoin.StateSimulate",
             "description": "```go\nfunc (s *FullNodeStruct) StateSimulate(p0 context.Context, p1 []*types.Message, p2 types.TipSetSelector, p3 types.TipSetLimit) (*api.ComputeStateOutput, error) {\n\tif s.Internal.StateSimulate == nil {\n\t\treturn nil, ErrNotSupported\n\t}\n\treturn s.Internal.StateSimulate(p0, p1, p2, p3)\n}\n```",
-            "summary": "",
+            "summary": "StateSimulate computes the state at the specified tipset and applies the provided messages\nusing the network version determined by a TipSetLimit.\n\nThis function:\n- Loads the tipset identified by the TipSetSelector\n- Calculates the complete state by applying all chain messages within that tipset\n- Applies any pending state upgrades up to the epoch determined by TipSetLimit\n- Applies the user-provided messages on top of that state using the network version\n  corresponding to the target epoch\n\nThis function is particularly useful for testing how messages would behave in\nfuture network versions or for simulating execution at specific protocol versions.\n\nThe TipSetLimit parameter controls the simulation target and must specify exactly\none of the following:\n- Height: an absolute chain epoch at which to simulate execution\n- Distance: a relative number of epochs ahead of the selected tipset\n\nFor example, to simulate at exactly epoch 1000, use Height=1000. To simulate\n120 epochs ahead of the selected tipset, use Distance=120.\n\nIf the target epoch determined by TipSetLimit is lower than the tipset's epoch,\nan error will be returned as backward simulation is not supported.\n\nMessages must have the correct nonces and gas values set.\n\nThe TipSetSelector parameter provides flexible options for selecting the base tipset.\nSee StateCompute and TipSetSelector documentation for details on selection options.\n\nExperimental: This API is experimental and may change without notice.\n",
             "paramStructure": "by-position",
             "params": [
                 {

documentation/en/api-v2-unstable-methods.md

@@ -411,9 +411,39 @@ Inputs:
 Response: `"f01234"`
 
 ### StateSimulate
+StateSimulate computes the state at the specified tipset and applies the provided messages
+using the network version determined by a TipSetLimit.
 
+This function:
+- Loads the tipset identified by the TipSetSelector
+- Calculates the complete state by applying all chain messages within that tipset
+- Applies any pending state upgrades up to the epoch determined by TipSetLimit
+- Applies the user-provided messages on top of that state using the network version
+  corresponding to the target epoch
+
+This function is particularly useful for testing how messages would behave in
+future network versions or for simulating execution at specific protocol versions.
+
+The TipSetLimit parameter controls the simulation target and must specify exactly
+one of the following:
+- Height: an absolute chain epoch at which to simulate execution
+- Distance: a relative number of epochs ahead of the selected tipset
+
+For example, to simulate at exactly epoch 1000, use Height=1000. To simulate
+120 epochs ahead of the selected tipset, use Distance=120.
+
+If the target epoch determined by TipSetLimit is lower than the tipset's epoch,
+an error will be returned as backward simulation is not supported.
 
-Perms: 
+Messages must have the correct nonces and gas values set.
+
+The TipSetSelector parameter provides flexible options for selecting the base tipset.
+See StateCompute and TipSetSelector documentation for details on selection options.
+
+Experimental: This API is experimental and may change without notice.
+
+
+Perms: read
 
 Inputs:
 ```json