feat(statics): onboard eth:waethusdc stata token - #9736
Merged
sachinBitgo merged 1 commit intoSep 16, 2026
Merged
Conversation
Register the Aave V3 StataTokenV2 (ERC-4626) USDC wrapper for Ethereum mainnet in @bitgo/statics — the vault share token for the ETH_USDC_AAVE_V3 DeFi Earn vault (DEFI-794, TDD - Aave V3 §11.3; the defi-service vaultRegistry entry already exists and references this coin as its shareToken): - Add UnderlyingAsset enum entry in base.ts - Add erc20 entry in coins/erc20Coins.ts with 6 decimals, contract address 0xd4fa2d31b7968e448877f69a96de69f5de8cd23e (StataTokenV2, whose asset() is the USDC underlying 0xa0b86991c6218b36c1d19d4a2e9eb0ce 3606eb48), and CoinFeature.RECEIPT_TOKEN — placed in the general erc20Coins set (per the DEFI-802 main-coin-set decision for stata tokens), not botTokens.ts where the legacy aToken family lives (TDD §11.3 open question) On-chain verification via eth_call against ethereum mainnet: name() = 'Wrapped Aave Ethereum USDC', symbol() = 'waEthUSDC', asset() = 0xA0b86991c6218b36C1d19D4a2e9Eb0cE3606eB48 (USDC), decimals() = 6, convertToAssets(1000) = 1185 (rate 1.185 — consistent with the defillama price of ~$1.18). Address cross-checked against the TDD - Aave V3 §11.3 address table (aave-dao/aave-address-book AaveV3Ethereum ASSETS.USDC.STATA_TOKEN). Mirrors the tbaseeth:waBasSepLidUSDC precedent (DEFI-802). TICKET: DEFI-794
Contributor
sachinBitgo
marked this pull request as draft
September 15, 2026 09:53
Contributor
|
|
sachinBitgo
marked this pull request as ready for review
September 15, 2026 14:39
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Onboards the Ethereum mainnet Aave V3 StataTokenV2 (ERC-4626) USDC wrapper as the BitGo coin
eth:waethusdc— the vault share token for theETH_USDC_AAVE_V3DeFi Earn vault (DEFI-794, TDD - Aave V3 §11.3). The defi-servicevaultRegistryentry already exists and references this coin as itsshareToken.UnderlyingAssetenum entry inmodules/statics/src/base.tserc20entry inmodules/statics/src/coins/erc20Coins.ts— 6 decimals, contract0xd4fa2d31b7968e448877f69a96de69f5de8cd23e,CoinFeature.RECEIPT_TOKENerc20Coinsset (the DEFI-802 main-coin-set decision for stata tokens), notbotTokens.tswhere the legacy aToken family lives (resolves the TDD §11.3 open question for the mainnet stata path)On-chain verification
eth_callagainst Ethereum mainnet:name()Wrapped Aave Ethereum USDCsymbol()waEthUSDCasset()0xA0b86991c6218b36C1d19D4a2e9Eb0cE3606eB48(USDC underlying ✓)decimals()convertToAssets(1000)Address cross-checked against the TDD - Aave V3 §11.3 address table (aave-dao/aave-address-book
AaveV3Ethereum ASSETS.USDC.STATA_TOKEN).Sequencing
Step 1 of the per-token sequence (mirrors DEFI-802 / the PR Sequence doc): merge + trigger the
@bitgo-beta/staticspublish (publish.yml) and confirm the beta version before the downstream PRs consume it. The AMS registration (instrumentMetadata/marketCoinConfig keyed off UUID8c2a071a-f3cc-4024-9d66-99bed562e562) is already open in BitGo/asset-metadata-service.Tests
modules/staticstscbuild ✅coins.get('eth:waethusdc')with the expected features (account defaults + EIP1559 + receipt-token) ✅; name/address/UUID unique across the registry ✅yarn unit-testinmodules/staticsfails identically on master in this environment (ts-node/nyc"expand is not a function" transform error on every file, pre-existing) — relying on CI for the full suiteTICKET: DEFI-794