@bounded-sh/client 0.0.17 → 0.0.19

package/README.md

@@ -147,6 +147,8 @@ The `set` and `get` functions automatically handle whether data is stored **on-c
 
 - Transactions are handled automatically, and users may be prompted to approve blockchain transactions.
 
+- On-chain transactions require an explicit Solana RPC URL in `init({ rpcUrl })`; the SDK does not choose a bundled mainnet/devnet RPC when this is omitted.
+
 **Off-Chain Data:**
 
 - If the data path corresponds to off-chain storage, the `set` function will store data off-chain.
@@ -295,4 +297,3 @@ This Tarobase JS SDK project is licensed under the MIT License.
   
 
 Thank you for using the Tarobase JS SDK! If you have any questions or need further assistance, feel free to crete an issue.
-

package/dist/auth/index.d.ts

@@ -1,6 +1,6 @@
 import { AuthProvider, User, ClientConfig } from "@bounded-sh/core";
 /**
- * Clears the session if it was created before auth method tracking (legacy session).
+ * Clears the session if it was created by a different auth method.
  * Returns true if the session was cleared, false if the session is compatible.
  *
  * Dispatches to the correct session manager based on the current auth method
@@ -8,9 +8,7 @@ import { AuthProvider, User, ClientConfig } from "@bounded-sh/core";
  * are properly cleared.
  */
 export declare function clearIncompatibleSession(): boolean;
