Class CreateTransactionRequest

CreateTransactionRequest provides functionalities for creating a transaction request that creates a contract.

Hierarchy (view full)

BaseTransactionRequest
- CreateTransactionRequest

Constructors

constructor

new CreateTransactionRequest(createTransactionRequestLike): CreateTransactionRequest
Creates an instance CreateTransactionRequest.
Parameters
- createTransactionRequestLike: CreateTransactionRequestLike
  The initial values for the instance
Returns CreateTransactionRequest
Overrides BaseTransactionRequest.constructor
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:53

Properties

bytecodeWitnessIndex

bytecodeWitnessIndex: number

Witness index of contract bytecode to create

inputs

inputs: TransactionRequestInput[] = []

List of inputs

`Optional`maturity

maturity?: number

Block until which tx cannot be included

maxFee

maxFee: BN

The maximum fee payable by this transaction using BASE_ASSET.

outputs

outputs: TransactionRequestOutput[] = []

List of outputs

salt

salt: string

Salt

storageSlots

storageSlots: TransactionRequestStorageSlot[]

List of storage slots to initialize

`Optional`tip

tip?: BN

Gas price for transaction

type

type: Create = ...

Type of the transaction

`Optional`witnessLimit

witnessLimit?: BN

The maximum amount of witness data allowed for the transaction

witnesses

witnesses: BytesLike[] = []

List of witnesses

Methods

addAccountWitnesses

addAccountWitnesses(account): Promise<CreateTransactionRequest>
Helper function to add an external signature to the transaction.
Parameters
- account: Account | Account[]
  The account/s to sign to the transaction.
Returns Promise<CreateTransactionRequest>
The transaction with the signature witness added.
Inherited from BaseTransactionRequest.addAccountWitnesses
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:294

addChangeOutput

addChangeOutput(to, assetId): void
Adds a change output to the transaction.
Parameters
- to: AddressLike
  Address of the owner.
- assetId: BytesLike
  Asset ID of coin.
Returns void
Inherited from BaseTransactionRequest.addChangeOutput
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:519

addCoinInput

addCoinInput(coin): void
Adds a single coin input to the transaction and a change output for the related assetId, if one it was not added yet.
Parameters
- coin: Coin
  Coin resource.
Returns void
Inherited from BaseTransactionRequest.addCoinInput
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:368

addCoinOutput

addCoinOutput(to, amount, assetId): CreateTransactionRequest
Adds a coin output to the transaction.
Parameters
- to: AddressLike
  Address of the owner.
- amount: BigNumberish
  Amount of coin.
- assetId: BytesLike
  Asset ID of coin.
Returns CreateTransactionRequest
Inherited from BaseTransactionRequest.addCoinOutput
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:483

addCoinOutputs

addCoinOutputs(to, quantities): CreateTransactionRequest
Adds multiple coin outputs to the transaction.
Parameters
- to: AddressLike
  Address of the destination.
- quantities: CoinQuantityLike[]
  Quantities of coins.
Returns CreateTransactionRequest
Inherited from BaseTransactionRequest.addCoinOutputs
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:500

addContractCreatedOutput

addContractCreatedOutput(contractId, stateRoot): void
Adds a contract created output to the transaction request.
Parameters
- contractId: BytesLike
  The contract ID.
- stateRoot: BytesLike
  The state root.
Returns void
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:108

addMessageInput

addMessageInput(message): void
Adds a single message input to the transaction and a change output for the asset against the message
Parameters
- message: Message | MessageCoin
  Message resource.
Returns void
Inherited from BaseTransactionRequest.addMessageInput
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:409

addResource

addResource(resource): CreateTransactionRequest
Adds a single resource to the transaction by adding a coin/message input and a change output for the related assetId, if one it was not added yet.
Parameters
- resource: Resource
  The resource to add.
Returns CreateTransactionRequest
This transaction.
Inherited from BaseTransactionRequest.addResource
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:453

addResources

addResources(resources): CreateTransactionRequest
Adds multiple resources to the transaction by adding coin/message inputs and change outputs from the related assetIds.
Parameters
- resources: readonly Resource[]
  The resources to add.
Returns CreateTransactionRequest
This transaction.
Inherited from BaseTransactionRequest.addResources
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:470

byteLength

byteLength(): number
Returns number
Inherited from BaseTransactionRequest.byteLength
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:709

calculateMaxGas

calculateMaxGas(chainInfo, minGas): BN
Parameters
- chainInfo: ChainInfo
- minGas: BN
Returns BN
Inherited from BaseTransactionRequest.calculateMaxGas
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:567

fundWithFakeUtxos

fundWithFakeUtxos(quantities, baseAssetId, resourcesOwner?): CreateTransactionRequest
Funds the transaction with fake UTXOs for each assetId and amount in the quantities array.
Parameters
- quantities: CoinQuantity[]
  CoinQuantity Array.
- baseAssetId: string
  The base asset to fund the transaction.
- OptionalresourcesOwner: AbstractAddress
Returns CreateTransactionRequest
Deprecated
- This method is deprecated and will be removed in future versions. Please use Account.generateFakeResources along with this.addResources instead.
Inherited from BaseTransactionRequest.fundWithFakeUtxos
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:596

`Protected`getBaseTransaction

getBaseTransaction(): ToBaseTransactionResponse
Method to obtain the base transaction details.

Returns ToBaseTransactionResponse
The base transaction details.
Inherited from BaseTransactionRequest.getBaseTransaction
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:179

getChangeOutputs

getChangeOutputs(): ChangeTransactionRequestOutput[]
Gets the change outputs for a transaction.

