@karn_lat/protocol-sdk 0.1.0-alpha.1

package/dist/react/index.js

@@ -0,0 +1,7 @@
+export * from './providers/KarnProvider.js';
+export * from './hooks/useValocracy.js';
+export * from './hooks/useGovernor.js';
+export * from './hooks/useTreasury.js';
+export * from './hooks/useWallet.js';
+export * from './hooks/useMultiWallet.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/dist/react/providers/KarnProvider.d.ts

@@ -0,0 +1,25 @@
+import React, { ReactNode } from 'react';
+import { ValocracyClient, GovernorClient, TreasuryClient } from '../../clients';
+export interface KarnConfig {
+    networkPassphrase: string;
+    rpcUrl: string;
+    contracts: {
+        valocracy: string;
+        governor: string;
+        treasury: string;
+    };
+}
+interface KarnContextValue {
+    valocracy: ValocracyClient;
+    governor: GovernorClient;
+    treasury: TreasuryClient;
+    config: KarnConfig;
+}
+export declare const useKarn: () => KarnContextValue;
+interface KarnProviderProps {
+    config: KarnConfig;
+    children: ReactNode;
+}
+export declare const KarnProvider: React.FC<KarnProviderProps>;
+export {};
+//# sourceMappingURL=KarnProvider.d.ts.map

package/dist/react/providers/KarnProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KarnProvider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/KarnProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;CACpB;AAID,eAAO,MAAM,OAAO,wBAMnB,CAAC;AAEF,UAAU,iBAAiB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA2BpD,CAAC"}

package/dist/react/providers/KarnProvider.js

@@ -0,0 +1,25 @@
+import React, { createContext, useContext, useMemo } from 'react';
+import { ValocracyClient, GovernorClient, TreasuryClient } from '../../clients';
+const KarnContext = createContext(null);
+export const useKarn = () => {
+    const context = useContext(KarnContext);
+    if (!context) {
+        throw new Error('useKarn must be used within a KarnProvider');
+    }
+    return context;
+};
+export const KarnProvider = ({ config, children }) => {
+    const clients = useMemo(() => {
+        return {
+            valocracy: new ValocracyClient(config.networkPassphrase, config.rpcUrl, config.contracts.valocracy),
+            governor: new GovernorClient(config.networkPassphrase, config.rpcUrl, config.contracts.governor),
+            treasury: new TreasuryClient(config.networkPassphrase, config.rpcUrl, config.contracts.treasury),
+        };
+    }, [config.networkPassphrase, config.rpcUrl, config.contracts.valocracy, config.contracts.governor, config.contracts.treasury]);
+    const value = {
+        ...clients,
+        config,
+    };
+    return React.createElement(KarnContext.Provider, { value: value }, children);
+};
+//# sourceMappingURL=KarnProvider.js.map

package/dist/react/providers/KarnProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KarnProvider.js","sourceRoot":"","sources":["../../../src/react/providers/KarnProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAa,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAmBhF,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE;IAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAOF,MAAM,CAAC,MAAM,YAAY,GAAgC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;IAChF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,OAAO;YACL,SAAS,EAAE,IAAI,eAAe,CAC5B,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,CAAC,SAAS,CAC3B;YACD,QAAQ,EAAE,IAAI,cAAc,CAC1B,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,CAAC,QAAQ,CAC1B;YACD,QAAQ,EAAE,IAAI,cAAc,CAC1B,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,CAAC,QAAQ,CAC1B;SACF,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEhI,MAAM,KAAK,GAAqB;QAC9B,GAAG,OAAO;QACV,MAAM;KACP,CAAC;IAEF,OAAO,oBAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IAAG,QAAQ,CAAwB,CAAC;AAC/E,CAAC,CAAC"}

package/dist/utils/decay.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Client-side Mana decay calculation
+ */
+/**
+ * Calculate current Mana based on level and last activity
+ *
+ * Formula: Mana = floor + bonus
+ * - floor = MEMBER_FLOOR (fixed constant, e.g. 5)
+ * - extra_level = level - floor
+ * - bonus = (extra_level * time_remaining) / VACANCY_PERIOD
+ *
+ * @param level Total level (including permanent)
+ * @param permanentLevel Permanent level (Founder badge)
+ * @param expiry Expiry timestamp (Unix seconds)
+ * @param currentTimestamp Current timestamp (Unix seconds)
+ * @returns Current Mana
+ */
+export declare function calculateMana(level: number, permanentLevel: number, expiry: number, currentTimestamp: number): number;
+//# sourceMappingURL=decay.d.ts.map

