@grimoirelabs/core 0.1.0

package/dist/wallet/keystore.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Private key management
+ *
+ * Supports loading keys from:
+ * - Environment variables
+ * - Raw hex strings (for testing)
+ * - BIP-39 mnemonics
+ * - Encrypted keystore JSON files
+ */
+import type { Address } from "../types/primitives.js";
+import type { KeyConfig, Wallet } from "./types.js";
+/** Error thrown when key loading fails */
+export declare class KeyLoadError extends Error {
+    constructor(message: string);
+}
+/**
+ * Load a private key from the specified source
+ */
+export declare function loadPrivateKey(config: KeyConfig): `0x${string}`;
+/**
+ * Create a wallet from a private key
+ */
+export declare function createWallet(privateKey: `0x${string}`, chainId: number, rpcUrl: string): Wallet;
+/**
+ * Create a wallet from a mnemonic phrase
+ */
+export declare function createWalletFromMnemonic(mnemonic: string, chainId: number, rpcUrl: string, derivationPath?: string): Wallet;
+/**
+ * Create a wallet from configuration
+ */
+export declare function createWalletFromConfig(config: KeyConfig, chainId: number, rpcUrl: string): Wallet;
+/**
+ * Generate a new random private key
+ */
+export declare function generatePrivateKey(): `0x${string}`;
+/**
+ * Encrypt a private key into a keystore JSON string
+ */
+export declare function createKeystore(privateKey: `0x${string}`, password: string): Promise<string>;
+/**
+ * Get wallet address from a key config without creating full wallet
+ */
+export declare function getAddressFromConfig(config: KeyConfig): Address;
+//# sourceMappingURL=keystore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.d.ts","sourceRoot":"","sources":["../../src/wallet/keystore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,EAAE,MAAM,YAAY,CAAC;AAE5F,0CAA0C;AAC1C,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AA4BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,MAAM,EAAE,CA4C/D;AAgFD;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAejG;AA+ED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAiB/D"}

package/dist/wallet/keystore.js