Returns ChangeTransactionRequestOutput[]
The change outputs.
Inherited from BaseTransactionRequest.getChangeOutputs
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:332

getCoinInputs

getCoinInputs(): CoinTransactionRequestInput[]
Gets the coin inputs for a transaction.

Returns CoinTransactionRequestInput[]
The coin inputs.
Inherited from BaseTransactionRequest.getCoinInputs
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:310

getCoinOutputs

getCoinOutputs(): CoinTransactionRequestOutput[]
Gets the coin outputs for a transaction.

Returns CoinTransactionRequestOutput[]
The coin outputs.
Inherited from BaseTransactionRequest.getCoinOutputs
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:321

getCoinOutputsQuantities

getCoinOutputsQuantities(): CoinQuantity[]
Retrieves an array of CoinQuantity for each coin output present in the transaction. a transaction.

Returns CoinQuantity[]
CoinQuantity array.
Inherited from BaseTransactionRequest.getCoinOutputsQuantities
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:647

getContractCreatedOutputs

getContractCreatedOutputs(): ContractCreatedTransactionRequestOutput[]
Get contract created outputs for the transaction.

Returns ContractCreatedTransactionRequestOutput[]
An array of contract created transaction request outputs.
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:84

getTransactionId

getTransactionId(chainId): string
Gets the Transaction Request by hashing the transaction.
Parameters
- chainId: number
  The chain ID.
Returns string
- A hash of the transaction, which is the transaction ID.
Overrides BaseTransactionRequest.getTransactionId
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:98

removeWitness

removeWitness(index): void
Parameters
- index: number
Returns void
Inherited from BaseTransactionRequest.removeWitness
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:675

toJSON

toJSON(): any
Return the minimum amount in native coins required to create a transaction.

Returns any
The transaction as a JSON object.
Inherited from BaseTransactionRequest.toJSON
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:671

toTransaction

toTransaction(): TransactionCreate
Converts the transaction request to a TransactionCreate.

Returns TransactionCreate
The transaction create object.
Overrides BaseTransactionRequest.toTransaction
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:65

toTransactionBytes

toTransactionBytes(): Uint8Array
Converts the transaction request to a byte array.

Returns Uint8Array
The transaction bytes.
Inherited from BaseTransactionRequest.toTransactionBytes
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:210

updatePredicateGasUsed

updatePredicateGasUsed(inputs): void
Parameters
- inputs: TransactionRequestInput[]
Returns void
Inherited from BaseTransactionRequest.updatePredicateGasUsed
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:689

updateWitness

updateWitness(index, witness): void
Updates an existing witness without any side effects.
Parameters
- index: number
  The index of the witness to update.
- witness: BytesLike
  The new witness.
Returns void
Throws
If the witness does not exist.
Inherited from BaseTransactionRequest.updateWitness
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:281

updateWitnessByOwner

updateWitnessByOwner(address, signature): void
Updates the witness for a given owner and signature.
Parameters
- address: string | AbstractAddress
  The address to get the coin input witness index for.
- signature: BytesLike
  The signature to update the witness with.
Returns void
Inherited from BaseTransactionRequest.updateWitnessByOwner
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:266

`Static`from

from(obj): CreateTransactionRequest
Parameters
- obj: CreateTransactionRequestLike
Returns CreateTransactionRequest
- Defined in packages/account/src/providers/transaction-request/create-transaction-request.ts:35

`Static`getPolicyMeta

getPolicyMeta(req): {
policies: Policy[];
policyTypes: number;
}
Parameters
- req: BaseTransactionRequest
Returns {
policies: Policy[];
policyTypes: number;
}
- policies: Policy[]
- policyTypes: number
Inherited from BaseTransactionRequest.getPolicyMeta
- Defined in packages/account/src/providers/transaction-request/transaction-request.ts:145

Class CreateTransactionRequest

Hierarchy (view full)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns CreateTransactionRequest

Properties

bytecodeWitnessIndex

inputs

Optionalmaturity

maxFee

outputs

salt

storageSlots

Optionaltip

type

OptionalwitnessLimit

witnesses

Methods

addAccountWitnesses

Parameters

Returns Promise<CreateTransactionRequest>

addChangeOutput

Parameters

Returns void

addCoinInput

Parameters

Returns void

addCoinOutput

Parameters

Returns CreateTransactionRequest

addCoinOutputs

Parameters

Returns CreateTransactionRequest

addContractCreatedOutput

Parameters

Returns void

addMessageInput

Parameters

Returns void

addResource

Parameters

Returns CreateTransactionRequest

addResources

Parameters

Returns CreateTransactionRequest

byteLength

Returns number

calculateMaxGas

Parameters

Returns BN

fundWithFakeUtxos

Parameters

Returns CreateTransactionRequest

Deprecated

ProtectedgetBaseTransaction

Returns ToBaseTransactionResponse

getChangeOutputs

Returns ChangeTransactionRequestOutput[]

getCoinInputs

Returns CoinTransactionRequestInput[]

getCoinOutputs

Returns CoinTransactionRequestOutput[]

getCoinOutputsQuantities

Returns CoinQuantity[]

getContractCreatedOutputs

Returns ContractCreatedTransactionRequestOutput[]

getTransactionId

Parameters

Returns string

removeWitness

Parameters

Returns void

toJSON

Returns any

toTransaction

`Optional`maturity

`Optional`tip

`Optional`witnessLimit

`Protected`getBaseTransaction

`Static`from

`Static`getPolicyMeta

Returns {
policies: Policy[];
policyTypes: number;
}