Add .igra resolution in 5 minutes.

INS is the permanent name service native to Igra L2 (chain 38833, native iKAS). Every name is an ERC-721 with on-chain SVG art. Resolve a name to an address with one fetch() — the API unions the V1 + V2 registries automatically. No SDK, no indexer, no infrastructure on your side.

Quick start — REST API

Free, public, CORS-enabled, no auth, no rate limit. The fastest path — hit it from your wallet's existing fetch layer.

// Forward resolve (name -> address) — works for V1 + V2, no flags
async function resolveIgra(name) {
  const r = await fetch(
    "https://insdomains.org/api/resolve?name=" + encodeURIComponent(name)
  );
  if (!r.ok) return null;
  const d = await r.json();
  if (!d.exists) return null;
  return d.address;          // also: d.owner, d.registry_version,
                             //       d.tenure ("forever"|"annual"), d.expires_at
}

// in your send-flow:
const to = await resolveIgra("alice.igra");
if (to) sendTransaction(to);

// Reverse (address -> primary name) for tx history / contacts
async function displayName(addr) {
  const r = await fetch("https://insdomains.org/api/reverse?address=" + addr);
  const { primary } = await r.json();
  return primary ?? (addr.slice(0, 6) + "\u2026" + addr.slice(-4));
}

Live endpoints

Click any example — they return real JSON from chain right now.

Three ways to integrate

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://rpc.igralabs.com:8545"),
  chain: { id: 38833, name: "Igra",
           nativeCurrency: { name: "iKAS", symbol: "iKAS", decimals: 18 } },
});

// resolve(label) returns the target address directly. Label only — no ".igra".
// Query V2 first, fall through to V1 on a zero result (matches the dApp).
const addr = await client.readContract({
  address: "0x7E7018959bf44045F01D176D8db1594894CBf4E9",
  abi: [{ name: "resolve", type: "function", stateMutability: "view",
          inputs: [{ name: "label", type: "string" }],
          outputs: [{ type: "address" }] }],
  functionName: "resolve",
  args: ["alice"],
});

Contracts on Igra mainnet

All explorer-verified. V2 is canonical; V1 is legacy read-only.

RPC: https://rpc.igralabs.com:8545 · Explorer: explorer.igralabs.com · strip the .igra suffix before calling label-based functions.

Audit posture

Reverse resolution is stale-safe, fees are capped in code (even a compromised owner can't exceed 5%), and registration overpayment is refunded in-tx. Reproduce with cd contracts && forge test.

What we'd love your help with

• Send-flow resolution — type alice.igra in the to-field, resolve, send. Show the name next to the 0x on confirmations.
• Reverse-resolve display — render alice.igra wherever you show a raw address.
• “My names” tile — on connect, fetch /api/names/by-owner.
• Annual expiry reminders — for tenure === "annual", nudge when expires_at is within 60 days.
• Native NFT art — tokenURI() returns a Base64 SVG; no extra fetch.