Add Generic USD on Citrea

[muhylmz]

Adds Generic USD (GUSD) issuance on Citrea.

• Adds the Citrea GUSD token adapter
• Counts issued supply from totalSupply
• Token: 0xac8c1aeb584765db16ac3e08d4736cfce198589b

Tested with:
npx ts-node --transpile-only test.ts generic-usd peggedUSD

Current live circulating supply returned by the adapter is about 412.96k GUSD.

Summary by CodeRabbit

• New Features
  • Added support for Generic USD (GUSD) stablecoin on Citrea blockchain with full integration and asset metadata configuration.

[coderabbitai]

Warning

Review limit reached

@realdealshaman, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 10 minutes and 44 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 695028cb-faf5-4d29-bdfc-f47a5b431c30

📥 Commits

Reviewing files that changed from the base of the PR and between a20e4d4 and 261c28f.

📒 Files selected for processing (1)

• src/peggedData/peggedData.ts

📝 Walkthrough

Walkthrough

Adds Generic USD (GUSD) as a new pegged asset by creating an adapter module that configures the citrea.issued contract and registering the asset metadata entry in the system's pegged-asset catalog with complete configuration fields.

Changes

Generic USD Pegged Asset

Layer / File(s)	Summary
Generic USD adapter module src/adapters/peggedAssets/generic-usd/index.ts	Defines chainContracts mapping with a citrea.issued contract address, wires it into addChainExports(...), and exports the produced adapter.
Generic USD asset metadata registration src/peggedData/peggedData.ts	Appends a new PeggedAsset entry (id "392") for Generic USD with symbol GUSD, including metadata fields for address, URL, description, audit, CoinGecko identifiers, peg mechanism, and a doublecounted: true flag.

Possibly Related PRs

• DefiLlama/peggedassets-server#786: Follows the same pattern—adds a new pegged-asset adapter module and appends a corresponding PeggedAsset entry to peggedData.ts.
• DefiLlama/peggedassets-server#788: Also extends peggedData.ts with a new PeggedAsset entry and introduces a new pegged-asset adapter using addChainExports.

Estimated Code Review Effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A new stablecoin hops into view,
Generic USD, so shiny and true—
Citrea's issued on the blockchain so bright,
Metadata configured, all fields just right! 🌟

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Add Generic USD on Citrea' directly and clearly describes the main change—adding Generic USD support on the Citrea blockchain.
Description check	✅ Passed	The description addresses the core changes (adapter addition, supply counting method, token address) and testing verification, though it lacks some template fields like website link, logo, and detailed metadata.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/peggedData/peggedData.ts`:
- Line 8113: Update the token entry that sets address:
"0xac8c1aeb584765db16ac3e08d4736cfce198589b" to a chain-qualified address by
prefixing it with "citrea:" (i.e.,
"citrea:0xac8c1aeb584765db16ac3e08d4736cfce198589b") so downstream consumers
won't misclassify the token as an Ethereum asset; locate the token's object in
src/peggedData/peggedData.ts (the entry with address field shown) and replace
the bare EVM address string with the "citrea:"-prefixed string.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 38fb0900-246e-4fdd-abd2-d9ea2cd8e4b3

📥 Commits

Reviewing files that changed from the base of the PR and between 38fee2e and a20e4d4.

📒 Files selected for processing (2)

• src/adapters/peggedAssets/generic-usd/index.ts
• src/peggedData/peggedData.ts

[realdealshaman]

@muhylmz what is backing GUSD? Also is it issued on Ethereum and then bridged to Citrea?