> For the complete documentation index, see [llms.txt](https://zardoz.gitbook.io/zardoz-docs-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zardoz.gitbook.io/zardoz-docs-1/indexer-integration.md).

# Indexer integration

## Indexer integration

**Audience:** GMGN, Axiom, Dex aggregators, RH terminals, bots, and any partner indexing Robinhood Chain launchpads.

**Product:** [zardoz.fun](https://zardoz.fun)\
**Public launches API:** `GET https://zardoz.fun/api/launches?network=mainnet`\
**Platform id:** `zardoz`

This page is enough to add a `zardoz` platform filter to Trenches / new-pair feeds without reverse-engineering.

***

### Why index Zardoz

* **Instant path** deploys ERC-20 + Uniswap V3 single-sided pool + permanent LP lock in **one factory call**.
* Tokens are **tradable from block 1** on Uniswap V3 (WETH pair).
* Canonical `TokenCreated` carries token, creator, pool, fee tier, supply, metadata, and logo URI.
* Platform launch fee is separate (`LaunchFeeRouter`); factory `create` only needs `initialBuyWei` in wrapped `msg.value`.

***

### Canonical contracts (Robinhood mainnet)

| Role                          | Address                                                                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Instant factory** (primary) | [`0xDabBB88c68bb44512b917d3AD3298669330954BD`](https://robinhoodchain.blockscout.com/address/0xDabBB88c68bb44512b917d3AD3298669330954BD) |
| Instant fee vault             | [`0xd390f16A02133928bF6943eF3637e65cF78EE988`](https://robinhoodchain.blockscout.com/address/0xd390f16A02133928bF6943eF3637e65cF78EE988) |
| Instant LP locker             | [`0xd10bac75248cC975Edc5770a71144a7549594b4e`](https://robinhoodchain.blockscout.com/address/0xd10bac75248cC975Edc5770a71144a7549594b4e) |
| Launch fee router             | [`0xB36Bd2A864cB5AD202c2b66Ba20C4e2da9484151`](https://robinhoodchain.blockscout.com/address/0xB36Bd2A864cB5AD202c2b66Ba20C4e2da9484151) |
| Legacy Instant factory        | `0xd4419ed7f2ff81821f3ec8e104d05918bb7ba9d1`                                                                                             |

**Indexer rule:** any token whose create tx targets the Instant factory (or emits its `TokenCreated`) → `launchpad = "zardoz"`.

Also scan legacy factory addresses for historical tokens.

***

### Uniswap / quote context

| Piece              | Address                                      |
| ------------------ | -------------------------------------------- |
| WETH               | `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73` |
| Uniswap V3 factory | `0x1f7d7550B1b028f7571E69A784071F0205FD2EfA` |
| NPM                | `0x73991a25C818Bf1f1128dEAaB1492D45638DE0D3` |
| SwapRouter02       | `0xCaf681a66D020601342297493863E78C959E5cb2` |

Instant pools are **WETH-paired Uniswap V3**. Default fee tier: **10000 (1%)**. Also: 100 / 500 / 3000.

***

### TokenCreated event

```solidity
event TokenCreated(
    address indexed token,
    address indexed creator,
    address indexed pool,
    address feeRecipient,
    uint256 positionId,
    uint24 feeTier,
    uint256 totalSupply,
    uint256 tokensForListing,
    string name,
    string symbol,
    string metadataURI,
    string logoURI,
    bytes extras
);
```

**topic0:** `0x6a930054a3ec27e994fa8a180f9a1ae564f0792f35245bc48d41687bb9c41568`

```json
{
  "address": "0xDabBB88c68bb44512b917d3AD3298669330954BD",
  "topics": ["0x6a930054a3ec27e994fa8a180f9a1ae564f0792f35245bc48d41687bb9c41568"]
}
```

***

### Suggested Trenches mapping

| Field                              | Source                                          |
| ---------------------------------- | ----------------------------------------------- |
| `launchpad` / `launchpad_platform` | `"zardoz"`                                      |
| `token_address`                    | `token`                                         |
| `creator` / `deployer`             | `creator`                                       |
| `pool` / `biggest_pool_address`    | `pool`                                          |
| `name` / `symbol`                  | event strings                                   |
| `logo`                             | `logoURI` (https / ipfs)                        |
| `open_timestamp`                   | block timestamp                                 |
| `launchpad_status`                 | Instant = listed immediately → open / completed |
| `launchpad_progress`               | `1` (no bonding curve)                          |

***

### Public JSON API

```
GET /api/launches?network=mainnet&limit=80
```

Response:

```json
{
  "network": "mainnet",
  "chainId": 4663,
  "factory": "0xDabBB88c68bb44512b917d3AD3298669330954BD",
  "launchpad": "zardoz",
  "count": 12,
  "launches": [
    {
      "token": "0x…",
      "creator": "0x…",
      "pool": "0x…",
      "feeTier": 10000,
      "name": "…",
      "symbol": "…",
      "metadataURI": "…",
      "logoURI": "…",
      "totalSupply": "…",
      "tokensForListing": "…",
      "blockNumber": 123,
      "timestamp": 1710000000,
      "txHash": "0x…"
    }
  ]
}
```

Also: `GET /api/tokens?network=mainnet` — Discover feed; filter `launchpad=zardoz` client-side.

***

### Create call (Cooking / one-click)

`ZardozInstantFactory.create(CreateParams)` — payable via router wrap.

Frontend entry: [/launch](https://zardoz.fun/launch) → **Zardoz Instant**.

High-level params: see Instant contracts and `lib/instant-factory.ts`.

***

### Fees & safety

| Item                | Behavior                                                       |
| ------------------- | -------------------------------------------------------------- |
| Platform launch fee | **0.002 ETH** via LaunchFeeRouter; refs **0.001 ETH**          |
| Swap fees           | Uniswap V3 LP fees → locked position; creator claims via vault |
| LP                  | Position NFT locked (not pullable)                             |
| Token               | Standard ERC-20; metadata + logo at deploy                     |

***

### Partner ask

1. Add platform id **`zardoz`** on Robinhood (`chain=robinhood` / `4663`).
2. Index Instant factory `TokenCreated` into Trenches / new creation.
3. Optional: Cooking one-click → `create` with UI defaults (1% fee, 100% listed).
4. Contact: [zardoz.fun](https://zardoz.fun) · [@ZardozPad](https://x.com/ZardozPad)

#### Outreach draft

> Hey GMGN — Zardoz is live on Robinhood Chain (`4663`). Instant factory `0xDabBB88c68bb44512b917d3AD3298669330954BD` emits `TokenCreated` (topic0 `0x6a930054…41568`) with token, creator, pool, metadataURI, logoURI. Public feed: <https://zardoz.fun/api/launches?network=mainnet> — docs: <https://zardoz.gitbook.io/zardoz-docs-1/> — asking for a `zardoz` platform tag on RH Trenches.

***

### Source references

| Artifact          | Path                                             |
| ----------------- | ------------------------------------------------ |
| Instant factory   | `contracts/src/instant/ZardozInstantFactory.sol` |
| Client decode     | `lib/instant-factory.ts`                         |
| On-chain indexer  | `lib/data/zardoz-index.ts`                       |
| Factory → pad map | `lib/launchpads.ts`                              |

Next: HTTP APIs · Instant contracts


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://zardoz.gitbook.io/zardoz-docs-1/indexer-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.