Skip to content

CHANGELOG.md

Latest commit

 

History

History
2087 lines (1438 loc) · 74.2 KB

CHANGELOG.md

File metadata and controls

2087 lines (1438 loc) · 74.2 KB
Raw

Release Notes

All notable changes to this project will be documented in this file.

[3.0.5] - 2026-08-11

Changed

  • Make execution fee constant for executions that failed with execution timeout

[3.0.4] - 2026-07-10

Added

  • Add ZK Halo2 verification insns: ZKHALO2VERIFY (C749), ZKHALO2VERIFYWITHVK (C74A); extending prior VERGRTH16 / Poseidon ZK support with a Halo2/KZG backend.
  • Add CHKHISTPROOF (C750) for TVM block history Merkle proof checks.

[3.0.3] - 2026-07-01

Changed

  • Improve Poseidon hash implementation

[3.0.2] - 2026-06-15

Fixed

  • tvm_abi: fixed an off-by-32 error when decoding values spanning multiple cells, which produced WrongDataLayout when the last field spilled into a reference cell.
  • tvm_client/tvm-cli: sending a message (e.g. tvm-cli call/callx) to a node that serves only the REST message API and returns 404 on /graphql no longer fails with code 11: Server responded with code 404. The GraphQL server-version probe is now best-effort: when GraphQL is reachable its info.version is trusted as before; when it is unavailable the send proceeds using the current v3 wire format instead of aborting, mirroring the existing get_account fallback.

[3.0.1] - 2026-06-08

Fixed

  • tvm_types/tvm_executor: use a fixed seed for the per-thread unique-cell Bloom filter, reset it before and after transaction execution, and manage executor cell size limits with an RAII guard so Bloom state and TLS limits are always cleared, including early error paths such as MaxBOCSizeExceeded. This makes transaction cell/tree size accounting deterministic and prevents producer/verifier divergence caused by stale warm Bloom state.
  • tvm_cli: fixed decode::tests::test_decode_body_json to use an existing manifest-relative wallet ABI fixture instead of a missing tests/samples/wallet.abi.json path.
  • tvm_debugger: fixed the test RunArgs initializer to include block_seq_no.

[3.0.0] - 2026-06-05

Upgrading from 2.x? See docs/MIGRATION-3.0.md for a step-by-step migration guide covering the dapp_id changes below.