package/dist/utils/decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["../../src/utils/decay.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAiBR"}

package/dist/utils/decay.js

@@ -0,0 +1,33 @@
+/**
+ * Client-side Mana decay calculation
+ */
+const MEMBER_FLOOR = 5;
+const VACANCY_PERIOD = 15552000; // 180 days in seconds
+/**
+ * Calculate current Mana based on level and last activity
+ *
+ * Formula: Mana = floor + bonus
+ * - floor = MEMBER_FLOOR (fixed constant, e.g. 5)
+ * - extra_level = level - floor
+ * - bonus = (extra_level * time_remaining) / VACANCY_PERIOD
+ *
+ * @param level Total level (including permanent)
+ * @param permanentLevel Permanent level (Founder badge)
+ * @param expiry Expiry timestamp (Unix seconds)
+ * @param currentTimestamp Current timestamp (Unix seconds)
+ * @returns Current Mana
+ */
+export function calculateMana(level, permanentLevel, expiry, currentTimestamp) {
+    // 1. Calculate decaying portion
+    const decayingLevel = Math.max(0, level - permanentLevel);
+    // 2. Calculate time remaining
+    const timeRemaining = Math.max(0, expiry - currentTimestamp);
+    // 3. Calculate bonus
+    // Use Math.floor to match integer arithmetic
+    // bonus = (DecayingLevel * TimeRemaining) / VacancyPeriod
+    const bonus = Math.floor((decayingLevel * timeRemaining) / VACANCY_PERIOD);
+    // 4. Default floor logic
+    // Contract: Mana = MemberFloor + bonus + PermanentLevel
+    return MEMBER_FLOOR + bonus + permanentLevel;
+}
+//# sourceMappingURL=decay.js.map

package/dist/utils/decay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.js","sourceRoot":"","sources":["../../src/utils/decay.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,sBAAsB;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,cAAsB,EACtB,MAAc,EACd,gBAAwB;IAExB,gCAAgC;IAChC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC,CAAC;IAG1D,8BAA8B;IAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;IAE7D,qBAAqB;IACrB,6CAA6C;IAC7C,0DAA0D;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,cAAc,CAAC,CAAC;IAE3E,yBAAyB;IACzB,wDAAwD;IAExD,OAAO,YAAY,GAAG,KAAK,GAAG,cAAc,CAAC;AAC/C,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './decay.js';
+export * from './simulation.js';
+export * from './polling.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export * from './decay.js';
+export * from './simulation.js';
+export * from './polling.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/polling.d.ts

@@ -0,0 +1,75 @@
+import { rpc } from '@stellar/stellar-sdk';
+export interface PollingOptions {
+    /**
+     * Maximum number of polling attempts
+     * @default 30
+     */
+    maxAttempts?: number;
+    /**
+     * Interval between polling attempts in milliseconds
+     * @default 1000 (1 second)
+     */
+    intervalMs?: number;
+    /**
+     * Whether to use exponential backoff
+     * @default true
+     */
+    exponentialBackoff?: boolean;
+    /**
+     * Maximum interval between attempts when using exponential backoff (ms)
+     * @default 10000 (10 seconds)
+     */
+    maxIntervalMs?: number;
+    /**
+     * Callback function called on each polling attempt
+     */
+    onAttempt?: (attempt: number, status: string) => void;
+}
+export interface PollingResult<T> {
+    /**
+     * Whether the operation succeeded
+     */
+    success: boolean;
+    /**
+     * The final transaction response (if successful)
+     */
+    response?: T;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Number of attempts made
+     */
+    attempts: number;
+    /**
+     * Total time elapsed in milliseconds
+     */
+    elapsedMs: number;
+}
+/**
+ * Poll for a transaction result with exponential backoff
+ *
+ * @param server - Stellar RPC server instance
+ * @param transactionHash - The transaction hash to poll for
+ * @param options - Polling configuration options
+ * @returns Promise resolving to polling result
+ */
+export declare function pollTransactionResult(server: rpc.Server, transactionHash: string, options?: PollingOptions): Promise<PollingResult<rpc.Api.GetTransactionResponse>>;
+/**
+ * Wait for a specified duration
+ *
+ * @param ms - Duration to wait in milliseconds
+ * @returns Promise that resolves after the duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Poll for multiple transactions in parallel
+ *
+ * @param server - Stellar RPC server instance
+ * @param transactionHashes - Array of transaction hashes to poll
+ * @param options - Polling configuration options
+ * @returns Promise resolving to array of polling results
+ */
+export declare function pollMultipleTransactions(server: rpc.Server, transactionHashes: string[], options?: PollingOptions): Promise<PollingResult<rpc.Api.GetTransactionResponse>[]>;
+//# sourceMappingURL=polling.d.ts.map

