/**
 * DappSDK ties together DiscoveryClient + DappClient and serves as the
 * primary SDK entrypoint for dApp developers.
 *
 * A default singleton instance is exported at the bottom of this file, and
 * module-level functions delegate to that singleton for backward compatibility
 * (e.g. `sdk.connect()`, `sdk.status()`).
 */
import { type ProviderAdapter, type WalletPickerFn } from '@canton-network/core-wallet-discovery';
import type { EventListener, Provider } from '@canton-network/core-splice-provider';
import type { StatusEvent, ConnectResult, PrepareExecuteParams, PrepareExecuteAndWaitResult, LedgerApiParams, LedgerApiResult, ListAccountsResult, AccountsChangedEvent, TxChangedEvent, RpcTypes as DappRpcTypes, MessageSignatureEvent, SignMessageParams, SignMessageResult } from '@canton-network/core-wallet-dapp-rpc-client';
export interface DappSDKConnectOptions<TDefaultAdapter extends ProviderAdapter = ProviderAdapter> {
    defaultAdapters?: TDefaultAdapter[];
    additionalAdapters?: ProviderAdapter[] | undefined;
    enableSuggestedWallets?: boolean;
}
export declare class DappSDK {
    private readonly RECENT_GATEWAYS_KEY;
    private readonly walletPicker;
    private discovery;
    private client;
    private initPromise;
    private dynamicAdapterIds;
    private configuredAdapters;
    constructor(options?: {
        walletPicker?: WalletPickerFn | undefined;
    });
    private registerAdapters;
    private registerAnnouncedAdapters;
    private ensureDiscovery;
    private getInitAdapters;
    private collectDetectedAdapters;
    private saveRecentGateway;
    private getHttpStatusCode;
    private formatConnectionErrorMessage;
    private requireClient;
    /**
     * Returns the raw connected provider instance (if any).
     *
     * This is useful for advanced integrations that need to call methods that
     * are not wrapped by the higher-level SDK helpers.
     */
    getConnectedProvider(): Provider<DappRpcTypes> | null;
    /**
     * Cold-start the SDK: create (or update) the discovery client, register adapters,
     * and attempt to restore a persisted wallet session without opening the picker.
     *
     * Call early on app mount with your adapter configuration. For the exported
     * {@link sdk} singleton, the **first** `init()` call (with or without options)
     * determines how {@link ensureDiscovery} builds the initial adapter list; pass
     * `options` on that first call when you need custom gateways or extra adapters.
     *
     * Adapter selection when discovery is first created (see {@link getInitAdapters}):
     * - If `options` is passed on this call, use those adapters (default gateways apply when
     *   `defaultAdapters` is omitted).
     * - Else if {@link configuredAdapters} was set by an earlier `init(options)`, use it.
     * - Else use the last remote gateway URL from app-local hints (if any), otherwise
     *   fall back to default gateways (`gateways.json`).
     *
     * Session restore itself is always performed by {@link DiscoveryClient} via
     * `restorePersistedSessionIfNeeded()`; the SDK only ensures a compatible adapter set
     * is registered first.
     *
     * Safe to call from multiple places: concurrent callers share the same in-flight
     * promise; discovery creation itself still happens at most once per SDK instance.
     */
    init(options?: DappSDKConnectOptions): Promise<void>;
    connect(): Promise<ConnectResult>;
    /** @deprecated Pass options to `init()` instead. */
    connect(options: DappSDKConnectOptions): Promise<ConnectResult>;
    disconnect(): Promise<null>;
    isConnected(): Promise<ConnectResult>;
    status(): Promise<StatusEvent>;
    listAccounts(): Promise<ListAccountsResult>;
    prepareExecute(params: PrepareExecuteParams): Promise<null>;
    prepareExecuteAndWait(params: PrepareExecuteParams): Promise<PrepareExecuteAndWaitResult>;
    signMessage(params: SignMessageParams): Promise<SignMessageResult>;
    ledgerApi(params: LedgerApiParams): Promise<LedgerApiResult>;
    open(): Promise<void>;
    onStatusChanged(listener: EventListener<StatusEvent>): Promise<void>;
    onAccountsChanged(listener: EventListener<AccountsChangedEvent>): Promise<void>;
    onConnected(listener: EventListener<StatusEvent>): Promise<void>;
    onTxChanged(listener: EventListener<TxChangedEvent>): Promise<void>;
    onMessageSignature(listener: EventListener<MessageSignatureEvent>): Promise<void>;
    removeOnStatusChanged(listener: EventListener<StatusEvent>): Promise<void>;
    removeOnAccountsChanged(listener: EventListener<AccountsChangedEvent>): Promise<void>;
    removeOnConnected(listener: EventListener<StatusEvent>): Promise<void>;
    removeOnTxChanged(listener: EventListener<TxChangedEvent>): Promise<void>;
    removeOnMessageSignature(listener: EventListener<MessageSignatureEvent>): Promise<void>;
}
export declare const sdk: DappSDK;
/**
 * Opens the wallet picker and connects. Prefer {@link init} with adapters at startup;
 * `options` here is a legacy convenience that forwards to {@link DappSDK.init}.
 */
export declare function connect(): Promise<ConnectResult>;
/** @deprecated Pass options to `init()` instead. */
export declare function connect(options: DappSDKConnectOptions): Promise<ConnectResult>;
export declare const init: (options?: DappSDKConnectOptions) => Promise<void>;
export declare const disconnect: () => Promise<null>;
export declare const isConnected: () => Promise<ConnectResult>;
export declare const status: () => Promise<StatusEvent>;
export declare const listAccounts: () => Promise<ListAccountsResult>;
export declare const prepareExecute: (params: PrepareExecuteParams) => Promise<null>;
export declare const prepareExecuteAndWait: (params: PrepareExecuteParams) => Promise<PrepareExecuteAndWaitResult>;
export declare const ledgerApi: (params: LedgerApiParams) => Promise<LedgerApiResult>;
export declare const open: () => Promise<void>;
export declare const getConnectedProvider: () => ReturnType<DappSDK["getConnectedProvider"]>;
export declare const onStatusChanged: (listener: EventListener<StatusEvent>) => Promise<void>;
export declare const onAccountsChanged: (listener: EventListener<AccountsChangedEvent>) => Promise<void>;
export declare const onConnected: (listener: EventListener<StatusEvent>) => Promise<void>;
export declare const onTxChanged: (listener: EventListener<TxChangedEvent>) => Promise<void>;
export declare const onMessageSignature: (listener: EventListener<MessageSignatureEvent>) => Promise<void>;
export declare const removeOnStatusChanged: (listener: EventListener<StatusEvent>) => Promise<void>;
export declare const removeOnAccountsChanged: (listener: EventListener<AccountsChangedEvent>) => Promise<void>;
export declare const removeOnConnected: (listener: EventListener<StatusEvent>) => Promise<void>;
export declare const removeOnTxChanged: (listener: EventListener<TxChangedEvent>) => Promise<void>;
export declare const removeOnMessageSignature: (listener: EventListener<MessageSignatureEvent>) => Promise<void>;
//# sourceMappingURL=sdk.d.ts.map