Ton integration

README.md

@@ -72,7 +72,7 @@ export default function App({ Component, pageProps }) {
 | Near      | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 | Bitcoin   | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 | Casper    | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
-| Ton       | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
+| Ton       | :white_check_mark:     | :x:                | :x:                    | :x:                    | :x:                    |
 | Algorand  | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 
 #### Hooks

example-next/public/tonconnect-manifest.json

@@ -0,0 +1,5 @@
+{
+  "url": "http://localhost:3000",
+  "name": "Tangled3 Next Example",
+  "iconUrl": "https://ton.vote/logo.png"
+}

example-next/src/components/Providers.tsx

@@ -24,6 +24,8 @@ const Providers = ({ children }: { children: ReactNode }) => {
           },
 
           projectId: '41980758771052df3f01be0a46f172a5',
+
+          tonconnectManifestUrl: `${window.location.origin}/tonconnect-manifest.json`,
         }}
       >
         {children}

example-next/src/components/Tokens.tsx

@@ -135,11 +135,18 @@ const tokens: TokenMetadata[] = [
     chainId: 'alephZero',
   },
   {
-    address: '5CMdxZDuprVZKnw6tEWjhEtK17Z52PUJo2dj1JLdyKeuUcfH',
+    address: ETH_ADDRESS,
+    decimals: 9,
+    name: 'Toncoin',
+    symbol: 'TON',
+    chainId: '-239',
+  },
+  {
+    address: 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs',
     decimals: 6,
-    name: 'USDT',
+    name: 'Tether USD',
     symbol: 'USDT',
-    chainId: 'alephZero',
+    chainId: '-239',
   },
 ];
 

packages/react/README.md

