Links

Module utils

Module utils

Misc utility Functions.

Functions

convert_address – Converts address from any TON format to any TON format
get_address_type – Validates and returns the type of any TON address.
calc_storage_fee – Calculates storage fee for an account over a specified time period
compress_zstd – Compresses data using Zstandard algorithm
decompress_zstd – Decompresses data using Zstandard algorithm

Types

Functions

convert_address

Converts address from any TON format to any TON format
type ParamsOfConvertAddress = {
address: string,
output_format: AddressStringFormat
}
type ResultOfConvertAddress = {
address: string
}
function convert_address(
params: ParamsOfConvertAddress,
): Promise<ResultOfConvertAddress>;
function convert_address_sync(
params: ParamsOfConvertAddress,
): ResultOfConvertAddress;
NOTE: Sync version is available only for lib-node binding.

Parameters

  • address: string – Account address in any TON format.
  • output_format: AddressStringFormat – Specify the format to convert to.

Result

  • address: string – Address in the specified format

get_address_type

Validates and returns the type of any TON address.
Address types are the following
0:919db8e740d50bf349df2eea03fa30c385d846b991ff5542e67098ee833fc7f7 - standard TON address most commonly used in all cases. Also called as hex address 919db8e740d50bf349df2eea03fa30c385d846b991ff5542e67098ee833fc7f7 - account ID. A part of full address. Identifies account inside particular workchain EQCRnbjnQNUL80nfLuoD+jDDhdhGuZH/VULmcJjugz/H9wam - base64 address. Also called "user-friendly". Was used at the beginning of TON. Now it is supported for compatibility
type ParamsOfGetAddressType = {
address: string
}
type ResultOfGetAddressType = {
address_type: AccountAddressType
}
function get_address_type(
params: ParamsOfGetAddressType,
): Promise<ResultOfGetAddressType>;
function get_address_type_sync(
params: ParamsOfGetAddressType,
): ResultOfGetAddressType;
NOTE: Sync version is available only for lib-node binding.

Parameters

  • address: string – Account address in any TON format.

Result

calc_storage_fee

Calculates storage fee for an account over a specified time period
type ParamsOfCalcStorageFee = {
account: string,
period: number
}
type ResultOfCalcStorageFee = {
fee: string
}
function calc_storage_fee(
params: ParamsOfCalcStorageFee,
): Promise<ResultOfCalcStorageFee>;
function calc_storage_fee_sync(
params: ParamsOfCalcStorageFee,
): ResultOfCalcStorageFee;
NOTE: Sync version is available only for lib-node binding.

Parameters

  • account: string
  • period: number

Result

  • fee: string

compress_zstd

Compresses data using Zstandard algorithm
type ParamsOfCompressZstd = {
uncompressed: string,
level?: number
}
type ResultOfCompressZstd = {
compressed: string
}
function compress_zstd(
params: ParamsOfCompressZstd,
): Promise<ResultOfCompressZstd>;
function compress_zstd_sync(
params: ParamsOfCompressZstd,
): ResultOfCompressZstd;
NOTE: Sync version is available only for lib-node binding.

Parameters

  • uncompressed: string – Uncompressed data. Must be encoded as base64.
  • level?: number – Compression level, from 1 to 21. Where: 1 - lowest compression level (fastest compression); 21 - highest compression level (slowest compression). If level is omitted, the default compression level is used (currently 3).

Result

  • compressed: string – Compressed data. Must be encoded as base64.

decompress_zstd

Decompresses data using Zstandard algorithm
type ParamsOfDecompressZstd = {
compressed: string
}
type ResultOfDecompressZstd = {
decompressed: string
}
function decompress_zstd(
params: ParamsOfDecompressZstd,
): Promise<ResultOfDecompressZstd>;
function decompress_zstd_sync(
params: ParamsOfDecompressZstd,
): ResultOfDecompressZstd;
NOTE: Sync version is available only for lib-node binding.

Parameters

  • compressed: string – Compressed data. Must be encoded as base64.

Result

  • decompressed: string – Decompressed data. Must be encoded as base64.

Types

AddressStringFormatAccountIdVariant

type AddressStringFormatAccountIdVariant = {
}

AddressStringFormatHexVariant

type AddressStringFormatHexVariant = {
}

AddressStringFormatBase64Variant

type AddressStringFormatBase64Variant = {
url: boolean,
test: boolean,
bounce: boolean
}
  • url: boolean
  • test: boolean
  • bounce: boolean

AddressStringFormat

type AddressStringFormat = ({
type: 'AccountId'
} & AddressStringFormatAccountIdVariant) | ({
type: 'Hex'
} & AddressStringFormatHexVariant) | ({
type: 'Base64'
} & AddressStringFormatBase64Variant)
Depends on value of the type field.
When type is 'AccountId'
When type is 'Hex'
When type is 'Base64'
  • url: boolean
  • test: boolean
  • bounce: boolean
Variant constructors:
function addressStringFormatAccountId(): AddressStringFormat;
function addressStringFormatHex(): AddressStringFormat;
function addressStringFormatBase64(url: boolean, test: boolean, bounce: boolean): AddressStringFormat;

AccountAddressType

enum AccountAddressType {
AccountId = "AccountId",
Hex = "Hex",
Base64 = "Base64"
}
One of the following value:
  • AccountId = "AccountId"
  • Hex = "Hex"
  • Base64 = "Base64"

ParamsOfConvertAddress

type ParamsOfConvertAddress = {
address: string,
output_format: AddressStringFormat
}
  • address: string – Account address in any TON format.
  • output_format: AddressStringFormat – Specify the format to convert to.

ResultOfConvertAddress

type ResultOfConvertAddress = {
address: string
}
  • address: string – Address in the specified format

ParamsOfGetAddressType

type ParamsOfGetAddressType = {
address: string
}
  • address: string – Account address in any TON format.

ResultOfGetAddressType

type ResultOfGetAddressType = {
address_type: AccountAddressType
}

ParamsOfCalcStorageFee

type ParamsOfCalcStorageFee = {
account: string,
period: number
}
  • account: string
  • period: number

ResultOfCalcStorageFee

type ResultOfCalcStorageFee = {
fee: string
}
  • fee: string

ParamsOfCompressZstd

type ParamsOfCompressZstd = {
uncompressed: string,
level?: number
}
  • uncompressed: string – Uncompressed data. Must be encoded as base64.
  • level?: number – Compression level, from 1 to 21. Where: 1 - lowest compression level (fastest compression); 21 - highest compression level (slowest compression). If level is omitted, the default compression level is used (currently 3).

ResultOfCompressZstd

type ResultOfCompressZstd = {
compressed: string
}
  • compressed: string – Compressed data. Must be encoded as base64.

ParamsOfDecompressZstd

type ParamsOfDecompressZstd = {
compressed: string
}
  • compressed: string – Compressed data. Must be encoded as base64.

ResultOfDecompressZstd

type ResultOfDecompressZstd = {
decompressed: string
}
  • decompressed: string – Decompressed data. Must be encoded as base64.