Developer Docs

async function resolveHandle(handle) {
  const res = await fetch(
    `https://nimimo.com/api/v1/resolve?handle=${handle}`
  )
  if (!res.ok) throw new Error("Resolution failed")
  return res.json()
}

const { addresses } = await resolveHandle("neat-gecko")
console.log(addresses.bitcoin)
// "bc1qz3yaratxc9z6wz2pj2k97nzl00l4cucpvcquq9"

import requests

def resolve_handle(handle, chain=None):
    params = {"handle": handle}
    if chain:
        params["chain"] = chain
    r = requests.get("https://nimimo.com/api/v1/resolve", params=params)
    r.raise_for_status()
    return r.json()

result = resolve_handle("neat-gecko")
print(result["addresses"]["ethereum"])
# "0x874a40B1857B006d46b80c9e6badCEF3BA3B705C"

curl "https://nimimo.com/api/v1/resolve?handle=neat-gecko"

# Single chain
curl "https://nimimo.com/api/v1/resolve?handle=neat-gecko&chain=solana"

// 1. Create the intent
const create = await fetch("https://nimimo.com/api/v1/intents", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    to: "@neat-gecko",
    chain: "ethereum",
    amount: "0.05",
    memo: "Invoice #1042",
  }),
})
const intent = await create.json()

// 2. Send the user to intent.sign_url to sign in their wallet
window.open(intent.sign_url, "_blank")

// 3. Poll for completion
const poll = setInterval(async () => {
  const res = await fetch(`https://nimimo.com/api/v1/intents/${intent.intent_id}`)
  const status = await res.json()
  if (["completed", "cancelled", "expired"].includes(status.status)) {
    clearInterval(poll)
    if (status.status === "completed") console.log("Paid:", status.tx_hash)
  }
}, 3000)

# Create
curl -X POST https://nimimo.com/api/v1/intents \
  -H "Content-Type: application/json" \
  -d '{ "to": "@neat-gecko", "chain": "ethereum", "amount": "0.05" }'

# Check status
curl https://nimimo.com/api/v1/intents/int_9x21abc...

# Cancel
curl -X PATCH https://nimimo.com/api/v1/intents/int_9x21abc... \
  -H "Content-Type: application/json" \
  -d '{ "status": "cancelled" }'

import { NimimoClient } from "@nimimo/resolve"

const nimimo = new NimimoClient()

// Optional: custom config
const nimimo = new NimimoClient({
  baseUrl: "https://nimimo.com",  // default; SDK appends /api/v1 internally
  maxRetries: 2,                  // retries on 429 with exponential backoff
  cacheTtl: 30_000,               // 30s in-memory cache for resolve()
})

const { handle, addresses } = await nimimo.resolve("neat-gecko")

console.log(addresses.bitcoin)
// "bc1qz3yaratxc9z6wz2pj2k97nzl00l4cucpvcquq9"

console.log(addresses.ethereum)
// "0x874a40B1857B006d46b80c9e6badCEF3BA3B705C"

console.log(addresses.solana)
// "9rhN3eug2LbqZKCtbkGRKjRq9BVa4Y5VE4Puf2p4HCRk"

const { address } = await nimimo.resolve("neat-gecko", "bitcoin")
// "bc1qz3yaratxc9z6wz2pj2k97nzl00l4cucpvcquq9"

const results = await nimimo.resolveMany(["neat-gecko", "lucky-mountain"])
// [
//   { handle: "neat-gecko", addresses: { bitcoin: "bc1q...", ... } },
//   { handle: "lucky-mountain", addresses: { bitcoin: "bc1q...", ... } }
// ]

const exists = await nimimo.exists("neat-gecko")  // true
const nope = await nimimo.exists("nonexistent")   // false

const intent = await nimimo.paymentIntent("neat-gecko", {
  chain: "ethereum",
  amount: "0.05",  // ETH
})

// intent = {
//   to: "0x874a40B1857B006d46b80c9e6badCEF3BA3B705C",
//   value: "50000000000000000",  // wei
//   chain: "ethereum",
//   amount: "0.05",
//   handle: "neat-gecko",
// }

// Use with ethers.js
await signer.sendTransaction({ to: intent.to, value: intent.value })

// Use with wagmi/viem
await sendTransaction({ to: intent.to, value: intent.value })

const intent = await nimimo.paymentIntent("neat-gecko", {
  chain: "bitcoin",
  amount: "0.001",  // BTC
})
// intent.to    → "bc1qz3yaratxc9z6wz2pj2k97nzl00l4cucpvcquq9"
// intent.value → "100000" (satoshis)

import { NimimoClient, IntentNotFound, IntentExpired } from "@nimimo/resolve"

const nimimo = new NimimoClient()

// Create
const created = await nimimo.createIntent({
  to: "@neat-gecko",
  chain: "ethereum",
  amount: "0.05",
  memo: "Invoice #1042",
  // from, asset, expires_at are optional
})

console.log(created.intent_id)   // "int_9x21abc..."
console.log(created.sign_url)    // "https://nimimo.com/sign/int_9x21abc..."
console.log(created.status)      // "awaiting_signature"

// Poll
const intent = await nimimo.getIntent(created.intent_id)
if (intent.status === "completed") {
  console.log("Paid:", intent.tx_hash)
}

// Cancel
try {
  await nimimo.cancelIntent(created.intent_id)
} catch (err) {
  if (err instanceof IntentExpired) {
    console.log("Already expired")
  } else if (err instanceof IntentNotFound) {
    console.log("No such intent")
  }
}

const url = nimimo.payUrl("neat-gecko", {
  chain: "ethereum",
  amount: "0.05",
})
// "https://nimimo.com/@neat-gecko?pay=0.05&chain=ethereum"

// Drop it in an invoice, a bio, or a chat message.
// Anyone who clicks it can pay from any wallet.

import { NimimoClient, HandleNotFound, NoAddress, RateLimited } from "@nimimo/resolve"

try {
  const result = await nimimo.resolve("nonexistent-handle")
} catch (err) {
  if (err instanceof HandleNotFound) {
    console.log("Handle doesn't exist")
  } else if (err instanceof NoAddress) {
    console.log("No address for this chain")
  } else if (err instanceof RateLimited) {
    console.log("Too many requests — SDK auto-retries with backoff")
  }
}