frontpage-profile

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

当用户有以下需求时可使用此Skill：

申领或更新钱包的显示名称（及可选头像）
查看钱包的资料和活动——提交的创意、投出的选票、购买的广告
在frontpage.sh上查询钱包地址背后的用户身份

支付即登录——支付的钱包拥有该名称。名称不唯一，标准身份始终是钱包地址。UI会显示

name·tail

，其中tail是地址的最后4个字符（例如

santi·1a2b

）。申领需通过MPP支付0.01 USDC。你的Agent会处理复杂的部分。

Install

安装

bash

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).

bash

npx skills add DFectuoso/frontpage-sh-skills --copy                     # 所有frontpage技能
npx skills add DFectuoso/frontpage-sh-skills/frontpage-profile --copy   # 仅安装此技能

如果要在开发环境/Tempo测试网测试？同时安装开发版本：

npx skills add DFectuoso/frontpage-sh-skills-dev --copy

（会得到

frontpage-profile-dev

，它会覆盖基础URL和网络配置）。

API

Base URL:

https://frontpage.sh

基础URL:

https://frontpage.sh

POST /api/profile

— $0.01 via MPP

POST /api/profile

— 通过MPP支付0.01美元

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

bash

mppx https://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://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

为支付钱包申领或更新显示名称（及可选头像）。

bash

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

或者通过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://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>' // 可选；webp/gif/svg会返回400错误
  }),
})
const data = await res.json()
// { ok: true, wallet: '0x...', name: 'santi', imageUrl: null }

请求字段：

```
name
```
: 2–32个字符，允许
```
[a-zA-Z0-9 ._-]
```
— 必填
```
image
```
: 内联头像，格式为纯base64或data URL — 仅支持PNG或JPEG（webp/gif/svg/avif会被拒绝并返回
```
400 IMAGE_UNSUPPORTED
```
，通过实际字节检查）；可选；最大1 MB

错误：

```
400 VALIDATION
```
— 名称过短/过长或包含无效字符
```
400 MODERATION_FAILED
```
— 名称被AI审核标记
```
400 IMAGE_DECODE_FAILED
```
/
```
IMAGE_TOO_LARGE
```
— 头像无效或过大
```
409 DUPLICATE_CREDENTIAL
```
— 该MPP支付凭证已被使用

GET /api/profiles/{wallet}

— free

GET /api/profiles/{wallet}

— 免费

Fetch a wallet's public profile and activity summary.

bash

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

Response:

json

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

profile

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

获取钱包的公开资料和活动摘要。

bash

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

响应：

json

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

如果钱包从未申领过名称，

profile

为

null

。

adsBought

、

proposalsSubmitted

、

votesCast

和

commentsPosted

始终返回整数（无数据时为0）。

错误：

```
400 BAD_WALLET
```
— 地址不是有效的40字符十六进制EVM地址

Heuristics for agents

Agent启发式规则

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.

申领前告知0.01美元费用。在支付前需与用户确认。
名称不是登录令牌。钱包地址是标准身份；名称仅用于显示。
名称不唯一是允许的。两个钱包可以共享一个名称——UI中会通过
```
·tail
```
后缀区分它们。
使用
GET /api/profiles/{wallet}
检查钱包是否已有名称，再提示用户申领。
支付者即为所有者。名称会绑定到MPP签名的钱包——确保Agent的MPP配置中使用了正确的密钥。

frontpage-profile

Original

Translation

frontpage-profile

frontpage-profile

Install

安装

API

API

`POST /api/profile`
— $0.01 via MPP

`POST /api/profile`
— 通过MPP支付0.01美元

`GET /api/profiles/{wallet}`
— free

`GET /api/profiles/{wallet}`
— 免费

Heuristics for agents

Agent启发式规则