Release Notes
JavaScript SDK
Track SDK updates, breaking changes, and new features across versions
This changelog documents all notable changes to the TAC SDK, including new features, improvements, bug fixes, and breaking changes.
Added
- Advanced options to
sendCrossChainTransaction
- Method to send multiple crosschain transactions at once:
sendCrossChainTransactions
- Batch sending support for crosschain transactions
- Error handling while sending crosschain transactions
Changed
- TonClient with TAC endpoint as default contract opener
Added
metaInfo
field to theExecutionStages
- LiteSequencerClient to handle lite sequencer requests and its parameters
- Method to calculate tvmExecutorFee:
getTVMExecutorFeeInfo
Changed
getEVMTokenAddress
now automatically normalizes addresses toEQ
form- For TAC->TON transactions tvmExecutorFee calculated via lite sequencer
Changed
- Due to an API change, updated the
operationId
retrieval. An empty string will be returned for 404 errors
Added
OperationType
typeExecutionStagesTableData
typeTrackingOperationResult
typeStageName
enumgetOperationType
inOperationTracker
retrieves theOperationType
foroperationId
Changed
- The stage names have been changed
- Changed namings in enums
OperationType
added in theExecutionStages
ExecutionStages
structure- Added return value in method
sendShardTransaction
inTonConnectSender
- Added
forceSend
option in methodsendCrossChainTransaction
inTacSdk
startTracking
has been improved. Added optional parameters and return values
Removed
- Deleted
isBridgeOperation
(now it can be determined withgetOperationType
)
Changed
- Changed package tac-sdk -> @tonappchain/sdk
calculateEVMTokenAddress
function now requires tokenUtils address as deployer and crossChainLayer address as constructor params- Rename shardedId -> shardsKey
- A
gasLimit
field has been added toEvmProxyMsg
(defaulting to undefined, which will be set through simulation in this case) - Renamed json properties in
buildEvmDataCell
- Renamed urls in
OperationTracker
Added
options
parameter ingetSender
method to modify W5 and Highload V3 walletscustomLiteSequencerEndpoints
parameter inSDKParams
to specify custom lite sequencer endpointssimulateEVMMessage
method inTacSdk
to simulate EVM message execution on TAC sidegetOperationStatuses
method inOperationTracker
retrieves the statuses of multiple operations based on their respectiveoperationId's
getOperationIdsByShardsKeys
method inOperationTracker
retrieves theoperationId's
based on their respectiveshardsKey's
getStageProfilings
method inOperationTracker
retrieves theExecutionStages's
based on their respectiveoperationId's
getStageProfiling
method inOperationTracker
retrieves theExecutionStages
foroperationId
- Added a pre-check before sending to the blockchain to ensure the transaction will execute successfully on the TAC side using the
simulateEVMMessage
method - Support for highload V3 wallet as a sender
Added
- Section in readme about TACHeader
- AddLiquidity uniswap_v2 test
orbsOpener
method to construct custom contractOpener for TacSDK. It uses Orbs Network and does not have rate limits
Changed
- SDK uses orbsOpener by default
address
field inAssetBridgingData
can be either EVM or TVM address- Method
SenderFactory.getSender
requires additional parameternetwork
when creating wallet wrapper using mnemonic - Fixed
getContractState
inliteClientOpener
- Fixed all tests for TACHeader logic
- Version
@tonappchain/artifacts
upgraded to0.0.12-addresses
- Request to
/status
endpoint of Sequencer API changed fromGET
toPOST
with body - Signature of
getOperationStatus
is changed
Removed
- Deleted test bridgeData
Changed
- Calculate token addresses through emulation
- Renamed
TransactionStatus
toOperationTracker
- Renamed method
OperationTracker.getStatusTransaction()
toOperationTracker.getOperationStatus()
- Renamed method
OperationTracker.getSimpifiedTransactionStatus()
toOperationTracker.getSimplifiedOperationStatus()
- Renamed
TacSDKTonClientParams
toSDKParams
- Changed struct of
SDKParams
- Changed
ton-lite-client
library to its fork@tonappchain/ton-lite-client
Added
- Custom
TONParams
andTACParams
inSDKParams
network
andcustomLiteSequencerEndpoints
params toOperationTracker
constructor- Static async function
create
inTacSdk
for creating an instance ofTacSdk
- Custom errors
- Methods that may construct custom contractOpener for TacSDK
- Method
closeConnections
inTacSdk
for closing all network connections - Optional method
closeConnections
toContractOpener
interface
Removed
init
function inTacSdk
- Public constructor of
TacSdk
Added
- Method to get TVM address based on EVM address
- Tests for SDK methods using contract emulation
- Support for custom contract opener
- SDK uses @tonappchain/artifacts
- Added get methods for native token addresses
- Added support for native token address calculation in getEVMTokenAddress and getTVMTokenAddress methods
Removed
- Support for TON wallet v1