@dogeos/dogeos-sdk 4.0.6-beta.2 → 4.0.7-beta.0

package/dist/index.d.ts

@@ -206,6 +206,16 @@ export declare type DogeOSEmbeddedWalletInitConfig = Omit<EmbeddedWalletConfig,
     stage: EmbeddedWalletStage;
 };
 
+/**
+ * Thrown inside MyDoge for a call that would open a web sign-in popup, such
+ * as `useDogeOSAuth().login()` or `reauthenticate()`. Use `signInWithWallet()`
+ * there instead.
+ */
+export declare class DogeOSHostError extends Error {
+    readonly code: "unavailable_in_native_host";
+    constructor(message: string);
+}
+
 /**
  * An email flow plus its original delivery verifier. Keep this object in
  * volatile memory only. If its runtime is interrupted, discard it and surface
@@ -362,8 +372,40 @@ export declare function getConnectors(): Promise<WalletConfig[]>;
 
 export declare type GetConnectorsReturnType = Promise<WalletConfig[]>;
 
+/**
+ * The href for a link to another dApp: the `mydoge://dapp` link inside MyDoge,
+ * so the target gets its own wallet session, and `targetUrl` itself elsewhere.
+ * It validates `targetUrl` the same way in both cases.
+ */
+export declare function getDappHref(targetUrl: string, { inMyDoge }: {
+    inMyDoge: boolean;
+}): string;
+
+/**
+ * Build the `mydoge://dapp` link that opens `targetUrl` as its own dApp session
+ * in MyDoge (3.1.1 build 652 or later). `targetUrl` is the complete, unencoded
+ * https URL. It is normalized by the URL parser (so stray whitespace or an
+ * unescaped space can't make MyDoge reject the link) and then encoded once.
+ */
+export declare function getMyDogeDappLink(targetUrl: string): string;
+
 declare const idBrand: unique symbol;
 
+/**
+ * Resolve whether this page runs inside the MyDoge mobile app's in-app browser.
+ * It asks for EIP-6963 providers and waits for one announcing {@link MYDOGE_APP_RDNS},
+ * resolving `false` after `timeoutMs` or when there is no `window` (SSR).
+ */
+export declare function isInMyDogeBrowser(timeoutMs?: number): Promise<boolean>;
+
+/**
+ * True when `error` is a wallet provider error, optionally with a given code.
+ * Use it for errors from `connect`, `switchChain`, signing, and provider requests.
+ */
+export declare function isWalletError(error: unknown, code?: WalletErrorCode): error is Error & {
+    code: number;
+};
+
 declare type LoginOptions = {
     provider: "email";
     email: string;
@@ -388,6 +430,13 @@ export declare enum ModalView {
     WalletHome = "WALLET_HOME"
 }
 
+export declare interface PreferredConnectOptions {
+    /** Chain family to connect. Defaults to `defaultConnectChain`, then the first configured family the wallet has. */
+    chainType?: ChainType;
+    /** Chain to switch to after connecting, as in `connect()`. In a browser it applies when adding a chain family to a connected wallet; a wallet picked in the modal keeps the modal's own choice. */
+    chainId?: string;
+}
+
 declare interface ProviderConnectionInfo {
     chainType: ChainTypeEnum;
     connected: boolean;
@@ -506,6 +555,27 @@ export declare type UseWalletConnect = {
 
 export declare const useWalletConnect: () => UseWalletConnect;
 
+export declare type UseWalletHost = {
+    /** `"mydoge"` inside the MyDoge dApp browser, otherwise `"browser"`. */
+    host: WalletHost;
+    /** True inside MyDoge, where every wallet request is answered by the native app and the SDK shows no wallet UI. */
+    isNativeHost: boolean;
+    /**
+     * Connects the wallet that fits the host and resolves with the account.
+     * Inside MyDoge it asks the native wallet directly. In a browser it opens the
+     * connect modal and settles when a wallet connects or the modal closes.
+     * Resolves at once when a wallet is already connected.
+     */
+    connect: (options?: PreferredConnectOptions) => Promise<ConnectData>;
+};
+
+/**
+ * Reports whether the dApp is running inside MyDoge and offers a connect call
+ * that works in both places. Inside MyDoge the SDK never renders its own
+ * wallet UI: `openModal()` and this `connect()` ask the native wallet instead.
+ */
+export declare const useWalletHost: () => UseWalletHost;
+
 /**
  * Embedded wallet connect component that renders the modal content with proper context
  * Uses a hidden Modal wrapper to provide required Modal context for UI components
@@ -620,6 +690,24 @@ declare interface WalletConnectProviderProps {
     config: WalletConnectKitConfig;
 }
 
+/**
+ * EIP-1193 provider error codes, plus 4902 for a chain the wallet does not
+ * know (the code `wallet_switchEthereumChain` uses by convention).
+ */
+export declare const WalletErrorCode: {
+    readonly UserRejected: 4001;
+    readonly Unauthorized: 4100;
+    readonly UnsupportedMethod: 4200;
+    readonly Disconnected: 4900;
+    readonly ChainDisconnected: 4901;
+    readonly UnsupportedChain: 4902;
+};
+
+export declare type WalletErrorCode = (typeof WalletErrorCode)[keyof typeof WalletErrorCode];
+
+/** Where the SDK is running: an ordinary browser, or MyDoge's dApp browser. */
+export declare type WalletHost = "browser" | "mydoge";
+
 export { WalletInfo }
 
 export { WalletProvider }