add shit

DmitriDmitriDmitri · DmitriDmitriDmitri · commit b51149d2bc68 · 2026-04-08T13:32:31.000-04:00
diff --git a/api-reference/rpc/http/getprogramaccountsv2.mdx b/api-reference/rpc/http/getprogramaccountsv2.mdx
@@ -17,6 +17,7 @@ openapi: "/openapi/rpc-http/getProgramAccountsV2.yaml POST /"
 - **Incremental updates**: Use `changedSinceSlot` to fetch only recently modified accounts  
 - **Better performance**: Prevents timeouts and reduces memory usage for large datasets
 - **Backward compatibility**: Supports all existing `getProgramAccounts` parameters
+- **Optional `withContext`**: Request snapshot metadata (`slot`, `apiVersion`) in a standard Solana-style wrapped `result`
 </Info>
 
 ## Key Benefits
@@ -109,6 +110,32 @@ const incrementalUpdate = await fetch(`https://mainnet.helius-rpc.com/?api-key=$
 - **Store `paginationKey`** to resume queries if interrupted
 - **Monitor response times** and adjust limits accordingly
 
+## `withContext` (optional)
+
+`withContext` is a boolean on the configuration object (alongside `encoding`, `limit`, `filters`, and so on). It only changes the JSON shape of `result`, not filters, limits, or pagination behavior.
+
+- **Omitted or `false`**: The paginated payload is returned directly on `result` — read `result.accounts`, `result.paginationKey`, and `result.totalResults` (when present).
+- **`true`**: The RPC returns the standard Solana wrapped shape: `result.context` (snapshot metadata, including `slot` and usually `apiVersion`) and the same payload under `result.value` — read `result.value.accounts`, `result.value.paginationKey`, and `result.value.totalResults`.
+
+```json
+// withContext omitted or false
+{ "jsonrpc": "2.0", "id": "1", "result": {
+  "accounts": [],
+  "paginationKey": null,
+  "totalResults": null
+}}
+
+// withContext: true
+{ "jsonrpc": "2.0", "id": "1", "result": {
+  "context": { "slot": 411895550, "apiVersion": "3.1.9" },
+  "value": { "accounts": [], "paginationKey": null, "totalResults": null }
+}}
+```
+
+<Note>
+**Client parsing**: If `withContext` is `false` or missing, use `result.accounts` (and `paginationKey`, `totalResults`). If `withContext` is `true`, use `result.value.accounts` (and `result.value.paginationKey`, `result.value.totalResults`) and read `result.context.slot` (and `apiVersion`) when you need snapshot consistency or debugging.
+</Note>
+
 ## Migration from getProgramAccounts
 
 Migrating from the original method is straightforward - simply replace the method name and add pagination parameters:
@@ -159,7 +186,7 @@ Migrating from the original method is straightforward - simply replace the metho
 </ParamField>
 
 <ParamField body="withContext" type="boolean">
-  Wrap the result in an RpcResponse JSON object.
+  When `true`, nests `accounts`, `paginationKey`, and `totalResults` under `result.value` and adds `result.context` (`slot`, `apiVersion`). When `false` or omitted, those fields are on `result` directly (for example `result.accounts`). Same query semantics as without this flag.
 </ParamField>
 
 <ParamField body="encoding" type="string">
diff --git a/api-reference/rpc/http/gettokenaccountsbyownerv2.mdx b/api-reference/rpc/http/gettokenaccountsbyownerv2.mdx
@@ -17,6 +17,7 @@ openapi: "/openapi/rpc-http/getTokenAccountsByOwnerV2.yaml POST /"
 - **Incremental updates**: Use `changedSinceSlot` to fetch only recently modified token accounts
 - **Portfolio scalability**: Handle wallets with thousands of token accounts efficiently  
 - **Backward compatibility**: Supports all existing `getTokenAccountsByOwner` parameters and filters
+- **Optional `withContext`**: Request snapshot metadata (`slot`, `apiVersion`) in a standard Solana-style wrapped `result`
 </Info>
 
 <Warning>
@@ -34,6 +35,39 @@ openapi: "/openapi/rpc-http/getTokenAccountsByOwnerV2.yaml POST /"
   </Card> 
 </CardGroup>
 
+## `withContext` (optional)
+
+`withContext` is a boolean on the configuration object (third parameter — alongside `encoding`, `limit`, and so on). It only changes the JSON shape of `result`, not filters, limits, or pagination behavior.
+
+- **Omitted or `false`**: Matches the familiar shape: the token account list for the page is **`result.value` as an array**, with `result.paginationKey` and `result.totalResults` on `result`.
+- **`true`**: The RPC returns the wrapped shape: **`result.context`** (snapshot metadata, including `slot` and usually `apiVersion`) and **`result.value` as an object** with `accounts`, `paginationKey`, and `totalResults`.
+
+```json
+// withContext omitted or false
+{ "jsonrpc": "2.0", "id": "1", "result": {
+  "value": [],
+  "paginationKey": null,
+  "totalResults": null
+}}
+
+// withContext: true
+{ "jsonrpc": "2.0", "id": "1", "result": {
+  "context": { "slot": 411895550, "apiVersion": "3.1.9" },
+  "value": { "accounts": [], "paginationKey": null, "totalResults": null }
+}}
+```
+
+When you support both modes, resolve the account list with:
+
+```typescript
+const accounts = Array.isArray(data.result.value)
+  ? data.result.value
+  : data.result.value.accounts;
+const nextKey = Array.isArray(data.result.value)
+  ? data.result.paginationKey
+  : data.result.value.paginationKey;
+```
+
 ## Pagination Best Practices
 
 <Warning>
@@ -180,6 +214,10 @@ Migration is simple - just add pagination parameters to your existing queries:
   The minimum slot that the request can be evaluated at.
 </ParamField>
 
+<ParamField body="withContext" type="boolean">
+  When `true`, returns `result.context` (`slot`, `apiVersion`) and nests `accounts`, `paginationKey`, and `totalResults` under `result.value` as an object. When `false` or omitted, `result.value` is the token account array for this page, with `paginationKey` and `totalResults` on `result`. Same query semantics as without this flag.
+</ParamField>
+
 <ParamField body="dataSlice" type="object">
   Request a slice of the account's data.
 </ParamField>
diff --git a/openapi/rpc-http/getProgramAccountsV2.yaml b/openapi/rpc-http/getProgramAccountsV2.yaml
@@ -45,6 +45,66 @@ components:
           type: string
           description: Identifier matching the request.
           example: "1"
+    ProgramAccountV2Entry:
+      type: object
+      properties:
+        pubkey:
+          type: string
+          description: The account Pubkey as a base-58 encoded string.
+          example: "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY"
+        account:
+          type: object
+          description: Details about the account.
+          properties:
+            lamports:
+              type: integer
+              description: Number of lamports assigned to this account.
+              example: 15298080
+            owner:
+              type: string
+              description: Base-58 encoded Pubkey of the program this account is assigned to.
+              example: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+            data:
+              type: array
+              description: Account data as encoded binary or JSON format.
+              items:
+                type: string
+              example:
+                - "2R9jLfiAQ9bgdcw6h8s44439"
+                - base64
+            executable:
+              type: boolean
+              description: Indicates if the account contains a program.
+              example: false
+            rentEpoch:
+              type: integer
+              description: The epoch at which this account will next owe rent.
+              example: 28
+            space:
+              type: integer
+              description: The data size of the account.
+              example: 165
+    ProgramAccountsV2Page:
+      type: object
+      description: >-
+        Paginated program accounts. Same fields appear on result when withContext is false or omitted,
+        or under result.value when withContext is true.
+      properties:
+        accounts:
+          type: array
+          description: List of program accounts for the current page.
+          items:
+            $ref: '#/components/schemas/ProgramAccountV2Entry'
+        paginationKey:
+          type: string
+          description: Pagination cursor for the next page. Null only when no accounts are returned (end of pagination). Note that fewer accounts than the limit may be returned due to filtering, but this does not indicate end of pagination.
+          example: "8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
+          nullable: true
+        totalResults:
+          type: integer
+          description: Total number of accounts matching the query (if available).
+          example: 25000
+          nullable: true
 paths:
   /:
     post:
@@ -62,6 +122,13 @@ paths:
         
         Note: End of pagination is only indicated when no accounts are returned. The API may return fewer accounts 
         than the limit due to filtering - continue pagination until paginationKey is null.
+        
+        **withContext**: Optional boolean on the configuration object (alongside encoding, limit, and so on). When 
+        `withContext` is `true`, the RPC returns the standard Solana wrapped shape: `result.context` (snapshot 
+        metadata, including `slot` and usually `apiVersion`) and `result.value` holding `accounts`, `paginationKey`, 
+        and `totalResults`. When `withContext` is `false` or omitted, those fields are returned directly on `result` 
+        (for example `result.accounts`). Filters, limits, and pagination behavior are unchanged; only the JSON shape 
+        of `result` differs.
       security:
         - ApiKeyQuery: []
       requestBody:
@@ -121,7 +188,10 @@ paths:
                             example: 1000
                           withContext:
                             type: boolean
-                            description: Wrap the result in an RpcResponse JSON object.
+                            description: |
+                              When `true`, returns `result.context` (snapshot metadata: `slot`, `apiVersion`) and nests
+                              `accounts`, `paginationKey`, and `totalResults` under `result.value`. When `false` or omitted,
+                              those fields appear directly on `result` (for example `result.accounts`). Same filters and limits apply.
                             example: true
                           encoding:
                             type: string
@@ -204,61 +274,30 @@ paths:
                     description: Identifier matching the request.
                     example: "1"
                   result:
-                    type: object
-                    description: Paginated program accounts with navigation metadata.
-                    properties:
-                      accounts:
-                        type: array
-                        description: List of program accounts for the current page.
-                        items:
-                          type: object
-                          properties:
-                            pubkey:
-                              type: string
-                              description: The account Pubkey as a base-58 encoded string.
-                              example: "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY"
-                            account:
-                              type: object
-                              description: Details about the account.
-                              properties:
-                                lamports:
-                                  type: integer
-                                  description: Number of lamports assigned to this account.
-                                  example: 15298080
-                                owner:
-                                  type: string
-                                  description: Base-58 encoded Pubkey of the program this account is assigned to.
-                                  example: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
-                                data:
-                                  type: array
-                                  description: Account data as encoded binary or JSON format.
-                                  items:
-                                    type: string
-                                  example:
-                                    - "2R9jLfiAQ9bgdcw6h8s44439"
-                                    - base64
-                                executable:
-                                  type: boolean
-                                  description: Indicates if the account contains a program.
-                                  example: false
-                                rentEpoch:
-                                  type: integer
-                                  description: The epoch at which this account will next owe rent.
-                                  example: 28
-                                space:
-                                  type: integer
-                                  description: The data size of the account.
-                                  example: 165
-                      paginationKey:
-                        type: string
-                        description: Pagination cursor for the next page. Null only when no accounts are returned (end of pagination). Note that fewer accounts than the limit may be returned due to filtering, but this does not indicate end of pagination.
-                        example: "8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
-                        nullable: true
-                      totalResults:
-                        type: integer
-                        description: Total number of accounts matching the query (if available).
-                        example: 25000
-                        nullable: true
+                    oneOf:
+                      - $ref: '#/components/schemas/ProgramAccountsV2Page'
+                        title: without withContext
+                      - type: object
+                        title: with withContext
+                        description: Wrapped result when `withContext` is `true` in the request options.
+                        required:
+                          - context
+                          - value
+                        properties:
+                          context:
+                            type: object
+                            description: Snapshot metadata for the node response (slot consistency, debugging).
+                            properties:
+                              slot:
+                                type: integer
+                                description: Slot at which the node built this response.
+                                example: 411895550
+                              apiVersion:
+                                type: string
+                                description: RPC API version when available.
+                                example: "3.1.9"
+                          value:
+                            $ref: '#/components/schemas/ProgramAccountsV2Page'
         400:
           description: Bad Request - Invalid request parameters or malformed request.
           content:
diff --git a/openapi/rpc-http/getTokenAccountsByOwnerV2.yaml b/openapi/rpc-http/getTokenAccountsByOwnerV2.yaml
