Class NativeAddBidBuilder

Builder for creating Native Add Bid transactions. Used by validators to submit or increase their bid in the Casper auction system.

Example

const transaction = new NativeAddBidBuilder()
  .from(validatorPublicKey)
  .validator(validatorPublicKey)
  .amount('1000000000000') // 1000 CSPR
  .delegationRate(10) // 10% commission
  .chainName('casper')
  .payment(5_000_000_000)
  .build();

Hierarchy

TransactionBuilder<NativeAddBidBuilder>
- NativeAddBidBuilder

Constructors

constructor

new NativeAddBidBuilder(): NativeAddBidBuilder
Returns NativeAddBidBuilder
Overrides TransactionBuilder< NativeAddBidBuilder >.constructor
- Defined in src/types/TransactionBuilder.ts:365

Properties

`Private` _amount

_amount: CLValue

`Protected` _chainName

_chainName: string

`Protected` _contractHash

_contractHash: string

`Private` _delegationRate

_delegationRate: CLValue

`Protected` _entryPoint

_entryPoint: TransactionEntryPoint

`Protected` _initiatorAddr

_initiatorAddr: InitiatorAddr

`Protected` _invocationTarget

_invocationTarget: TransactionTarget

`Private` `Optional` _maximumDelegationAmount

_maximumDelegationAmount?: CLValue

`Private` `Optional` _minimumDelegationAmount

_minimumDelegationAmount?: CLValue

`Protected` _pricingMode

_pricingMode: PricingMode

`Private` `Optional` _reservedSlots

_reservedSlots?: CLValue

`Protected` _runtimeArgs

_runtimeArgs: Args

`Protected` _scheduling

_scheduling: TransactionScheduling = ...

`Protected` _timestamp

_timestamp: Timestamp = ...

`Protected` _ttl

_ttl: Duration = ...

`Private` _validator

_validator: CLValue

Methods

`Protected` _getDefaultDeployHeader

_getDefaultDeployHeader(): DeployHeader
Protected
Creates a default deploy header with the configured transaction settings.

Returns
A deploy header with account, chain name, timestamp, TTL, and gas price

Returns DeployHeader
Inherited from TransactionBuilder._getDefaultDeployHeader
- Defined in src/types/TransactionBuilder.ts:148

`Protected` _getStandardPayment

_getStandardPayment(): ExecutableDeployItem
Protected
Creates a standard payment executable deploy item.

Returns
An executable deploy item configured for standard payment

Throws
If payment amount is not specified

Returns ExecutableDeployItem
Inherited from TransactionBuilder._getStandardPayment
- Defined in src/types/TransactionBuilder.ts:169

amount

amount(amount: string | BigNumber): NativeAddBidBuilder
Sets the bid amount in motes.

Returns
The builder instance for method chaining
Parameters
- amount: string | BigNumber
  
  The bid amount (minimum varies by network)
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:390

build

build(): Transaction
Builds and returns the Add Bid transaction for Casper 2.0+.

Returns
A complete Transaction object ready to be signed and submitted

Returns Transaction
Overrides TransactionBuilder.build
- Defined in src/types/TransactionBuilder.ts:452

buildFor1_5

buildFor1_5(): Transaction
Builds and returns the Add Bid transaction for Casper 1.5. Uses the auction manager contract for backward compatibility.

Returns
A Transaction object compatible with Casper 1.5

Throws
If initiator address or contract hash is not specified

Returns Transaction
- Defined in src/types/TransactionBuilder.ts:489

chainName

chainName(chainName: string): NativeAddBidBuilder
Sets the chain name for the transaction.

Returns
The builder instance for method chaining
Parameters
- chainName: string
  
  The name of the Casper network chain (e.g., 'casper-test', 'casper')
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.chainName
- Defined in src/types/TransactionBuilder.ts:85

contractHash

contractHash(contractHash: string): NativeAddBidBuilder
Sets the contract hash for the transaction.

Returns
The builder instance for method chaining
Parameters
- contractHash: string
  
  The contract hash in hexadecimal format
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.contractHash
- Defined in src/types/TransactionBuilder.ts:96

delegationRate

delegationRate(delegationRate: number): NativeAddBidBuilder
Sets the delegation rate (commission percentage).

Returns
The builder instance for method chaining
Parameters
- delegationRate: number
  
  Commission rate as a percentage (0-100)
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:401

from

from(publicKey: PublicKey): NativeAddBidBuilder
Sets the initiator address using a public key.

Returns
The builder instance for method chaining
Parameters
- publicKey: PublicKey
  
  The public key of the transaction initiator
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.from
- Defined in src/types/TransactionBuilder.ts:63

fromAccountHash

fromAccountHash(accountHashKey: AccountHash): NativeAddBidBuilder
Sets the initiator address using an account hash.

