@avalabs/core-wallets-sdk 3.1.0-alpha.8 → 3.1.0-alpha.9

package/dist/index.d.ts

@@ -8,12 +8,14 @@ import { Provider, VoidSigner, HDNodeWallet, TransactionResponse, JsonRpcProvide
 import Transport from '@ledgerhq/hw-transport';
 import Eth from '@ledgerhq/hw-app-eth';
 import * as _avalabs_avalanchejs from '@avalabs/avalanchejs';
-import { VM, Common, OutputOwners, TransferableOutput, pvmSerial, Context, avm, pvm, evm, avaxSerial, utils, UnsignedTx, EVMUnsignedTx, Utxo, Credential, Signature } from '@avalabs/avalanchejs';
+import { VM, Common, OutputOwners, TransferableOutput, pvmSerial, Context, avm, pvm, evm, Info, avaxSerial, utils, UnsignedTx, EVMUnsignedTx, Utxo, TransferOutput, Credential, Signature } from '@avalabs/avalanchejs';
 import * as _avalabs_avalanchejs_dist_vms_common from '@avalabs/avalanchejs/dist/vms/common';
+import { GetUpgradesInfoResponse } from '@avalabs/avalanchejs/dist/info/model';
 import { Bip32Path } from 'bip32-path';
 import AppZondax, { ResponseBase } from '@avalabs/hw-app-avalanche';
 import { BIP32Interface } from 'bip32';
 import { Utxo as Utxo$1, PChainUtxo } from '@avalabs/glacier-sdk';
+import * as _avalabs_avalanchejs_dist_serializable_common_types from '@avalabs/avalanchejs/dist/serializable/common/types';
 import { WalletAbstract as WalletAbstract$1 } from 'Avalanche/wallets';
 
 /**
@@ -563,7 +565,7 @@ type ChainIDAlias = 'X' | 'P' | 'C';
 /**
  * Types for parsed transaction
  */
-type Tx = AddValidatorTx | AddDelegatorTx | ExportTx | ImportTx | BaseTx | CreateSubnetTx | CreateChainTx | AddSubnetValidatorTx | RemoveSubnetValidatorTx | AddPermissionlessValidatorTx | AddPermissionlessDelegatorTx | TransformSubnetTx | TransferSubnetOwnershipTx | UnknownTx;
+type Tx = AddValidatorTx | AddDelegatorTx | ExportTx | ImportTx | BaseTx$1 | CreateSubnetTx | CreateChainTx | AddSubnetValidatorTx | RemoveSubnetValidatorTx | AddPermissionlessValidatorTx | AddPermissionlessDelegatorTx | TransformSubnetTx | TransferSubnetOwnershipTx$1 | UnknownTx;
 interface FeeData {
     totalAvaxBurned: bigint;
     totalAvaxOutput: bigint;
@@ -591,7 +593,7 @@ declare enum TxType {
     TransferSubnetOwnership = "transfer_subnet_ownership",
     Unknown = "unknown"
 }
-interface BaseTx extends TxBase {
+interface BaseTx$1 extends TxBase {
     type: TxType.Base;
     chain: VM;
     outputs: {
@@ -670,7 +672,7 @@ interface AddPermissionlessValidatorTx extends TxBase {
     rewardOwner: OutputOwners;
     delegationRewardOwner: OutputOwners;
     stake: bigint;
-    stakeOuts: TransferableOutput[];
+    stakeOuts: readonly TransferableOutput[];
     subnetID: string;
     publicKey: undefined | string;
     signature: undefined | string;
@@ -684,7 +686,7 @@ interface AddPermissionlessDelegatorTx extends TxBase {
     stake: bigint;
     subnetID: string;
     delegatorRewardsOwner: OutputOwners;
-    stakeOuts: TransferableOutput[];
+    stakeOuts: readonly TransferableOutput[];
 }
 interface TransformSubnetTx extends TxBase {
     type: TxType.TransformSubnet;
@@ -703,7 +705,7 @@ interface TransformSubnetTx extends TxBase {
     maxValidatorWeightFactor: number;
     uptimeRequirement: number;
 }
-interface TransferSubnetOwnershipTx extends TxBase {
+interface TransferSubnetOwnershipTx$1 extends TxBase {
     type: TxType.TransferSubnetOwnership;
     subnetID: string;
     threshold: number;
@@ -719,7 +721,7 @@ declare function isAddValidatorTx(tx: Tx): tx is AddValidatorTx;
 declare function isAddDelegatorTx(tx: Tx): tx is AddDelegatorTx;
 declare function isExportTx(tx: Tx): tx is ExportTx;
 declare function isImportTx(tx: Tx): tx is ImportTx;
-declare function isBaseTx(tx: Tx): tx is BaseTx;
+declare function isBaseTx(tx: Tx): tx is BaseTx$1;
 declare function isCreateSubnetTx(tx: Tx): tx is CreateSubnetTx;
 declare function isCreateChainTx(tx: Tx): tx is CreateChainTx;
 declare function isAddSubnetValidatorTx(tx: Tx): tx is AddSubnetValidatorTx;
@@ -727,24 +729,28 @@ declare function isRemoveSubnetValidatorTx(tx: Tx): tx is RemoveSubnetValidatorT
 declare function isAddPermissionlessValidatorTx(tx: Tx): tx is AddPermissionlessValidatorTx;
 declare function isAddPermissionlessDelegatorTx(tx: Tx): tx is AddPermissionlessDelegatorTx;
 declare function isTransformSubnetTx(tx: Tx): tx is TransformSubnetTx;
-declare function isTransferSubnetOwnershipTx(tx: Tx): tx is TransferSubnetOwnershipTx;
+declare function isTransferSubnetOwnershipTx(tx: Tx): tx is TransferSubnetOwnershipTx$1;
 
 declare class AbstractProvider {
     protected baseUrl: string;
     protected context: Context.Context;
+    protected upgradesInfo: GetUpgradesInfoResponse;
     evmRpc: JsonRpcProvider$1;
-    constructor(baseUrl: string, context: Context.Context);
+    constructor(baseUrl: string, context: Context.Context, upgradesInfo: GetUpgradesInfoResponse);
     /**
      * @link https://docs.ethers.io/v5/api/providers/provider/#Provider-getFeeData
      */
     getEvmFeeData(): Promise<ethers.FeeData>;
     getContext(): Context.Context;
+    isEtnaEnabled(): boolean;
+    getUpgradesInfo(): GetUpgradesInfoResponse;
     getChainID(chainAlias: ChainIDAlias): string;
     getNetworkID(): number;
     getHrp(): string;
     getApiX(): avm.AVMApi;
     getApiP(): pvm.PVMApi;
     getApiC(): evm.EVMApi;
+    getInfo(): Info;
     getApi(chain: ChainIDAlias): avm.AVMApi | pvm.PVMApi | evm.EVMApi;
     getAvaxID(): string;
     getAddress(publicKey: Buffer, chain: ChainIDAlias): string;
@@ -765,10 +771,10 @@ declare class AbstractProvider {
 }
 
 declare class JsonRpcProvider extends AbstractProvider {
-    constructor(baseUrl: string, context: Context.Context);
+    constructor(baseUrl: string, context: Context.Context, upgradesInfo: GetUpgradesInfoResponse);
     static fromBaseURL(url: string): Promise<JsonRpcProvider>;
-    static getDefaultMainnetProvider(): JsonRpcProvider;
-    static getDefaultFujiProvider(): JsonRpcProvider;
+    static getDefaultMainnetProvider(upgradesInfo: GetUpgradesInfoResponse): JsonRpcProvider;
+    static getDefaultFujiProvider(upgradesInfo: GetUpgradesInfoResponse): JsonRpcProvider;
 }
 
 /**
@@ -780,6 +786,113 @@ declare const MainnetContext: Context.Context;
  */
 declare const FujiContext: Context.Context;
 
+type BaseTx = {
+    utxoSet: utils.UtxoSet;
+    chain: 'X' | 'P';
+    toAddress: string;
+    amountsPerAsset: Record<string, bigint>;
+    feeState: pvm.FeeState;
+    options?: Common.SpendOptions;
+    fromAddresses?: string[];
+};
+type ImportP = {
+    utxoSet: utils.UtxoSet;
+    sourceChain: 'X' | 'C';
+    toAddress?: string;
+    threshold?: number;
+    feeState: pvm.FeeState;
+    locktime?: bigint;
+};
+type ExportP = {
+    amount: bigint;
+    utxoSet: utils.UtxoSet;
+    destination: 'X' | 'C';
+    feeState: pvm.FeeState;
+    toAddress?: string;
+};
+type ConsolidateP = {
+    utxoSet: utils.UtxoSet;
+    amount: bigint;
+    feeState: pvm.FeeState;
+    toAddress?: string;
+    options?: Common.SpendOptions;
+};
+type CreateSubnet = {
+    utxoSet: utils.UtxoSet;
+    rewardAddresses: string[];
+    feeState: pvm.FeeState;
+    fromAddresses?: string[];
+    options?: Common.SpendOptions;
+    threshold?: number;
+    locktime?: bigint;
+};
+type AddSubnetValidator = {
+    utxoSet: utils.UtxoSet;
+    nodeId: string;
+    start: bigint;
+    end: bigint;
+    weight: bigint;
+    subnetId: string;
+    subnetAuth: number[];
+    feeState: pvm.FeeState;
+    fromAddresses?: string[];
+    options?: Common.SpendOptions;
+};
+type AddPermissionlessValidator = {
+    utxoSet: utils.UtxoSet;
+    nodeId: string;
+    start: bigint;
+    end: bigint;
+    weight: bigint;
+    subnetId: string;
+    shares: number;
+    fromAddresses?: string[];
+    rewardAddresses?: string[];
+    delegatorRewardAddresses?: string[];
+    publicKey?: Buffer;
+    signature?: Buffer;
+    options?: Common.SpendOptions;
+    stakingAssetId?: string;
+    locktime?: bigint;
+    threshold?: number;
+    feeState: pvm.FeeState;
+};
+type AddPermissionlessDelegator = {
+    utxoSet: utils.UtxoSet;
+    nodeId: string;
+    start: bigint;
+    end: bigint;
+    weight: bigint;
+    subnetId: string;
+    fromAddresses?: string[];
+    rewardAddresses?: string[];
+    options?: Common.SpendOptions;
+    locktime?: bigint;
+    feeState: pvm.FeeState;
+    stakingAssetId?: string;
+    threshold?: number;
+};
+type RemoveSubnetValidator = {
+    utxoSet: utils.UtxoSet;
+    nodeId: string;
+    subnetId: string;
+    subnetAuth: number[];
+    feeState: pvm.FeeState;
+    fromAddresses?: string[];
+    options?: Common.SpendOptions;
+};
+type TransferSubnetOwnershipTx = {
+    utxoSet: utils.UtxoSet;
+    subnetId: string;
+    subnetAuth: number[];
+    subnetOwners: string[];
+    feeState: pvm.FeeState;
+    fromAddresses?: string[];
+    options?: Common.SpendOptions;
+    threshold?: number;
+    locktime?: bigint;
+};
+
 /**
  * An  abstract class that that is shared by all wallet classes.
  */
@@ -825,8 +938,12 @@ declare abstract class WalletAbstract {
      * @param source What is the source chain of the atomic UTXOs
      */
     getAtomicUTXOs(chain: ChainIDAlias, source: ChainIDAlias): Promise<utils.UtxoSet>;
+    /**
+     * Get the nonce of this wallet's C chain address
+     */
+    getNonce(): Promise<number>;
     exportX(amount: bigint, utxoSet: utils.UtxoSet, destination: 'P' | 'C', toAddress?: string): Common.UnsignedTx;
-    importP(utxos: utils.UtxoSet, sourceChain: 'X' | 'C', toAddress?: string): Common.UnsignedTx;
+    importP({ utxoSet, sourceChain, toAddress, threshold, feeState, locktime, }: ImportP): Common.UnsignedTx;
     importX(utxos: utils.UtxoSet, sourceChain: 'P' | 'C', toAddress?: string): Common.UnsignedTx;
     /**
      *
@@ -846,10 +963,6 @@ declare abstract class WalletAbstract {
      * @param toAddress
      */
     exportC(amount: bigint, destination: 'X' | 'P', nonce: bigint, baseFee: bigint, toAddress?: string): _avalabs_avalanchejs.EVMUnsignedTx;
-    /**
-     * Get the nonce of this wallet's C chain address
-     */
-    getNonce(): Promise<number>;
     /**
      * Export the given amount of AVAX from the P chain. Export fee is automatically added.
      * @param amount
@@ -857,18 +970,18 @@ declare abstract class WalletAbstract {
      * @param destination
      * @param toAddress
      */
-    exportP(amount: bigint, utxoSet: utils.UtxoSet, destination: 'X' | 'C', toAddress?: string): Common.UnsignedTx;
-    addValidator(utxos: utils.UtxoSet, nodeID: string, stakeAmount: bigint, startDate: bigint, endDate: bigint, delegationFee: number, config?: {
+    exportP({ amount, utxoSet, destination, feeState, toAddress }: ExportP): Common.UnsignedTx;
+    addValidator(utxos: utils.UtxoSet, nodeId: string, stakeAmount: bigint, startDate: bigint, endDate: bigint, delegationFee: number, config?: {
         rewardAddress?: string;
     }): Common.UnsignedTx;
-    addDelegator(utxos: utils.UtxoSet, nodeID: string, stakeAmount: bigint, startDate: bigint, endDate: bigint, config?: {
+    addDelegator(utxos: utils.UtxoSet, nodeId: string, stakeAmount: bigint, startDate: bigint, endDate: bigint, config?: {
         rewardAddress?: string;
     }): Common.UnsignedTx;
-    consolidateP(utxoSet: utils.UtxoSet, amount: bigint, toAddress?: string, options?: Common.SpendOptions): Common.UnsignedTx;
-    baseTX(utxoSet: utils.UtxoSet, chain: 'X' | 'P', toAddress: string, amountsPerAsset: Record<string, bigint>, options?: Common.SpendOptions, fromAddresses?: string[]): Common.UnsignedTx;
+    consolidateP({ utxoSet, amount, feeState, toAddress, options, }: ConsolidateP): Common.UnsignedTx;
+    baseTX({ utxoSet, chain, toAddress, amountsPerAsset, feeState, options, fromAddresses, }: BaseTx): Common.UnsignedTx;
     createBlockchain(utxoSet: utils.UtxoSet, subnetId: string, chainName: string, vmID: string, fxIds: string[], genesisData: Record<string, unknown>, subnetAuth: number[], options?: Common.SpendOptions, fromAddresses?: string[]): Common.UnsignedTx;
-    createSubnet(utxoSet: utils.UtxoSet, rewardAddresses: string[], fromAddresses?: string[], options?: Common.SpendOptions, threshold?: number, locktime?: bigint): Common.UnsignedTx;
-    addSubnetValidator(utxoSet: utils.UtxoSet, nodeId: string, start: bigint, end: bigint, weight: bigint, subnetId: string, subnetAuth: number[], fromAddresses?: string[], options?: Common.SpendOptions): Common.UnsignedTx;
+    createSubnet({ utxoSet, rewardAddresses, feeState, fromAddresses, options, threshold, locktime, }: CreateSubnet): Common.UnsignedTx;
+    addSubnetValidator({ utxoSet, nodeId, start, end, weight, subnetId, subnetAuth, feeState, fromAddresses, options, }: AddSubnetValidator): Common.UnsignedTx;
     /**
      *
      * @param utxoSet The transaction will be constructed from these UTXOs.
@@ -885,7 +998,7 @@ declare abstract class WalletAbstract {
      * @param signature the BLS signature, If the subnet is the primary network. Can be found in the Node on startup.
      * @param options
      */
-    addPermissionlessValidator(utxoSet: utils.UtxoSet, nodeId: string, start: bigint, end: bigint, weight: bigint, subnetId: string, shares: number, fromAddresses?: string[], rewardAddresses?: string[], delegatorRewardAddresses?: string[], publicKey?: Buffer, signature?: Buffer, options?: Common.SpendOptions): Common.UnsignedTx;
+    addPermissionlessValidator({ utxoSet, nodeId, start, end, weight, subnetId, shares, feeState, fromAddresses, rewardAddresses, delegatorRewardAddresses, publicKey, signature, options, threshold, locktime, stakingAssetId, }: AddPermissionlessValidator): Common.UnsignedTx;
     /**
      *
      * @param utxoSet The transaction will be constructed from these UTXOs.
@@ -898,9 +1011,9 @@ declare abstract class WalletAbstract {
      * @param rewardAddresses Will use active address if not provided. Given addresses will share the reward UTXO.
      * @param options
      */
-    addPermissionlessDelegator(utxoSet: utils.UtxoSet, nodeId: string, start: bigint, end: bigint, weight: bigint, subnetId: string, fromAddresses?: string[], rewardAddresses?: string[], options?: Common.SpendOptions): Common.UnsignedTx;
-    removeSubnetValidator(utxoSet: utils.UtxoSet, nodeId: string, subnetId: string, subnetAuth: number[], fromAddresses?: string[], options?: Common.SpendOptions): Common.UnsignedTx;
-    transferSubnetOwnershipTx(utxoSet: utils.UtxoSet, subnetId: string, subnetAuth: number[], subnetOwners: string[], fromAddresses?: string[], options?: Common.SpendOptions, threshold?: number, locktime?: bigint): Common.UnsignedTx;
+    addPermissionlessDelegator({ utxoSet, nodeId, start, end, weight, subnetId, fromAddresses, rewardAddresses, options, locktime, feeState, threshold, stakingAssetId, }: AddPermissionlessDelegator): Common.UnsignedTx;
+    removeSubnetValidator({ utxoSet, nodeId, subnetId, subnetAuth, fromAddresses, feeState, options, }: RemoveSubnetValidator): Common.UnsignedTx;
+    transferSubnetOwnershipTx({ utxoSet, subnetId, subnetAuth, subnetOwners, feeState, fromAddresses, options, threshold, locktime, }: TransferSubnetOwnershipTx): Common.UnsignedTx;
     transformSubnetTx(utxoSet: utils.UtxoSet, subnetId: string, assetId: string, initialSupply: bigint, maximumSupply: bigint, minConsumptionRate: bigint, maxConsumptionRate: bigint, minValidatorStake: bigint, maxValidatorStake: bigint, minStakeDuration: number, maxStakeDuration: number, minDelegationFee: number, minDelegatorStake: number, maxValidatorWeightFactor: number, uptimeRequirement: number, subnetAuth: number[], fromAddresses?: string[], options?: Common.SpendOptions): Common.UnsignedTx;
     protected constructor(provider: AbstractProvider);
 }
@@ -1352,7 +1465,7 @@ declare const addSignaturesToAvalancheTx: ({ transactionHex, signatures, chainAl
 }>;
 
 type GlacierOutput = Utxo$1 | PChainUtxo;
-declare const convertGlacierUtxo: (glacierUtxo: GlacierOutput, isTestnet: boolean) => Utxo;
+declare const convertGlacierUtxo: (glacierUtxo: GlacierOutput, isTestnet: boolean) => Utxo<TransferOutput | pvmSerial.StakeableLockOut<TransferOutput>>;
 
 type Params$2 = {
     txBytes: Uint8Array;
@@ -1474,7 +1587,7 @@ type Params = {
     token?: string;
     headers?: Record<string, string>;
 };
-declare const getUtxosByTxFromGlacier: ({ transactionHex, chainAlias, isTestnet, url, token, headers, }: Params) => Promise<Utxo[]>;
+declare const getUtxosByTxFromGlacier: ({ transactionHex, chainAlias, isTestnet, url, token, headers, }: Params) => Promise<Utxo<_avalabs_avalanchejs_dist_serializable_common_types.Serializable>[]>;
 
 declare const getVmByChainAlias: (chainAlias: string) => "EVM" | "AVM" | "PVM";
 
@@ -1510,10 +1623,10 @@ declare function signedTxToHex(signedTx: avaxSerial.SignedTx): string;
  * 2- Highest value UTXOs to lowest
  * @remark Does not check for locked UTXOs
  */
-declare function sortUTXOsStaking(utxos: Utxo[]): Utxo[];
-declare function sortUTXOsByAmount(utxos: Utxo[], isDescending: boolean): Utxo[];
-declare const sortUTXOsByAmountDescending: (utxos: Utxo[]) => Utxo[];
-declare const sortUTXOsByAmountAscending: (utxos: Utxo[]) => Utxo[];
+declare function sortUTXOsStaking(utxos: Utxo[]): Utxo<_avalabs_avalanchejs_dist_serializable_common_types.Serializable>[];
+declare function sortUTXOsByAmount(utxos: Utxo[], isDescending: boolean): Utxo<_avalabs_avalanchejs_dist_serializable_common_types.Serializable>[];
+declare const sortUTXOsByAmountDescending: (utxos: Utxo[]) => Utxo<_avalabs_avalanchejs_dist_serializable_common_types.Serializable>[];
+declare const sortUTXOsByAmountAscending: (utxos: Utxo[]) => Utxo<_avalabs_avalanchejs_dist_serializable_common_types.Serializable>[];
 
 /**
  * The list of transaction types supported by `getMaximumUtxoSet`.
@@ -1539,9 +1652,16 @@ declare const P_CHAIN_TX_SIZE_LIMIT = 65536;
  * @param utxos - list of UTXOs to be consumed by the transaction.
  * @param sizeSupportedTx - one of the supported transaction types
  * @param limit - optional - byte size limit, defaults to 64kb.
+ * @param feeState - current fee state on the chain
  * @returns the largest prefix of sorted `utxos` before hitting the size limit. If no such prefix exists, then an empty array.
  */
-declare function getMaximumUtxoSet(wallet: WalletAbstract$1, utxos: Utxo[], sizeSupportedTx: SizeSupportedTx, limit?: number): Utxo[];
+declare function getMaximumUtxoSet({ wallet, utxos, sizeSupportedTx, limit, feeState, }: {
+    wallet: WalletAbstract$1;
+    utxos: Utxo[];
+    sizeSupportedTx: SizeSupportedTx;
+    limit?: number;
+    feeState: pvm.FeeState;
+}): Utxo[];
 
 /**
  * Verifies the given derivation path is valid, starts with `m`, and of the right length
@@ -1558,7 +1678,6 @@ type index_AddSubnetValidatorTx = AddSubnetValidatorTx;
 type index_AddValidatorTx = AddValidatorTx;
 type index_AddressWallet = AddressWallet;
 declare const index_AddressWallet: typeof AddressWallet;
-type index_BaseTx = BaseTx;
 type index_ChainIDAlias = ChainIDAlias;
 type index_CreateChainTx = CreateChainTx;
 type index_CreateSubnetTx = CreateSubnetTx;
@@ -1595,7 +1714,6 @@ type index_SizeSupportedTx = SizeSupportedTx;
 declare const index_SizeSupportedTx: typeof SizeSupportedTx;
 type index_StaticSigner = StaticSigner;
 declare const index_StaticSigner: typeof StaticSigner;
-type index_TransferSubnetOwnershipTx = TransferSubnetOwnershipTx;
 type index_TransformSubnetTx = TransformSubnetTx;
 type index_Tx = Tx;
 type index_TxBase = TxBase;
@@ -1660,7 +1778,7 @@ declare namespace index {
     index_AddSubnetValidatorTx as AddSubnetValidatorTx,
     index_AddValidatorTx as AddValidatorTx,
     index_AddressWallet as AddressWallet,
-    index_BaseTx as BaseTx,
+    BaseTx$1 as BaseTx,
     index_ChainIDAlias as ChainIDAlias,
     index_CreateChainTx as CreateChainTx,
     index_CreateSubnetTx as CreateSubnetTx,
@@ -1688,7 +1806,7 @@ declare namespace index {
     index_SimpleSigner as SimpleSigner,
     index_SizeSupportedTx as SizeSupportedTx,
     index_StaticSigner as StaticSigner,
-    index_TransferSubnetOwnershipTx as TransferSubnetOwnershipTx,
+    TransferSubnetOwnershipTx$1 as TransferSubnetOwnershipTx,
     index_TransformSubnetTx as TransformSubnetTx,
     index_Tx as Tx,
     index_TxBase as TxBase,