Toncenter API
815 subscribers
6 photos
40 links
Updates and announcements of https://toncenter.com β€” fast and reliable HTTP API for TON (The Open Network).

Bot @toncenter.

API is developed by the TON Core team @toncore.
Download Telegram
The peer_swaps field has been added to the Action API for complex swaps on DEXes. This field contains information about intermediate swaps (exchanges).
Emulation API now uses the same response models for transactions, messages, and actions as Index API v3.

Additionally, is_incomplete flag has been added to indicate if the emulated trace was truncated due to size limits.
πŸ‘5
Toncenter API supported hash of a normalized external message

API V3 (Index):

- hash_norm field added to the Message structure. If the field is not present, it means this message is not an external message, or the normalized hash_norm is equal to the regular hash.

- All methods with msg_hash parameter search also by normalized hash.

API V2:

- api/v2/sendBocReturnHash returns the normalized hash in addition to the normal hash.
πŸ”₯2
Introducing the Pending API

Using this API you can track operations on the blockchain that have not yet completed.

As soon as an external message enters the blockchain, the Toncenter API Indexer notices it and builds a subsequent transaction series. Next, the action to be executed (e.g. "Swap on DeDust DEX") is recognized. As transactions are executed, the transaction series is re-indexed.

You can use this API to build responsive applications that respond quickly to user actions and show the progress of pending blockchain operations.

/api/v3/pendingActions

/api/v3/pendingTraces
πŸ”₯9
Tonscan.org uses the Toncenter API

A great example of using the latest features of the Toncenter API is the popular blockchain explorer tonscan.org.

Using the Actions API, it shows user-understandable actions (such as β€œSwap on DeDust DEX” or β€œDomain Renew”) instead of raw account transactions.

Using Pending API it displays a list of pending transactions. By opening such a pending transaction we can see its progress in real time.

In the next updates, the Tonscan.org team plans to further simplify the UI.
πŸ”₯6😁4πŸ‘2πŸ₯΄1
MyTonWallet uses the Toncenter API

Another impressive example is how the popular non-custodial wallet MyTonWallet has enhanced the β€œActivity Feed” tab with user activity history using Toncenter's Actions API.

https://tg-me.sbs/MyTonWalletEn/227
πŸ‘9πŸ”₯6😁4
The Emulation API now supports the optional mc_block_seqno parameter. You can emulate a transaction chain for a specific masterchain block. Only recent masterchain blocks (~7 days) are supported.
πŸ”₯3πŸ‘1
Instant appearance of pending transactions

Pending actions and transactions are now instantly available in the Pending API after message sending via Toncenter API.
πŸ‘3❀1
New actions supported in Toncenter API

Multisig V2:

β€” Multisig order creation (multisig_create_order)

β€” Order approval (multisig_approve)

β€” Order execution (multisig_execute)

Vesting:

β€” Message sending (vesting_send_message)

β€” Adding to the whitelist (vesting_add_whitelist)

Evaa:

β€” Supply (evaa_supply)

β€” Withdraw (evaa_withdraw)

β€” Liquidation (evaa_liquidate)

Jvault:

β€” Stake (jvault_stake)

β€” Unstake (jvault_unstake)

β€” Claim (jvault_claim)

In addition, the current actions have been improved:

β€” Supported NFT discovery message (nft_discovery).

β€” A definition of unsuccessful TON transfer (ton_transfer) and Jetton transfer (jetton_transfer) has been added for cases where the execution failed on the sender's account (traces with a single transaction by an external message).

β€” Improved support for Jetton Mint action: added support for mints that run with opcode 0x00000015. Previously, only 0x642b7d07 was supported.

β€” Improved support for liquid staking (@stakee, Tonstakers) actions: added tokens_minted and tokens_burnt fields to deposit/withdrawal operations. Improved the method of calculating how many TON a user receives for burning tokens upon withdrawal. Added the definition of the pool address when burning NFT vouchers (deferred deposit withdrawal).

https://toncenter.com/api/v3/index.html#/actions/api_v3_get_actions
πŸ‘3
Versioning in the Actions API

We introduce versioning for actions in https://toncenter.com/api/v3/.

Specify the "supported_action_types" in methods api/v3/traces and api/v3/actions to desired version of action types and get the actions of supported types or set it to "latest" to get all newest actions from API v3.

Clients (e.g., wallet or blockchain explorers applications) can use it to receive the only actions that they support.

Version "v1":
β€” Basic: call_contract, contract_deploy, ton_transfer, tick_tock
β€” Jettons: jetton_burn, jetton_transfer, jetton_mint
β€” NFTs: nft_mint, nft_transfer, auction_bid
β€” DEXs: jetton_swap, dex_deposit_liquidity, dex_withdraw_liquidity
β€” Liquid staking: stake_deposit, stake_withdrawal, stake_withdrawal_request
β€” Elections: election_deposit, election_recover
β€” TON DNS: change_dns, delete_dns, renew_dns
β€” Subsctiptions: subscribe, unsubscribe

Version "v2":
β€” Multisig: multisig_create_order, multisig_approve, multisig_execute
β€” Vesting: vesting_send_message, vesting_add_whitelist
β€” EVAA: evaa_supply, evaa_withdraw, evaa_liquidate
β€” Jvault: jvault_stake, jvault_unstake, jvault_claim
β€” NFTs: nft_discovery

Version "latest": returns all newest action types.
πŸ‘4
Emulation and Pending API Updates

β€” In the Emulation API and Pending API, transaction chains are now emulated more accurately.
Previously, all transactions in a chain were emulated for a single block. Now, the emulator distributes transactions across different blocks (for example, an inter-shard message will occupy several blocks).
This allows for more accurate prediction of transaction order and results, as well as approximate timestamps and lt values for transactions, which makes it possible to estimate approximate execution times.

β€” Emulation API: added address_book and metadata.
πŸ‘4❀1
ton-http-api 2.0.54

Normalized hash of external messages supported.

https://github.com/toncenter/ton-http-api
πŸ‘3
DeDust DEX now provides an instant link to pending action

After the exchange, you will immediately receive a link to the blockchain explorer, which you can share or use to track the transaction.

Please note that the DeDust DEX user interface does not block you, and you can make a new exchange even if the previous one is still in progress.

https://dedust.io/swap
πŸ‘4
Tonscan.org has made it even easier to display account history using the Toncenter Actions API

The account history displays human-readable and user-friendly information, with almost no technical data.
πŸ‘7πŸ‘Ž2
Tonscan.org displays the percentage of an action completed using the Toncenter Pending API

The user receives a simple response in real time regarding the execution of the action in the blockchain.
πŸ‘9πŸ”₯4❀1
tonscan.org uses Toncenter Actions V2

Based on Toncenter Actions API v2 update, the popular blockchain explorer tonscan.org has start to display operations with multisig, vesting, EVAA, and Jvault services.

It is also worth noting the extended support for multisig: the explorer now displays a list of signers, proposers, multisig info and the contents of the multisig order that will be executed after signing.
πŸ”₯3❀1
New actions supported

Tonco.io DEX supported in the Toncenter Actions API:

New provider "tonco" added to existing DEX actions: jetton_swap, dex_deposit_liquidity, dex_withdraw_liquidity; tonco_create_pool action added.
πŸ”₯5