@opendatalabs/vana-sdk 2.2.1 → 2.2.3-canary.046cb7e

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/config/features.cjs +1 -24
  2. package/dist/config/features.cjs.map +1 -1
  3. package/dist/config/features.d.ts +13 -44
  4. package/dist/config/features.js +1 -24
  5. package/dist/config/features.js.map +1 -1
  6. package/dist/controllers/permissions.cjs +19 -14
  7. package/dist/controllers/permissions.cjs.map +1 -1
  8. package/dist/controllers/permissions.js +19 -14
  9. package/dist/controllers/permissions.js.map +1 -1
  10. package/dist/controllers/staking.cjs +539 -0
  11. package/dist/controllers/staking.cjs.map +1 -0
  12. package/dist/controllers/staking.d.ts +404 -0
  13. package/dist/controllers/staking.js +515 -0
  14. package/dist/controllers/staking.js.map +1 -0
  15. package/dist/core.cjs +4 -0
  16. package/dist/core.cjs.map +1 -1
  17. package/dist/core.d.ts +3 -0
  18. package/dist/core.js +4 -0
  19. package/dist/core.js.map +1 -1
  20. package/dist/crypto/ecies/index.cjs.map +1 -1
  21. package/dist/crypto/ecies/index.d.ts +10 -2
  22. package/dist/crypto/ecies/index.js.map +1 -1
  23. package/dist/generated/abi/VanaPoolEntityImplementation.cjs +37 -0
  24. package/dist/generated/abi/VanaPoolEntityImplementation.cjs.map +1 -1
  25. package/dist/generated/abi/VanaPoolEntityImplementation.d.ts +29 -0
  26. package/dist/generated/abi/VanaPoolEntityImplementation.js +37 -0
  27. package/dist/generated/abi/VanaPoolEntityImplementation.js.map +1 -1
  28. package/dist/generated/abi/VanaPoolStakingImplementation.cjs +156 -19
  29. package/dist/generated/abi/VanaPoolStakingImplementation.cjs.map +1 -1
  30. package/dist/generated/abi/VanaPoolStakingImplementation.d.ts +120 -14
  31. package/dist/generated/abi/VanaPoolStakingImplementation.js +156 -19
  32. package/dist/generated/abi/VanaPoolStakingImplementation.js.map +1 -1
  33. package/dist/generated/abi/index.d.ts +149 -14
  34. package/dist/generated/event-types.cjs.map +1 -1
  35. package/dist/generated/event-types.d.ts +4 -0
  36. package/dist/generated/eventRegistry.cjs +24 -0
  37. package/dist/generated/eventRegistry.cjs.map +1 -1
  38. package/dist/generated/eventRegistry.js +24 -0
  39. package/dist/generated/eventRegistry.js.map +1 -1
  40. package/dist/index.browser.d.ts +4 -0
  41. package/dist/index.browser.js +12 -0
  42. package/dist/index.browser.js.map +1 -1
  43. package/dist/index.node.cjs +15 -0
  44. package/dist/index.node.cjs.map +1 -1
  45. package/dist/index.node.d.ts +5 -0
  46. package/dist/index.node.js +14 -0
  47. package/dist/index.node.js.map +1 -1
  48. package/dist/platform/browser.cjs +40 -119
  49. package/dist/platform/browser.cjs.map +1 -1
  50. package/dist/platform/browser.d.ts +7 -7
  51. package/dist/platform/browser.js +40 -119
  52. package/dist/platform/browser.js.map +1 -1
  53. package/dist/platform/node.cjs +51 -129
  54. package/dist/platform/node.cjs.map +1 -1
  55. package/dist/platform/node.d.ts +5 -5
  56. package/dist/platform/node.js +51 -129
  57. package/dist/platform/node.js.map +1 -1
  58. package/dist/tests/staking.test.d.ts +1 -0
  59. package/dist/types/permissions.cjs.map +1 -1
  60. package/dist/types/permissions.d.ts +2 -0
  61. package/package.json +1 -2
  62. package/dist/types/eccrypto-js.d.cjs +0 -2
  63. package/dist/types/eccrypto-js.d.cjs.map +0 -1
  64. package/dist/types/eccrypto-js.d.js +0 -1
  65. package/dist/types/eccrypto-js.d.js.map +0 -1
