@avalabs/glacier-sdk 3.1.0-alpha.96 → 3.1.0-alpha.97

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.d.ts CHANGED
@@ -3552,6 +3552,148 @@ type GetNetworkDetailsResponse = {
3552
3552
  delegatorDetails: DelegatorsDetails;
3553
3553
  };
3554
3554
 
3555
+ /**
3556
+ * How this cycle ended. `renewed` = rolled into another cycle; `exited` = final cycle of a graceful exit; `aborted` = reward eligibility not met.
3557
+ */
3558
+ declare enum AutoRenewedCycleOutcome {
3559
+ RENEWED = "renewed",
3560
+ EXITED = "exited",
3561
+ ABORTED = "aborted"
3562
+ }
3563
+
3564
+ type AutoRenewedCycle = {
3565
+ /**
3566
+ * 1-based sequence within this position. A node that has held more than one auto-renewed position has more than one cycle 1, so group by `stakingTxHash` or filter with the `txHash` query param.
3567
+ */
3568
+ cycleIndex: number;
3569
+ /**
3570
+ * The transaction that settled this cycle. Present even when the cycle paid nothing out, which is what makes a fully-compounding cycle visible.
3571
+ */
3572
+ rewardTxHash: string;
3573
+ /**
3574
+ * The originating AddAutoRenewedValidatorTx. Identifies the position, and is shared by every cycle of it.
3575
+ */
3576
+ stakingTxHash: string;
3577
+ /**
3578
+ * This cycle's window start, unix seconds.
3579
+ */
3580
+ startTimestamp: number;
3581
+ /**
3582
+ * This cycle's window end, unix seconds.
3583
+ */
3584
+ endTimestamp: number;
3585
+ /**
3586
+ * Weight bonded for this cycle in nAVAX, before this cycle's own rewards were compounded into it. The denominator for per-cycle yield.
3587
+ */
3588
+ weightAtCycleStart: string;
3589
+ /**
3590
+ * Validation reward earned this cycle, in nAVAX. `"0"` when the cycle was aborted, since the reward is forfeited. Excludes rewards earned in earlier cycles.
3591
+ */
3592
+ grossValidationReward: string;
3593
+ /**
3594
+ * Portion paid out as a reward UTXO, in nAVAX.
3595
+ */
3596
+ withdrawnValidationReward: string;
3597
+ /**
3598
+ * Portion restaked into validator weight, in nAVAX. Produces no UTXO. May be below `share x gross` when restaking would exceed the maximum validator stake.
3599
+ */
3600
+ compoundedValidationReward: string;
3601
+ /**
3602
+ * Delegatee commission earned this cycle, in nAVAX. Still paid when the cycle is aborted. `"0"` when the validator had no delegators.
3603
+ */
3604
+ grossDelegateeReward: string;
3605
+ /**
3606
+ * Commission paid out, in nAVAX.
3607
+ */
3608
+ withdrawnDelegateeReward: string;
3609
+ /**
3610
+ * Commission restaked into weight, in nAVAX.
3611
+ */
3612
+ compoundedDelegateeReward: string;
3613
+ /**
3614
+ * 0-100. The share in effect during this cycle, not the current one.
3615
+ */
3616
+ autoCompoundSharePercent: number;
3617
+ outcome: AutoRenewedCycleOutcome;
3618
+ /**
3619
+ * Delegations overlapping this cycle's window. A delegation covering part of the cycle counts the same as one covering all of it.
3620
+ */
3621
+ delegatorCount: number;
3622
+ /**
3623
+ * Total weight of those delegations in nAVAX. Not included in `weightAtCycleStart`.
3624
+ */
3625
+ amountDelegated: string;
3626
+ };
3627
+
3628
+ /**
3629
+ * `renewing` = will roll into another cycle; `exiting` = graceful exit armed, this is the final cycle. Not an outcome - the cycle can still abort on reward eligibility.
3630
+ */
3631
+ declare enum AutoRenewState {
3632
+ RENEWING = "renewing",
3633
+ EXITING = "exiting",
3634
+ EXITED = "exited",
3635
+ ABORTED = "aborted"
3636
+ }
3637
+
3638
+ type CurrentAutoRenewedCycle = {
3639
+ /**
3640
+ * 1-based sequence within this position. The settled cycles in `cycles` run from 1 to this value minus one.
3641
+ */
3642
+ cycleIndex: number;
3643
+ /**
3644
+ * The originating AddAutoRenewedValidatorTx for this position.
3645
+ */
3646
+ stakingTxHash: string;
3647
+ /**
3648
+ * This cycle's window start, unix seconds.
3649
+ */
3650
+ startTimestamp: number;
3651
+ /**
3652
+ * This cycle's window end, unix seconds. A delegation into this validator must end within it.
3653
+ */
3654
+ endTimestamp: number;
3655
+ /**
3656
+ * Weight bonded for this cycle in nAVAX. Rewards compound into weight only at settlement, so this is stable for the whole cycle.
3657
+ */
3658
+ weightAtCycleStart: string;
3659
+ /**
3660
+ * Forecast validation reward for the **whole** cycle in nAVAX, minted at cycle start. Not an amount earned so far, and not comparable to a settled cycle's `grossValidationReward` until this cycle settles. Do not add it to sums over `cycles`.
3661
+ */
3662
+ projectedValidationReward: string;
3663
+ /**
3664
+ * Delegatee commission already accrued this cycle, in nAVAX, from delegations that have settled within it. Unlike the validation reward this is realised, not forecast; delegations still running contribute nothing yet.
3665
+ */
3666
+ accruedDelegateeReward: string;
3667
+ /**
3668
+ * 0-100. The share that will apply when this cycle settles. A SetAutoRenewedValidatorConfigTx mid-cycle changes it, so it is not final until settlement.
3669
+ */
3670
+ autoCompoundSharePercent: number;
3671
+ state: AutoRenewState;
3672
+ /**
3673
+ * Delegations overlapping this cycle's window.
3674
+ */
3675
+ delegatorCount: number;
3676
+ /**
3677
+ * Total weight of those delegations in nAVAX. Not included in `weightAtCycleStart`.
3678
+ */
3679
+ amountDelegated: string;
3680
+ };
3681
+
3682
+ type ListAutoRenewedCyclesResponse = {
3683
+ /**
3684
+ * A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
3685
+ */
3686
+ nextPageToken?: string;
3687
+ /**
3688
+ * Settled cycles, newest first by default. Empty for a node with no auto-renewed validation. The in-flight cycle is not included; it is on the validator object.
3689
+ */
3690
+ cycles: Array<AutoRenewedCycle>;
3691
+ /**
3692
+ * The cycle in flight. Absent when the position has ended, and on any page but the first.
3693
+ */
3694
+ currentCycle?: CurrentAutoRenewedCycle;
3695
+ };
3696
+
3555
3697
  type ListBlockchainsResponse = {
3556
3698
  /**
3557
3699
  * A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
@@ -3765,16 +3907,6 @@ declare enum AutoRenewExitReason {
3765
3907
  UPTIME_NOT_MET = "uptime_not_met"
3766
3908
  }
3767
3909
 
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
3910
  type AutoRenewDetails = {
3779
3911
  state: AutoRenewState;
3780
3912
  /**
@@ -3782,11 +3914,11 @@ type AutoRenewDetails = {
3782
3914
  */
3783
3915
  nextPeriodSeconds: number;
3784
3916
  /**
3785
- * 0-100. Share of each cycle's rewards that is restaked (compounded into validator weight).
3917
+ * Share of each cycle's rewards that is restaked (compounded into validator weight), as a percent from 0 to 100 (not millionths/ppm, e.g. 90 means 90%).
3786
3918
  */
3787
3919
  autoCompoundSharePercent: number;
3788
3920
  /**
3789
- * Current weight in nAVAX including all restaked rewards. Equals the top-level `amountStaked`.
3921
+ * Current validator weight in nAVAX: the original stake plus all rewards restaked across prior cycles.
3790
3922
  */
3791
3923
  compoundedWeight: string;
3792
3924
  /**
@@ -4342,6 +4474,44 @@ declare class PrimaryNetworkService {
4342
4474
  */
4343
4475
  sortOrder?: SortOrder;
4344
4476
  }): CancelablePromise<ListValidatorDetailsResponse>;