Changed (breaking)

  • Default HD key derivation path changed from m/44'/396'/0'/0/0 to m/44'/1331'/0'/0/0. Crypto functions (tvm_client) and key/address generation (tvm_cli) that rely on the default path now derive different keys from the same seed phrase. To keep previous keys, pass the old path explicitly.
  • tvm_client: ParamsOfGetAccount.address renamed to account_id; now strict 64-character hex (no 0x, no workchain). Added required dapp_id field.
  • tvm_client: ResultOfGetAccount.dapp_id is now String (not Option); added account_id field.
  • tvm_client: ParamsOfSendMessage.dst_dapp_id: Option<String> renamed to dapp_id: String (empty allowed only for pre-1.0.0 servers).
  • tvm_client: ResultOfSendMessage now exposes account_id and dapp_id (always populated; derived from the request when the server doesn't return them).
  • tvm_client: ParamsOfProcessMessage.dst_dapp_id renamed to dapp_id: String.
  • tvm-cli now requires the dapp_id::account_id address form on all commands and against all nodes; legacy 0:<hex> and bare-hex address inputs are no longer accepted.
  • tvm-cli deploy/deployx now always require --dst-dapp-id (including --fee mode); pass all zeros for a self-rooted dapp.
  • tvm-cli genaddr additionally prints the dapp_id::account_id (dapp_account in JSON) self-rooted form.

Added

  • tvm_client: SDK version-gates /v2/account and /v2/messages wire formats based on GraphQL info.version. v>=1.0.0 sends new dapp_id/account_id fields; v<1.0.0 keeps legacy address/dst_dapp_id.
  • tvm_client: new ServerLink::server_version() and ServerLink::supports_dapp_id() helpers.

[2.24.21] - 2026-04-29

Added

  • --block-seq-no option for tvm-debugger run that allows to set block seq no for TVM execution

[2.24.20] - 2026-04-20

Changed

  • tvm_api and tvm_block_json: gated TON-specific code behind the ton feature
  • TON-related dependencies are now optional to allow lighter builds without TON support

[2.24.19] - 2026-04-17

Added

  • tvm_client: new account.get_account API returning account BOC, optional dapp_id, and state timestamp
  • tvm_cli: support for extended address parsing via SdkAddress::from_str, including dapp_id extraction from user-provided addresses

Changed

  • tvm_client: ClientError now exposes accessor methods (code(), message(), data(), etc.) instead of relying on direct public field access, and now carries optional traceparent
  • tvm_client: ParamsOfSendMessage now includes thread_id and dst_dapp_id
  • tvm_client: ParamsOfProcessMessage now includes dst_dapp_id
  • tvm_client: ParamsOfWaitForTransaction now accepts tx_hash; shard_block_id is deprecated and no longer used for transaction lookup
  • tvm_client: ResultOfSendMessage now returns message and transaction metadata (message_hash, block_hash, tx_hash, return_value, aborted, exit_code, thread_id, producers, current_time) instead of shard_block_id and sending_endpoints
  • tvm_client: process_message and wait_for_transaction now use the transaction hash returned by send_message
  • tvm_cli: call, callx, and proposal commands now derive destination dapp_id from extended addresses
  • tvm_cli: deploy, deployx, and send commands now accept explicit --dst-dapp-id where the destination dapp_id can not be derived from an address

Fixed

  • tvm_cli: fixed dump accounts address validation for the current SdkAddress API

[2.24.18] - 2026-04-13

Added

  • tvm_client: retry with exponential backoff for query_http
  • tvm_cli: --log-path and --log-filter options to redirect and filter log output to a file, keeping stdout/stderr clean for automation

Changed

  • Removed failure crate dependency across all workspace crates in favor of anyhow
  • Replaced anyhow::Error::msg with anyhow::anyhow! macro for idiomatic error construction
  • tvm_client: removed non-standard REST API port 8600, use standard HTTP/HTTPS ports
  • tvm_cli: console log output is suppressed in --json mode; default log level lowered from Warn to Error

[2.24.17] - 2026-04-07

Fixed

  • Fixed WASM web build compatibility and ZK dependency handling
  • Fixed current_traceparent function in endpoint.rs
  • Optimized dependencies: ZK deps behind feature gate, dependency deduplication, workspace consolidation

Changed

  • Removed redundant compliant flag from HD key derivation

[2.24.16] - 2026-03-23

Fixes

  • Fixed fwd_fee with flag 16
  • Fixed use_new_version artifacts

[2.24.15] - 2026-03-19

Fixes

  • Fixed exchange system for 16 flag in message

[2.24.14] - 2026-03-06

Fixes

  • Fixed MerkleUpdate generation for a single account cell

[2.24.13] - 2026-03-06

Added

  • tvm_client: outgoing HTTP requests now include a traceparent header; on failure the trace identifier is included in the error message for easier diagnostics

Changed

  • tvm_cli: migrated CLI argument definitions to current clap v3 API, removing deprecated usage

Fixed

  • tvm_cli: --abi argument is now required for the genaddr subcommand, preventing confusing runtime errors when omitted (breaking)

[2.24.12] - 2026-02-26

Changed

  • Refactored transaction execute to properly initialize account state from StateInit before execution

Fixed

  • Fix token transfers between and within dapp_id

[2.24.11] - 2026-02-17

Fixed

  • Hash used for calculating BOC depth when applying BOC size limits

[2.24.10] - 2026-02-16

New

  • Add general purpose Poseidon TVM instruction based on Axiom.

[2.24.9] - 2026-01-21

New

  • tvm_client now can be compiled without a wasmtime runtime (e.g. for the browser environment) with a new feature wasm_web

[2.24.8] - 2025-12-10

Added/Changed

  • Add and modify reward instruction for mvrewards and mining

Fixed

  • Fix deploy between dapp_id

[2.24.7] - 2025-12-10

New

  • Client will choose https protocol for BK rest API if client's config endpoint uses https

[2.24.6] - 2025-12-10

Fixed

  • Add support of Gosh provider into TLS wasm binary and update related tests

[2.24.5] - 2025-11-03

Fixed

  • Fix mvreward
  • Set big minstake

[2.24.4] - 2025-10-30

Fixed

  • Facebook tls wasm test

[2.24.3] - 2025-10-23

New

  • Add get_proof and get_nonce functions

[2.24.2] - 2025-10-17

Changed/Fixed

  • Block seq no to repair accounts moved from SDK
  • Added engine version to execute params

[2.24.1] - 2025-10-15

Changed/Fixed

  • MobileVerifiers rewards fixes

[2.24.0] - 2025-10-15

Added

  • In the tvm_client::send_message()/tvm-cli call(x) execution error result, the recipient account address has been added. This is particularly useful in cases where errors occur during contract deployment
  • tvm-cli account|run|runx calls now return state_timestamp — the timestamp of the state from which the account’s BOC was loaded
  • A state_timestamp field has also been added to ResultOfGetAccount

Changed/Fixed

  • Rename tvm-cli config files:

    • tonos-cli.conf.json to tvm-cli.conf.json
    • tonos-cli.global.conf.json to tvm-cli.global.conf.json

    On first run after upgrade, if the new files don’t exist but the deprecated ones do, they are automatically renamed

  • Decoding of return_value returned in tvm-cli call(x) invocations

[2.23.6] - 2025-10-13

Fixed

  • Fixed tvm-debugger crashes when executing solidity functions that accept and return.

[2.23.5] - 2025-10-08

  • Replace bloom with fastbloom

[2.23.3] - 2025-10-04

  • Tests fixed

[2.23.2] - 2025-09-30

  • Leaf cert subject check and some error codes in certs checking added

[2.23.1] - 2025-09-30

Fixed

  • Fixed VM deadlines setup

[2.23.0] - 2025-09-27

Changed/Fixed

  • Removed full shard state balance from ValueFlow
  • Changed ShardAccountsMap from HashmapAugE to HashmapE

[2.22.5] - 2025-09-25

Changed/Fixed

  • Fixed hardcoded root certificates and sha384 issue in TLS wasm binary.

[2.22.4] - 2025-09-19

Changed/Fixed

  • Changed how the depth and bits are counted in BOC to account for deduplication (duplicate cells are not counted as they do not grow the account state). This updated counter is used to limit the max BOC size to avoid edge-case issues with node state updates.
  • Wasmtime upgrade to 36.0.2
  • Fixed some wasm tests

Added

  • External function for loading a wasm hash whitelist file from disk. Intended for use as a node config.

[2.22.3] - 2025-09-23

Fix

  • Fix mv reward instructions

[2.22.2] - 2025-09-22

Update

  • Change reward instructions
  • Change Constructor FunctionId to 1

[2.22.1] - 2025-09-19

Fixed

  • Fix bug with extract expires

[2.22.0] - 2025-09-18

Added

  • New type OptionalAccount that can either contain account data or be account redirect
  • ShardAccount now contain OptionalAccount
  • New int message header field: dest_dapp_id
  • Added filed dapp_id_changed to AccountBlock struct
  • FWD fees increased *2 for messages without dest_dapp_id

[2.21.2] - 2025-08-27

Added

  • Ability to write BOC into generic Write destination

[2.21.1] - 2025-08-20

Changed/Fixed

  • Now function tvm_client::account returns account boc and dapp_id

[2.21.0] - 2025-08-20

Fixed

  • Fix mintshell action
  • Add gas prices for Vergrth16 and Poseidon instructions
  • Add wasm binary to checl TLS data for multifactor

[2.20.5] - 2025-08-20

New

  • Error codes for different wasm-related errors for better on-chain debugging
  • Various tests related to wasm clocks
  • Wasi random functions now use block timestamps as seed.

[2.20.4] - 2025-08-14

Fixed

  • Cell optimizations
  • UsageTree refactoring + optimizations

[2.20.3] - 2025-08-14

New

  • Wasm plugs for wasi-io, wasi-clocks, wasi-random, providing access to some tvm blockchain info.
  • Matching tests and examples

Fixed

  • Major refactor of wasm-related code

[2.20.2] - 2025-08-11

Fixed

  • Usage tree seg fault and added usage tree/set stoping tracking on tree drop

[2.20.1] - 2025-08-06

Update

  • Passing wasm binaries as arguments to runwasm and runwasmconcatmultiarg now behind a feature flag. With default flags, those binaries will be ignored.

[2.20.0] - 2025-08-05

New

  • Add getavailablecredit sendtodappconfig mintshellq instructions
  • Change mintshell instruction.
  • Refactor fee in executor

Update

  • Update CALCBMREWARDADJ. Rename into CALCBMMVREWARDADJ

[2.19.1] - 2025-07-30

Fixes

  • Fixed runwasm and runwasmconcatmultiarg to support wasm components dependent on, when no real io access is needed:
import wasi:io/streams@0.2.3;
import wasi:io/error@0.2.3;
import wasi:cli/stdin@0.2.3;
import wasi:cli/stdout@0.2.3;
import wasi:cli/stderr@0.2.3;
import wasi:filesystem/types@0.2.3;
import wasi:filesystem/preopens@0.2.3;
  • Local wasm execution by hash now enforces sha256sum checking of the local wasm binary against a whitelist.

Changed

Determinism:

  • added support for relaxed SIMD proposal with deterministic behaviour
  • added memory limiter support for dynamic table and linear memory allocation
  • enable other determinism settings via cranelift

New

  • Wasm Component Precompilation: Wasm Enginge gets preinitialised and Components get pre-compiled and passed into the Executor via the Executor Engine. There is support for initialising via the Executor Engine or passing pre-initialised from an external context.

[2.19.0] - 2025-07-30

Breaking changes

  • ExtMessage structure changed: bm_license, bm_token fields removed, ext_message_token field added
  • network.endpoints initialization changed:
    • If port is specified in the endpoint URL then use this port for sending messages and getting account
    • If port is not specified in the endoint URL then use 8600 for sending and getting account
    • For graphql - always use http(s)://hostname/graphql url
    • Use the specified schema (protocol) (https/http)

[2.18.4] - 2025-07-18

Fixes

  • Fixed an error decoding account data: Invalid BOC: error decode contract data BOC base64

[2.18.3] - 2025-07-08

Changed

  • Changed api.json file. Added properties related to module account.

[2.18.2] - 2025-07-04

Fixes

  • Fixed runwasm and runwasmconcatmultiarg causing panic on using invalid hash.

[2.18.1] - 2025-06-28

New

  • Added runwasmconcatmultiarg instruction that allows multiple arguments to be concatenated then passed to runwasm

[2.18.0] - 2025-06-27

New

  • account module with get_account function that requests account boc from BM or BK node
  • api-token added to config.network

[2.17.3] - 2025-06-25

Fixes:

  • Changed runwasm gas usage to match other instruction prices

[2.17.2] - 2025-06-19

New

  • Changed runwasm instruction to accept local wasm binaries, selected by hash.

[2.17.1] - 2025-06-16

New

  • Added fixed gas metering and wasm fuel limiting to runwasm instruction

[2.17.0] - 2025-06-12

New

[2.16.3] - 2025-06-09

New

  • Add the ability to fill in the source address for external messages if it is provided by the Block Manager (required for Block Keepers with authentication enabled)

[2.16.2] - 2025-06-05

New

  • Optimized build for new versions of Rust

[2.16.1] - 2025-05-28

New

  • Add BURNECC instructions.

[2.16.0] - 2025-05-28

New

  • Add support of authorization on Block Producers

Fixed

  • Fixed redirection while sending external messages

[2.15.0] - 2025-05-12

New

  • Add CALCBMREWARD, CALCBMREWARDADJ, CALCMINSTAKEBM instructions.

[2.14.0] - 2025-05-12

New

  • gosh feature made default

[2.13.0] - 2025-05-01

Improvement

  • While sending external messages, using the port provided in the redirection response

[2.12.0] - 2025-04-30

Improvement

  • Message is sent to the bk/v2/messages or bm/v2/messages endpoints

[2.11.0] - 2025-04-22

New

  • BOC v3 stores all hashes and cell stats (tree cell count, tree bits count). It increases BOC size but speeds up deserialization time. It stores cell offsets instead of cell indexes, to avoid extra indirection level when resolving cell address inside boc. It also introduces new internal cell variant Boc3Cell that holds ref to entire boc and offset of raw cell data. So whe using boc3 and new cell variant, it is possible to avoid boc deserialization into cell tree structure.
  • Cell now declared as ан enum instead of Arc.
  • BocReader parameter force_cell_finalization - forces cell verification and hash rebuilding when reading cell(s) from BOC. It is by default. Turning this parameter off will speed up deserialization time in case when BOC contains stored hashes.

[2.10.0] - 2025-03-28

New

  • return_value is added to the ResultOfSendMessage - returns the executed contract's return value

[2.9.2] - 2025-03-18

Fixed

  • Restored the utility for generating api.json.
  • Changed the type of the thread_id field in the ParamsOfSendMessage structure.

[2.9.0] – 2025-03-11

New

  • Message delivery to the target thread has been made more reliable.

Fixed

  • Issue with tvm_api formatting

Breaking changes

Error.data.tvm_exit_code renamed to Error.data.exit_code

[2.8.0] – 2025-02-28

New

  • tvm-debugger commands: boc-encode Encodes given parameters in JSON into a BOC boc-decode Decodes BOC into JSON as a set of provided parameters boc-hash Read BOC string from stdin and print its hash state-encode Encodes initial contract state from code, data, libraries ans special options state-decode Decodes initial contract state into code, data, libraries ans special options account-encode Creates account state BOC

Breaking changes

  • tvm-debugger:
    • existing functionality was moved under command run

[2.7.1] – 2025-02-28

New

  • In case of "THREAD_MISMATCH" error message will be re-sent to the right thread.

Fixed

  • In case of "WRONG_PRODUCER" error message was not re-sent to the right producer correctly.

Improvements

  • Removed some unused dependencies

[2.7.0] – 2025-02-27

New

  • tvm_vm: execution time control parameters termination_deadline and execution_timeout. See details

[2.6.1] – 2025-02-26

Fixed

  • Fix bugs in VERGRTH16 and POSEIDON instructions.

[2.6.0] – 2025-02-19

New

dapp_id is moved form Account structure to the wrapping structure ShardAccount

[2.5.0] – 2025-02-19

New

  • Add instructions CALCBKREWARDADJ, CALCREPCOEF functions
  • Add free fee with same ThreadId

Fixed

  • Fix CNVRTSHELLQ, CALCBKREWARD, CALCMINSTAKE instructions.

[2.4.0] – 2025-02-06

New

  • processing.send_message works with bm/v2/messages endpoint and synchronously returns execution result from the node

[2.3.3] – 2024-12-18

New

  • Delete some flags from RawReserve instruction

[2.3.2] – 2024-12-18

Fixed

  • Fix src dapp id for out messages

[2.3.1] – 2024-12-16

Fixed

  • Rawreserve didn't include credit money.
  • Transfer all balance sent credit money and transaction failed.
  • Abort ext_message didn't restore balances

[2.3.0] – 2024-10-21

New

  • Add support of VERGRTH16 and POSEIDON instructions for zk-login.

[2.2.12] – 2024-10-08

Fixed

  • Increase message credit.

[2.2.11] – 2024-10-08

Fixed

  • Update Dapp_id field in AccountStuff into Option.

[2.2.10] – 2024-10-08

Fixed

  • Work with CurrencyCollections. Fixed add and sub.

[2.2.9] – 2024-10-08

Fixed

  • Fix SEND_ALL_BALANCE_FLAG

[2.2.8] – 2024-10-02

Improved

Improve RawReserve instruction

[2.2.7] – 2024-09-20

Fixed

  • Fix with read_from_cell in VarIntegerN.

[2.2.6] – 2024-09-20

Fixed

  • Update MINTECC, EXCHANGE, CALCBKREWARD instruction.
  • Fix check_overflow in grams.

New

  • Add MINTSHELL intruction and credit program.

[2.2.5] – 2024-09-12

Fixed

  • Set dapp_id in executor to have it the same for inbound and outbound messages.

[2.2.4] – 2024-09-11

Fixed

  • dapp_id was not set for the accounts which state changed from nonExist to Active

[2.2.3] – 2024-09-11

New

  • Add tvm-client function set_code_salt_cell to set code salt with both objects passed by cells (not shared in json-api).

[2.2.2] – 2024-09-10

New

  • New instruction - CALCMINSTAKEREWARD.
  • Change CNVRTSHELLQ instruction.

[2.2.1] – 2024-08-27

New

  • New field in internal message - src_dapp_id.

[2.2.0] – 2024-08-23

New

  • New field in account - dapp_id.

[2.1.1] – 2024-08-19

Improved

Validator reward formula updated.

[2.1.0] – 2024-08-15

New

  • New VM instructions supported: MINTECC - mint ecc tokens for special contracts CNVRTSHELLQ - convert ecc shell tokens into shell 1:1 CALCBKREWARD - calculate reward for validators after validator epoch

[2.0.3] – 2024-08-15

New

tvm_debugger crate added

[2.0.2] – 2024-07-25

Fixed

AccountActive Stack Overflow issue fixed

account state: AccountActive
Stack Overflow:
   0: backtrace_on_stack_overflow::handle_sigsegv
   1: <unknown>
   2: <tvm_types::cell::DataCell as tvm_types::cell::CellImpl>::reference...

[2.0.1] – 2024-07-16

Fixed

Resolved stack overflow issue: returning an error instead of using anyhow.

[2.0.0] – 2024-07-10

First release of SDK supporting Acki Nacki protocol.

[1.45.1] – 2023-12-19

Fixed

  • Updated dependences

[1.45.0] – 2023-11-10

New

  • ABI 2.4 supported.

Breaking

  • For contracts with ABI version => 2.4 initial public key should be explicitly supplied inside initial_data in abi module functions. Signer public key and initial_pubkey parameter are not used in contract initial data encoding since ABI version 2.4.

  • abi.decode_initial_data and abi.update_initial_data functions don't support ABI version => 2.4. abi.decode_account_data and abi.encode_initial_data should be used instead

  • Only workchain_id parameter is allowed if state_init parameter of DeploySet is provided. State init should be finalized and ready to be used in message as is.

  • abi.encode_account parameter state_init is BOC or cached BOC reference instead of StateInitSource enum. There is only one way to provide account state init now.

[1.44.4] – 2023-11-07

New

  • Account BOC for local error resolving is fetched from blockchain API instead of collections API

[1.44.3] – 2023-09-05

New

  • Error appeared during network paramaters resolving is returned to client instead of using default parameters

[1.44.2] – 2023-08-22

New

  • Pruned account serialization supported

[1.44.1] – 2023-07-25

New

  • functions with callbacks (e.g. processing.process_messages) can be called as sync.
  • send_event parameter is now optional with default value false.

Deprecated

[1.44.0] – 2023-07-12

New

  • Ability to call async functions via tc_request_sync.
  • In rust API, the following functions become sync (slight breaking): abi::encode_internal_message, abi::attach_signature_to_message_body, abi::attach_signature, abi::decode_message, abi::decode_message_body, abi::decode_account_data, abi::update_initial_data, abi::encode_initial_data, abi::decode_initial_data, abi::decode_boc, abi::encode_boc, boc::decode_tvc, boc::parse_message, boc::parse_transaction, boc::parse_account, boc::parse_block, boc::parse_shardstate, boc::get_blockchain_config, boc::get_boc_hash, boc::get_code_from_tvc, boc::cache_get, boc::cache_set, boc::cache_unpin, boc::encode_boc, boc::get_code_salt, boc::set_code_salt, boc::decode_state_init, boc::encode_state_init, boc::encode_external_in_message, boc::get_compiler_version, processing::monitor_messages, processing::get_monitor_info, processing::cancel_monitor
  • Code generator for modules.ts produces _sync wrapper for all API functions.

[1.43.3] – 2023-06-24

Fixed

  • Memory leak in a spawned loop of the web socket link.

[1.43.2] – 2023-06-09

Fixed

  • Non existing accounts are treated as missing since q-server return non existed if account is missing
  • Next block awaiting timeout calculation on message with long expiration time

[1.43.1] – 2023-06-01

Fixed

  • MonitoredMessage API representation simplified.

[1.43.0] – 2023-05-23

New

  • network.network_retries_count config parameter is finally deprecated and not used in SDK. max_reconnect_timeout is used instead
  • Message monitoring errors received by subscription are returned from processing.fetch_next_monitor_results function
  • Message monitor buffers new messages for delayed start of the subscription. New subscription starts when 1 second has passed since the last addition or when 5 seconds has passed since last sending
  • Message monitor uses more than one subscription.
  • Version of ton_types upped to 2.0.0
  • Fixed code for changed dependencies api
  • Removed logic related to client-server clock sync
  • boc.encode_tvc and boc.decode_tvc are renamed to boc.encode_state_init and boc.decode_state_init.
  • boc.decode_tvc decodes TVC BOC according to the TVC spec.
  • DeploySet.tvc supports new TVC file format (according to new TVC spec). Old tvc files (with serialized state init) are also supported.
  • DeploySet.state_init allows to specify serialized state init.
  • DeploySet.code allows to construct state init from provided serialized code.
  • DeploySet's fields tvc, state_init and code are mutually exclusive (so you should provide value for one of these fields).
  • ProcessingEvent::MessageExpired is sent to callback in case of retry in processing.process_message

Client breaking changes

  • boc.encode_tvc and boc.decode_tvc are renamed to boc.encode_state_init and boc.decode_state_init

[1.42.1] – 2023-03-23

Fixed

  • Client was notified about every REMP status timeout. Now it is notified only once when fallback scenario is started

[1.42.0] – 2023-03-22

New

  • Added message monitoring functions to the processing module: monitor_messages, fetch_next_monitor_results, get_monitor_info, cancel_monitor****.
  • Added processing.send_messages function.
  • Improved error resolving for deleted accounts
  • net.first_remp_status_timeout config parameter default value set to 1 ms in order to start fallback scenario together with REMP statuses processing while REMP is not properly tuned yet.
  • Network errors are returned on subscription creation if occured

Fixed

  • ParamsOfSubscribe was not public.
  • subscribe did not trim subscription query text. It is required for some graphql servers expecting that query text starts from operation text.

[1.41.1] – 2023-03-14

Fixed

  • api_derive compilation errors

[1.41.0] – 2023-01-18

New

  • CapSignatureWithId capability is supported.

    Network signature ID is used by VM in signature verifying instructions if capability CapSignatureWithId is enabled in blockchain configuration parameters.

    This parameter should be set to global_id field from any blockchain block if network can not be reached at the moment of message encoding and the message is aimed to be sent into network with CapSignatureWithId enabled. Otherwise signature ID is detected automatically inside message encoding functions. Overwrite priority: ExecutionOptions.signature_id -> ClientConfig.network.signature_id -> last network block

    • ClientConfig.network.signature_id optional parameter is added. Specify it in case of offline work for all message signing operations to use.
    • ExecutionOptions is extended with signature_id optional parameter. Specify locally for a particular run_tvm or run_executor call.
    • net.get_signature_id function returns global_id if CapSignatureWithId capability is enabled,

  • message_id and message_dst fields are added to all ProcessingEvent variants

  • Config parameter binding: { library: string, version: string }. Binding authors should define this parameter at context initialization.

  • tonclient-binding-library and tonclient-binding-version GraphQL request headers. Read more here

  • Error.data.binding_library and Error.data.binding_version error data fields. Read more here

Client breaking changes

  • abi.get_signature_data function ouput parameter hash is renamed to unsigned for consistency with other crypto functions parameters

Possible breaking change on binding side

  • Changed type of the dictionary parameter or mnemonic crypto functions and crypto config. Now it uses MnemonicDictionary enum type instead of number. MnemonicDictionary numeric constants are compatible with previous values.

Deprecated

  • debot engine module is deprecated. Debot engine development has migrated to a separate repository (soon will be published). So, in order to reduce sdk binary size, we will remove debot engine module from sdk in the next releases.

[1.40.0] – 2023-01-11

New

  • abi.get_signature_data function that returns signature from message and hash to verify the signature

Improvement

  • local endpoints with port specified are expanded with http protocol instead of https (e.g. localhost:8033 in expanded to http://localhost:8033/graphql)

[1.39.0] – 2022-12-07

Improvement

  • Resolved endpoints are cached for 10 minutes so subsequent messages sent will not require additional server request

  • Queries are retried in case of network errors when websocket connection is used

  • WaitForTimeout error code (607) is returned in case of wait_for_transaction function was successfully executed but expected data did not appeared during the specified timeout

  • timeout parameter in net.query_transaction_tree behaviour changed. Now value 0 indicates that no time limit should be used and function will wait for all transactions execution

New

  • transaction_max_count parameter in net.query_transaction_tree which controls the count of transaction to be awaited and returned

  • data_layout and function_name parameters in abi.decode_message and abi.decode_message_body that can be used to decode responsible function output and optimize message decoding by strict layout check

Fixed

  • abi.encode_initial_data function properly creates data in case of public key omitted. Now abi.encode_initial_data call without initial data values and public key creates the same data as compiled tvc

  • Graphql error messages with HTTP response 400 was skipped (was not propagated to the SDK client application).

  • Several misspelling.

  • Message processing freeze in case of large amount of messages parallel processing using Websocket connection

  • Websocket interaction thread panic

  • Debot module:

    • fill hash argument in SDK.signHash method with leading zeroes up to 32 bytes.

[1.38.1] – 2022-11-10

Improvement

  • Additional info query is removed from send_message to minimize API usage

Fixed

  • Error code Unauthorized is returned from all network functions in case of authentication failure
  • Server connection attempt is not retried in case of authentication failure

New

[1.38.0] – 2022-10-06

New

  • Debot module:
    • ABI specification v2.3 is supported in DEngine.
    • Supported flags OVERRIDE_TS, OVERRIDE_EXPT, ASYNC_CALL for external messages in DEngine.

Improvement

  • Support cookies in net module for std mode (not wasm)
  • Remove network aliases (main, dev, main.ton.dev, net.ton.dev)
  • No balancing logic in case of 1 endpoint + removed the check of REMP support on backend during client initialization. These changes will make client initialization faster -> CLI tools that use SDK will work faster, web pages will load initial data faster.
  • Changed 401 error message to response message from API
  • Tests improvements: cryptobox tests made stable

[1.37.2] – 2022-08-10

New

  • crypto.encryption_box_get_info returns nacl box public key in info.public field.
  • Gosh instruction are supported in local VM and executor:
    • execute_diff
    • execute_diff_patch_not_quiet
    • execute_zip
    • execute_unzip
    • execute_diff_zip
    • execute_diff_patch_zip_not_quiet
    • execute_diff_patch_quiet
    • execute_diff_patch_zip_quiet
    • execute_diff_patch_binary_not_quiet
    • execute_diff_patch_binary_zip_not_quiet
    • execute_diff_patch_binary_quiet
    • execute_diff_patch_binary_zip_quiet

Improvement

  • create_crypto_box optimisation. When a user creates a crypto box, library encrypts provided secret information using provided password and salt. When library encrypts the secret, it calculates encryption key from password and salt using scrypt function which takes a lot of CPU time (about 1 second). So when a user creates many crypto boxes using the same password and salt, it takes a lot of time (about 12 seconds for 10 crypto boxes). With the optimisations introduced in this version the library stores the pair (password+salt => encryption key) in internal cache for approximately 2 seconds. So when a user creates many crypto boxes at a time using the same password and salt, library uses cached information to skip heavy calculations. As a result now it takes only a second to create 10 crypto boxes.

Fixed

  • Some enum types were not properly presented in api.json (some types that use serde(content=" value"))

[1.37.1] – 2022-08-03

Fixed

  • Pinned BOC cache now has reference counter for each pin in BOC. BOC can be pinned several times with the same pin. BOC is removed from cache after all references for all pins are unpinned with cache_unpin function calls.
  • Fixed error resolving in case when account state was modified after message expiration time. Now appropriate error text is added to error message instead of executor internal error

[1.37.0] – 2022-07-28

New

  • client sends config.network.access_key as Authorization: Basic ... or Authorization: Bearer ... header depending on the value passed: if value is in hex, then it is processed as project secret (basic), if in base64 - then as JWT token (bearer).
  • client accepts endpoints with /graphql suffixes specified in config.

Fixed

  • Updated zstd in order to fix building.

[1.36.1] – 2022-07-18

Improvement

  • Time synchronization check between device and server improved: calculation of time-diff with server is moved from batched query to send_message function and therefore now query execution time does not affect this time diff.

[1.36.0] – 2022-07-01

New

  • ABI specification v2.3 is supported
  • parameter address is added to abi.encode_message_body function

[1.35.1] – 2022-06-28

Improved

  • abi module errors have been improved

[1.35.0] – 2022-06-28

New

  • chksig_always_succeed execution option used in params of the tvm.run_get, tvm.run_tvm and tvm.run_executor.
  • abi.calc_function_id function
  • tokio library is updated to 1.* version

[1.34.3] – 2022-06-08

New

  • send accessKey header in api requests (specified in config.network.accessKey)

Fixed

  • send headers in info api requests

[1.34.2] – 2022-05-30

Fixed

  • build process

[1.34.1] – 2022-05-26

New

  • supported removing Copy interface from UInt256
  • supported changed interface of ton_types::Cell

[1.34.0] – 2022-05-18

New

  • client.config function that returns the current client config

  • run_executor().fees is extended with these fields:

    • ext_in_msg_fee - fee for processing external inbound message
    • total_fwd_fees - total fees of action phase
    • account_fees - total fees the account pays for the transaction

  • main and dev endpoints aliases for Evernode Cloud Mainnet and Devnet endpoints

Improved

  • Added documentation for TransactionFees type (run_executor().fees).
  • Documentation now includes enum types descriptions. To achieve it we updated binding-gen: enum of types now produces its own type for each enum variant.

[1.33.1] – 2022-05-10

Fixed

  • Websocket errors weren't treated as a network errors. This is why all the processing functions that worked via wss protocol failed on these errors without retries. Now retries are performed.
  • SDK tried to rebalance even if only a single endpoint was specified. Now in case of a single endpoint, no rebalancing occurs.

[1.33.0] – 2022-05-02

New

  • allow_partial flag in all abi.decode_* functions. This flag controls decoder behaviour whether return error or not in case of incomplete BOC decoding
  • REMP supported. ProcessingEvent enum is extended with REMP statuses (enum of events posted into processing.wait_for_transaction function callback )
  • UNSTABLE. first_remp_status_timeout and next_remp_status_timeout parameters in network config

[1.32.0] – 2022-03-22

New

  • network.queries_protocol config parameter allows selecting protocol the SDK uses to communicate with GraphQL endpoint:
    • HTTP – SDK performs single HTTP-request for each request.
    • WS – SDK uses single WebSocket connection to send all requests. This protocol is a preferable way when the application sends many GraphQL requests in parallel.

Fixed

  • Debot module:
    • If DEngine received a non-zero exit_code while emulating a transaction while sending a message, DEngine will call onErrorId callback of the message.

[1.31.0] – 2022-03-09

New

crypto module:

  • Cryptobox introduced: root crypto object that stores encrypted secret and acts as a factory for all crypto primitives used in SDK. Crypto box provides signing and encryption boxes.

    Functions: create_crypto_box - initializes cryptobox with secret remove_crypto_box - removes cryptobox and overwrites all secrets with zeroes get_crypto_box_seed_phrase

  • Support of initCodeHash in tvm: X-Evernode-Expected-Account-Boc-Version=2 http header added to graphql requests. value=2 means that SDK requests the latest account boc version with initCodeHash support from API. This was done because new boc version is not compatible with old transaction executor, i.e. with previous SDK versions. New transaction executor is compatible with new and old boc formats. New SDK asks for new boc format if it exists,if it does not - old boc version is returned. Previous version of SDK will fetch only old version without initCodeHash support.

Attention! Migrate your applications to the new SDK version ASAP because in some period of time we will stop supporting old boc version in API and default value of X-Evernode-Expected-Account-Boc-Version on backend side will become 2, missing value will cause an error. Now default value on API side is Null which means that API returns the old version. This is done to avoid breaking changes in existing applications and give time to migrate to the new SDK.

Fixed

  • Documentation generator for app object interface fills documentation from ParamsOfXXXAppObject enum.
  • Documentation generator for function with obj parameter add this parameter into parameters section with link to appropriate AppObject interface.

[1.30.0] – 2022-02-04

New

  • Added boc.encode_external_in_message function to encode message BOC based on a low level message parts such as a body, state init etc.
  • Added net.subscribe function to start a low level GraphQL subscription.
  • Added support for new MYCODE TVM command in tvm.run_tvm and tvm.run_get functions.

[1.29.0] – 2022-02-03

New

  • Added abi.encode_boc function to encode parameters with values to BOC, using ABI types.
  • Added support of address type in boc.encode_boc.
  • All fetch requests are now called with timeouts to prevent freezing in case of infinite answer.
  • Support of MYCODE instruction in TVM

[1.28.1] – 2022-01-25

Fixed

  • Support breaking changes in ton-labs-block-json v0.7.1
  • Updated endpoints for main.ton.dev alias.

[1.28.0] – 2021-12-24

New

  • DevNet endpoints now changed to EVER OS domain: eri01.net.everos.dev, rbx01.net.everos.dev, gra01.net.everos.dev
  • Debot module:
    • Added float numbers support for Json interface
  • Added guide for custom giver usage.

Fixed

  • Debot module: fixed a bug in Query.query function called with an empty variables field.

[1.27.1] – 2021-12-09

Fixed

  • Empty function_name field in the "create run message failed" error.

[1.27.0] – 2021-12-06

New

Function abi.encode_initial_data which encodes initial account data with initial values for the contract's static variables and owner's public key. This function is analogue of tvm.buildDataInit function in Solidity.

Fixed

  • Subscription for Counterparties failed with 'Unknown type "CounterpartieFilter"' error.

[1.26.1] – 2021-12-01

Fixed

  • Fixed building and warning.

[1.26.0] – 2021-11-25

New

  • Debot module:
    • Added allow_no_signature parameter to decode_and_fix_ext_msg() and onerror_id return value to prepare_ext_in_message() inner functions used in TS4.
    • Added support for async external calls.
    • Query interface extended with waitForCollection and query methods. waitForCollection allows to wait for completion of async external calls.
    • Added support for DeBots with ABI 2.2.

Function proofs.proof_message_data which proves message data, retrieved from Graphql API.

[1.25.0] – 2021-11-08

New

  • New module proofs is introduced!

  • Functions proofs.proof_block_data and proofs.proof_transaction_data which prove block data, retrieved from Graphql API.

    These are the first functions from proofs series :) Wait for others(proof_account_data , proof_message_data) in the next releases.

    Read about them more in the documentation.

  • abi.decode_boc function to decode custom BOC data into JSON parameters.

  • Ref(<ParamType>) type was added to ABI. Solidity functions use ABI types for builder encoding. The simplest way to decode such a BOC is to use ABI decoding. ABI has it own rules for fields layout in cells so manually encoded BOC can not be described in terms of ABI rules. To solve this problem we introduce a new ABI type Ref(<ParamType>) which allows to store ParamType ABI parameter in cell reference and, thus, decode manually encoded BOCs. This type is available only in decode_boc function and will not be available in ABI messages encoding until it is included into some ABI revision.

[1.24.0] – 2021-10-18

New

  • boc.get_boc_depth function to get depth of the provided boc.

  • boc.decode_tvc function returns additional fields code_hash, code_depth, data_hash , data_depth and compiler_version

  • Debot module:

    • added parse function to Json interface.

[1.23.0] – 2021-10-05

New

  • boc.get_code_salt and boc.set_code_salt functions for contract code salt management.
  • boc.encode_tvc and boc.decode_tvc functions for TVC image encoding and decoding
  • boc.get_compiler_version function extracting compiler version from contract code
  • abi.update_initial_data and abi.decode_initial_data function for pre-deployment contract data management

[1.22.0] – 2021-09-20

New

  • ABI v2.2 with fixed message body layout supported. See the specification .

    Now, for contracts with ABI version < 2.2 compact layout will still be used for compatibility, for contracts with ABI version 2.2 and more - fixed layout will be used. Please, make sure that you updated the ABI if you recompiled your contract with 2.2 ABI, or you may get an inconsistent contract behaviour.

  • Debot module:

    • added getEncryptionBoxInfo, getSigningBoxInfo functions to Sdk interface.
    • implemented Query DeBot interface in DEngine.

[1.21.5] – 2021-09-13

Fixed

  • abi.encode_message and processing.process_message created invalid deploy message in case of Signer::None was used, and contract could not be deployed.

[1.21.4] – 2021-09-08

New

  • Support MacOS aarch64 target

[1.21.3] – 2021-09-02

New

  • Information about used endpoint is added to subscription errors.
  • Graphql response error codes 500-599 are treated as retriable network errors

[1.21.2] – 2021-08-25

Fixed

  • Updated crypto libraries in order to fix building.

[1.21.1] – 2021-08-24

Fixed

  • http errors were not processed as network errors and didn't lead to endpoint reconnect and request retry

[1.21.0] – 2021-08-18

New

  • crypto.create_encryption_box function for creating SDK-defined encryption boxes. First supported algorithm - AES with CBC mode.
  • Debot module:
    • Added public prepare_ext_in_message function.

Fixed

  • tvm.run_executor did not work when SDK is configured to use TONOS SE, because of incomplete default blockchain configuration. Now mainnet config from key block 10660619 (last key block at the moment of fix) is used as default.

[1.20.1] – 2021-07-30

New

  • Added support of contract error messages. Error messages (for example, require(...) in Solidity) are now parsed by SDK and returned in error message. New field contract_error was added to error's data.

Fixed

[1.20.0] – 2021-07-16

New

  • ABI version 2.1 supported. Attention! If you work with contracts, that contain String parameters, then during migration from ABI 2.0 to 2.1 you will need to remove all String type conversions to bytes and back and pass string to your contract as is.

  • Now all requests to GraphQL are limited with timeout to react on unexpected server unavailability. Existing timeouts in waiting functions keep the same behaviour. All other requests timeout now can be set with net.query_timeout config parameter. Its default value is 60000 ms

  • Debot module:

    • added encrypt, decrypt functions to Sdk interface which accept encryption box handles.

Fixed

  • Deployment with empty signer in cases of public key set in TVC or deploy set.

[1.19.0] – 2021-07-07

New

  • get_address_type function in utils module, which validates address and returns its type. See the documentation.
  • decode_account_data function in abi module that converts account data BOC into JSON representation according to ABI 2.1. See the documentation.
  • Diagnostic fields filter and timestamp added to wait_for_collection error
  • main.ton.dev and net.ton.dev endpoints that will be deprecated on 12.07.21 are now replaced with proper endpoints list, if they were specified in network endpoints config

Fixed

  • Search of the first master blocks during the network start period was fixed in blocks and transactions iterators

[1.18.0] – 2021-06-26

New

  • Iterators in net module: robust way to iterate blockchain items (blocks, transactions) in specified range. See documentation for create_block_iterator , create_transaction_iterator, resume_block_iterator, resume_transaction_iterator, iterator_next, iterator_remove functions.
  • Library adds http:// protocol to endpoints localhost, 127.0.0.1, 0.0.0.0 if protocol isn't specified in config.
  • Debot module:
    • added tests for Json interface.

[1.17.0] – 2021-06-21

New

  • Added support of external encryption boxes. See the documentation
  • Debot module:
    • Dengine waits for completion of all transactions in a chain initiated by debot's onchain call.

[1.16.1] – 2021-06-16

New

  • timeout option to query_transaction_tree – timeout used to limit waiting time for the next message and transaction in the transaction tree.

Improved

  • Improved error messages regarding ABI and JSON interface. SDK now shows additional tips for the user in cases of errors.

Fixed

  • Warnings in Rust 1.52+. Little fixes in the documentation.
  • total_output field in fees was always 0.
  • query_transaction_tree didn't wait for messages.

[1.16.0] – 2021-05-25

New

  • query_transaction_tree function that returns messages and transactions tree produced by the specified message was added to net module. See the documentation

Fixed

  • AbiData.key type changed to u32.
  • attempt to use orderBy instead of order in query_collection will raise error.

[1.15.0] – 2021-05-18

New

  • Sync latency detection increases connection reliability. Library will change the current endpoint when it detects data sync latency on it.

  • Configuration parameters: latency_detection_interval, max_latency. See client documentation for details.

  • Debot module:

    • signing messages with signing box handles returned from debots.
    • return any sdk errors to debot in case of external calls.
    • defining signing box handle used to sign message in approve callback.

[1.14.1] – 2021-04-29

Fixed

  • Fixed building under Rust versions older than 1.51.

[1.14.0] – 2021-04-28

New

  • Debot module:
    • implementation of Network DeBot interface in DEngine.
    • implementation of signHash function in Sdk interface.

Fixed

  • Debot module:
    • fixed bug in Json interface with supporting nested structures and arrays of structures.
    • fixed bug in Json interface with keys containing hyphens.

[1.13.0] – 2021-04-23

New

  • net.query_counterparties - allows to query and paginate through the list of accounts that the specified account has interacted with, sorted by the time of the last internal message between accounts. Subscription to counterparties collection is available via net.subscribe_collection function.

  • Blockchain interaction reliability improvement (broadcast): library sends external inbound messages simultaneously to the N randomly chosen endpoints. If all N endpoints failed to response then library repeats sending to another random N endpoints (except the failed one). If all the available endpoints fail to respond then library throws error. The N parameter is taken from config.network.sending_endpoint_count (default is 2).

  • Blockchain interaction reliability improvement (bad delivery list): library tracks endpoints with bad message delivery (expired messages). These endpoints have lower priority when library chooses endpoints to send message.

  • Debot module:

    • Implementation of Json DeBot interface in DEngine.

Fixed

  • BuilderOp::Integer.size type has changed from u8 to u32.
  • Debot Module:
    • Sdk interface function getAccountsDataByHash didn't find accounts by code_hash with leading zero.

[1.12.0] – 2021-04-01

New

  • utils.compress_zstd compresses data using Facebook's Zstandard algorithm.
  • utils.decompress_zstd decompresses data using Facebook's Zstandard algorithm.
  • Debot module:
    • init function that creates an instance of DeBot and returns DeBot metadata.
    • Dengine fetches metadata form DeBot by calling 2 mandatory functions: getRequiredInterfaces and getDebotInfo. This data is returned by fetch and init functions.
    • approve DeBot Browser callback which is called by DEngine to request permission for DeBot activities.

Changed

  • Debot Module:
    • [breaking] fetch function doesn't create an instance of debot. It returns DeBot metadata (DebotInfo).
    • [breaking] start function doesn't create an instance of debot. It accepts DeBot handle created in init function.

[1.11.2] – 2021-03-19

Refactor

  • Some internal refactor due to ton-block changes

[1.11.1] – 2021-03-15

New

  • Giver address in tests is calculated from secret key. Default values are provided for TON OS SE giver

[1.11.0] – 2021-03-05

New

  • utils.calc_storage_fee function to calculate account storage fee over a some time period.
  • Debot Module:
    • Added unstable functions to Sdk interface: getAccountsDataByHash

[1.10.0] – 2021-03-04

New

  • Add optional field src_address to ParamsOfEncodeInternalMessage.
  • Field abi in ParamsOfEncodeInternalMessage is optional and can be None if call_set and deploy_set are None.
  • boc.encode_boc function provides ability to build and serialize any custom tree of cells. Application can use several base Builder serialization primitives like integers, bitstrings and nested cells.
  • boc.get_blockchain_config function can extract blockchain configuration from key block and also from zerostate.
  • tvm module functions download current blockchain configuration if net is initialized with DApp Server endpoints. Otherwise, default configuration is used.
  • Debot Module:
    • Support for debot invoking in Debot Engine. send browser callback is used not only for interface calls but to invoke debots.
    • start and fetch functions returns debot ABI.
    • Added new built-in interface Hex which implements hexadecimal encoding and decoding.
    • Added unstable functions to Sdk interface: naclBox, naclBoxOpen, naclKeypairFromSecret, getAccountCodeHash.

Changed

  • Both call_set and deploy_set in ParamsOfEncodeInternalMessage can be omitted. In this case encode_internal_message generates internal message with empty body.
  • Debot Module:
    • send function accepts one argument - serialized internal message as string encoded into base64.

Documentation

Fixed

1.9.0 Feb 19, 2021

New

  • tuple_list_as_array parameter in tvm.run_get function which controls lists representation. Default is stack-like based on nested tuples. If set to true then returned lists are encoded as plain arrays. Use this option if you receive this error on Web: "Runtime error. Unreachable code should not be executed..." This reduces stack size requirements for long lists.
  • function_name field of CallSet structure can be the name or id (as string in hex starting with 0x) of the called function.
  • Fields config_servers, query_url, account_address, gas_used added into specific errors' ClientError.data object.

Fixed

  • Binaries download links are now under https protocol
  • If you receive this error on Web: "Runtime error. Unreachable code should not be executed..." in run_get, use the new parameter tuple_list_as_array = true . See the documentation. This may happen, for example, when elector contract contains too many participants

1.8.0 Feb 11, 2021

New

  • Debot Module:
    • Added new built-in interface Msg which allows to send external message to blockchain and sign it with supplied keypair.

Fixed

  • crypto.hdkey_public_from_xprv used compressed 33-byte form instead of normal 32-byte.

1.7.0 Feb 9, 2021

New

  • BOC cache management functions were introduced:
    • boc.cache_set,
    • boc.cache_get
    • boc.cache_unpin
  • Now functions that take boc as a parameter can also take a reference to boc cash instead so that it decreases the number of boc serialization and deserializations which drastically improves performance of run_tvm and run_executor especially in case of numerous calls on the same data.
  • boc_cache parameter in tvm.run_tvm and tvm.run_executor functions to save resulting messages and account BOCs into cache.
  • return_updated_account flag parameter introduced in tvm.run_tvm and tvm.run_executor functions to return updated account state. Important: by default this flag is false and account data is not returned.
  • abi.encode_internal_message function to encode an internal ABI-compatible message.
  • Debot Module:
    • Support for get-methods and external calls in debots. Debots can send external inbound messages to destination contracts (signed - for external calls and unsigned - for get-methods) using native language syntax without actions.
    • Built-in debot interfaces (interfaces implemented by DEngine). Added two built-in interfaces: base64 and Sdk.
    • Added DebotInterfaceExecutor to automatically route messages to destination interfaces.
    • Debot's fetch function is optional now. New debots can implement only start function.

1.6.3 Feb 4, 2021

Fixed

  • Expired message wasn't retried if local execution succeeded.

1.6.2 Feb 3, 2021

Added

  • ResponseHandler type description into modules.md.

Fixed

  • net.batch_query parameters serialization did't match to docs.
  • Module description in docs generator contains null instead of summary.
  • Function result section header hadn't the line separator before.

1.6.0 Jan 29, 2021

New

  • nacl_sign_detached_verify function to verify detached signature.
  • aggregate_collection function as a wrapper for GraphQL aggregation queries.
  • batch_query function performs multiple queries per single fetch.
  • Active endpoint invalidation in case of network error occurring.
  • network.network_retries_count config parameter is deprecated. network.max_reconnect_timeout is introduced that allows to specify maximum network resolving timeout. Default value is 2 min.
  • initial_pubkey field in DeploySet to specify public key instead of one from TVC file or provided by signer.
  • Support for debot interfaces:
    • send Browser Callback to send messages with interface calls to Browser.
    • new variant ParamsOfAppDebotBrowser::Send.
    • send API function to send messages from Browser to Debot.
    • run_output.rs - internal structure RunOutput to filter messages generated by debot to 4 categories: interface calls, external calls, get-method calls and invoke calls.

Fixed

  • Device time synchronization is checked only in send_message. Data querying does not require proper time now

1.5.2 Dec 30, 2020

Fixed

  • net module functions waits for net.resume call instead of returning error if called while the module is suspended

Documentation

1.5.1 Dec 28, 2020

Fixed

  • Updated the dependence on ton-labs-abi

1.5.0 Dec 25, 2020

New

  • reconnect_timeout parameter in NetworkConfig.
  • endpoints parameter in NetworkConfig. It contains the list of available server addresses to connect. SDK will use one them with the least connect time. server_address parameter is still supported but endpoints is prevailing.
  • net.fetch_endpoints function to receive available endpoints from server.
  • net.set_endpoints function to set endpoints list for using on next reconnect.
  • ErrorCode type in each module spec in api.json.

Fixed

  • send GQL_TERMINATE_CONNECTION and close websocket on leaving ws loop.

1.4.0 Dec 18, 2020

New

  • GraphQL optimization: use single web socket to serve all subscriptions.
  • Support for the keep-alive messages from the GraphQL server.
  • tonclient-core-version http header.
  • net.find_last_shard_block function returning account shard last block ID.
  • boc.get_code_from_tvc function extracting contract code from TVC image.
  • Debot Module:
    • Add new variant ParamsOfAppDebotBrowser::SwitchCompleted to notify browser when all context actions are shown.
    • Added new 3 engine routines for crypto operations and 1 routine for querying account state ( balance, state type, code, data) that can be used in debots.

Fixed

  • Debot Module:
    • Invoked debot terminated correctly after error occurred during execution of one of its actions. Initial prev_state of invoked debot changed to STATE_EXIT.
    • Fixed double jumping to current context in invoker debot after returning control to it from invoked debot.
    • Fixed conversation of exception codes thrown by debots to their user-friendly description.

1.3.0 Dec 8, 2020

Featured

  • net.query method . Performs custom graphql query that can be copied directly from the playground.
  • net.suspend and net.resume methods for disabling and enabling network activity. One of the possible use-cases is to manage subscriptions when a mobile application is brought to the background and into the foreground again.
  • Smart summary and description doc separation.
  • ts-generator includes doc comments in JSDoc format.

1.2.0 Nov 26, 2020

Featured

  • UNSTABLE API. This API is experimental. It can be changed in the next releases. debot module was added with debot engine functions, such as : start, fetch, execute , remove. See the debot module documentation for more info. Check our tests for code examples.

  • External signing was supported for message encoding: SigningBox type for Signer enum was supported. Now it is possible to sign messages with externally implemented signing box interface without private key disclosure to the library. Can be used in case of signing via HSM API or via cold wallet - when there is no access to the private key.

    It is also possible to create a Signing Box instance inside SDK - from a key pair passed into the library with get_signing_box method. It can be used for some test cases. Also it increases security - you need to pass your keys one time only.

    Check the crypto module documentation for SigningBoxHandle type and register_signing_box , get_signing_box, signing_box_get_public_key, signing_box_sign. Check our tests for code examples.

Fixed

  • panic after tc_destroy_context call. Now all contexts use global async runtime
  • field mnemonic_hdkey_compliant was removed from CryptoConfig (unused by the library)
  • original and resolved errors are swapped in result. Now error.code contains original error code

1.1.2 Nov 15, 2020

Fixed

  • wasm feature has been fixed
  • crypto.factorize doesn't panic on invalid challenge
  • client.get_api_reference returns proper version
  • ABI JSON with explicit function ID is parsed properly

1.1.1 Nov 11, 2020

Fixed

  • Compatible with older rust version change api type derivation with vec![] instead of prev [].into()

1.1.0 Nov 3, 2020

New

  • ChaCha20 encryption support crypto.chacha20.
  • boc.parse_shardstate function for shardstates parsing.
  • boc.get_boc_hash function for calculating BOC root hash
  • client.build_info fully defined and documented.
  • processing.wait_for_transaction and processing.process_message functions execute contract locally in case if transaction waiting fails in order to resolve the contract execution error
  • run_executor, run_tvm now return exit_arg in case of TVM errors.
  • Create the build_info.json on the build stage.
  • Abi::Contract variant as an alias to deprecated Abi::Serialized
  • Abi::Json variant to specify an ABI as a raw JSON string.
  • api.json now contains details about numeric types: Number and BigInt are now have new fields number_type and number_size.
  • api.json ref type names are fully qualified now in form of module.type, for example abi.Signer.

Fixed

  • TS generator fix some field names that is an invalid JS identifiers.
  • Use install_name_tool to fix loading library paths at libton_client.dylib.
  • api.json is reduced, so it can't contain tuple types, only structs. All types are exactly match to JSON.
  • out_of_sync_threshold config parameter is u32

Unstable

  • tc_request_ptr function to use pointers void* instead of request_id u32. This feature is UNSTABLE yet.

1.0.0 Oct 27, 2020

Differences between Core SDK v0 and v1

  • All api functions are defined in mod.rs of appropriate modules
  • Function names are the same as API function names: module.function_name
  • Parameters naming:
    • In snake case
    • Base64 suffix is removed from parameter names. For example, bocBase64 is changed to boc
  • Parsed boc replaced with unparsed boc in all function input parameters
  • All functions take byte arrays in a defined encoding:
    • base64 - encoding used for byte arrays of variable length: text, images, etc.
    • hex-lower-case - encoding used to encode fixed length bit sequences: hashes, keys, salt, etc.
  • contracts module is splitted into 5 modules:
    • tvm - embedded TVM execution functions
    • boc - raw cell and BOC manipulation functions
    • abi - abi-compatible messages creation and parsing functions
    • processing - blockchain interaction functions
    • utils - has only convert_address ATM, later will be used for some useful stuff
  • query module is renamed to net
  • new client module with functions version, api_reference
  • All the environment functions (fetch, websocket, spawn, now, etc.) were abstracted behind a separate environment layer crate ClientEnv. The standard core env layer implementation is in std_client_env . Later (in 1.1 release) web_client_env implementation for Web will be added.
  • Error codes are distributed across the modules the following way: client - 0..99, crypto - 100..199, boc - 200..299, abi - 300..399, tvm - 400..499, processing - 500..599, net - 600..699
  • Error descriptions related to a module are described in error.rs file in the module's folder
  • decode_message, process_message, wait_for_transaction, run_tvm, run_executor, etc. (all the functions that return decoded messages) now returns int*/uint* data as a string which can be either decimal or 0x-prefixed hex string. Hex representation can be in any register and have any number of leading zeroes.

Featured

  • All the functions are asynchronous

  • All the functions that can be called via JSON-api are public, so that they can be used directly without JSON-api.

  • Inline documentation and api reference added.

  • [breaking] interops.rs, tonclient.h. create_context now takes config parameter - context creation and setup happen at the same time. Config structure has been changed.

  • [breaking] crypto module. default values for mnemonic-related functions have been changed:

    dictionary is 1, for word count is 12, derivation path is 'm/44'/396'/0'/0/0

  • [breaking] crypto module. removed word_count parameter from words function

  • [breaking] crypto module. compliant parameter is removed from functions mnemonic_derive_sign_keys, hdkey_xprv_derive_path, hdkey_xprv_derive,

  • [new] boc module. Functions parse_block, parse_account, parse_message , parse_transaction that parse bocs to JSONs are introduced.

  • [breaking] net module. Functions query , wait.for, subscribe are renamed to query_collection, wait_for_collection, subscribe_collection

    table parameter is renamed to collection. filter parameter is now optional and of json type (passed as json object instead of string)

  • [breaking] net module. Function get.next is removed.

  • [breaking] net module.subscribe_collection now uses callback to return data.

  • [breaking] abi module. decode_message introduced instead of decode_unknown_run , decode_run_output

  • [breaking] abi module. encode_message introduced instead of encode_unsigned_deploy_message , encode_unsigned_run_message, run.encode_message, deploy.encode_message

  • [breaking] abi module. signer: Signer parameter used instead of key_pair: KeyPair , which can be of None (unsigned message will be produced), External (data to be signed +unsigned message), Keys (signed message will be produced), SigningBox (message will be signed using a provided interface - will be supported in coming releases)

  • [breaking] processing module. process_message introduced instead of deploy and run. Parameter set was drastically changed.

  • [breaking] processing module. process_message - now, if the contract was already deployed, deploy fails with an exception of double constructor call.

  • [new] processing module. process_message - any function can be called at deploy, not only constructor, also there can be no function call.

  • [new] processing module. process_message now can optionally use callback to monitor message processing (creation, sending, shard block fetching, transaction receiving).

  • [fixed] processing module. process_message - deploy can be performed without a key pair

  • [breaking] tvm module. run_local is divided into 2 functions run_tvm and run_executor.

  • [new] tvm module. run_tvm function - performs contract code execution on tvm (part of compute phase). Helps to run contract methods without ACCEPT. Returns account state with updated data, list of external messages and (optional, for ABI contracts only) list of messages decoded data.

  • [new] tvm module. run_executor function - performs full contract code execution on Transaction Executor (part of collator protocol that performs all phases and checks and - as a successful result - forms a transaction) Returns updated account state, parsed transaction, list of parsed messages with optional decoded message bodies.

  • [breaking] tvm module. run_get does not download account boc from the network anymore, but takes account boc as a parameter.

0.26.0 Aug 15, 2020

New

  • config.get_api_reference api function (pre release).
  • ton_sdk_cli cli tool (pre release).
  • full local run functions use LocalRunContext to exactly reproduce all transaction parameters and produce the same result as node

0.25.4 Aug 5, 2020

Fixed

  • waitForTransaction didn't use prev_alt_ref for block walking

0.25.3 Jul 30, 2020

New

  • All methods that require contract's code/data can use field boc in account document to extract code and data (instead of code and data fields).
  • Optional bocBase64 parameter of method tvm.get that can be used instead of codeBase64 and dataBase64.

0.25.2 Jul 29, 2020

New

  • error.data object extended with fields address, function_name, account_balance, account_address, query_url, config_server for appropriate errors

0.25.0 Jul 8, 2020

New

  • supports for core context in all platforms
  • local run functions return updated contract state when running with full_run = true
  • time sync check while initializing
  • parallel requests on different contexts don't block each other. Requests on the same context remain sequential
  • new transaction wait mechanism. All account's shard blocks are checked for transaction to guarantee message expiration
  • contracts.wait.transaction function for awaiting previously sent message processing
  • contracts.send.message returns message processing state for contracts.wait.transaction function
  • contracts.find.shard function for account shard matching
  • added logging on warning messages

May 28, 2020

New

  • error resolving by local message processing
  • contracts.resolve.error function for manual error resolving call
  • contracts.process.transaction function processing transaction to check errors and get output
  • contracts.run.local and contracts.run.local functions now have fullRun flag to emulate node transaction processing and calculate fees
  • tonsdk command line tool.
  • ton_client function get_method_names.

May 22, 2020

Fix

  • TON mnemonic functions didn't check validity of the seed phrase.

May 19, 2020

ton-client-web 0.23.1

New

  • Platform builder generates ready to use index.js for web clients (instead of install script of ton-client-web-js binding)

May 17, 2020

New

  • tvm.get now can fetch account data if it is not provided

May 14, 2020

New

  • Message processing functions added
  • Run get methods function added
  • ed25519-dalek version updated to 1.0.0-pre.3
  • SDK is fully open sourced since open repo ton-labs-executor used

Fixed

  • Panic in fee calculation under WASM
  • reqwest crate version synced in all projects
  • Memory leaking in Node JS