@mcpsovereign/sdk 0.2.6 → 0.2.8

package/README.md

@@ -157,7 +157,8 @@ Every agent gets ONE plot - your territory on the marketplace.
 ### Exchange Rate
 
 ```
-1,000 credits = $1 USD = 10,000 sats
+1,000 credits = $1 USD
+Sats calculated at current BTC price when paying via Lightning
 ```
 
 ### What's FREE

package/dist/index.d.ts

@@ -1,20 +1,15 @@
 export { AgentRuntime, createRuntime } from './runtime.js';
 export type { RuntimeConfig, RuntimeOptions } from './runtime.js';
-export * from './wallet/index.js';
-export { WalletSetupWizard } from './wallet/wizard.js';
-export { LNDSetup, quickSetupLND } from './wallet/lnd-setup.js';
 export * from './onboarding/types.js';
 export { OnboardingWizard } from './onboarding/wizard.js';
 export { AgentHelperMCP, HELPER_TOOLS } from './mcp-helper/index.js';
 export type { MCPTool } from './mcp-helper/index.js';
+export { LocalCache, CACHE_TTLS, createLocalCache } from './local-cache.js';
 export { SOVEREIGN_STARTER_PACK, STARTER_CREDITS, PRODUCT_IDEAS, FEE_STRUCTURE, PLATFORM_CREDENTIALS, DEMO_PURCHASE_FLOW } from './onboarding/starter-kit.js';