4477
+ /**
4478
+ * List auto-renewed validator cycles
4479
+ * Lists the settled staking cycles of an auto-renewed (ACP-236) validator, newest first. Each cycle reports the weight bonded for that cycle and the gross / withdrawn / compounded split of its rewards.
4480
+ *
4481
+ * Includes cycles that paid nothing out. A fully-compounding cycle mints no reward UTXO and so does not appear in reward history at all.
4482
+ *
4483
+ * The in-flight cycle is not listed; it is on the validator object. Returns an empty list for a node with no auto-renewed validation.
4484
+ *
4485
+ * `cycleIndex` is 1-based per position, so a node that has held more than one auto-renewed position has more than one cycle 1. Group by `stakingTxHash`, or pass `txHash` for a single series.
4486
+ * @returns ListAutoRenewedCyclesResponse Successful response
4487
+ * @throws ApiError
4488
+ */
4489
+ listAutoRenewedValidatorCycles({ network, nodeId, txHash, pageToken, pageSize, sortOrder, }: {
4490
+ /**
4491
+ * Either mainnet or testnet/fuji.
4492
+ */
4493
+ network: Network;
4494
+ /**
4495
+ * A primary network (P or X chain) nodeId.
4496
+ */
4497
+ nodeId: string;
4498
+ /**
4499
+ * Restrict results to a single auto-renewed position, given its `AddAutoRenewedValidatorTx` hash. Only needed for a node that has held more than one auto-renewed validation, where `cycleIndex` restarts at 1 per position.
4500
+ */
4501
+ txHash?: string;
4502
+ /**
4503
+ * A page token, received from a previous list call. Provide this to retrieve the subsequent page.
4504
+ */
4505
+ pageToken?: string;
4506
+ /**
4507
+ * The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
4508
+ */
4509
+ pageSize?: number;
4510
+ /**
4511
+ * The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the `sortBy` query parameter, if provided.
4512
+ */
4513
+ sortOrder?: SortOrder;
4514
+ }): CancelablePromise<ListAutoRenewedCyclesResponse>;
4345
4515
  /**
4346
4516
  * List delegators
4347
4517
  * Lists details for delegators.
@@ -5341,6 +5511,134 @@ type PChainUtxo = {
5341
5511
  utxoType: UtxoType;
5342
5512
  };
5343
5513
 
5514
+ type PChainStakingTransaction = {
5515
+ /**
5516
+ * A P-Chain transaction hash.
5517
+ */
5518
+ txHash: string;
5519
+ txType: PChainTransactionType;
5520
+ /**
5521
+ * The block creation (proposal) timestamp in seconds
5522
+ */
5523
+ blockTimestamp: number;
5524
+ /**
5525
+ * The height of the block in which the transaction was included
5526
+ */
5527
+ blockNumber: string;
5528
+ blockHash: string;
5529
+ /**
5530
+ * The consumed UTXOs of the transaction
5531
+ */
5532
+ consumedUtxos: Array<PChainUtxo>;
5533
+ /**
5534
+ * The newly created UTXOs of the transaction
5535
+ */
5536
+ emittedUtxos: Array<PChainUtxo>;
5537
+ /**
5538
+ * Source chain for an atomic transaction.
5539
+ */
5540
+ sourceChain?: string;
5541
+ /**
5542
+ * Destination chain for an atomic transaction.
5543
+ */
5544
+ destinationChain?: string;
5545
+ /**
5546
+ * A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The amount of nAVAX present in the newly created UTXOs of the transaction
5547
+ */
5548
+ value: Array<AssetAmount>;
5549
+ /**
5550
+ * A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The nAVAX amount burned in a transaction, partially or fully contributing to the transaction fee
5551
+ */
5552
+ amountBurned: Array<AssetAmount>;
5553
+ /**
5554
+ * A list of objects containing P-chain Asset basic info and the amount of that Asset ID. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
5555
+ */
5556
+ amountStaked: Array<AssetAmount>;
5557
+ /**
5558
+ * A list of objects containing P-chain Asset basic info and the amount of that Asset ID. The amount of nAVAX locked for pay-as-you-go continuous fees to sustain L1 validation.
5559
+ */
5560
+ amountL1ValidatorBalanceBurned: Array<AssetAmount>;
5561
+ /**
5562
+ * 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.
5563
+ */
5564
+ startTimestamp?: number;
5565
+ /**
5566
+ * Present for AddValidatorTx, AddSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx. For AddAutoRenewedValidatorTx this reflects the cycle the validator is currently serving, so it advances on each renewal.
5567
+ */
5568
+ endTimestamp?: number;
5569
+ /**
5570
+ * The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations. Present for AddValidatorTx, AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
5571
+ */
5572
+ delegationFeePercent?: string;
5573
+ /**
5574
+ * The NodeID of the validator node linked to the stake transaction. Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, AddAutoRenewedValidatorTx
5575
+ */
5576
+ nodeId?: string;
5577
+ /**
5578
+ * Present for AddValidatorTx, AddSubnetValidatorTx, RemoveSubnetValidatorTx, AddPermissionlessValidatorTx, AddDelegatorTx, CreateChainTx, CreateSubnetTx
5579
+ */
5580
+ subnetId?: string;
5581
+ /**
5582
+ * Details of the L1's validator manager contract and blockchain. Present for the ConvertSubnetToL1Tx which transforms a subnet into L1
5583
+ */
5584
+ l1ValidatorManagerDetails?: L1ValidatorManagerDetails;
5585
+ /**
5586
+ * Details of L1 validators registered or changed in the current transaction. The details reflect the state at the time of the transaction, not in real-time
5587
+ */
5588
+ l1ValidatorDetails?: Array<L1ValidatorDetailsTransaction>;
5589
+ /**
5590
+ * 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).
5591
+ */
5592
+ estimatedReward?: string;
5593
+ /**
5594
+ * Reward transaction hash for the completed validations or delegations
5595
+ */
5596
+ rewardTxHash?: string;
5597
+ rewardAddresses?: Array<string>;
5598
+ memo?: string;
5599
+ /**
5600
+ * Staking transaction corresponding to the RewardValidatorTx, or the originating AddAutoRenewedValidatorTx for a RewardAutoRenewedValidatorTx
5601
+ */
5602
+ stakingTxHash?: string;
5603
+ /**
5604
+ * Subnet owner details for the CreateSubnetTx or TransferSubnetOwnershipTx
5605
+ */
5606
+ subnetOwnershipInfo?: SubnetOwnershipInfo;
5607
+ /**
5608
+ * Public Key and PoP of new validator registrations. Present for AddPermissionlessValidatorTx, AddAutoRenewedValidatorTx
5609
+ */
5610
+ blsCredentials?: BlsCredentials;
5611
+ /**
5612
+ * Details of the blockchain that was created in the CreateChainTx
5613
+ */
5614
+ blockchainInfo?: BlockchainInfo;
5615
+ /**
5616
+ * 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.
5617
+ */
5618
+ period?: number;
5619
+ /**
5620
+ * 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.
5621
+ */
5622
+ autoCompoundRewardShares?: number;
5623
+ /**
5624
+ * Owner (addresses + signature threshold) authorized to reconfigure or exit the auto-renewed validator via SetAutoRenewedValidatorConfigTx. Present for AddAutoRenewedValidatorTx.
5625
+ */
5626
+ validatorAuthority?: BalanceOwner;
5627
+ /**
5628
+ * Present only for an active auto-renewed validator (AddAutoRenewedValidatorTx). The validator's current live auto-renew state and latest/next-cycle config, different from the initial `period`/`autoCompoundRewardShares`.
5629
+ */
5630
+ autoRenew?: AutoRenewDetails;
5631
+ };
5632
+
5633
+ type ListPChainStakingTransactionsResponse = {
5634
+ /**
5635
+ * A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
5636
+ */
5637
+ nextPageToken?: string;
5638
+ transactions: Array<PChainStakingTransaction>;
5639
+ chainInfo: PrimaryNetworkChainInfo;
5640
+ };
5641
+
5344
5642
  type PChainTransaction = {
5345
5643
  /**
5346
5644
  * A P-Chain transaction hash.
@@ -5726,7 +6024,7 @@ declare class PrimaryNetworkTransactionsService {
5726
6024
  /**
5727
6025
  * List staking transactions
5728
6026
  * Lists active staking transactions on the P-Chain for the supplied addresses.
5729
- * @returns ListPChainTransactionsResponse Successful response
6027
+ * @returns ListPChainStakingTransactionsResponse Successful response
5730
6028
  * @throws ApiError
5731
6029
  */
5732
6030
  listActivePrimaryNetworkStakingTransactions({ blockchainId, network, addresses, txTypes, startTimestamp, endTimestamp, pageToken, pageSize, sortOrder, }: {
@@ -5766,7 +6064,7 @@ declare class PrimaryNetworkTransactionsService {
5766
6064
  * The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the `sortBy` query parameter, if provided.
5767
6065
  */
5768
6066
  sortOrder?: SortOrder;
5769
- }): CancelablePromise<ListPChainTransactionsResponse>;
6067
+ }): CancelablePromise<ListPChainStakingTransactionsResponse>;
5770
6068
  /**
5771
6069
  * List asset transactions
5772
6070
  * Lists asset transactions corresponding to the given asset id on the X-Chain.
@@ -7312,5 +7610,5 @@ declare class FetchHttpRequest extends BaseHttpRequest {
7312
7610
  request<T>(options: ApiRequestOptions): CancelablePromise<T>;
7313
7611
  }
7314
7612
 
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 };
7613
+ export { ActiveDelegatorDetails, ActiveValidatorDetails, AddressActivityEventType, ApiError, ApiFeature, AutoRenewExitReason, AutoRenewState, AutoRenewedCycleOutcome, 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 };
7614
+ export type { AccessListData, AddressActivityMetadata, AddressesChangeRequest, AggregatedAssetAmount, ApiRequestOptions, AssetAmount, AssetWithPriceInfo, AutoRenewDetails, AutoRenewedCycle, AvaxSupplyResponse, BadGateway, BadRequest, BalanceOwner, Blockchain, BlockchainInfo, BlsCredentials, CChainAtomicBalances, CChainSharedAssetBalance, ChainAddressChainIdMap, ChainAddressChainIdMapListResponse, ChainInfo, ContractDeploymentDetails, CreateEvmTransactionExportRequest, CreatePrimaryNetworkTransactionExportRequest, CurrentAutoRenewedCycle, 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, ListAutoRenewedCyclesResponse, ListBlockchainsResponse, ListCChainAtomicBalancesResponse, ListCChainAtomicTransactionsResponse, ListChainsResponse, ListCollectibleBalancesResponse, ListContractsResponse, ListDelegatorDetailsResponse, ListErc1155BalancesResponse, ListErc1155TransactionsResponse, ListErc20BalancesResponse, ListErc20TransactionsResponse, ListErc721BalancesResponse, ListErc721TransactionsResponse, ListEvmBlocksResponse, ListHistoricalRewardsResponse, ListIcmMessagesResponse, ListInternalTransactionsResponse, ListL1ValidatorsResponse, ListNativeTransactionsResponse, ListNftTokens, ListPChainBalancesResponse, ListPChainStakingTransactionsResponse, 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, PChainStakingTransaction, 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 };
@@ -8,11 +8,11 @@ type AutoRenewDetails = {
8
8
  */
