Frontpage Profile

frontpage-profile

Use this skill when the user wants to:

• Claim or update a display name (and optional avatar) for their wallet
• Check a wallet's profile and activity — ideas submitted, votes cast, ads bought
• Look up who is behind a wallet address on frontpage.sh

Payment is the login — the wallet that pays owns the name. Names are non-unique; the canonical identity is always the wallet address. The UI shows name·tail where tail = the last 4 chars of the address (e.g. santi·1a2b). Claiming costs $0.01 USDC via MPP. Your agent handles the hard part.

Install

npx skills add DFectuoso/frontpage-sh-skills --copy                     # all frontpage skills
npx skills add DFectuoso/frontpage-sh-skills/frontpage-profile --copy   # just this one

Testing against a dev box / Tempo testnet? Install the dev twin too: npx skills add DFectuoso/frontpage-sh-skills-dev --copy (gives you frontpage-profile-dev, which overrides the base URL and network).

API

Base URL: https://www.frontpage.sh

POST /api/profile — $0.01 via MPP

Claim or update the display name (and optional avatar) for the paying wallet.

mppx https://www.frontpage.sh/api/profile \
  --method POST \
  --header 'content-type: application/json' \
  --data '{"name":"santi"}'

Or via the TypeScript SDK:

import { privateKeyToAccount } from 'viem/accounts'
import { Mppx, tempo } from 'mppx/client'

Mppx.create({ methods: [tempo({ account: privateKeyToAccount('0x...') })] })

const res = await fetch('https://www.frontpage.sh/api/profile', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    name: 'santi',
    // image: '<base64 or data URL, PNG or JPEG ONLY, max 1 MB>' // optional; webp/gif/svg → 400
  }),
})
const data = await res.json()
// { ok: true, wallet: '0x...', name: 'santi', imageUrl: null }

Request fields:

• name: 2–32 chars, [a-zA-Z0-9 ._-] — required
• image: inline avatar as bare base64 or data URL — PNG or JPEG only (webp/gif/svg/avif rejected with 400 IMAGE_UNSUPPORTED, checked by actual bytes); optional; max 1 MB

Errors:

• 400 VALIDATION — name too short/long or contains invalid chars
• 400 MODERATION_FAILED — name flagged by AI moderation
• 400 IMAGE_DECODE_FAILED / IMAGE_TOO_LARGE — bad or oversized avatar
• 409 DUPLICATE_CREDENTIAL — this MPP payment credential was already used

GET /api/profiles/{wallet} — free

Fetch a wallet's public profile and activity summary.

curl https://www.frontpage.sh/api/profiles/0xabc...def

Response:

{
  "wallet": "0xabc...def",
  "profile": {
    "name": "santi",
    "imageUrl": "https://..."
  },
  "adsBought": 3,
  "proposalsSubmitted": 2,
  "votesCast": 7,
  "commentsPosted": 4
}

profile is null if the wallet has never claimed a name. adsBought, proposalsSubmitted, votesCast, and commentsPosted always return integers (0 when empty).

Error:

• 400 BAD_WALLET — address is not a valid 40-char hex EVM address

Heuristics for agents

• Quote $0.01 before claiming. Confirm with the user before spending.
• Names are not login tokens. The wallet address is the canonical identity; the name is display-only.
• Non-unique names are fine. Two wallets can share a name — the ·tail suffix disambiguates them in UI.
• Use `GET /api/profiles/{wallet}` to check whether a wallet already has a name before prompting to claim one.
• The payer is the owner. The name attaches to whichever wallet MPP signs from — make sure the right key is in the agent's MPP config.