@@ -0,0 +1,296 @@
+/**
+ * Private key management
+ *
+ * Supports loading keys from:
+ * - Environment variables
+ * - Raw hex strings (for testing)
+ * - BIP-39 mnemonics
+ * - Encrypted keystore JSON files
+ */
+import { readFileSync } from "node:fs";
+import { Wallet as EthersWallet } from "ethers";
+import { http, createWalletClient, publicActions, } from "viem";
+import { mnemonicToAccount, privateKeyToAccount, generatePrivateKey as viemGeneratePrivateKey, } from "viem/accounts";
+import { arbitrum, base, mainnet, optimism, polygon, sepolia } from "viem/chains";
+/** Error thrown when key loading fails */
+export class KeyLoadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "KeyLoadError";
+    }
+}
+/** 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,
+};
+/**
+ * Load a private key from the specified source
+ */
+export function loadPrivateKey(config) {
+    switch (config.type) {
+        case "raw":
+            return validatePrivateKey(config.source);
+        case "env": {
+            const value = process.env[config.source];
+            if (!value) {
+                throw new KeyLoadError(`Environment variable ${config.source} is not set`);
+            }
+            return validatePrivateKey(value);
+        }
+        case "mnemonic": {
+            // For mnemonic, the source is the mnemonic phrase
+            // Check if it's an env var reference
+            let mnemonic = config.source;
+            if (!mnemonic.includes(" ")) {
+                // Likely an env var name
+                const envValue = process.env[config.source];
+                if (envValue) {
+                    mnemonic = envValue;
+                }
+            }
+            if (!isValidMnemonic(mnemonic)) {
+                throw new KeyLoadError("Invalid mnemonic phrase");
+            }
+            const path = (config.derivationPath ?? "m/44'/60'/0'/0/0");
+            const _account = mnemonicToAccount(mnemonic, { path });
+            // Note: viem doesn't expose the private key directly from mnemonic account
+            // We need to derive it differently for raw access
+            throw new KeyLoadError("Mnemonic support requires direct account usage. Use createWalletFromMnemonic instead.");
+        }
+        case "keystore":
+            return loadPrivateKeyFromKeystore(config);
+        default:
+            throw new KeyLoadError(`Unknown key source type: ${config.type}`);
+    }
+}
+/**
+ * Validate and normalize a private key
+ */
+function validatePrivateKey(key) {
+    // Remove whitespace
+    let normalized = key.trim();
+    // Add 0x prefix if missing
+    if (!normalized.startsWith("0x")) {
+        normalized = `0x${normalized}`;
+    }
+    // Check length (32 bytes = 64 hex chars + 0x prefix)
+    if (normalized.length !== 66) {
+        throw new KeyLoadError(`Invalid private key length: expected 66 characters, got ${normalized.length}`);
+    }
+    // Check if valid hex
+    if (!/^0x[0-9a-fA-F]{64}$/.test(normalized)) {
+        throw new KeyLoadError("Invalid private key: must be 32 bytes of hex");
+    }
+    return normalized;
+}
+/**
+ * Load a private key from a keystore JSON source
+ */
+function loadPrivateKeyFromKeystore(config) {
+    if (!config.password) {
+        throw new KeyLoadError("Keystore password is required");
+    }
+    const keystoreJson = resolveKeystoreSource(config.source);
+    try {
+        const wallet = EthersWallet.fromEncryptedJsonSync(keystoreJson, config.password);
+        return validatePrivateKey(wallet.privateKey);
+    }
+    catch (error) {
+        throw new KeyLoadError(`Failed to decrypt keystore: ${error.message}`);
+    }
+}
+/**
+ * Resolve keystore JSON from file path, env var, or raw JSON string
+ */
+function resolveKeystoreSource(source) {
+    const trimmed = source.trim();
+    if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+        return trimmed;
+    }
+    const envValue = process.env[source];
+    if (envValue) {
+        return envValue;
+    }
+    try {
+        return readFileSync(source, "utf-8");
+    }
+    catch (error) {
+        throw new KeyLoadError(`Unable to read keystore JSON from '${source}': ${error.message}`);
+    }
+}
+/**
+ * Check if a string is a valid BIP-39 mnemonic
+ */
+function isValidMnemonic(phrase) {
+    const words = phrase.trim().split(/\s+/);
+    // BIP-39 mnemonics are 12, 15, 18, 21, or 24 words
+    return [12, 15, 18, 21, 24].includes(words.length);
+}
+/**
+ * Create a wallet from a private key
+ */
+export function createWallet(privateKey, chainId, rpcUrl) {
+    const account = privateKeyToAccount(privateKey);
+    const chain = VIEM_CHAINS[chainId];
+    if (!chain) {
+        throw new KeyLoadError(`Unsupported chain ID: ${chainId}`);
+    }
+    const client = createWalletClient({
+        account,
+        chain,
+        transport: http(rpcUrl),
+    }).extend(publicActions);
+    return new ViemWallet(client, account, chainId);
+}
+/**
+ * Create a wallet from a mnemonic phrase
+ */
+export function createWalletFromMnemonic(mnemonic, chainId, rpcUrl, derivationPath) {
+    const path = (derivationPath ?? "m/44'/60'/0'/0/0");
+    const account = mnemonicToAccount(mnemonic, { path });
+    const chain = VIEM_CHAINS[chainId];
+    if (!chain) {
+        throw new KeyLoadError(`Unsupported chain ID: ${chainId}`);
+    }
+    const client = createWalletClient({
+        account,
+        chain,
+        transport: http(rpcUrl),
+    }).extend(publicActions);
+    return new ViemWallet(client, account, chainId);
+}
+/**
+ * Create a wallet from configuration
+ */
+export function createWalletFromConfig(config, chainId, rpcUrl) {
+    if (config.type === "mnemonic") {
+        let mnemonic = config.source;
+        // Check if it's an env var reference
+        if (!mnemonic.includes(" ")) {
+            const envValue = process.env[config.source];
+            if (envValue) {
+                mnemonic = envValue;
+            }
+        }
+        return createWalletFromMnemonic(mnemonic, chainId, rpcUrl, config.derivationPath);
+    }
+    const privateKey = loadPrivateKey(config);
+    return createWallet(privateKey, chainId, rpcUrl);
+}
+/**
+ * Wallet implementation using viem
+ */
+class ViemWallet {
+    client;
+    account;
+    chainId;
+    constructor(client, account, chainId) {
+        this.client = client;
+        this.account = account;
+        this.chainId = chainId;
+    }
+    get address() {
+        return this.account.address;
+    }
+    async signTransaction(tx) {
+        const request = this.toViemRequest(tx);
+        if (!this.account.signTransaction) {
+            throw new Error("Account does not support signTransaction");
+        }
+        return await this.account.signTransaction(request);
+    }
+    async signMessage(message) {
+        return await this.client.signMessage({
+            account: this.account,
+            message,
+        });
+    }
+    async sendTransaction(tx) {
+        const request = this.toViemRequest(tx);
+        // Send the transaction
+        const hash = await this.client.sendTransaction(request);
+        // Wait for confirmation
+        const receipt = await this.client.waitForTransactionReceipt({
+            hash,
+            confirmations: 1,
+        });
+        return {
+            hash: receipt.transactionHash,
+            blockNumber: receipt.blockNumber,
+            blockHash: receipt.blockHash,
+            gasUsed: receipt.gasUsed,
+            effectiveGasPrice: receipt.effectiveGasPrice,
+            status: receipt.status === "success" ? "success" : "reverted",
+            contractAddress: receipt.contractAddress,
+            logs: receipt.logs.map((log) => ({
+                address: log.address,
+                topics: log.topics,
+                data: log.data,
+                logIndex: log.logIndex,
+            })),
+        };
+    }
+    toViemRequest(tx) {
+        return {
+            to: tx.to,
+            value: tx.value,
+            data: tx.data,
+            gas: tx.gasLimit,
+            maxFeePerGas: tx.maxFeePerGas,
+            maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+            nonce: tx.nonce,
+        };
+    }
+}
+/**
+ * Generate a new random private key
+ */
+export function generatePrivateKey() {
+    return viemGeneratePrivateKey();
+}
+/**
+ * Encrypt a private key into a keystore JSON string
+ */
+export async function createKeystore(privateKey, password) {
+    if (!password) {
+        throw new KeyLoadError("Keystore password must not be empty");
+    }
+    const wallet = new EthersWallet(privateKey);
+    return await wallet.encrypt(password);
+}
+/**
+ * Get wallet address from a key config without creating full wallet
+ */
+export function getAddressFromConfig(config) {
+    if (config.type === "mnemonic") {
+        let mnemonic = config.source;
+        if (!mnemonic.includes(" ")) {
+            const envValue = process.env[config.source];
+            if (envValue) {
+                mnemonic = envValue;
+            }
+        }
+        const path = (config.derivationPath ?? "m/44'/60'/0'/0/0");
+        const account = mnemonicToAccount(mnemonic, { path });
+        return account.address;
+    }
+    const privateKey = loadPrivateKey(config);
+    const account = privateKeyToAccount(privateKey);
+    return account.address;
+}
+//# sourceMappingURL=keystore.js.map

package/dist/wallet/keystore.js.map

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

package/dist/wallet/provider.d.ts

@@ -0,0 +1,111 @@
+/**
+ * RPC Provider management
+ *
+ * Handles connection to blockchain nodes with:
+ * - Automatic fallback to backup URLs
+ * - Retry with exponential backoff
+ * - Gas price estimation
+ */
+import { type Abi, type PublicClient } from "viem";
+import type { Address } from "../types/primitives.js";
+import type { GasEstimate, ProviderConfig } from "./types.js";
+/**
+ * Provider wrapper with fallback and retry support
+ */
+export declare class Provider {
+    private client;
+    private config;
+    private currentUrlIndex;
+    constructor(config: ProviderConfig);
+    /**
+     * Get the chain ID
+     */
+    get chainId(): number;
+    /**
+     * Get the current RPC URL
+     */
+    get rpcUrl(): string;
+    /**
+     * Get underlying viem client
+     */
+    getClient(): PublicClient;
+    /**
+     * Get the current block number
+     */
+    getBlockNumber(): Promise<bigint>;
+    /**
+     * Get the balance of an address
+     */
+    getBalance(address: Address): Promise<bigint>;
+    /**
+     * Get the nonce for an address
+     */
+    getNonce(address: Address): Promise<number>;
+    /**
+     * Estimate gas for a transaction
+     */
+    estimateGas(tx: {
+        to: Address;
+        data?: string;
+        value?: bigint;
+        from?: Address;
+    }): Promise<bigint>;
+    /**
+     * Get current gas prices (EIP-1559)
+     */
+    getGasPrices(): Promise<{
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }>;
+    /**
+     * Get full gas estimate for a transaction
+     */
+    getGasEstimate(tx: {
+        to: Address;
+        data?: string;
+        value?: bigint;
+        from?: Address;
+    }): Promise<GasEstimate>;
+    /**
+     * Read contract data
+     */
+    readContract<T>(params: {
+        address: Address;
+        abi: Abi;
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<T>;
+    /**
+     * Wait for a transaction receipt
+     */
+    waitForTransaction(hash: string, confirmations?: number): Promise<unknown>;
+    /**
+     * Execute with retry and fallback
+     */
+    private withRetry;
+    /**
+     * Check if we should switch to a different provider
+     */
+    private shouldSwitchProvider;
+    /**
+     * Switch to a different RPC URL
+     */
+    private switchToUrl;
+    /**
+     * Sleep for a duration
+     */
+    private sleep;
+}
+/**
+ * Create a provider for a specific chain
+ */
+export declare function createProvider(chainId: number, rpcUrl?: string): Provider;
+/**
+ * Format wei to human-readable string
+ */
+export declare function formatWei(wei: bigint, decimals?: number): string;
+/**
+ * Format gas cost to USD (rough estimate)
+ */
+export declare function formatGasCostUsd(gasUsed: bigint, gasPrice: bigint, ethPriceUsd?: number): string;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/wallet/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,KAAK,GAAG,EAAE,KAAK,YAAY,EAAsB,MAAM,MAAM,CAAC;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2E9D;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAK;gBAEhB,MAAM,EAAE,cAAc;IAqBlC;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE;QACpB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC;IAWnB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAeF;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE;QACvB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,CAAC;IAcxB;;OAEG;IACG,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,GAAG,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAC3B,GAAG,OAAO,CAAC,CAAC,CAAC;IAYd;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E;;OAEG;YACW,SAAS;IAgCvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAgBzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAa5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,SAAO,GAAG,MAAM,CAM9F"}