package/dist/utils/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AAEH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAyFxD;AAED;;;;;GAKG;AAEH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;GAOG;AAEH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAI1D"}

package/dist/utils/polling.js

@@ -0,0 +1,104 @@
+import { rpc } from '@stellar/stellar-sdk';
+/**
+ * Poll for a transaction result with exponential backoff
+ *
+ * @param server - Stellar RPC server instance
+ * @param transactionHash - The transaction hash to poll for
+ * @param options - Polling configuration options
+ * @returns Promise resolving to polling result
+ */
+export async function pollTransactionResult(server, transactionHash, options = {}) {
+    const { maxAttempts = 30, intervalMs = 1000, exponentialBackoff = true, maxIntervalMs = 10000, onAttempt, } = options;
+    const startTime = Date.now();
+    let attempts = 0;
+    let currentInterval = intervalMs;
+    while (attempts < maxAttempts) {
+        attempts++;
+        try {
+            const response = await server.getTransaction(transactionHash);
+            const status = response.status;
+            onAttempt?.(attempts, status);
+            // SUCCESS - Transaction confirmed
+            if (response.status === rpc.Api.GetTransactionStatus.SUCCESS) {
+                return {
+                    success: true,
+                    response,
+                    attempts,
+                    elapsedMs: Date.now() - startTime,
+                };
+            }
+            // FAILED - Transaction failed permanently
+            if (response.status === rpc.Api.GetTransactionStatus.FAILED) {
+                return {
+                    success: false,
+                    error: `Transaction failed: ${JSON.stringify(response)}`,
+                    attempts,
+                    elapsedMs: Date.now() - startTime,
+                };
+            }
+            // NOT_FOUND - Still pending, continue polling
+            if (response.status === rpc.Api.GetTransactionStatus.NOT_FOUND) {
+                // Wait before next attempt
+                if (attempts < maxAttempts) {
+                    await sleep(currentInterval);
+                    // Exponential backoff: double interval each time, up to max
+                    if (exponentialBackoff) {
+                        currentInterval = Math.min(currentInterval * 2, maxIntervalMs);
+                    }
+                }
+                continue;
+            }
+            // Unknown status (shouldn't reach here, but handle gracefully)
+            return {
+                success: false,
+                error: `Unknown transaction status: ${status}`,
+                attempts,
+                elapsedMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            // Network error or RPC error
+            if (attempts >= maxAttempts) {
+                return {
+                    success: false,
+                    error: err instanceof Error ? err.message : 'Unknown error during polling',
+                    attempts,
+                    elapsedMs: Date.now() - startTime,
+                };
+            }
+            // Retry on error
+            await sleep(currentInterval);
+            if (exponentialBackoff) {
+                currentInterval = Math.min(currentInterval * 2, maxIntervalMs);
+            }
+        }
+    }
+    // Max attempts reached
+    return {
+        success: false,
+        error: `Transaction polling timed out after ${attempts} attempts (${Date.now() - startTime}ms)`,
+        attempts,
+        elapsedMs: Date.now() - startTime,
+    };
+}
+/**
+ * Wait for a specified duration
+ *
+ * @param ms - Duration to wait in milliseconds
+ * @returns Promise that resolves after the duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Poll for multiple transactions in parallel
+ *
+ * @param server - Stellar RPC server instance
+ * @param transactionHashes - Array of transaction hashes to poll
+ * @param options - Polling configuration options
+ * @returns Promise resolving to array of polling results
+ */
+export async function pollMultipleTransactions(server, transactionHashes, options = {}) {
+    return Promise.all(transactionHashes.map((hash) => pollTransactionResult(server, hash, options)));
+}
+//# sourceMappingURL=polling.js.map

package/dist/utils/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"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"}

