nuthatch

Nests

The nest catalogue

A nest is a packaged indexing definition — ABIs, decoded event tables and declarative views — for a contract or protocol. Point Nuthatch at one and you get a self-hosted equivalent of the subgraph you'd otherwise rent.

Nests live as git repos on github.com/nuthatch-indexer. Consuming one is a clone; publishing one is a git push. This page is a catalogue for humans — it hands you a URL, your machine fetches from GitHub. Nothing routes through us.

From a published nest
nuthatch init --from https://github.com/nuthatch-indexer/horizon-nest
Or straight from an address
nuthatch init 0xYourContract --chain mainnet

The full demand-ranked reasoning behind these picks lives in the nest-catalogue in the repo.

Available now

4

Installable today — from a published nest repo, or generated straight from a contract address.

  • Graph Horizon

    available
    Graph infra Tier 0 · beachhead medium

    The Graph's own protocol state — staking provisions, allocations, delegation, curation and rewards. The data every indexer pays GRT to read today.

    events ProvisionCreated, AllocationCreated, AllocationClosed, TokensDelegated, Signalled, HorizonRewardsAssigned

    Arbitrum
    nuthatch init --from https://github.com/nuthatch-indexer/horizon-nest
    nuthatch-indexer/horizon-nest ↗

    Covers the Horizon staking/service surface today (operators, allocations, delegations, rewards); extending to the full network-subgraph surface — Indexer Directory, Curation, Epochs (RFC-0011).

  • ERC-20 token

    available
    Token Tier 1 trivial

    Any ERC-20 — transfers, holders and supply. Generated straight from the contract address; no repo to clone.

    events Transfer, Approval

    EthereumArbitrumBase
    nuthatch init 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain mainnet

    Generic decode — works for any token today. The example above is USDC.

  • ERC-721 / ERC-1155 NFT

    available
    NFT Tier 1 low

    Any NFT collection — ownership and full transfer history, resolved from the collection address.

    events Transfer, ApprovalForAll, TransferSingle, TransferBatch

    EthereumArbitrumBase
    nuthatch init 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D --chain mainnet

    Generic decode — works for any collection today. The example above is BAYC.

  • Uniswap V3

    available
    DEX Tier 1 factory high

    Concentrated-liquidity DEX — every pool discovered from the factory, with swaps, prices, and gross volume. The showcase for factory discovery: one rule tracks every pool, no per-pool config.

    events PoolCreated, Swap, Mint, Burn, Collect, Flash

    ArbitrumEthereumOptimismBasePolygon
    nuthatch init --from https://github.com/nuthatch-indexer/uniswap-v3
    nuthatch-indexer/uniswap-v3 ↗

    Configured for Arbitrum; the factory address is identical on every chain, so re-pointing is a two-line edit. Token decimals / USD pricing need a vendored token list (the declarative core makes no contract calls).

Planned

12

On the catalogue, demand-ranked. Not built yet — no fake install commands.

  • Epoch Block Oracle

    planned
    Graph infra Tier 0 · beachhead medium

    The per-epoch canonical block for every indexed chain — the reference all indexers use to close multichain allocations consistently.

    events DataEdge calldata payloads (EventfulDataEdge emits on Arbitrum)

    Arbitrum

    Needs the calldata decoder (the node-independent RFC-0014 slice).

  • QoS / Rewards-Eligibility Oracle

    planned
    Graph infra Tier 0 · beachhead high

    Indexer quality-of-service and reward eligibility — off-chain gateway telemetry posted on-chain.

    events Rewards Eligibility Oracle postings (GIP-0079)

    Arbitrum

    On-chain shape still consolidating post-Horizon — a watch-and-follow target.

  • Aave V3

    planned
    Lending Tier 1 medium

    The lending flagship — supplies, borrows, repayments, liquidations and rates across 20+ chains.

    events Supply, Borrow, Repay, LiquidationCall, ReserveUsedAsCollateral

    EthereumArbitrumOptimismBasePolygon

  • ENS

    planned
    Name service Tier 1 medium

    The archetypal name-service index — registrations, expiries, resolvers and records across the registry and registrar.

    events NameRegistered, NameRenewed, Transfer, NewResolver

    Ethereum

  • Uniswap V2 + Sushiswap

    planned
    DEX Tier 2 factory medium

    Constant-product AMM — the simpler Uniswap, and the template Sushiswap reuses. One nest, two protocols.

    events PairCreated, Swap, Mint, Burn, Sync

    EthereumArbitrumOptimismBasePolygon

  • Compound V2 + V3

    planned
    Lending Tier 2 medium

    cToken and Comet money-markets — supply, borrow, repayment and liquidation.

    events Mint, Redeem, Borrow, RepayBorrow, LiquidateBorrow

    EthereumArbitrumBasePolygon

  • Lido

    planned
    Staking / LST Tier 2 medium

    The liquid-staking leader — stETH/wstETH deposits, withdrawals, rebases and oracle reporting.

    events Submitted, Transfer, TokenRebased, WithdrawalRequested

    Ethereum

  • Seaport (OpenSea)

    planned
    NFT marketplace Tier 2 medium

    The protocol behind the largest NFT marketplace — order fulfilment and cancellation.

    events OrderFulfilled, OrderCancelled, CounterIncremented

    EthereumArbitrumOptimismBasePolygon

  • Curve

    planned
    DEX Tier 2 factory high

    StableSwap AMM — pools, exchanges and liquidity with invariant pricing.

    events TokenExchange, AddLiquidity, RemoveLiquidity

    EthereumArbitrumOptimismPolygon

  • EigenLayer

    planned
    Restaking Tier 3 medium

    Restaking — operator registration, staker delegation, deposits and withdrawals.

    events OperatorRegistered, StakerDelegated, Deposit, WithdrawalQueued

    Ethereum

  • GMX

    planned
    Perps Tier 3 high

    Perpetuals — position lifecycle, PnL and liquidations.

    events IncreasePosition, DecreasePosition, LiquidatePosition

    Arbitrum

  • MakerDAO / Sky

    planned
    CDP Tier 3 high

    The DAI/USDS CDP engine — vaults, collateral and liquidations.

    events vat.frob, vat.grab, Bark (Dog)

    Ethereum