docs: answer recurring assistant questions on availability, rewards, programs and facilitator trust

[GigaHierz]

Refs #2314, #2320, #2324, #2343

Answers the recurring in-scope questions from the assistant's unanswered-question reports that need a statement rather than a new page.

What changed

• home/wallets: MiniPay entry links the MiniPay availability list (https://docs.minipay.xyz/getting-started/availability.html, by country, platform and Opera Mini) instead of the hand-written five-country subset.
• contribute-to-celo/index: states that Celo has no points or task-reward program, links epoch rewards for locking CELO and voting, and says rewards inside apps (including MiniPay Mini Apps) are run by those apps; links the MiniPay availability list; developer programs point to Celo Devs on X; partnerships go through the Celo Discord or X (Celo, Celo Devs).
• build-on-celo/build-with-ai/x402: "Other facilitators" becomes "Trust and other facilitators": the Celo facilitator is run by Celo and built on x402-rs; a short checklist for any other facilitator (confirm the operator, check asset/amount/payTo before accepting, confirm the settlement transaction on-chain before delivering anything valuable, test on Celo Sepolia). The page no longer names or describes the facilitator's source repository.

No new addresses or numbers; the Celo facilitator URLs were already on the page.

Verification

$ mint broken-links
success no broken links found
$ bash scripts/check-orphans.sh
No orphan pages found.

The three changed pages were also viewed under mint dev with Playwright, and the MiniPay availability URL returns 200.

Overlap

#2349 and #2350 also edit home/wallets.mdx (frontmatter and a different section); this PR touches only the MiniPay entry.

🤖 Generated with Claude Code

[palango]

Thanks for picking these up from the assistant reports. Three things need fixing before this goes in.

The MiniPay availability link returns 404 in both places it is used. The MiniPay docs site serves that page at https://docs.minipay.xyz/getting-started/availability.html, which is also how build-on-celo/build-on-minipay/overview.mdx links into that site. The content behind it is right (Nigeria is available on Android, iOS and Opera Mini), so it's only the URL.

"Celo does not run a rewards or points program" is not true as written. CELO holders earn epoch rewards for locking and voting (/home/protocol/epoch-rewards/index, and self-custody.mdx walks through it), and Celo Devs runs Proof of Ship as a monthly builder rewards pool (https://www.celopg.eco/programs/proof-of-ship). The "As a Builder" section the sentence points to doesn't mention Proof of Ship either. I'd say Celo has no points or task-reward program, link epoch rewards for holders, and name Proof of Ship under builders.

The new facilitator checklist asks readers to confirm a facilitator's source is public, but line 74 of the same page says the Celo facilitator's source is a private repo. So the recommended default fails the first check, and the assistant will run into that when someone asks whether the facilitator can be trusted. Either drop the public-source criterion or say plainly that the Celo facilitator's source is private and that trust rests on transferWithAuthorization being non-custodial.

Smaller points are inline. One is whether X DMs to @celo are really where partnership requests should go; I couldn't confirm that, and it's a channel scammers like to imitate.

[palango]

This URL returns 404 when loaded directly. The MiniPay docs serve the page at https://docs.minipay.xyz/getting-started/availability.html (their own nav links it that way).

[palango]

CELO holders do earn protocol rewards for locking and voting (/home/protocol/epoch-rewards/index), and Celo Devs runs Proof of Ship for builders, so "does not run a rewards or points program" will mislead. Suggest something like: "Celo has no points or task-reward program. CELO holders can earn epoch rewards by locking CELO and voting for a group. Rewards inside apps, including MiniPay, are run by those apps." The MiniPay link here also needs the .html suffix (it 404s without it).

[palango]

Naming Proof of Ship here (https://www.celopg.eco/programs/proof-of-ship) would answer the "what programs are there" question directly. The rewards bullet above sends readers to this section, and right now it doesn't list any rewards program.

[palango]

Is @celo on X actually where partnership requests are triaged? I couldn't find that stated anywhere. Telling people to DM a brand account also helps impersonators. If there is a form or an address, link that instead.

[palango]

Line 66 says this is built on the open-source x402-rs, so "run by Celo, built on x402-rs" is more accurate than "built and run by Celo". The non-custody clause repeats line 66 word for word.

[palango]

Line 74 says the Celo facilitator's source is a private repo, so the recommended default fails this check. Either drop "source is public" or address it directly for the Celo facilitator.

[palango]

Worth adding that you should confirm the settlement transaction on-chain before delivering anything valuable. A facilitator can't redirect funds, because the payer signs to and value, but it can claim a settlement that never happened.

[GigaHierz]

Review points addressed in ddf14c2.

• MiniPay availability link now uses the .html URL (200) in both places.
• Rewards: now "no points or task-reward program"; links epoch rewards for locking and voting; apps, including MiniPay Mini Apps, run their own rewards. No mention of Proof of Ship, which is sunset.
• Partnerships: there is no form or email; the bullet says to reach out in the Celo Discord or on X (Celo or Celo Devs).
• x402: the Note naming the facilitator's repository is removed; the lead reads "run by Celo and built on x402-rs"; the checklist no longer asks for public source ("Confirm who operates it"); the repeated non-custody sentence is gone; added "confirm the settlement transaction on-chain before delivering anything valuable".

I left out any statement about what Celo staff will or won't ask over direct messages, since nothing on the site states such a policy.

mint broken-links and the orphan check pass; the three changed pages render under mint dev. #2349 and #2350 also edit home/wallets.mdx; #2352 merges cleanly with both.

[palango]

Thanks, this covers everything I raised. The MiniPay link resolves, the rewards line is accurate and points holders at epoch rewards, and the facilitator checklist no longer contradicts the page. You're right about Proof of Ship: the repo was archived in June, so please ignore that suggestion. This merges cleanly with #2349 and #2350, and after #2350 the availability link sits on the end-user wallet page, where it belongs.

Two optional nits inline on x402.mdx.

[palango]

With the source line gone, this Note only repeats the base URLs from line 71 and the endpoint list below it. I'd drop it.

[palango]

Optional: someone will ask whether the Celo facilitator is open source, and the page no longer says. If we're comfortable stating publicly how much of it is upstream x402-rs, a short clause here would answer that. Fine to leave as is.