package/dist/utils/simulation.d.ts

@@ -0,0 +1,67 @@
+import { rpc } from '@stellar/stellar-sdk';
+import type { AssembledTransaction } from '@stellar/stellar-sdk/contract';
+export interface SimulationResult<T> {
+    /**
+     * Whether the simulation succeeded
+     */
+    success: boolean;
+    /**
+     * The decoded result value (if successful)
+     */
+    result?: T;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Estimated resource fees in stroops
+     */
+    fee?: number;
+    /**
+     * Raw simulation response from RPC
+     */
+    raw?: rpc.Api.SimulateTransactionResponse;
+}
+/**
+ * Simulate a transaction and extract the result
+ *
+ * @param tx - AssembledTransaction to simulate
+ * @returns Promise resolving to simulation result
+ */
+export declare function simulateTransaction<T>(tx: AssembledTransaction<T>): Promise<SimulationResult<T>>;
+/**
+ * Check if a transaction needs restoration (contract data needs to be restored)
+ *
+ * @param tx - AssembledTransaction to check
+ * @returns Promise resolving to boolean indicating if restoration is needed
+ */
+export declare function needsRestoration<T>(tx: AssembledTransaction<T>): Promise<boolean>;
+/**
+ * Estimate the total fee for a transaction (base fee + resource fee)
+ *
+ * @param tx - AssembledTransaction to estimate
+ * @returns Promise resolving to estimated fee in stroops
+ */
+export declare function estimateFee<T>(tx: AssembledTransaction<T>): Promise<number>;
+/**
+ * Simulate multiple transactions in parallel
+ *
+ * @param transactions - Array of AssembledTransactions to simulate
+ * @returns Promise resolving to array of simulation results
+ */
+export declare function simulateMultiple<T>(transactions: AssembledTransaction<T>[]): Promise<SimulationResult<T>[]>;
+/**
+ * Extract error details from a failed simulation
+ *
+ * @param simulation - The simulation response
+ * @returns Human-readable error message
+ */
+export declare function getSimulationError(simulation: rpc.Api.SimulateTransactionResponse): string;
+/**
+ * Check if a simulation result indicates success
+ *
+ * @param simulation - The simulation response
+ * @returns True if simulation succeeded
+ */
+export declare function isSimulationSuccess(simulation: rpc.Api.SimulateTransactionResponse): boolean;
+//# sourceMappingURL=simulation.d.ts.map

package/dist/utils/simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../../src/utils/simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,2BAA2B,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAyB9B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAEhC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,2BAA2B,GAC9C,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,2BAA2B,GAC9C,OAAO,CAET"}

package/dist/utils/simulation.js

@@ -0,0 +1,88 @@
+import { rpc } from '@stellar/stellar-sdk';
+/**
+ * Simulate a transaction and extract the result
+ *
+ * @param tx - AssembledTransaction to simulate
+ * @returns Promise resolving to simulation result
+ */
+export async function simulateTransaction(tx) {
+    try {
+        // AssembledTransaction has `result` property if already simulated
+        // The simulation happens automatically by default in generated clients
+        // Try to get the result directly (already simulated)
+        if (tx.result !== undefined) {
+            return {
+                success: true,
+                result: tx.result,
+                fee: 0, // Fee info not available without raw simulation
+            };
+        }
+        // If result not available, transaction likely failed or wasn't simulated
+        return {
+            success: false,
+            error: 'Transaction simulation not available',
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : 'Unknown simulation error',
+        };
+    }
+}
+/**
+ * Check if a transaction needs restoration (contract data needs to be restored)
+ *
+ * @param tx - AssembledTransaction to check
+ * @returns Promise resolving to boolean indicating if restoration is needed
+ */
+export async function needsRestoration(tx) {
+    // For generated clients, restoration info is not directly accessible
+    // Return false as default - users should check simulation errors
+    return false;
+}
+/**
+ * Estimate the total fee for a transaction (base fee + resource fee)
+ *
+ * @param tx - AssembledTransaction to estimate
+ * @returns Promise resolving to estimated fee in stroops
+ */
+export async function estimateFee(tx) {
+    // Return a default estimate since simulation details not directly accessible
+    // Users should check actual fee after building transaction
+    return 100000; // Default estimate: 100,000 stroops (~0.01 XLM)
+}
+/**
+ * Simulate multiple transactions in parallel
+ *
+ * @param transactions - Array of AssembledTransactions to simulate
+ * @returns Promise resolving to array of simulation results
+ */
+export async function simulateMultiple(transactions) {
+    return Promise.all(transactions.map((tx) => simulateTransaction(tx)));
+}
+/**
+ * Extract error details from a failed simulation
+ *
+ * @param simulation - The simulation response
+ * @returns Human-readable error message
+ */
+export function getSimulationError(simulation) {
+    if (rpc.Api.isSimulationError(simulation)) {
+        return simulation.error || 'Unknown simulation error';
+    }
+    if (rpc.Api.isSimulationRestore(simulation)) {
+        return 'Contract requires restoration';
+    }
+    return 'Simulation did not succeed';
+}
+/**
+ * Check if a simulation result indicates success
+ *
+ * @param simulation - The simulation response
+ * @returns True if simulation succeeded
+ */
+export function isSimulationSuccess(simulation) {
+    return rpc.Api.isSimulationSuccess(simulation);
+}
+//# sourceMappingURL=simulation.js.map