Returns
The builder instance for method chaining
Parameters
- accountHashKey: AccountHash
  
  The account hash of the transaction initiator
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.fromAccountHash
- Defined in src/types/TransactionBuilder.ts:74

maximumDelegationAmount

maximumDelegationAmount(maximumDelegationAmount: BigNumberish): NativeAddBidBuilder
Sets the maximum delegation amount for delegators.

Returns
The builder instance for method chaining
Parameters
- maximumDelegationAmount: BigNumberish
  
  Maximum amount delegators can stake
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:427

minimumDelegationAmount

minimumDelegationAmount(minimumDelegationAmount: BigNumberish): NativeAddBidBuilder
Sets the minimum delegation amount for delegators.

Returns
The builder instance for method chaining
Parameters
- minimumDelegationAmount: BigNumberish
  
  Minimum amount delegators can stake
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:412

payment

payment(paymentAmount: number, gasPriceTolerance?: number): NativeAddBidBuilder
Sets the payment amount for the transaction using a limited payment mode.

Returns
The builder instance for method chaining
Parameters
- paymentAmount: number
  
  The payment amount in motes
- gasPriceTolerance: number = 1
  
  Gas price tolerance multiplier (default: 1)
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.payment
- Defined in src/types/TransactionBuilder.ts:130

reservedSlots

reservedSlots(reservedSlots: BigNumber): NativeAddBidBuilder
Sets the number of reserved delegation slots.

Returns
The builder instance for method chaining
Parameters
- reservedSlots: BigNumber
  
  Number of slots reserved for specific delegators
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:442

timestamp

timestamp(timestamp: Timestamp): NativeAddBidBuilder
Sets the timestamp for the transaction.

Returns
The builder instance for method chaining
Parameters
- timestamp: Timestamp
  
  The transaction timestamp
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.timestamp
- Defined in src/types/TransactionBuilder.ts:107

ttl

ttl(ttl: number): NativeAddBidBuilder
Sets the time-to-live for the transaction.

Returns
The builder instance for method chaining
Parameters
- ttl: number
  
  Time-to-live in milliseconds (default: 1800000ms = 30 minutes)
Returns NativeAddBidBuilder
Inherited from TransactionBuilder.ttl
- Defined in src/types/TransactionBuilder.ts:118

validator

validator(publicKey: PublicKey): NativeAddBidBuilder
Sets the validator's public key for the bid.

Returns
The builder instance for method chaining
Parameters
- publicKey: PublicKey
  
  The validator's public key
Returns NativeAddBidBuilder
- Defined in src/types/TransactionBuilder.ts:379

Class NativeAddBidBuilder

Example

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Returns NativeAddBidBuilder

Properties

Private _amount

Protected _chainName

Protected _contractHash

Private _delegationRate

Protected _entryPoint

Protected _initiatorAddr

Protected _invocationTarget

Private Optional _maximumDelegationAmount

Private Optional _minimumDelegationAmount

Protected _pricingMode

Private Optional _reservedSlots

Protected _runtimeArgs

Protected _scheduling

Protected _timestamp

Protected _ttl

Private _validator

Methods

Protected _getDefaultDeployHeader

Returns

Returns DeployHeader

Protected _getStandardPayment

Returns

Throws

Returns ExecutableDeployItem

amount

Returns

Parameters

amount: string | BigNumber

Returns NativeAddBidBuilder

build

Returns

Returns Transaction

buildFor1_5

Returns

Throws

Returns Transaction

chainName

Returns

Parameters

chainName: string

Returns NativeAddBidBuilder

contractHash

Returns

Parameters

contractHash: string

Returns NativeAddBidBuilder

delegationRate

Returns

Parameters

delegationRate: number

Returns NativeAddBidBuilder

from

Returns

Parameters

publicKey: PublicKey

Returns NativeAddBidBuilder

fromAccountHash

Returns

Parameters

accountHashKey: AccountHash

Returns NativeAddBidBuilder

maximumDelegationAmount

Returns

Parameters

maximumDelegationAmount: BigNumberish

Returns NativeAddBidBuilder

minimumDelegationAmount

Returns

Parameters

`Private` _amount

`Protected` _chainName

`Protected` _contractHash

`Private` _delegationRate

`Protected` _entryPoint

`Protected` _initiatorAddr

`Protected` _invocationTarget

`Private` `Optional` _maximumDelegationAmount

`Private` `Optional` _minimumDelegationAmount

`Protected` _pricingMode

`Private` `Optional` _reservedSlots

`Protected` _runtimeArgs

`Protected` _scheduling

`Protected` _timestamp

`Protected` _ttl

`Private` _validator

`Protected` _getDefaultDeployHeader

`Protected` _getStandardPayment