Class Dictionary<K, V>

Type Parameters

K extends DictionaryKeyTypes
V

Hierarchy

Dictionary

Index

Constructors

`Private` constructor

new Dictionary<K, V>(values: Map<string, V>, key: null | DictionaryKey<K>, value: null | DictionaryValue<V>): Dictionary<K, V>
Type Parameters
- K extends DictionaryKeyTypes
- V
Parameters
- values: Map<string, V>
- key: null | DictionaryKey<K>
- value: null | DictionaryValue<V>
Returns Dictionary<K, V>
- Defined in src/dict/Dictionary.ts:282

Properties

`Private` `Readonly` _key

_key: null | DictionaryKey<K>

`Private` `Readonly` _map

_map: Map<string, V>

`Private` `Readonly` _value

_value: null | DictionaryValue<V>

`Static` Keys

Keys: {
    Address: (() => DictionaryKey<Address>);
    BigInt: ((bits: number) => DictionaryKey<bigint>);
    BigUint: ((bits: number) => DictionaryKey<bigint>);
    BitString: ((bits: number) => DictionaryKey<BitString>);
    Buffer: ((bytes: number) => DictionaryKey<Buffer>);
    Int: ((bits: number) => DictionaryKey<number>);
    Uint: ((bits: number) => DictionaryKey<number>);
} = ...

Type declaration

Address: (() => DictionaryKey<Address>)
- - (): DictionaryKey<Address>
  - Standard address key
    
    Returns
    DictionaryKey
    
    Returns DictionaryKey<Address>
BigInt: ((bits: number) => DictionaryKey<bigint>)
- - (bits: number): DictionaryKey<bigint>
  - Create standard big integer key
    
    Returns
    DictionaryKey
    Parameters
    - bits: number
      
      number of bits
    Returns DictionaryKey<bigint>
BigUint: ((bits: number) => DictionaryKey<bigint>)
- - (bits: number): DictionaryKey<bigint>
  - Create standard unsigned big integer key
    
    Returns
    DictionaryKey
    Parameters
    - bits: number
      
      number of bits
    Returns DictionaryKey<bigint>
BitString: ((bits: number) => DictionaryKey<BitString>)
- - (bits: number): DictionaryKey<BitString>
  - Create BitString key
    
    Returns
    DictionaryKey Point is that Buffer has to be 8 bit aligned, while key is TVM dictionary doesn't have to be aligned at all.
    Parameters
    - bits: number
      
      key length
    Returns DictionaryKey<BitString>
Buffer: ((bytes: number) => DictionaryKey<Buffer>)
- - (bytes: number): DictionaryKey<Buffer>
  - Create standard buffer key
    
    Returns
    DictionaryKey
    Parameters
    - bytes: number
      
      number of bytes of a buffer
    Returns DictionaryKey<Buffer>
Int: ((bits: number) => DictionaryKey<number>)
- - (bits: number): DictionaryKey<number>
  - Create integer key
    
    Returns
    DictionaryKey
    Parameters
    - bits: number
      
      bits of integer
    Returns DictionaryKey<number>
Uint: ((bits: number) => DictionaryKey<number>)
- - (bits: number): DictionaryKey<number>
  - Create standard unsigned integer key
    
    Returns
    DictionaryKey
    Parameters
    - bits: number
      
      number of bits
    Returns DictionaryKey<number>

`Static` Values

Values: {
    Address: (() => DictionaryValue<Address>);
    BigInt: ((bits: number) => DictionaryValue<bigint>);
    BigUint: ((bits: number) => DictionaryValue<bigint>);
    BigVarInt: ((bits: number) => DictionaryValue<bigint>);
    BigVarUint: ((bits: number) => DictionaryValue<bigint>);
    BitString: ((bits: number) => DictionaryValue<BitString>);
    Bool: (() => DictionaryValue<boolean>);
    Buffer: ((bytes: number) => DictionaryValue<Buffer>);
    Cell: (() => DictionaryValue<Cell>);
    Dictionary: (<K, V>(key: DictionaryKey<K>, value: DictionaryValue<V>) => DictionaryValue<Dictionary<K, V>>);
    Int: ((bits: number) => DictionaryValue<number>);
    Uint: ((bits: number) => DictionaryValue<number>);
} = ...

Type declaration

Address: (() => DictionaryValue<Address>)
- - (): DictionaryValue<Address>
  - Create standard address value
    
    Returns
    DictionaryValue
    
    Returns DictionaryValue<Address>
