convert_formatted_to_wei
Convert formatted token amounts (e.g., '1.5 ETH') to wei using specified decimals, enabling precise blockchain transactions. Ideal for DeFi trading and token operations.
Instructions
Convert formatted amounts to wei using ethers.js
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Formatted amount (e.g., '1.5' for 1.5 ETH) | |
| decimals | Yes | Number of decimal places for the token (e.g., 18 for ETH, 6 for USDC) |
Input Schema (JSON Schema)
{
"properties": {
"amount": {
"description": "Formatted amount (e.g., '1.5' for 1.5 ETH)",
"type": "string"
},
"decimals": {
"description": "Number of decimal places for the token (e.g., 18 for ETH, 6 for USDC)",
"type": "integer"
}
},
"required": [
"amount",
"decimals"
],
"type": "object"
}
Implementation Reference
- src/toolService.js:779-807 (handler)The core handler function that implements the tool logic: validates input, uses ethers.parseUnits to convert formatted amount to wei, and returns formatted result with metadata.async convertFormattedToWei(params) { const { amount, decimals } = params; if (!amount) { throw new Error("amount is required"); } if (decimals === undefined || decimals === null) { throw new Error("decimals is required"); } try { // Convert the formatted amount to wei (BigNumber) const weiAmount = ethers.parseUnits(amount.toString(), decimals); return { message: "Formatted to wei conversion completed successfully", data: { originalAmount: amount.toString(), decimals: decimals, weiAmount: weiAmount.toString(), unit: decimals === 18 ? "ETH" : `${decimals} decimals`, }, summary: `Converted ${amount} (${decimals} decimals) to ${weiAmount.toString()} wei`, }; } catch (error) { throw new Error(`Formatted to wei conversion failed: ${error.message}`); } }
- src/index.js:954-971 (schema)MCP tool schema definition including input validation schema (amount: string, decimals: integer) and description.name: TOOL_NAMES.CONVERT_FORMATTED_TO_WEI, description: "Convert formatted amounts to wei using ethers.js", inputSchema: { type: "object", properties: { amount: { type: "string", description: "Formatted amount (e.g., '1.5' for 1.5 ETH)", }, decimals: { type: "integer", description: "Number of decimal places for the token (e.g., 18 for ETH, 6 for USDC)", }, }, required: ["amount", "decimals"], }, },
- src/index.js:1178-1180 (registration)Dispatcher switch case that routes tool calls to the specific handler method in ToolService.case TOOL_NAMES.CONVERT_FORMATTED_TO_WEI: result = await toolService.convertFormattedToWei(args); break;
- src/constants.js:45-45 (helper)Constant definition mapping the tool name constant to its string identifier used throughout the codebase.CONVERT_FORMATTED_TO_WEI: "convert_formatted_to_wei",