package/dist/utils/simulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.js","sourceRoot":"","sources":["../../src/utils/simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AA8B3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAA2B;IAE3B,IAAI,CAAC;QACH,kEAAkE;QAClE,uEAAuE;QAEvE,qDAAqD;QACrD,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,GAAG,EAAE,CAAC,EAAE,gDAAgD;aACzD,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sCAAsC;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;SACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAA2B;IAE3B,qEAAqE;IACrE,iEAAiE;IACjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAA2B;IAE3B,6EAA6E;IAC7E,2DAA2D;IAC3D,OAAO,MAAM,CAAC,CAAC,gDAAgD;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAuC;IAEvC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA+C;IAE/C,IAAI,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC,KAAK,IAAI,0BAA0B,CAAC;IACxD,CAAC;IAED,IAAI,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,OAAO,4BAA4B,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA+C;IAE/C,OAAO,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC"}

package/dist/wallet/WalletManager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Manages wallet selection, connection state, and provides unified API
+ * for interacting with any supported Stellar wallet.
+ */
+import { WalletType, WalletState, WalletMetadata, WalletConnection, WalletEvent, WalletEventListener, SignTransactionOptions } from './types.js';
+export declare class WalletManager {
+    private adapters;
+    private currentAdapter;
+    private state;
+    private eventListeners;
+    constructor();
+    /**
+     * Get all available (installed) wallets
+     */
+    getAvailableWallets(): Promise<WalletMetadata[]>;
+    /**
+     * Get all wallet metadata (including unavailable wallets)
+     */
+    getAllWallets(): WalletMetadata[];
+    /**
+     * Get current wallet state
+     */
+    getState(): WalletState;
+    /**
+     * Connect to a specific wallet
+     */
+    connect(walletType: WalletType): Promise<WalletConnection>;
+    /**
+     * Disconnect from current wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current connected address
+     */
+    getAddress(): Promise<string | null>;
+    /**
+     * Check if wallet is connected
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Sign a transaction with current wallet
+     */
+    signTransaction(xdr: string, options?: SignTransactionOptions): Promise<string>;
+    /**
+     * Sign a message (if supported by wallet)
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Get current network (if supported by wallet)
+     */
+    getNetwork(): Promise<string>;
+    /**
+     * Add event listener
+     */
+    on(event: WalletEvent, listener: WalletEventListener): void;
+    /**
+     * Remove event listener
+     */
+    off(event: WalletEvent, listener: WalletEventListener): void;
+    /**
+     * Emit event to all listeners
+     */
+    private emitEvent;
+    /**
+     * Save connection to localStorage for auto-reconnect
+     */
+    private saveConnection;
+    /**
+     * Clear connection from localStorage
+     */
+    private clearConnection;
+    /**
+     * Restore previous connection from localStorage
+     */
+    private restoreConnection;
+}
+//# sourceMappingURL=WalletManager.d.ts.map

package/dist/wallet/WalletManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletManager.d.ts","sourceRoot":"","sources":["../../src/wallet/WalletManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EAEX,mBAAmB,EACnB,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAQpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,cAAc,CAA6C;;IAkCnE;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtD;;OAEG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoEhE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQrC;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC;IAWlB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBnC;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAO3D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAO5D;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;YACW,iBAAiB;CAiBhC"}