BigInt: ((bits: number) => DictionaryValue<bigint>)
- - (bits: number): DictionaryValue<bigint>
  - Create standard integer value
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
    Returns DictionaryValue<bigint>
BigUint: ((bits: number) => DictionaryValue<bigint>)
- - (bits: number): DictionaryValue<bigint>
  - Create standard unsigned integer value
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
      
      number of bits
    Returns DictionaryValue<bigint>
BigVarInt: ((bits: number) => DictionaryValue<bigint>)
- - (bits: number): DictionaryValue<bigint>
  - Create big var int
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
      
      nubmer of header bits
    Returns DictionaryValue<bigint>
BigVarUint: ((bits: number) => DictionaryValue<bigint>)
- - (bits: number): DictionaryValue<bigint>
  - Create big var int
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
      
      nubmer of header bits
    Returns DictionaryValue<bigint>
BitString: ((bits: number) => DictionaryValue<BitString>)
- - (bits: number): DictionaryValue<BitString>
  - Create BitString value
    
    Returns
    DictionaryValue Point is that Buffer is not applicable when length is not 8 bit alligned.
    Parameters
    - bits: number
    Returns DictionaryValue<BitString>
Bool: (() => DictionaryValue<boolean>)
- - (): DictionaryValue<boolean>
  - Create standard boolean value
    
    Returns
    DictionaryValue
    
    Returns DictionaryValue<boolean>
Buffer: ((bytes: number) => DictionaryValue<Buffer>)
- - (bytes: number): DictionaryValue<Buffer>
  - Create Builder value
    
    Returns
    DictionaryValue
    Parameters
    - bytes: number
      
      number of bytes of a buffer
    Returns DictionaryValue<Buffer>
Cell: (() => DictionaryValue<Cell>)
- - (): DictionaryValue<Cell>
  - Create standard cell value
    
    Returns
    DictionaryValue
    
    Returns DictionaryValue<Cell>
Dictionary: (<K, V>(key: DictionaryKey<K>, value: DictionaryValue<V>) => DictionaryValue<Dictionary<K, V>>)
- - <K, V>(key: DictionaryKey<K>, value: DictionaryValue<V>): DictionaryValue<Dictionary<K, V>>
  - Create dictionary value
    Type Parameters
    - K extends DictionaryKeyTypes
    - V
    Parameters
    - key: DictionaryKey<K>
    - value: DictionaryValue<V>
    Returns DictionaryValue<Dictionary<K, V>>
Int: ((bits: number) => DictionaryValue<number>)
- - (bits: number): DictionaryValue<number>
  - Create standard integer value
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
    Returns DictionaryValue<number>
Uint: ((bits: number) => DictionaryValue<number>)
- - (bits: number): DictionaryValue<number>
  - Create standard unsigned integer value
    
    Returns
    DictionaryValue
    Parameters
    - bits: number
      
      number of bits
    Returns DictionaryValue<number>

Accessors

size

get size(): number
Returns number
- Defined in src/dict/Dictionary.ts:288

Methods

[iterator]

[iterator](): IterableIterator<[K, V]>
Returns IterableIterator<[K, V]>
- Defined in src/dict/Dictionary.ts:314

clear

clear(): void
Returns void
- Defined in src/dict/Dictionary.ts:310

delete

delete(key: K): boolean
Parameters
- key: K
Returns boolean
- Defined in src/dict/Dictionary.ts:305

generateMerkleProof

generateMerkleProof(key: K): Cell
Parameters
- key: K
Returns Cell
- Defined in src/dict/Dictionary.ts:395

generateMerkleUpdate

generateMerkleUpdate(key: K, newValue: V): Cell
Parameters
- key: K
- newValue: V
Returns Cell
- Defined in src/dict/Dictionary.ts:399

get

get(key: K): undefined | V
Parameters
- key: K
Returns undefined | V
- Defined in src/dict/Dictionary.ts:292

has

has(key: K): boolean
Parameters
- key: K
Returns boolean
- Defined in src/dict/Dictionary.ts:296

keys

keys(): K[]
Returns K[]
- Defined in src/dict/Dictionary.ts:321

set

set(key: K, value: V): Dictionary<K, V>
Parameters
- key: K
- value: V
Returns Dictionary<K, V>
- Defined in src/dict/Dictionary.ts:300

store

