@meshconnect/uwc-types 0.2.0

package/dist/UWC-state.d.ts

@@ -0,0 +1,62 @@
+import type { NetworkId, Namespace } from './networks';
+import type { Session } from './session';
+export interface UniversalWalletConnectorState {
+    session: Session;
+}
+export interface DetectedEIP6963WalletInfo {
+    uuid: string;
+    name: string;
+    icon: string;
+    rdns: string;
+}
+export interface DetectedSolanaWalletInfo {
+    uuid: string;
+    name: string;
+    features: string[];
+}
+export interface Eip155Metadata {
+    eip155Name: string;
+    injectedId: string;
+    supportsAddingNetworks: boolean;
+    requiresUserApprovalOnNetworkSwitch: boolean;
+    installed?: boolean;
+    detectedWallet?: DetectedEIP6963WalletInfo;
+}
+export interface SolanaMetadata {
+    walletStandardName?: string;
+    injectedId?: string;
+    ignoredInjectedIds?: string[];
+    installed?: boolean;
+    detectedWallet?: DetectedSolanaWalletInfo;
+}
+type NamespaceMetaDataMap = {
+    [K in Namespace]?: K extends 'eip155' ? Eip155Metadata : K extends 'solana' ? SolanaMetadata : undefined;
+};
+export interface ExtensionInjectedProvider {
+    supportedNetworkIds: NetworkId[];
+    namespaceMetaData: Partial<NamespaceMetaDataMap>;
+    requiresUserApprovalOnNamespaceSwitch: boolean;
+}
+export interface IntegratedBrowserInjectedProvider extends ExtensionInjectedProvider {
+    integratedBrowserDeeplink: string;
+}
+export type DeeplinkType = 'universal' | 'native';
+export interface WalletConnectProvider {
+    supportedNetworkIds: NetworkId[];
+    deeplinks: {
+        universal: string;
+        native: string;
+        androidPreferredDeeplink?: DeeplinkType;
+        iOSPreferredDeeplink?: DeeplinkType;
+    };
+}
+export interface WalletMetadata {
+    id: string;
+    name: string;
+    metadata: Record<string, any>;
+    extensionInjectedProvider?: ExtensionInjectedProvider;
+    integratedBrowserInjectedProvider?: IntegratedBrowserInjectedProvider;
+    walletConnectProvider?: WalletConnectProvider;
+}
+export {};
+//# sourceMappingURL=UWC-state.d.ts.map

package/dist/UWC-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UWC-state.d.ts","sourceRoot":"","sources":["../src/UWC-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,sBAAsB,EAAE,OAAO,CAAA;IAC/B,mCAAmC,EAAE,OAAO,CAAA;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,wBAAwB,CAAA;CAC1C;AAED,KAAK,oBAAoB,GAAG;KACzB,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,GACjC,cAAc,GACd,CAAC,SAAS,QAAQ,GAChB,cAAc,GACd,SAAS;CAChB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,SAAS,EAAE,CAAA;IAChC,iBAAiB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAChD,qCAAqC,EAAE,OAAO,CAAA;CAC/C;AAED,MAAM,WAAW,iCACf,SAAQ,yBAAyB;IACjC,yBAAyB,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,SAAS,EAAE,CAAA;IAChC,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,wBAAwB,CAAC,EAAE,YAAY,CAAA;QACvC,oBAAoB,CAAC,EAAE,YAAY,CAAA;KACpC,CAAA;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IAEZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,yBAAyB,CAAC,EAAE,yBAAyB,CAAA;IACrD,iCAAiC,CAAC,EAAE,iCAAiC,CAAA;IACrE,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;CAC9C"}

package/dist/UWC-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UWC-state.js.map

package/dist/UWC-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UWC-state.js","sourceRoot":"","sources":["../src/UWC-state.ts"],"names":[],"mappings":""}

package/dist/connection-mode.d.ts

@@ -0,0 +1,2 @@
+export type ConnectionMode = 'injected' | 'walletConnect';
+//# sourceMappingURL=connection-mode.d.ts.map

package/dist/connection-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-mode.d.ts","sourceRoot":"","sources":["../src/connection-mode.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,CAAA"}

package/dist/connection-mode.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-mode.js.map

package/dist/connection-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-mode.js","sourceRoot":"","sources":["../src/connection-mode.ts"],"names":[],"mappings":""}

package/dist/connector.d.ts

