@tonconnect/sdk 3.0.7 → 3.1.0

package/lib/types/index.d.ts

@@ -70,6 +70,8 @@ export declare enum CHAIN {
     TESTNET = "-3"
 }
 
+export declare function checkRequiredWalletFeatures(features: Feature[], walletsRequiredFeatures?: RequiredFeatures): boolean;
+
 export declare enum CONNECT_EVENT_ERROR_CODES {
     UNKNOWN_ERROR = 0,
     BAD_REQUEST_ERROR = 1,
@@ -92,6 +94,15 @@ export declare interface ConnectAdditionalRequest {
     tonProof?: string;
 }
 
+export declare interface ConnectEventSuccess {
+    event: 'connect';
+    id: number;
+    payload: {
+        items: ConnectItemReply[];
+        device: DeviceInfo;
+    };
+}
+
 /**
  * Successful connection event when a user successfully connected a wallet.
  */
@@ -243,6 +254,8 @@ export declare type ConnectionStartedEvent = {
 
 export declare type ConnectItem = TonAddressItem | TonProofItem;
 
+export declare type ConnectItemReply = TonAddressItemReply | TonProofItemReply;
+
 export declare type ConnectItemReplyError<T> = {
     name: T;
     error: {
@@ -575,6 +588,30 @@ export declare type RequestVersionEvent = {
     type: 'request-version';
 };
 
+/**
+ * Required features for wallets.
+ */
+export declare type RequiredFeatures = {
+    /**
+     * Required features for the send transaction feature.
+     */
+    sendTransaction?: RequiredSendTransactionFeature;
+};
+
+/**
+ * Required features for the send transaction feature.
+ */
+export declare type RequiredSendTransactionFeature = {
+    /**
+     * Minimum number of messages to send.
+     */
+    minMessages?: number;
+    /**
+     * Whether extra currency is required.
+     */
+    extraCurrencyRequired?: boolean;
+};
+
 /**
  * Response TON Connect UI version.
  */
@@ -667,6 +704,14 @@ export declare interface TonAddressItem {
     name: 'ton_addr';
 }
 
+export declare interface TonAddressItemReply {
+    name: 'ton_addr';
+    address: string;
+    network: CHAIN;
+    walletStateInit: string;
+    publicKey: string;
+}
+
 declare class TonConnect implements ITonConnect {
     private static readonly walletsList;
     /**
@@ -695,6 +740,7 @@ declare class TonConnect implements ITonConnect {
     private provider;
     private statusChangeSubscriptions;
     private statusChangeErrorSubscriptions;
+    private readonly walletsRequiredFeatures;
     private abortController?;
     /**
      * Shows if the wallet is connected right now.
@@ -788,11 +834,11 @@ export default TonConnect;
 /**
  * Base class for TonConnect errors. You can check if the error was triggered by the @tonconnect/sdk using `err instanceof TonConnectError`.
  */
-export declare class TonConnectError extends Error {
+export declare class TonConnectError<T = unknown> extends Error {
     private static prefix;
     protected get info(): string;
     constructor(message?: string, options?: {
-        cause?: unknown;
+        cause?: T;
     });
 }
 
@@ -824,6 +870,10 @@ export declare interface TonConnectOptions {
      * @default Infinity
      */
     walletsListCacheTTLMs?: number;
+    /**
+     * Required features for wallets. If wallet doesn't support required features, it will be disabled.
+     */
+    walletsRequiredFeatures?: RequiredFeatures;
     /**
      * Allows to disable auto pause/unpause SSE connection on 'document.visibilitychange' event. It is not recommended to change default behaviour.
      */
@@ -1063,6 +1113,10 @@ export declare interface WalletInfoBase {
      * Info or landing page of your wallet. May be useful for TON newcomers.
      */
     aboutUrl: string;
+    /**
+     * List of features supported by the wallet.
+     */
+    features?: Feature[];
     /**
      * OS and browsers where the wallet could be installed
      */
@@ -1129,6 +1183,23 @@ export declare interface WalletInfoRemote extends WalletInfoBase {
     bridgeUrl: string;
 }
 
+/**
+ * Thrown when wallet can't get manifest by passed manifestUrl.
+ */
+export declare class WalletMissingRequiredFeaturesError extends TonConnectError<{
+    connectEvent: ConnectEventSuccess['payload'];
+}> {
+    cause: {
+        connectEvent: ConnectEventSuccess['payload'];
+    };
+    protected get info(): string;
+    constructor(message: string, options: {
+        cause: {
+            connectEvent: ConnectEventSuccess['payload'];
+        };
+    });
+}
+
 /**
  * Thrown when send transaction or other protocol methods called while wallet is not connected.
  */
@@ -1145,6 +1216,14 @@ export declare class WalletNotInjectedError extends TonConnectError {
     constructor(...args: ConstructorParameters<typeof TonConnectError>);
 }
 
+/**
+ * Thrown when wallet doesn't support requested feature method.
+ */
+export declare class WalletNotSupportFeatureError extends TonConnectError {
+    protected get info(): string;
+    constructor(...args: ConstructorParameters<typeof TonConnectError>);
+}
+
 export declare class WalletsListManager {
     private walletsListCache;
     private walletsListCacheCreationTimestamp;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonconnect/sdk",
-  "version": "3.0.7",
+  "version": "3.1.0",
   "scripts": {
     "build": "npx rimraf types-dist && npx rimraf lib && npx rollup -c rollup.config.mjs && ttsc --project tsconfig.declarations.json && api-extractor run && npx rimraf types-dist && npx rimraf dist && npx webpack --config webpack.config.js",
     "test": "vitest run"