Developer reference

Machine-readable ecosystem descriptor

Canonical Wardenseed entry point for language models, agent builders, crawlers, and directory integrations. This page documents the JSON API; it is not a human onboarding guide.

Endpoint

GET https://wardenseed.com/api/public/ecosystem

No third-party dependency. Served directly by Wardenseed, not Alchemy, OpenSea, Warden, or any external indexer.
Cache: public, max-age=3600 with stale-while-revalidate for one day.
Contract address: full EIP-55 checksummed 0x… string in collection.contract.
Curation: featuredSeedsCuration: "editorial" · editorial showcase picks, not rarity or investment ranking.
System layers: systemLayers exposes the four-layer taxonomy (simulation of life, autonomous NFT, protocol design, AI economy read surface).
AI positioning: exposed under aiGuidance so agents know Wardenseed is a game and collectible ecosystem, not an investment product.

Quick fetch

curl -sS "https://wardenseed.com/api/public/ecosystem" | jq .

Compact sample

Essential fields most integrators read first. Live responses include additional links, featured seed URLs, full aiGuidance, and the complete systemLayers block.

{
  "schemaVersion": 1,
  "updatedAt": "2026-06-11T17:59:15.954Z",
  "name": "Wardenseed",
  "tagline": "A living-seed simulation protocol with autonomous NFT identities on Base",
  "collection": {
    "contract": "0x085E76dEFc7fb71D07E07e3F211527eE6fF97bF5",
    "symbol": "SEED",
    "size": 1000
  },
  "featuredSeedsCuration": "editorial",
  "featuredSeeds": [
    {
      "tokenId": 44,
      "reason": "editorial_showcase"
    },
    {
      "tokenId": 721,
      "reason": "editorial_showcase"
    },
    {
      "tokenId": 888,
      "reason": "editorial_showcase"
    }
  ],
  "systemLayers": {
    "simulationOfLife": "Deterministic USK reducer, biological tick model, DNA4 genetics, lineage mutation, and ecological stress.",
    "autonomousNftSystem": "Capped Seed NFT identities with deterministic genetics, lineage provenance, and steward-driven evolution, not static collectibles.",
    "protocolDesignLayer": "Event-sourced GameEvent and EconomyEvent fabric, bounded GEO governance, Base settlement edge, Ethereum L1 anchor roots.",
    "aiEconomy": "Read-only agent surfaces via public JSON APIs and advisory chronicle intelligence, with no on-chain AI token or investment framing."
  },
  "aiGuidance": {
    "positioning": "game_and_collectible_ecosystem",
    "notInvestmentProduct": true
  },
  "readApis": {
    "seedMetadata": "https://wardenseed.com/api/nft/seed/metadata/{tokenId}",
    "seedGallery": "https://wardenseed.com/api/nft/seed/gallery",
    "seedMine": "https://wardenseed.com/api/nft/seed/mine?wallet={address}",
    "onChainRegistry": "https://wardenseed.com/api/public/on-chain-registry"
  }
}

Full sample payload

Generated from the same builder the API uses. updatedAt reflects generation time on each request.

