@ethernauta/eth

Philosophy

This module aims to be an un-opinionated representation of the defined:

• Ethereum schemas
• Ethereum base methods
• abi-spec

Modules

• abi NPM
• chain NPM
• cli NPM
• erc NPM
• eth NPM
• transaction NPM
• utils NPM
• wallet NPM

Table of contents

• API
• core
• method

API

Reading from the blockchain

import { eth_getBlockByHash } from "@ethernauta/eth";
import { reader, SEPOLIA_CHAIN_ID } from "./reader";

const readable = eth_getBlockByHash([
  "0x31386e6cfba70bb4d8a95404bdb740572b758a15c62e51ee912071a7b5be9e26",
  false,
]);
const block = await readable(reader(SEPOLIA_CHAIN_ID));

Signing a transaction

import { eth_sendRawTransaction } from "@ethernauta/eth"
import { number_to_hex } from "@ethernauta/wallet"

const method = "transfer"
const ADDRESS = "0x515e9e0565fdddd4f8a9759744734154da453585"
const params = [ADDRESS, number_to_hex(1)]
const signed_transaction = await window.wallet.sign(
  method,
  params,
)

Writting to the blockchain

import { transfer } from "@ethernauta/eth"
import { number_to_hex } from "@ethernauta/wallet"
import { writer, SEPOLIA_CHAIN_ID } from "./writer"

const writable = transfer([
  "0x636c0fcd6da2207abfa80427b556695a4ad0af94",
  number_to_hex(1),
])
const hash = await writable(writer(SEPOLIA_CHAIN_ID))
await writable(writer(SEPOLIA_CHAIN_ID))

Reacting to transaction states

import { transfer } from "@ethernauta/eth"
import { number_to_hex } from "@ethernauta/wallet"
import { writer, SEPOLIA_CHAIN_ID } from "./writer"
import {
  watch_transaction,
  register_transaction
} from "@ethernauta/transaction"

const writable = transfer([
  "0x636c0fcd6da2207abfa80427b556695a4ad0af94",
  number_to_hex(1),
])
const hash = await writable(writer(SEPOLIA_CHAIN_ID))
// initial transaction state 
// with "type" key equal "pending"
const transaction = register_transaction(hash)
watch_transaction(hash, (transaction) => {
  // subsequent states that the transaction goes trough
})

Files to pay attention

core

• block.ts
• client.ts
• filter.ts
• receipt.ts
• state.ts
• withdrawal.ts

base

• address.ts
• addressses.ts
• base/byte.ts
• base/bytes/ts
• base/bytes-8.ts
• base/bytes-32.ts
• base/bytes-48.ts
• base/bytes-65.ts
• base/bytes-256.ts
• base/bytes-max-32.ts
• base/hash-32.ts
• base/not-found.ts
• base/ratio.ts
• base/uint.ts
• base/uint-64.ts
• base/uint-256.ts

transaction

• transaction/1559.ts
• transaction/2930.ts
• transaction/4844.ts
• transaction/access-list.ts
• transaction/generic.ts
• transaction/info.ts
• transaction/legacy.ts
• transaction/signed.ts
• transaction/unsigned.ts

abi

• abi/error.ts
• abi/client.ts
• abi/shared.ts

function

• function/shared.ts
• function/function.ts
• function/constructor.ts
• function/fallback.ts
• function/receive.ts

method

eip

• eip/1102/request-accounts/request-accounts.ts

block

• block/get-block-by-hash.ts
• block/get-block-by-number.ts
• block/get-block-receipts.ts
• block/get-block-transaction-count-by-hash.ts
• block/get-block-transaction-count-by-number.ts
• block/get-uncle-count-by-block-hash.ts
• block/get-uncle-count-by-block-number.ts

client

• client/accounts.ts
• client/block-number.ts
• client/chain-id.ts
• client/coinbase.ts
• client/syncing.ts

execute

• execute/call.ts
• execute/create-access-list.ts
• execute/estimate-gas.ts

fee-market

• fee-market/fee-history.ts
• fee-market/gas-price.ts
• fee-market/max-priority-fee-per-gas.ts

filter

• filter/get-filter-changes.ts
• filter/get-filter-logs.ts
• filter/get-logs.ts
• filter/new-block-filter.ts
• filter/new-filter.ts
• filter/new-pending-transaction-filter.ts
• filter/uninstall-filter.ts

sign

• sign/sign.ts
• sign/sign-transaction.ts

state

• state/get-balance.ts
• state/get-code.ts
• state/get-proof.ts
• state/get-storage-at.ts
• state/get-transaction-count.ts

submit

• submit/send-raw-transaction.ts
• submit/send-transaction.ts

transaction

• transaction/get-transaction-by-block-hash-and-index.ts
• transaction/get-transaction-by-block-number-and-index.ts
• transaction/get-transaction-by-hash.ts
• transaction/get-transaction-receipt.ts