@@ -72,7 +72,7 @@ export default function App({ Component, pageProps }) {
 | Near      | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 | Bitcoin   | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 | Casper    | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
-| Ton       | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
+| Ton       | :white_check_mark:     | :white_check_mark: | :white_check_mark:     | :white_check_mark:     | :white_check_mark:     |
 | Algorand  | :x:                    | :x:                | :x:                    | :x:                    | :x:                    |
 
 #### Hooks

packages/react/package.json

@@ -41,6 +41,8 @@
     "@solana/web3.js": "^1.94.0",
     "@tangled3/solana-react": "workspace:*",
     "@tanstack/react-query": "^5.44.0",
+    "@ton/ton": "^15.0.0",
+    "@tonconnect/ui-react": "^2.0.9",
     "@tronweb3/tronwallet-abstract-adapter": "^1.1.6",
     "@tronweb3/tronwallet-adapters": "^1.2.1",
     "@wagmi/core": "^2.11.0",

packages/react/src/actions/getToken.ts

@@ -9,6 +9,7 @@ import { areTokensEqual } from '../utils/index.js';
 import { getAlephZeroTokenBalanceAndAllowance, getAlephZeroTokenMetadata } from './alephZero/getAlephZeroToken.js';
 import { getEVMTokenBalanceAndAllowance, getEVMTokenMetadata } from './evm/getEVMToken.js';
 import { getSolanaTokenBalanceAndAllowance } from './solana/getSolanaToken.js';
+import { getTonTokenBalanceAndAllowance, getTonTokenMetadata } from './ton/getTonToken.js';
 
 /**
  * Get token metadata
@@ -83,6 +84,17 @@ export const getTokenMetadata = async ({ token, chain, config }: GetTokenMetadat
     };
   }
 
+  if (chain.type === 'ton') {
+    if (areTokensEqual(token, ETH_ADDRESS)) {
+      return { ...chain.nativeCurrency, address: ETH_ADDRESS, chainId: chain.id };
+    }
+    const res = await getTonTokenMetadata({ token, chainId: chain.id });
+    return {
+      ...res,
+      chainId: chain.id,
+    };
+  }
+
   throw new Error('Chain type not supported');
 };
 
@@ -177,5 +189,14 @@ export const getTokenBalanceAndAllowance = (async (params) => {
     });
   }
 
+  if (chain.type === 'ton') {
+    return getTonTokenBalanceAndAllowance({
+      account,
+      token,
+      spender,
+      config,
+    });
+  }
+
   throw new Error('Chain type not supported');
 }) as GetTokenBalanceAndAllowanceFunction;

packages/react/src/actions/sendTransaction.ts

@@ -1,5 +1,7 @@
 import { Signer, SubmittableExtrinsic } from '@polkadot/api/types';
 import { VersionedTransaction as SolanaVersionedTransaction } from '@solana/web3.js';
+import { Cell } from '@ton/ton';
+import { CHAIN } from '@tonconnect/ui-react';
 import { sendTransaction as sendEVMTransaction } from '@wagmi/core';
 import { Address as EVMAddress } from 'viem';
 import { ChainData, ChainType, ConnectionOrConfig } from '../types/index.js';
@@ -29,7 +31,16 @@ type TransactionArgs<CType extends ChainType> = CType extends 'evm' | 'tron'
       ? {
           submittableExtrinsic: SubmittableExtrinsic<'promise' | 'rxjs'>;
         }
-      : never;
+      : CType extends 'ton'
+        ? {
+            tonArgs: {
+              validUntil: number; // transaction deadline in unix epoch seconds.
+              network?: CHAIN; // (MAINNET: "-239" & TESTNET: "-3")
+              payload?: string;
+              stateInit?: string;
+            };
+          }
+        : never;
 
 type SendTransactionReturnType<C extends ChainType> = C extends 'alephZero'
   ? {
@@ -136,5 +147,38 @@ export const sendTransactionToChain = (async ({ chain, to, from, value, args, co
     };
   }
 
+  if (chain.type === 'ton') {
+    const { tonArgs } = args as TransactionArgs<'ton'>;
+    const messages: Array<{
+      address: string;
+      amount: string;
+      payload?: string;
+      stateInit?: string;
+    }> = [
+      {
+        address: to,
+        amount: value.toString(),
+        payload: tonArgs.payload,
+        stateInit: tonArgs.stateInit,
+      },
+    ];
+    const transaction = {
+      from,
+      messages,
+      network: tonArgs.network,
+      validUntil: tonArgs.validUntil,
+    };
+
+    const walletConnector = config.connector as WalletInstance<'ton'>;
+    // send transaction to TON chain
+    const tx = await walletConnector.sendTransaction(transaction);
+
+    const cell = Cell.fromBase64(tx.boc);
+    const buffer = cell.hash();
+    const hashHex = buffer.toString('hex');
+
+    return { txHash: hashHex };
+  }
+
   throw new Error('Chain not supported');
 }) as SendTransactionToChainFunction;

packages/react/src/actions/ton/getTonClient.ts

@@ -0,0 +1,9 @@
+import { TonClient } from '@ton/ton';
+import { OtherChainData } from '../../types/index.js';
+
+export const getTonClient = (chain: OtherChainData<'ton'>) => {
+  const tonClient = new TonClient({
+    endpoint: chain.rpcUrls.default.http[0] ?? '',
+  });
+  return tonClient;
+};

packages/react/src/actions/ton/getTonToken.ts

@@ -0,0 +1,54 @@
+import { Address, JettonMaster } from '@ton/ton';
+import { CHAIN } from '@tonconnect/ui-react';
+import { ChainId, ConnectionOrConfig } from '../../types/index.js';
+
+export const getTonTokenMetadata = async ({ token, chainId }: { token: string; chainId: ChainId }) => {
+  const data = await (
+    await fetch(
+      chainId === CHAIN.MAINNET
+        ? `https://toncenter.com/api/v3/jetton/masters?address=${token}&limit=128&offset=0`
+        : `https://testnet.toncenter.com/api/v3/jetton/masters?address=${token}&limit=128&offset=0`,
+    )
+  ).json();
+
+  const jettonContent = data.jetton_masters[0].jetton_content;
+
+  return {
+    symbol: jettonContent.symbol ?? 'USDT',
+    name: jettonContent.name ?? 'Tether USD',
+    decimals: Number(jettonContent.decimals),
+    address: jettonContent.address ?? token,
+  };
+};
+
+export const getTonTokenBalanceAndAllowance = async ({
+  account,
+  token,
+  config,
+}: {
+  account: string;
+  token: string;
+  spender: string | undefined;
+  config: ConnectionOrConfig;
+}) => {
+  let balance = 0n;
+  const allowance = 0n;
+
+  try {
+    const jettonMaster = new JettonMaster(Address.parse(token));
+    const contractProvider = config.tonClient.provider(Address.parse(token));
+
+    const walletAddress = await jettonMaster.getWalletAddress(contractProvider, Address.parse(account));
+
+    const walletAddressContractCallResult = await config.tonClient.runMethod(walletAddress, 'get_wallet_data');
+    const accountBalance = walletAddressContractCallResult.stack.readNumber();
+    balance = BigInt(accountBalance);
+  } catch (error) {
+    console.error('error - ', error);
+  }
+
+  return {
+    balance,
+    allowance,
+  };
+};

packages/react/src/actions/waitForTransaction.ts

@@ -1,3 +1,4 @@
+import { Address } from '@ton/ton';
 import { waitForTransactionReceipt } from '@wagmi/core';
 import { ReplacementReturnType } from 'viem';
 import { ChainData, ChainType, ConnectionOrConfig, TransactionReceipt } from '../types/index.js';
@@ -19,7 +20,12 @@ export type WatchTransactionOverrides<C extends ChainType> = DefaultOverrides &
       ? {
           maxSupportedTransactionVersion: number;
         }
-      : any);
+      : C extends 'ton'
+        ? {
+            accountAddress: string;
+            lt: string;
+          }
+        : any);
 
 export type DefaultTransactionParams = {
   txHash: string;
@@ -157,5 +163,25 @@ export const waitForTransaction = (async ({ chain, config, overrides, transactio
     return receipt;
   }
 
+  if (chain.type === 'ton') {
+    const _overrides = (overrides || {}) as WatchTransactionOverrides<'ton'>;
+    const { txHash } = transactionParams as TransactionParams<'ton'>;
+
+    const receipt = await pollCallback(
+      async () => {
+        return await config.tonClient.getTransaction(Address.parse(_overrides.accountAddress), _overrides.lt, txHash);
+      },
+      {
+        interval: overrides?.interval || DEFAULT_POLLING_INTERVAL,
+        timeout: overrides?.timeout,
+      },
+    );
+
+    if (!receipt) {
+      throw new Error('Transaction not found');
+    }
+    return receipt;
+  }
+
   throw new Error('Chain not supported');
 }) as WatchTransactionFunction;

packages/react/src/chains/index.ts

@@ -4,5 +4,6 @@ export * from './evm.testnet.js';
 export * from './solana.devnet.js';
 export * from './solana.js';
 export * from './solana.testnet.js';
+export * from './ton.js';
 export * from './tron.js';
 export * from './tron.shasta.js';

packages/react/src/chains/ton.testnet.ts

@@ -0,0 +1,25 @@
+import { CHAIN } from '@tonconnect/ui-react';
+import { ChainData } from '../types/index.js';
+
+export const tonTestnet: ChainData = {
+  id: CHAIN.TESTNET, // '-3'
+  name: 'Ton Testnet',
+  type: 'ton',
+  nativeCurrency: {
+    name: 'TON',
+    symbol: 'TON',
+    decimals: 9,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://testnet.toncenter.com/api/v2/jsonRPC'],
+      webSocket: [''],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Tonscan',
+      url: 'https://testnet.tonscan.org/',
+    },
+  },
+} as const;

packages/react/src/chains/ton.ts

@@ -0,0 +1,25 @@
+import { CHAIN } from '@tonconnect/ui-react';
+import { OtherChainData } from '../types/index.js';
+
+export const tonMainnet: OtherChainData<'ton'> = {
+  id: CHAIN.MAINNET, // '-239'
+  name: 'Ton',
+  type: 'ton',
+  nativeCurrency: {
+    name: 'TON',
+    symbol: 'TON',
+    decimals: 9,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://toncenter.com/api/v2/jsonRPC'],
+      webSocket: [''],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Tonscan',
+      url: 'https://tonscan.org/',
+    },
+  },
+} as const;