Virtual environmentsSimulator
Simulator API compatibility
Coverage matrix for Acton's simulated LiteAPI, TON Center v2/v3, Streaming API, and Emulate API surfaces
Available since: Acton 1.2
The simulator implements the HTTP endpoints for TON Center v2/v3, Streaming, and Emulate APIs.
The LiteAPI reference covers the binary liteserver protocol.
TON Center v2 coverage matrix
| Method | Endpoint | Supported | Summary |
|---|---|---|---|
GET | /api/v2/detectAddress | Yes | Detect address |
GET | /api/v2/detectHash | Yes | Detect hash |
GET | /api/v2/packAddress | Yes | Pack address |
GET | /api/v2/unpackAddress | Yes | Unpack address |
GET | /api/v2/getAddressInformation | Yes | Get address information |
GET | /api/v2/getExtendedAddressInformation | Yes | Get extended address information |
GET | /api/v2/getShardAccountCell | Yes | Get shard account cell |
GET | /api/v2/getWalletInformation | Yes | Get wallet information |
GET | /api/v2/getAddressBalance | Yes | Get address balance |
GET | /api/v2/getAddressState | Yes | Get address state |
GET | /api/v2/getTokenData | Yes | Get token data |
GET | /api/v2/getMasterchainInfo | Yes | Get masterchain info |
GET | /api/v2/getMasterchainBlockSignatures | No | Get masterchain block signatures |
GET | /api/v2/getShardBlockProof | No | Get shard block proof |
GET | /api/v2/getConsensusBlock | Yes | Get consensus block |
GET | /api/v2/lookupBlock | Yes | Lookup block |
GET | /api/v2/getShards | Yes | Get shards |
GET | /api/v2/getBlock | Yes | Get raw block BoC |
POST | /api/v2/getBlock | Yes | Get raw block BoC |
GET | /api/v2/getBlockHeader | Yes | Get block header |
GET | /api/v2/getOutMsgQueueSize | Yes | Get out msg queue size |
GET | /api/v2/getBlockTransactions | Yes | Get block transactions |
GET | /api/v2/getBlockTransactionsExt | Yes | Get block transactions extended |
GET | /api/v2/getTransactions | Yes | Get transactions |
GET | /api/v2/getTransactionsStd | Yes | Get transactions std |
GET | /api/v2/tryLocateTx | Yes | Try locate transaction |
GET | /api/v2/tryLocateResultTx | Yes | Try locate result transaction |
GET | /api/v2/tryLocateSourceTx | Yes | Try locate source transaction |
GET | /api/v2/getConfigParam | Yes | Get config parameter |
GET | /api/v2/getConfigAll | Yes | Get all config |
GET | /api/v2/getLibraries | Yes | Get libraries |
POST | /api/v2/sendBoc | Yes | Send serialized BoC |
POST | /api/v2/sendBocReturnHash | Yes | Send serialized BoC and return hash |
POST | /api/v2/runGetMethod | Yes | Run get method |
POST | /api/v2/runGetMethodStd | Yes | Run get method with std stack |
TON Center v3 coverage matrix
| Method | Endpoint | Supported | Summary |
|---|---|---|---|
GET | /api/v3/traces | Yes | Returns transaction trace tree for a transaction hash. |
GET | /api/v3/blocks | Yes | Returns block metadata with TON Center v3 blockchain filters. |
GET | /api/v3/accountStates | Yes | Returns account states with interfaces and token metadata. |
GET | /api/v3/addressInformation | Yes | Returns account state in V2AddressInformation shape. |
GET | /api/v3/walletInformation | Yes | Returns wallet type, state, seqno, and wallet ID when available. |
GET | /api/v3/addressBook | Yes | Returns address forms and locally detected interfaces. |
GET | /api/v3/metadata | Yes | Returns locally indexed jetton and NFT metadata. |
GET | /api/v3/masterchainInfo | Yes | Returns the first and latest local masterchain blocks. |
GET | /api/v3/transactions | Yes | Returns transactions with TON Center v3 blockchain filters. |
GET | /api/v3/messages | Yes | Returns messages with TON Center v3 filters. |
GET | /api/v3/adjacentTransactions | Yes | Returns transactions connected by inbound or outbound messages. |
GET | /api/v3/walletStates | Yes | Returns wallet projections for existing account states. |
GET | /api/v3/topAccountsByBalance | Yes | Returns accounts sorted by balance. |
GET | /api/v3/transactionsByMasterchainBlock | Yes | Returns transactions included in a masterchain block. |
GET | /api/v3/transactionsByMessage | Yes | Returns transactions filtered by message hash/body hash/opcode. |
GET | /api/v3/pendingTransactions | Yes | Returns pending transactions filtered by account and trace id. |
POST | /api/v3/message | Yes | Sends an external message in BoC and returns message hash fields. |
POST | /api/v3/estimateFee | Yes | Estimates fees without committing a transaction. |
POST | /api/v3/runGetMethod | Yes | Runs a get method of a smart contract with an explicit stack. |
GET | /api/v3/jetton/masters | Yes | Returns jetton master metadata with optional filters and pagination. |
GET | /api/v3/jetton/wallets | Yes | Returns jetton wallet metadata with optional filters and pagination. |
GET | /api/v3/nft/items | Yes | Returns NFT items with optional filters, pagination, and metadata. |
GET | /api/v3/actions | No | Returns classified actions. |
GET | /api/v3/decode | No | Decodes message bodies. |
GET | /api/v3/dns/records | Yes | Returns DNS records. |
GET | /api/v3/jetton/burns | Yes | Returns jetton burns. |
GET | /api/v3/jetton/transfers | Yes | Returns jetton transfers. |
GET | /api/v3/masterchainBlockShardState | Yes | Returns shard heads referenced by a masterchain block. |
GET | /api/v3/masterchainBlockShards | Yes | Returns workchain blocks indexed for a masterchain block. |
GET | /api/v3/multisig/orders | Yes | Returns multisig orders. |
GET | /api/v3/multisig/wallets | Yes | Returns multisig wallets. |
GET | /api/v3/nft/collections | Yes | Returns NFT collections. |
GET | /api/v3/nft/sales | Yes | Returns NFT sales. |
GET | /api/v3/nft/transfers | Yes | Returns NFT transfers. |
GET | /api/v3/pendingActions | Yes | Returns an empty pending-actions collection. |
GET | /api/v3/pendingTraces | Yes | Returns an empty pending-traces collection. |
GET | /api/v3/vesting | Yes | Returns vesting contract state. |
/api/v3/multisig/orders?parse_actions=true decodes order action envelopes, destinations, values, send modes, and multisig_update_params. Other embedded message bodies retain body_raw and use parsed_body_type: "unknown".
Streaming API v2
The simulator supports a TON Center Streaming API v2-compatible subset for local tools and the bundled explorer UI. For protocol details, request fields, finality behavior, and notification schemas, use the official TON Center Streaming API documentation.
| Transport | Endpoint | Supported | Summary |
|---|---|---|---|
| Server-sent events (SSE) | /api/streaming/v2/sse | Yes | Opens a text/event-stream subscription. |
WebSocket | /api/streaming/v2/ws | Yes | Opens a WebSocket subscription over JSON. |
The simulator emits transaction, account-state, jetton-state, and trace updates. Action extraction is not implemented; do not use action notifications for local indexing.
Emulate API coverage matrix
| Method | Endpoint | Supported | Summary |
|---|---|---|---|
POST | /api/emulate/v1/emulateTrace | Yes | Emulates external message execution trace against current state (no commit). |
POST | /api/emulate/v1/emulateTonConnect | Yes | Emulates a TON Connect transaction request against the sender wallet state. |
Last updated on