Sub vaults

.github/workflows/build-check.yml

@@ -13,15 +13,15 @@ jobs:
       packages: read
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1
         with:
           version: 10.25.0
 
       - name: Setup Node
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f
         with:
           node-version: '24.12.0'
 

.github/workflows/unit-tests.yml

@@ -13,15 +13,15 @@ jobs:
         packages: read
     steps:
       - name: Checkout 🛎️
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1
         with:
           version: 10.25.0
 
       - name: Setup Node
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f
         with:
           cache: pnpm
           scope: '@stakewise'

.gitignore

@@ -17,3 +17,5 @@ schema.graphql
 src/types/graphql
 src/contracts/types
 src/contracts/vault/types
+
+CLAUDE.md

.graphqlconfig

@@ -11,7 +11,7 @@
   "extensions": {
     "endpoints": {
       "Subgraph GraphQL": {
-        "url": "https://graphs.stakewise.io/hoodi/subgraphs/name/stakewise/prod",
+        "url": "https://graphs-replica.stakewise.io/hoodi/subgraphs/name/stakewise/stage",
         "headers": {
           "user-agent": "JS GraphQL"
         },

.husky/pre-commit

@@ -1,3 +1,3 @@
 sh ./scripts/pre-push.sh
-
-npm run lint
+pnpm run check:docLinks
+pnpm run lint

changelog/next-release.md

@@ -0,0 +1,23 @@
+## Added methods
+
+- [sdk.vault.getSubVaults](https://docs.stakewise.io/sdk/api/vault/requests/getsubvaults)
+- [sdk.vault.addSubVault](https://docs.stakewise.io/sdk/api/vault/transactions/addsubvault)
+- [sdk.vault.rejectSubVault](https://docs.stakewise.io/sdk/api/vault/transactions/rejectsubvault)
+- [sdk.vault.ejectSubVault](https://docs.stakewise.io/sdk/api/vault/transactions/ejectsubvault)
+- [sdk.vault.updateState](https://docs.stakewise.io/sdk/api/vault/transactions/updatestate)
+
+## Modified methods
+
+### 1. [sdk.vault.getVault](https://docs.stakewise.io/sdk/api/vault/requests/getvault)
+
+#### Add output field:
+```ts
+type Output = {
+  canHarvest: boolean
+  exitingAssets: string
+  exitingTickets: string
+  ejectingSubVault: string
+  subVaultsRegistry: string
+  pendingMetaSubVault: string
+}
+```

codegen.ts

@@ -2,8 +2,8 @@ import type { CodegenConfig } from '@graphql-codegen/cli'
 import { Network } from './src/helpers/enums'
 import configs from './src/helpers/configs'
 
-
-let network: Network = Network.Mainnet
+// TODO change
+let network: Network = Network.Hoodi
 
 if (process.env.NETWORK === 'mainnet') {
   network = Network.Mainnet

context7.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://context7.com/schema/context7.json",
+  "projectTitle": "StakeWise V3 SDK",
+  "description": "Official TypeScript SDK for StakeWise V3 liquid staking on Ethereum and Gnosis. Typed access to vaults, osToken (osETH/osGNO), boost leverage, rewards via subgraph and on-chain calls.",
+  "url": "https://context7.com/stakewise/v3-sdk",
+  "public_key": "pk_wpaUy9UwJWjviJip1LFYx",
+  "branch": "sub-vaults",
+  "folders": ["documentation", "src/services"],
+  "excludeFolders": [
+    "scripts",
+    "dist",
+    "node_modules",
+    "changelog",
+    "documentation/_drafts"
+  ],
+  "excludeFiles": [
+    "_category_.json",
+    "README.md",
+    "package.json",
+    "tsconfig.json",
+    "pnpm-lock.yaml",
+    "rollup.config.js",
+    "jest.config.ts",
+    "codegen.ts",
+    "hardhat.config.js",
+    "eslint.config.mjs",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "rules": [
+    "Init: `new StakeWiseSDK({ network, provider })` for read+write, or `{ network, endpoints: { web3: rpcUrl } }` for read-only.",
+    "After every write, `await sdk.utils.waitForSubgraph({ hash })` before refetching reads. Subgraph indexing lags transaction confirmation.",
+    "Writes have 3 forms: default sends a tx, `.encode(args)` returns `{data,to,value}` for multisig, `.estimateGas(args)` returns bigint. `sdk.vault.multicall<T>` lacks `.encode`/`.estimateGas`.",
+    "`Network.Mainnet=1` (osETH), `Network.Gnosis=100` (osGNO), `Network.Hoodi=560048`. SDK instances are immutable per network; recreate to switch.",
+    "V3 uses `osToken` (osETH/osGNO). `sETH2`/`rETH2` are V2, never reference in V3 code.",
+    "Reads return `AbortPromise<T>`; call `.abort()` to cancel. `.then`/`.catch` are silently suppressed after abort.",
+    "Contracts outside `sdk.contracts`: import top-level `createContract<T>(address, abi, sdk.provider)` from `@stakewise/v3-sdk`.",
+    "Batch independent reads with `Promise.all` / `AbortPromise.all`. Never parallelise writes; wallets serialise signing."
+  ],
+  "previousVersions": []
+}

documentation/connecting-wallet.md

@@ -2,7 +2,7 @@
 id: connecting
 title: Connecting a Wallet
 sidebar_position: 2
-description: Connect wallets to the StakeWise SDK using EIP-1193 providers — MetaMask, WalletConnect, Coinbase, Safe, Binance, and Wagmi integration.
+description: Connect wallets to the StakeWise SDK using EIP-1193 providers - MetaMask, WalletConnect, Coinbase, Safe, Binance, and Wagmi integration.
 ---
 
 # Connecting a Wallet
@@ -29,7 +29,7 @@ interface Eip1193Provider {
 ## Wallet Connection Types
 
 Different wallets implement the EIP-1193 provider in different ways.  
-The most common type is **injected wallets** — wallets that automatically inject a provider into the global `window` object under the `window.ethereum` property. This type of connection is used by wallets that are provided in the form of browsers or browser extensions, the most popular of which is **MetaMask**.
+The most common type is **injected wallets** - wallets that automatically inject a provider into the global `window` object under the `window.ethereum` property. This type of connection is used by wallets that are provided in the form of browsers or browser extensions, the most popular of which is **MetaMask**.
 
 This is the simplest connection method and works out of the box for most browser wallets.
 

documentation/endpoints.md

@@ -0,0 +1,75 @@
+---
+id: endpoints
+title: Available Endpoints
+sidebar_position: 4
+description: RPC, API and Subgraph endpoints for Mainnet, Gnosis and Hoodi networks.
+---
+
+# Available Endpoints
+
+---
+
+## How to retrieve the subgraph endpoint URL
+
+The StakeWise V3 subgraph URL depends on the network the SDK is bound to. For SDK-driven workflows the subgraph URL is configured at construction time and the SDK queries it transparently - you do not need to read the URL yourself for typical reads. For direct GraphQL calls (custom queries, dashboards, monitoring), use the production URLs listed below under [Subgraph Endpoint](#subgraph-endpoint).
+
+```typescript
+import { StakeWiseSDK, Network } from '@stakewise/v3-sdk'
+
+const sdk = new StakeWiseSDK({
+  network: Network.Mainnet,
+  endpoints: { web3: 'https://main-rpc.io' },
+})
+
+const stats = await sdk.utils.getStakewiseStats()
+```
+
+The SDK ships with the StakeWise V3 subgraph URL baked in for each `Network` (Mainnet, Hoodi, Gnosis), so all read methods (`getVault`, `getStakeBalance`, `getStakewiseStats`, etc.) hit the right subgraph automatically.
+
+---
+
+## RPC Endpoint
+
+The RPC endpoint is the JSON-RPC URL of an Ethereum node for the selected network. You can use any public RPC provider - a curated list with public nodes for each chain is available at:
+
+🔗 **[chainlist.org](https://chainlist.org/)**
+
+✅ **Tip:** For production, prefer a dedicated provider (Infura, Alchemy, QuickNode, etc.) over a free public RPC - public RPCs are rate-limited and may go down.
+
+---
+
+## API Endpoint
+
+GraphQL endpoint of the StakeWise backend.
+
+| Network | Endpoint |
+|---------|----------|
+| **Mainnet** | `https://mainnet-api.stakewise.io/graphql` |
+| **Gnosis** | `https://gnosis-api.stakewise.io/graphql` |
+| **Hoodi** | `https://hoodi-api.stakewise.io/graphql` |
+
+---
+
+## Subgraph Endpoint
+
+GraphQL endpoint of the StakeWise subgraph.
+
+### Production
+
+Use the **`prod`** endpoint for production environments.
+
+| Network | Endpoint |
+|---------|----------|
+| **Mainnet** | `https://graphs.stakewise.io/mainnet/subgraphs/name/stakewise/prod` |
+| **Gnosis** | `https://graphs.stakewise.io/gnosis/subgraphs/name/stakewise/prod` |
+| **Hoodi** | `https://graphs.stakewise.io/hoodi/subgraphs/name/stakewise/prod` |
+
+### Stage
+
+Mirrors the production schema but tracks the staging deployment - use it only when reproducing issues against a non-production environment.
+
+| Network | Endpoint |
+|---------|----------|
+| **Mainnet** | `https://graphs.stakewise.io/mainnet/subgraphs/name/stakewise/stage` |
+| **Gnosis** | `https://graphs.stakewise.io/gnosis/subgraphs/name/stakewise/stage` |
+| **Hoodi** | `https://graphs.stakewise.io/hoodi/subgraphs/name/stakewise/stage` |

documentation/fundamentals/_category_.json

@@ -0,0 +1,4 @@
+{
+  "position": 2,
+  "label": "Fundamentals"
+}

documentation/fundamentals/aggregate-queries.md

@@ -0,0 +1,58 @@
+---
+id: aggregate-queries
+title: Network-wide aggregates
+sidebar_position: 3
+description: Use sdk.utils.getStakewiseStats() to fetch total ETH staked, user count, and total earned rewards across all StakeWise V3 vaults on the configured chain.
+---
+
+# Network-wide aggregates
+
+
+To answer "how much is staked across all StakeWise V3 vaults?" use `sdk.utils.getStakewiseStats()`. It returns the protocol-wide aggregate for the network the SDK is bound to.
+
+## Total ETH staked across all V3 vaults
+
+```typescript
+import { formatEther } from 'ethers'
+import { StakeWiseSDK, Network } from '@stakewise/v3-sdk'
+
+const sdk = new StakeWiseSDK({
+  network: Network.Mainnet,
+  endpoints: { web3: 'https://main-rpc.io' },
+})
+
+const stats = await sdk.utils.getStakewiseStats()
+
+console.log(`Total: ${formatEther(stats.totalAssets)} ETH`)
+console.log(`Users: ${stats.usersCount}`)
+console.log(`Earned: ${formatEther(stats.totalEarnedAssets)} ETH`)
+```
+
+`stats.totalAssets` and `stats.totalEarnedAssets` are wei strings; convert with `BigInt` for math, with `formatEther` for display. On Gnosis swap `Network.Mainnet` for `Network.Gnosis` and the value is in GNO.
+
+## Cross-chain TVL
+
+Instantiate one SDK per chain, run them concurrently:
+
+```typescript
+import { formatEther } from 'ethers'
+import { StakeWiseSDK, Network } from '@stakewise/v3-sdk'
+
+const mainnet = new StakeWiseSDK({
+  network: Network.Mainnet,
+  endpoints: { web3: 'https://main-rpc.io' },
+})
+
+const gnosis = new StakeWiseSDK({
+  network: Network.Gnosis,
+  endpoints: { web3: 'https://gnosis-rpc.io' },
+})
+
+const [ mainnetStats, gnosisStats ] = await Promise.all([
+  mainnet.utils.getStakewiseStats(),
+  gnosis.utils.getStakewiseStats(),
+])
+
+console.log(`Mainnet TVL: ${formatEther(mainnetStats.totalAssets)} ETH`)
+console.log(`Gnosis TVL: ${formatEther(gnosisStats.totalAssets)} GNO`)
+```