Skip to main content

UpdateRole

@iota/audit-trails API documentation

Class: UpdateRole

Transaction wrapper for updating a role.

Remarks​

Replaces both the role's permissions and its roleTags; any newly supplied tag must already be in the trail's record-tag registry.

Requires the Permission.UpdateRoles permission.

Emits a RoleUpdated event on success.

Methods​

toJSON()​

toJSON(): Object

  • Return copy of self without private attributes.

Returns​

Object

toString()​

toString(): string

Return stringified version of self.

Returns​

string

applyWithEvents()​

applyWithEvents(wasm_effects, wasm_events, client): Promise<RoleUpdated>

Applies transaction effects and events and decodes the matching event payload.

Parameters​

wasm_effects​

TransactionEffects

wasm_events​

IotaEvent[]

client​

CoreClientReadOnly

Read-only core client used during application.

Returns​

Promise<RoleUpdated>

Decoded RoleUpdated event payload.

Throws​

When the expected event is missing or transaction application fails.

buildProgrammableTransaction()​

buildProgrammableTransaction(client): Promise<Uint8Array<ArrayBufferLike>>

Builds the programmable transaction bytes for submission.

Parameters​

client​

CoreClientReadOnly

Read-only core client used to resolve packages and serialize the transaction.

Returns​

Promise<Uint8Array<ArrayBufferLike>>

BCS-encoded programmable transaction bytes ready for signing and submission.

Throws​

When transaction serialization fails.