For Developers

Guide for developers and integrators — build on ETH Strategy's tokens, contracts, and protocol interfaces.

You're building something that touches ETH Strategy — integrating esETH into a DEX, displaying STRAT in a wallet, building on the bonding mechanism, or querying protocol state for a dashboard. This guide points you to the right resources.

Quick Reference

Token
Standard
Key Integration Note

esETH

ERC-20

Non-rebasing. Balances never change except on transfer/mint/burn. Safe to cache. Supports ERC-2612 permits.

STRAT

ERC-20

Standard ERC-20. No inflation schedule — only minted through note conversion.

CDT

ERC-20

Each token = ~$1 protocol debt. totalSupply() = total protocol debt. Supports ERC-2612 permits.

sSTRAT-v2

ERC-20

Non-transferable. transfer() and approve() revert with TransferDisabled. Display-only.

NFT Option

ERC-721

Conversion rights. Requires CDT to exercise. Partial exercise supported.

ESPN

ERC-4626

Standard vault interface. Deposit USDS, receive shares.

Primary Resources

Integration Guide

The Developer Integration Guide is your main reference. It covers:

  • Solidity interfaces for every token

  • Recommended integration patterns (with opinionated guidance on what works best)

  • Production caveats and common pitfalls

  • Working ethers.js code examples

  • An end-to-end quickstart

Contract Addresses

All deployed contract addresses: Contracts

AI Agents

Building an autonomous agent that queries or interacts with ETH Strategy? The AI Agents page provides function selectors for direct RPC calls, typed protocol state schemas, machine-readable token metadata in JSON, safety rules for transaction agents, and derived metric formulas.

Machine-Readable Docs

The llms.txtarrow-up-right file provides a machine-readable protocol overview for AI assistants and automated tools. See LLMs.txt for details.

Key Integration Patterns

esETH is the easy one. Non-rebasing, standard ERC-20, supports permits. If you've integrated wstETH or rETH, esETH works the same way. Store and operate on balances directly — no rebase edge cases.

sSTRAT-v2 is display-only. Transfers revert. Show it in wallet UIs as a staked balance indicator, but do not attempt to transfer, pool, or use it as collateral.

CDT is a standard ERC-20 with economic meaning. Each CDT = ~$1 of protocol debt. totalSupply() gives you real-time protocol leverage. Useful for dashboards and risk monitoring.

NFT Options require CDT to exercise. If you're building an NFT marketplace integration, note that the NFT alone is not self-contained — the holder also needs CDT to convert.

Your Reading Path

  1. Developer Integration Guide — interfaces, patterns, code examples

  2. Contract Reference — full API reference for every function

  3. AI Agents — structured data for autonomous agents

  4. Protocol Overview — how the pieces fit together

  5. Contracts — deployed addresses

  6. Risks — security considerations

Last updated