Tac-sdk NPM | npm.io

TAC-SDK

SDK for cross-chain transactions from TVM to EVM.

The main idea of SDK is to help EVM developers with cross-chain transactions from TVM to EVM. EVM-developer should specify a few things: 1. The address of contract to interact with 2. Which method to use on the contract 3. What parameters need to be passed to contract

Then SDK will use these parameters to build a correct transaction for TON, i.e. it will build the payload and give it to the TON for further signature via ton-connect.

EVM-developer will not need to know the details of working with TON except ton-connect.

Features

TON:

Get user jetton balance
Cross-chain payload generation
Jetton transfers

Install

npm install tac-sdk

Usage

To use this library you need HTTP API endpoint, you can use one of the public endpoints:

Mainnet: https://toncenter.com/api/v2/jsonRPC
Testnet: https://testnet.toncenter.com/api/v2/jsonRPC

import {TacSdk} from "tac-sdk";
import {TonConnectUI} from "@tonconnect/ui";
import {ethers} from "ethers";

const tonConnectUI = new TonConnectUI({
    manifestUrl: config.tonconnectManifestUrl as string
});

// work with tonconnect (connect user)

const abi = new ethers.AbiCoder();
const encodedParameters = abi.encode(
    ['address', 'uint256', 'uint256', 'uint256', 'uint256'],
    [
        "ethersContractAddress",
        "value1",
        "value2",
        "value3",
        "value4"
    ]
); //example

const params = {
    fromAddress: "tonUserAddress",
    jettonAmount: 100, //example
    proxyMsg: {
        evmTargetAddress: "evmTargetAddress",
        methodName: 'exchange(address,uint256,uint256,uint256,uint256)', //example
        encodedParameters: encodedParameters,
    },
    tokenAddress: "tonTokenAddress",
    tonConnect: tonConnectUI
};

const tacSdk = new TacSdk({
      network: CHAIN.TESTNET //default: MAINNET
});

await tacSdk.sendJettonWithProxyMsg(params);