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/nightswatchhq. 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/nightswatchhq/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

7

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/nightswatchhq/horizon-nest
    nightswatchhq/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 V4

    available
    DEX Tier 1 low

    Concentrated liquidity in a singleton - every pool lives inside one PoolManager, so there is no factory and no pool contracts. Hook adoption, per-pool activity and liquidity.

    events Initialize, Swap, ModifyLiquidity, Donate, Transfer, ProtocolFeeUpdated

    Ethereum
    nuthatch init --from https://github.com/nightswatchhq/uniswap-v4-ethereum
    nightswatchhq/uniswap-v4-ethereum ↗

    Structurally the SIMPLEST nest in the catalogue - one static contract, no templates, no factory rules. The work is volume, not config: ~17 events/block, ~68M events for full history from block 21688329 (~7 h at a measured 2,785 ev/s). Ships with a recent-history quickstart. No USD pricing (needs a token list; the declarative core makes no contract calls).

  • 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

    ArbitrumEthereumBase
    nuthatch init --from https://github.com/nightswatchhq/uniswap-v3
    nightswatchhq/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).

  • Livepeer

    available
    Video infra Tier 2 factory medium

    The Livepeer protocol - transcoders, rounds, delegators, tickets and governance polls. Built for feature parity with the official Livepeer subgraph.

    events TranscoderUpdate, Bond, Unbond, Rebond, EarningsClaimed, Reward, NewRound, WinningTicketRedeemed, PollCreated, Vote

    Arbitrum
    nuthatch init --from https://github.com/nightswatchhq/livepeer-nest
    nightswatchhq/livepeer-nest ↗

    All 11 subgraph dataSources, with the subgraph's own implementation ABIs vendored - Sourcify only exposes the ManagerProxy ABI, which omits every real event. Governance polls are factory-discovered.

  • POA

    available
    DAO tooling Tier 3 factory high

    A full DAO-tooling stack - org deployment, Hats-based roles, tasks and bounties, hybrid + direct-democracy voting, and a gas paymaster. Replaces a subgraph that had been stuck syncing for over a day.

    events OrgDeployed, ContractRegistered, TransferSingle, TaskCreated, TaskCompleted, NewProposal, VoteCast, UsageIncreased

    Arbitrum
    nuthatch init --from https://github.com/nightswatchhq/poa-nest
    nightswatchhq/poa-nest ↗

    19 contracts and 207 tables across 42.5M Arbitrum blocks - 848 events, sealed in 59s. The subgraph stalls on 10 file/ipfs data sources and 19 dynamic templates; this nest indexes metadata hashes instead of fetching CIDs, keeping the indexing path offline and deterministic.

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

    EthereumArbitrumBase

  • 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

    EthereumArbitrumBase

  • Compound V2 + V3

    planned
    Lending Tier 2 medium

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

    events Mint, Redeem, Borrow, RepayBorrow, LiquidateBorrow

    EthereumArbitrumBase

  • 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

    EthereumArbitrumBase

  • Curve

    planned
    DEX Tier 2 factory high

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

    events TokenExchange, AddLiquidity, RemoveLiquidity

    EthereumArbitrum

  • 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