Methods

tonConnect_connect

Connect the wallet and request account information.

Request

[
  {
    "manifestUrl": "https://yourapp.com/tonconnect-manifest.json",
    "items": [
      { "name": "ton_addr" }
    ]
  }
]

Response

{
  "items": [
    {
      "name": "ton_addr",
      "address": "0:057bdabe92e2963cdf83e906cedadde13d418be6deb394faea77e1090097f747",
      "network": "-239",
      "walletStateInit": "te6cck...",
      "publicKey": "6fc8798de2bd48a1a0f4b3b4b37f7d30d51dca23f4b143ed3439096ca01897b9"
    }
  ],
  "device": {
    "platform": "mac",
    "appName": "cactus link",
    "appVersion": "2.1.8",
    "maxProtocolVersion": 2,
    "features": [
      "SendTransaction",
      {
        "name": "SendTransaction",
        "maxMessages": 255,
        "extraCurrencySupported": true
      },
      {
        "name": "SignData",
        "types": ["text", "binary", "cell"]
      }
    ]
  }
}

Note: network: "-239" is the mainnet network ID for TON. The device section is assembled by the plugin.

tonConnect_reconnect

Reconnect a previously authorized wallet session.

Request

[
  { "name": "ton_addr" }
]

Response

Same structure as tonConnect_connect response.

tonConnect_sendTransaction

Send one or more messages in a TON transaction.

Request

[
  {
    "from": "0:057bdabe92e2963cdf83e906cedadde13d418be6deb394faea77e1090097f747",
    "network": "-239",
    "valid_until": 1750734652242,
    "messages": [
      {
        "address": "EQAwYg4_Y9LnDJ_zSDCxEHs-BvpHZQM6GQ-2AZBnxeP2PxTW",
        "amount": "200000000",
        "payload": "te6cckEBAQEADgAAGAAAAABXaXRoZHJhd6/QZtE="
      }
    ]
  }
]

Response

A BOC (Bag of Cells) encoded string:

te6cckEBBAEAwwAB5YgACve1fSXFLHm...

The plugin passes through the dApp's request message directly. The parameters for custody are the same as tonConnect_sendTransaction request parameters.

tonConnect_disconnect

Disconnect the currently connected wallet.

Request

[]

Response

None

tonConnect_signData

Sign arbitrary data (text, binary, or cell format).

Supported Data Types

• text
• binary
• cell

Request

{
  "schema_crc": 0,
  "cell": "..."
}

Response

{
  "signature": "...",
  "timestamp": 1234567890
}