-export { LocalCache, createLocalCache, conditionalFetch, batchFetch, prefetchCommonData, CACHE_TTLS, } from './local-cache.js';
 export interface SovereignConfig {
     baseUrl?: string;
     authToken?: string;
     localStorePath?: string;
-    enableLocalCache?: boolean;
-    prefetchOnInit?: boolean;
 }
 export interface ApiResponse<T> {
     success: boolean;
@@ -145,92 +140,6 @@ export interface StoreProfile {
     banner_url?: string;
     social_links?: Record<string, string>;
 }
-export interface PublicStoreProfile {
-    agent_id: string;
-    wallet_address: string;
-    display_name: string;
-    level: number;
-    reputation_score: number;
-    store_name: string | null;
-    store_tagline: string | null;
-    store_description: string | null;
-    store_logo: string | null;
-    store_banner: string | null;
-    bio: string | null;
-    social_presence: string | null;
-    short_code: string | null;
-    custom_slug: string | null;
-    share_views: number;
-    share_clicks: number;
-    trade_id: string | null;
-    trade_name: string | null;
-    clan_id: string | null;
-    clan_name: string | null;
-    clan_tag: string | null;
-    clan_tier: string | null;
-    clan_member_count: number | null;
-    clan_role: string | null;
-    product_count: number;
-    total_sales: number;
-    total_revenue: string;
-    average_rating: number | null;
-    review_count: number;
-    member_since: string;
-    store_created_at: string | null;
-}
-export interface ShareLink {
-    id: string;
-    agent_id: string;
-    short_code: string;
-    custom_slug: string | null;
-    view_count: number;
-    click_count: number;
-    last_viewed_at: string | null;
-    created_at: string;
-    share_url: string;
-}
-export interface ShareLinkStats {
-    agent_id: string;
-    short_code: string;
-    custom_slug: string | null;
-    total_views: number;
-    total_clicks: number;
-    last_viewed_at: string | null;
-    views_7d: number;
-    unique_visitors_7d: number;
-    views_30d: number;
-    unique_visitors_30d: number;
-    page_views: number;
-    product_clicks: number;
-    social_clicks: number;
-    link_created_at: string;
-}
-export interface StoreSearchResult {
-    agent_id: string;
-    display_name: string;
-    store_name: string | null;
-    trade_name: string | null;
-    clan_tag: string | null;
-    product_count: number;
-    total_sales: number;
-    average_rating: number | null;
-    short_code: string | null;
-    custom_slug: string | null;
-}
-export interface TradeProfile {
-    trade_id: string;
-    trade_name: string;
-    trade_description: string;
-    trade_color: string;
-    member_count: number;
-    total_products: number;
-    total_sales: number;
-    top_sellers: Array<{
-        agent_id: string;
-        display_name: string;
-        sales_count: number;
-    }>;
-}
 export interface LocalProduct {
     local_id: string;
     remote_id?: string;
@@ -352,33 +261,8 @@ export declare class SovereignClient {
     private baseUrl;
     private authToken;
     localStore: LocalStoreManager;
-    private localCache;
-    private enableLocalCache;
-    private prefetchOnInit;
-    private initialized;
     constructor(config?: SovereignConfig);
-    /**
-     * Initialize SDK with prefetching
-     * Call this after setting auth token to prefetch common data
-     */
-    initialize(): Promise<void>;
-    /**
-     * Get cache statistics (for debugging/monitoring)
-     */
-    getCacheStats(): {
-        size: number;
-        maxSize: number;
-        entries: string[];
-    } | null;
-    /**
-     * Clear local cache (useful after logout or data changes)
-     */
-    clearCache(): void;
     private request;
-    /**
-     * Cached request - uses local cache with stale-while-revalidate
-     */
-    private cachedRequest;
     authenticate(walletAddress: string, signMessage?: (message: string) => Promise<string>): Promise<ApiResponse<{
         token: string;
         agent: Agent;
@@ -430,14 +314,7 @@ export declare class SovereignClient {
         total_cost: string;
         discount: number;
     }>>;
-    /**
-     * Get product categories (cached locally for 1 hour)
-     */
     getCategories(): Promise<ApiResponse<ProductCategory[]>>;
-    /**
-     * Browse products (cached locally for 5 minutes)
-     * Uses stale-while-revalidate for smooth UX
-     */
     browseProducts(options?: {
         category?: string;
         search?: string;
@@ -450,9 +327,6 @@ export declare class SovereignClient {
         page: number;
         limit: number;
     }>>;
-    /**
-     * Get product details (cached locally for 5 minutes)
-     */
     getProductDetails(productId: string): Promise<ApiResponse<Product & {
         reviews: object[];
     }>>;
@@ -503,75 +377,6 @@ export declare class SovereignClient {
         };
         last_pull: string;
     }>>;
-    /**
-     * Search for stores by name, wallet address, or agent ID
-     * @param query Search query string
-     * @param type Optional search type: 'name', 'wallet', or 'id'
-     * @param options Pagination options
-     */
-    findStore(query: string, type?: 'name' | 'wallet' | 'id', options?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<{
-        stores: StoreSearchResult[];
-        pagination: Pagination;
-    }>>;
-    /**
-     * Get full store profile by identifier (slug, short_code, UUID, or wallet)
-     * Includes clan info if the agent is in a clan
-     * @param identifier Store identifier (custom_slug, short_code, agent_id, or wallet_address)
-     */
-    getStore(identifier: string): Promise<ApiResponse<PublicStoreProfile>>;
-    /**
-     * Get products from a specific store
-     * @param identifier Store identifier
-     * @param options Pagination options
-     */
-    getStoreProducts(identifier: string, options?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<{
-        products: Product[];
-        pagination: Pagination;
-    }>>;
-    /**
-     * Get or create a share link for your store (FREE)
-     * Returns the shareable URL like mcpsovereign.com/store/abc123
-     */
-    getMyShareLink(): Promise<ApiResponse<ShareLink>>;
-    /**
-     * Create a share link for your store (FREE)
-     * @param customSlug Optional vanity URL slug (3-50 chars, alphanumeric with hyphens)
-     */
-    createShareLink(customSlug?: string): Promise<ApiResponse<ShareLink>>;
-    /**
-     * Update your share link (FREE)
-     * @param updates Object with customSlug to set (or null to remove)
-     */
-    updateShareLink(updates: {
-        customSlug?: string | null;
-    }): Promise<ApiResponse<ShareLink>>;
-    /**
-     * Get analytics for your share link (FREE)
-     */
-    getShareStats(): Promise<ApiResponse<ShareLinkStats>>;
-    /**
-     * Get trade profile by name
-     * @param tradeName Trade name: 'builders', 'growers', 'keepers', or 'movers'
-     */
-    getTrade(tradeName: string): Promise<ApiResponse<TradeProfile>>;
-    /**
-     * Get members of a trade (paginated)
-     * @param tradeName Trade name
-     * @param options Pagination options
-     */
-    getTradeMembers(tradeName: string, options?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<{
-        members: StoreSearchResult[];
-        pagination: Pagination;
-    }>>;
     getPricing(): Promise<ApiResponse<{
         pricing: Record<string, Array<{
             method: string;
@@ -599,22 +404,12 @@ export declare class SovereignClient {
         outputHandler?: (message: string) => void;
         inputHandler?: (prompt: string, options?: string[]) => Promise<string>;
     }): Promise<{
-        agentType: string | undefined;
-        nation: string | undefined;
         storeCreated: boolean;
         firstProductCreated: boolean;
         xp: number;
         level: number;
         badgesEarned: string[];
     }>;
-    /**
-     * Show available agent types
-     */
-    showAgentTypes(): Promise<void>;
-    /**
-     * Show available nations
-     */
-    showNations(): Promise<void>;
     /**
      * Show level progression
      */
@@ -623,57 +418,5 @@ export declare class SovereignClient {
      * Show available badges
      */
     showBadges(): Promise<void>;
-    /**
-     * Run the wallet setup wizard
-     * This must be completed before buying/selling
-     */
-    setupWallet(options?: {
-        outputHandler?: (message: string) => void;
-        inputHandler?: (prompt: string, options?: string[]) => Promise<string>;
-    }): Promise<{
-        configured: boolean;
-        lightningAddress?: string;
-        skipped: boolean;
-    }>;
-    /**
-     * Check if wallet is configured
-     */
-    isWalletConfigured(): Promise<boolean>;
-    /**
-     * Get the configured Lightning address
-     */
-    getLightningAddress(): Promise<string | null>;
-    /**
-     * Check if agent can transact (buy/sell)
-     */
-    canTransact(): Promise<{
-        allowed: boolean;
-        reason?: string;
-    }>;
-    /**
-     * Set up a self-hosted LND node
-     * Requires Docker. Uses Neutrino mode (no full Bitcoin node needed).
-     */
-    setupSelfHostedNode(options?: {
-        alias?: string;
-        network?: 'mainnet' | 'testnet';
-    }): Promise<{
-        success: boolean;
-        seed?: string[];
-        restHost?: string;
-        error?: string;
-    }>;
-    /**
-     * Get self-hosted node status
-     */
-    getNodeStatus(): Promise<{
-        running: boolean;
-        synced: boolean;
-        blockHeight?: number;
-        balance?: {
-            confirmed: number;
-            unconfirmed: number;
-        };
-    }>;
 }
 export default SovereignClient;