Class StackingClient

Hierarchy

StackingClient

Index

Constructors

Properties

Methods - PoX-2

delegateStackExtend delegateStackIncrease stackAggregationCommitIndexed stackAggregationIncrease stackExtend stackIncrease

Methods - Other

Constructors

constructor

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

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:822

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:851

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:920

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:947

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:698

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:726

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:621

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:786

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:751

getAccountBalance

getAccountBalance(): Promise<bigint>
Get account balance

Returns
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
resolves to a bigint if the operation succeeds

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

getAccountExtendedBalances

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

Returns
resolves to an AccountExtendedBalances response if the operation succeeds

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

getAccountStatus

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

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:345

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:412

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:1064

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:1132

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:1158

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:1096

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:1324

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:355

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:530

getRevokeDelegateStxOptions

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

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:447

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:458

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:436

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:427

getSecondsUntilNextCycle

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

Returns
that resolves to a number if the operation succeeds

See also:
- getSecondsUntilStackingDeadline
Returns Promise<number>
- Defined in packages/stacking/src/index.ts:485

getSecondsUntilStackingDeadline

getSecondsUntilStackingDeadline(): Promise<number>
Get number of seconds until the end of the stacking deadline. This is the estimated time stackers have to submit their stacking transactions to be included in the upcoming reward cycle.

Returns
that resolves to a number if the operation succeeds

See also:
- getSecondsUntilNextCycle
Returns Promise<number>
- Defined in packages/stacking/src/index.ts:510

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:1184

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:1232

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:1207

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:1027

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:1050

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:999

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:1370

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:1274

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:365

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:610

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:602

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:1390

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:1403

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:976
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:982

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:664

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:880

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