Class StackingClient

Hierarchy

StackingClient

Index

Constructors

Properties

Methods - PoX-2

delegateStackExtend delegateStackIncrease stackAggregationCommitIndexed stackAggregationIncrease stackExtend stackIncrease

Constructors

constructor

new StackingClient(address: string, network: StacksNetwork): StackingClient
Parameters
- address: string
- network: StacksNetwork
Returns StackingClient
- Defined in packages/stacking/src/index.ts:337

Properties

address

address: string

network

network: StacksNetwork

PoX-2 Methods

delegateStackExtend

delegateStackExtend(options: DelegateStackExtendOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast transactions to extend stack for multiple delegatees.

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: DelegateStackExtendOptions & BaseTxOptions
  
  a required delegate stack extend STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:817

delegateStackIncrease

delegateStackIncrease(-: DelegateStackIncreaseOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast transactions to stack increase for multiple delegatees.

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- -: DelegateStackIncreaseOptions & BaseTxOptions
  
  a required delegate stack increase STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:846

stackAggregationCommitIndexed

stackAggregationCommitIndexed(options: StackAggregationCommitOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast a transaction to commit partially committed delegatee tokens

Commit partially stacked STX and allocate a new PoX reward address slot. This allows a stacker/delegate to lock fewer STX than the minimal threshold in multiple transactions, so long as: 1. The pox-addr is the same. 2. This "commit" transaction is called before the PoX anchor block. This ensures that each entry in the reward set returned to the stacks-node is greater than the threshold, but does not require it be all locked up within a single transaction

stack-aggregation-commit-indexed returns (ok uint) on success, where the given uint is the reward address's index in the list of reward addresses allocated in this reward cycle. This index can then be passed to stack-aggregation-increase to later increment the STX this PoX address represents, in amounts less than the stacking minimum.

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: StackAggregationCommitOptions & BaseTxOptions
  
  a required stack aggregation commit options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:917

stackAggregationIncrease

stackAggregationIncrease(options: StackAggregationIncreaseOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast a transaction to increase partial commitment committed delegatee tokens

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: StackAggregationIncreaseOptions & BaseTxOptions
  
  a required stack aggregation increase options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:945

stackExtend

stackExtend(-: StackExtendOptions & BaseTxOptions): Promise<TxBroadcastResult>
Generate and broadcast a stacking transaction to extend locked STX (pox-2.stack-extend)

Returns
a broadcasted txid if the operation succeeds
Parameters
- -: StackExtendOptions & BaseTxOptions
  
  a required extend STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:689

stackIncrease

stackIncrease(-: StackIncreaseOptions & BaseTxOptions): Promise<TxBroadcastResult>
Generate and broadcast a stacking transaction to increase locked STX (pox-2.stack-increase)

Returns
a broadcasted txid if the operation succeeds
Parameters
- -: StackIncreaseOptions & BaseTxOptions
  
  a required increase STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:717

Other Methods

canStack

canStack(options: CanLockStxOptions): Promise<StackingEligibility>
Check if account can lock stx

Returns
that resolves to a StackingEligibility object if the operation succeeds
Parameters
- options: CanLockStxOptions
  
  a required lock STX options object
Returns Promise<StackingEligibility>
- Defined in packages/stacking/src/index.ts:610

delegateStackStx

delegateStackStx(options: DelegateStackStxOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast transactions to stack for multiple delegatees. This will lock up tokens owned by the delegatees.

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: DelegateStackStxOptions & BaseTxOptions
  
  a required delegate stack STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:781

delegateStx

delegateStx(options: DelegateStxOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegatee, generate and broadcast a transaction to create a delegation relationship

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: DelegateStxOptions & BaseTxOptions
  
  a required delegate STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:744

getAccountBalance

getAccountBalance(): Promise<bigint>
Get account balance

Returns
promise resolves to a bigint if the operation succeeds

Returns Promise<bigint>
- Defined in packages/stacking/src/index.ts:385

getAccountBalanceLocked

getAccountBalanceLocked(): Promise<bigint>
Get account balance of locked tokens

Returns
promise resolves to a bigint if the operation succeeds

Returns Promise<bigint>
- Defined in packages/stacking/src/index.ts:406

getAccountExtendedBalances

getAccountExtendedBalances(): Promise<AccountExtendedBalances>
Get extended account balances

Returns
promise resolves to a bigint if the operation succeeds

Returns Promise<AccountExtendedBalances>
- Defined in packages/stacking/src/index.ts:396

getAccountStatus

getAccountStatus(): Promise<any>
Returns Promise<any>
- Defined in packages/stacking/src/index.ts:375

getCoreInfo

getCoreInfo(): Promise<CoreInfo>
Get stacks node info

Returns
that resolves to a CoreInfo response if the operation succeeds

Returns Promise<CoreInfo>
- Defined in packages/stacking/src/index.ts:344

getCycleDuration

getCycleDuration(): Promise<number>
Get reward cycle duration in seconds

Returns
that resolves to a number if the operation succeeds

Returns Promise<number>
- Defined in packages/stacking/src/index.ts:415

getDelegateOptions

getDelegateOptions(__namedParameters: {
    amountMicroStx: IntegerType;
    contract: string;
    delegateTo: string;
    poxAddress?: string;
    untilBurnBlockHeight?: number;
}): ContractCallOptions
Parameters
- __namedParameters: {
      amountMicroStx: IntegerType;
      contract: string;
      delegateTo: string;
      poxAddress?: string;
      untilBurnBlockHeight?: number;
  }
  - amountMicroStx: IntegerType
  - contract: string
  - delegateTo: string
  - Optional poxAddress?: string
  - Optional untilBurnBlockHeight?: number
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1062

getDelegateStackExtendOptions

getDelegateStackExtendOptions(__namedParameters: {
    contract: string;
    extendCount: number;
    poxAddress: string;
    stacker: string;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      extendCount: number;
      poxAddress: string;
      stacker: string;
  }
  - contract: string
  - extendCount: number
  - poxAddress: string
  - stacker: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1130

getDelegateStackIncreaseOptions

getDelegateStackIncreaseOptions(__namedParameters: {
    contract: string;
    increaseBy: IntegerType;
    poxAddress: string;
    stacker: string;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      increaseBy: IntegerType;
      poxAddress: string;
      stacker: string;
  }
  - contract: string
  - increaseBy: IntegerType
  - poxAddress: string
  - stacker: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1156

getDelegateStackOptions

getDelegateStackOptions(__namedParameters: {
    amountMicroStx: IntegerType;
    burnBlockHeight: number;
    contract: string;
    cycles: number;
    poxAddress: string;
    stacker: string;
}): ContractCallOptions
Parameters
- __namedParameters: {
      amountMicroStx: IntegerType;
      burnBlockHeight: number;
      contract: string;
      cycles: number;
      poxAddress: string;
      stacker: string;
  }
  - amountMicroStx: IntegerType
  - burnBlockHeight: number
  - contract: string
  - cycles: number
  - poxAddress: string
  - stacker: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1094

getDelegationStatus

getDelegationStatus(): Promise<DelegationInfo>
Check delegation status

Returns
that resolves to a DelegationInfo object if the operation succeeds

Returns Promise<DelegationInfo>
- Defined in packages/stacking/src/index.ts:1322

getPoxInfo

getPoxInfo(): Promise<PoxInfo>
Get stacks node pox info

Returns
that resolves to a PoxInfo response if the operation succeeds

Returns Promise<PoxInfo>
- Defined in packages/stacking/src/index.ts:354

getPoxOperationInfo

getPoxOperationInfo(poxInfo?: PoxInfo): Promise<PoxOperationInfo>
Get information on current PoX operation

Periods:
- Period 1: This is before the 2.1 fork.
- Period 2: This is after the 2.1 fork, but before cycle (N+1).
- Period 3: This is after cycle (N+1) has begun. Original PoX contract state will no longer have any impact on reward sets, account lock status, etc.
Returns
that resolves to PoX operation info
Parameters
- Optional poxInfo: PoxInfo
Returns Promise<PoxOperationInfo>
- Defined in packages/stacking/src/index.ts:516

getRevokeDelegateStxOptions

getRevokeDelegateStxOptions(contract: string): ContractCallOptions
Parameters
- contract: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1253

getRewardHoldersForBtcAddress

getRewardHoldersForBtcAddress(options?: PaginationOptions): Promise<RewardsError | BurnchainRewardSlotHolderListResponse>
Get burnchain rewards holders for the set address

Returns
that resolves to RewardHoldersResponse or RewardsError
Parameters
- Optional options: PaginationOptions
Returns Promise<RewardsError | BurnchainRewardSlotHolderListResponse>
- Defined in packages/stacking/src/index.ts:453

getRewardSet

getRewardSet(options: RewardSetOptions): Promise<undefined | RewardSetInfo>
Get PoX address from reward set by index

Returns
that resolves to RewardSetInfo if the entry exists
Parameters
- options: RewardSetOptions
Returns Promise<undefined | RewardSetInfo>
- Defined in packages/stacking/src/index.ts:465

getRewardsForBtcAddress

getRewardsForBtcAddress(options?: PaginationOptions): Promise<RewardsError | BurnchainRewardListResponse>
Get burnchain rewards for the set address

Returns
that resolves to RewardsResponse or RewardsError
Parameters
- Optional options: PaginationOptions
Returns Promise<RewardsError | BurnchainRewardListResponse>
- Defined in packages/stacking/src/index.ts:441

getRewardsTotalForBtcAddress

getRewardsTotalForBtcAddress(): Promise<RewardsError | BurnchainRewardsTotal>
Get the total burnchain rewards total for the set address

Returns
that resolves to TotalRewardsResponse or RewardsError

Returns Promise<RewardsError | BurnchainRewardsTotal>
- Defined in packages/stacking/src/index.ts:431

getSecondsUntilNextCycle

getSecondsUntilNextCycle(): Promise<number>
Get number of seconds until next reward cycle

Returns
that resolves to a number if the operation succeeds

Returns Promise<number>
- Defined in packages/stacking/src/index.ts:490

getStackAggregationCommitOptions

getStackAggregationCommitOptions(__namedParameters: {
    contract: string;
    poxAddress: string;
    rewardCycle: number;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      poxAddress: string;
      rewardCycle: number;
  }
  - contract: string
  - poxAddress: string
  - rewardCycle: number
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1182

getStackAggregationCommitOptionsIndexed

getStackAggregationCommitOptionsIndexed(__namedParameters: {
    contract: string;
    poxAddress: string;
    rewardCycle: number;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      poxAddress: string;
      rewardCycle: number;
  }
  - contract: string
  - poxAddress: string
  - rewardCycle: number
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1230

getStackAggregationIncreaseOptions

getStackAggregationIncreaseOptions(__namedParameters: {
    contract: string;
    poxAddress: string;
    rewardCycle: number;
    rewardCycleIndex: number;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      poxAddress: string;
      rewardCycle: number;
      rewardCycleIndex: number;
  }
  - contract: string
  - poxAddress: string
  - rewardCycle: number
  - rewardCycleIndex: number
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1205

getStackExtendOptions

getStackExtendOptions(__namedParameters: {
    contract: string;
    extendCycles: number;
    poxAddress: string;
}): ContractCallOptions
Parameters
- __namedParameters: {
      contract: string;
      extendCycles: number;
      poxAddress: string;
  }
  - contract: string
  - extendCycles: number
  - poxAddress: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1025

getStackIncreaseOptions

getStackIncreaseOptions(__namedParameters: {
contract: string;
increaseBy: IntegerType;
}): ContractCallOptions
Parameters
- __namedParameters: {
  contract: string;
  increaseBy: IntegerType;
  }
  - contract: string
  - increaseBy: IntegerType
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:1048

getStackOptions

getStackOptions(__namedParameters: {
    amountMicroStx: IntegerType;
    burnBlockHeight: number;
    contract: string;
    cycles: number;
    poxAddress: string;
}): ContractCallOptions
Parameters
- __namedParameters: {
      amountMicroStx: IntegerType;
      burnBlockHeight: number;
      contract: string;
      cycles: number;
      poxAddress: string;
  }
  - amountMicroStx: IntegerType
  - burnBlockHeight: number
  - contract: string
  - cycles: number
  - poxAddress: string
Returns ContractCallOptions
- Defined in packages/stacking/src/index.ts:997

getStackingContract

getStackingContract(poxOperationInfo?: PoxOperationInfo): Promise<string>
Returns
that resolves to the contract id (address and name) to use for stacking
Parameters
- Optional poxOperationInfo: PoxOperationInfo
Returns Promise<string>
- Defined in packages/stacking/src/index.ts:1368

getStatus

getStatus(): Promise<StackerInfo>
Check stacking status

Returns
that resolves to a StackerInfo object if the operation succeeds

Returns Promise<StackerInfo>
- Defined in packages/stacking/src/index.ts:1272

getTargetBlockTime

getTargetBlockTime(): Promise<number>
Get stacks node target block time

Returns
that resolves to a number if the operation succeeds

Returns Promise<number>
- Defined in packages/stacking/src/index.ts:364

hasMinimumStx

hasMinimumStx(): Promise<boolean>
Check if account has minimum require amount of Stacks for stacking

Returns
that resolves to a bool if the operation succeeds

Returns Promise<boolean>
- Defined in packages/stacking/src/index.ts:597

isStackingEnabledNextCycle

isStackingEnabledNextCycle(): Promise<boolean>
Check if stacking is enabled for next reward cycle

Returns
that resolves to a bool if the operation succeeds

Returns Promise<boolean>
- Defined in packages/stacking/src/index.ts:588

modifyLockTxFee

modifyLockTxFee(__namedParameters: {
amountMicroStx: IntegerType;
tx: StacksTransaction;
}): StacksTransaction
Adjust microstacks amount for locking after taking into account transaction fees

Returns
that resolves to a transaction object if the operation succeeds
Parameters
- __namedParameters: {
  amountMicroStx: IntegerType;
  tx: StacksTransaction;
  }
  - amountMicroStx: IntegerType
  - tx: StacksTransaction
Returns StacksTransaction
- Defined in packages/stacking/src/index.ts:1388

parseContractId

parseContractId(contract: string): string[]
Parses a contract identifier and ensures it is formatted correctly

Returns
a contract address and name
Parameters
- contract: string
Returns string[]
- Defined in packages/stacking/src/index.ts:1401

revokeDelegateStx

revokeDelegateStx(privateKey: string): Promise<TxBroadcastResult>
As a delegatee, generate and broadcast a transaction to terminate the delegation relationship

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- privateKey: string
  
  the private key to be used for the revoke call
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:974
revokeDelegateStx(txOptions: BaseTxOptions): Promise<TxBroadcastResult>
As a delegatee, generate and broadcast a transaction to terminate the delegation relationship

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- txOptions: BaseTxOptions
  
  the private key, fee, and nonce to be used for the revoke call
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:980

stack

stack(options: LockStxOptions & BaseTxOptions): Promise<TxBroadcastResult>
Generate and broadcast a stacking transaction to lock STX

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: LockStxOptions & BaseTxOptions
  
  a required lock STX options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:655

stackAggregationCommit

stackAggregationCommit(options: StackAggregationCommitOptions & BaseTxOptions): Promise<TxBroadcastResult>
As a delegator, generate and broadcast a transaction to commit partially committed delegatee tokens

Returns
that resolves to a broadcasted txid if the operation succeeds
Parameters
- options: StackAggregationCommitOptions & BaseTxOptions
  
  a required stack aggregation commit options object
Returns Promise<TxBroadcastResult>
- Defined in packages/stacking/src/index.ts:877

Class StackingClient

Hierarchy

Index

Constructors

Properties

Methods - PoX-2

Methods - Other

Constructors

constructor

Parameters

address: string

network: StacksNetwork

Returns StackingClient

Properties

address

network

PoX-2 Methods

delegateStackExtend

Returns

Parameters

options: DelegateStackExtendOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

delegateStackIncrease

Returns

Parameters

-: DelegateStackIncreaseOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

stackAggregationCommitIndexed

Returns

Parameters

options: StackAggregationCommitOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

stackAggregationIncrease

Returns

Parameters

options: StackAggregationIncreaseOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

stackExtend

Returns

Parameters

-: StackExtendOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

stackIncrease

Returns

Parameters

-: StackIncreaseOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

Other Methods

canStack

Returns

Parameters

options: CanLockStxOptions

Returns Promise<StackingEligibility>

delegateStackStx

Returns

Parameters

options: DelegateStackStxOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

delegateStx

Returns

Parameters

options: DelegateStxOptions & BaseTxOptions

Returns Promise<TxBroadcastResult>

getAccountBalance

Returns

Returns Promise<bigint>

getAccountBalanceLocked

Returns

Returns Promise<bigint>

getAccountExtendedBalances

Returns

Returns Promise<AccountExtendedBalances>

getAccountStatus

Returns Promise<any>

getCoreInfo

Returns

Returns Promise<CoreInfo>

getCycleDuration

Returns

Returns Promise<number>

__namedParameters: {
amountMicroStx: IntegerType;
contract: string;
delegateTo: string;
poxAddress?: string;
untilBurnBlockHeight?: number;
}

`Optional` poxAddress?: string

`Optional` untilBurnBlockHeight?: number

__namedParameters: {
contract: string;
extendCount: number;
poxAddress: string;
stacker: string;
}

__namedParameters: {
contract: string;
increaseBy: IntegerType;
poxAddress: string;
stacker: string;
}

__namedParameters: {
amountMicroStx: IntegerType;
burnBlockHeight: number;
contract: string;
cycles: number;
poxAddress: string;
stacker: string;
}

`Optional` poxInfo: PoxInfo

`Optional` options: PaginationOptions

`Optional` options: PaginationOptions