darttonconnect_plus 1.0.2

Dart SDK for TON Connect. Use it to connect your app to TON wallets via TonConnect protocol.

Dart SDK for TON Connect

Improved Dart SDK for TON Connect 2.0

Here is the fork of DartTonConnect package. Forked version advantages:

1. Stream with TON HTTP network events
2. Transaction sending interface with payload support
3. Bug fixes

Install

With Dart:

 $ dart pub add darttonconnect_plus

This will add a line like this to your package's pubspec.yaml (and run an implicit dart pub get):

dependencies:
  darttonconnect_plus: ^1.0.1

Alternatively, your editor might support dart pub get. Check the docs for your editor to learn more.

Configure

Create JSON-manifest file with your app description. This info will be displayed inside the wallet during the connection procedure.

{
  "url": "<app-url>",                        // required
  "name": "<app-name>",                      // required
  "iconUrl": "<app-icon-url>",               // required
  "termsOfUseUrl": "<terms-of-use-url>",     // optional
  "privacyPolicyUrl": "<privacy-policy-url>" // optional
}

This file must be available to GET by its URL.

Init

Pass manifest to TonConnectManager

var tonManager = TonConnectManager(
'https://gist.githubusercontent.com/romanovichim/e81d599a6f3798bb9f74ab1970a8b376/raw/43e00b0abc824ef272ac6d0f8083d21456602adf/gistfiletest.txt');

Subscribe to TON events stream messages

    tonManager.messagesStream.listen((TonPaymentStatus status) {
      
    });

Handle events

Next events may be in the stream:

TonPaymentStatus.Wallets_loaded

Supported TON wallets list is loaded. Now you are able to offer them to connect.

TonPaymentStatus.UniversalLink_generated

User picked up specific wallet. Link for connection is generated.

TonPaymentStatus.Connected

Selected wallet is connected to the app. Now you are able to request the transaction.

TonPaymentStatus.Transaction_prepaired

Transanction request is sent through TON HTTP bridge. User should open the wallet and confirm the transaction

TonPaymentStatus.Transaction_sent

The transaction is successfully add to the blockchain

TonPaymentStatus.Transaction_error_or_rejected

User declined the transaction or something went wrong with the connection

TonPaymentStatus.Disconnected

The wallet is disconnected from your app

Transaction

Simple interface, with comment that will be shown while confirmation inside the wallet

  void sendTrx(
      {required String address,
        required int amount,
        String? comment,
        int? validUntill})

Or create transaction by your own

sendTrxRaw({required Map<String, dynamic> transaction})

Example

Full example please see here

UI Part

All nessesary Flutter widgets implemented in Flutter_ton_buttons package