Base Sepolia

WALLET

Connect a wallet

Choose a wallet configured for Base Sepolia.

Choose wallet
INTEGRATION SURFACE / VERSION 2.0.0

BUILD
WITH SEPBASE

CONTRACT0xe000de3efe798Aa4F834fd952Bef35BAE1B16945
01 / QUICKSTART

Discover configuration before calling the contract.

Start with the deployment manifest. It publishes the current network, contract, pricing rules, asset details, and integration URLs in one place.

The SDK validates the manifest and ABI before returning reads. The HTTP API exposes the same public name data without requiring a wallet connection.

The SDK and React integration packages are release-ready in packages/sdk and packages/react, but are not yet published to the public npm registry. Use workspace:* inside this monorepo; the install command applies after the first package release.

TYPESCRIPT
# After the public package release
pnpm add @sepbase/sdk @sepbase/react

import { createSepbaseClient } from "@sepbase/sdk";

const sepbase = await createSepbaseClient(
  "https://sepbase.vercel.app/deployment-manifest.json"
);

const address = await sepbase.resolveName("alice");
const primary = await sepbase.reverseLookup("0xYourAddress");
const quote = await sepbase.quoteName("alice", 1);
CHAINBase Sepolia / 84532
CONTRACT0xe000de3efe798Aa4F834fd952Bef35BAE1B16945
VERSION2.0.0
SUFFIX.sepbase
SETTLEMENTETH
DEPLOYMENT BLOCK44011800
DEPLOYMENT MANIFEST/deployment-manifest.json

Runtime chain, contract, asset, and endpoint metadata.

OPEN WELL-KNOWN MANIFEST/.well-known/chain-name-service.json

Stable discovery document for other applications.

OPEN CONTRACT ABI/abi/ChainNameService.json

Canonical JSON ABI with a published checksum.

OPEN OPENAPI/api/openapi.json

Machine-readable read-only HTTP API contract.

OPEN BLOCKSCOUT HANDOFF/integrations/blockscout-bens.md

BENS prerequisites, semantics, and event mapping.

OPEN LLMS.TXT/llms.txt

Compact integration map for AI-assisted development.

OPEN
02 / VERIFIED IDENTITY

Show a name only when both directions still agree.

TYPESCRIPT
const identity = await sepbase.verifyAddress(
  "0x78de409a6306550882328E2a67160471368387FF"
);

const displayName = identity.verified
  ? identity.primaryName
  : identity.account;

// Name-first verification is also available.
const recipient = await sepbase.verifyName("alice", identity.account);
DISPLAY

Use the primary name only when verified is true. Otherwise display the checksummed address.

SNAPSHOT

Owner, lifecycle, resolution, primary, and expiry reads are pinned to one block.

RECHECK

Verify again before a payment or other address-sensitive confirmation.

REACT FALLBACK

SepbaseIdentity never displays an unverified name and exposes stable loading, verified, unverified, and error states.

BLOCKSCOUT

Explorer-native search requires an external BENS-compatible subgraph and Blockscout configuration. The public handoff document maps the required work without adding an indexer to this dApp.

03 / HTTP API

Read SEPBASE without a wallet library.

The read-only API returns name, profile, resolution, pricing, and market data with the network context needed by another application.

GET/api/name/{label}

Lifecycle, owner, resolution, profile, and listing.

GET/api/resolve/{label}

Forward resolution for a canonical label.

GET/api/reverse/{address}

Forward-confirmed primary name for an address.

GET/api/market

Current validated fixed-price listings.

GET/api/metadata/{tokenId}

ERC-721 metadata for a registered token.

GET/api/image/{tokenId}

Deterministic onchain-name image representation.

SHELL
curl "https://sepbase.vercel.app/api/name/alice?durationYears=1"

curl "https://sepbase.vercel.app/api/reverse/0x78de409a6306550882328E2a67160471368387FF"

curl "https://sepbase.vercel.app/api/market?cursor=0&limit=24"
04 / WRITE INTEGRATION

Quote first. Preserve every slippage guard.

TYPESCRIPT
const amount = await publicClient.readContract({
  address: manifest.contract,
  abi,
  functionName: "quote",
  args: ["alice", 1]
});

const rewardBps = await publicClient.readContract({
  address: manifest.contract,
  abi,
  functionName: "referralRewardBps"
});

const { request } = await publicClient.simulateContract({
  account: owner,
  address: manifest.contract,
  abi,
  functionName: "register",
  args: [
    "alice",
    1,
    owner,
    referrer,
    amount,    // expectedAmount guard
    rewardBps  // expectedRewardBps guard
  ],
  value: manifest.settlement.kind === "native" ? amount : undefined
});

const hash = await walletClient.writeContract(request);
REGISTER / RENEW

Pass the current quote as expectedAmount. For ERC-20 settlement, approve that exact base-unit amount first.

REFERRALS

Pass the current reward rate as expectedRewardBps. Attribution is recorded onchain; claims use pull payments.

LIST / UPDATE

Pass the current market fee as expectedFeeBps. The fee is captured on each listing.

BUY

Pass the displayed listing price as expectedPrice. Seller proceeds remain protected until claimed.

REFERRAL DEEP LINK

Send users to the configured /r/{referrer} route. Attribution is scoped to schema, chain, and contract.

EVENTS / ERRORS

Index NameRegistered, NameRenewed, ReferralAttributed, NameListed, and NameSold; handle custom errors by machine name.

05 / PROTOCOL MODEL

Portable across settlement assets, explicit about trust.

GAS CURRENCYETH

Used by the connected chain to pay transaction fees.

SETTLEMENTETH / 18 decimals

Native or one standard ERC-20 selected per deployment.

STANDARD ANNUAL / 4-320.0005 ETHUSD REFERENCE / LOADING

quote(label, years) applies the configured length tier in settlement base units.

SHORT-NAME PREMIUMS100x / 25x / 5x

Applied respectively to one-, two-, and three-character labels.

REFERRAL RATE10%

Current reward for a successful registration made through a referral.

MARKET FEE0%

Applied to new or updated listings, not retroactively changed.

NAME DATAV2 REGISTRY

Reads resolve against the deployment published in the manifest.