bnbchain-mcp

Instructions

Implementation Reference

• src/evm/modules/wallet/tools.ts:17-32 (handler)

  Handler function that formats the input private key (ensuring 0x prefix) and delegates to the service to derive the EVM address.

  async ({ privateKey }) => {
    try {
      // Ensure the private key has 0x prefix
      const formattedKey = privateKey.startsWith("0x")
        ? (privateKey as Hex)
        : (`0x${privateKey}` as Hex)
  
      const address = services.getAddressFromPrivateKey(formattedKey)
  
      return mcpToolRes.success({
        address
      })
    } catch (error) {
      return mcpToolRes.error(error, "deriving address from private key")
    }
  }

• src/evm/modules/wallet/tools.ts:12-33 (registration)

  Registers the 'get_address_from_private_key' tool on the MCP server with description, input schema, and handler.

    "get_address_from_private_key",
    "Get the EVM address derived from a private key",
    {
      privateKey: privateKeyParam
    },
    async ({ privateKey }) => {
      try {
        // Ensure the private key has 0x prefix
        const formattedKey = privateKey.startsWith("0x")
          ? (privateKey as Hex)
          : (`0x${privateKey}` as Hex)
  
        const address = services.getAddressFromPrivateKey(formattedKey)
  
        return mcpToolRes.success({
          address
        })
      } catch (error) {
        return mcpToolRes.error(error, "deriving address from private key")
      }
    }
  )

• src/evm/modules/common/types.ts:17-22 (schema)

  Zod schema definition for the privateKey input parameter used in the tool schema.

  export const privateKeyParam = z
    .string()
    .describe(
      "Private key in hex format (with or without 0x prefix). SECURITY: This is used only for address derivation and is not stored. The private key will not be logged or displayed in chat history."
    )
    .default(process.env.PRIVATE_KEY as string)

• src/evm/services/clients.ts:66-69 (helper)

  Core utility function that derives an EVM address from a private key using viem's privateKeyToAccount.

  export function getAddressFromPrivateKey(privateKey: Hex): Address {
    const account = privateKeyToAccount(privateKey)
    return account.address
  }