@grimoirelabs/core 0.1.0

package/dist/wallet/provider.js

@@ -0,0 +1,309 @@
+/**
+ * RPC Provider management
+ *
+ * Handles connection to blockchain nodes with:
+ * - Automatic fallback to backup URLs
+ * - Retry with exponential backoff
+ * - Gas price estimation
+ */
+import { http, createPublicClient } from "viem";
+import { arbitrum, base, mainnet, optimism, polygon, sepolia } from "viem/chains";
+/** HyperEVM chain definition */
+const hyperEVM = {
+    id: 999,
+    name: "HyperEVM",
+    nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+    rpcUrls: {
+        default: { http: ["https://rpc.hyperliquid.xyz/evm"] },
+    },
+};
+/** Map chain IDs to viem chain objects */
+const VIEM_CHAINS = {
+    1: mainnet,
+    10: optimism,
+    137: polygon,
+    42161: arbitrum,
+    8453: base,
+    999: hyperEVM,
+    11155111: sepolia,
+};
+/** Default provider configurations */
+const DEFAULT_CONFIGS = {
+    1: {
+        chainId: 1,
+        rpcUrl: "https://eth.llamarpc.com",
+        fallbackUrls: ["https://rpc.ankr.com/eth", "https://ethereum.publicnode.com"],
+        timeout: 30000,
+        retries: 3,
+    },
+    10: {
+        chainId: 10,
+        rpcUrl: "https://mainnet.optimism.io",
+        fallbackUrls: ["https://rpc.ankr.com/optimism"],
+        timeout: 30000,
+        retries: 3,
+    },
+    137: {
+        chainId: 137,
+        rpcUrl: "https://polygon-rpc.com",
+        fallbackUrls: ["https://rpc.ankr.com/polygon"],
+        timeout: 30000,
+        retries: 3,
+    },
+    42161: {
+        chainId: 42161,
+        rpcUrl: "https://arb1.arbitrum.io/rpc",
+        fallbackUrls: ["https://rpc.ankr.com/arbitrum"],
+        timeout: 30000,
+        retries: 3,
+    },
+    8453: {
+        chainId: 8453,
+        rpcUrl: "https://mainnet.base.org",
+        fallbackUrls: ["https://base.llamarpc.com"],
+        timeout: 30000,
+        retries: 3,
+    },
+    999: {
+        chainId: 999,
+        rpcUrl: "https://rpc.hyperliquid.xyz/evm",
+        timeout: 30000,
+        retries: 3,
+    },
+    11155111: {
+        chainId: 11155111,
+        rpcUrl: "https://rpc.sepolia.org",
+        fallbackUrls: ["https://ethereum-sepolia.publicnode.com"],
+        timeout: 30000,
+        retries: 3,
+    },
+};
+/**
+ * Provider wrapper with fallback and retry support
+ */
+export class Provider {
+    client;
+    config;
+    currentUrlIndex = 0;
+    constructor(config) {
+        this.config = {
+            ...config,
+            timeout: config.timeout ?? 30000,
+            retries: config.retries ?? 3,
+        };
+        const chain = VIEM_CHAINS[config.chainId];
+        if (!chain) {
+            throw new Error(`Unsupported chain ID: ${config.chainId}`);
+        }
+        this.client = createPublicClient({
+            chain,
+            transport: http(config.rpcUrl, {
+                timeout: this.config.timeout,
+                retryCount: this.config.retries,
+            }),
+        });
+    }
+    /**
+     * Get the chain ID
+     */
+    get chainId() {
+        return this.config.chainId;
+    }
+    /**
+     * Get the current RPC URL
+     */
+    get rpcUrl() {
+        const urls = [this.config.rpcUrl, ...(this.config.fallbackUrls ?? [])];
+        return urls[this.currentUrlIndex] ?? this.config.rpcUrl;
+    }
+    /**
+     * Get underlying viem client
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Get the current block number
+     */
+    async getBlockNumber() {
+        return await this.withRetry(() => this.client.getBlockNumber());
+    }
+    /**
+     * Get the balance of an address
+     */
+    async getBalance(address) {
+        return await this.withRetry(() => this.client.getBalance({ address: address }));
+    }
+    /**
+     * Get the nonce for an address
+     */
+    async getNonce(address) {
+        return await this.withRetry(() => this.client.getTransactionCount({ address: address }));
+    }
+    /**
+     * Estimate gas for a transaction
+     */
+    async estimateGas(tx) {
+        return await this.withRetry(() => this.client.estimateGas({
+            to: tx.to,
+            data: tx.data,
+            value: tx.value,
+            account: tx.from,
+        }));
+    }
+    /**
+     * Get current gas prices (EIP-1559)
+     */
+    async getGasPrices() {
+        const block = (await this.withRetry(() => this.client.getBlock({ blockTag: "latest" })));
+        const baseFee = block.baseFeePerGas ?? 0n;
+        // Default priority fee of 1.5 gwei, or use oracle if available
+        const priorityFee = 1500000000n; // 1.5 gwei
+        return {
+            maxFeePerGas: baseFee * 2n + priorityFee,
+            maxPriorityFeePerGas: priorityFee,
+        };
+    }
+    /**
+     * Get full gas estimate for a transaction
+     */
+    async getGasEstimate(tx) {
+        const [gasLimit, gasPrices] = await Promise.all([this.estimateGas(tx), this.getGasPrices()]);
+        // Add 20% buffer to gas limit
+        const bufferedGasLimit = (gasLimit * 120n) / 100n;
+        return {
+            gasLimit: bufferedGasLimit,
+            maxFeePerGas: gasPrices.maxFeePerGas,
+            maxPriorityFeePerGas: gasPrices.maxPriorityFeePerGas,
+            estimatedCost: bufferedGasLimit * gasPrices.maxFeePerGas,
+        };
+    }
+    /**
+     * Read contract data
+     */
+    async readContract(params) {
+        return await this.withRetry(() => this.client.readContract({
+            address: params.address,
+            abi: params.abi,
+            functionName: params.functionName,
+            args: params.args,
+        }));
+    }
+    /**
+     * Wait for a transaction receipt
+     */
+    async waitForTransaction(hash, confirmations = 1) {
+        return await this.withRetry(() => this.client.waitForTransactionReceipt({
+            hash: hash,
+            confirmations,
+        }));
+    }
+    /**
+     * Execute with retry and fallback
+     */
+    async withRetry(fn) {
+        const urls = [this.config.rpcUrl, ...(this.config.fallbackUrls ?? [])];
+        let lastError = null;
+        for (let urlIndex = 0; urlIndex < urls.length; urlIndex++) {
+            for (let attempt = 0; attempt < (this.config.retries ?? 3); attempt++) {
+                try {
+                    return await fn();
+                }
+                catch (error) {
+                    lastError = error;
+                    // If this is a rate limit or connection error, try next URL
+                    if (this.shouldSwitchProvider(error)) {
+                        break;
+                    }
+                    // Exponential backoff
+                    if (attempt < (this.config.retries ?? 3) - 1) {
+                        await this.sleep(2 ** attempt * 1000);
+                    }
+                }
+            }
+            // Try next URL
+            if (urlIndex < urls.length - 1) {
+                this.switchToUrl(urlIndex + 1);
+            }
+        }
+        throw lastError ?? new Error("All retry attempts failed");
+    }
+    /**
+     * Check if we should switch to a different provider
+     */
+    shouldSwitchProvider(error) {
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            return (message.includes("rate limit") ||
+                message.includes("too many requests") ||
+                message.includes("connection refused") ||
+                message.includes("econnrefused") ||
+                message.includes("timeout"));
+        }
+        return false;
+    }
+    /**
+     * Switch to a different RPC URL
+     */
+    switchToUrl(index) {
+        const urls = [this.config.rpcUrl, ...(this.config.fallbackUrls ?? [])];
+        if (index >= urls.length)
+            return;
+        this.currentUrlIndex = index;
+        const chain = VIEM_CHAINS[this.config.chainId];
+        this.client = createPublicClient({
+            chain,
+            transport: http(urls[index], {
+                timeout: this.config.timeout,
+                retryCount: this.config.retries,
+            }),
+        });
+    }
+    /**
+     * Sleep for a duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create a provider for a specific chain
+ */
+export function createProvider(chainId, rpcUrl) {
+    const defaultConfig = DEFAULT_CONFIGS[chainId];
+    if (!defaultConfig && !rpcUrl) {
+        throw new Error(`No default configuration for chain ${chainId}. Please provide an RPC URL.`);
+    }
+    const config = {
+        chainId,
+        rpcUrl: rpcUrl ?? defaultConfig?.rpcUrl ?? "",
+        fallbackUrls: defaultConfig?.fallbackUrls,
+        timeout: defaultConfig?.timeout ?? 30000,
+        retries: defaultConfig?.retries ?? 3,
+    };
+    return new Provider(config);
+}
+/**
+ * Format wei to human-readable string
+ */
+export function formatWei(wei, decimals = 18) {
+    const divisor = 10n ** BigInt(decimals);
+    const integerPart = wei / divisor;
+    const fractionalPart = wei % divisor;
+    if (fractionalPart === 0n) {
+        return integerPart.toString();
+    }
+    const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+    const trimmed = fractionalStr.replace(/0+$/, "");
+    return `${integerPart}.${trimmed}`;
+}
+/**
+ * Format gas cost to USD (rough estimate)
+ */
+export function formatGasCostUsd(gasUsed, gasPrice, ethPriceUsd = 2000) {
+    const costWei = gasUsed * gasPrice;
+    const costEth = Number(costWei) / 1e18;
+    const costUsd = costEth * ethPriceUsd;
+    return `$${costUsd.toFixed(2)}`;
+}
+//# sourceMappingURL=provider.js.map

