Onchain JS
JavaScript bridge for Ethereum — run npm packages on the BEAM via QuickBEAM. No Node.js required. Built on onchain.
Package Family
| Package | Purpose | Native Deps |
|---|---|---|
| onchain | Core Ethereum primitives, RPC, ABI, signing | None (pure Elixir) |
| onchain_aave | Aave V3 protocol wrappers | None (pure Elixir) |
| onchain_evm | Rust NIFs: revm simulation, Solidity parsing, codegen | Rustler |
| onchain_js (this) | JS bridge: npm packages on the BEAM | QuickBEAM (Zig NIF) |
Pick what you need — consumers who only need eth_call never compile Zig or Rust.
Installation
def deps do
[
{:onchain_js, "~> 0.1"}
]
end
Use Cases
- solc-js compilation —
.sol→ ABI + bytecode without installing solc natively - Uniswap v3 SDK routing — optimal swap paths, price impact via
@uniswap/v3-sdk - DeFiSaver recipe builder — flash loan recipes via
@defisaver/sdk - Merkle proof construction — airdrop claims, storage proofs via
merkletreejs - Aave math cross-validation — validate Elixir math against
@aave/math-utils - 1inch Fusion SDK — DEX aggregation across protocols
How It Works
QuickBEAM embeds QuickJS-NG as a Zig NIF. Each runtime is a GenServer with a persistent JavaScript context. npm_ex manages package installation without Node.js.
Testing
mix test.json --quiet # Unit tests
mix test.json --quiet --include integration # Integration tests (requires QuickBEAM)