9
9
  nextPeriodSeconds: number;
10
10
  /**
11
- * 0-100. Share of each cycle's rewards that is restaked (compounded into validator weight).
11
+ * Share of each cycle's rewards that is restaked (compounded into validator weight), as a percent from 0 to 100 (not millionths/ppm, e.g. 90 means 90%).
12
12
  */
13
13
  autoCompoundSharePercent: number;
14
14
  /**
15
- * Current weight in nAVAX including all restaked rewards. Equals the top-level `amountStaked`.
15
+ * Current validator weight in nAVAX: the original stake plus all rewards restaked across prior cycles.
16
16
  */
17
17
  compoundedWeight: string;
18
18
  /**
@@ -1,5 +1,5 @@
1
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.
2
+ * `renewing` = will roll into another cycle; `exiting` = graceful exit armed, this is the final cycle. Not an outcome - the cycle can still abort on reward eligibility.
3
3
  */
4
4
  declare enum AutoRenewState {
5
5
  RENEWING = "renewing",
@@ -0,0 +1,67 @@
1
+ import { AutoRenewedCycleOutcome } from './AutoRenewedCycleOutcome.js';
2
+
3
+ type AutoRenewedCycle = {
4
+ /**
5
+ * 1-based sequence within this position. A node that has held more than one auto-renewed position has more than one cycle 1, so group by `stakingTxHash` or filter with the `txHash` query param.
6
+ */
7
+ cycleIndex: number;
8
+ /**
9
+ * The transaction that settled this cycle. Present even when the cycle paid nothing out, which is what makes a fully-compounding cycle visible.
10
+ */
11
+ rewardTxHash: string;
12
+ /**
13
+ * The originating AddAutoRenewedValidatorTx. Identifies the position, and is shared by every cycle of it.
14
+ */
15
+ stakingTxHash: string;
16
+ /**
17
+ * This cycle's window start, unix seconds.
18
+ */
19
+ startTimestamp: number;
20
+ /**
21
+ * This cycle's window end, unix seconds.
22
+ */
23
+ endTimestamp: number;
24
+ /**
25
+ * Weight bonded for this cycle in nAVAX, before this cycle's own rewards were compounded into it. The denominator for per-cycle yield.
26
+ */
27
+ weightAtCycleStart: string;
28
+ /**
29
+ * Validation reward earned this cycle, in nAVAX. `"0"` when the cycle was aborted, since the reward is forfeited. Excludes rewards earned in earlier cycles.
30
+ */
31
+ grossValidationReward: string;
32
+ /**
33
+ * Portion paid out as a reward UTXO, in nAVAX.
34
+ */
35
+ withdrawnValidationReward: string;
36
+ /**
37
+ * Portion restaked into validator weight, in nAVAX. Produces no UTXO. May be below `share x gross` when restaking would exceed the maximum validator stake.
38
+ */
39
+ compoundedValidationReward: string;
40
+ /**
41
+ * Delegatee commission earned this cycle, in nAVAX. Still paid when the cycle is aborted. `"0"` when the validator had no delegators.
42
+ */
43
+ grossDelegateeReward: string;
44
+ /**
45
+ * Commission paid out, in nAVAX.
46
+ */
47
+ withdrawnDelegateeReward: string;
48
+ /**
49
+ * Commission restaked into weight, in nAVAX.
50
+ */
51
+ compoundedDelegateeReward: string;
52
+ /**
53
+ * 0-100. The share in effect during this cycle, not the current one.
54
+ */
55
+ autoCompoundSharePercent: number;
56
+ outcome: AutoRenewedCycleOutcome;
57
+ /**
58
+ * Delegations overlapping this cycle's window. A delegation covering part of the cycle counts the same as one covering all of it.
59
+ */
60
+ delegatorCount: number;
61
+ /**
62
+ * Total weight of those delegations in nAVAX. Not included in `weightAtCycleStart`.
63
+ */
64
+ amountDelegated: string;
65
+ };
66
+
67
+ export type { AutoRenewedCycle };
@@ -0,0 +1,10 @@
1
+ /**
2
+ * How this cycle ended. `renewed` = rolled into another cycle; `exited` = final cycle of a graceful exit; `aborted` = reward eligibility not met.
3
+ */
4
+ declare enum AutoRenewedCycleOutcome {
5
+ RENEWED = "renewed",
6
+ EXITED = "exited",
7
+ ABORTED = "aborted"
8
+ }
9
+
10
+ export { AutoRenewedCycleOutcome };
@@ -0,0 +1 @@
1
+ var e=(e=>(e.RENEWED="renewed",e.EXITED="exited",e.ABORTED="aborted",e))(e||{});export{e as AutoRenewedCycleOutcome};
@@ -0,0 +1,47 @@
1
+ import { AutoRenewState } from './AutoRenewState.js';
2
+
3
+ type CurrentAutoRenewedCycle = {
4
+ /**
5
+ * 1-based sequence within this position. The settled cycles in `cycles` run from 1 to this value minus one.
6
+ */
7
+ cycleIndex: number;
8
+ /**
9
+ * The originating AddAutoRenewedValidatorTx for this position.
10
+ */
11
+ stakingTxHash: string;
12
+ /**
13
+ * This cycle's window start, unix seconds.
14
+ */
15
+ startTimestamp: number;
16
+ /**
17
+ * This cycle's window end, unix seconds. A delegation into this validator must end within it.
18
+ */
19
+ endTimestamp: number;
20
+ /**
21
+ * Weight bonded for this cycle in nAVAX. Rewards compound into weight only at settlement, so this is stable for the whole cycle.
22
+ */
23
+ weightAtCycleStart: string;
24
+ /**
25
+ * Forecast validation reward for the **whole** cycle in nAVAX, minted at cycle start. Not an amount earned so far, and not comparable to a settled cycle's `grossValidationReward` until this cycle settles. Do not add it to sums over `cycles`.
26
+ */
27
+ projectedValidationReward: string;
28
+ /**
29
+ * Delegatee commission already accrued this cycle, in nAVAX, from delegations that have settled within it. Unlike the validation reward this is realised, not forecast; delegations still running contribute nothing yet.
30
+ */
31
+ accruedDelegateeReward: string;
32
+ /**
33
+ * 0-100. The share that will apply when this cycle settles. A SetAutoRenewedValidatorConfigTx mid-cycle changes it, so it is not final until settlement.
34
+ */
35
+ autoCompoundSharePercent: number;
36
+ state: AutoRenewState;
37
+ /**
38
+ * Delegations overlapping this cycle's window.
39
+ */
40
+ delegatorCount: number;
41
+ /**
42
+ * Total weight of those delegations in nAVAX. Not included in `weightAtCycleStart`.
43
+ */
44
+ amountDelegated: string;
45
+ };
46
+
47
+ export type { CurrentAutoRenewedCycle };
@@ -0,0 +1,19 @@
1
+ import { AutoRenewedCycle } from './AutoRenewedCycle.js';
2
+ import { CurrentAutoRenewedCycle } from './CurrentAutoRenewedCycle.js';
3
+
4
+ type ListAutoRenewedCyclesResponse = {
5
+ /**
6
+ * A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
7
+ */
8
+ nextPageToken?: string;
9
+ /**
10
+ * Settled cycles, newest first by default. Empty for a node with no auto-renewed validation. The in-flight cycle is not included; it is on the validator object.
11
+ */
12
+ cycles: Array<AutoRenewedCycle>;
13
+ /**
14
+ * The cycle in flight. Absent when the position has ended, and on any page but the first.
15
+ */
16
+ currentCycle?: CurrentAutoRenewedCycle;
17
+ };
18
+
19
+ export type { ListAutoRenewedCyclesResponse };
@@ -0,0 +1,13 @@
1
+ import { PChainStakingTransaction } from './PChainStakingTransaction.js';
2
+ import { PrimaryNetworkChainInfo } from './PrimaryNetworkChainInfo.js';
3
+
4
+ type ListPChainStakingTransactionsResponse = {
5
+ /**
6
+ * A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
7
+ */
8
+ nextPageToken?: string;
9
+ transactions: Array<PChainStakingTransaction>;
10
+ chainInfo: PrimaryNetworkChainInfo;
11
+ };
12
+
13
+ export type { ListPChainStakingTransactionsResponse };