@@ -0,0 +1,515 @@
1
+ import { BaseController } from "./base";
2
+ import { getContract, parseEther } from "viem";
3
+ import { getContractAddress } from "../generated/addresses";
4
+ import { getAbi } from "../generated/abi";
5
+ import { BlockchainError } from "../errors";
6
+ class StakingController extends BaseController {
7
+ constructor(context) {
8
+ super(context);
9
+ }
10
+ /**
11
+ * Gets the chain ID from context.
12
+ */
13
+ getChainId() {
14
+ const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
15
+ if (!chainId) {
16
+ throw new Error("Chain ID not available");
17
+ }
18
+ return chainId;
19
+ }
20
+ /**
21
+ * Gets the VanaPoolEntity contract instance.
22
+ */
23
+ getEntityContract() {
24
+ const chainId = this.getChainId();
25
+ return getContract({
26
+ address: getContractAddress(chainId, "VanaPoolEntity"),
27
+ abi: getAbi("VanaPoolEntity"),
28
+ client: this.context.publicClient
29
+ });
30
+ }
31
+ /**
32
+ * Gets the VanaPoolStaking contract instance.
33
+ */
34
+ getStakingContract() {
35
+ const chainId = this.getChainId();
36
+ return getContract({
37
+ address: getContractAddress(chainId, "VanaPoolStaking"),
38
+ abi: getAbi("VanaPoolStaking"),
39
+ client: this.context.publicClient
40
+ });
41
+ }
42
+ /**
43
+ * Gets the total amount of VANA staked in the VanaPool protocol or a specific entity.
44
+ *
45
+ * @remarks
46
+ * When called without an entityId, this retrieves the sum of activeRewardPool
47
+ * across all active entities in the VanaPool protocol.
48
+ * When called with an entityId, this returns the activeRewardPool for that specific entity.
49
+ * The value is returned in wei (10^18 = 1 VANA).
50
+ *
51
+ * @param entityId - Optional entity ID to get staked amount for a specific entity
52
+ * @returns The total amount of VANA staked in wei
53
+ *
54
+ * @example
55
+ * ```typescript
56
+ * // Get total staked across all entities
57
+ * const totalStaked = await vana.staking.getTotalVanaStaked();
58
+ * console.log(`Total staked: ${Number(totalStaked) / 1e18} VANA`);
59
+ *
60
+ * // Get staked amount for a specific entity
61
+ * const entityStaked = await vana.staking.getTotalVanaStaked(1n);
62
+ * console.log(`Entity 1 staked: ${Number(entityStaked) / 1e18} VANA`);
63
+ * ```
64
+ */
65
+ async getTotalVanaStaked(entityId) {
66
+ const entityContract = this.getEntityContract();
67
+ if (entityId !== void 0) {
68
+ const entity = await entityContract.read.entities([entityId]);
69
+ return entity.activeRewardPool;
70
+ }
71
+ const activeEntityIds = await entityContract.read.activeEntitiesValues();
72
+ let totalStaked = 0n;
73
+ for (const id of activeEntityIds) {
74
+ const entity = await entityContract.read.entities([id]);
75
+ totalStaked += entity.activeRewardPool;
76
+ }
77
+ return totalStaked;
78
+ }
79
+ /**
80
+ * Gets information about a specific staking entity.
81
+ *
82
+ * @param entityId - The ID of the entity to query
83
+ * @returns The entity information including name, APY, shares, and reward pools
84
+ *
85
+ * @example
86
+ * ```typescript
87
+ * const entity = await vana.staking.getEntity(1n);
88
+ * console.log(`Entity: ${entity.name}`);
89
+ * console.log(`Total shares: ${entity.totalShares}`);
90
+ * console.log(`Max APY: ${Number(entity.maxAPY) / 100}%`);
91
+ * ```
92
+ */
93
+ async getEntity(entityId) {
94
+ const entityContract = this.getEntityContract();
95
+ const result = await entityContract.read.entities([entityId]);
96
+ return {
97
+ entityId: result.entityId,
98
+ ownerAddress: result.ownerAddress,
99
+ status: result.status,
100
+ name: result.name,
101
+ maxAPY: result.maxAPY,
102
+ lockedRewardPool: result.lockedRewardPool,
103
+ activeRewardPool: result.activeRewardPool,
104
+ totalShares: result.totalShares,
105
+ lastUpdateTimestamp: result.lastUpdateTimestamp
106
+ };
107
+ }
108
+ /**
109
+ * Gets the total number of staking entities in the protocol.
110
+ *
111
+ * @returns The count of entities
112
+ *
113
+ * @example
114
+ * ```typescript
115
+ * const count = await vana.staking.getEntitiesCount();
116
+ * console.log(`Total entities: ${count}`);
117
+ * ```
118
+ */
119
+ async getEntitiesCount() {
120
+ const entityContract = this.getEntityContract();
121
+ return entityContract.read.entitiesCount();
122
+ }
123
+ /**
124
+ * Gets the IDs of all active staking entities.
125
+ *
126
+ * @returns Array of active entity IDs
127
+ *
128
+ * @example
129
+ * ```typescript
130
+ * const activeIds = await vana.staking.getActiveEntities();
131
+ * console.log(`Active entities: ${activeIds.join(', ')}`);
132
+ * ```
133
+ */
134
+ async getActiveEntities() {
135
+ const entityContract = this.getEntityContract();
136
+ return entityContract.read.activeEntitiesValues();
137
+ }
138
+ /**
139
+ * Gets a staker's position in a specific entity.
140
+ *
141
+ * @param staker - The address of the staker
142
+ * @param entityId - The ID of the entity
143
+ * @returns The staker's position information
144
+ *
145
+ * @example
146
+ * ```typescript
147
+ * const position = await vana.staking.getStakerPosition(
148
+ * '0x742d35...',
149
+ * 1n
150
+ * );
151
+ * console.log(`Shares: ${position.shares}`);
152
+ * console.log(`Rewards: ${position.realizedRewards}`);
153
+ * ```
154
+ */
155
+ async getStakerPosition(staker, entityId) {
156
+ const stakingContract = this.getStakingContract();
157
+ const result = await stakingContract.read.stakerEntities([
158
+ staker,
159
+ entityId
160
+ ]);
161
+ return {
162
+ shares: result.shares,
163
+ costBasis: result.costBasis,
164
+ rewardEligibilityTimestamp: result.rewardEligibilityTimestamp,
165
+ realizedRewards: result.realizedRewards,
166
+ vestedRewards: result.vestedRewards
167
+ };
168
+ }
169
+ /**
170
+ * Gets the earned rewards for a staker in an entity.
171
+ *
172
+ * @param staker - The address of the staker
173
+ * @param entityId - The ID of the entity
174
+ * @returns The earned rewards amount in wei
175
+ *
176
+ * @example
177
+ * ```typescript
178
+ * const rewards = await vana.staking.getEarnedRewards(
179
+ * '0x742d35...',
180
+ * 1n
181
+ * );
182
+ * console.log(`Earned: ${Number(rewards) / 1e18} VANA`);
183
+ * ```
184
+ */
185
+ async getEarnedRewards(staker, entityId) {
186
+ const stakingContract = this.getStakingContract();
187
+ return stakingContract.read.getEarnedRewards([staker, entityId]);
188
+ }
189
+ /**
190
+ * Gets the minimum stake amount required to stake.
191
+ *
192
+ * @returns The minimum stake amount in wei
193
+ *
194
+ * @example
195
+ * ```typescript
196
+ * const minStake = await vana.staking.getMinStakeAmount();
197
+ * console.log(`Minimum stake: ${Number(minStake) / 1e18} VANA`);
198
+ * ```
199
+ */
200
+ async getMinStakeAmount() {
201
+ const stakingContract = this.getStakingContract();
202
+ return stakingContract.read.minStakeAmount();
203
+ }
204
+ /**
205
+ * Gets the count of active stakers in the protocol.
206
+ *
207
+ * @returns The number of active stakers
208
+ *
209
+ * @example
210
+ * ```typescript
211
+ * const count = await vana.staking.getActiveStakersCount();
212
+ * console.log(`Active stakers: ${count}`);
213
+ * ```
214
+ */
215
+ async getActiveStakersCount() {
216
+ const stakingContract = this.getStakingContract();
217
+ return stakingContract.read.activeStakersListCount();
218
+ }
219
+ /**
220
+ * Gets the bonding period for staking.
221
+ *
222
+ * @returns The bonding period in seconds
223
+ *
224
+ * @example
225
+ * ```typescript
226
+ * const bondingPeriod = await vana.staking.getBondingPeriod();
227
+ * console.log(`Bonding period: ${bondingPeriod / 86400n} days`);
228
+ * ```
229
+ */
230
+ async getBondingPeriod() {
231
+ const stakingContract = this.getStakingContract();
232
+ return stakingContract.read.bondingPeriod();
233
+ }
234
+ /**
235
+ * Gets the total distributed rewards for a specific entity from the subgraph.
236
+ *
237
+ * @remarks
238
+ * This queries the VanaPool subgraph to retrieve the cumulative `totalDistributedRewards`
239
+ * for a staking entity. This value represents the sum of all rewards that have been
240
+ * processed (moved from lockedRewardPool to activeRewardPool) minus any forfeited
241
+ * rewards that were returned.
242
+ *
243
+ * Requires a configured `subgraphUrl` in the Vana constructor options.
244
+ *
245
+ * @param entityId - The ID of the entity to query
246
+ * @param options - Optional configuration including custom subgraph URL
247
+ * @returns The total distributed rewards in wei
248
+ * @throws {BlockchainError} When subgraph URL is not configured or query fails
249
+ *
250
+ * @example
251
+ * ```typescript
252
+ * const totalRewards = await vana.staking.getTotalDistributedRewards(1n);
253
+ * const totalRewardsVana = Number(totalRewards) / 1e18;
254
+ * console.log(`Total distributed rewards: ${totalRewardsVana.toLocaleString()} VANA`);
255
+ * ```
256
+ */
257
+ async getTotalDistributedRewards(entityId, options = {}) {
258
+ const graphqlEndpoint = options.subgraphUrl ?? this.context.subgraphUrl;
259
+ if (!graphqlEndpoint) {
260
+ throw new BlockchainError(
261
+ "subgraphUrl is required. Please provide a valid subgraph endpoint or configure it in Vana constructor."
262
+ );
263
+ }
264
+ const query = `
265
+ query GetStakingEntityRewards($entityId: ID!) {
266
+ stakingEntity(id: $entityId) {
267
+ totalDistributedRewards
268
+ }
269
+ }
270
+ `;
271
+ const response = await fetch(graphqlEndpoint, {
272
+ method: "POST",
273
+ headers: {
274
+ "Content-Type": "application/json"
275
+ },
276
+ body: JSON.stringify({
277
+ query,
278
+ variables: {
279
+ entityId: entityId.toString()
280
+ }
281
+ })
282
+ });
283
+ if (!response.ok) {
284
+ throw new BlockchainError(
285
+ `Subgraph query failed with status ${response.status}`
286
+ );
287
+ }
288
+ const result = await response.json();
289
+ if (result.errors && result.errors.length > 0) {
290
+ throw new BlockchainError(
291
+ `Subgraph query error: ${result.errors[0].message}`
292
+ );
293
+ }
294
+ if (!result.data?.stakingEntity) {
295
+ throw new BlockchainError(`Staking entity ${entityId} not found`);
296
+ }
297
+ return BigInt(result.data.stakingEntity.totalDistributedRewards);
298
+ }
299
+ /**
300
+ * Gets a comprehensive staking summary for a staker in an entity.
301
+ *
302
+ * @remarks
303
+ * This method aggregates all relevant staking information for a staker in a single call,
304
+ * including staked amount, current value, bonding status, and all reward types.
305
+ *
306
+ * Reward breakdown:
307
+ * - `earnedRewards` = pendingInterest + vestedRewards + realizedRewards
308
+ * - `pendingInterest` = currentValue - costBasis (unvested appreciation)
309
+ * - `vestedRewards` = rewards that have vested but not yet withdrawn
310
+ * - `realizedRewards` = rewards already withdrawn during unstakes
311
+ *
312
+ * @param staker - The address of the staker
313
+ * @param entityId - The ID of the entity
314
+ * @returns A comprehensive summary of the staker's position
315
+ *
316
+ * @example
317
+ * ```typescript
318
+ * const summary = await vana.staking.getStakerSummary('0x742d35...', 1n);
319
+ * console.log(`Total staked: ${Number(summary.totalStaked) / 1e18} VANA`);
320
+ * console.log(`Current value: ${Number(summary.currentValue) / 1e18} VANA`);
321
+ * console.log(`In bonding period: ${summary.isInBondingPeriod}`);
322
+ * console.log(`Remaining bonding time: ${Number(summary.remainingBondingTime) / 86400} days`);
323
+ * console.log(`Vested rewards: ${Number(summary.vestedRewards) / 1e18} VANA`);
324
+ * console.log(`Unvested rewards: ${Number(summary.unvestedRewards) / 1e18} VANA`);
325
+ * console.log(`Realized rewards: ${Number(summary.realizedRewards) / 1e18} VANA`);
326
+ * console.log(`Total earned: ${Number(summary.earnedRewards) / 1e18} VANA`);
327
+ * ```
328
+ */
329
+ async getStakerSummary(staker, entityId) {
330
+ const stakingContract = this.getStakingContract();
331
+ const entityContract = this.getEntityContract();
332
+ const position = await stakingContract.read.stakerEntities([
333
+ staker,
334
+ entityId
335
+ ]);
336
+ const earnedRewards = await stakingContract.read.getEarnedRewards([
337
+ staker,
338
+ entityId
339
+ ]);
340
+ const block = await this.context.publicClient.getBlock();
341
+ const currentTimestamp = block.timestamp;
342
+ const eligibilityTimestamp = position.rewardEligibilityTimestamp;
343
+ const remainingBondingTime = eligibilityTimestamp > currentTimestamp ? eligibilityTimestamp - currentTimestamp : 0n;
344
+ const isInBondingPeriod = remainingBondingTime > 0n;
345
+ const shareToVana = await entityContract.read.entityShareToVana([entityId]);
346
+ const currentValue = position.shares * shareToVana / 10n ** 18n;
347
+ const unvestedRewards = currentValue > position.costBasis ? currentValue - position.costBasis : 0n;
348
+ return {
349
+ shares: position.shares,
350
+ costBasis: position.costBasis,
351
+ currentValue,
352
+ rewardEligibilityTimestamp: eligibilityTimestamp,
353
+ remainingBondingTime,
354
+ isInBondingPeriod,
355
+ vestedRewards: position.vestedRewards,
356
+ unvestedRewards,
357
+ realizedRewards: position.realizedRewards,
358
+ earnedRewards
359
+ };
360
+ }
361
+ /**
362
+ * Stakes VANA to an entity in the VanaPool protocol.
363
+ *
364
+ * @remarks
365
+ * This method stakes native VANA tokens to a specified entity. The staker will receive
366
+ * shares in proportion to their stake amount. A bonding period applies during which
367
+ * rewards cannot be fully claimed without penalty.
368
+ *
369
+ * Requires a wallet client to be configured in the Vana constructor.
370
+ *
371
+ * @param params - The staking parameters
372
+ * @param params.entityId - The ID of the entity to stake to
373
+ * @param params.amount - The amount of VANA to stake (in wei, or as a string like "1.5" for 1.5 VANA)
374
+ * @param params.recipient - Optional recipient address for the shares (defaults to the sender)
375
+ * @param params.minShares - Optional minimum shares to receive (slippage protection, defaults to 0)
376
+ * @returns The transaction hash
377
+ * @throws {BlockchainError} When wallet client is not configured
378
+ *
379
+ * @example
380
+ * ```typescript
381
+ * // Stake 100 VANA to entity 1
382
+ * const txHash = await vana.staking.stake({
383
+ * entityId: 1n,
384
+ * amount: "100", // 100 VANA
385
+ * });
386
+ * console.log(`Staked! Transaction: ${txHash}`);
387
+ *
388
+ * // Stake with slippage protection
389
+ * const txHash2 = await vana.staking.stake({
390
+ * entityId: 1n,
391
+ * amount: parseEther("50"), // 50 VANA in wei
392
+ * minShares: parseEther("49"), // Expect at least 49 shares
393
+ * });
394
+ * ```
395
+ */
396
+ async stake(params, options) {
397
+ this.assertWallet();
398
+ const chainId = this.getChainId();
399
+ const stakingAddress = getContractAddress(chainId, "VanaPoolStaking");
400
+ const stakingAbi = getAbi("VanaPoolStaking");
401
+ const amountWei = typeof params.amount === "string" ? parseEther(params.amount) : params.amount;
402
+ const account = this.context.walletClient.account ?? this.context.userAddress;
403
+ const accountAddress = typeof account === "string" ? account : account.address;
404
+ const recipient = params.recipient ?? accountAddress;
405
+ const minShares = params.minShares ?? 0n;
406
+ const txHash = await this.context.walletClient.writeContract({
407
+ address: stakingAddress,
408
+ abi: stakingAbi,
409
+ functionName: "stake",
410
+ args: [params.entityId, recipient, minShares],
411
+ value: amountWei,
412
+ account,
413
+ chain: this.context.walletClient.chain,
414
+ ...this.spreadTransactionOptions(options)
415
+ });
416
+ return txHash;
417
+ }
418
+ /**
419
+ * Gets the maximum amount of VANA that can be unstaked in a single transaction.
420
+ *
421
+ * @remarks
422
+ * This calls the contract's getMaxUnstakeAmount which returns the minimum of:
423
+ * 1. The withdrawable VANA (costBasis if in bonding period, shareValue if eligible)
424
+ * 2. The entity's activeRewardPool (what the entity has available)
425
+ * 3. The treasury balance (what can be paid out)
426
+ *
427
+ * The limiting factor indicates what's constraining the unstake:
428
+ * - 0 = user shares/costBasis
429
+ * - 1 = activeRewardPool
430
+ * - 2 = treasury
431
+ *
432
+ * @param staker - The address of the staker
433
+ * @param entityId - The ID of the entity
434
+ * @returns Object containing maxVana, maxShares, limitingFactor, and isInBondingPeriod
435
+ *
436
+ * @example
437
+ * ```typescript
438
+ * const result = await vana.staking.getMaxUnstakeAmount('0x742d35...', 1n);
439
+ * console.log(`Max unstake: ${Number(result.maxVana) / 1e18} VANA`);
440
+ * console.log(`Max shares: ${result.maxShares}`);
441
+ * console.log(`In bonding period: ${result.isInBondingPeriod}`);
442
+ * ```
443
+ */
444
+ async getMaxUnstakeAmount(staker, entityId) {
445
+ const stakingContract = this.getStakingContract();
446
+ const result = await stakingContract.read.getMaxUnstakeAmount([
447
+ staker,
448
+ entityId
449
+ ]);
450
+ return {
451
+ maxVana: result[0],
452
+ maxShares: result[1],
453
+ limitingFactor: Number(result[2]),
454
+ isInBondingPeriod: result[3]
455
+ };
456
+ }
457
+ /**
458
+ * Unstakes VANA from an entity in the VanaPool protocol.
459
+ *
460
+ * @remarks
461
+ * This method unstakes native VANA tokens from a specified entity. The amount
462
+ * that can be unstaked depends on whether the staker is in the bonding period:
463
+ *
464
+ * - **During bonding period**: Only cost basis can be withdrawn; rewards are forfeited
465
+ * - **After bonding period**: Full current value (cost basis + rewards) can be withdrawn
466
+ *
467
+ * Use `getMaxUnstakeAmount` to determine the maximum amount that can be unstaked.
468
+ *
469
+ * Requires a wallet client to be configured in the Vana constructor.
470
+ *
471
+ * @param params - The unstaking parameters
472
+ * @param params.entityId - The ID of the entity to unstake from
473
+ * @param params.amount - The amount of VANA to unstake (in wei, or as a string like "1.5" for 1.5 VANA)
474
+ * @param params.maxShares - Maximum shares to burn for slippage protection (defaults to 0, no protection)
475
+ * @returns The transaction hash
476
+ * @throws {BlockchainError} When wallet client is not configured
477
+ *
478
+ * @example
479
+ * ```typescript
480
+ * // Get max unstake amount first
481
+ * const maxUnstake = await vana.staking.getMaxUnstakeAmount(address, 1n);
482
+ *
483
+ * // Unstake the maximum amount with slippage protection
484
+ * const txHash = await vana.staking.unstake({
485
+ * entityId: 1n,
486
+ * amount: maxUnstake.maxVana,
487
+ * maxShares: maxUnstake.maxShares,
488
+ * });
489
+ * console.log(`Unstaked! Transaction: ${txHash}`);
490
+ * ```
491
+ */
492
+ async unstake(params, options) {
493
+ this.assertWallet();
494
+ const chainId = this.getChainId();
495
+ const stakingAddress = getContractAddress(chainId, "VanaPoolStaking");
496
+ const stakingAbi = getAbi("VanaPoolStaking");
497
+ const amountWei = typeof params.amount === "string" ? parseEther(params.amount) : params.amount;
498
+ const maxShares = params.maxShares ?? 0n;
499
+ const account = this.context.walletClient.account ?? this.context.userAddress;
500
+ const txHash = await this.context.walletClient.writeContract({
501
+ address: stakingAddress,
502
+ abi: stakingAbi,
503
+ functionName: "unstakeVana",
504
+ args: [params.entityId, amountWei, maxShares],
505
+ account,
506
+ chain: this.context.walletClient.chain,
507
+ ...this.spreadTransactionOptions(options)
508
+ });
509
+ return txHash;
510
+ }
511
+ }
512
+ export {
513
+ StakingController
514
+ };
515
+ //# sourceMappingURL=staking.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/controllers/staking.ts"],"sourcesContent":["/**\n * Provides staking functionality for the VanaPool protocol.\n *\n * @remarks\n * This controller handles interactions with VanaPool staking contracts,\n * allowing users to query staking information such as total VANA staked,\n * entity information, and staker positions.\n *\n * @category Controllers\n * @module StakingController\n */\n\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\nimport { getContract, parseEther } from \"viem\";\nimport type { Address, Hash } from \"viem\";\nimport { getContractAddress } from \"../generated/addresses\";\nimport { getAbi } from \"../generated/abi\";\nimport { BlockchainError } from \"../errors\";\n\n/**\n * Information about a staking entity in the VanaPool protocol.\n */\nexport interface EntityInfo {\n entityId: bigint;\n ownerAddress: Address;\n status: number;\n name: string;\n maxAPY: bigint;\n lockedRewardPool: bigint;\n activeRewardPool: bigint;\n totalShares: bigint;\n lastUpdateTimestamp: bigint;\n}\n\n/**\n * Information about a staker's position in an entity.\n */\nexport interface StakerEntityInfo {\n shares: bigint;\n costBasis: bigint;\n rewardEligibilityTimestamp: bigint;\n realizedRewards: bigint;\n vestedRewards: bigint;\n}\n\n/**\n * Comprehensive staking summary for a staker in an entity.\n */\nexport interface StakerEntitySummary {\n /** Number of shares owned by the staker */\n shares: bigint;\n /** Cost basis - the original VANA amount staked */\n costBasis: bigint;\n /** Current value of the staker's shares in VANA */\n currentValue: bigint;\n /** Timestamp when rewards become eligible */\n rewardEligibilityTimestamp: bigint;\n /** Remaining bonding time in seconds (0 if bonding period has passed) */\n remainingBondingTime: bigint;\n /** Whether the staker is still in the bonding period */\n isInBondingPeriod: boolean;\n /** Vested rewards that can be claimed without penalty */\n vestedRewards: bigint;\n /** Unvested rewards (pending interest = currentValue - costBasis) */\n unvestedRewards: bigint;\n /** Realized/withdrawn rewards (already claimed) */\n realizedRewards: bigint;\n /** Total earned rewards (includes vested, unvested, and realized) */\n earnedRewards: bigint;\n}\n\n/**\n * Controller for VanaPool staking operations.\n *\n * @remarks\n * Provides methods to query staking information from the VanaPool contracts.\n * This includes total VANA staked across the protocol, entity information,\n * and individual staker positions.\n *\n * @example\n * ```typescript\n * // Get total VANA staked in the protocol\n * const totalStaked = await vana.staking.getTotalVanaStaked();\n * console.log(`Total staked: ${totalStaked} wei`);\n *\n * // Get entity information\n * const entity = await vana.staking.getEntity(1n);\n * console.log(`Entity name: ${entity.name}`);\n * ```\n *\n * @category Controllers\n */\nexport class StakingController extends BaseController {\n constructor(context: ControllerContext) {\n super(context);\n }\n\n /**\n * Gets the chain ID from context.\n */\n private getChainId(): number {\n const chainId =\n this.context.walletClient?.chain?.id ??\n this.context.publicClient.chain?.id;\n if (!chainId) {\n throw new Error(\"Chain ID not available\");\n }\n return chainId;\n }\n\n /**\n * Gets the VanaPoolEntity contract instance.\n */\n private getEntityContract() {\n const chainId = this.getChainId();\n return getContract({\n address: getContractAddress(chainId, \"VanaPoolEntity\"),\n abi: getAbi(\"VanaPoolEntity\"),\n client: this.context.publicClient,\n });\n }\n\n /**\n * Gets the VanaPoolStaking contract instance.\n */\n private getStakingContract() {\n const chainId = this.getChainId();\n return getContract({\n address: getContractAddress(chainId, \"VanaPoolStaking\"),\n abi: getAbi(\"VanaPoolStaking\"),\n client: this.context.publicClient,\n });\n }\n\n /**\n * Gets the total amount of VANA staked in the VanaPool protocol or a specific entity.\n *\n * @remarks\n * When called without an entityId, this retrieves the sum of activeRewardPool\n * across all active entities in the VanaPool protocol.\n * When called with an entityId, this returns the activeRewardPool for that specific entity.\n * The value is returned in wei (10^18 = 1 VANA).\n *\n * @param entityId - Optional entity ID to get staked amount for a specific entity\n * @returns The total amount of VANA staked in wei\n *\n * @example\n * ```typescript\n * // Get total staked across all entities\n * const totalStaked = await vana.staking.getTotalVanaStaked();\n * console.log(`Total staked: ${Number(totalStaked) / 1e18} VANA`);\n *\n * // Get staked amount for a specific entity\n * const entityStaked = await vana.staking.getTotalVanaStaked(1n);\n * console.log(`Entity 1 staked: ${Number(entityStaked) / 1e18} VANA`);\n * ```\n */\n async getTotalVanaStaked(entityId?: bigint): Promise<bigint> {\n const entityContract = this.getEntityContract();\n\n // If entityId is provided, return the activeRewardPool for that specific entity\n if (entityId !== undefined) {\n const entity = await entityContract.read.entities([entityId]);\n return entity.activeRewardPool;\n }\n\n // Otherwise, sum up the activeRewardPool from all active entities\n const activeEntityIds = await entityContract.read.activeEntitiesValues();\n\n let totalStaked = 0n;\n for (const id of activeEntityIds) {\n const entity = await entityContract.read.entities([id]);\n totalStaked += entity.activeRewardPool;\n }\n\n return totalStaked;\n }\n\n /**\n * Gets information about a specific staking entity.\n *\n * @param entityId - The ID of the entity to query\n * @returns The entity information including name, APY, shares, and reward pools\n *\n * @example\n * ```typescript\n * const entity = await vana.staking.getEntity(1n);\n * console.log(`Entity: ${entity.name}`);\n * console.log(`Total shares: ${entity.totalShares}`);\n * console.log(`Max APY: ${Number(entity.maxAPY) / 100}%`);\n * ```\n */\n async getEntity(entityId: bigint): Promise<EntityInfo> {\n const entityContract = this.getEntityContract();\n\n const result = await entityContract.read.entities([entityId]);\n\n return {\n entityId: result.entityId,\n ownerAddress: result.ownerAddress as Address,\n status: result.status,\n name: result.name,\n maxAPY: result.maxAPY,\n lockedRewardPool: result.lockedRewardPool,\n activeRewardPool: result.activeRewardPool,\n totalShares: result.totalShares,\n lastUpdateTimestamp: result.lastUpdateTimestamp,\n };\n }\n\n /**\n * Gets the total number of staking entities in the protocol.\n *\n * @returns The count of entities\n *\n * @example\n * ```typescript\n * const count = await vana.staking.getEntitiesCount();\n * console.log(`Total entities: ${count}`);\n * ```\n */\n async getEntitiesCount(): Promise<bigint> {\n const entityContract = this.getEntityContract();\n return entityContract.read.entitiesCount();\n }\n\n /**\n * Gets the IDs of all active staking entities.\n *\n * @returns Array of active entity IDs\n *\n * @example\n * ```typescript\n * const activeIds = await vana.staking.getActiveEntities();\n * console.log(`Active entities: ${activeIds.join(', ')}`);\n * ```\n */\n async getActiveEntities(): Promise<readonly bigint[]> {\n const entityContract = this.getEntityContract();\n return entityContract.read.activeEntitiesValues();\n }\n\n /**\n * Gets a staker's position in a specific entity.\n *\n * @param staker - The address of the staker\n * @param entityId - The ID of the entity\n * @returns The staker's position information\n *\n * @example\n * ```typescript\n * const position = await vana.staking.getStakerPosition(\n * '0x742d35...',\n * 1n\n * );\n * console.log(`Shares: ${position.shares}`);\n * console.log(`Rewards: ${position.realizedRewards}`);\n * ```\n */\n async getStakerPosition(\n staker: Address,\n entityId: bigint,\n ): Promise<StakerEntityInfo> {\n const stakingContract = this.getStakingContract();\n\n const result = await stakingContract.read.stakerEntities([\n staker,\n entityId,\n ]);\n\n return {\n shares: result.shares,\n costBasis: result.costBasis,\n rewardEligibilityTimestamp: result.rewardEligibilityTimestamp,\n realizedRewards: result.realizedRewards,\n vestedRewards: result.vestedRewards,\n };\n }\n\n /**\n * Gets the earned rewards for a staker in an entity.\n *\n * @param staker - The address of the staker\n * @param entityId - The ID of the entity\n * @returns The earned rewards amount in wei\n *\n * @example\n * ```typescript\n * const rewards = await vana.staking.getEarnedRewards(\n * '0x742d35...',\n * 1n\n * );\n * console.log(`Earned: ${Number(rewards) / 1e18} VANA`);\n * ```\n */\n async getEarnedRewards(staker: Address, entityId: bigint): Promise<bigint> {\n const stakingContract = this.getStakingContract();\n return stakingContract.read.getEarnedRewards([staker, entityId]);\n }\n\n /**\n * Gets the minimum stake amount required to stake.\n *\n * @returns The minimum stake amount in wei\n *\n * @example\n * ```typescript\n * const minStake = await vana.staking.getMinStakeAmount();\n * console.log(`Minimum stake: ${Number(minStake) / 1e18} VANA`);\n * ```\n */\n async getMinStakeAmount(): Promise<bigint> {\n const stakingContract = this.getStakingContract();\n return stakingContract.read.minStakeAmount();\n }\n\n /**\n * Gets the count of active stakers in the protocol.\n *\n * @returns The number of active stakers\n *\n * @example\n * ```typescript\n * const count = await vana.staking.getActiveStakersCount();\n * console.log(`Active stakers: ${count}`);\n * ```\n */\n async getActiveStakersCount(): Promise<bigint> {\n const stakingContract = this.getStakingContract();\n return stakingContract.read.activeStakersListCount();\n }\n\n /**\n * Gets the bonding period for staking.\n *\n * @returns The bonding period in seconds\n *\n * @example\n * ```typescript\n * const bondingPeriod = await vana.staking.getBondingPeriod();\n * console.log(`Bonding period: ${bondingPeriod / 86400n} days`);\n * ```\n */\n async getBondingPeriod(): Promise<bigint> {\n const stakingContract = this.getStakingContract();\n return stakingContract.read.bondingPeriod();\n }\n\n /**\n * Gets the total distributed rewards for a specific entity from the subgraph.\n *\n * @remarks\n * This queries the VanaPool subgraph to retrieve the cumulative `totalDistributedRewards`\n * for a staking entity. This value represents the sum of all rewards that have been\n * processed (moved from lockedRewardPool to activeRewardPool) minus any forfeited\n * rewards that were returned.\n *\n * Requires a configured `subgraphUrl` in the Vana constructor options.\n *\n * @param entityId - The ID of the entity to query\n * @param options - Optional configuration including custom subgraph URL\n * @returns The total distributed rewards in wei\n * @throws {BlockchainError} When subgraph URL is not configured or query fails\n *\n * @example\n * ```typescript\n * const totalRewards = await vana.staking.getTotalDistributedRewards(1n);\n * const totalRewardsVana = Number(totalRewards) / 1e18;\n * console.log(`Total distributed rewards: ${totalRewardsVana.toLocaleString()} VANA`);\n * ```\n */\n async getTotalDistributedRewards(\n entityId: bigint,\n options: { subgraphUrl?: string } = {},\n ): Promise<bigint> {\n const graphqlEndpoint = options.subgraphUrl ?? this.context.subgraphUrl;\n\n if (!graphqlEndpoint) {\n throw new BlockchainError(\n \"subgraphUrl is required. Please provide a valid subgraph endpoint or configure it in Vana constructor.\",\n );\n }\n\n const query = `\n query GetStakingEntityRewards($entityId: ID!) {\n stakingEntity(id: $entityId) {\n totalDistributedRewards\n }\n }\n `;\n\n const response = await fetch(graphqlEndpoint, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n query,\n variables: {\n entityId: entityId.toString(),\n },\n }),\n });\n\n if (!response.ok) {\n throw new BlockchainError(\n `Subgraph query failed with status ${response.status}`,\n );\n }\n\n const result = (await response.json()) as {\n data?: { stakingEntity?: { totalDistributedRewards: string } };\n errors?: Array<{ message: string }>;\n };\n\n if (result.errors && result.errors.length > 0) {\n throw new BlockchainError(\n `Subgraph query error: ${result.errors[0].message}`,\n );\n }\n\n if (!result.data?.stakingEntity) {\n throw new BlockchainError(`Staking entity ${entityId} not found`);\n }\n\n return BigInt(result.data.stakingEntity.totalDistributedRewards);\n }\n\n /**\n * Gets a comprehensive staking summary for a staker in an entity.\n *\n * @remarks\n * This method aggregates all relevant staking information for a staker in a single call,\n * including staked amount, current value, bonding status, and all reward types.\n *\n * Reward breakdown:\n * - `earnedRewards` = pendingInterest + vestedRewards + realizedRewards\n * - `pendingInterest` = currentValue - costBasis (unvested appreciation)\n * - `vestedRewards` = rewards that have vested but not yet withdrawn\n * - `realizedRewards` = rewards already withdrawn during unstakes\n *\n * @param staker - The address of the staker\n * @param entityId - The ID of the entity\n * @returns A comprehensive summary of the staker's position\n *\n * @example\n * ```typescript\n * const summary = await vana.staking.getStakerSummary('0x742d35...', 1n);\n * console.log(`Total staked: ${Number(summary.totalStaked) / 1e18} VANA`);\n * console.log(`Current value: ${Number(summary.currentValue) / 1e18} VANA`);\n * console.log(`In bonding period: ${summary.isInBondingPeriod}`);\n * console.log(`Remaining bonding time: ${Number(summary.remainingBondingTime) / 86400} days`);\n * console.log(`Vested rewards: ${Number(summary.vestedRewards) / 1e18} VANA`);\n * console.log(`Unvested rewards: ${Number(summary.unvestedRewards) / 1e18} VANA`);\n * console.log(`Realized rewards: ${Number(summary.realizedRewards) / 1e18} VANA`);\n * console.log(`Total earned: ${Number(summary.earnedRewards) / 1e18} VANA`);\n * ```\n */\n async getStakerSummary(\n staker: Address,\n entityId: bigint,\n ): Promise<StakerEntitySummary> {\n const stakingContract = this.getStakingContract();\n const entityContract = this.getEntityContract();\n\n // Get staker's position data\n const position = await stakingContract.read.stakerEntities([\n staker,\n entityId,\n ]);\n\n // Get earned rewards from contract\n const earnedRewards = await stakingContract.read.getEarnedRewards([\n staker,\n entityId,\n ]);\n\n // Get current timestamp from the blockchain\n const block = await this.context.publicClient.getBlock();\n const currentTimestamp = block.timestamp;\n\n // Calculate remaining bonding time\n const eligibilityTimestamp = position.rewardEligibilityTimestamp;\n const remainingBondingTime =\n eligibilityTimestamp > currentTimestamp\n ? eligibilityTimestamp - currentTimestamp\n : 0n;\n const isInBondingPeriod = remainingBondingTime > 0n;\n\n // Calculate current value of shares\n // entityShareToVana returns the VANA value of 1 share (scaled by 1e18)\n const shareToVana = await entityContract.read.entityShareToVana([entityId]);\n const currentValue = (position.shares * shareToVana) / 10n ** 18n;\n\n // Calculate pending interest (unvested rewards)\n // pendingInterest = currentValue - costBasis (if positive)\n const unvestedRewards =\n currentValue > position.costBasis\n ? currentValue - position.costBasis\n : 0n;\n\n return {\n shares: position.shares,\n costBasis: position.costBasis,\n currentValue,\n rewardEligibilityTimestamp: eligibilityTimestamp,\n remainingBondingTime,\n isInBondingPeriod,\n vestedRewards: position.vestedRewards,\n unvestedRewards,\n realizedRewards: position.realizedRewards,\n earnedRewards,\n };\n }\n\n /**\n * Stakes VANA to an entity in the VanaPool protocol.\n *\n * @remarks\n * This method stakes native VANA tokens to a specified entity. The staker will receive\n * shares in proportion to their stake amount. A bonding period applies during which\n * rewards cannot be fully claimed without penalty.\n *\n * Requires a wallet client to be configured in the Vana constructor.\n *\n * @param params - The staking parameters\n * @param params.entityId - The ID of the entity to stake to\n * @param params.amount - The amount of VANA to stake (in wei, or as a string like \"1.5\" for 1.5 VANA)\n * @param params.recipient - Optional recipient address for the shares (defaults to the sender)\n * @param params.minShares - Optional minimum shares to receive (slippage protection, defaults to 0)\n * @returns The transaction hash\n * @throws {BlockchainError} When wallet client is not configured\n *\n * @example\n * ```typescript\n * // Stake 100 VANA to entity 1\n * const txHash = await vana.staking.stake({\n * entityId: 1n,\n * amount: \"100\", // 100 VANA\n * });\n * console.log(`Staked! Transaction: ${txHash}`);\n *\n * // Stake with slippage protection\n * const txHash2 = await vana.staking.stake({\n * entityId: 1n,\n * amount: parseEther(\"50\"), // 50 VANA in wei\n * minShares: parseEther(\"49\"), // Expect at least 49 shares\n * });\n * ```\n */\n async stake(\n params: {\n entityId: bigint;\n amount: bigint | string;\n recipient?: Address;\n minShares?: bigint;\n },\n options?: TransactionOptions,\n ): Promise<Hash> {\n this.assertWallet();\n\n const chainId = this.getChainId();\n const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n const stakingAbi = getAbi(\"VanaPoolStaking\");\n\n // Convert amount to bigint if it's a string (e.g., \"1.5\" -> 1.5 VANA in wei)\n const amountWei =\n typeof params.amount === \"string\"\n ? parseEther(params.amount)\n : params.amount;\n\n // Get account with fallback to userAddress\n const account =\n this.context.walletClient.account ?? this.context.userAddress;\n const accountAddress =\n typeof account === \"string\" ? account : account.address;\n\n // Default recipient to the sender's address\n const recipient = params.recipient ?? accountAddress;\n\n // Default minShares to 0 (no slippage protection)\n const minShares = params.minShares ?? 0n;\n\n const txHash = await this.context.walletClient.writeContract({\n address: stakingAddress,\n abi: stakingAbi,\n functionName: \"stake\",\n args: [params.entityId, recipient, minShares],\n value: amountWei,\n account,\n chain: this.context.walletClient.chain,\n ...this.spreadTransactionOptions(options),\n });\n\n return txHash;\n }\n\n /**\n * Gets the maximum amount of VANA that can be unstaked in a single transaction.\n *\n * @remarks\n * This calls the contract's getMaxUnstakeAmount which returns the minimum of:\n * 1. The withdrawable VANA (costBasis if in bonding period, shareValue if eligible)\n * 2. The entity's activeRewardPool (what the entity has available)\n * 3. The treasury balance (what can be paid out)\n *\n * The limiting factor indicates what's constraining the unstake:\n * - 0 = user shares/costBasis\n * - 1 = activeRewardPool\n * - 2 = treasury\n *\n * @param staker - The address of the staker\n * @param entityId - The ID of the entity\n * @returns Object containing maxVana, maxShares, limitingFactor, and isInBondingPeriod\n *\n * @example\n * ```typescript\n * const result = await vana.staking.getMaxUnstakeAmount('0x742d35...', 1n);\n * console.log(`Max unstake: ${Number(result.maxVana) / 1e18} VANA`);\n * console.log(`Max shares: ${result.maxShares}`);\n * console.log(`In bonding period: ${result.isInBondingPeriod}`);\n * ```\n */\n async getMaxUnstakeAmount(\n staker: Address,\n entityId: bigint,\n ): Promise<{\n maxVana: bigint;\n maxShares: bigint;\n limitingFactor: number;\n isInBondingPeriod: boolean;\n }> {\n const stakingContract = this.getStakingContract();\n\n const result = await stakingContract.read.getMaxUnstakeAmount([\n staker,\n entityId,\n ]);\n\n return {\n maxVana: result[0],\n maxShares: result[1],\n limitingFactor: Number(result[2]),\n isInBondingPeriod: result[3],\n };\n }\n\n /**\n * Unstakes VANA from an entity in the VanaPool protocol.\n *\n * @remarks\n * This method unstakes native VANA tokens from a specified entity. The amount\n * that can be unstaked depends on whether the staker is in the bonding period:\n *\n * - **During bonding period**: Only cost basis can be withdrawn; rewards are forfeited\n * - **After bonding period**: Full current value (cost basis + rewards) can be withdrawn\n *\n * Use `getMaxUnstakeAmount` to determine the maximum amount that can be unstaked.\n *\n * Requires a wallet client to be configured in the Vana constructor.\n *\n * @param params - The unstaking parameters\n * @param params.entityId - The ID of the entity to unstake from\n * @param params.amount - The amount of VANA to unstake (in wei, or as a string like \"1.5\" for 1.5 VANA)\n * @param params.maxShares - Maximum shares to burn for slippage protection (defaults to 0, no protection)\n * @returns The transaction hash\n * @throws {BlockchainError} When wallet client is not configured\n *\n * @example\n * ```typescript\n * // Get max unstake amount first\n * const maxUnstake = await vana.staking.getMaxUnstakeAmount(address, 1n);\n *\n * // Unstake the maximum amount with slippage protection\n * const txHash = await vana.staking.unstake({\n * entityId: 1n,\n * amount: maxUnstake.maxVana,\n * maxShares: maxUnstake.maxShares,\n * });\n * console.log(`Unstaked! Transaction: ${txHash}`);\n * ```\n */\n async unstake(\n params: {\n entityId: bigint;\n amount: bigint | string;\n maxShares?: bigint;\n },\n options?: TransactionOptions,\n ): Promise<Hash> {\n this.assertWallet();\n\n const chainId = this.getChainId();\n const stakingAddress = getContractAddress(chainId, \"VanaPoolStaking\");\n const stakingAbi = getAbi(\"VanaPoolStaking\");\n\n // Convert amount to bigint if it's a string (e.g., \"1.5\" -> 1.5 VANA in wei)\n const amountWei =\n typeof params.amount === \"string\"\n ? parseEther(params.amount)\n : params.amount;\n\n // Default maxShares to 0 (no slippage protection)\n const maxShares = params.maxShares ?? 0n;\n\n // Get account with fallback to userAddress\n const account =\n this.context.walletClient.account ?? this.context.userAddress;\n\n const txHash = await this.context.walletClient.writeContract({\n address: stakingAddress,\n abi: stakingAbi,\n functionName: \"unstakeVana\",\n args: [params.entityId, amountWei, maxShares],\n account,\n chain: this.context.walletClient.chain,\n ...this.spreadTransactionOptions(options),\n });\n\n return txHash;\n }\n}\n"],"mappings":"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","names":[]}
package/dist/core.cjs CHANGED
@@ -40,6 +40,7 @@ var import_schemas = require("./controllers/schemas");
40
40
  var import_server = require("./controllers/server");
41
41
  var import_protocol = require("./controllers/protocol");
42
42
  var import_operations = require("./controllers/operations");
43
+ var import_staking = require("./controllers/staking");
43
44
  var import_storage = require("./storage");
44
45
  var import_viem = require("viem");
45
46
  var import_wallet = require("./utils/wallet");
@@ -100,6 +101,8 @@ class VanaCore {
100
101
  server;
101
102
  /** Offers low-level access to Vana protocol smart contracts. */
102
103
  protocol;
104
+ /** Provides VanaPool staking information and operations. */
105
+ staking;
103
106
  /** Handles environment-specific operations like encryption and file systems. */
104
107
  platform;
105
108
  relayerConfig;
@@ -269,6 +272,7 @@ class VanaCore {
269
272
  this.operations = new import_operations.OperationsController(sharedContext);
270
273
  this.server = new import_server.ServerController(sharedContext);
271
274
  this.protocol = new import_protocol.ProtocolController(sharedContext);
275
+ this.staking = new import_staking.StakingController(sharedContext);
272
276
  }
273
277
  /**
274
278
  * Validates that storage is available for storage-dependent operations.