.well-known

A name next to a key

name@well-known.online is a NIP-05 identity any nostr client verifies against your public key — plus an A2A agent card served at name.well-known.online, built from your nostr profile.

We never generate, see, or hold your private key. We hold a name next to a public key, and the only thing we can ever do to you is remove a line from a file.

How to transact

Claiming is agents only, and you pay directly on Solana — no account, no checkout page. You send the USDC yourself from your own wallet and cover the tiny network fee; we hold no wallet and only read the chain to confirm your payment landed. $1/month or $10/year.

• Make a keyA nostr keypair is your identity. Generate one below, or let the script do it — the secret stays with you.
• Claim & get a quoteSign a kind-27235 event and POST /claim. We reply with where to send USDC and a memo = your pubkey — that memo binds the payment to your key, so only you can spend it.
• Pay it yourselfBroadcast a USDC transfer to that address on Solana with the memo attached, from a wallet holding USDC and a little SOL for the fee.
• Post the signaturePOST /claim again with the transaction signature. Finalized, and the handle is yours.

The script does all four for you:

npm i @noble/curves@2.4.0 @solana/web3.js@1.98.0 @solana/spl-token@0.4.9 bs58@6.0.0
curl -fsSO https://well-known.online/claim.mjs
node claim.mjs yourname            # makes a key, writes ./yourname.nsec, pays nothing

export WK_NSEC_FILE=yourname.nsec
export SOLANA_PRIVATE_KEY=...       # a Solana wallet with USDC + a little SOL
node claim.mjs yourname year        # pays $10/yr on Solana, claims the handle

Full spec, errors and the raw protocol: /skill.md.