@@ -0,0 +1,76 @@
+import type { Network, NetworkId, Namespace } from './networks';
+import type { AvailableAddress } from './session';
+import type { DetectedEIP6963WalletInfo, DetectedSolanaWalletInfo, ExtensionInjectedProvider, IntegratedBrowserInjectedProvider, WalletConnectProvider } from './UWC-state';
+import type { TransactionRequest, TransactionResult } from './transactions';
+/**
+ * Result interface for connect operations
+ */
+export interface ConnectorResult {
+    networkId: NetworkId;
+    address: string;
+    availableAddresses: AvailableAddress[];
+}
+/**
+ * Result interface for network switch operations
+ */
+export interface SwitchNetworkResult {
+    networkId: NetworkId;
+    address: string;
+    availableAddresses?: AvailableAddress[];
+}
+/**
+ * Common interface for all wallet connectors
+ */
+export interface Connector {
+    /**
+     * Connect to a wallet on the specified network
+     * @param network The network to connect to
+     * @param args Additional arguments specific to the connector type
+     * @returns A promise that resolves to a ConnectorResult containing the network ID, wallet address, and available addresses
+     */
+    connect(network: Network, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider): Promise<ConnectorResult>;
+    /**
+     * Get the connection URI for the wallet, if applicable
+     * This is typically used for WalletConnect or similar protocols
+     * to allow the user to scan a QR code or open a link
+     * to initiate the connection.
+     * @return A string representing the connection URI, or undefined if not applicable
+     * @remarks This method is optional and may not be implemented by all connectors.
+     */
+    getConnectionURI?(): string;
+    /**
+     * Disconnect from the wallet
+     * This method is optional and may not be implemented by all connectors.
+     * @returns A promise that resolves when the disconnection is complete
+     */
+    disconnect?(): Promise<void>;
+    /**
+     * Switch to a different network
+     * @param network The network to switch to
+     * @param args Additional arguments specific to the connector type
+     * @returns A promise that resolves to a SwitchNetworkResult containing the network ID and new wallet address
+     */
+    switchNetwork(network: Network, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider): Promise<SwitchNetworkResult>;
+    /**
+     * Get available wallets for a specific namespace
+     * This method is optional and may not be implemented by all connectors.
+     * @param namespace The namespace to check for available wallets (e.g., 'eip155', 'solana')
+     * @returns A promise that resolves to an array of detected wallets, or undefined if not supported
+     */
+    getAvailableWallets?(namespace: Namespace): Promise<DetectedEIP6963WalletInfo[] | DetectedSolanaWalletInfo[]>;
+    /**
+     * Sign a message with the connected wallet
+     * @param message The message to sign
+     * @param provider The wallet provider (required for injected connector)
+     * @returns A promise that resolves to the signature
+     */
+    signMessage?(message: string, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider): Promise<string>;
+    /**
+     * Send a transaction with the connected wallet
+     * @param request The transaction request parameters
+     * @param provider The wallet provider (required for injected connector)
+     * @returns A promise that resolves to the transaction result
+     */
+    sendTransaction?(request: TransactionRequest, provider?: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider): Promise<TransactionResult>;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,EACtB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IAEH,OAAO,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,MAAM,CAAA;IAE3B;;;;OAIG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5B;;;;;OAKG;IAEH,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAE/B;;;;;OAKG;IACH,mBAAmB,CAAC,CAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,yBAAyB,EAAE,GAAG,wBAAwB,EAAE,CAAC,CAAA;IAEpE;;;;;OAKG;IACH,WAAW,CAAC,CACV,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACxB,OAAO,CAAC,MAAM,CAAC,CAAA;IAElB;;;;;OAKG;IACH,eAAe,CAAC,CACd,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,CAAC,EACL,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAC9B"}

package/dist/connector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export type ErrorType = 'unknown' | 'rejected';
+export interface WalletError {
+    type: ErrorType;
+    message: string;
+}
+/**
+ * Custom error class that includes wallet error metadata
+ * This is thrown by the connectors when operations fail
+ */
+export declare class WalletConnectorError extends Error {
+    type: ErrorType;
+    constructor(walletError: WalletError);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,IAAI,EAAE,SAAS,CAAA;gBAEH,WAAW,EAAE,WAAW;CAKrC"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+/**
+ * Custom error class that includes wallet error metadata
+ * This is thrown by the connectors when operations fail
+ */
+export class WalletConnectorError extends Error {
+    type;
+    constructor(walletError) {
+        super(walletError.message);
+        this.name = 'WalletConnectorError';
+        this.type = walletError.type;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,IAAI,CAAW;IAEf,YAAY,WAAwB;QAClC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './networks';
+export * from './network-rpc';
+export * from './connection-mode';
+export * from './session';
+export * from './UWC-state';
+export * from './connector';
+export * from './providers';
+export * from './wallet-connect-connector';
+export * from './react-hooks';
+export * from './signature';
+export * from './transactions';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './networks';
+export * from './network-rpc';
+export * from './connection-mode';
+export * from './session';
+export * from './UWC-state';
+export * from './connector';
+export * from './providers';
+export * from './wallet-connect-connector';
+export * from './react-hooks';
+export * from './signature';
+export * from './transactions';
+export * from './errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}

package/dist/network-rpc.d.ts

@@ -0,0 +1,6 @@
+import type { NetworkId } from './networks';
+/**
+ * Map of network IDs to their RPC URLs
+ */
+export type NetworkRpcMap = Partial<Record<NetworkId, string>>;
+//# sourceMappingURL=network-rpc.d.ts.map

package/dist/network-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-rpc.d.ts","sourceRoot":"","sources":["../src/network-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA"}

package/dist/network-rpc.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=network-rpc.js.map

package/dist/network-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-rpc.js","sourceRoot":"","sources":["../src/network-rpc.ts"],"names":[],"mappings":""}

package/dist/networks.d.ts

@@ -0,0 +1,33 @@
+export type NetworkId = 'eip155:1' | 'eip155:11155111' | 'solana:devnet' | 'eip155:56' | 'eip155:137' | 'eip155:43114' | 'eip155:42161' | 'eip155:10' | 'eip155:8453' | 'bip122:000000000019d6689c085ae165831e93' | 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp' | 'tron:0x2b6653dc' | 'eip155:81457' | 'bip122:1a91e3dace36e2be3bf030a65679fe82' | 'xrpl:0' | 'bip122:12a765e31ffd4059bada1e25190f6e98';
+export type NetworkType = 'evm' | 'solana' | 'bitcoin' | 'tron' | 'dogecoin' | 'litecoin' | 'ripple';
+export type Namespace = 'eip155' | 'solana' | 'bip122' | 'tron' | 'xrpl';
+export interface NativeCurrency {
+    name: string;
+    symbol: string;
+    decimals: number;
+}
+export interface RpcUrls {
+    default: {
+        http: string[];
+    };
+}
+export interface BlockExplorer {
+    name: string;
+    url: string;
+    apiUrl?: string;
+}
+export interface BlockExplorers {
+    default: BlockExplorer;
+}
+export interface Network {
+    internalId: number;
+    id: NetworkId;
+    namespace: Namespace;
+    name: string;
+    logoUrl: string;
+    nativeCurrency: NativeCurrency;
+    rpcUrls?: RpcUrls;
+    blockExplorers?: BlockExplorers;
+    networkType: NetworkType;
+}
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,YAAY,GACZ,cAAc,GACd,cAAc,GACd,WAAW,GACX,aAAa,GACb,yCAAyC,GACzC,yCAAyC,GACzC,iBAAiB,GACjB,cAAc,GACd,yCAAyC,GACzC,QAAQ,GACR,yCAAyC,CAAA;AAE7C,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,CAAA;AAEZ,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAExE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,EAAE,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,SAAS,CAAA;IACb,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,WAAW,EAAE,WAAW,CAAA;CACzB"}

package/dist/networks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.js","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":""}

package/dist/providers.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionInjectedProvider, IntegratedBrowserInjectedProvider, WalletConnectProvider } from './UWC-state';
+/**
+ * Union type of all supported provider types
+ * Used throughout the application to handle different wallet provider types
+ */
+export type SupportedProvider = ExtensionInjectedProvider | IntegratedBrowserInjectedProvider | WalletConnectProvider;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EACjC,qBAAqB,EACtB,MAAM,aAAa,CAAA;AAEpB;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,yBAAyB,GACzB,iCAAiC,GACjC,qBAAqB,CAAA"}

package/dist/providers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":""}

package/dist/react-hooks.d.ts

@@ -0,0 +1,231 @@
+import type { NetworkId, Network, ConnectionMode, Session, AvailableAddress, TransactionRequest, TransactionResult, WalletError } from './index';
+/**
+ * WalletConnect connection interface for the useConnection hook
+ */
+export interface WalletConnectConnection {
+    /**
+     * Connects to the specified wallet using WalletConnect protocol
+     * @param networkId - Optional network ID to connect to. If not provided, uses the default network
+     * @returns Promise that resolves when connection is established
+     */
+    connect: (networkId?: NetworkId) => Promise<void>;
+    /**
+     * The WalletConnect connection URI for QR code display
+     * Will be undefined if not using WalletConnect or if connection is already established
+     */
+    connectionURI: string | undefined;
+    /**
+     * Indicates if the WalletConnect connection is currently being established
+     */
+    isLoading: boolean;
+    /**
+     * Error from the last connection attempt, undefined if no error occurred
+     */
+    error: WalletError | undefined;
+    /**
+     * Indicates if WalletConnect is currently available for use
+     * This depends on whether the wallet supports WalletConnect
+     */
+    available: boolean;
+}
+/**
+ * Injected wallet connection interface for the useConnection hook
+ */
+export interface InjectedConnection {
+    /**
+     * Connects to the specified wallet using browser injection (MetaMask, Trust Wallet, etc.)
+     * @param networkId - Optional network ID to connect to. If not provided, uses the default network
+     * @returns Promise that resolves when connection is established
+     */
+    connect: (networkId?: NetworkId) => Promise<void>;
+    /**
+     * Indicates if the injected wallet connection is currently being established
+     */
+    isLoading: boolean;
+    /**
+     * Error from the last connection attempt, undefined if no error occurred
+     */
+    error: WalletError | undefined;
+    /**
+     * Indicates if injected connection is currently available for use
+     */
+    available: boolean;
+}
+/**
+ * Return type for the useConnection hook
+ * @example
+ * ```tsx
+ * const { walletConnect, injected } = useConnection('metamask')
+ *
+ * // Connect with WalletConnect
+ * await walletConnect.connect('eip155:1')
+ * console.log(walletConnect.connectionURI) // Display QR code
+ *
+ * // Connect with injected wallet
+ * await injected.connect('eip155:1')
+ * ```
+ */
+export interface UseConnectionReturn {
+    /**
+     * WalletConnect connection methods and state
+     */
+    walletConnect: WalletConnectConnection;
+    /**
+     * Injected wallet connection methods and state
+     */
+    injected: InjectedConnection;
+    /**
+     * Indicates if wallet detection has completed and the connector is ready to use
+     */
+    isReady: boolean;
+}
+/**
+ * Return type for the useSession hook
+ * Provides access to the current wallet session state
+ * @example
+ * ```tsx
+ * const { activeAddress, activeNetwork, session } = useSession()
+ *
+ * if (activeAddress) {
+ *   console.log(`Connected to ${activeNetwork?.name} with ${activeAddress}`)
+ * }
+ * ```
+ */
+export interface UseSessionReturn {
+    /**
+     * The complete session object containing all wallet connection state
+     */
+    session: Session;
+    /**
+     * The currently connected wallet address, or null if not connected
+     */
+    activeAddress: string | null;
+    /**
+     * The currently selected network, or null if not connected
+     */
+    activeNetwork: Network | null;
+    /**
+     * List of networks available for the connected wallet
+     */
+    availableNetworks: Network[];
+    /**
+     * The active connection mode ('injected' or 'walletConnect'), or null if not connected
+     */
+    activeConnector: ConnectionMode | null;
+    /**
+     * List of available addresses for the connected wallet
+     */
+    availableAddresses: AvailableAddress[];
+}
+/**
+ * Return type for the useSwitchNetwork hook
+ * Provides network switching functionality with loading states
+ * @example
+ * ```tsx
+ * const { switchNetwork, isLoading, isWaitingForUserApproval } = useSwitchNetwork()
+ *
+ * const handleNetworkSwitch = async () => {
+ *   await switchNetwork('eip155:8453') // Switch to Base
+ *
+ *   if (isWaitingForUserApproval) {
+ *     console.log('Waiting for user to approve in wallet...')
+ *   }
+ * }
+ * ```
+ */
+export interface UseSwitchNetworkReturn {
+    /**
+     * Switches the connected wallet to the specified network
+     * @param networkId - The ID of the network to switch to (e.g., 'eip155:1' for Ethereum mainnet)
+     * @returns Promise that resolves when the network switch is complete
+     * @throws Error if network switch fails or is rejected by the user
+     */
+    switchNetwork: (networkId: NetworkId) => Promise<void>;
+    /**
+     * Indicates if a network switch operation is currently in progress
+     */
+    isLoading: boolean;
+    /**
+     * Indicates if the wallet is waiting for user approval to switch networks
+     * This depends on the wallet's metadata configuration (requiresUserApprovalOnNetworkSwitch)
+     */
+    isWaitingForUserApproval: boolean;
+    /**
+     * Error from the last network switch attempt, undefined if no error occurred
+     */
+    error: WalletError | undefined;
+}
+/**
+ * Return type for the useSignMessage hook
+ * Provides message signing functionality with loading state and signature result
+ * @example
+ * ```tsx
+ * const { signMessage, isLoading, signature } = useSignMessage()
+ *
+ * const handleSign = async () => {
+ *   const sig = await signMessage('Hello World')
+ *   console.log('Signature:', sig)
+ *   // The signature state will also contain the result
+ * }
+ * ```
+ */
+export interface UseSignMessageReturn {
+    /**
+     * Signs a message with the connected wallet
+     * @param message - The message to sign
+     * @returns Promise that resolves to the signature string
+     * @throws Error if no wallet is connected or signing fails
+     */
+    signMessage: (message: string) => Promise<string>;
+    /**
+     * Indicates if a message signing operation is currently in progress
+     */
+    isLoading: boolean;
+    /**
+     * The last signature result, undefined if no message has been signed yet
+     */
+    signature: string | undefined;
+    /**
+     * Error from the last signing attempt, undefined if no error occurred
+     */
+    error: WalletError | undefined;
+}
+/**
+ * Return type for the useTransaction hook
+ * Provides transaction sending functionality with loading state and result
+ * @example
+ * ```tsx
+ * const { sendTransaction, isLoading, transactionResult } = useTransaction()
+ *
+ * const handleSend = async () => {
+ *   const result = await sendTransaction({
+ *     to: '0x...',
+ *     amount: BigInt('1000000000000000000'),
+ *     from: session.activeAddress
+ *   })
+ *   console.log('Transaction hash:', result.hash)
+ * }
+ * ```
+ */
+export interface UseTransactionReturn {
+    /**
+     * Sends a transaction with the connected wallet
+     * @param request - The transaction request object
+     * @returns Promise that resolves to the transaction result
+     * @throws Error if no wallet is connected or transaction fails
+     */
+    sendTransaction: (request: TransactionRequest) => Promise<TransactionResult>;
+    /**
+     * Indicates if a transaction is currently being processed
+     */
+    isLoading: boolean;
+    /**
+     * The last transaction result, undefined if no transaction has been sent yet
+     */
+    transactionResult: TransactionResult | undefined;
+    /**
+     * Error from the last transaction attempt, undefined if no error occurred
+     */
+    error: WalletError | undefined;
+}
+//# sourceMappingURL=react-hooks.d.ts.map

package/dist/react-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hooks.d.ts","sourceRoot":"","sources":["../src/react-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACZ,MAAM,SAAS,CAAA;AAIhB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,EAAE,uBAAuB,CAAA;IACtC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAA;IAC5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;OAEG;IACH,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B;;OAEG;IACH,iBAAiB,EAAE,OAAO,EAAE,CAAA;IAC5B;;OAEG;IACH,eAAe,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC;;OAEG;IACH,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAA;IACjC;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACjD;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5E;;OAEG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAChD;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;CAC/B"}

package/dist/react-hooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=react-hooks.js.map

package/dist/react-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hooks.js","sourceRoot":"","sources":["../src/react-hooks.ts"],"names":[],"mappings":""}

package/dist/session.d.ts

@@ -0,0 +1,16 @@
+import type { ConnectionMode } from './connection-mode';
+import type { Network, NetworkId } from './networks';
+import type { WalletMetadata } from './UWC-state';
+export interface AvailableAddress {
+    address: string;
+    networkId: NetworkId;
+}
+export interface Session {
+    connectionMode: ConnectionMode | null;
+    activeNetwork: Network | null;
+    activeAddress: string | null;
+    availableNetworks: Network[];
+    activeWallet: WalletMetadata | null;
+    availableAddresses: AvailableAddress[];
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;IACrC,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,iBAAiB,EAAE,OAAO,EAAE,CAAA;IAC5B,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;IACnC,kBAAkB,EAAE,gBAAgB,EAAE,CAAA;CACvC"}

package/dist/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":""}

package/dist/signature.d.ts

@@ -0,0 +1,28 @@
+import type { ExtensionInjectedProvider, IntegratedBrowserInjectedProvider } from './UWC-state';
+/**
+ * Result interface for signature operations
+ */
+export interface SignatureResult {
+    signature: string;
+    address: string;
+}
+/**
+ * Error types for signature operations
+ */
+export interface SignatureError {
+    code: number;
+    message: string;
+}
+/**
+ * Signature service interface
+ */
+export interface SignatureService {
+    /**
+     * Sign a message with the connected wallet
+     * @param message The message to sign
+     * @param provider The wallet provider to use for signing
+     * @returns A promise that resolves to the signature result
+     */
+    signMessage(message: string, provider: ExtensionInjectedProvider | IntegratedBrowserInjectedProvider): Promise<SignatureResult>;
+}
+//# sourceMappingURL=signature.d.ts.map

package/dist/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,yBAAyB,GAAG,iCAAiC,GACtE,OAAO,CAAC,eAAe,CAAC,CAAA;CAC5B"}