ARC Name Service

# Core SDK (required)
npm install @arcnames/sdk

# React hooks (optional, for React/Next.js apps)
npm install @arcnames/sdk-react

import { ARCNames } from "@arcnames/sdk";

const ans = new ARCNames({
  rpcUrl: "https://rpc.testnet.arc.network",
  registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  cacheTimeout: 60000, // optional, default 60s
});

const address = await ans.resolve("david");
if (!address) throw new Error("Name not found");

// Use the resolved address in any transaction
await sendUSDC(address, amount);

import { useANSReverse } from "@arcnames/sdk-react";

function Navbar({ walletAddress }) {
  const { arcName, isLoading } = useANSReverse(walletAddress, {
    rpcUrl: "https://rpc.testnet.arc.network",
    registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  });

  return (
    <span>
      {isLoading ? "..." : arcName ?? `${walletAddress.slice(0, 6)}...${walletAddress.slice(-4)}`}
    </span>
  );
}

import { useANSResolve } from "@arcnames/sdk-react";

function RecipientInput({ onResolved }) {
  const [input, setInput] = useState("");
  const { address, arcName, isResolving, reason } = useANSResolve(input, {
    rpcUrl: "https://rpc.testnet.arc.network",
    registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
    debounceMs: 400,
  });

  if (address) onResolved(address);

  return (
    <div>
      <input
        value={input}
        onChange={(e) => setInput(e.target.value)}
        placeholder="0x... or name.arc"
      />
      {isResolving && <span>Resolving...</span>}
      {arcName && address && <span>{arcName} → {address.slice(0, 10)}...</span>}
      {reason === "not_registered" && <span>Name not found</span>}
    </div>
  );
}

const recipients = ["alice", "bob", "charlie", "david"];
const results = await ans.resolveMany(recipients);

// [{ name: "alice.arc", address: "0x..." }, { name: "bob.arc", address: null }, ...]
const valid = results.filter((r) => r.address !== null);
const failed = results.filter((r) => r.address === null);

const available = await ans.isAvailable("myname");
if (available) {
  const price = await ans.quotePrice("myname", 1); // 1 year in USDC (6 decimals)
  console.log(`Register for ${price} USDC`);
}

import { BrowserProvider } from "ethers";

const provider = new BrowserProvider(window.ethereum);
const signer = await provider.getSigner();

const ansWrite = new ARCNames({
  rpcUrl: "https://rpc.testnet.arc.network",
  registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  signer,
});

const txHash = await ansWrite.register("myname");
console.log(`Registered: https://testnet.arcscan.app/tx/${txHash}`);

import { ARCNames, normalizeName } from "@arcnames/sdk";

// Read-only (no signer needed)
const ans = new ARCNames({
  rpcUrl: "https://rpc.testnet.arc.network",
  registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  cacheTimeout: 60000, // optional, default 60s
});

// Read + Write (requires ethers.js signer)
import { BrowserProvider } from "ethers";
const provider = new BrowserProvider(window.ethereum);
const signer = await provider.getSigner();

const ansWrite = new ARCNames({
  rpcUrl: "https://rpc.testnet.arc.network",
  registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  signer,
});

import { ANSProvider } from "@arcnames/sdk-react";

function App() {
  return (
    <ANSProvider config={{
      rpcUrl: "https://rpc.testnet.arc.network",
      registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
    }}>
      <YourApp />
    </ANSProvider>
  );
}

// Then in any child — no config needed:
const { address } = useANSResolve(input);
const { arcName } = useANSReverse(walletAddress);
const { available } = useANSAvailability(nameInput);

interface IANSRegistry {
    function resolve(string calldata rawLabel) external view returns (address);
    function getRecord(string calldata rawLabel) external view returns (
        address owner, address resolvedAddress, uint64 expiry, bool expired, bool reserved
    );
    function isAvailable(string calldata rawLabel) external view returns (bool);
    function reverseLookup(address wallet) external view returns (string memory);
}

contract PaymentRouter {
    IANSRegistry public immutable ans;

    constructor(address ansRegistry) {
        ans = IANSRegistry(ansRegistry);
    }

    function payByName(string calldata name) external payable {
        address recipient = ans.resolve(name);
        require(recipient != address(0), "Name not registered");
        (bool ok, ) = recipient.call{value: msg.value}("");
        require(ok, "Transfer failed");
    }
}

import { ARCNames } from "@arcnames/sdk";
import { useState, useMemo } from "react";

function AddressInput({ onResolved }) {
  const [input, setInput] = useState("");
  const [resolved, setResolved] = useState(null);

  const ans = useMemo(() => new ARCNames({
    rpcUrl: "https://rpc.testnet.arc.network",
    registryAddress: "0xf5e0E328119D16c75Fb4a001282a3a7b733EF6db",
  }), []);

  async function handleChange(value) {
    setInput(value);
    if (value.endsWith(".arc") || (!value.startsWith("0x") && value.length >= 3)) {
      try {
        const addr = await ans.resolve(value.replace(/\.arc$/, ""));
        setResolved(addr);
        if (addr) onResolved(addr);
      } catch { setResolved(null); }
    } else if (value.startsWith("0x")) {
      setResolved(value);
      onResolved(value);
    }
  }

  return (
    <div>
      <input value={input} onChange={(e) => handleChange(e.target.value)} placeholder="0x... or name.arc" />
      {resolved && <small>Resolved: {resolved}</small>}
    </div>
  );
}