@ethernauta/core

Philosophy

This module is the canonical home of the primitive Valibot schemas used everywhere else in the monorepo — addresses, fixed-width byte sequences, uintN sizes, the 32-byte hash type, and a few small protocol primitives. Every other package depends on it; nothing here depends on the rest of the library.

The shapes mirror the Ethereum execution-apis base types. A schema in @ethernauta/core is the single source of truth — feature packages compose these primitives instead of redeclaring regexes.

Modules

• abi [NPM]
• chain [NPM]
• cli [NPM]
• core [NPM]
• crypto [NPM]
• eip [NPM]
• ens [NPM]
• erc [NPM]
• eth [NPM]
• react [NPM]
• transaction [NPM]
• transport [NPM]
• utils [NPM]
• wallet

API

Every export pairs a xxxSchema Valibot schema with an Xxx type inferred via v.InferOutput. The idiom across the monorepo is:

import { parse } from "valibot"
import { addressSchema } from "@ethernauta/core"

function transfer(_to: string) {
  const to = parse(addressSchema, _to) // validated `Address`
  // …
}

Address

import { type Address, addressSchema, addressesSchema } from "@ethernauta/core"

// `addressSchema`     — single 0x-prefixed 20-byte address
// `addressesSchema`   — array of addresses

Hash

import { type Hash32, hash32Schema } from "@ethernauta/core"

// `hash32Schema` — 0x-prefixed 32-byte hash (transaction / block / topic)

Bytes

import {
  type Byte, byteSchema,
  type Bytes, bytesSchema,
  type BytesMax32, bytesMax32Schema,
  type Bytes4, bytes4Schema,
  type Bytes8, bytes8Schema,
  type Bytes32, bytes32Schema,
  type Bytes48, bytes48Schema,
  type Bytes64, bytes64Schema,
  type Bytes65, bytes65Schema,
  type Bytes256, bytes256Schema,
} from "@ethernauta/core"

// `byteSchema`       — single 0x-prefixed byte
// `bytesSchema`      — arbitrary 0x-prefixed byte string
// `bytesMax32Schema` — 0x-prefixed byte string ≤ 32 bytes
// `bytesNSchema`     — fixed-width N-byte string (4, 8, 32, 48, 64, 65, 256)

Unsigned integers

import {
  type Uint, uintSchema,
  type Uint8, uint8Schema,
  type Uint16, uint16Schema,
  type Uint24, uint24Schema,
  type Uint32, uint32Schema,
  type Uint40, uint40Schema,
  type Uint48, uint48Schema,
  type Uint56, uint56Schema,
  type Uint64, uint64Schema,
  type Uint96, uint96Schema,
  type Uint128, uint128Schema,
  type Uint160, uint160Schema,
  type Uint192, uint192Schema,
  type Uint224, uint224Schema,
  type Uint256, uint256Schema,
} from "@ethernauta/core"

// One schema per ABI uintN width. All accept 0x-prefixed
// quantities, validated against `2^N - 1`.

Ratio

import { type Ratio, ratioSchema } from "@ethernauta/core"

// A 0x-prefixed fraction in [0, 1] (used by tip / cap ratios).

NotFound

import { type NotFound, notFoundSchema } from "@ethernauta/core"

// The protocol's "absent" sentinel — `null` wrapped as a schema
// so JSON-RPC responses that may resolve to `null` (missing
// block, missing receipt) can be composed with `union([…, notFoundSchema])`.