@avalabs/glacier-sdk 3.1.0-alpha.94 → 3.1.0-alpha.95
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.
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +136 -16
- package/esm/generated/models/ActiveValidatorDetails.d.ts +12 -3
- package/esm/generated/models/AutoRenewDetails.d.ts +41 -0
- package/esm/generated/models/AutoRenewExitReason.d.ts +9 -0
- package/esm/generated/models/AutoRenewExitReason.js +1 -0
- package/esm/generated/models/AutoRenewState.d.ts +11 -0
- package/esm/generated/models/AutoRenewState.js +1 -0
- package/esm/generated/models/CompletedValidatorDetails.d.ts +18 -0
- package/esm/generated/models/HistoricalReward.d.ts +5 -0
- package/esm/generated/models/PChainBalance.d.ts +6 -0
- package/esm/generated/models/PChainTransaction.d.ts +21 -8
- package/esm/generated/models/PChainTransactionType.d.ts +3 -0
- package/esm/generated/models/PChainTransactionType.js +1 -1
- package/esm/generated/models/PChainUtxo.d.ts +2 -2
- package/esm/generated/models/PendingReward.d.ts +6 -1
- package/esm/generated/models/PendingValidatorDetails.d.ts +2 -0
- package/esm/generated/models/PrimaryNetworkTxType.d.ts +3 -0
- package/esm/generated/models/PrimaryNetworkTxType.js +1 -1
- package/esm/generated/models/RemovedValidatorDetails.d.ts +2 -0
- package/esm/generated/models/StakingType.d.ts +9 -0
- package/esm/generated/models/StakingType.js +1 -0
- package/esm/index.d.ts +4 -0
- package/esm/index.js +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -3757,6 +3757,61 @@ type ListSubnetsResponse = {
|
|
|
3757
3757
|
subnets: Array<Subnet>;
|
|
3758
3758
|
};
|
|
3759
3759
|
|
|
3760
|
+
/**
|
|
3761
|
+
* Why the validation ended. `graceful` = exited after being configured to stop renewing; `uptime_not_met` = removed because reward eligibility was not met. Null while still active (`renewing` or `exiting`). `state` carries the same distinction (`exited` vs `aborted`).
|
|
3762
|
+
*/
|
|
3763
|
+
declare enum AutoRenewExitReason {
|
|
3764
|
+
GRACEFUL = "graceful",
|
|
3765
|
+
UPTIME_NOT_MET = "uptime_not_met"
|
|
3766
|
+
}
|
|
3767
|
+
|
|
3768
|
+
/**
|
|
3769
|
+
* Current-cycle lifecycle. `renewing` = active, will roll into another cycle; `exiting` = active in its final cycle (graceful exit armed) with validationStatus still `active`; `exited`/`aborted` = ended.
|
|
3770
|
+
*/
|
|
3771
|
+
declare enum AutoRenewState {
|
|
3772
|
+
RENEWING = "renewing",
|
|
3773
|
+
EXITING = "exiting",
|
|
3774
|
+
EXITED = "exited",
|
|
3775
|
+
ABORTED = "aborted"
|
|
3776
|
+
}
|
|
3777
|
+
|
|
3778
|
+
type AutoRenewDetails = {
|
|
3779
|
+
state: AutoRenewState;
|
|
3780
|
+
/**
|
|
3781
|
+
* Length of the next cycle in seconds. `0` = graceful exit armed at the end of the current cycle.
|
|
3782
|
+
*/
|
|
3783
|
+
nextPeriodSeconds: number;
|
|
3784
|
+
/**
|
|
3785
|
+
* 0-100. Share of each cycle's rewards that is restaked (compounded into validator weight).
|
|
3786
|
+
*/
|
|
3787
|
+
autoCompoundSharePercent: number;
|
|
3788
|
+
/**
|
|
3789
|
+
* Current weight in nAVAX including all restaked rewards. Equals the top-level `amountStaked`.
|
|
3790
|
+
*/
|
|
3791
|
+
compoundedWeight: string;
|
|
3792
|
+
/**
|
|
3793
|
+
* Cumulative validation rewards restaked from prior cycles, in nAVAX.
|
|
3794
|
+
*/
|
|
3795
|
+
accruedValidationRewards: string;
|
|
3796
|
+
/**
|
|
3797
|
+
* Cumulative delegatee commission restaked from prior cycles, in nAVAX.
|
|
3798
|
+
*/
|
|
3799
|
+
accruedDelegateeRewards: string;
|
|
3800
|
+
/**
|
|
3801
|
+
* Reward owner addresses (validation).
|
|
3802
|
+
*/
|
|
3803
|
+
validationRewardAddresses: Array<string>;
|
|
3804
|
+
/**
|
|
3805
|
+
* Reward owner addresses (delegation).
|
|
3806
|
+
*/
|
|
3807
|
+
delegationRewardAddresses: Array<string>;
|
|
3808
|
+
exitReason: AutoRenewExitReason | null;
|
|
3809
|
+
/**
|
|
3810
|
+
* When it exited/aborted; null while still active.
|
|
3811
|
+
*/
|
|
3812
|
+
endedAtTimestamp: any | null;
|
|
3813
|
+
};
|
|
3814
|
+
|
|
3760
3815
|
type BlsCredentials = {
|
|
3761
3816
|
publicKey: string;
|
|
3762
3817
|
proofOfPossession: string;
|
|
@@ -3792,6 +3847,14 @@ type Rewards = {
|
|
|
3792
3847
|
rewardTxHash?: string;
|
|
3793
3848
|
};
|
|
3794
3849
|
|
|
3850
|
+
/**
|
|
3851
|
+
* Staking kind. `autoRenewed` type validators run in repeating cycles; for these the top-level startTimestamp/endTimestamp/amountStaked reflect the current cycle and compounded weight.
|
|
3852
|
+
*/
|
|
3853
|
+
declare enum StakingType {
|
|
3854
|
+
FIXED = "fixed",
|
|
3855
|
+
AUTO_RENEWED = "autoRenewed"
|
|
3856
|
+
}
|
|
3857
|
+
|
|
3795
3858
|
type ValidatorHealthDetails = {
|
|
3796
3859
|
/**
|
|
3797
3860
|
* Percent of requests responded to in last polling.
|
|
@@ -3822,6 +3885,7 @@ type ActiveValidatorDetails = {
|
|
|
3822
3885
|
delegationFee?: string;
|
|
3823
3886
|
startTimestamp: number;
|
|
3824
3887
|
endTimestamp: number;
|
|
3888
|
+
stakingType: StakingType;
|
|
3825
3889
|
/**
|
|
3826
3890
|
* Present for AddPermissionlessValidatorTx
|
|
3827
3891
|
*/
|
|
@@ -3831,11 +3895,11 @@ type ActiveValidatorDetails = {
|
|
|
3831
3895
|
*/
|
|
3832
3896
|
stakePercentage: number;
|
|
3833
3897
|
/**
|
|
3834
|
-
* The number of delegators linked to the validator.
|
|
3898
|
+
* The number of delegators linked to the validator. For `autoRenewed` validators this counts the current staking cycle only (a single validation period, like a fixed validator over its one period) — not a cumulative total across cycles.
|
|
3835
3899
|
*/
|
|
3836
3900
|
delegatorCount: number;
|
|
3837
3901
|
/**
|
|
3838
|
-
* The total amount in nAVAX delegated to the validator.
|
|
3902
|
+
* The total amount in nAVAX delegated to the validator. For `autoRenewed` validators this reflects the current staking cycle only (a single validation period), not a cumulative total across cycles.
|
|
3839
3903
|
*/
|
|
3840
3904
|
amountDelegated?: string;
|
|
3841
3905
|
/**
|
|
@@ -3848,7 +3912,9 @@ type ActiveValidatorDetails = {
|
|
|
3848
3912
|
*/
|
|
3849
3913
|
delegationCapacity?: string;
|
|
3850
3914
|
/**
|
|
3851
|
-
* Estimated rewards for the validator if the validation is successful.
|
|
3915
|
+
* Estimated rewards for the validator if the validation is successful. For `autoRenewed` validators the delegation portion (`delegationRewardAmount`) covers the current staking cycle only.
|
|
3916
|
+
*
|
|
3917
|
+
* For `autoRenewed` validators these amounts are **gross** — the whole reward the cycle is expected to earn, before any of it is restaked. The portion that will actually be paid out to the reward address is `gross * (100 - autoRenew.autoCompoundSharePercent) / 100`. Note this differs from `estimatedReward` on `/rewards::listPending`, which reports that withdrawn portion directly.
|
|
3852
3918
|
*/
|
|
3853
3919
|
potentialRewards: Rewards;
|
|
3854
3920
|
validationStatus: ActiveValidatorDetails.validationStatus;
|
|
@@ -3857,6 +3923,10 @@ type ActiveValidatorDetails = {
|
|
|
3857
3923
|
* The geographical location of the validator node, if available.
|
|
3858
3924
|
*/
|
|
3859
3925
|
geolocation: Geolocation | null;
|
|
3926
|
+
/**
|
|
3927
|
+
* Current-cycle renewal and compounding detail. Present only when stakingType is `autoRenewed`.
|
|
3928
|
+
*/
|
|
3929
|
+
autoRenew?: AutoRenewDetails;
|
|
3860
3930
|
};
|
|
3861
3931
|
declare namespace ActiveValidatorDetails {
|
|
3862
3932
|
enum validationStatus {
|
|
@@ -3875,14 +3945,30 @@ type CompletedValidatorDetails = {
|
|
|
3875
3945
|
delegationFee?: string;
|
|
3876
3946
|
startTimestamp: number;
|
|
3877
3947
|
endTimestamp: number;
|
|
3948
|
+
stakingType: StakingType;
|
|
3878
3949
|
/**
|
|
3879
3950
|
* Present for AddPermissionlessValidatorTx
|
|
3880
3951
|
*/
|
|
3881
3952
|
blsCredentials?: BlsCredentials;
|
|
3953
|
+
/**
|
|
3954
|
+
* The number of delegators linked to the validator. For `autoRenewed` validators this reflects the final staking cycle (a single validation period), not a cumulative total across cycles.
|
|
3955
|
+
*/
|
|
3882
3956
|
delegatorCount: number;
|
|
3957
|
+
/**
|
|
3958
|
+
* The total amount in nAVAX delegated to the validator. For `autoRenewed` validators this reflects the final staking cycle.
|
|
3959
|
+
*/
|
|
3883
3960
|
amountDelegated?: string;
|
|
3961
|
+
/**
|
|
3962
|
+
* Rewards for the validator. For `autoRenewed` validators the delegation portion covers the final staking cycle.
|
|
3963
|
+
*
|
|
3964
|
+
* As with `potentialRewards` on an active validator, for `autoRenewed` validators these amounts are **gross** — before the restaked share is deducted.
|
|
3965
|
+
*/
|
|
3884
3966
|
rewards: Rewards;
|
|
3885
3967
|
validationStatus: CompletedValidatorDetails.validationStatus;
|
|
3968
|
+
/**
|
|
3969
|
+
* Final-cycle renewal and compounding detail for an auto-renewed validator that has exited/aborted. Present only when stakingType is `autoRenewed`.
|
|
3970
|
+
*/
|
|
3971
|
+
autoRenew?: AutoRenewDetails;
|
|
3886
3972
|
};
|
|
3887
3973
|
declare namespace CompletedValidatorDetails {
|
|
3888
3974
|
enum validationStatus {
|
|
@@ -3906,6 +3992,7 @@ type PendingValidatorDetails = {
|
|
|
3906
3992
|
*/
|
|
3907
3993
|
blsCredentials?: BlsCredentials;
|
|
3908
3994
|
validationStatus: PendingValidatorDetails.validationStatus;
|
|
3995
|
+
stakingType: StakingType;
|
|
3909
3996
|
};
|
|
3910
3997
|
declare namespace PendingValidatorDetails {
|
|
3911
3998
|
enum validationStatus {
|
|
@@ -3924,6 +4011,7 @@ type RemovedValidatorDetails = {
|
|
|
3924
4011
|
delegationFee?: string;
|
|
3925
4012
|
startTimestamp: number;
|
|
3926
4013
|
endTimestamp: number;
|
|
4014
|
+
stakingType: StakingType;
|
|
3927
4015
|
/**
|
|
3928
4016
|
* Present for AddPermissionlessValidatorTx
|
|
3929
4017
|
*/
|
|
@@ -4460,6 +4548,12 @@ type PChainBalance = {
|
|
|
4460
4548
|
* A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of staked Avax whose staking period has not yet started.
|
|
4461
4549
|
*/
|
|
4462
4550
|
pendingStaked: Array<AggregatedAssetAmount>;
|
|
4551
|
+
/**
|
|
4552
|
+
* Total AVAX (in nAVAX) restaked into auto-renewed validators via compounding. These rewards are bonded into validator weight and have no UTXO until the validator exits, so they are reported here as a separate amount (always AVAX). Add to unlockedStaked/lockedStaked for an auto-renewed validator's full current staked value.
|
|
4553
|
+
*
|
|
4554
|
+
* Current-balance queries only. The field is OMITTED for historical queries, i.e. when blockTimestamp is supplied with a value greater than 0, because compounding history is not reconstructable from current-state data. Absence therefore means "not available for this timestamp" — it does not mean nothing was compounded. A current-balance query for an address with no auto-renewed position returns "0". Note blockTimestamp=0 is treated as "no timestamp supplied" and is answered as a current-balance query.
|
|
4555
|
+
*/
|
|
4556
|
+
restakedRewards?: string;
|
|
4463
4557
|
/**
|
|
4464
4558
|
* A list of objects containing P-chain Asset basic info, amount and utxo count of that Asset ID. Denotes the amount of unlocked Avax in the atomic memory between P-Chain and other chain.
|
|
4465
4559
|
*/
|
|
@@ -4730,11 +4824,15 @@ type HistoricalReward = {
|
|
|
4730
4824
|
*/
|
|
4731
4825
|
addresses: Array<string>;
|
|
4732
4826
|
txHash: string;
|
|
4827
|
+
/**
|
|
4828
|
+
* Amount staked by the validator this reward comes from. For autoRenewed validators this is the position's compounded weight, so it is the same on every cycle rather than the weight held during that particular cycle — per-cycle weight is not recorded on chain.
|
|
4829
|
+
*/
|
|
4733
4830
|
amountStaked: string;
|
|
4734
4831
|
nodeId: string;
|
|
4735
4832
|
startTimestamp: number;
|
|
4736
4833
|
endTimestamp: number;
|
|
4737
4834
|
rewardType: RewardType;
|
|
4835
|
+
stakingType: StakingType;
|
|
4738
4836
|
utxoId: string;
|
|
4739
4837
|
outputIndex: number;
|
|
4740
4838
|
reward: AssetWithPriceInfo;
|
|
@@ -4779,14 +4877,18 @@ type PendingReward = {
|
|
|
4779
4877
|
*/
|
|
4780
4878
|
addresses: Array<string>;
|
|
4781
4879
|
txHash: string;
|
|
4880
|
+
/**
|
|
4881
|
+
* Amount staked by the validator this reward comes from. For autoRenewed validators this is the position's compounded weight, so it is the same on every cycle rather than the weight held during that particular cycle — per-cycle weight is not recorded on chain.
|
|
4882
|
+
*/
|
|
4782
4883
|
amountStaked: string;
|
|
4783
4884
|
nodeId: string;
|
|
4784
4885
|
startTimestamp: number;
|
|
4785
4886
|
endTimestamp: number;
|
|
4786
4887
|
rewardType: RewardType;
|
|
4888
|
+
stakingType: StakingType;
|
|
4787
4889
|
progress: number;
|
|
4788
4890
|
/**
|
|
4789
|
-
* An object containing P-chain Asset basic info and the amount of that Asset ID.
|
|
4891
|
+
* An object containing P-chain Asset basic info and the amount of that Asset ID. For `autoRenewed` validators this amount is **net** of compounding: it is only the portion of the cycle's reward that will be paid out to the reward address, already reduced by the auto-compound share. Do **not** apply `autoRenew.autoCompoundSharePercent` to it again — that double-discounts the payout. The gross figure for the same cycle is `potentialRewards.validationRewardAmount` on the validator endpoints.
|
|
4790
4892
|
*/
|
|
4791
4893
|
estimatedReward: AssetAmount;
|
|
4792
4894
|
};
|
|
@@ -5148,6 +5250,9 @@ declare enum PChainTransactionType {
|
|
|
5148
5250
|
SET_L1VALIDATOR_WEIGHT_TX = "SetL1ValidatorWeightTx",
|
|
5149
5251
|
DISABLE_L1VALIDATOR_TX = "DisableL1ValidatorTx",
|
|
5150
5252
|
INCREASE_L1VALIDATOR_BALANCE_TX = "IncreaseL1ValidatorBalanceTx",
|
|
5253
|
+
ADD_AUTO_RENEWED_VALIDATOR_TX = "AddAutoRenewedValidatorTx",
|
|
5254
|
+
SET_AUTO_RENEWED_VALIDATOR_CONFIG_TX = "SetAutoRenewedValidatorConfigTx",
|
|
5255
|
+
REWARD_AUTO_RENEWED_VALIDATOR_TX = "RewardAutoRenewedValidatorTx",
|
|
5151
5256
|
UNKNOWN = "UNKNOWN"
|
|
5152
5257
|
}
|
|
5153
5258
|
|
|
@@ -5226,11 +5331,11 @@ type PChainUtxo = {
|
|
|
5226
5331
|
*/
|
|
5227
5332
|
txHash: string;
|
|
5228
5333
|
/**
|
|
5229
|
-
* Timestamp in seconds after which the staked UTXO will be unlocked.
|
|
5334
|
+
* Timestamp in seconds after which the staked UTXO will be unlocked. For an auto-renewed (ACP-236) position this is the end of the CURRENT validation cycle, not an unlock date: the principal stays bonded and is returned only when the validator stops, so the value rolls forward each time the position renews. Use autoRenew.state from the validator endpoints to tell a renewing position from an exiting one.
|
|
5230
5335
|
*/
|
|
5231
5336
|
utxoEndTimestamp?: number;
|
|
5232
5337
|
/**
|
|
5233
|
-
* Timestamp in seconds at which the staked UTXO was locked.
|
|
5338
|
+
* Timestamp in seconds at which the staked UTXO was locked. For an auto-renewed (ACP-236) position this is the start of the CURRENT validation cycle, not the original bonding time, so it advances each time the position renews.
|
|
5234
5339
|
*/
|
|
5235
5340
|
utxoStartTimestamp?: number;
|
|
5236
5341
|
utxoType: UtxoType;
|
|
@@ -5276,7 +5381,7 @@ type PChainTransaction = {
|
|
|
5276
5381
|
*/
|
|
5277
5382
|
amountBurned: Array<AssetAmount>;
|
|
5278
5383
|
/**
|
|
5279
|
-
* A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
5384
|
+
* A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
|
|
5280
5385
|
*/
|
|
5281
5386
|
amountStaked: Array<AssetAmount>;
|
|
5282
5387
|
/**
|
|
@@ -5284,19 +5389,19 @@ type PChainTransaction = {
|
|
|
5284
5389
|
*/
|
|
5285
5390
|
amountL1ValidatorBalanceBurned: Array<AssetAmount>;
|
|
5286
5391
|
/**
|
|
5287
|
-
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
5392
|
+
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx. For AddAutoRenewedValidatorTx this reflects the cycle the validator is currently serving, so it advances on each renewal; use blockTimestamp for when the position was first created.
|
|
5288
5393
|
*/
|
|
5289
5394
|
startTimestamp?: number;
|
|
5290
5395
|
/**
|
|
5291
|
-
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
5396
|
+
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx. For AddAutoRenewedValidatorTx this reflects the cycle the validator is currently serving, so it advances on each renewal.
|
|
5292
5397
|
*/
|
|
5293
5398
|
endTimestamp?: number;
|
|
5294
5399
|
/**
|
|
5295
|
-
* The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx
|
|
5400
|
+
* The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
|
|
5296
5401
|
*/
|
|
5297
5402
|
delegationFeePercent?: string;
|
|
5298
5403
|
/**
|
|
5299
|
-
* The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
5404
|
+
* The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
|
|
5300
5405
|
*/
|
|
5301
5406
|
nodeId?: string;
|
|
5302
5407
|
/**
|
|
@@ -5312,7 +5417,7 @@ type PChainTransaction = {
|
|
|
5312
5417
|
*/
|
|
5313
5418
|
l1ValidatorDetails?: Array<L1ValidatorDetailsTransaction>;
|
|
5314
5419
|
/**
|
|
5315
|
-
* Estimated reward from the staking transaction, if successful. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
5420
|
+
* Estimated reward from the staking transaction, if successful. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx (the cycle the validator is currently serving), and each RewardAutoRenewedValidatorTx (the estimate for the next cycle it starts).
|
|
5316
5421
|
*/
|
|
5317
5422
|
estimatedReward?: string;
|
|
5318
5423
|
/**
|
|
@@ -5322,7 +5427,7 @@ type PChainTransaction = {
|
|
|
5322
5427
|
rewardAddresses?: Array<string>;
|
|
5323
5428
|
memo?: string;
|
|
5324
5429
|
/**
|
|
5325
|
-
* Staking transaction corresponding to the RewardValidatorTx
|
|
5430
|
+
* Staking transaction corresponding to the RewardValidatorTx, or the originating AddAutoRenewedValidatorTx for a RewardAutoRenewedValidatorTx
|
|
5326
5431
|
*/
|
|
5327
5432
|
stakingTxHash?: string;
|
|
5328
5433
|
/**
|
|
@@ -5330,13 +5435,25 @@ type PChainTransaction = {
|
|
|
5330
5435
|
*/
|
|
5331
5436
|
subnetOwnershipInfo?: SubnetOwnershipInfo;
|
|
5332
5437
|
/**
|
|
5333
|
-
* Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx
|
|
5438
|
+
* Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
|
|
5334
5439
|
*/
|
|
5335
5440
|
blsCredentials?: BlsCredentials;
|
|
5336
5441
|
/**
|
|
5337
5442
|
* Details of the blockchain that was created in the CreateChainTx
|
|
5338
5443
|
*/
|
|
5339
5444
|
blockchainInfo?: BlockchainInfo;
|
|
5445
|
+
/**
|
|
5446
|
+
* Length of an auto-renewed validation cycle, in seconds. Present for AddAutoRenewedValidatorTx and SetAutoRenewedValidatorConfigTx. A value of 0 on SetAutoRenewedValidatorConfigTx indicates validation will attempt a graceful exit at the end of the current cycle.
|
|
5447
|
+
*/
|
|
5448
|
+
period?: number;
|
|
5449
|
+
/**
|
|
5450
|
+
* Fraction of each cycle’s rewards that is restaked (compounded into validator weight) rather than withdrawn, expressed in millionths (0–1000000). Present for AddAutoRenewedValidatorTx and SetAutoRenewedValidatorConfigTx.
|
|
5451
|
+
*/
|
|
5452
|
+
autoCompoundRewardShares?: number;
|
|
5453
|
+
/**
|
|
5454
|
+
* Owner (addresses + signature threshold) authorized to reconfigure or exit the auto-renewed validator via SetAutoRenewedValidatorConfigTx. Present for AddAutoRenewedValidatorTx.
|
|
5455
|
+
*/
|
|
5456
|
+
validatorAuthority?: BalanceOwner;
|
|
5340
5457
|
};
|
|
5341
5458
|
|
|
5342
5459
|
type ListPChainTransactionsResponse = {
|
|
@@ -5524,6 +5641,9 @@ declare enum PrimaryNetworkTxType {
|
|
|
5524
5641
|
SET_L1VALIDATOR_WEIGHT_TX = "SetL1ValidatorWeightTx",
|
|
5525
5642
|
DISABLE_L1VALIDATOR_TX = "DisableL1ValidatorTx",
|
|
5526
5643
|
INCREASE_L1VALIDATOR_BALANCE_TX = "IncreaseL1ValidatorBalanceTx",
|
|
5644
|
+
ADD_AUTO_RENEWED_VALIDATOR_TX = "AddAutoRenewedValidatorTx",
|
|
5645
|
+
SET_AUTO_RENEWED_VALIDATOR_CONFIG_TX = "SetAutoRenewedValidatorConfigTx",
|
|
5646
|
+
REWARD_AUTO_RENEWED_VALIDATOR_TX = "RewardAutoRenewedValidatorTx",
|
|
5527
5647
|
UNKNOWN = "UNKNOWN",
|
|
5528
5648
|
CREATE_ASSET_TX = "CreateAssetTx",
|
|
5529
5649
|
OPERATION_TX = "OperationTx"
|
|
@@ -7192,5 +7312,5 @@ declare class FetchHttpRequest extends BaseHttpRequest {
|
|
|
7192
7312
|
request<T>(options: ApiRequestOptions): CancelablePromise<T>;
|
|
7193
7313
|
}
|
|
7194
7314
|
|
|
7195
|
-
export { ActiveDelegatorDetails, ActiveValidatorDetails, AddressActivityEventType, ApiError, ApiFeature, AvaxSupplyService, BaseHttpRequest, BlockchainId, BlockchainIds, CChainExportTransaction, CChainImportTransaction, CancelError, CancelablePromise, ChainStatus, CommonBalanceType, CompletedDelegatorDetails, CompletedValidatorDetails, CurrencyCode, DataApiUsageMetricsService, DelegationStatusType, DeliveredIcmMessage, DeliveredSourceNotIndexedIcmMessage, DeliveredSourceNotIndexedTeleporterMessage, DeliveredTeleporterMessage, EVMAddressActivityRequest, EVMOperationType, Erc1155Contract, Erc1155Token, Erc1155TokenBalance, Erc20Contract, Erc20Token, Erc20TokenBalance, Erc20TokenV2, Erc721Contract, Erc721Token, Erc721TokenBalance, EvmBalancesService, EvmBlocksService, EvmChainsService, EvmContractsService, EvmTransactionsService, FetchHttpRequest, Glacier, HealthCheckResultDto, HealthCheckService, HealthIndicatorResultDto, IcmRewardDetails, InterchainMessagingService, InternalTransactionOpCall, Network, NfTsService, NftTokenMetadataStatus, OpenAPI, OperationStatus, OperationStatusCode, OperationType, OperationsService, PChainId, PChainTransactionType, PendingDelegatorDetails, PendingIcmMessage, PendingTeleporterMessage, PendingValidatorDetails, PlatformAddressActivityKeyType, PrimaryNetworkAddressActivityEventType, PrimaryNetworkAddressActivityRequest, PrimaryNetworkAddressActivitySubEventType, PrimaryNetworkAssetCap, PrimaryNetworkAssetType, PrimaryNetworkBalancesService, PrimaryNetworkBlocksService, PrimaryNetworkChainName, PrimaryNetworkOperationType, PrimaryNetworkRewardsService, PrimaryNetworkRpcMetricsGroupByEnum, PrimaryNetworkRpcTimeIntervalGranularity, PrimaryNetworkRpcUsageMetricsResponseDTO, PrimaryNetworkService, PrimaryNetworkTransactionsService, PrimaryNetworkTxType, PrimaryNetworkType, PrimaryNetworkUtxOsService, PrimaryNetworkVerticesService, RemovedValidatorDetails, RequestType, ResourceLinkType, RewardType, RpcUsageMetricsGroupByEnum, RpcUsageMetricsValueAggregated, SignatureAggregatorService, SortByOption, SortOrder, SubnetRpcTimeIntervalGranularity, TeleporterRewardDetails, TeleporterService, TimeIntervalGranularityExtended, TransactionDirectionType, TransactionMethodType, TransactionStatus, UnknownContract, UsageMetricsGroupByEnum, UsageMetricsValueDTO, UtxoType, UtxosSortByOption, ValidationStatusType, ValidatorActivityEventType, ValidatorActivityKeyType, ValidatorActivityRequest, VmName, WebhookAddressActivityResponse, WebhookStatus, WebhookStatusType, WebhooksService, XChainId, XChainLinearTransaction, XChainNonLinearTransaction, XChainTransactionType };
|
|
7196
|
-
export type { AccessListData, AddressActivityMetadata, AddressesChangeRequest, AggregatedAssetAmount, ApiRequestOptions, AssetAmount, AssetWithPriceInfo, AvaxSupplyResponse, BadGateway, BadRequest, BalanceOwner, Blockchain, BlockchainInfo, BlsCredentials, CChainAtomicBalances, CChainSharedAssetBalance, ChainAddressChainIdMap, ChainAddressChainIdMapListResponse, ChainInfo, ContractDeploymentDetails, CreateEvmTransactionExportRequest, CreatePrimaryNetworkTransactionExportRequest, DataListChainsResponse, DelegatorsDetails, ERCToken, ERCTransfer, EVMAddressActivityResponse, EVMInput, EVMOutput, Erc1155TokenMetadata, Erc1155Transfer, Erc1155TransferDetails, Erc20Transfer, Erc20TransferDetails, Erc20TransferDetailsV2, Erc721TokenMetadata, Erc721Transfer, Erc721TransferDetails, EvmBlock, EvmGenesisAllocDto, EvmGenesisAllowListConfigDto, EvmGenesisConfigDto, EvmGenesisDto, EvmGenesisFeeConfigDto, EvmGenesisWarpConfigDto, EvmNetworkOptions, Forbidden, FullNativeTransactionDetails, Geolocation, GetChainResponse, GetEvmBlockResponse, GetNativeBalanceResponse, GetNetworkDetailsResponse, GetPrimaryNetworkBlockResponse, GetTransactionResponse, HistoricalReward, IcmDestinationTransaction, IcmReceipt, IcmSourceTransaction, ImageAsset, InternalServerError, InternalTransaction, InternalTransactionDetails, L1ValidatorDetailsFull, L1ValidatorDetailsTransaction, L1ValidatorManagerDetails, LastActivityTimestamp, ListAddressChainsResponse, ListBlockchainsResponse, ListCChainAtomicBalancesResponse, ListCChainAtomicTransactionsResponse, ListChainsResponse, ListCollectibleBalancesResponse, ListContractsResponse, ListDelegatorDetailsResponse, ListErc1155BalancesResponse, ListErc1155TransactionsResponse, ListErc20BalancesResponse, ListErc20TransactionsResponse, ListErc721BalancesResponse, ListErc721TransactionsResponse, ListEvmBlocksResponse, ListHistoricalRewardsResponse, ListIcmMessagesResponse, ListInternalTransactionsResponse, ListL1ValidatorsResponse, ListNativeTransactionsResponse, ListNftTokens, ListPChainBalancesResponse, ListPChainTransactionsResponse, ListPChainUtxosResponse, ListPendingRewardsResponse, ListPrimaryNetworkBlocksResponse, ListSubnetsResponse, ListTeleporterMessagesResponse, ListTransactionDetailsResponse, ListTransactionDetailsResponseV2, ListTransfersResponse, ListUtxosResponse, ListValidatorDetailsResponse, ListWebhookAddressesResponse, ListWebhooksResponse, ListXChainBalancesResponse, ListXChainTransactionsResponse, ListXChainVerticesResponse, Log, LogsFormat, LogsFormatMetadata, LogsResponseDTO, Method, Metric, Money, NativeTokenBalance, NativeTransaction, NetworkToken, NetworkTokenDetails, NetworkTokenInfo, NextPageToken, NotFound, OpenAPIConfig, OperationStatusResponse, PChainBalance, PChainSharedAsset, PChainTransaction, PChainUtxo, PendingReward, PricingProviders, PrimaryNetworkAddressActivityMetadata, PrimaryNetworkAddressActivityResponse, PrimaryNetworkAddressActivitySubEvents, PrimaryNetworkAddressesBodyDto, PrimaryNetworkBalanceThresholdFilter, PrimaryNetworkBlock, PrimaryNetworkChainInfo, PrimaryNetworkOptions, ProposerDetails, ResourceLink, Rewards, RichAddress, RpcMetrics, ServiceUnavailable, SharedSecretsResponse, SignatureAggregationResponse, SignatureAggregatorRequest, StakingDistribution, Subnet, SubnetOwnershipInfo, SubnetRpcUsageMetricsResponseDTO, TeleporterDestinationTransaction, TeleporterMessageInfo, TeleporterReceipt, TeleporterSourceTransaction, TooManyRequests, Transaction, TransactionDetails, TransactionDetailsV2, TransactionEvent, TransactionExportMetadata, TransactionVertexDetail, Unauthorized, UpdateWebhookRequest, UsageMetricsResponseDTO, UtilityAddresses, Utxo, UtxoCredential, ValidatorActivityMetadata, ValidatorActivityResponse, ValidatorActivitySubEvents, ValidatorHealthDetails, ValidatorsDetails, WebhookInternalTransaction, XChainAssetDetails, XChainBalances, XChainSharedAssetBalance, XChainVertex };
|
|
7315
|
+
export { ActiveDelegatorDetails, ActiveValidatorDetails, AddressActivityEventType, ApiError, ApiFeature, AutoRenewExitReason, AutoRenewState, AvaxSupplyService, BaseHttpRequest, BlockchainId, BlockchainIds, CChainExportTransaction, CChainImportTransaction, CancelError, CancelablePromise, ChainStatus, CommonBalanceType, CompletedDelegatorDetails, CompletedValidatorDetails, CurrencyCode, DataApiUsageMetricsService, DelegationStatusType, DeliveredIcmMessage, DeliveredSourceNotIndexedIcmMessage, DeliveredSourceNotIndexedTeleporterMessage, DeliveredTeleporterMessage, EVMAddressActivityRequest, EVMOperationType, Erc1155Contract, Erc1155Token, Erc1155TokenBalance, Erc20Contract, Erc20Token, Erc20TokenBalance, Erc20TokenV2, Erc721Contract, Erc721Token, Erc721TokenBalance, EvmBalancesService, EvmBlocksService, EvmChainsService, EvmContractsService, EvmTransactionsService, FetchHttpRequest, Glacier, HealthCheckResultDto, HealthCheckService, HealthIndicatorResultDto, IcmRewardDetails, InterchainMessagingService, InternalTransactionOpCall, Network, NfTsService, NftTokenMetadataStatus, OpenAPI, OperationStatus, OperationStatusCode, OperationType, OperationsService, PChainId, PChainTransactionType, PendingDelegatorDetails, PendingIcmMessage, PendingTeleporterMessage, PendingValidatorDetails, PlatformAddressActivityKeyType, PrimaryNetworkAddressActivityEventType, PrimaryNetworkAddressActivityRequest, PrimaryNetworkAddressActivitySubEventType, PrimaryNetworkAssetCap, PrimaryNetworkAssetType, PrimaryNetworkBalancesService, PrimaryNetworkBlocksService, PrimaryNetworkChainName, PrimaryNetworkOperationType, PrimaryNetworkRewardsService, PrimaryNetworkRpcMetricsGroupByEnum, PrimaryNetworkRpcTimeIntervalGranularity, PrimaryNetworkRpcUsageMetricsResponseDTO, PrimaryNetworkService, PrimaryNetworkTransactionsService, PrimaryNetworkTxType, PrimaryNetworkType, PrimaryNetworkUtxOsService, PrimaryNetworkVerticesService, RemovedValidatorDetails, RequestType, ResourceLinkType, RewardType, RpcUsageMetricsGroupByEnum, RpcUsageMetricsValueAggregated, SignatureAggregatorService, SortByOption, SortOrder, StakingType, SubnetRpcTimeIntervalGranularity, TeleporterRewardDetails, TeleporterService, TimeIntervalGranularityExtended, TransactionDirectionType, TransactionMethodType, TransactionStatus, UnknownContract, UsageMetricsGroupByEnum, UsageMetricsValueDTO, UtxoType, UtxosSortByOption, ValidationStatusType, ValidatorActivityEventType, ValidatorActivityKeyType, ValidatorActivityRequest, VmName, WebhookAddressActivityResponse, WebhookStatus, WebhookStatusType, WebhooksService, XChainId, XChainLinearTransaction, XChainNonLinearTransaction, XChainTransactionType };
|
|
7316
|
+
export type { AccessListData, AddressActivityMetadata, AddressesChangeRequest, AggregatedAssetAmount, ApiRequestOptions, AssetAmount, AssetWithPriceInfo, AutoRenewDetails, AvaxSupplyResponse, BadGateway, BadRequest, BalanceOwner, Blockchain, BlockchainInfo, BlsCredentials, CChainAtomicBalances, CChainSharedAssetBalance, ChainAddressChainIdMap, ChainAddressChainIdMapListResponse, ChainInfo, ContractDeploymentDetails, CreateEvmTransactionExportRequest, CreatePrimaryNetworkTransactionExportRequest, DataListChainsResponse, DelegatorsDetails, ERCToken, ERCTransfer, EVMAddressActivityResponse, EVMInput, EVMOutput, Erc1155TokenMetadata, Erc1155Transfer, Erc1155TransferDetails, Erc20Transfer, Erc20TransferDetails, Erc20TransferDetailsV2, Erc721TokenMetadata, Erc721Transfer, Erc721TransferDetails, EvmBlock, EvmGenesisAllocDto, EvmGenesisAllowListConfigDto, EvmGenesisConfigDto, EvmGenesisDto, EvmGenesisFeeConfigDto, EvmGenesisWarpConfigDto, EvmNetworkOptions, Forbidden, FullNativeTransactionDetails, Geolocation, GetChainResponse, GetEvmBlockResponse, GetNativeBalanceResponse, GetNetworkDetailsResponse, GetPrimaryNetworkBlockResponse, GetTransactionResponse, HistoricalReward, IcmDestinationTransaction, IcmReceipt, IcmSourceTransaction, ImageAsset, InternalServerError, InternalTransaction, InternalTransactionDetails, L1ValidatorDetailsFull, L1ValidatorDetailsTransaction, L1ValidatorManagerDetails, LastActivityTimestamp, ListAddressChainsResponse, ListBlockchainsResponse, ListCChainAtomicBalancesResponse, ListCChainAtomicTransactionsResponse, ListChainsResponse, ListCollectibleBalancesResponse, ListContractsResponse, ListDelegatorDetailsResponse, ListErc1155BalancesResponse, ListErc1155TransactionsResponse, ListErc20BalancesResponse, ListErc20TransactionsResponse, ListErc721BalancesResponse, ListErc721TransactionsResponse, ListEvmBlocksResponse, ListHistoricalRewardsResponse, ListIcmMessagesResponse, ListInternalTransactionsResponse, ListL1ValidatorsResponse, ListNativeTransactionsResponse, ListNftTokens, ListPChainBalancesResponse, ListPChainTransactionsResponse, ListPChainUtxosResponse, ListPendingRewardsResponse, ListPrimaryNetworkBlocksResponse, ListSubnetsResponse, ListTeleporterMessagesResponse, ListTransactionDetailsResponse, ListTransactionDetailsResponseV2, ListTransfersResponse, ListUtxosResponse, ListValidatorDetailsResponse, ListWebhookAddressesResponse, ListWebhooksResponse, ListXChainBalancesResponse, ListXChainTransactionsResponse, ListXChainVerticesResponse, Log, LogsFormat, LogsFormatMetadata, LogsResponseDTO, Method, Metric, Money, NativeTokenBalance, NativeTransaction, NetworkToken, NetworkTokenDetails, NetworkTokenInfo, NextPageToken, NotFound, OpenAPIConfig, OperationStatusResponse, PChainBalance, PChainSharedAsset, PChainTransaction, PChainUtxo, PendingReward, PricingProviders, PrimaryNetworkAddressActivityMetadata, PrimaryNetworkAddressActivityResponse, PrimaryNetworkAddressActivitySubEvents, PrimaryNetworkAddressesBodyDto, PrimaryNetworkBalanceThresholdFilter, PrimaryNetworkBlock, PrimaryNetworkChainInfo, PrimaryNetworkOptions, ProposerDetails, ResourceLink, Rewards, RichAddress, RpcMetrics, ServiceUnavailable, SharedSecretsResponse, SignatureAggregationResponse, SignatureAggregatorRequest, StakingDistribution, Subnet, SubnetOwnershipInfo, SubnetRpcUsageMetricsResponseDTO, TeleporterDestinationTransaction, TeleporterMessageInfo, TeleporterReceipt, TeleporterSourceTransaction, TooManyRequests, Transaction, TransactionDetails, TransactionDetailsV2, TransactionEvent, TransactionExportMetadata, TransactionVertexDetail, Unauthorized, UpdateWebhookRequest, UsageMetricsResponseDTO, UtilityAddresses, Utxo, UtxoCredential, ValidatorActivityMetadata, ValidatorActivityResponse, ValidatorActivitySubEvents, ValidatorHealthDetails, ValidatorsDetails, WebhookInternalTransaction, XChainAssetDetails, XChainBalances, XChainSharedAssetBalance, XChainVertex };
|
|
@@ -1,6 +1,8 @@
|
|
|
1
|
+
import { AutoRenewDetails } from './AutoRenewDetails.js';
|
|
1
2
|
import { BlsCredentials } from './BlsCredentials.js';
|
|
2
3
|
import { Geolocation } from './Geolocation.js';
|
|
3
4
|
import { Rewards } from './Rewards.js';
|
|
5
|
+
import { StakingType } from './StakingType.js';
|
|
4
6
|
import { ValidatorHealthDetails } from './ValidatorHealthDetails.js';
|
|
5
7
|
|
|
6
8
|
type ActiveValidatorDetails = {
|
|
@@ -14,6 +16,7 @@ type ActiveValidatorDetails = {
|
|
|
14
16
|
delegationFee?: string;
|
|
15
17
|
startTimestamp: number;
|
|
16
18
|
endTimestamp: number;
|
|
19
|
+
stakingType: StakingType;
|
|
17
20
|
/**
|
|
18
21
|
* Present for AddPermissionlessValidatorTx
|
|
19
22
|
*/
|
|
@@ -23,11 +26,11 @@ type ActiveValidatorDetails = {
|
|
|
23
26
|
*/
|
|
24
27
|
stakePercentage: number;
|
|
25
28
|
/**
|
|
26
|
-
* The number of delegators linked to the validator.
|
|
29
|
+
* The number of delegators linked to the validator. For `autoRenewed` validators this counts the current staking cycle only (a single validation period, like a fixed validator over its one period) — not a cumulative total across cycles.
|
|
27
30
|
*/
|
|
28
31
|
delegatorCount: number;
|
|
29
32
|
/**
|
|
30
|
-
* The total amount in nAVAX delegated to the validator.
|
|
33
|
+
* The total amount in nAVAX delegated to the validator. For `autoRenewed` validators this reflects the current staking cycle only (a single validation period), not a cumulative total across cycles.
|
|
31
34
|
*/
|
|
32
35
|
amountDelegated?: string;
|
|
33
36
|
/**
|
|
@@ -40,7 +43,9 @@ type ActiveValidatorDetails = {
|
|
|
40
43
|
*/
|
|
41
44
|
delegationCapacity?: string;
|
|
42
45
|
/**
|
|
43
|
-
* Estimated rewards for the validator if the validation is successful.
|
|
46
|
+
* Estimated rewards for the validator if the validation is successful. For `autoRenewed` validators the delegation portion (`delegationRewardAmount`) covers the current staking cycle only.
|
|
47
|
+
*
|
|
48
|
+
* For `autoRenewed` validators these amounts are **gross** — the whole reward the cycle is expected to earn, before any of it is restaked. The portion that will actually be paid out to the reward address is `gross * (100 - autoRenew.autoCompoundSharePercent) / 100`. Note this differs from `estimatedReward` on `/rewards::listPending`, which reports that withdrawn portion directly.
|
|
44
49
|
*/
|
|
45
50
|
potentialRewards: Rewards;
|
|
46
51
|
validationStatus: ActiveValidatorDetails.validationStatus;
|
|
@@ -49,6 +54,10 @@ type ActiveValidatorDetails = {
|
|
|
49
54
|
* The geographical location of the validator node, if available.
|
|
50
55
|
*/
|
|
51
56
|
geolocation: Geolocation | null;
|
|
57
|
+
/**
|
|
58
|
+
* Current-cycle renewal and compounding detail. Present only when stakingType is `autoRenewed`.
|
|
59
|
+
*/
|
|
60
|
+
autoRenew?: AutoRenewDetails;
|
|
52
61
|
};
|
|
53
62
|
declare namespace ActiveValidatorDetails {
|
|
54
63
|
enum validationStatus {
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { AutoRenewExitReason } from './AutoRenewExitReason.js';
|
|
2
|
+
import { AutoRenewState } from './AutoRenewState.js';
|
|
3
|
+
|
|
4
|
+
type AutoRenewDetails = {
|
|
5
|
+
state: AutoRenewState;
|
|
6
|
+
/**
|
|
7
|
+
* Length of the next cycle in seconds. `0` = graceful exit armed at the end of the current cycle.
|
|
8
|
+
*/
|
|
9
|
+
nextPeriodSeconds: number;
|
|
10
|
+
/**
|
|
11
|
+
* 0-100. Share of each cycle's rewards that is restaked (compounded into validator weight).
|
|
12
|
+
*/
|
|
13
|
+
autoCompoundSharePercent: number;
|
|
14
|
+
/**
|
|
15
|
+
* Current weight in nAVAX including all restaked rewards. Equals the top-level `amountStaked`.
|
|
16
|
+
*/
|
|
17
|
+
compoundedWeight: string;
|
|
18
|
+
/**
|
|
19
|
+
* Cumulative validation rewards restaked from prior cycles, in nAVAX.
|
|
20
|
+
*/
|
|
21
|
+
accruedValidationRewards: string;
|
|
22
|
+
/**
|
|
23
|
+
* Cumulative delegatee commission restaked from prior cycles, in nAVAX.
|
|
24
|
+
*/
|
|
25
|
+
accruedDelegateeRewards: string;
|
|
26
|
+
/**
|
|
27
|
+
* Reward owner addresses (validation).
|
|
28
|
+
*/
|
|
29
|
+
validationRewardAddresses: Array<string>;
|
|
30
|
+
/**
|
|
31
|
+
* Reward owner addresses (delegation).
|
|
32
|
+
*/
|
|
33
|
+
delegationRewardAddresses: Array<string>;
|
|
34
|
+
exitReason: AutoRenewExitReason | null;
|
|
35
|
+
/**
|
|
36
|
+
* When it exited/aborted; null while still active.
|
|
37
|
+
*/
|
|
38
|
+
endedAtTimestamp: any | null;
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
export type { AutoRenewDetails };
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Why the validation ended. `graceful` = exited after being configured to stop renewing; `uptime_not_met` = removed because reward eligibility was not met. Null while still active (`renewing` or `exiting`). `state` carries the same distinction (`exited` vs `aborted`).
|
|
3
|
+
*/
|
|
4
|
+
declare enum AutoRenewExitReason {
|
|
5
|
+
GRACEFUL = "graceful",
|
|
6
|
+
UPTIME_NOT_MET = "uptime_not_met"
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export { AutoRenewExitReason };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var e=(e=>(e.GRACEFUL="graceful",e.UPTIME_NOT_MET="uptime_not_met",e))(e||{});export{e as AutoRenewExitReason};
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Current-cycle lifecycle. `renewing` = active, will roll into another cycle; `exiting` = active in its final cycle (graceful exit armed) with validationStatus still `active`; `exited`/`aborted` = ended.
|
|
3
|
+
*/
|
|
4
|
+
declare enum AutoRenewState {
|
|
5
|
+
RENEWING = "renewing",
|
|
6
|
+
EXITING = "exiting",
|
|
7
|
+
EXITED = "exited",
|
|
8
|
+
ABORTED = "aborted"
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export { AutoRenewState };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var e=(e=>(e.RENEWING="renewing",e.EXITING="exiting",e.EXITED="exited",e.ABORTED="aborted",e))(e||{});export{e as AutoRenewState};
|
|
@@ -1,5 +1,7 @@
|
|
|
1
|
+
import { AutoRenewDetails } from './AutoRenewDetails.js';
|
|
1
2
|
import { BlsCredentials } from './BlsCredentials.js';
|
|
2
3
|
import { Rewards } from './Rewards.js';
|
|
4
|
+
import { StakingType } from './StakingType.js';
|
|
3
5
|
|
|
4
6
|
type CompletedValidatorDetails = {
|
|
5
7
|
txHash: string;
|
|
@@ -12,14 +14,30 @@ type CompletedValidatorDetails = {
|
|
|
12
14
|
delegationFee?: string;
|
|
13
15
|
startTimestamp: number;
|
|
14
16
|
endTimestamp: number;
|
|
17
|
+
stakingType: StakingType;
|
|
15
18
|
/**
|
|
16
19
|
* Present for AddPermissionlessValidatorTx
|
|
17
20
|
*/
|
|
18
21
|
blsCredentials?: BlsCredentials;
|
|
22
|
+
/**
|
|
23
|
+
* The number of delegators linked to the validator. For `autoRenewed` validators this reflects the final staking cycle (a single validation period), not a cumulative total across cycles.
|
|
24
|
+
*/
|
|
19
25
|
delegatorCount: number;
|
|
26
|
+
/**
|
|
27
|
+
* The total amount in nAVAX delegated to the validator. For `autoRenewed` validators this reflects the final staking cycle.
|
|
28
|
+
*/
|
|
20
29
|
amountDelegated?: string;
|
|
30
|
+
/**
|
|
31
|
+
* Rewards for the validator. For `autoRenewed` validators the delegation portion covers the final staking cycle.
|
|
32
|
+
*
|
|
33
|
+
* As with `potentialRewards` on an active validator, for `autoRenewed` validators these amounts are **gross** — before the restaked share is deducted.
|
|
34
|
+
*/
|
|
21
35
|
rewards: Rewards;
|
|
22
36
|
validationStatus: CompletedValidatorDetails.validationStatus;
|
|
37
|
+
/**
|
|
38
|
+
* Final-cycle renewal and compounding detail for an auto-renewed validator that has exited/aborted. Present only when stakingType is `autoRenewed`.
|
|
39
|
+
*/
|
|
40
|
+
autoRenew?: AutoRenewDetails;
|
|
23
41
|
};
|
|
24
42
|
declare namespace CompletedValidatorDetails {
|
|
25
43
|
enum validationStatus {
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { AssetWithPriceInfo } from './AssetWithPriceInfo.js';
|
|
2
2
|
import { RewardType } from './RewardType.js';
|
|
3
|
+
import { StakingType } from './StakingType.js';
|
|
3
4
|
|
|
4
5
|
type HistoricalReward = {
|
|
5
6
|
/**
|
|
@@ -7,11 +8,15 @@ type HistoricalReward = {
|
|
|
7
8
|
*/
|
|
8
9
|
addresses: Array<string>;
|
|
9
10
|
txHash: string;
|
|
11
|
+
/**
|
|
12
|
+
* Amount staked by the validator this reward comes from. For autoRenewed validators this is the position's compounded weight, so it is the same on every cycle rather than the weight held during that particular cycle — per-cycle weight is not recorded on chain.
|
|
13
|
+
*/
|
|
10
14
|
amountStaked: string;
|
|
11
15
|
nodeId: string;
|
|
12
16
|
startTimestamp: number;
|
|
13
17
|
endTimestamp: number;
|
|
14
18
|
rewardType: RewardType;
|
|
19
|
+
stakingType: StakingType;
|
|
15
20
|
utxoId: string;
|
|
16
21
|
outputIndex: number;
|
|
17
22
|
reward: AssetWithPriceInfo;
|
|
@@ -26,6 +26,12 @@ type PChainBalance = {
|
|
|
26
26
|
* A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of staked Avax whose staking period has not yet started.
|
|
27
27
|
*/
|
|
28
28
|
pendingStaked: Array<AggregatedAssetAmount>;
|
|
29
|
+
/**
|
|
30
|
+
* Total AVAX (in nAVAX) restaked into auto-renewed validators via compounding. These rewards are bonded into validator weight and have no UTXO until the validator exits, so they are reported here as a separate amount (always AVAX). Add to unlockedStaked/lockedStaked for an auto-renewed validator's full current staked value.
|
|
31
|
+
*
|
|
32
|
+
* Current-balance queries only. The field is OMITTED for historical queries, i.e. when blockTimestamp is supplied with a value greater than 0, because compounding history is not reconstructable from current-state data. Absence therefore means "not available for this timestamp" — it does not mean nothing was compounded. A current-balance query for an address with no auto-renewed position returns "0". Note blockTimestamp=0 is treated as "no timestamp supplied" and is answered as a current-balance query.
|
|
33
|
+
*/
|
|
34
|
+
restakedRewards?: string;
|
|
29
35
|
/**
|
|
30
36
|
* A list of objects containing P-chain Asset basic info, amount and utxo count of that Asset ID. Denotes the amount of unlocked Avax in the atomic memory between P-Chain and other chain.
|
|
31
37
|
*/
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { AssetAmount } from './AssetAmount.js';
|
|
2
|
+
import { BalanceOwner } from './BalanceOwner.js';
|
|
2
3
|
import { BlockchainInfo } from './BlockchainInfo.js';
|
|
3
4
|
import { BlsCredentials } from './BlsCredentials.js';
|
|
4
5
|
import { L1ValidatorDetailsTransaction } from './L1ValidatorDetailsTransaction.js';
|
|
@@ -47,7 +48,7 @@ type PChainTransaction = {
|
|
|
47
48
|
*/
|
|
48
49
|
amountBurned: Array<AssetAmount>;
|
|
49
50
|
/**
|
|
50
|
-
* A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
51
|
+
* A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
|
|
51
52
|
*/
|
|
52
53
|
amountStaked: Array<AssetAmount>;
|
|
53
54
|
/**
|
|
@@ -55,19 +56,19 @@ type PChainTransaction = {
|
|
|
55
56
|
*/
|
|
56
57
|
amountL1ValidatorBalanceBurned: Array<AssetAmount>;
|
|
57
58
|
/**
|
|
58
|
-
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
59
|
+
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx. For AddAutoRenewedValidatorTx this reflects the cycle the validator is currently serving, so it advances on each renewal; use blockTimestamp for when the position was first created.
|
|
59
60
|
*/
|
|
60
61
|
startTimestamp?: number;
|
|
61
62
|
/**
|
|
62
|
-
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
63
|
+
* Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx. For AddAutoRenewedValidatorTx this reflects the cycle the validator is currently serving, so it advances on each renewal.
|
|
63
64
|
*/
|
|
64
65
|
endTimestamp?: number;
|
|
65
66
|
/**
|
|
66
|
-
* The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx
|
|
67
|
+
* The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
|
|
67
68
|
*/
|
|
68
69
|
delegationFeePercent?: string;
|
|
69
70
|
/**
|
|
70
|
-
* The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
71
|
+
* The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
|
|
71
72
|
*/
|
|
72
73
|
nodeId?: string;
|
|
73
74
|
/**
|
|
@@ -83,7 +84,7 @@ type PChainTransaction = {
|
|
|
83
84
|
*/
|
|
84
85
|
l1ValidatorDetails?: Array<L1ValidatorDetailsTransaction>;
|
|
85
86
|
/**
|
|
86
|
-
* Estimated reward from the staking transaction, if successful. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx
|
|
87
|
+
* Estimated reward from the staking transaction, if successful. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx (the cycle the validator is currently serving), and each RewardAutoRenewedValidatorTx (the estimate for the next cycle it starts).
|
|
87
88
|
*/
|
|
88
89
|
estimatedReward?: string;
|
|
89
90
|
/**
|
|
@@ -93,7 +94,7 @@ type PChainTransaction = {
|
|
|
93
94
|
rewardAddresses?: Array<string>;
|
|
94
95
|
memo?: string;
|
|
95
96
|
/**
|
|
96
|
-
* Staking transaction corresponding to the RewardValidatorTx
|
|
97
|
+
* Staking transaction corresponding to the RewardValidatorTx, or the originating AddAutoRenewedValidatorTx for a RewardAutoRenewedValidatorTx
|
|
97
98
|
*/
|
|
98
99
|
stakingTxHash?: string;
|
|
99
100
|
/**
|
|
@@ -101,13 +102,25 @@ type PChainTransaction = {
|
|
|
101
102
|
*/
|
|
102
103
|
subnetOwnershipInfo?: SubnetOwnershipInfo;
|
|
103
104
|
/**
|
|
104
|
-
* Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx
|
|
105
|
+
* Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
|
|
105
106
|
*/
|
|
106
107
|
blsCredentials?: BlsCredentials;
|
|
107
108
|
/**
|
|
108
109
|
* Details of the blockchain that was created in the CreateChainTx
|
|
109
110
|
*/
|
|
110
111
|
blockchainInfo?: BlockchainInfo;
|
|
112
|
+
/**
|
|
113
|
+
* Length of an auto-renewed validation cycle, in seconds. Present for AddAutoRenewedValidatorTx and SetAutoRenewedValidatorConfigTx. A value of 0 on SetAutoRenewedValidatorConfigTx indicates validation will attempt a graceful exit at the end of the current cycle.
|
|
114
|
+
*/
|
|
115
|
+
period?: number;
|
|
116
|
+
/**
|
|
117
|
+
* Fraction of each cycle’s rewards that is restaked (compounded into validator weight) rather than withdrawn, expressed in millionths (0–1000000). Present for AddAutoRenewedValidatorTx and SetAutoRenewedValidatorConfigTx.
|
|
118
|
+
*/
|
|
119
|
+
autoCompoundRewardShares?: number;
|
|
120
|
+
/**
|
|
121
|
+
* Owner (addresses + signature threshold) authorized to reconfigure or exit the auto-renewed validator via SetAutoRenewedValidatorConfigTx. Present for AddAutoRenewedValidatorTx.
|
|
122
|
+
*/
|
|
123
|
+
validatorAuthority?: BalanceOwner;
|
|
111
124
|
};
|
|
112
125
|
|
|
113
126
|
export type { PChainTransaction };
|
|
@@ -19,6 +19,9 @@ declare enum PChainTransactionType {
|
|
|
19
19
|
SET_L1VALIDATOR_WEIGHT_TX = "SetL1ValidatorWeightTx",
|
|
20
20
|
DISABLE_L1VALIDATOR_TX = "DisableL1ValidatorTx",
|
|
21
21
|
INCREASE_L1VALIDATOR_BALANCE_TX = "IncreaseL1ValidatorBalanceTx",
|
|
22
|
+
ADD_AUTO_RENEWED_VALIDATOR_TX = "AddAutoRenewedValidatorTx",
|
|
23
|
+
SET_AUTO_RENEWED_VALIDATOR_CONFIG_TX = "SetAutoRenewedValidatorConfigTx",
|
|
24
|
+
REWARD_AUTO_RENEWED_VALIDATOR_TX = "RewardAutoRenewedValidatorTx",
|
|
22
25
|
UNKNOWN = "UNKNOWN"
|
|
23
26
|
}
|
|
24
27
|
|