-export declare const SOLANA_DEVNET_RPC_URL = "https://idelle-8nxsep-fast-devnet.helius-rpc.com";
-export declare const SOLANA_MAINNET_RPC_URL = "https://celestia-cegncv-fast-mainnet.helius-rpc.com";
-export declare const SURFNET_RPC_URL = "https://surfpool.fly.dev";
+export { SOLANA_DEVNET_RPC_URL, SOLANA_MAINNET_RPC_URL, SURFNET_RPC_URL, } from "./solana-rpc";
 export declare function getAuthProvider(config?: Partial<ClientConfig>): Promise<AuthProvider>;
 /** Per-call overrides forwarded to the active auth provider's modal. */
 export interface LoginOptions {

package/dist/auth/providers/mock-auth-provider.d.ts

@@ -23,7 +23,6 @@ export declare class MockAuthProvider implements AuthProvider {
      */
     signMessage(message: string): Promise<string>;
     signMessageMock(message: string): Promise<string>;
-    private generateOffchainSignature;
     /**
      * Mock transaction signing - returns the transaction as-is (no actual signing)
      */

package/dist/auth/providers/offchain-auth-provider.d.ts

@@ -9,9 +9,9 @@ export interface OffchainAuthProviderConfig {
 /**
  * OffchainAuthProvider wraps a real auth provider (e.g., Phantom) for the poofnet environment.
  *
- * For signMessageMock, this shows a custom confirmation modal and generates a mock signature.
- * This is used for offchain transaction signing. For real wallet signing, use signMessage
- * which delegates to the wrapped provider.
+ * For signMessageMock, this shows a custom confirmation modal and then delegates
+ * to the wrapped provider for a real detached signature over the exact offchain
+ * transaction message.
  */
 export declare class OffchainAuthProvider implements AuthProvider {
     private wrappedProvider;
@@ -46,5 +46,4 @@ export declare class OffchainAuthProvider implements AuthProvider {
     private buildTransactionModalContent;
     private buildInstructionElement;
     private getModalStyles;
-    private generateMockSignature;
 }

package/dist/auth/providers/phantom-wallet-provider.d.ts

@@ -33,6 +33,7 @@ export declare class PhantomWalletProvider implements AuthProvider {
     private static instance;
     private containerElement;
     private networkUrl;
+    private configuredNetwork;
     private root;
     private phantomMethods;
     private config;
@@ -46,13 +47,13 @@ export declare class PhantomWalletProvider implements AuthProvider {
     setLoginOverrides(opts: LoginOptions | null): void;
     /** Callback to swap to a Mobile Wallet Adapter provider when the user clicks "Connect Mobile Wallet" */
     onSwitchToMWA: (() => Promise<AuthProvider>) | null;
-    constructor(networkUrl?: string | null, config?: PhantomWalletConfig);
+    constructor(networkUrl?: string | null, config?: PhantomWalletConfig, configuredNetwork?: string | null);
     private initializeAsync;
     /**
      * Check if social login providers are configured (non-injected providers).
      */
     private hasSocialProviders;
-    static getInstance(networkUrl: string | null, config: PhantomWalletConfig): PhantomWalletProvider;
+    static getInstance(networkUrl: string | null, config: PhantomWalletConfig, configuredNetwork?: string | null): PhantomWalletProvider;
     private resolveProviders;
     /**
      * Patch the Phantom extension's provider to gracefully handle `phantom_getFeatures`

package/dist/auth/providers/privy-wallet-provider.d.ts

@@ -1,25 +1,26 @@
 import type { EVMTransaction, SolTransaction, TransactionResult, AuthProvider, User, SetOptions } from '@bounded-sh/core';
 import { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
+type PrivyWalletConfig = {
+    appId: string;
+    config: any;
+};
 export declare class PrivyWalletProvider implements AuthProvider {
     private static instance;
     private containerElement;
     private networkUrl;
+    private configuredNetwork;
     private chainId;
     private root;
     private privyMethods;
     private privyConfig;
     private pendingLogin;
-    private rpcDevnetUrl;
-    private rpcMainnetUrl;
+    private configuredRpcUrl;
     private pendingTransaction;
     private pendingSignTransaction;
     private pendingSignMessage;
     private pendingSignAndSubmitTransaction;
-    constructor(appName: string | null, appLogoUrl: string | null, privyConfig?: {
-        appId: string;
-        config: any;
-    }, networkUrl?: string | null);
-    static getInstance(appName: string | null, appLogoUrl: string | null, privyConfig: any): PrivyWalletProvider;
+    constructor(appName: string | null, appLogoUrl: string | null, privyConfig: PrivyWalletConfig | undefined, networkUrl?: string | null, configuredNetwork?: string | null);
+    static getInstance(appName: string | null, appLogoUrl: string | null, privyConfig: PrivyWalletConfig, networkUrl?: string | null, configuredNetwork?: string | null): PrivyWalletProvider;
     private initialize;
     login(): Promise<User | null>;
     getNativeMethods(): Promise<any>;
@@ -51,6 +52,7 @@ export declare class PrivyWalletProvider implements AuthProvider {
      */
     signAndSubmitTransaction(transaction: Transaction | VersionedTransaction, feePayer?: PublicKey): Promise<string>;
     private getRpcUrl;
+    private getChainId;
     /**
      * Internal sign transaction - serializes and signs via Privy
      * Returns the raw result from Privy (Uint8Array)
@@ -80,3 +82,4 @@ export declare class PrivyWalletProvider implements AuthProvider {
     private waitForMatchingWallet;
     private ensureReady;
 }
+export {};

package/dist/auth/providers/solana-mobile-wallet-provider.d.ts

@@ -73,14 +73,15 @@ export declare function registerMobileWalletAdapter(config?: {
 export declare class SolanaMobileWalletProvider implements AuthProvider {
     private static instance;
     private networkUrl;
+    private configuredNetwork;
     private config;
     private appIdentity;
     /** Raw cluster name (e.g. 'mainnet-beta'); mapped via mapChainToWalletStandard. */
     private cluster;
     /** LocalSolanaMobileWalletAdapterWallet, lazy-constructed in ensureWallet(). */
     private wallet;
-    constructor(networkUrl?: string | null, config?: SolanaMobileWalletConfig);
-    static getInstance(networkUrl: string | null, config: SolanaMobileWalletConfig): SolanaMobileWalletProvider;
+    constructor(networkUrl?: string | null, config?: SolanaMobileWalletConfig, configuredNetwork?: string | null);
+    static getInstance(networkUrl: string | null, config: SolanaMobileWalletConfig, configuredNetwork?: string | null): SolanaMobileWalletProvider;
     /** Lazy-construct LocalSolanaMobileWalletAdapterWallet on first need. */
     private ensureWallet;
     /**

package/dist/auth/solana-rpc.d.ts

@@ -0,0 +1,8 @@
+export declare const SOLANA_DEVNET_RPC_URL = "https://idelle-8nxsep-fast-devnet.helius-rpc.com";
+export declare const SOLANA_MAINNET_RPC_URL = "https://celestia-cegncv-fast-mainnet.helius-rpc.com";
+export declare const SURFNET_RPC_URL = "https://surfpool.fly.dev";
+export type SolanaRpcNetwork = "solana_devnet" | "solana_mainnet" | "surfnet";
+export declare function normalizeSolanaRpcUrl(rpcUrl: string | null | undefined): string | null;
+export declare function isSupportedSolanaRpcNetwork(network: string | null | undefined): network is SolanaRpcNetwork;
+export declare function resolveSolanaWalletStandardChain(network: string | null | undefined, context: string): string;
+export declare function resolveSolanaRpcUrl(explicitRpcUrl: string | null | undefined, network: string | null | undefined, context: string): string;