Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
<!doctype html>
<html lang="en">
<head>
<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<meta charset="utf-8">
<title data-i18n="eth_vanity.meta_title">Ethereum CREATE2 vanity grinder · three.ws</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Grind a vanity Ethereum smart-contract address by searching CREATE2 salts. Runs entirely in your browser — no keys involved, just a salt you feed to your factory." data-i18n-attr="content:eth_vanity.meta_description">
<link rel="icon" href="/favicon.ico">
<link rel="stylesheet" href="/footer.css">
<link rel="stylesheet" href="/nav.css">
<link rel="stylesheet" href="/fonts/fonts.css" />
<style>
* { box-sizing: border-box; }
:root {
color-scheme: dark;
--fg: #f0f0f0; --muted: #888; --border: rgba(255,255,255,0.08); --bg: #111;
--card-bg: #0f0f0f;
--ok-bg: rgba(74,222,128,0.12); --ok-fg: #4ade80;
--warn-bg: rgba(251,191,36,0.1); --warn-fg: #fbbf24;
--bad-bg: rgba(239,68,68,0.1); --bad-fg: #f87171;
--header-h: 3.5rem;
--font-display: 'Space Grotesk', 'Inter', system-ui, sans-serif;
}
body {
font: 15px/1.5 'Inter', system-ui, -apple-system, sans-serif;
background: #000; color: var(--fg); margin: 0;
min-height: 100vh; display: flex; flex-direction: column;
}
main { flex: 1; max-width: 720px; width: 100%; margin: 0 auto; padding: 2.5rem 1rem 4rem; }
h1 { font-size: 1.5rem; margin: 0 0 .25rem; font-family: var(--font-display); letter-spacing: -0.02em; }
p.lede { color: var(--muted); margin: 0 0 1rem; }
.sibling-note { display: flex; gap: .5rem; align-items: flex-start; font-size: .78rem; color: var(--muted); background: #0a0a0a; border: 1px solid var(--border); border-radius: 8px; padding: .65rem .8rem; margin: 0 0 1.5rem; }
.sibling-note svg { flex: none; margin-top: 1px; color: #ffd54f; }
.sibling-note a { color: #ffd54f; text-decoration: none; }
.sibling-note a:hover { text-decoration: underline; }
label { display: block; font-size: .8rem; color: var(--muted); margin: 1rem 0 .25rem; }
.card { border: 1px solid var(--border); border-radius: 10px; padding: 1.1rem 1.25rem; background: var(--card-bg); margin-bottom: 1rem; }
.card h2 { font-size: .95rem; margin: 0 0 .35rem; font-family: var(--font-display); letter-spacing: -0.01em; }
.card .desc { color: var(--muted); font-size: .8rem; margin: 0 0 .35rem; }
input[type=text], textarea, select {
font: inherit; font-family: ui-monospace, monospace; padding: .55rem .7rem;
width: 100%; border: 1px solid rgba(255,255,255,0.12); border-radius: 6px;
background: #1a1a1a; color: var(--fg); resize: vertical;
}
input[type=text]:focus, textarea:focus, select:focus { outline: none; border-color: rgba(255,255,255,0.3); }
input.invalid, textarea.invalid { border-color: var(--bad-fg); background: rgba(239,68,68,0.06); }
.row2 { display: grid; grid-template-columns: 1fr 1fr; gap: .75rem; }
@media (max-width: 600px) { .row2 { grid-template-columns: 1fr; } }
.preview { font-family: ui-monospace, monospace; font-size: .9rem; padding: .65rem .75rem; background: #1a1a1a; border-radius: 6px; margin-top: .55rem; word-break: break-all; min-height: 2.4em; line-height: 1.4; border: 1px solid var(--border); }
.preview .pfx, .preview .sfx { background: linear-gradient(90deg,#ffd54f,#ff8a65); color: #1a1a1a; padding: 0 3px; border-radius: 3px; font-weight: 700; }
.preview .rest { color: #555; }
/* ── Difficulty meter ── */
.meter { display: flex; gap: 4px; margin-top: .65rem; }
.meter .seg { flex: 1; height: 7px; border-radius: 4px; background: #2a2a2a; transition: background var(--duration-fast); }
.lit-1, .lit-2, .lit-3, .lit-4 { background: #4caf50 !important; }
.lit-5 { background: #fb8c00 !important; }
.lit-6 { background: #d32f2f !important; }
.tier-tag { padding: .15rem .55rem; border-radius: 999px; font-size: .75rem; font-weight: 600; }
.tier-free { background: rgba(74,222,128,0.12); color: #4ade80; }
.tier-paid { background: linear-gradient(90deg,rgba(255,213,79,0.15),rgba(255,138,101,0.15)); color: #fbbf24; border: 1px solid rgba(255,213,79,0.2); }
/* ── Compute / core selector ── */
.cores { margin-top: 1.1rem; padding-top: 1rem; border-top: 1px solid var(--border); }
.cores .cores-head { display: flex; justify-content: space-between; align-items: baseline; }
.cores .cores-head label { margin: 0; }
.cores .cores-val { font-family: ui-monospace, monospace; font-size: .85rem; color: var(--fg); }
.cores .cores-val b { color: #fff; font-size: 1rem; }
.cores-row { display: flex; align-items: center; gap: .75rem; margin-top: .55rem; }
.cores-row input[type=range] {
flex: 1; -webkit-appearance: none; appearance: none; height: 5px; border-radius: 999px;
background: #2a2a2a; outline: none; cursor: pointer; margin: 0;
}
.cores-row input[type=range]::-webkit-slider-thumb {
-webkit-appearance: none; appearance: none; width: 18px; height: 18px; border-radius: 50%;
background: #fff; cursor: pointer; border: 3px solid #000; box-shadow: 0 0 0 1px rgba(255,255,255,0.2);
transition: transform var(--duration-instant);
}
.cores-row input[type=range]::-webkit-slider-thumb:hover { transform: scale(1.15); }
.cores-row input[type=range]::-moz-range-thumb {
width: 18px; height: 18px; border-radius: 50%; background: #fff; cursor: pointer;
border: 3px solid #000; box-shadow: 0 0 0 1px rgba(255,255,255,0.2);
}
.cores-row input[type=range]:disabled { opacity: .4; cursor: not-allowed; }
.cores-row input[type=range]:focus-visible { box-shadow: 0 0 0 2px rgba(255,255,255,0.35); }
.cores .cores-hint { font-size: .72rem; color: var(--muted); margin-top: .45rem; }
.cores-ticks { display: flex; gap: .35rem; margin-top: .55rem; }
.cores-ticks button {
font: inherit; font-size: .72rem; padding: .2rem .55rem; border-radius: 999px;
border: 1px solid rgba(255,255,255,0.1); background: #1a1a1a; color: #bbb; cursor: pointer;
}
.cores-ticks button:hover { background: #242424; border-color: rgba(255,255,255,0.2); }
.cores-ticks button[aria-pressed=true] { background: #fff; color: #000; border-color: #fff; font-weight: 600; }
.progress.paused { opacity: .75; }
.paused-tag { display: inline-block; padding: .1rem .5rem; border-radius: 999px; font-size: .7rem; font-weight: 600;
background: var(--warn-bg); color: var(--warn-fg); border: 1px solid rgba(251,191,36,0.2); margin-left: .5rem; vertical-align: middle; }
.chip-est { color: #555; margin-left: .35rem; font-family: system-ui, sans-serif; font-size: .7rem; }
.row { display: flex; justify-content: space-between; align-items: center; margin-top: .55rem; font-size: .85rem; color: var(--muted); }
.actions { display: flex; gap: .55rem; margin-top: 1.25rem; align-items: center; flex-wrap: wrap; }
.btn { font: inherit; padding: .55rem 1.1rem; border-radius: 6px; border: 1px solid rgba(255,255,255,0.12); background: #1a1a1a; color: var(--fg); cursor: pointer; }
.btn:hover { background: #222; }
.btn.primary { background: #fff; color: #000; border-color: #fff; font-weight: 600; }
.btn.primary:hover { background: #e8e8e8; }
.btn:disabled { opacity: .35; cursor: not-allowed; }
.progress { margin-top: 1.25rem; padding: .9rem 1.1rem; background: #111; border-radius: 8px; border: 1px solid var(--border); font-family: ui-monospace, monospace; font-size: .85rem; }
.progress .live { display: flex; justify-content: space-between; align-items: center; gap: 1rem; }
.progress .stat { font-size: 1.1rem; font-weight: 600; color: #fff; }
.progress .scan { font-family: ui-monospace, monospace; font-size: .85rem; color: #555; margin-top: .35rem; word-break: break-all; min-height: 1.4em; }
.progress .scan .pfx, .progress .scan .sfx { background: linear-gradient(90deg,#ffd54f,#ff8a65); color: #1a1a1a; padding: 0 3px; border-radius: 3px; font-weight: 700; }
.result { margin-top: 1.25rem; padding: 1.1rem 1.25rem; background: rgba(255,213,79,0.06); border: 1px solid rgba(255,213,79,0.25); border-radius: 10px; }
.result h3 { margin: 0 0 .4rem; font-size: 1rem; color: #fff; }
.result .out-row { font-family: ui-monospace, monospace; font-size: .82rem; word-break: break-all; padding: .55rem .65rem; background: #111; border-radius: 6px; border: 1px solid rgba(255,213,79,0.15); margin-top: .5rem; }
.result .out-row .k { color: #ffffff; display: inline-block; min-width: 5.5rem; }
.result .pfx, .result .sfx { background: linear-gradient(90deg,#ffd54f,#ff8a65); color: #1a1a1a; padding: 0 3px; border-radius: 3px; font-weight: 700; }
.result .meta { font-size: .8rem; color: var(--muted); margin: .65rem 0 0; }
.warn { background: var(--warn-bg); color: var(--warn-fg); padding: .65rem .85rem; border-radius: 6px; margin-top: 1rem; font-size: .8rem; border: 1px solid rgba(251,191,36,0.15); }
.error { background: var(--bad-bg); color: var(--bad-fg); padding: .6rem .85rem; border-radius: 6px; margin-top: 1rem; font-size: .85rem; border: 1px solid rgba(239,68,68,0.15); }
.preset-row { display: flex; gap: .35rem; flex-wrap: wrap; margin-top: .4rem; }
.preset {
background: #1a1a1a; border: 1px solid rgba(255,255,255,0.1); border-radius: 999px;
padding: .25rem .65rem; cursor: pointer; font-size: .75rem; color: #bbb;
}
.preset:hover { background: #242424; border-color: rgba(255,255,255,0.2); }
.formula {
font-family: ui-monospace, monospace; font-size: .75rem;
color: #888; background: #0a0a0a; padding: .5rem .65rem;
border-radius: 6px; border: 1px solid var(--border); margin-top: .35rem;
}
.skip-link { position: absolute; left: -9999px; }
.skip-link:focus { left: 1rem; top: 1rem; padding: .5rem 1rem; background: #0c0c0c; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; z-index: 9999; color: #fff; text-decoration: none; }
</style>
<link rel="canonical" href="https://three.ws/eth-vanity">
<meta property="og:type" content="website">
<meta property="og:site_name" content="three.ws">
<meta property="og:title" content="CREATE2 Vanity Address Grinder · three.ws" data-i18n-attr="content:eth_vanity.meta_og_title">
<meta property="og:description" content="Grind a vanity smart-contract address by searching CREATE2 salts — chain-agnostic and deployer-agnostic. Works with any CREATE2 factory (Arachnid, CreateX, Safe, Coinbase). Runs entirely in your browser, no private keys involved." data-i18n-attr="content:eth_vanity.meta_og_description">
<meta property="og:url" content="https://three.ws/eth-vanity">
<meta property="og:image" content="https://three.ws/api/page-og?s=crypto&t=ETH+Vanity+%28CREATE2%29&d=Grind+a+vanity+smart-contract+address+using+the+ThreeWSFactory+CREATE2+deployer+on+BSC.&p=%2Feth-vanity">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="CREATE2 Vanity Address Grinder · three.ws" data-i18n-attr="content:eth_vanity.meta_twitter_title">
<meta name="twitter:description" content="Grind a vanity smart-contract address by searching CREATE2 salts — chain-agnostic and deployer-agnostic. Works with any CREATE2 factory. Runs entirely in your browser, no private keys involved." data-i18n-attr="content:eth_vanity.meta_twitter_description">
<meta name="twitter:image" content="https://three.ws/api/page-og?s=crypto&t=ETH+Vanity+%28CREATE2%29&d=Grind+a+vanity+smart-contract+address+using+the+ThreeWSFactory+CREATE2+deployer+on+BSC.&p=%2Feth-vanity">
<script type="application/ld+json">{"@context":"https://schema.org","@type":"WebPage","name":"CREATE2 Vanity Address Grinder","description":"Grind a vanity smart-contract address by searching CREATE2 salts — chain-agnostic and deployer-agnostic. Works with any CREATE2 factory (Arachnid, CreateX, Safe, Coinbase). Runs entirely in your browser, no private keys involved.","url":"https://three.ws/eth-vanity","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"}}</script>
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
<meta property="og:locale" content="en_US">
<meta property="og:image:alt" content="ETH Vanity (CREATE2) — three.ws">
<meta name="twitter:site" content="@trythreews">
</head>
<body>
<a href="#main-content" class="skip-link" data-i18n="eth_vanity.skip_to_main_content">Skip to main content</a>
<header>
<div id="nav-container"></div>
</header>
<script src="/nav.js"></script>
<main id="main-content">
<h1 data-i18n="eth_vanity.ethereum_create2_vanity_grinder">✦ Ethereum CREATE2 vanity grinder</h1>
<p class="lede" data-i18n-html="eth_vanity.grind_a_vanity_smart_contract_address_by">
Grind a vanity smart-contract address by searching <strong>CREATE2 salts</strong> — no private keys involved.
The result is a deterministic address you can deploy to from your factory of choice (Safe, ERC-4337 SimpleAccount, CreateX, Coinbase Smart Wallet…).
Runs entirely in your browser.
</p>
<div class="sibling-note">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="M12 2 4 5v6c0 5 3.4 8.5 8 10 4.6-1.5 8-5 8-10V5l-8-3Z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/><path d="m9 12 2 2 4-4" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/></svg>
<span data-i18n-html="eth_vanity.this_grinds_a_vanity_smart_contract_address">
This grinds a vanity <strong>smart-contract</strong> address — you search a salt, and the address is a deterministic function of your factory + init code. No private key is involved.
Want a vanity <strong>wallet</strong> you hold the key to? Use the <a href="/evm-wallet">EVM vanity wallet generator</a> — it grinds a real secp256k1 keypair in your browser.
</span>
</div>
<div class="card">
<h2 data-i18n="eth_vanity.1_factory_init_code">1. Factory + init code</h2>
<p class="desc" data-i18n="eth_vanity.create2_fixes_the_deployer_address_and_the">CREATE2 fixes the deployer address and the init code; only the salt is yours to choose.</p>
<div class="formula">address = keccak256(0xff ‖ deployer ‖ salt ‖ keccak256(initCode))[12:]</div>
<label for="deployer" data-i18n="eth_vanity.deployer_factory_address_20_bytes">Deployer / factory address (20 bytes)</label>
<input id="deployer" type="text" placeholder="0x…" autocomplete="off" spellcheck="false" />
<div class="preset-row" aria-label="Common deployers">
<button class="preset" type="button" data-deployer="0x4e59b44847b379578588920cA78FbF26c0B4956C" data-name="Arachnid CREATE2 (deterministic-deployment-proxy)" data-i18n="eth_vanity.arachnid_proxy">Arachnid proxy</button>
<button class="preset" type="button" data-deployer="0xba5Ed099633D3B313e4D5F7bdc1305d3c28ba5Ed" data-name="CreateX" data-i18n="eth_vanity.createx">CreateX</button>
<button class="preset" type="button" data-deployer="0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67" data-name="Safe SafeProxyFactory v1.4.1" data-i18n="eth_vanity.safe_v1_4_1">Safe v1.4.1</button>
<button class="preset" type="button" data-deployer="0x0BA5ED0c6AA8c49038F819E587E2633c4A9F428a" data-name="Coinbase Smart Wallet factory" data-i18n="eth_vanity.coinbase_smart_wallet">Coinbase Smart Wallet</button>
</div>
<label for="initcode-hash" data-i18n="eth_vanity.keccak256_initcode_32_bytes">keccak256(initCode) — 32 bytes</label>
<input id="initcode-hash" type="text" placeholder="0x… (64 hex chars)" autocomplete="off" spellcheck="false" />
<p class="desc" style="margin-top:.4rem" data-i18n-html="eth_vanity.if_you_have_the_raw_deploy_bytecode">
If you have the raw <code>initCode</code> (deploy bytecode + constructor args), paste it below and we'll hash it for you.
</p>
<label for="initcode-raw" style="margin-top:.5rem" data-i18n="eth_vanity.raw_init_code_optional_auto_hashes">Raw init code (optional — auto-hashes)</label>
<textarea id="initcode-raw" rows="3" placeholder="0x… (paste bytecode + ABI-encoded args)"></textarea>
</div>
<div class="card">
<h2 data-i18n="eth_vanity.2_pattern">2. Pattern</h2>
<p class="desc" data-i18n-html="eth_vanity.hex_characters_only_0_9_a_f">
Hex characters only (0–9, a–f). Each extra character is 16× harder.
<strong>Mixed case</strong> (e.g. <code>Beef</code>) matches the EIP-55 checksum — visually distinctive, ~2× harder per letter.
</p>
<div class="row2">
<div>
<label for="prefix" data-i18n="eth_vanity.prefix_after_0x">Prefix (after 0x)</label>
<input id="prefix" type="text" maxlength="10" placeholder="e.g. beef or Beef" autocomplete="off" spellcheck="false" />
</div>
<div>
<label for="suffix" data-i18n="eth_vanity.suffix">Suffix</label>
<input id="suffix" type="text" maxlength="10" placeholder="e.g. dead" autocomplete="off" spellcheck="false" />
</div>
</div>
<div class="preset-row" id="word-chips" aria-label="Quick-pick patterns" style="margin-top:.6rem"></div>
<div class="preview" id="preview" aria-live="polite"></div>
<div class="meter" aria-hidden="true">
<div class="seg" data-seg="1"></div>
<div class="seg" data-seg="2"></div>
<div class="seg" data-seg="3"></div>
<div class="seg" data-seg="4"></div>
<div class="seg" data-seg="5"></div>
<div class="seg" data-seg="6"></div>
</div>
<div class="row">
<span id="est" data-i18n="eth_vanity.type_a_pattern_to_see_estimated_time">type a pattern to see estimated time</span>
<span><span id="case-tag"></span> <span id="tier"></span></span>
</div>
<div class="cores">
<div class="cores-head">
<label for="core-count" data-i18n="eth_vanity.compute_cpu_cores_to_use">Compute — CPU cores to use</label>
<span class="cores-val"><b id="core-count-val">4</b> / <span id="core-max">8</span></span>
</div>
<div class="cores-row">
<input id="core-count" type="range" min="1" max="8" value="4" step="1"
aria-label="Number of CPU cores to use for grinding" />
</div>
<div class="cores-ticks" id="core-ticks" aria-label="Quick core presets"></div>
<div class="cores-hint" id="cores-hint">More cores = faster, but a heavier load on your machine. Pause anytime to free them.</div>
</div>
<div class="actions">
<button id="grind" class="btn primary" type="button" disabled data-i18n="eth_vanity.grind_salt">Grind salt</button>
<button id="pause" class="btn" type="button" hidden data-i18n="eth_vanity.pause">Pause</button>
<button id="cancel" class="btn" type="button" hidden data-i18n="eth_vanity.stop">Stop</button>
</div>
<div id="progress" hidden class="progress">
<div class="live">
<div>
<div class="stat" id="rate">0/s</div>
<div style="font-size:.75rem;color:#555">tries/sec across <span id="cores2">?</span> cores<span id="paused-tag" class="paused-tag" hidden data-i18n="eth_vanity.paused">paused</span></div>
</div>
<div style="text-align:right">
<div class="stat"><span id="attempts">0</span></div>
<div style="font-size:.75rem;color:#555">attempts · eta <span id="eta">—</span></div>
</div>
</div>
<div class="scan" id="scan"></div>
</div>
<div id="error" hidden class="error"></div>
<div id="result" hidden></div>
</div>
</main>
<script type="module">
import { keccak_256 } from '@noble/hashes/sha3';
import { apiFetch } from '/src/api.js';
import { grindCreate2Vanity } from '/src/eth/vanity/grinder.js';
import {
validatePattern, validateAddress, validateInitCodeHash,
estimateAttempts, formatTimeEstimate, letterCount, eip55Checksum,
MAX_PATTERN_LENGTH,
} from '/src/eth/vanity/validation.js';
import { PRESET_CHIPS } from '/src/eth/vanity/wordlist.js';
const $ = (id) => document.getElementById(id);
const HEX_ALPHA = '0123456789abcdef';
const RATE_PER_CORE = 60_000; // measured order-of-magnitude for keccak_256 on 85 bytes in a worker
// ── Core selection ─────────────────────────────────────────────────
// The machine's logical core count is the ceiling; default to a
// conservative half (min 1) so we don't peg the whole CPU by surprise.
const HW_CORES = Math.max(1, navigator.hardwareConcurrency || 4);
const DEFAULT_CORES = Math.max(1, Math.min(HW_CORES, Math.round(HW_CORES / 2) || 1));
let cores = DEFAULT_CORES;
const coreSlider = $('core-count');
coreSlider.max = String(HW_CORES);
coreSlider.value = String(DEFAULT_CORES);
$('core-max').textContent = HW_CORES;
$('core-count-val').textContent = DEFAULT_CORES;
$('cores2').textContent = DEFAULT_CORES;
// Quick presets: 1, half, max — deduped for low-core machines.
const presetVals = [...new Set([1, DEFAULT_CORES, HW_CORES])].sort((a, b) => a - b);
const presetLabel = (n) => n === 1 ? '1 core' : n === HW_CORES ? `Max (${n})` : `${n}`;
$('core-ticks').innerHTML = presetVals
.map((n) => `<button type="button" data-cores="${n}" aria-pressed="${n === DEFAULT_CORES}">${presetLabel(n)}</button>`)
.join('');
function setCores(n) {
cores = Math.max(1, Math.min(HW_CORES, n | 0));
coreSlider.value = String(cores);
$('core-count-val').textContent = cores;
$('core-ticks').querySelectorAll('button').forEach((b) => {
b.setAttribute('aria-pressed', String(Number(b.dataset.cores) === cores));
});
refreshChipEstimates();
update();
}
coreSlider.addEventListener('input', () => setCores(Number(coreSlider.value)));
$('core-ticks').querySelectorAll('button').forEach((b) => {
b.addEventListener('click', () => setCores(Number(b.dataset.cores)));
});
function refreshChipEstimates() {
$('word-chips').querySelectorAll('.preset').forEach((c) => {
const w = c.dataset.word || '';
const est = c.querySelector('.chip-est');
if (est) est.textContent = ' ' + fmtTime(estSeconds(w.length, 0, letterCount(w), /[A-F]/.test(w)));
});
}
function esc(s) { return String(s ?? '').replace(/[&<>"']/g, (c) => ({ '&':'&','<':'<','>':'>','"':'"',"'":''' })[c]); }
function sample(prefix = '', suffix = '') {
const total = 40;
const fillLen = Math.max(0, total - prefix.length - suffix.length);
let mid = '';
for (let i = 0; i < fillLen; i++) mid += HEX_ALPHA[Math.floor(Math.random() * 16)];
return prefix + mid + suffix;
}
function fmtTime(seconds) {
if (!isFinite(seconds)) return '—';
if (seconds < 1) return '<1s';
if (seconds < 60) return `~${Math.round(seconds)}s`;
if (seconds < 3600) return `~${Math.round(seconds/60)}m`;
if (seconds < 86400) return `~${Math.round(seconds/3600)}h`;
if (seconds < 31536000) return `~${Math.round(seconds/86400)}d`;
return '>1y';
}
// Map estimated wall-clock seconds → 1..6 difficulty "heat" for the meter
// (and the fast/slow tier). Cores-dependent, so easing the slider visibly
// cools the meter — the same live feedback as the Solana grinder.
function heatLevel(seconds) {
if (seconds <= 0) return 0;
if (seconds < 5) return 1;
if (seconds < 30) return 2;
if (seconds < 120) return 3;
if (seconds < 600) return 4;
if (seconds < 3600) return 5;
return 6;
}
function estSeconds(prefixLen, suffixLen, letters = 0, caseSensitive = false) {
const total = prefixLen + suffixLen;
if (total <= 0) return 0;
const base = Math.pow(16, total);
const tax = caseSensitive ? Math.pow(2, letters) : 1;
// case-sensitive mode pays an extra keccak per attempt → ~30% slower hot loop.
const ratePerCore = caseSensitive ? RATE_PER_CORE * 0.7 : RATE_PER_CORE;
return (base * tax) / (ratePerCore * cores);
}
function bytesToHex(bytes) {
let s = '';
for (let i = 0; i < bytes.length; i++) s += bytes[i].toString(16).padStart(2, '0');
return s;
}
function hexToBytes(hex) {
let h = (hex || '').trim();
if (h.startsWith('0x') || h.startsWith('0X')) h = h.slice(2);
if (h.length % 2) return null;
if (!/^[0-9a-f]*$/i.test(h)) return null;
const out = new Uint8Array(h.length / 2);
for (let i = 0; i < out.length; i++) out[i] = parseInt(h.substring(i*2, i*2+2), 16);
return out;
}
// ── Preset deployer chips ──────────────────────────────────────────
document.querySelectorAll('.preset[data-deployer]').forEach((b) => {
b.title = b.dataset.name || '';
b.addEventListener('click', () => {
$('deployer').value = b.dataset.deployer;
$('deployer').dispatchEvent(new Event('input'));
});
});
// ── Wordlist chips ────────────────────────────────────────────────
const chipsEl = $('word-chips');
PRESET_CHIPS.forEach((w) => {
const b = document.createElement('button');
b.type = 'button';
b.className = 'preset';
b.dataset.word = w;
b.innerHTML = `${esc(w)}<span class="chip-est"></span>`;
b.addEventListener('click', () => {
$('prefix').value = w;
$('prefix').dispatchEvent(new Event('input'));
$('prefix').focus();
});
chipsEl.appendChild(b);
});
refreshChipEstimates();
// ── Auto-hash raw initCode → fill initcode-hash ────────────────────
$('initcode-raw').addEventListener('input', () => {
const raw = $('initcode-raw').value.trim();
if (!raw) return;
const bytes = hexToBytes(raw);
$('initcode-raw').classList.toggle('invalid', !bytes);
if (!bytes) return;
const h = '0x' + bytesToHex(keccak_256(bytes));
$('initcode-hash').value = h;
$('initcode-hash').dispatchEvent(new Event('input'));
});
// ── Live preview / validation ──────────────────────────────────────
function readPattern() {
// Preserve casing — the grinder switches into EIP-55 mode if any char is uppercase.
const p = $('prefix').value.trim().replace(/^0x/i, '');
const s = $('suffix').value.trim();
const caseSensitive = /[A-F]/.test(p) || /[A-F]/.test(s);
return { p, s, caseSensitive };
}
let previewLoop = null;
function startPreviewLoop() {
stopPreviewLoop();
previewLoop = setInterval(() => {
const { p, s } = readPattern();
if ($('prefix').classList.contains('invalid') || $('suffix').classList.contains('invalid')) return;
const middle = $('preview').querySelector('.rest');
if (middle) middle.textContent = sample('', '').slice(0, 40 - p.length - s.length);
}, 700);
}
function stopPreviewLoop() { if (previewLoop) clearInterval(previewLoop); previewLoop = null; }
function update() {
const { p, s, caseSensitive } = readPattern();
const pv = p ? validatePattern(p) : { valid: true, errors: [], caseSensitive: false };
const sv = s ? validatePattern(s) : { valid: true, errors: [], caseSensitive: false };
$('prefix').classList.toggle('invalid', !!p && !pv.valid);
$('suffix').classList.toggle('invalid', !!s && !sv.valid);
const dv = validateAddress($('deployer').value || '');
const ich = validateInitCodeHash($('initcode-hash').value || '');
$('deployer').classList.toggle('invalid', !!$('deployer').value && !dv.valid);
$('initcode-hash').classList.toggle('invalid', !!$('initcode-hash').value && !ich.valid);
const total = (pv.valid ? p.length : 0) + (sv.valid ? s.length : 0);
const letters = letterCount(p) + letterCount(s);
const secs = total === 0 ? 0 : estSeconds(p.length, s.length, letters, caseSensitive);
const heat = heatLevel(secs);
// Difficulty meter — segments light by estimated wall-clock heat at
// the current core count, green → orange → red.
document.querySelectorAll('.meter .seg').forEach((seg, i) => {
seg.className = 'seg' + (i < heat ? ` lit-${heat}` : '');
});
if (total === 0) {
$('preview').innerHTML = `<span class="rest">0x${esc(sample())}</span>`;
$('est').textContent = 'type a pattern to see estimated time';
$('case-tag').innerHTML = '';
$('tier').innerHTML = '';
} else {
const mid = sample('', '').slice(0, 40 - p.length - s.length);
$('preview').innerHTML =
`0x` +
(p ? `<span class="pfx">${esc(p)}</span>` : '') +
`<span class="rest">${esc(mid)}</span>` +
(s ? `<span class="sfx">${esc(s)}</span>` : '');
$('est').textContent = `rough estimate: ${fmtTime(secs)} on ${cores} cores`;
$('case-tag').innerHTML = caseSensitive
? `<span style="background:rgba(255,255,255,0.07);color:#888888;border:1px solid rgba(255,255,255,0.14);padding:.05rem .4rem;border-radius:999px;font-size:.7rem">EIP-55 case-sensitive</span>`
: '';
$('tier').innerHTML = heat >= 4
? '<span class="tier-tag tier-paid">slow — minutes+</span>'
: '<span class="tier-tag tier-free">fast</span>';
}
$('grind').disabled =
!dv.valid || !ich.valid || total === 0 ||
(!!p && !pv.valid) || (!!s && !sv.valid);
}
['prefix','suffix','deployer','initcode-hash'].forEach((id) => {
$(id).addEventListener('input', update);
$(id).addEventListener('keydown', (e) => {
if (e.key === 'Enter' && !$('grind').disabled) $('grind').click();
});
});
update();
startPreviewLoop();
// ── Grind ──────────────────────────────────────────────────────────
let abort = null;
let controls = null; // GrindController for pause/resume/stop
let scanLoop = null;
// Render a shimmering scan line: 0x + highlighted prefix + dim middle + suffix.
function renderScan(p, s) {
const mid = sample('', '').slice(0, 40 - p.length - s.length);
return `0x${p ? `<span class="pfx">${esc(p)}</span>` : ''}<span class="scan-mid" style="color:#555">${esc(mid)}</span>${s ? `<span class="sfx">${esc(s)}</span>` : ''}`;
}
// Pattern + core controls can only change between runs — the worker pool
// and target pattern are fixed for the lifetime of a grind.
function setCoreControlsDisabled(disabled) {
coreSlider.disabled = disabled;
$('core-ticks').querySelectorAll('button').forEach((b) => { b.disabled = disabled; });
$('prefix').disabled = disabled;
$('suffix').disabled = disabled;
$('deployer').disabled = disabled;
$('initcode-hash').disabled = disabled;
$('initcode-raw').disabled = disabled;
}
function setPaused(paused) {
$('pause').textContent = paused ? 'Resume' : 'Pause';
$('pause').classList.toggle('primary', paused);
$('paused-tag').hidden = !paused;
$('progress').classList.toggle('paused', paused);
}
function endGrindUI() {
if (scanLoop) { clearInterval(scanLoop); scanLoop = null; }
$('pause').hidden = true;
$('cancel').hidden = true;
setPaused(false);
setCoreControlsDisabled(false);
}
$('grind').addEventListener('click', async () => {
const { p, s, caseSensitive } = readPattern();
const dv = validateAddress($('deployer').value);
const ich = validateInitCodeHash($('initcode-hash').value);
if (!dv.valid) { showError(dv.error); return; }
if (!ich.valid) { showError(ich.error); return; }
$('grind').hidden = true;
$('pause').hidden = false;
$('cancel').hidden = false;
setPaused(false);
setCoreControlsDisabled(true);
$('progress').hidden = false;
$('result').hidden = true;
$('error').hidden = true;
$('attempts').textContent = '0';
$('rate').textContent = '0/s';
$('cores2').textContent = cores;
$('eta').textContent = fmtTime(estSeconds(p.length, s.length, letterCount(p) + letterCount(s), caseSensitive));
$('scan').innerHTML = renderScan(p, s);
stopPreviewLoop();
// Animate the scan-line middle during grind (frozen while paused).
scanLoop = setInterval(() => {
if (controls?.paused) return;
const midNode = $('scan').querySelector('.scan-mid');
if (midNode) midNode.textContent = sample('', '').slice(0, 40 - p.length - s.length);
}, 100);
abort = new AbortController();
controls = {};
try {
const result = await grindCreate2Vanity({
deployer: dv.normalized,
initCodeHash: ich.normalized,
prefix: p || undefined,
suffix: s || undefined,
maxWorkers: cores,
controller: controls,
signal: abort.signal,
onProgress: ({ attempts, rate, eta, paused }) => {
$('attempts').textContent = attempts.toLocaleString();
$('rate').textContent = paused ? 'paused' : `${Math.round(rate).toLocaleString()}/s`;
$('eta').textContent = eta;
},
});
renderResult(result, p, s);
} catch (err) {
if (err?.name !== 'AbortError') showError(`Grind failed: ${err.message || err}`);
resetIdle();
} finally {
controls = null;
if (scanLoop) { clearInterval(scanLoop); scanLoop = null; }
}
});
$('pause').addEventListener('click', () => {
if (!controls) return;
if (controls.paused) { controls.resume(); setPaused(false); }
else { controls.pause(); setPaused(true); }
});
$('cancel').addEventListener('click', () => abort?.abort());
function showError(msg) {
$('error').textContent = msg;
$('error').hidden = false;
}
function resetIdle() {
endGrindUI();
$('grind').hidden = false;
$('progress').hidden = true;
startPreviewLoop();
}
function renderResult(result, p, s) {
endGrindUI();
$('grind').hidden = false;
$('grind').textContent = 'Grind another';
$('progress').hidden = true;
// Use the checksummed (EIP-55) form for display when the user
// asked for a case-sensitive match; otherwise show lowercase.
const display = result.caseSensitive ? result.addressChecksum : result.address;
const addrNoPrefix = display.slice(2);
const mid = addrNoPrefix.slice(p.length, addrNoPrefix.length - s.length);
const html = `
<div class="result">
<h3>✦ Salt found</h3>
<div class="out-row">
<span class="k">address</span> 0x${
(p ? `<span class="pfx">${esc(p)}</span>` : '') +
esc(mid) +
(s ? `<span class="sfx">${esc(s)}</span>` : '')
}
</div>
${result.caseSensitive ? `<div class="out-row"><span class="k">lowercase</span> ${esc(result.address)}</div>` : ''}
<div class="out-row"><span class="k">salt</span> ${esc(result.salt)}</div>
<div class="out-row"><span class="k">deployer</span> ${esc(result.deployer)}</div>
<div class="out-row"><span class="k">initCodeHash</span> ${esc(result.initCodeHash)}</div>
<div class="meta">
${result.attempts.toLocaleString()} attempts in ${(result.durationMs/1000).toFixed(1)}s
across ${result.workers} cores
(${Math.round(result.attempts / (result.durationMs/1000)).toLocaleString()}/s)${result.caseSensitive ? ' · EIP-55 case-sensitive' : ''}
</div>
<div class="actions">
<button id="copy-salt" class="btn primary" type="button">Copy salt</button>
<button id="copy-addr" class="btn" type="button">Copy address</button>
<button id="download" class="btn" type="button">⬇ Download JSON</button>
</div>
<div class="warn">
The address above will only match if you deploy with the <em>exact</em> initCode whose hash you entered.
Same factory + same initCode + this salt → same address, on every EVM chain that has this factory deployed.
</div>
</div>
<div id="assign-host"></div>
`;
$('result').hidden = false;
$('result').innerHTML = html;
renderAssignBlock(result, p, s);
$('copy-salt').addEventListener('click', () => copy(result.salt, 'copy-salt', 'Copy salt'));
$('copy-addr').addEventListener('click', () => copy(result.caseSensitive ? result.addressChecksum : result.address, 'copy-addr', 'Copy address'));
$('download').addEventListener('click', () => {
const payload = {
address: result.address,
addressChecksum: result.addressChecksum,
salt: result.salt,
deployer: result.deployer,
initCodeHash: result.initCodeHash,
pattern: { prefix: p || null, suffix: s || null, caseSensitive: !!result.caseSensitive },
attempts: result.attempts,
durationMs: result.durationMs,
generatedAt: new Date().toISOString(),
};
const blob = new Blob([JSON.stringify(payload, null, 2)], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = `create2-vanity-${result.address.slice(2, 10)}.json`;
document.body.appendChild(a);
a.click();
a.remove();
URL.revokeObjectURL(url);
});
}
async function copy(text, btnId, restoreLabel) {
try {
await navigator.clipboard.writeText(text);
$(btnId).textContent = 'Copied!';
setTimeout(() => { $(btnId).textContent = restoreLabel; }, 1400);
} catch {}
}
// ── Assign to agent ───────────────────────────────────────────────
async function renderAssignBlock(result, p, s) {
const host = document.getElementById('assign-host');
if (!host) return;
let agents = [];
try {
const r = await fetch('/api/agents', { credentials: 'include' });
if (r.status === 401) {
host.innerHTML = `
<div class="card" style="margin-top:1rem">
<h2>Assign to an agent</h2>
<p class="desc" style="margin:0">
<a href="/login.html?next=${encodeURIComponent(location.pathname)}" style="color:#ffffff">Sign in</a>
to assign this CREATE2 vanity to one of your agents — they'll display it on their profile and you can deploy it from the agent home page.
</p>
</div>`;
return;
}
if (!r.ok) throw new Error(`agents fetch ${r.status}`);
const data = await r.json();
agents = data.agents || [];
} catch (e) {
host.innerHTML = `<div class="card" style="margin-top:1rem"><h2>Assign to an agent</h2><p class="desc" style="color:var(--bad-fg);margin:0">Could not load your agents: ${esc(e.message)}</p></div>`;
return;
}
if (!agents.length) {
host.innerHTML = `
<div class="card" style="margin-top:1rem">
<h2>Assign to an agent</h2>
<p class="desc" style="margin:0">No agents yet. <a href="/create" style="color:#ffffff">Create one</a> and come back to assign this address.</p>
</div>`;
return;
}
const initCode = ($('initcode-raw').value || '').trim();
const hasInitCode = /^0x[0-9a-f]+$/i.test(initCode) && initCode.length % 2 === 0;
// Find the matching preset label by deployer address
let presetLabel = null;
document.querySelectorAll('.preset[data-deployer]').forEach((b) => {
if (b.dataset.deployer.toLowerCase() === $('deployer').value.toLowerCase()) presetLabel = b.dataset.name;
});
host.innerHTML = `
<div class="card" style="margin-top:1rem">
<h2>Assign to an agent</h2>
<p class="desc" style="margin:0 0 .5rem">
Save this CREATE2 record (deployer + salt + init code hash + predicted address) to one of your agents.
No private keys are stored — the predicted address is just a deterministic function of the inputs.
${hasInitCode ? 'Raw init code will be saved alongside, enabling one-click deploy from the agent home page (Arachnid only).' : 'No raw init code provided — you\'ll be able to deploy from your own tooling.'}
</p>
<select id="assign-agent" style="margin-top:.4rem">
<option value="">— select an agent —</option>
${agents.map((a) => `<option value="${esc(a.id)}">${esc(a.name)}${a.meta?.eth_vanity ? ' (already has CREATE2 vanity)' : ''}</option>`).join('')}
</select>
<div class="actions">
<button id="assign-btn" class="btn primary" type="button" disabled>Assign to agent</button>
</div>
<div id="assign-status" style="margin-top:.5rem;font-size:.8rem"></div>
</div>
`;
const sel = document.getElementById('assign-agent');
const btn = document.getElementById('assign-btn');
const status = document.getElementById('assign-status');
sel.addEventListener('change', () => { btn.disabled = !sel.value; });
btn.addEventListener('click', async () => {
btn.disabled = true;
status.textContent = 'assigning…';
status.style.color = '#888';
const payload = {
deployer: result.deployer,
salt: result.salt,
init_code_hash: result.initCodeHash,
init_code: hasInitCode ? initCode.toLowerCase() : null,
predicted_address: result.address,
prefix: p || null,
suffix: s || null,
case_sensitive: !!result.caseSensitive,
deployer_label: presetLabel,
};
try {
let r = await apiFetch(`/api/agents/${encodeURIComponent(sel.value)}/eth-vanity`, {
method: 'POST',
credentials: 'include',
headers: { 'content-type': 'application/json' },
body: JSON.stringify(payload),
});
// On 409, ask before replacing.
if (r.status === 409) {
if (!confirm('This agent already has a CREATE2 vanity record. Replace it?')) {
btn.disabled = false; status.textContent = ''; return;
}
const del = await apiFetch(`/api/agents/${encodeURIComponent(sel.value)}/eth-vanity`, { method: 'DELETE', credentials: 'include' });
if (!del.ok) {
const dd = await del.json().catch(() => ({}));
status.innerHTML = `<span style="color:var(--bad-fg)">Could not remove existing record: ${esc(dd.error_description || del.status)}</span>`;
btn.disabled = false; return;
}
r = await apiFetch(`/api/agents/${encodeURIComponent(sel.value)}/eth-vanity`, {
method: 'POST', credentials: 'include',
headers: { 'content-type': 'application/json' },
body: JSON.stringify(payload),
});
}
const data = await r.json().catch(() => ({}));
if (!r.ok) {
status.innerHTML = `<span style="color:var(--bad-fg)">Failed: ${esc(data.error_description || r.status)}</span>`;
btn.disabled = false;
return;
}
const agentName = sel.options[sel.selectedIndex].text.replace(/\s*\(already.*\)$/, '');
host.innerHTML = `
<div class="card" style="margin-top:1rem;background:rgba(74,222,128,0.06);border-color:rgba(74,222,128,0.2)">
<h2 style="color:var(--ok-fg)">✓ Assigned to ${esc(agentName)}</h2>
<p class="desc" style="margin:0">
<a href="/agents/${esc(sel.value)}" style="color:#ffffff">Open agent →</a>
The CREATE2 record is saved. Deploy it from the agent home page when you're ready.
</p>
</div>`;
} catch (e) {
status.innerHTML = `<span style="color:var(--bad-fg)">Network error: ${esc(e.message)}</span>`;
btn.disabled = false;
}
});
}
</script>
<div id="footer-container"></div>
<script src="/footer.js" defer></script>
<script src="/brand.js" defer></script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>