Please go to TON Connect v2 for a newer protocol that offers a seamless bridge API and does not require the app to receive callbacks from the wallet.
📄 TON Connect v1 Specification
cd server-example
yarn install
yarn start
$ yarn add @tonapps/tonconnect-server
$ npx tonconnect-generate-sk
Put generated static secret to env vars or config
import { TonConnectServer, AuthRequestTypes } from '@tonapps/tonconnect-server';
// Create a TonConnectServer instance configured with a static secret.
const tonconnect = new TonConnectServer({
staticSecret: process.env.TONCONNECT_SECRET
});
// When we need to authenticate the user, create an authentication request:
const request = tonconnect.createRequest({
image_url: 'https://ddejfvww7sqtk.cloudfront.net/images/landing/ton-nft-tegro-dog/avatar/image_d0315e1461.jpg',
callback_url: `${hostname}/tonconnect`,
items: [{
type: AuthRequestTypes.ADDRESS,
required: true
}, {
type: AuthRequestTypes.OWNERSHIP,
required: true
}],
});
res.send(request);
// Example: Tonkeeper deeplink:
// Provide the user with the URL to download that request.
const requestURL = `example.com/myrequest`;
const deeplinkURL = `https://app.tonkeeper.com/ton-login/${requestURL}`;Decode Auth Response
try {
const response = tonconnect.decodeResponse(req.query.tonlogin);
console.log('response', response);
for (let payload of response.payload) {
switch (payload.type) {
case AuthRequestTypes.OWNERSHIP:
const isVerified = await tonconnect.verifyTonOwnership(payload, response.client_id);
if (isVerified) {
console.log(`ton-ownership is verified for ${payload.address}`);
} else {
console.log(`ton-ownership is NOT verified`);
}
break;
case AuthRequestTypes.ADDRESS:
console.log(`ton-address ${payload.address}`);
break;
}
}
} catch (err) {
console.log(err);
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent