ethkit

Pure TypeScript Ethereum library. Drop-in replacement for the most-used parts of ethers.js.

No Proxy objects, no class inheritance, no dynamic imports, no native addons. Just functions.

Compatible with Perry — the TypeScript-to-native compiler.

Install

npm install ethkit

Dependencies: @noble/hashes, @noble/curves (both pure TypeScript).

Quick start

import {
    createProvider, createWallet, Contract,
    parseEther, formatEther, Interface,
} from 'ethkit';

// Provider (HTTP JSON-RPC)
const provider = createProvider('https://rpc.example.com', 1);

// Wallet
const wallet = createWallet('0xYOUR_PRIVATE_KEY', provider);

// Send ETH
const tx = await wallet.sendTransaction({
    to: '0x...',
    value: parseEther('1.0'),
});
const receipt = await tx.wait();

// Contract interaction
const erc20 = Contract('0xTokenAddress', [
    'function balanceOf(address) view returns (uint256)',
    'function transfer(address, uint256) returns (bool)',
], provider);

const balance = await erc20.balanceOf('0x...');
console.log(formatEther(balance));

What's included

Module	Exports	ethers.js equivalent
Units	parseEther, formatEther, parseUnits, formatUnits	ethers.parseEther, etc.
ABI	encode, decode, encodeFunctionData, decodeFunctionResult, functionSelector, eventTopic	AbiCoder, Interface
Interface	new Interface(abi) with encodeFunctionData, decodeFunctionResult, parseTransaction, parseLog	ethers.Interface
Contract	Contract(address, abi, providerOrWallet)	new ethers.Contract(...)
Provider	createProvider(url, chainId) with call, send, getBlock, getBalance, getTransactionReceipt, etc.	ethers.JsonRpcProvider
Wallet	createWallet(key, provider) with signMessage, signTransaction, sendTransaction	ethers.Wallet
Transaction	serializeEip1559, serializeLegacy, transactionHash	ethers.Transaction
Hashing	keccak256, id, toUtf8Bytes, toUtf8String	ethers.keccak256, ethers.id
Address	getAddress, isAddress, computeAddress	ethers.getAddress, etc.
Utils	hexlify, zeroPadValue, dataSlice, concat, toQuantity, toBigInt, isHexString	Various ethers.* utils
Constants	ZeroAddress, ZeroHash, MaxUint256	ethers.ZeroAddress, etc.
RLP	rlpEncode	ethers.encodeRlp
AbiCoder	AbiCoder.defaultAbiCoder()	ethers.AbiCoder.defaultAbiCoder()

Design choices

• Functions, not classes. createProvider() and createWallet() return plain objects. Contract() is a function call, not new Contract().
• HTTP only. Provider uses fetch(). No WebSocket support (use a dedicated WS library if needed).
• Native BigInt. All numeric values are bigint. No BigNumber wrapper.
• Throws on bad input. parseUnits('1.12345', 4) throws (too many decimals) rather than silently truncating.
• Minimal surface. ~1,700 lines of source covering the most common Ethereum operations.
• Perry compatible. No Proxy, no __proto__, no dynamic imports, no class inheritance — compiles cleanly to native code.

ABI support

Supports both human-readable and JSON ABI formats:

// Human-readable
const iface = new Interface([
    'function transfer(address to, uint256 amount) returns (bool)',
    'event Transfer(address indexed from, address indexed to, uint256 value)',
]);

// JSON ABI
const iface2 = new Interface([
    { type: 'function', name: 'transfer', inputs: [...], outputs: [...] },
]);

Supported ABI types: uint8-uint256, int8-int256, address, bool, bytes1-bytes32, bytes, string, and dynamic arrays (type[]) of all the above. Tuples are not yet supported.

Tests

Tests compare every function's output against ethers.js to ensure identical behavior:

npm test

159 tests across units, ABI, address, hashing, utils, transactions, and wallet signing.

License

MIT