Getting started

import { Oniym } from "@oniym/sdk";
 
const oniym = new Oniym({
    indexerUrl: "https://api.oniym.xyz", // fast reads
    rpcUrl: "https://mainnet.base.org", // fallback / write calls
});

import { Oniym } from "@oniym/sdk";
const oniym = new Oniym({ indexerUrl: "https://api.oniym.xyz" });
// All records for a name
const result = await oniym.resolve("kyy.web3");
console.log(result?.owner); // "0x..."
console.log(result?.expiresAt); // unix timestamp string
console.log(result?.addresses); // { "60": "0x..." }
console.log(result?.texts); // { "twitter": "..." }
 
// Just one chain's address
const eth = await oniym.getAddress("kyy.web3", "eth");
 
// All chain addresses at once
const all = await oniym.getAddresses("kyy.web3");
// { eth: "0x...", sol: "...", btc: "..." }
 
// Reverse: address → name
const name = await oniym.getName("0x11702b...");

import { Oniym } from "@oniym/sdk";
const oniym = new Oniym({ indexerUrl: "https://api.oniym.xyz" });
const isAvailable = await oniym.available("alice", "web3");
 
// ETH price — fluctuates with Chainlink feed
const monthly = await oniym.rentPrice("alice", "web3", 30 * 24 * 60 * 60); // ~$3
const annual = await oniym.rentPrice("alice", "web3", 365 * 24 * 60 * 60); // ~$15
console.log(`Monthly: ${Number(monthly) / 1e18} ETH`);
console.log(`Annual:  ${Number(annual) / 1e18} ETH`);

import { Oniym } from "@oniym/sdk";
import { createWalletClient, custom } from "viem";
import { baseSepolia } from "viem/chains";
 
const oniym = new Oniym({ indexerUrl: "https://api.oniym.xyz" });
const walletClient = createWalletClient({
    chain: baseSepolia,
    transport: custom(window.ethereum),
});
 
// Pay with ETH (default)
const hash = await oniym.register(
    {
        name: "alice",
        tld: "web3",
        duration: 365 * 24 * 60 * 60,
        reverseRecord: true,
        addresses: { eth: "0x11702b8eF5F882191Af862a7e27096C44A5e2B37" },
        onCommit: (hash) => console.log("Committed:", hash),
        onWaiting: (ms) => console.log(`Waiting ${ms / 1000}s...`),
    },
    walletClient,
);
 
// Pay with USDC — SDK approves + registers automatically (2 txs)
const hash = await oniym.register(
    {
        name: "alice",
        tld: "web3",
        duration: 365 * 24 * 60 * 60,
        paymentToken: "usdc",
    },
    walletClient,
);