@shadow-corp/nearconnect 1.0.0

package/build/helpers/simulation.js

@@ -0,0 +1,441 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionSimulator = void 0;
+exports.quickGasEstimate = quickGasEstimate;
+const errors_1 = require("../errors");
+/**
+ * Default RPC endpoints
+ */
+const DEFAULT_RPC_ENDPOINTS = {
+    mainnet: "https://rpc.mainnet.near.org",
+    testnet: "https://rpc.testnet.near.org",
+};
+/**
+ * Gas constants
+ */
+const GAS_CONSTANTS = {
+    /** Base gas for a function call */
+    BASE_FUNCTION_CALL: 5000000000000n, // 5 TGas
+    /** Gas per byte of arguments */
+    GAS_PER_BYTE: 100000000n, // 0.0001 TGas
+    /** Base gas for transfer */
+    TRANSFER_GAS: 450000000000n, // 0.45 TGas
+    /** Base gas for creating account */
+    CREATE_ACCOUNT_GAS: 1000000000000n, // 1 TGas
+    /** Base gas for add key */
+    ADD_KEY_GAS: 1000000000000n, // 1 TGas
+    /** Base gas for delete key */
+    DELETE_KEY_GAS: 450000000000n, // 0.45 TGas
+    /** Base gas for deploy contract */
+    DEPLOY_CONTRACT_BASE: 10000000000000n, // 10 TGas
+    /** Gas per byte of contract code */
+    DEPLOY_GAS_PER_BYTE: 6812999n,
+    /** Base gas for stake */
+    STAKE_GAS: 450000000000n, // 0.45 TGas
+    /** Base gas for delete account */
+    DELETE_ACCOUNT_GAS: 450000000000n, // 0.45 TGas
+    /** Maximum gas allowed */
+    MAX_GAS: 300000000000000n, // 300 TGas
+    /** Gas price in yoctoNEAR (approximate) */
+    GAS_PRICE: 100000000n, // 0.0001 NEAR per TGas
+};
+/**
+ * High deposit threshold in NEAR
+ */
+const HIGH_DEPOSIT_THRESHOLD = 10n * 10n ** 24n; // 10 NEAR
+/**
+ * Transaction simulator
+ */
+class TransactionSimulator {
+    network;
+    rpcEndpoint;
+    constructor(options = {}) {
+        this.network = options.network ?? "mainnet";
+        this.rpcEndpoint = options.rpcEndpoint ?? DEFAULT_RPC_ENDPOINTS[this.network];
+    }
+    /**
+     * Simulate a transaction and get gas estimates
+     */
+    async simulate(transaction, signerAccount) {
+        const warnings = [];
+        const logs = [];
+        let success = true;
+        let error;
+        let returnValue;
+        // Calculate gas estimate
+        const gasEstimate = await this.estimateGas(transaction, signerAccount);
+        // Calculate total deposit
+        const totalDeposit = this.calculateTotalDeposit(transaction);
+        const totalDepositNear = this.formatNear(totalDeposit);
+        // Check for high deposit
+        if (BigInt(totalDeposit) > HIGH_DEPOSIT_THRESHOLD) {
+            warnings.push({
+                type: "high_deposit",
+                message: `This transaction requires a large deposit of ${totalDepositNear}`,
+                severity: "warning",
+            });
+        }
+        // Check for dangerous actions
+        this.checkDangerousActions(transaction, warnings);
+        // Check account balance
+        try {
+            const balance = await this.getAccountBalance(signerAccount.accountId);
+            const requiredBalance = BigInt(totalDeposit) + BigInt(gasEstimate.gasCostNear.replace(" NEAR", "")) * 10n ** 24n;
+            if (BigInt(balance) < requiredBalance) {
+                warnings.push({
+                    type: "low_balance",
+                    message: "Account balance may be insufficient for this transaction",
+                    severity: "warning",
+                });
+                gasEstimate.canAfford = false;
+            }
+        }
+        catch {
+            // Can't check balance, skip
+        }
+        // Try to simulate function calls via RPC
+        if (transaction.actions) {
+            for (const action of transaction.actions) {
+                if (typeof action === "object" && ("FunctionCall" in action || "functionCall" in action)) {
+                    const fc = action.FunctionCall ?? action.functionCall;
+                    const fcData = fc;
+                    try {
+                        const result = await this.simulateFunctionCall(transaction.receiverId, fcData.methodName, fcData.args);
+                        if (result.logs)
+                            logs.push(...result.logs);
+                        if (result.result)
+                            returnValue = result.result;
+                    }
+                    catch (e) {
+                        success = false;
+                        error = e instanceof Error ? e.message : "Simulation failed";
+                        logs.push(`Simulation error: ${error}`);
+                    }
+                }
+            }
+        }
+        return {
+            success,
+            gasEstimate,
+            totalDeposit,
+            totalDepositNear,
+            logs,
+            returnValue,
+            error,
+            warnings,
+        };
+    }
+    /**
+     * Estimate gas for a transaction
+     */
+    async estimateGas(transaction, signerAccount) {
+        const breakdown = [];
+        let totalGas = 0n;
+        if (!transaction.actions) {
+            return {
+                gas: "0",
+                tgas: 0,
+                gasCostNear: "0 NEAR",
+                canAfford: true,
+                breakdown: [],
+            };
+        }
+        for (const action of transaction.actions) {
+            const estimate = this.estimateActionGas(action);
+            breakdown.push(estimate);
+            totalGas += BigInt(estimate.gas);
+        }
+        // Cap at max gas
+        if (totalGas > GAS_CONSTANTS.MAX_GAS) {
+            totalGas = GAS_CONSTANTS.MAX_GAS;
+        }
+        const tgas = Number(totalGas) / 1e12;
+        const gasCostYocto = totalGas * GAS_CONSTANTS.GAS_PRICE;
+        const gasCostNear = this.formatNear(gasCostYocto.toString());
+        // Check if account can afford
+        let canAfford = true;
+        try {
+            const balance = await this.getAccountBalance(signerAccount.accountId);
+            canAfford = BigInt(balance) >= gasCostYocto;
+        }
+        catch {
+            // Assume can afford if we can't check
+        }
+        return {
+            gas: totalGas.toString(),
+            tgas,
+            gasCostNear,
+            canAfford,
+            breakdown,
+        };
+    }
+    /**
+     * Estimate gas for a single action
+     */
+    estimateActionGas(action) {
+        if (typeof action === "string") {
+            return { type: action, gas: GAS_CONSTANTS.BASE_FUNCTION_CALL.toString(), tgas: 5 };
+        }
+        const actionType = Object.keys(action)[0];
+        const actionData = action[actionType];
+        switch (actionType) {
+            case "FunctionCall":
+            case "functionCall": {
+                const fc = actionData;
+                // Use provided gas or estimate
+                if (fc.gas) {
+                    const gas = BigInt(fc.gas);
+                    return {
+                        type: "FunctionCall",
+                        methodName: fc.methodName,
+                        gas: gas.toString(),
+                        tgas: Number(gas) / 1e12,
+                    };
+                }
+                // Estimate based on args size
+                const argsSize = fc.args ? (typeof fc.args === "string" ? fc.args.length : fc.args.length) : 0;
+                const gas = GAS_CONSTANTS.BASE_FUNCTION_CALL + BigInt(argsSize) * GAS_CONSTANTS.GAS_PER_BYTE;
+                return {
+                    type: "FunctionCall",
+                    methodName: fc.methodName,
+                    gas: gas.toString(),
+                    tgas: Number(gas) / 1e12,
+                };
+            }
+            case "Transfer":
+            case "transfer":
+                return { type: "Transfer", gas: GAS_CONSTANTS.TRANSFER_GAS.toString(), tgas: 0.45 };
+            case "CreateAccount":
+            case "createAccount":
+                return { type: "CreateAccount", gas: GAS_CONSTANTS.CREATE_ACCOUNT_GAS.toString(), tgas: 1 };
+            case "AddKey":
+            case "addKey":
+                return { type: "AddKey", gas: GAS_CONSTANTS.ADD_KEY_GAS.toString(), tgas: 1 };
+            case "DeleteKey":
+            case "deleteKey":
+                return { type: "DeleteKey", gas: GAS_CONSTANTS.DELETE_KEY_GAS.toString(), tgas: 0.45 };
+            case "DeployContract":
+            case "deployContract": {
+                const dc = actionData;
+                const codeSize = dc.code?.length ?? 0;
+                const gas = GAS_CONSTANTS.DEPLOY_CONTRACT_BASE + BigInt(codeSize) * GAS_CONSTANTS.DEPLOY_GAS_PER_BYTE;
+                return { type: "DeployContract", gas: gas.toString(), tgas: Number(gas) / 1e12 };
+            }
+            case "Stake":
+            case "stake":
+                return { type: "Stake", gas: GAS_CONSTANTS.STAKE_GAS.toString(), tgas: 0.45 };
+            case "DeleteAccount":
+            case "deleteAccount":
+                return { type: "DeleteAccount", gas: GAS_CONSTANTS.DELETE_ACCOUNT_GAS.toString(), tgas: 0.45 };
+            default:
+                return { type: actionType, gas: GAS_CONSTANTS.BASE_FUNCTION_CALL.toString(), tgas: 5 };
+        }
+    }
+    /**
+     * Calculate total deposit required
+     */
+    calculateTotalDeposit(transaction) {
+        if (!transaction.actions)
+            return "0";
+        let total = 0n;
+        for (const action of transaction.actions) {
+            if (typeof action === "object") {
+                const actionType = Object.keys(action)[0];
+                const actionData = action[actionType];
+                if (actionType === "FunctionCall" || actionType === "functionCall") {
+                    const fc = actionData;
+                    if (fc.deposit)
+                        total += BigInt(fc.deposit);
+                }
+                else if (actionType === "Transfer" || actionType === "transfer") {
+                    const t = actionData;
+                    if (t.deposit)
+                        total += BigInt(t.deposit);
+                }
+                else if (actionType === "Stake" || actionType === "stake") {
+                    const s = actionData;
+                    if (s.stake)
+                        total += BigInt(s.stake);
+                }
+            }
+        }
+        return total.toString();
+    }
+    /**
+     * Check for dangerous actions
+     */
+    checkDangerousActions(transaction, warnings) {
+        if (!transaction.actions)
+            return;
+        for (const action of transaction.actions) {
+            if (typeof action === "object") {
+                const actionType = Object.keys(action)[0];
+                if (actionType === "DeleteAccount" || actionType === "deleteAccount") {
+                    warnings.push({
+                        type: "dangerous_action",
+                        message: "This transaction will DELETE your account permanently!",
+                        severity: "error",
+                    });
+                }
+                if (actionType === "DeleteKey" || actionType === "deleteKey") {
+                    warnings.push({
+                        type: "dangerous_action",
+                        message: "This transaction will remove an access key from your account",
+                        severity: "warning",
+                    });
+                }
+                if (actionType === "AddKey" || actionType === "addKey") {
+                    const ak = action[actionType];
+                    if (ak.accessKey?.permission === "FullAccess") {
+                        warnings.push({
+                            type: "dangerous_action",
+                            message: "This transaction grants FULL ACCESS to your account",
+                            severity: "error",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Simulate a function call via RPC view call
+     */
+    async simulateFunctionCall(contractId, methodName, args) {
+        const argsBase64 = args
+            ? typeof args === "string"
+                ? btoa(args)
+                : btoa(String.fromCharCode(...args))
+            : "";
+        try {
+            const response = await fetch(this.rpcEndpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: "simulation",
+                    method: "query",
+                    params: {
+                        request_type: "call_function",
+                        finality: "optimistic",
+                        account_id: contractId,
+                        method_name: methodName,
+                        args_base64: argsBase64,
+                    },
+                }),
+            });
+            const data = await response.json();
+            if (data.error) {
+                throw new errors_1.WalletError({
+                    code: errors_1.ErrorCode.RPC_ERROR,
+                    message: data.error.message ?? "RPC call failed",
+                });
+            }
+            const result = data.result;
+            const logs = result?.logs ?? [];
+            let parsedResult;
+            if (result?.result) {
+                try {
+                    const decoded = String.fromCharCode(...result.result);
+                    parsedResult = JSON.parse(decoded);
+                }
+                catch {
+                    parsedResult = result.result;
+                }
+            }
+            return { result: parsedResult, logs };
+        }
+        catch (e) {
+            if (e instanceof errors_1.WalletError)
+                throw e;
+            throw new errors_1.WalletError({
+                code: errors_1.ErrorCode.RPC_ERROR,
+                message: e instanceof Error ? e.message : "Simulation failed",
+                originalError: e instanceof Error ? e : undefined,
+            });
+        }
+    }
+    /**
+     * Get account balance
+     */
+    async getAccountBalance(accountId) {
+        try {
+            const response = await fetch(this.rpcEndpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: "balance",
+                    method: "query",
+                    params: {
+                        request_type: "view_account",
+                        finality: "optimistic",
+                        account_id: accountId,
+                    },
+                }),
+            });
+            const data = await response.json();
+            return data.result?.amount ?? "0";
+        }
+        catch {
+            return "0";
+        }
+    }
+    /**
+     * Format yoctoNEAR to NEAR
+     */
+    formatNear(yocto) {
+        try {
+            const value = BigInt(yocto);
+            const near = Number(value) / 1e24;
+            if (near < 0.0001 && near > 0) {
+                return "< 0.0001 NEAR";
+            }
+            return `${near.toFixed(4)} NEAR`;
+        }
+        catch {
+            return "0 NEAR";
+        }
+    }
+    /**
+     * Set network
+     */
+    setNetwork(network) {
+        this.network = network;
+        this.rpcEndpoint = DEFAULT_RPC_ENDPOINTS[network];
+    }
+    /**
+     * Set custom RPC endpoint
+     */
+    setRpcEndpoint(endpoint) {
+        this.rpcEndpoint = endpoint;
+    }
+}
+exports.TransactionSimulator = TransactionSimulator;
+/**
+ * Quick gas estimate without full simulation
+ */
+function quickGasEstimate(transaction) {
+    const simulator = new TransactionSimulator();
+    const breakdown = [];
+    let totalGas = 0n;
+    if (transaction.actions) {
+        for (const action of transaction.actions) {
+            const estimate = simulator.estimateActionGas(action);
+            breakdown.push(estimate);
+            totalGas += BigInt(estimate.gas);
+        }
+    }
+    if (totalGas > GAS_CONSTANTS.MAX_GAS) {
+        totalGas = GAS_CONSTANTS.MAX_GAS;
+    }
+    const tgas = Number(totalGas) / 1e12;
+    const gasCostYocto = totalGas * GAS_CONSTANTS.GAS_PRICE;
+    return {
+        gas: totalGas.toString(),
+        tgas,
+        gasCostNear: `${(Number(gasCostYocto) / 1e24).toFixed(6)} NEAR`,
+        canAfford: true, // Can't check without account
+        breakdown,
+    };
+}
+//# sourceMappingURL=simulation.js.map

package/build/helpers/simulation.js.map

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

package/build/helpers/storage.d.ts

@@ -0,0 +1,58 @@
+export interface DataStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * localStorage adapter - persists across browser sessions
+ */
+export declare class LocalStorage implements DataStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * sessionStorage adapter - cleared when browser tab closes
+ */
+export declare class SessionStorage implements DataStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * Memory-only adapter - no persistence, lost on page refresh
+ */
+export declare class MemoryStorage implements DataStorage {
+    private data;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): void;
+}
+/**
+ * IndexedDB adapter - for larger data, survives browser sessions
+ */
+export declare class IndexedDBStorage implements DataStorage {
+    private dbName;
+    private storeName;
+    private dbPromise;
+    constructor(dbName?: string, storeName?: string);
+    private getDB;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * Encrypted storage wrapper - encrypts data before storing
+ * Uses AES-GCM with a derived key from password
+ */
+export declare class EncryptedStorage implements DataStorage {
+    private storage;
+    private keyPromise;
+    private password;
+    constructor(storage: DataStorage, password: string);
+    private getKey;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}