store(builder: Builder, key?: Maybe<DictionaryKey<K>>, value?: Maybe<DictionaryValue<V>>): void
Parameters
- builder: Builder
- Optional key: Maybe<DictionaryKey<K>>
- Optional value: Maybe<DictionaryValue<V>>
Returns void
- Defined in src/dict/Dictionary.ts:329

storeDirect

storeDirect(builder: Builder, key?: Maybe<DictionaryKey<K>>, value?: Maybe<DictionaryValue<V>>): void
Parameters
- builder: Builder
- Optional key: Maybe<DictionaryKey<K>>
- Optional value: Maybe<DictionaryValue<V>>
Returns void
- Defined in src/dict/Dictionary.ts:364

values

values(): V[]
Returns V[]
- Defined in src/dict/Dictionary.ts:325

`Static` empty

empty<K, V>(key?: Maybe<DictionaryKey<K>>, value?: Maybe<DictionaryValue<V>>): Dictionary<K, V>
Create an empty map

Returns
Dictionary<K, V>
Type Parameters
- K extends DictionaryKeyTypes
- V
Parameters
- Optional key: Maybe<DictionaryKey<K>>
  
  key type
- Optional value: Maybe<DictionaryValue<V>>
  
  value type
Returns Dictionary<K, V>
- Defined in src/dict/Dictionary.ts:218

`Static` load

load<K, V>(key: DictionaryKey<K>, value: DictionaryValue<V>, sc: Slice | Cell): Dictionary<K, V>
Load dictionary from slice

Returns
Dictionary<K, V>
Type Parameters
- K extends DictionaryKeyTypes
- V
Parameters
- key: DictionaryKey<K>
  
  key description
- value: DictionaryValue<V>
  
  value description
- sc: Slice | Cell
Returns Dictionary<K, V>
- Defined in src/dict/Dictionary.ts:233

`Static` loadDirect

loadDirect<K, V>(key: DictionaryKey<K>, value: DictionaryValue<V>, sc: null | Slice | Cell): Dictionary<K, V>
Low level method for rare dictionaries from system contracts. Loads dictionary from slice directly without going to the ref.

Returns
Dictionary<K, V>
Type Parameters
- K extends DictionaryKeyTypes
- V
Parameters
- key: DictionaryKey<K>
  
  key description
- value: DictionaryValue<V>
  
  value description
- sc: null | Slice | Cell
  
  slice
Returns Dictionary<K, V>
- Defined in src/dict/Dictionary.ts:260

Class Dictionary<K, V>

Type Parameters

K extends DictionaryKeyTypes

V

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

Private constructor

Type Parameters

K extends DictionaryKeyTypes

V

Parameters

values: Map<string, V>

key: null | DictionaryKey<K>

value: null | DictionaryValue<V>

Returns Dictionary<K, V>

Properties

Private Readonly _key

Private Readonly _map

Private Readonly _value

Static Keys

Type declaration

Address: (() => DictionaryKey<Address>)

Returns

Returns DictionaryKey<Address>

BigInt: ((bits: number) => DictionaryKey<bigint>)

Returns

Parameters

bits: number

Returns DictionaryKey<bigint>

BigUint: ((bits: number) => DictionaryKey<bigint>)

Returns

Parameters

bits: number

Returns DictionaryKey<bigint>

BitString: ((bits: number) => DictionaryKey<BitString>)

Returns

Parameters

bits: number

Returns DictionaryKey<BitString>

Buffer: ((bytes: number) => DictionaryKey<Buffer>)

Returns

Parameters

bytes: number

Returns DictionaryKey<Buffer>

Int: ((bits: number) => DictionaryKey<number>)

Returns

Parameters

bits: number

Returns DictionaryKey<number>

Uint: ((bits: number) => DictionaryKey<number>)

Returns

Parameters

bits: number

Returns DictionaryKey<number>

Static Values

Type declaration

Address: (() => DictionaryValue<Address>)

Returns

Returns DictionaryValue<Address>

BigInt: ((bits: number) => DictionaryValue<bigint>)

Returns

Parameters

bits: number

Returns DictionaryValue<bigint>

BigUint: ((bits: number) => DictionaryValue<bigint>)

Returns

Parameters

bits: number

Returns DictionaryValue<bigint>

BigVarInt: ((bits: number) => DictionaryValue<bigint>)

Returns

Parameters

bits: number

Returns DictionaryValue<bigint>

BigVarUint: ((bits: number) => DictionaryValue<bigint>)

`Private` constructor

`Private` `Readonly` _key

`Private` `Readonly` _map

`Private` `Readonly` _value

`Static` Keys

`Static` Values