Skip to main content

ObjectId

open class ObjectId : Disposable, AutoCloseable, ObjectIdInterface

An ObjectId is a 32-byte identifier used to uniquely identify an object on the IOTA blockchain.

Relationship to Address

Addresses and ObjectIds share the same 32-byte addressable space but are derived leveraging different domain-separator values to ensure, cryptographically, that there won't be any overlap, e.g. there can't be a valid Object whose ObjectId is equal to that of the Address of a user account.

BCS

An ObjectId's BCS serialized form is defined by the following:

object-id = address

Functions

NameSummary
close@Synchronized
open override fun close()
deriveDynamicChildIdopen override fun deriveDynamicChildId(keyTypeTag: TypeTag, keyBytes: ByteArray): ObjectId
Derive an ObjectId for a Dynamic Child Object.
deriveObjectIdopen override fun deriveObjectId(keyTypeTag: TypeTag, keyBytes: ByteArray): ObjectId
Derive the ObjectId of a derived object (0x2::derived_object).
destroyopen override fun destroy()
equalsopen operator override fun equals(other: Any?): Boolean
hashCodeopen override fun hashCode(): Int
nextLexicographicalopen override fun nextLexicographical(): ObjectId
Returns the next digest in byte-increasing order.
nextLexicographicalOptopen override fun nextLexicographicalOpt(): ObjectId?
Returns the next digest in byte-increasing order, or None if the result would overflow.
toAddressopen override fun toAddress(): Address
toBytesopen override fun toBytes(): ByteArray
toCanonicalStringopen override fun toCanonicalString(withPrefix: Boolean): String
Returns the string representation of this object ID using the canonical display, with or without a 0x prefix.
toHexopen override fun toHex(): String
Returns the string representation of this object id in hex format with 0x prefix.
toRawHexopen override fun toRawHex(): String
Returns the string representation of this object id in hex format without 0x prefix.
toRawShortHexopen override fun toRawShortHex(): String
Returns the shortest possible string representation of the object id (i.e. with leading zeroes trimmed), without 0x prefix.
toShortHexopen override fun toShortHex(): String
Returns the shortest possible string representation of the object ID (i.e. with leading zeroes trimmed).
toStringopen override fun toString(): String

Companion object functions

NameSummary
authenticatorStatefun authenticatorState(): ObjectId
clockfun clock(): ObjectId
denyListfun denyList(): ObjectId
deriveIdfun deriveId(digest: TransactionDigest, count: ULong): ObjectId
Create an ObjectId from a transaction digest and the number of objects that have been created during a transactions.
frameworkfun framework(): ObjectId
fromBytesfun fromBytes(bytes: ByteArray): ObjectId
fromHexfun fromHex(hex: String): ObjectId
Parses an ObjectId from a full-length hex string (64 hex characters), with or without a 0x prefix. Will return an error if the string is not exactly 64 hex characters long (excluding the 0x prefix).
fromPrefixedHexfun fromPrefixedHex(hex: String): ObjectId
Parses an ObjectId from a full-length hex string (64 hex characters), with a mandatory 0x prefix. Will return an error if the string is not exactly 64 hex characters long (excluding the 0x prefix).
fromPrefixedShortHexfun fromPrefixedShortHex(hex: String): ObjectId
Parses an ObjectId from a hex string with a mandatory 0x prefix. The string can be of variable length; if it's shorter than 64 hex characters, it will be left-padded with 0s.
fromShortHexfun fromShortHex(hex: String): ObjectId
Parses an ObjectId from a hex string, with or without a 0x prefix. The string can be of variable length; if it's shorter than 64 hex characters, it will be left-padded with 0s.
genesisBridgefun genesisBridge(): ObjectId
genesisIotaBridgefun genesisIotaBridge(): ObjectId
maxfun max(): ObjectId
randomnessStatefun randomnessState(): ObjectId
stardustfun stardust(): ObjectId
stdfun std(): ObjectId
systemfun system(): ObjectId
systemStatefun systemState(): ObjectId
transactionDenyRulesfun transactionDenyRules(): ObjectId
zerofun zero(): ObjectId