Skip to content

docs: add USA₮ on Ramp Network and the Self faucet as ways to get USA₮ - #2407

Merged
GigaHierz merged 2 commits into
mainfrom
GigaHierz/rampnetwork-docs-addition
Oct 23, 2026
Merged

GigaHierz merged 2 commits into
mainfrom
GigaHierz/rampnetwork-docs-addition

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

Summary

  • Ramp Network entry in `learn/ramps.mdx`: add USA₮ to Currency, Apple Pay and Google Pay to Payment Method, and a note that buy/sell/swap of USA₮ is available in the US.
  • `build/build-with-usat.mdx`: new "Get USA₮" section covering Ramp Network (buy with card, Apple Pay or Google Pay; swap in without a bridge; cash out to card or bank) and the Self faucet (verify with Self, then claim).

Notes

  • The Self faucet bullet links to the Self build page only; the faucet's own URL isn't in the repo.
  • Apple Pay and Google Pay are listed under the Ramp entry's Payment Method, but availability is stated for USA₮ in the US.

Test plan

  • `mint broken-links` passes
  • Preview both pages

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested review from a team as code owners October 21, 2026 22:14
@GigaHierz
GigaHierz requested review from karlb, palango and seolaoh and removed request for a team October 21, 2026 22:14

@palango palango left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Ramp listing itself checks out: Ramp's public asset API (https://api.ramp.network/api/host-api/assets) lists CELO_USAT at 0xD2ab3C9A02DBBAB236BfEC45D1d755DF4267F771, enabled, so it's the right token and not USDT. Two things before this goes in.

The Self faucet bullet should point at the faucet itself. It's Self and Google Cloud's USA₮ Mainnet Faucet at https://cloud.google.com/application/web3/faucet/celo/mainnet (the Valora launch post links it). It gives out real mainnet USA₮ to verified people, so "useful for testing" will send developers the wrong way.

I couldn't find a source for "available in the US" or for swapping USA₮ on Celo. Ramp's supported-assets article (https://support.rampnetwork.com/en/articles/432-what-cryptoassets-does-ramp-network-support) doesn't list USAT yet, and it says Ramp isn't available at all in Louisiana, Minnesota, Nevada, New Jersey, New York, Pennsylvania, Vermont, Washington and Puerto Rico, with stablecoins restricted in Texas. So "the US" overstates it. If you have the Ramp announcement or a partner note, could you link it? Otherwise I'd keep to buy and sell and say "supported US states".

Comment thread build/build-with-usat.mdx Outdated
## Get USA₮

- **[Ramp Network](/learn/ramps)**: buy USA₮ on Celo with a card, Apple Pay or Google Pay, swap in from other assets without a bridge, and cash out to a card or bank account. Available in the US.
- **Self faucet**: verify with [Self](/build/build-with-self) (a zero-knowledge proof of humanity), then claim USA₮. Useful for testing and onboarding new users.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The faucet is Self and Google Cloud's USA₮ Mainnet Faucet: https://cloud.google.com/application/web3/faucet/celo/mainnet. Could this link there, keeping the Self link for the verification step? It pays out real mainnet USA₮, so I'd drop "useful for testing".

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FIXED in d3a8d2a: the bullet links the Self and Google Cloud faucet, keeps the Self link for verification, and says it pays real mainnet USA₮. 'Useful for testing' is gone.

Comment thread build/build-with-usat.mdx Outdated

## Get USA₮

- **[Ramp Network](/learn/ramps)**: buy USA₮ on Celo with a card, Apple Pay or Google Pay, swap in from other assets without a bridge, and cash out to a card or bank account. Available in the US.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ramp's API confirms USA₮ on Celo. Do you have a source for the swap part and for the US availability? Ramp's support article lists nine states and territories where it doesn't operate and restricts stablecoins in Texas, so "supported US states" would be safer. Linking the Ramp Network section of /learn/ramps rather than the top of a 1000-line page would also help.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FIXED in d3a8d2a: I have no source for the swap or a US-wide claim, so both are dropped. It now says buy and sell in supported US states, and links the Ramp Network section (/learn/ramps#ramp-network).

Comment thread learn/ramps.mdx Outdated
- USA₮

<Note>
Buying, selling and swapping USA₮ on Ramp Network is available in the US. See [Build with USA₮](/build/build-with-usat).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same question as on the USA₮ page: where do the US-only and swap claims come from? A source link here would help whoever updates this entry next.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FIXED in d3a8d2a: same change here. The note says buying and selling in supported US states and no longer mentions swapping. I have no Ramp announcement to link; the claim rests on Ramp's asset API listing CELO_USAT.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested a review from palango October 22, 2026 16:33

@palango palango left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, all three points are fixed and the #ramp-network anchor resolves. One thing in the new wording, inline: Ramp only pays out US sales to a bank account, so selling with a card, Apple Pay or Google Pay doesn't hold. Could you also update the PR description? It still mentions swapping and says the faucet URL isn't in the repo. Approving so the fix doesn't need another round.

Comment thread build/build-with-usat.mdx

## Get USA₮

- **[Ramp Network](/learn/ramps#ramp-network)**: buy and sell USA₮ on Celo with a card, Apple Pay or Google Pay. Available in supported US states.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ramp's payout article (https://support.rampnetwork.com/en/articles/8992-what-payout-methods-are-available) says US sales pay out by bank only, through ACH or RTP, and "Card payouts are not available for US sales". Apple Pay and Google Pay are only for buying. Maybe: "buy USA₮ on Celo with a card, Apple Pay or Google Pay, and sell it to a US bank account. Available in supported US states."

@GigaHierz
GigaHierz merged commit a19a7f8 into main Oct 23, 2026
5 checks passed
@GigaHierz
GigaHierz deleted the GigaHierz/rampnetwork-docs-addition branch October 23, 2026 11:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants