@grimoirelabs/core 0.1.0

package/dist/wallet/tx-builder.js

@@ -0,0 +1,290 @@
+/**
+ * Transaction builder
+ *
+ * Builds transactions from spell actions, supporting:
+ * - ERC20 operations (transfer, approve)
+ * - Swap operations
+ * - Lending operations (deposit, withdraw)
+ */
+import { encodeFunctionData, parseAbi } from "viem";
+import { getNativeCurrencySymbol, isNativeCurrency } from "./types.js";
+/** Standard ERC20 ABI */
+const ERC20_ABI = parseAbi([
+    "function transfer(address to, uint256 amount) returns (bool)",
+    "function approve(address spender, uint256 amount) returns (bool)",
+    "function balanceOf(address account) view returns (uint256)",
+    "function allowance(address owner, address spender) view returns (uint256)",
+    "function decimals() view returns (uint8)",
+    "function symbol() view returns (string)",
+]);
+/**
+ * Transaction builder class
+ */
+export class TransactionBuilder {
+    provider;
+    fromAddress;
+    constructor(provider, fromAddress) {
+        this.provider = provider;
+        this.fromAddress = fromAddress;
+    }
+    /**
+     * Build a transaction from an action
+     */
+    async buildAction(action) {
+        switch (action.type) {
+            case "transfer":
+                return this.buildTransfer(action);
+            case "approve":
+                return this.buildApprove(action);
+            case "swap":
+                return this.buildSwap(action);
+            case "lend":
+                return this.buildLend(action);
+            case "withdraw":
+                return this.buildWithdraw(action);
+            default:
+                throw new Error(`Unsupported action type: ${action.type}`);
+        }
+    }
+    /**
+     * Build a transfer transaction (native ETH or ERC20)
+     */
+    async buildTransfer(action) {
+        if (action.type !== "transfer") {
+            throw new Error("Invalid action type for transfer");
+        }
+        const toAddress = action.to;
+        const amount = BigInt(action.amount?.toString() ?? "0");
+        const isNative = isNativeCurrency(action.asset ?? "", this.provider.chainId);
+        let tx;
+        if (isNative) {
+            tx = {
+                to: toAddress,
+                value: amount,
+            };
+        }
+        else {
+            const tokenAddress = this.resolveAssetAddress(action.asset);
+            const data = encodeFunctionData({
+                abi: ERC20_ABI,
+                functionName: "transfer",
+                args: [toAddress, amount],
+            });
+            tx = {
+                to: tokenAddress,
+                data,
+                value: 0n,
+            };
+        }
+        const gasEstimate = await this.provider.getGasEstimate({
+            ...tx,
+            from: this.fromAddress,
+        });
+        return {
+            tx: {
+                ...tx,
+                gasLimit: gasEstimate.gasLimit,
+                maxFeePerGas: gasEstimate.maxFeePerGas,
+                maxPriorityFeePerGas: gasEstimate.maxPriorityFeePerGas,
+            },
+            description: `Transfer ${formatAmount(amount)} ${action.asset} to ${shortenAddress(toAddress)}`,
+            gasEstimate,
+            action,
+        };
+    }
+    /**
+     * Build an ERC20 approve transaction
+     */
+    async buildApprove(action) {
+        if (action.type !== "approve") {
+            throw new Error("Invalid action type for approve");
+        }
+        const tokenAddress = this.resolveAssetAddress(action.asset);
+        const spenderAddress = action.spender;
+        const amount = BigInt(action.amount?.toString() ?? "0");
+        const data = encodeFunctionData({
+            abi: ERC20_ABI,
+            functionName: "approve",
+            args: [spenderAddress, amount],
+        });
+        const tx = {
+            to: tokenAddress,
+            data,
+            value: 0n,
+        };
+        const gasEstimate = await this.provider.getGasEstimate({
+            ...tx,
+            from: this.fromAddress,
+        });
+        return {
+            tx: {
+                ...tx,
+                gasLimit: gasEstimate.gasLimit,
+                maxFeePerGas: gasEstimate.maxFeePerGas,
+                maxPriorityFeePerGas: gasEstimate.maxPriorityFeePerGas,
+            },
+            description: `Approve ${formatAmount(amount)} ${action.asset} for ${shortenAddress(spenderAddress)}`,
+            gasEstimate,
+            action,
+        };
+    }
+    /**
+     * Build a swap transaction (placeholder - requires venue adapter)
+     */
+    async buildSwap(action) {
+        if (action.type !== "swap") {
+            throw new Error("Invalid action type for swap");
+        }
+        // TODO: Implement with venue adapters in Phase 2
+        throw new Error(`Swap transactions require venue adapters. Venue: ${action.venue}, ` +
+            `${action.assetIn} → ${action.assetOut}`);
+    }
+    /**
+     * Build a lending deposit transaction (placeholder - requires venue adapter)
+     */
+    async buildLend(action) {
+        if (action.type !== "lend") {
+            throw new Error("Invalid action type for lend");
+        }
+        // TODO: Implement with venue adapters in Phase 2
+        throw new Error(`Lend transactions require venue adapters. Venue: ${action.venue}, ` +
+            `Asset: ${action.asset}`);
+    }
+    /**
+     * Build a withdrawal transaction (placeholder - requires venue adapter)
+     */
+    async buildWithdraw(action) {
+        if (action.type !== "withdraw") {
+            throw new Error("Invalid action type for withdraw");
+        }
+        // TODO: Implement with venue adapters in Phase 2
+        throw new Error(`Withdraw transactions require venue adapters. Venue: ${action.venue}, ` +
+            `Asset: ${action.asset}`);
+    }
+    /**
+     * Build a raw transaction
+     */
+    async buildRaw(to, data, value = 0n, description = "Raw transaction") {
+        const tx = {
+            to,
+            data,
+            value,
+        };
+        const gasEstimate = await this.provider.getGasEstimate({
+            ...tx,
+            from: this.fromAddress,
+        });
+        const action = {
+            type: "transfer",
+            asset: getNativeCurrencySymbol(this.provider.chainId),
+            amount: { kind: "literal", value: 0n, type: "int" },
+            to,
+        };
+        return {
+            tx: {
+                ...tx,
+                gasLimit: gasEstimate.gasLimit,
+                maxFeePerGas: gasEstimate.maxFeePerGas,
+                maxPriorityFeePerGas: gasEstimate.maxPriorityFeePerGas,
+            },
+            description,
+            gasEstimate,
+            action,
+        };
+    }
+    /**
+     * Check ERC20 allowance
+     */
+    async checkAllowance(tokenAddress, spenderAddress) {
+        return await this.provider.readContract({
+            address: tokenAddress,
+            abi: ERC20_ABI,
+            functionName: "allowance",
+            args: [this.fromAddress, spenderAddress],
+        });
+    }
+    /**
+     * Check ERC20 balance
+     */
+    async checkBalance(tokenAddress) {
+        return await this.provider.readContract({
+            address: tokenAddress,
+            abi: ERC20_ABI,
+            functionName: "balanceOf",
+            args: [this.fromAddress],
+        });
+    }
+    /**
+     * Get token decimals
+     */
+    async getTokenDecimals(tokenAddress) {
+        return await this.provider.readContract({
+            address: tokenAddress,
+            abi: ERC20_ABI,
+            functionName: "decimals",
+        });
+    }
+    /**
+     * Get token symbol
+     */
+    async getTokenSymbol(tokenAddress) {
+        return await this.provider.readContract({
+            address: tokenAddress,
+            abi: ERC20_ABI,
+            functionName: "symbol",
+        });
+    }
+    /**
+     * Resolve asset symbol to address
+     * TODO: Implement proper asset registry
+     */
+    resolveAssetAddress(asset) {
+        if (!asset) {
+            throw new Error("Asset is required");
+        }
+        // If it's already an address, return it
+        if (asset.startsWith("0x") && asset.length === 42) {
+            return asset;
+        }
+        // Known token addresses (mainnet)
+        const KNOWN_TOKENS = {
+            USDC: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+            USDT: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+            DAI: "0x6B175474E89094C44Da98b954EescdeCB5cB92c0",
+            WETH: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+            WBTC: "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
+        };
+        const address = KNOWN_TOKENS[asset.toUpperCase()];
+        if (!address) {
+            throw new Error(`Unknown asset: ${asset}. Provide address directly.`);
+        }
+        return address;
+    }
+}
+/**
+ * Shorten an address for display
+ */
+function shortenAddress(address) {
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+/**
+ * Format an amount for display
+ */
+function formatAmount(amount, decimals = 18) {
+    const divisor = 10n ** BigInt(decimals);
+    const integerPart = amount / divisor;
+    const fractionalPart = amount % divisor;
+    if (fractionalPart === 0n) {
+        return integerPart.toString();
+    }
+    const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+    const trimmed = fractionalStr.slice(0, 4).replace(/0+$/, "") || "0";
+    return `${integerPart}.${trimmed}`;
+}
+/**
+ * Create a transaction builder
+ */
+export function createTransactionBuilder(provider, fromAddress) {
+    return new TransactionBuilder(provider, fromAddress);
+}
+//# sourceMappingURL=tx-builder.js.map

package/dist/wallet/tx-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-builder.js","sourceRoot":"","sources":["../../src/wallet/tx-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAIpD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGvE,yBAAyB;AACzB,MAAM,SAAS,GAAG,QAAQ,CAAC;IACzB,8DAA8D;IAC9D,kEAAkE;IAClE,4DAA4D;IAC5D,2EAA2E;IAC3E,0CAA0C;IAC1C,yCAAyC;CAC1C,CAAC,CAAC;AAcH;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,QAAQ,CAAW;IACnB,WAAW,CAAU;IAE7B,YAAY,QAAkB,EAAE,WAAoB;QAClD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACnC,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC;gBACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,EAAa,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE7E,IAAI,EAAsB,CAAC;QAE3B,IAAI,QAAQ,EAAE,CAAC;YACb,EAAE,GAAG;gBACH,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,MAAM;aACd,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,IAAI,GAAG,kBAAkB,CAAC;gBAC9B,GAAG,EAAE,SAAS;gBACd,YAAY,EAAE,UAAU;gBACxB,IAAI,EAAE,CAAC,SAA0B,EAAE,MAAM,CAAC;aAC3C,CAAC,CAAC;YACH,EAAE,GAAG;gBACH,EAAE,EAAE,YAAY;gBAChB,IAAI;gBACJ,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YACrD,GAAG,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,WAAW;SACvB,CAAC,CAAC;QAEH,OAAO;YACL,EAAE,EAAE;gBACF,GAAG,EAAE;gBACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;aACvD;YACD,WAAW,EAAE,YAAY,YAAY,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,OAAO,cAAc,CAAC,SAAS,CAAC,EAAE;YAC/F,WAAW;YACX,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,MAAM,CAAC,OAAkB,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC;QAExD,MAAM,IAAI,GAAG,kBAAkB,CAAC;YAC9B,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,cAA+B,EAAE,MAAM,CAAC;SAChD,CAAC,CAAC;QAEH,MAAM,EAAE,GAAuB;YAC7B,EAAE,EAAE,YAAY;YAChB,IAAI;YACJ,KAAK,EAAE,EAAE;SACV,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YACrD,GAAG,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,WAAW;SACvB,CAAC,CAAC;QAEH,OAAO;YACL,EAAE,EAAE;gBACF,GAAG,EAAE;gBACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;aACvD;YACD,WAAW,EAAE,WAAW,YAAY,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,QAAQ,cAAc,CAAC,cAAc,CAAC,EAAE;YACpG,WAAW;YACX,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,iDAAiD;QACjD,MAAM,IAAI,KAAK,CACb,oDAAoD,MAAM,CAAC,KAAK,IAAI;YAClE,GAAG,MAAM,CAAC,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAE,CAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,iDAAiD;QACjD,MAAM,IAAI,KAAK,CACb,oDAAoD,MAAM,CAAC,KAAK,IAAI;YAClE,UAAU,MAAM,CAAC,KAAK,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,iDAAiD;QACjD,MAAM,IAAI,KAAK,CACb,wDAAwD,MAAM,CAAC,KAAK,IAAI;YACtE,UAAU,MAAM,CAAC,KAAK,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAW,EACX,IAAY,EACZ,KAAK,GAAG,EAAE,EACV,WAAW,GAAG,iBAAiB;QAE/B,MAAM,EAAE,GAAuB;YAC7B,EAAE;YACF,IAAI;YACJ,KAAK;SACN,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YACrD,GAAG,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,WAAW;SACvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAW;YACrB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YACnD,EAAE;SACH,CAAC;QAEF,OAAO;YACL,EAAE,EAAE;gBACF,GAAG,EAAE;gBACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;aACvD;YACD,WAAW;YACX,WAAW;YACX,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,YAAqB,EAAE,cAAuB;QACjE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAS;YAC9C,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,YAAqB;QACtC,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAS;YAC9C,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,YAAqB;QAC1C,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAS;YAC9C,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,UAAU;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,YAAqB;QACxC,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAS;YAC9C,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,QAAQ;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,KAAyB;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,wCAAwC;QACxC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAClD,OAAO,KAAgB,CAAC;QAC1B,CAAC;QAED,kCAAkC;QAClC,MAAM,YAAY,GAA4B;YAC5C,IAAI,EAAE,4CAAuD;YAC7D,IAAI,EAAE,4CAAuD;YAC7D,GAAG,EAAE,4CAAuD;YAC5D,IAAI,EAAE,4CAAuD;YAC7D,IAAI,EAAE,4CAAuD;SAC9D,CAAC;QAEF,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,6BAA6B,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAgB;IACtC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,MAAc,EAAE,QAAQ,GAAG,EAAE;IACjD,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;IAExC,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEpE,OAAO,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAkB,EAClB,WAAoB;IAEpB,OAAO,IAAI,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC"}

package/dist/wallet/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Wallet and transaction types
+ */
+import type { Address } from "../types/primitives.js";
+/** Supported key source types */
+export type KeySourceType = "raw" | "env" | "mnemonic" | "keystore";
+/** Configuration for loading a private key */
+export interface KeyConfig {
+    /** Type of key source */
+    type: KeySourceType;
+    /** Source value - env var name, file path, or raw hex */
+    source: string;
+    /** Password for keystore files */
+    password?: string;
+    /** Derivation path for mnemonic (default: m/44'/60'/0'/0/0) */
+    derivationPath?: string;
+}
+/** Wallet interface for signing operations */
+export interface Wallet {
+    /** Get the wallet's address */
+    readonly address: Address;
+    /** Get the chain ID this wallet is connected to */
+    readonly chainId: number;
+    /** Sign a transaction */
+    signTransaction(tx: TransactionRequest): Promise<string>;
+    /** Sign a message */
+    signMessage(message: string): Promise<string>;
+    /** Send a signed transaction */
+    sendTransaction(tx: TransactionRequest): Promise<TransactionReceipt>;
+}
+/** Transaction request parameters */
+export interface TransactionRequest {
+    /** Recipient address */
+    to: Address;
+    /** Transaction value in wei */
+    value?: bigint;
+    /** Encoded calldata */
+    data?: string;
+    /** Gas limit */
+    gasLimit?: bigint;
+    /** Max fee per gas (EIP-1559) */
+    maxFeePerGas?: bigint;
+    /** Max priority fee per gas (EIP-1559) */
+    maxPriorityFeePerGas?: bigint;
+    /** Legacy gas price */
+    gasPrice?: bigint;
+    /** Transaction nonce */
+    nonce?: number;
+    /** Chain ID */
+    chainId?: number;
+}
+/** Transaction receipt after confirmation */
+export interface TransactionReceipt {
+    /** Transaction hash */
+    hash: string;
+    /** Block number */
+    blockNumber: bigint;
+    /** Block hash */
+    blockHash: string;
+    /** Gas used */
+    gasUsed: bigint;
+    /** Effective gas price */
+    effectiveGasPrice: bigint;
+    /** Transaction status (1 = success, 0 = failure) */
+    status: "success" | "reverted";
+    /** Contract address if deployment */
+    contractAddress?: Address;
+    /** Transaction logs */
+    logs: TransactionLog[];
+}
+/** Transaction log entry */
+export interface TransactionLog {
+    /** Contract address that emitted the log */
+    address: Address;
+    /** Log topics */
+    topics: string[];
+    /** Log data */
+    data: string;
+    /** Log index in the block */
+    logIndex: number;
+}
+/** RPC provider configuration */
+export interface ProviderConfig {
+    /** Chain ID */
+    chainId: number;
+    /** Primary RPC URL */
+    rpcUrl: string;
+    /** Fallback RPC URLs */
+    fallbackUrls?: string[];
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Retry attempts */
+    retries?: number;
+}
+/** Gas estimation result */
+export interface GasEstimate {
+    /** Estimated gas limit */
+    gasLimit: bigint;
+    /** Current max fee per gas */
+    maxFeePerGas: bigint;
+    /** Current max priority fee */
+    maxPriorityFeePerGas: bigint;
+    /** Estimated total cost in wei */
+    estimatedCost: bigint;
+}
+/** Supported chains with default configurations */
+export declare const CHAIN_CONFIGS: Record<number, ProviderConfig>;
+/** Check if a chain ID is a testnet */
+export declare function isTestnet(chainId: number): boolean;
+/** Get chain name from ID */
+export declare function getChainName(chainId: number): string;
+/** Get the native currency symbol for a chain */
+export declare function getNativeCurrencySymbol(chainId: number): string;
+/** Check if an asset is the native currency for a given chain */
+export declare function isNativeCurrency(asset: string, chainId: number): boolean;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/wallet/types.js

@@ -0,0 +1,86 @@
+/**
+ * Wallet and transaction types
+ */
+/** Supported chains with default configurations */
+export const CHAIN_CONFIGS = {
+    // Mainnets
+    1: {
+        chainId: 1,
+        rpcUrl: "https://eth.llamarpc.com",
+        fallbackUrls: ["https://rpc.ankr.com/eth", "https://ethereum.publicnode.com"],
+    },
+    10: {
+        chainId: 10,
+        rpcUrl: "https://mainnet.optimism.io",
+        fallbackUrls: ["https://rpc.ankr.com/optimism"],
+    },
+    137: {
+        chainId: 137,
+        rpcUrl: "https://polygon-rpc.com",
+        fallbackUrls: ["https://rpc.ankr.com/polygon"],
+    },
+    42161: {
+        chainId: 42161,
+        rpcUrl: "https://arb1.arbitrum.io/rpc",
+        fallbackUrls: ["https://rpc.ankr.com/arbitrum"],
+    },
+    8453: {
+        chainId: 8453,
+        rpcUrl: "https://mainnet.base.org",
+        fallbackUrls: ["https://base.llamarpc.com"],
+    },
+    999: {
+        chainId: 999,
+        rpcUrl: "https://rpc.hyperliquid.xyz/evm",
+    },
+    // Testnets
+    11155111: {
+        chainId: 11155111,
+        rpcUrl: "https://rpc.sepolia.org",
+        fallbackUrls: ["https://ethereum-sepolia.publicnode.com"],
+    },
+};
+/** Check if a chain ID is a testnet */
+export function isTestnet(chainId) {
+    const testnets = [11155111, 5, 80001, 421613, 84531];
+    return testnets.includes(chainId);
+}
+/** Get chain name from ID */
+export function getChainName(chainId) {
+    const names = {
+        1: "Ethereum Mainnet",
+        10: "Optimism",
+        137: "Polygon",
+        42161: "Arbitrum One",
+        8453: "Base",
+        999: "HyperEVM",
+        11155111: "Sepolia",
+        5: "Goerli",
+        80001: "Mumbai",
+        421613: "Arbitrum Goerli",
+        84531: "Base Goerli",
+    };
+    return names[chainId] ?? `Chain ${chainId}`;
+}
+/** Get the native currency symbol for a chain */
+export function getNativeCurrencySymbol(chainId) {
+    const symbols = {
+        1: "ETH",
+        10: "ETH",
+        137: "POL",
+        42161: "ETH",
+        8453: "ETH",
+        999: "ETH",
+        11155111: "ETH",
+        5: "ETH",
+        80001: "POL",
+        421613: "ETH",
+        84531: "ETH",
+    };
+    return symbols[chainId] ?? "ETH";
+}
+/** Check if an asset is the native currency for a given chain */
+export function isNativeCurrency(asset, chainId) {
+    return asset.toUpperCase() === getNativeCurrencySymbol(chainId).toUpperCase();
+}
+//# sourceMappingURL=types.js.map

package/dist/wallet/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wallet/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiHH,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,WAAW;IACX,CAAC,EAAE;QACD,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,0BAA0B;QAClC,YAAY,EAAE,CAAC,0BAA0B,EAAE,iCAAiC,CAAC;KAC9E;IACD,EAAE,EAAE;QACF,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,6BAA6B;QACrC,YAAY,EAAE,CAAC,+BAA+B,CAAC;KAChD;IACD,GAAG,EAAE;QACH,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,yBAAyB;QACjC,YAAY,EAAE,CAAC,8BAA8B,CAAC;KAC/C;IACD,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,8BAA8B;QACtC,YAAY,EAAE,CAAC,+BAA+B,CAAC;KAChD;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,0BAA0B;QAClC,YAAY,EAAE,CAAC,2BAA2B,CAAC;KAC5C;IACD,GAAG,EAAE;QACH,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,iCAAiC;KAC1C;IACD,WAAW;IACX,QAAQ,EAAE;QACR,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,yBAAyB;QACjC,YAAY,EAAE,CAAC,yCAAyC,CAAC;KAC1D;CACF,CAAC;AAEF,uCAAuC;AACvC,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAA2B;QACpC,CAAC,EAAE,kBAAkB;QACrB,EAAE,EAAE,UAAU;QACd,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,UAAU;QACf,QAAQ,EAAE,SAAS;QACnB,CAAC,EAAE,QAAQ;QACX,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,iBAAiB;QACzB,KAAK,EAAE,aAAa;KACrB,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,SAAS,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,OAAO,GAA2B;QACtC,CAAC,EAAE,KAAK;QACR,EAAE,EAAE,KAAK;QACT,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,KAAK;QACf,CAAC,EAAE,KAAK;QACR,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;KACb,CAAC;IACF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;AACnC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAe;IAC7D,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAChF,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@grimoirelabs/core",
+  "version": "0.1.0",
+  "description": "Core compiler and runtime for Grimoire",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./dist/types/index.js",
+    "./compiler": "./dist/compiler/index.js",
+    "./runtime": "./dist/runtime/index.js",
+    "./builders": "./dist/builders/index.js",
+    "./venues": "./dist/venues/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": ["dist"],
+  "dependencies": {
+    "ethers": "^6.12.1",
+    "viem": "^2.21.0",
+    "yaml": "^2.6.0",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "better-sqlite3": "^9.6.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  }
+}