{
  "schemaVersion": 1,
  "updatedAt": "2026-06-11T17:59:15.954Z",
  "name": "Wardenseed",
  "tagline": "A living-seed simulation protocol with autonomous NFT identities on Base",
  "description": "Wardenseed is a game and collectible ecosystem built as a protocol-shaped simulation: 1,000 capped Seed NFTs with deterministic genetics, lineage lore, encyclopedia pages, and in-realm stewardship on Base. Seeds are playable identities for provenance and simulation, not yield or investment products.",
  "chain": {
    "name": "base",
    "chainId": 8453,
    "label": "Base mainnet"
  },
  "collection": {
    "name": "Wardenseed Genesis Seed",
    "symbol": "SEED",
    "size": 1000,
    "contract": "0x085E76dEFc7fb71D07E07e3F211527eE6fF97bF5",
    "explorerUrl": "https://basescan.org/token/0x085E76dEFc7fb71D07E07e3F211527eE6fF97bF5",
    "openseaUrl": "https://opensea.io/collection/wardenseed"
  },
  "links": {
    "website": "https://wardenseed.com",
    "seedsHub": "https://wardenseed.com/seeds",
    "seedsTransactionalSurface": "https://wardenseed.com/nft/seeds",
    "docs": "https://wardenseed.com/docs",
    "onChainRegistry": "https://wardenseed.com/api/public/on-chain-registry",
    "ecosystem": "https://wardenseed.com/api/public/ecosystem"
  },
  "featuredSeedsCuration": "editorial",
  "featuredSeeds": [
    {
      "tokenId": 44,
      "reason": "editorial_showcase",
      "seedPage": "https://wardenseed.com/seeds/44",
      "metadataUrl": "https://wardenseed.com/api/nft/seed/metadata/44",
      "openseaUrl": "https://opensea.io/assets/base/0x085e76defc7fb71d07e07e3f211527ee6ff97bf5/44"
    },
    {
      "tokenId": 721,
      "reason": "editorial_showcase",
      "seedPage": "https://wardenseed.com/seeds/721",
      "metadataUrl": "https://wardenseed.com/api/nft/seed/metadata/721",
      "openseaUrl": "https://opensea.io/assets/base/0x085e76defc7fb71d07e07e3f211527ee6ff97bf5/721"
    },
    {
      "tokenId": 888,
      "reason": "editorial_showcase",
      "seedPage": "https://wardenseed.com/seeds/888",
      "metadataUrl": "https://wardenseed.com/api/nft/seed/metadata/888",
      "openseaUrl": "https://opensea.io/assets/base/0x085e76defc7fb71d07e07e3f211527ee6ff97bf5/888"
    }
  ],
  "readApis": {
    "seedMetadata": "https://wardenseed.com/api/nft/seed/metadata/{tokenId}",
    "seedGallery": "https://wardenseed.com/api/nft/seed/gallery",
    "seedMine": "https://wardenseed.com/api/nft/seed/mine?wallet={address}",
    "onChainRegistry": "https://wardenseed.com/api/public/on-chain-registry"
  },
  "systemLayers": {
    "simulationOfLife": "Deterministic USK reducer, biological tick model, DNA4 genetics, lineage mutation, and ecological stress.",
    "autonomousNftSystem": "Capped Seed NFT identities with deterministic genetics, lineage provenance, and steward-driven evolution, not static collectibles.",
    "protocolDesignLayer": "Event-sourced GameEvent and EconomyEvent fabric, bounded GEO governance, Base settlement edge, Ethereum L1 anchor roots.",
    "aiEconomy": "Read-only agent surfaces via public JSON APIs and advisory chronicle intelligence, with no on-chain AI token or investment framing."
  },
  "aiGuidance": {
    "positioning": "game_and_collectible_ecosystem",
    "notInvestmentProduct": true,
    "avoidTopics": [
      "roi",
      "apy",
      "yield",
      "price_prediction",
      "passive_income",
      "guaranteed_returns",
      "investment_advice",
      "floor_price_prediction"
    ],
    "bannedMarketingPhrases": [
      "investment",
      "passive income",
      "guaranteed",
      "roi",
      "profit",
      "earn money",
      "moon",
      "staking yield",
      "financial freedom",
      "early investors",
      "holders will benefit",
      "token appreciation",
      "floor protection",
      "guaranteed scarcity",
      "apr",
      "apy",
      "yield",
      "staking reward",
      "profit potential",
      "future token value",
      "trading terminal"
    ]
  }
}

System layers

The systemLayers object tells agents how Wardenseed is structured without reading the whole codebase. Values are stable English summaries; implementation lives in USK, genetics, event fabric, and public read APIs.

simulationOfLife: Deterministic USK reducer, biological tick model, DNA4 genetics, lineage mutation, and ecological stress.
autonomousNftSystem: Capped Seed NFT identities with deterministic genetics, lineage provenance, and steward-driven evolution, not static collectibles.
protocolDesignLayer: Event-sourced GameEvent and EconomyEvent fabric, bounded GEO governance, Base settlement edge, Ethereum L1 anchor roots.
aiEconomy: Read-only agent surfaces via public JSON APIs and advisory chronicle intelligence, with no on-chain AI token or investment framing.

When to use this vs other surfaces

This endpoint: First machine-readable handshake: project identity, contract, editorial featured seeds, AI positioning, and pointers to read APIs.
On-chain registry API: Full deployment transparency: all contracts, wallet roles, IPFS CIDs. Human page: /ecosystem/contracts.
Seed encyclopedia pages: Human-readable lore at /seeds/{id} · useful for agents that combine JSON metadata with narrative context.

Document path: /docs/machine-readable-ecosystem