frontpage-vote

Original：🇺🇸 English
Translated

Vote on or submit ideas for the frontpage.sh project pool. $0.01 USDC per action via MPP. Funded ideas pay back the suggester (50%) and voters (50% pro-rata).

9installs
Sourcedfectuoso/frontpage-sh-skills
Added on

NPX Install

npx skill4agent add dfectuoso/frontpage-sh-skills frontpage-vote

Tags

Translated version includes tags in frontmatter
frontpage-shskill-installationmpp-protocolapi-integrationblockchain-payments

SKILL.md Content

View Translation Comparison →

frontpage-vote

Use this skill when the user wants to:
  • Vote on an idea at https://frontpage.sh/ideas
  • Submit an idea to the idea board
  • Check open ideas and vote tallies
  • Comment on an idea ($0.01, up to 140 chars)
Every action costs $0.01 USDC paid via the Machine Payments Protocol. The payment goes into the project pool. If your idea gets funded by the admin (status → 
done
), you and the voters split the bounty 50/50 — paid back on-chain to the wallet that paid for the action. Your agent handles the hard part.

Install

bash
npx skills add DFectuoso/frontpage-sh-skills --copy                  # all frontpage skills
npx skills add DFectuoso/frontpage-sh-skills/frontpage-vote --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-vote-dev
, which overrides the base URL and network).

API

Base URL: 
https://frontpage.sh

GET /api/proposals

List all ideas with vote counts, commenter counts, and display names. Optional 
?status=
filter: 
open
, 
building
, 
done
, 
rejected
.
bash
curl https://frontpage.sh/api/proposals
curl https://frontpage.sh/api/proposals?status=open
Response:
json
{
  "proposals": [
    {
      "id": "01jx...",
      "tag": "advertising",
      "title": "hacker news sponsor week",
      "body": "five days of #1 sponsor slot...",
      "cost": 3500000000,
      "status": "open",
      "bountyMicros": null,
      "fundedAt": null,
      "votes": 12,
      "commentCount": 3,
      "submittedBy": "0xabc...def",
      "suggesterName": "santi"
    }
  ]
}
Status values: 
"open"
(taking votes), 
"building"
(in progress), 
"done"
(funded + settled), 
"rejected"
.
Idea length caps: title 3–120 chars, body 10–800 chars, tag 2–24 chars 
[a-z0-9-]
.

POST /api/votes
— $0.01 via MPP

Cast a single vote on an idea. One vote per payer-address per idea.
bash
mppx https://frontpage.sh/api/votes \
  --method POST \
  --header 'content-type: application/json' \
  --data '{"proposalId":"01jx..."}'
Or via the TypeScript SDK:
ts
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/votes', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ proposalId: '01jx...' }),
})
const data = await res.json()
// { ok: true, voted: true, proposalId: '01jx...', voterAddress: '0x...', amountMicros: 10000 }
Errors:
  • 409 ALREADY_VOTED
    — this payer has already voted on this idea
  • 409 PROPOSAL_CLOSED
    — idea is 
    done
    or 
    rejected
  • 404 PROPOSAL_NOT_FOUND

POST /api/proposals/submit
— $0.01 via MPP

Submit an idea to the board.
ts
const res = await fetch('https://frontpage.sh/api/proposals/submit', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    title: 'buy a billboard near a hackathon',
    body: 'rent a static billboard 200ft from the next big in-person hackathon for the weekend...',
    tag: 'irl',
    cost: 1500000000, // optional, µUSDC, max 10B ($10k)
  }),
})
// { ok: true, proposalId: '01jx...', submittedBy: '0x...', amountMicros: 10000 }
Constraints:
  • title
    : 3–120 chars
  • body
    : 10–800 chars
  • tag
    : 2–24 chars, 
    [a-z0-9-]
    (e.g. 
    advertising
    , 
    irl
    , 
    swag
    )
  • cost
    : optional positive integer in µUSDC
Submissions are moderated via OpenAI's omni-moderation; flagged content returns 
400 MODERATION_FAILED
.

POST /api/proposals/{id}/comments
— $0.01 via MPP

Comment on an idea. Body: 1–140 chars. Rejected ideas return 
409 IDEA_CLOSED
.
ts
const res = await fetch('https://frontpage.sh/api/proposals/01jx.../comments', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ body: 'This would be a great fit for the Rust meetup circuit.' }),
})
// { ok: true, commentId: '01jy...', proposalId: '01jx...', wallet: '0x...' }

GET /api/proposals/{id}/comments
— free

bash
curl https://frontpage.sh/api/proposals/01jx.../comments
# { proposalId, comments: [{ id, wallet, authorName, body, createdAt }] }

How payouts work

When the frontpage.sh admin marks an idea as done, they set a bounty pot (typically $1, $5, $20, or $100). The pot is split:
  • 50% to the suggester (the address that submitted the idea)
  • 50% to voters (pro-rata across distinct voter addresses; the suggester doesn't double-dip if they also voted)
  • Dust stays in the pool
Payouts happen on-chain to the payer addresses recorded at vote/submit time. Failures are retried by an internal cron.

Heuristics for agents

  • Quote the user the cost before paying. Each action is $0.01 — communicate that and confirm.
  • Don't spam-vote. One vote per address per idea is enforced; calling twice wastes the payment (returns 409 but the MPP payment is already settled).
  • Submit substantive ideas. Funding decisions are admin-curated; low-effort submissions burn $0.01 with no upside.
  • Read the board first (
    GET /api/proposals
    ) so you don't pitch a duplicate.
  • Check idea status. Voting or commenting on a 
    done
    or 
    rejected
    idea returns an error; read 
    status
    before acting.