package/dist/wallet/provider.js.map

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

package/dist/wallet/tx-builder.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Transaction builder
+ *
+ * Builds transactions from spell actions, supporting:
+ * - ERC20 operations (transfer, approve)
+ * - Swap operations
+ * - Lending operations (deposit, withdraw)
+ */
+import type { Action } from "../types/actions.js";
+import type { Address } from "../types/primitives.js";
+import type { Provider } from "./provider.js";
+import type { GasEstimate, TransactionRequest } from "./types.js";
+/** Built transaction with metadata */
+export interface BuiltTransaction {
+    /** The transaction request */
+    tx: TransactionRequest;
+    /** Human-readable description */
+    description: string;
+    /** Gas estimate */
+    gasEstimate?: GasEstimate;
+    /** Action this transaction executes */
+    action: Action;
+}
+/**
+ * Transaction builder class
+ */
+export declare class TransactionBuilder {
+    private provider;
+    private fromAddress;
+    constructor(provider: Provider, fromAddress: Address);
+    /**
+     * Build a transaction from an action
+     */
+    buildAction(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build a transfer transaction (native ETH or ERC20)
+     */
+    buildTransfer(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build an ERC20 approve transaction
+     */
+    buildApprove(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build a swap transaction (placeholder - requires venue adapter)
+     */
+    buildSwap(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build a lending deposit transaction (placeholder - requires venue adapter)
+     */
+    buildLend(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build a withdrawal transaction (placeholder - requires venue adapter)
+     */
+    buildWithdraw(action: Action): Promise<BuiltTransaction>;
+    /**
+     * Build a raw transaction
+     */
+    buildRaw(to: Address, data: string, value?: bigint, description?: string): Promise<BuiltTransaction>;
+    /**
+     * Check ERC20 allowance
+     */
+    checkAllowance(tokenAddress: Address, spenderAddress: Address): Promise<bigint>;
+    /**
+     * Check ERC20 balance
+     */
+    checkBalance(tokenAddress: Address): Promise<bigint>;
+    /**
+     * Get token decimals
+     */
+    getTokenDecimals(tokenAddress: Address): Promise<number>;
+    /**
+     * Get token symbol
+     */
+    getTokenSymbol(tokenAddress: Address): Promise<string>;
+    /**
+     * Resolve asset symbol to address
+     * TODO: Implement proper asset registry
+     */
+    private resolveAssetAddress;
+}
+/**
+ * Create a transaction builder
+ */
+export declare function createTransactionBuilder(provider: Provider, fromAddress: Address): TransactionBuilder;
+//# sourceMappingURL=tx-builder.d.ts.map

package/dist/wallet/tx-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-builder.d.ts","sourceRoot":"","sources":["../../src/wallet/tx-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAYlE,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAU;gBAEjB,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO;IAKpD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiB5D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgD9D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuC7D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY9D;;OAEG;IACG,QAAQ,CACZ,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,EACV,WAAW,SAAoB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAgC5B;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IASrF;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAS1D;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9D;;OAEG;IACG,cAAc,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ5D;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA0B5B;AA2BD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,OAAO,GACnB,kBAAkB,CAEpB"}