Add USDV supply adapters for Tron, Base, Polygon and BNB Chain

[valtorum]

Updates the existing Valtorum USD (USDV) listing.

Changes included:

• Adds USDV supply tracking for TRON
• Adds USDV supply tracking for Base
• Adds USDV supply tracking for Polygon
• Adds USDV supply tracking for BNB Chain
• Keeps existing XRP Ledger and Stellar supply tracking
• Updates USDV metadata to reflect the supported networks

The adapter uses DefiLlama's existing addChainExports helper for EVM/TRON supply reads and keeps the custom XRP Ledger/Stellar logic already used for those networks.

Summary by CodeRabbit

• New Features

  • Expanded USDV tracking to support additional networks (beyond XRP Ledger and Stellar), improving cross-chain peg issuance coverage.
  • Improved consistency of USDV minted and supply/balance reporting across the supported issuance sources.

• Documentation

  • Updated USDV descriptions to clearly explain multi-network issuance and redemption, including the role of supported issuer/contract accounts and related compliance terms.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cea3444a-2edb-43e7-8763-68e2142c8611

📥 Commits

Reviewing files that changed from the base of the PR and between 0a3a7bf and bded5cc.

📒 Files selected for processing (1)

• src/adapters/peggedAssets/valtorum-usdv/index.ts

🚧 Files skipped from review as they are similar to previous changes (1)

• src/adapters/peggedAssets/valtorum-usdv/index.ts

---

📝 Walkthrough

Walkthrough

USDV support now includes additional network contract mappings, shared peg typing for minted balance aggregation, revised Stellar supply calculation, simplified chain handlers, and metadata describing issuance and redemption across supported networks.

Changes

USDV multi-network support

Layer / File(s)	Summary
Adapter network mappings and minted handlers src/adapters/peggedAssets/valtorum-usdv/index.ts	Adds network contract mappings and shared pegType usage, updates Stellar supply summation, and exposes additional chain exports while retaining XRPL and Stellar minted handlers.
Multi-network USDV metadata src/peggedData/peggedData.ts	Updates USDV issuance and redemption descriptions to cover supported networks, issuer or contract accounts, compliance requirements, and applicable terms.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Adapter
  participant XRPLGatewayBalances
  participant StellarAPI
  participant BalanceAggregator
  Adapter->>XRPLGatewayBalances: Request gateway_balances
  XRPLGatewayBalances-->>Adapter: Return obligation balances
  Adapter->>StellarAPI: Read balance record
  StellarAPI-->>Adapter: Return balance fields
  Adapter->>BalanceAggregator: Sum supply with pegType

Loading

Possibly related PRs

• DefiLlama/peggedassets-server#851: Adds related Stellar USDV supply tracking that this adapter update builds on.
• DefiLlama/peggedassets-server#867: Makes related pegType and addChainExports adapter wiring changes alongside pegged-asset metadata updates.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Description check	❓ Inconclusive	The description summarizes the update well, but it does not follow the repository's listing template or include its standard metadata fields.	Add the template sections or explicitly note that this is an update and list any required metadata changes that apply.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly matches the main change: adding USDV supply adapters for the listed chains.
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.

✨ 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.}

[realdealshaman]

hey @valtorum are all of these tokens circulating? for example on base 89% of the supply is in this wallet:
https://basescan.org/address/0x3c8d9271cc15a225bd3a1345c1412b76f12a3a4d

[valtorum]

hey @valtorum are all of these tokens circulating? for example on base 89% of the supply is in this wallet: https://basescan.org/address/0x3c8d9271cc15a225bd3a1345c1412b76f12a3a4d

Thanks for flagging this.

The Base address you linked is an issuer-controlled/non-circulating balance and should be excluded from the reported USDV supply.

I will update the adapter accordingly and review the other supported networks so the same treatment is applied consistently where issuer-controlled balances exist.

[valtorum]

Updated the adapter to exclude confirmed issuer-controlled balances from reported circulating USDV supply.

The Base balance flagged above is now marked as unreleased, and I also added confirmed controlled balances for Polygon, BNB Chain, and TRON where applicable.