Type Alias BoxRef

Readonlyexists

Readonlykey

Readonlylength

value

create

• create(options: { size: uint64 }): boolean

  Create the box for this proxy with the specified size if it does not exist

  No op if the box already exists

  Parameters

  • options: { size: uint64 }

    The size of the box to create

  Returns boolean

  True if the box was created, false if it already existed

delete

• delete(): boolean

  Delete the box associated with this proxy if it exists.

  Returns boolean

  True if the box existed and was deleted, else false

extract

• extract(start: uint64, length: uint64): bytes

  Extract a slice of bytes from the box

  Error if the box does not exist Error if start + length is greater than the box size

  Parameters

  • start: uint64

    The index to start extracting
  • length: uint64

    The number of bytes to extract

  Returns bytes

  The extracted bytes

get

• get(options: { default: bytes }): bytes

  Get the value stored in the box, or return a specified default value if the box does not exist

  Parameters

  • options: { default: bytes }

    Options to specify a default value to be returned if no other value exists

  Returns bytes

  The value if the box exists, else the default value

maybe

• maybe(): readonly [bytes, boolean]

  Get the value stored in the box if available, and a boolean indicating if the box exists.

  If the box does not exist, the value returned at position 0 will be an empty byte array.

  Returns readonly [bytes, boolean]

  A tuple with the first item being the box value, and the second item being a boolean indicating if the box exists.

put

• put(value: bytes): void

  Puts the specified bytes into the box replacing any existing value.

  Creates the box if it does not exist Errors if the box exists, but the length does not match the length of value

  Parameters

  • value: bytes

    The value to put into the box

  Returns void

replace

• replace(start: uint64, value: bytes): void

  Replace bytes in a box starting at start.

  Error if the box does not exist Error if start + value.length is greater than the box size

  Parameters

  • start: uint64

    The index to start replacing
  • value: bytes

    The value to be written

  Returns void

resize

• resize(newSize: uint64): void

  Resize the box to the specified size.

  Adds zero bytes to the end if the new size is larger Removes end bytes if the new size is smaller Error if the box does not exist

  Parameters

  • newSize: uint64

    The new size for the box

  Returns void

splice

• splice(start: uint64, length: uint64, value: bytes): void

  Splice the specified bytes into the box starting at start, removing length bytes from the existing value and replacing them with value before appending the remainder of the original box value.

  If the resulting byte value is larger than length, bytes will be trimmed from the end If the resulting byte value is smaller than length, zero bytes will be appended to the end Error if the box does not exist

  Parameters

  • start: uint64

    The index to start inserting the value
  • length: uint64

    The number of bytes after start to be omitted
  • value: bytes

    The value to be inserted

  Returns void