@iota/bundle

@iota/bundle

Utilities for generating and signing bundles. A bundle in IOTA is an atomic set of transactions.

Installation

Install using npm:

npm install @iota/bundle

or using yarn:

yarn add @iota/bundle

API Reference

• bundle

  • ~createBundle(entries)

  • ~addEntry(transactions, entry)

  • ~addTrytes(transactions, fragments, [offset])

  • ~finalizeBundle(transactions)

bundle~createBundle(entries)

Param	Type	Description
entries	Array.<BundleEntry>	Entries of single or multiple transactions with the same address

Creates a bundle with given transaction entries.

Returns: Array.<Transaction> - List of transactions in the bundle

bundle~addEntry(transactions, entry)

Param	Type	Default	Description
transactions	Array.<Transaction>		List of transactions currently in the bundle
entry	object		Entry of a single or multiple transactions with the same address
[entry.length]	number	1	Entry length, which indicates how many transactions in the bundle it will occupy
[entry.address]	Hash		Address, defaults to all-9s
[entry.value]	number	0	Value to transfer in iotas
[entry.signatureMessageFragments]	Array.<Trytes>		List of signature message fragments, defaults to all-9s
[entry.timestamp]	number		Transaction timestamp, defaults to Math.floor(Date.now() / 1000)
[entry.tag]	string		Optional Tag, defaults to null tag (all-9s)

Adds given transaction entry to a bundle.

Returns: Array.<Transaction> - List of transactions in the updated bundle

bundle~addTrytes(transactions, fragments, [offset])

Param	Type	Default	Description
transactions	Array.<Transaction>		List of transactions in the bundle
fragments	Array.<Trytes>		List of signature message fragments to add
[offset]	number	0	Optional offset to start appending signature message fragments

Adds signature message fragments to transactions in a bundle starting at offset.

Returns: Array.<Transaction> - List of transactions in the updated bundle

bundle~finalizeBundle(transactions)

Param	Type	Description
transactions	Array.<Transaction>	List of transactions in the bundle

Finalizes a bundle by calculating the bundle hash.

Returns: Array.<Transaction> - List of transactions in the finalized bundle