@bounded-sh/server 0.0.17 → 0.0.19

package/README.md

@@ -26,39 +26,29 @@ yarn add @tarobase/server
 ## Basic Usage
 
 ```typescript
-import { init, login, getCurrentUser, set, get } from '@tarobase/server';
-import { Keypair } from '@solana/web3.js';
+import { init, createWalletClient } from '@tarobase/server';
 
 async function main() {
-  // Initialize the SDK
+  // Initialize endpoints/app config only. Server signing identity is explicit.
   await init({
     apiKey: 'your-api-key',
     appId: 'your-app-id',
     authMethod: 'solana-keypair'
   });
 
-  // Create or load a Solana keypair
-  const keypair = Keypair.generate(); // or load from a file/secret
-  // Alternative: const keypair = "your-base58-encoded-private-key"
-
-  // Log in with the keypair
-  const user = await login(keypair);
-  if (!user) {
-    console.error('Login failed');
-    return;
-  }
-
-  console.log(`Logged in as: ${user.address}`);
+  // Create a wallet-scoped client from an explicit secret key.
+  const wallet = await createWalletClient({ keypair: process.env.SERVER_WALLET_KEYPAIR! });
+  console.log(`Using wallet: ${wallet.address}`);
 
   // Set data
-  await set('todos/123', { 
+  await wallet.set('todos/123', {
     text: 'Buy milk', 
     completed: false, 
     created: new Date().toISOString() 
   });
 
   // Get data
-  const todo = await get('todos/123');
+  const todo = await wallet.get('todos/123');
   console.log('Retrieved todo:', todo);
 }
 
@@ -70,44 +60,35 @@ main().catch(console.error);
 ### Loading a Keypair from a Secret Key File
 
 ```typescript
-import { init, login, getCurrentUser } from '@tarobase/server';
-import { Keypair } from '@solana/web3.js';
+import { init, createWalletClient } from '@tarobase/server';
 import * as fs from 'fs';
 
 // Load keypair from file
 const secretKeyString = fs.readFileSync('/path/to/keypair.json', 'utf8');
-const secretKey = Uint8Array.from(JSON.parse(secretKeyString));
-const keypair = Keypair.fromSecretKey(secretKey);
 
-// Initialize and login
+// Initialize and create a wallet-scoped client
 await init({ apiKey: 'your-api-key', appId: 'your-app-id' });
-await login(keypair);
+const wallet = await createWalletClient({ keypair: secretKeyString });
 ```
 
 ### Using the SolanaKeypairProvider Directly
 
 ```typescript
-import { init, SolanaKeypairProvider, getAuthProvider } from '@tarobase/server';
+import { init, SolanaKeypairProvider } from '@tarobase/server';
 import { Keypair } from '@solana/web3.js';
 
 // Initialize the SDK
 await init({
   apiKey: 'your-api-key',
   appId: 'your-app-id',
-  rpcUrl: 'https://api.mainnet-beta.solana.com'
+  rpcUrl: process.env.SOLANA_MAINNET_RPC_URL
 });
 
-// Get the auth provider (automatically created during init)
-const provider = await getAuthProvider() as SolanaKeypairProvider;
-
-// Or create a provider instance directly
-// const provider = new SolanaKeypairProvider("https://api.mainnet-beta.solana.com");
-
-// Set the keypair
-provider.setKeypair(Keypair.generate());
-
-// Login
-const user = await provider.login();
+// Create a provider instance directly with your RPC endpoint and keypair.
+const provider = new SolanaKeypairProvider(
+  "https://your-solana-rpc.example",
+  Keypair.generate()
+);
 
 // Sign a message
 const signature = await provider.signMessage("Hello, world!");
@@ -115,6 +96,7 @@ const signature = await provider.signMessage("Hello, world!");
 // Run a transaction (example)
 const txResult = await provider.runTransaction(undefined, {
   appId: 'your-app-id',
+  network: 'solana_mainnet',
   txArgs: [{
     setDocumentData: [{ path: 'todos/123', data: { text: 'New todo' } }],
     deletePaths: [],
@@ -127,22 +109,19 @@ const txResult = await provider.runTransaction(undefined, {
 ### Subscriptions
 
 ```typescript
-import { init, login, subscribe, unsubscribe } from '@tarobase/server';
-import { Keypair } from '@solana/web3.js';
+import { init, createWalletClient } from '@tarobase/server';
 
-// Initialize and login
+// Initialize and create an explicit wallet client
 await init({ apiKey: 'your-api-key', appId: 'your-app-id' });
-await login(Keypair.generate());
+const wallet = await createWalletClient({ keypair: process.env.SERVER_WALLET_KEYPAIR! });
 
 // Subscribe to changes
-const unsubscribeFunc = await subscribe('todos', (data) => {
+const unsubscribeFunc = await wallet.subscribe('todos', (data) => {
   console.log('Todos updated:', data);
 });
 
 // Later, unsubscribe when done
-unsubscribeFunc();
-// Or use the unsubscribe function
-await unsubscribe('todos');
+await unsubscribeFunc();
 ```
 
 ## API Reference
@@ -152,48 +131,44 @@ await unsubscribe('todos');
 ```typescript
 function init(config: Partial<ClientConfig>): Promise<void>;
 function getConfig(): Promise<ClientConfig>;
-function getSessionOptions(): SessionOptions;
-function isInitialized(): boolean;
-function waitForInitialization(): Promise<void>;
+function getWebhookKeysUrl(): string | undefined;
 ```
 
 ### Authentication
 
 ```typescript
-function login(keypair?: Keypair | string | Uint8Array): Promise<User | null>;
-function logout(): Promise<void>;
-function getCurrentUser(): User | null;
-function getAuthProvider(): Promise<AuthProvider>;
-function getIdToken(): Promise<string | null>;
+function createWalletClient(options: { keypair: string }): Promise<WalletClient>;
+function getAuthProvider(): Promise<AuthProvider>; // always rejects; no process-global provider
+function getIdToken(): Promise<string | null>; // always rejects; no process-global session
 ```
 
 ### Data Operations
 
 ```typescript
-function get(path: string): Promise<any>;
-function getMany(paths: string[], options?: { bypassCache?: boolean }): Promise<GetManyResult[]>;
-function set(path: string, data: any, options?: SetOptions): Promise<any>;
-function setMany(many: { path: string; document: any }[], options?: SetOptions): Promise<any>;
-function setFile(path: string, file: File, metadata?: any): Promise<any>;
-function getFiles(path: string): Promise<any>;
-function runQuery(queryString: string, variables?: any): Promise<any>;
-function runQueryMany(queryString: string, variables?: any): Promise<any>;
+const wallet = await createWalletClient({ keypair });
+await wallet.get(path);
+await wallet.getMany(paths);
+await wallet.set(path, data);
+await wallet.setMany(many);
+await wallet.setFile(path, file);
+await wallet.getFiles(path);
+await wallet.runQuery(absolutePath, queryName, queryArgs);
+await wallet.runQueryMany(many);
 ```
 
 ### Subscriptions
 
 ```typescript
-function subscribe(path: string, callback: (data: any) => void): Promise<() => void>;
-function unsubscribe(path: string): Promise<void>;
+const unsubscribe = await wallet.subscribe(path, callback);
+await unsubscribe();
 ```
 
 ### Solana Keypair Provider
 
 ```typescript
 class SolanaKeypairProvider implements AuthProvider {
-  constructor(networkUrl?: string);
-  
-  setKeypair(keypair: Keypair | string | Uint8Array): void;
+  constructor(rpcUrl: string | null, keypair: Keypair);
+
   login(): Promise<User | null>;
   logout(): Promise<void>;
   signMessage(message: string): Promise<string>;
@@ -203,6 +178,10 @@ class SolanaKeypairProvider implements AuthProvider {
 }
 ```
 
+`runTransaction` requires an explicit provider `rpcUrl` plus `solTransactionData.network`
+set to `solana_devnet`, `solana_mainnet`, or `surfnet`; missing RPCs and unknown/missing
+networks fail closed.
+
 ## Types
 
 ```typescript

package/dist/auth/index.d.ts

@@ -1,6 +1,2 @@
 import { AuthProvider } from '@bounded-sh/core';
-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 declare function getAuthProvider(): Promise<AuthProvider>;
-export declare function matchAuthProvider(rpcUrl: string | null): Promise<AuthProvider>;

package/dist/auth/providers/solana-keypair-provider.d.ts

@@ -2,10 +2,9 @@ import { Keypair, Transaction, VersionedTransaction } from '@solana/web3.js';
 import * as anchor from '@coral-xyz/anchor';
 import type { AuthProvider, EVMTransaction, SolTransaction, TransactionResult, User, SetOptions } from '@bounded-sh/core';
 export declare class SolanaKeypairProvider implements AuthProvider {
-    private readonly networkUrl;
-    private explicitKeypair?;
-    private cachedKeypair?;
-    constructor(networkUrl?: string | null, keypair?: Keypair);
+    private readonly rpcUrl;
+    private readonly serverKeypair;
+    constructor(rpcUrl: string | null, serverKeypair: Keypair);
     private get keypair();
     login(): Promise<User | null>;
     restoreSession(): Promise<User | null>;
@@ -17,7 +16,8 @@ export declare class SolanaKeypairProvider implements AuthProvider {
      *
      * This method handles blockhash and transaction confirmation automatically - you do NOT need to
      * set recentBlockhash or lastValidBlockHeight on the transaction before calling this method.
-     * The network/RPC URL is derived from the provider's configuration (set during initialization).
+     * Requires an explicit RPC URL configured on the provider because this method has no
+     * Solana transaction payload network to resolve.
      *
      * @param transaction - The transaction to sign and submit (Transaction or VersionedTransaction)
      * @param feePayer - Optional fee payer public key. If not provided and the transaction doesn't
@@ -31,6 +31,7 @@ export declare class SolanaKeypairProvider implements AuthProvider {
      * Shared by both signAndSubmitTransaction and runTransactionInner.
      */
     private submitAndConfirmTransaction;
+    private requireSupportedNetwork;
     private getRpcUrl;
     runTransaction(_evm?: EVMTransaction, sol?: SolTransaction, opts?: SetOptions): Promise<TransactionResult>;
     private runTransactionInner;

package/dist/explicit-client-only.d.ts

@@ -0,0 +1,28 @@
+export declare function get(..._args: unknown[]): Promise<never>;
+export declare function getMany(..._args: unknown[]): Promise<never>;
+export declare function set(..._args: unknown[]): Promise<never>;
+export declare function setMany(..._args: unknown[]): Promise<never>;
+export declare function setFile(..._args: unknown[]): Promise<never>;
+export declare function getFiles(..._args: unknown[]): Promise<never>;
+export declare function search(..._args: unknown[]): Promise<never>;
+export declare function queryAggregate(..._args: unknown[]): Promise<never>;
+export declare function runQuery(..._args: unknown[]): Promise<never>;
+export declare function runQueryMany(..._args: unknown[]): Promise<never>;
+export declare function runExpression(..._args: unknown[]): Promise<never>;
+export declare function runExpressionMany(..._args: unknown[]): Promise<never>;
+export declare function signMessage(..._args: unknown[]): Promise<never>;
+export declare function signTransaction(..._args: unknown[]): Promise<never>;
+export declare function signAndSubmitTransaction(..._args: unknown[]): Promise<never>;
+export declare function count(..._args: unknown[]): Promise<never>;
+export declare function aggregate(..._args: unknown[]): Promise<never>;
+export declare function subscribe(..._args: unknown[]): Promise<never>;
+export declare function invokeFunction(..._args: unknown[]): Promise<never>;
+export declare function liveIntent(..._args: unknown[]): Promise<never>;
+export declare function liveStatus(..._args: unknown[]): Promise<never>;
+export declare const functions: {
+    invoke: (..._args: unknown[]) => Promise<never>;
+};
+export declare const live: {
+    intent: (..._args: unknown[]) => Promise<never>;
+    status: (..._args: unknown[]) => Promise<never>;
+};

package/dist/index.d.ts

@@ -1,16 +1,10 @@
-export { init } from "./global";
-export { getConfig } from '@bounded-sh/core';
+export { init } from './global';
+export { getConfig, getWebhookKeysUrl, InsufficientBalanceError, FunctionInvokeError, LiveIntentError } from '@bounded-sh/core';
 export { getAuthProvider } from './auth';
-export { get, getMany, set, setMany, setFile, getFiles, search, queryAggregate, runQuery, runQueryMany, runExpression, runExpressionMany, signMessage, signTransaction, signAndSubmitTransaction, count, aggregate, InsufficientBalanceError } from '@bounded-sh/core';
-export type { GetOptions, SearchOptions, SetOptions, CountOptions, AggregateOptions, AggregateOperation, AggregateResult, AggregateSpec, AggregateRow, QueryAggregateOptions, GetManyResult, RunExpressionOptions, RunExpressionResult, RequestOverrides, RunQueryOptions } from '@bounded-sh/core';
-export { subscribe } from '@bounded-sh/core';
-export { functions, invokeFunction, FunctionInvokeError } from '@bounded-sh/core';
-export type { InvokeOptions } from '@bounded-sh/core';
-export { live, liveIntent, liveStatus, LiveIntentError } from '@bounded-sh/core';
-export type { LiveIntentOptions, LiveStatus, LiveStatusOptions } from '@bounded-sh/core';
-export * from '@bounded-sh/core';
+export { get, getMany, set, setMany, setFile, getFiles, search, queryAggregate, runQuery, runQueryMany, runExpression, runExpressionMany, signMessage, signTransaction, signAndSubmitTransaction, count, aggregate, subscribe, functions, invokeFunction, live, liveIntent, liveStatus, } from './explicit-client-only';
+export type { AuthProvider, ClientConfig, User, GetOptions, SearchOptions, SetOptions, CountOptions, AggregateOptions, AggregateOperation, AggregateResult, AggregateSpec, AggregateRow, QueryAggregateOptions, GetManyResult, RunExpressionOptions, RunExpressionResult, RequestOverrides, RunQueryOptions, InvokeOptions, LiveIntentOptions, LiveStatus, LiveStatusOptions, } from '@bounded-sh/core';
 export { getIdToken } from './utils';
 export { createWalletClient, WalletClient } from './wallet-client';
 export type { CreateWalletClientOptions } from './wallet-client';
-export { verifyWebhook, clearWebhookKeyCache, clearWebhookReplayCache, WebhookVerificationError, DEFAULT_WEBHOOK_KEYS_URL, InMemoryReplayStore } from './webhooks';
-export type { WebhookPayload, WebhookPublicKey, WebhookOperation, VerifyWebhookOptions, WebhookHeaders, WebhookReplayStore } from './webhooks';
+export { verifyWebhook, clearWebhookKeyCache, clearWebhookReplayCache, WebhookVerificationError, DEFAULT_WEBHOOK_KEYS_URL, InMemoryReplayStore, } from './webhooks';
+export type { WebhookPayload, WebhookPublicKey, WebhookOperation, VerifyWebhookOptions, WebhookHeaders, WebhookReplayStore, } from './webhooks';