Add PumpSpace adapter (Avalanche) with V2 + V3 TVL and token mapping support #16805

bluewhale-saito · 2025-10-23T10:10:58Z

NOTE

Please enable "Allow edits by maintainers" while putting up the PR.

If you would like to add a volume/fees/revenue adapter please submit the PR here.

If you would like to add a liquidations adapter, please refer to this readme document for details.

Once your adapter has been merged, it takes time to show on the UI. If more than 24 hours have passed, please let us know in Discord.
Sorry, We no longer accept fetch adapter for new projects, we prefer the tvl to computed from blockchain data, if you have trouble with creating a the adapter, please hop onto our discord, we are happy to assist you.
Please fill the form below only if the PR is for listing a new protocol else it can be ignored/replaced with reason/details about the PR
For updating listing info It is a different repo, you can find your listing in this file: https://github.com/DefiLlama/defillama-server/blob/master/defi/src/protocols/data2.ts, you can edit it there and put up a PR
Do not edit/push package-lock.json file as part of your changes, we use lockfileVersion 2, and most use v1 and using that messes up our CI
No need to go to our discord and announce that you've created a PR, we monitor all PRs and will review it asap

Name (to be shown on DefiLlama):

PumpSpace

Current TVL:

$ 2,048,553

Treasury Addresses (if the protocol has treasury)

N/A

Chain:

Avalanche (AVAX)

Coingecko ID (so your TVL can appear on Coingecko, leave empty if not listed): (https://api.coingecko.com/api/v3/coins/list)

None yet — awaiting listing approval.

Coinmarketcap ID (so your TVL can appear on Coinmarketcap, leave empty if not listed): (https://api.coinmarketcap.com/data-api/v3/map/all?listing_status=active,inactive,untracked&start=1&limit=10000)

None yet — awaiting listing approval.

Short Description (to be shown on DefiLlama):

PumpSpace is a decentralized liquidity platform on Avalanche supporting both V2 and V3 AMM models, offering multi-token farms and on-chain yield optimization for community-driven tokens.

Token address and ticker if any:

0x08c4b51e6Ca9Eb89C255F0a5ab8aFD721420e447 Pearl Token (Stargate) PEARL
0xaD4CB79293322c07973ee83Aed5DF66A53214dc6 Shell Token (Stargate) SHELL
0x6c960648d5F16f9e12895C28655cc6Dd73B660f7 BWPM Vault (Stargate) sBWPM
0x6214D13725d458890a8EF39ECB2578BdfCd82170 AquaDolpin Vault (Stargate) sADOL
0x1ea53822f9B2a860A7d20C6D2560Fd07db7CFF85 Clam Token (Stargate) CLAM
0x4ED0A710a825B9FcD59384335836b18C75A34270 Krill Token (Stargate) KRILL
0x3C594084dC7AB1864AC69DFd01AB77E8f65B83B7 bTether bUSDT
0xAB4fBa02a2905a03adA8BD3d493FB289Dcf84024 Wrapped AVAX v10 WAVAX

Category (full list at https://defillama.com/categories) *Please choose only one:

DEXes (Decentralized Exchanges)

Oracle Provider(s): Specify the oracle(s) used (e.g., Chainlink, Band, API3, TWAP, etc.):

Implementation Details: Briefly describe how the oracle is integrated into your project:

Documentation/Proof: Provide links to documentation or any other resources that verify the oracle's usage:

PumpSpace relies on its native pool price oracles and TWAP mechanisms embedded within the V3/Trident architecture for price feeds and fair on-chain asset valuation.

forkedFrom (Does your project originate from another project):

v2 : uniswap, v3:Sushi Trident

methodology (what is being counted as tvl, how is tvl being calculated):

TVL is calculated by summing up all token reserves from PumpSpace V2 and V3 (Trident) AMM factories on Avalanche.
To ensure accurate valuation, several address mappings are applied:

bUSDT → USDt (Tether) to aggregate stablecoin liquidity.

WAVAX proxy (0xAB4f...) → canonical WAVAX (0xB31f...).

These mappings prevent duplicate counting of wrapped assets.
Staking values represent single-asset staking of SHELL from the Shell MasterChef contract.

Github org/user (Optional, if your code is open source, we can track activity):

llamabutler · 2025-10-23T10:11:40Z

The adapter at projects/pumpspace exports TVL:

avax                      869.63 k
avax-staking              138.62 k
staking                   138.62 k

total                    869.63 k

waynebruce0x · 2025-10-23T14:16:24Z

Who mints bTETHER and what backs it?

bluewhale-saito · 2025-10-23T14:33:42Z

Who mints bTETHER and what backs it?

Thanks for the question!

bTETHER (bUSDT) is a fully backed wrapped version of USDt (Tether) on Avalanche.

Anyone can mint 1:1 by depositing native USDt.

The underlying USDt is deposited into Benqi and Euler to earn low-risk yield, and each vault issues receipt tokens representing the collateral.

Benqi vault: 0x7D336B49879a173626E51BFF780686D88b8081ec

Euler vault: 0x61E8f77eD693d3edeCBCc2dd9c55c1d987c47775

Users can redeem 1:1 for USDt anytime (with a 0.02% unmint fee).
Since bTETHER is fully collateralized and redeemable, our adapter maps bUSDT → USDt so its liquidity is accurately aggregated on DefiLlama.

llamabutler · 2025-10-24T06:02:49Z

The adapter at projects/pumpspace exports TVL:

avax                      922.71 k
avax-staking              139.47 k
staking                   139.47 k

total                    922.71 k

llamabutler · 2025-10-24T07:31:30Z

The adapter at projects/aquabank exports TVL:

avax                      938.61 k
avax-staking              639.05 k
staking                   639.05 k

total                    938.61 k

llamabutler · 2025-10-24T07:31:39Z

The adapter at projects/pumpspace exports TVL:

avax                      928.89 k
avax-staking              139.47 k
staking                   139.47 k

total                    928.89 k

waynebruce0x · 2025-10-24T10:21:36Z

projects/aquabank/index.js

+        ' TVL = USDt underlying represented by Benqi/Euler receipt tokens held in vaults (Benqi: shares*exchangeRate/1e18, Euler: convertToAssets). Staking = bUSDT deposited in BankStaking contracts, reported as USDt via 1:1 mapping.',
+    avax: { 
+        tvl,
+        staking,


please remove this as it is doublecounting the underlying in tvl

waynebruce0x · 2025-10-24T10:27:35Z

projects/pumpspace/index.js

+// Map wrapped/local tokens to canonical core assets for pricing/aggregation.
+// - bUSDT → USDt (Tether on Avalanche)
+// - WAVAX proxy (0xAB4f...) → canonical WAVAX (0xB31f...) 
+function transformAddress(addr) {


we will add support for these assets so this transform will no longer be required DefiLlama/defillama-server#10877

llamabutler · 2025-10-27T01:44:48Z

The adapter at projects/aquabank exports TVL:

avax                      932.92 k
avax-staking              643.66 k
staking                   643.66 k

total                    932.92 k

llamabutler · 2025-10-27T01:45:24Z

The adapter at projects/pumpspace exports TVL:

avax                      965.47 k
avax-staking              130.75 k
staking                   130.75 k

total                    965.47 k

llamabutler · 2025-10-27T01:49:18Z

The adapter at projects/aquabank exports TVL:

avax                      932.91 k

total                    932.91 k

llamabutler · 2025-10-27T01:49:30Z

The adapter at projects/pumpspace exports TVL:

avax                      965.49 k
avax-staking              130.75 k
staking                   130.75 k

total                    965.49 k

bluewhale-saito · 2025-10-27T01:52:12Z

Aquabank

I’ve removed staking and kept only tvl as requested to avoid double-counting the USDt underlying.

PumpSpace – transformAddress

I saw your note that support will be added in server (DefiLlama/defillama-server#10877), thanks!

One question: if I remove the bUSDT → USDt mapping right now, TVL undercounts because bUSDT isn’t priced as USDt yet. In local tests I see a drop (e.g. usdt 411.46k → 298.30k) when the mapping is removed.

The WAVAX proxy → WAVAX mapping can be safely removed (WAVAX gets picked up correctly), but bUSDT still needs the temporary transform until the server-side alias is live.

llamabutler · 2025-10-27T01:52:30Z

The adapter at projects/aquabank exports TVL:

avax                      932.91 k

total                    932.91 k

llamabutler · 2025-10-28T02:14:33Z

The adapter at projects/aquabank exports TVL:

avax                      915.60 k

total                    915.60 k

llamabutler · 2025-10-28T02:14:40Z

The adapter at projects/pumpspace exports TVL:

avax                      957.10 k
avax-staking              128.22 k
staking                   128.22 k

total                    957.10 k

llamabutler · 2025-10-28T02:16:56Z

The adapter at projects/aquabank exports TVL:

avax                      915.58 k

total                    915.58 k

llamabutler · 2025-10-28T02:17:31Z

The adapter at projects/pumpspace exports TVL:

avax                      956.96 k
avax-staking              128.22 k
staking                   128.22 k

total                    956.96 k

waynebruce0x · 2025-10-28T15:06:50Z

projects/aquabank/index.js

+
+// Protocol receipt tokens (convertible to USDt underlying)
+const BENQI_RECEIPT = '0xd8fcDa6ec4Bdc547C0827B8804e89aCd817d56EF'
+const EULER_RECEIPT = '0xa446938b0204Aa4055cdFEd68Ddf0E0d1BAB3E9E'


we price both of these too, you can just export a balance of the receipt tokens, no need for conversion

waynebruce0x · 2025-10-28T15:08:50Z

projects/pumpspace/index.js

+  })
+}
+
+async function v3FactoryTVL(ts, _block, { [CHAIN]: block }) {


please check projects/helper/sushi-trident.js helpers, I think there is some code duplication here

getTridentTVL() for the Trident/V3 factory

waynebruce0x · 2025-10-28T15:09:02Z

projects/pumpspace/index.js

+}
+
+
+async function v2FactoryTVL(api) {


please check const { getUniTVL } = require('./helper/unknownTokens') I think there is code duplication here

getUniTVL() for the PumpSpace V2 factory

llamabutler · 2025-10-29T02:23:01Z

The adapter at projects/aquabank exports TVL:

avax                      958.22 k

total                    958.22 k

llamabutler · 2025-10-29T02:23:42Z

The adapter at projects/pumpspace exports TVL:

avax                      932.30 k
avax-staking              117.88 k
staking                   117.88 k

total                    932.30 k

bluewhale-saito · 2025-10-29T02:24:31Z

Replaced custom V2/V3 TVL functions with built-in helpers:
- getUniTVL() for the PumpSpace V2 factory
- getTridentTVL() for the Trident/V3 factory
Simplified module to align with DefiLlama adapter conventions

bluewhale-saito · 2025-11-04T08:05:32Z

Thanks for the earlier review @waynebruce0x!
Just wanted to confirm that the PumpSpace and AQUABANK adapters are ready on our side —
the mappings for bUSDT → USDt and WAVAX proxy → WAVAX were implemented as discussed.

Could you please let me know if any further action is needed from my side before merging?
I understand that bUSDT pricing support is being handled server-side (DefiLlama/defillama-server#10877),
so I just want to confirm that this PR can be merged once that alias is live.

Appreciate your time and support as always 🙏

waynebruce0x · 2025-11-04T13:20:59Z

projects/aquabank/index.js

+    }
+
+    // 4) Add both underlyings as USDt
+    if (benqiUnderlying > 0n) api.add(USDt, benqiUnderlying)


we price these vault receipt tokens, you can just export a balance of the receipt tokens, no need for conversion

Got it, thanks! 👍
I’ve updated the adapter to export the raw balances of the Benqi and Euler receipt tokens directly,
removing the manual USDt conversion since they’re already priced server-side.

llamabutler · 2025-11-05T06:43:10Z

The adapter at projects/aquabank exports TVL:

avax                      843.95 k

total                    843.94 k

llamabutler · 2025-11-05T06:43:25Z

The adapter at projects/pumpspace exports TVL:

avax                      806.23 k
avax-staking              102.19 k
staking                   102.19 k

total                    806.23 k

llamabutler · 2025-11-05T06:43:55Z

The adapter at projects/aquabank exports TVL:

avax                      843.95 k

total                    843.94 k

llamabutler · 2025-11-05T06:44:02Z

The adapter at projects/pumpspace exports TVL:

avax                      806.23 k
avax-staking              102.19 k
staking                   102.19 k

total                    806.23 k

waynebruce0x · 2025-11-05T14:54:37Z

On the Aquabank UI it looks like theres more like 600k$ in TVL - what causes the discrepancy? Is it possible for us to count the underlying deposits to Euler and Benqi instead?

llamabutler · 2025-11-06T02:18:43Z

The adapter at projects/aquabank exports TVL:

avax                      833.49 k

total                    833.49 k

llamabutler · 2025-11-06T02:18:56Z

The adapter at projects/pumpspace exports TVL:

avax                      813.10 k
avax-staking              99.41 k
staking                   99.41 k

total                    813.10 k

llamabutler · 2025-11-06T02:22:48Z

The adapter at projects/aquabank exports TVL:

avax                      833.41 k

total                    833.41 k

llamabutler · 2025-11-06T02:23:02Z

The adapter at projects/pumpspace exports TVL:

avax                      822.72 k
avax-staking              99.41 k
staking                   99.41 k

total                    822.72 k

bluewhale-saito · 2025-11-06T02:24:47Z

On the Aquabank UI it looks like theres more like 600k$ in TVL - what causes the discrepancy? Is it possible for us to count the underlying deposits to Euler and Benqi instead?

Thanks for flagging the discrepancy!

Our UI aggregates the USDt collateral that backs bUSDT across our Benqi/Euler vaults.
Counting totalSupply(bUSDT) can diverge from the UI whenever a portion of bUSDT is off-protocol (LPs, user wallets, staking flows) or while mint/redeem/fees are settling, so it’s safer to measure Aquabank TVL by the underlying vault deposits.

Per your suggestion, I’ll export the raw balances of the vault receipt tokens held by our vault contracts (no manual conversion), so the server can price them directly:

Receipt tokens (priced server-side):
- BENQI_RECEIPT = 0xd8fcDa6ec4Bdc547C0827B8804e89aCd817d56EF
- EULER_RECEIPT = 0xa446938b0204Aa4055cdFEd68Ddf0E0d1BAB3E9E
Vaults that hold the collateral:
- Benqi vault: 0x7D336B49879a173626E51BFF780686D88b8081ec
- Euler vault: 0x61E8f77eD693d3edeCBCc2dd9c55c1d987c47775

The adapter will sum balanceOf(vault) for each receipt token and export those balances.

bluewhale-saito and others added 9 commits February 5, 2024 17:21

init Klaytn Bluewhale

94a262d

Refactor Bluewhale contract and update token addresses

9985e74

Merge branch 'DefiLlama:main' into main

c712bb7

Add bluewhale v3 tvl

bb8370c

Merge branch 'DefiLlama:main' into main

bdfd36d

add PumpSpace.

0a77c11

add PumpSpace Token WAVAX

0f6144d

feat(pumpspace): token mappings for bUSDT & WAVAX

49a49bb

Merge branch 'DefiLlama:main' into main

4f6353b

waynebruce0x self-assigned this Oct 23, 2025

Merge branch 'DefiLlama:main' into main

f8ad4d7

Add AquaBank TVL and Staking adapter (Avalanche)

c9bed2d

waynebruce0x reviewed Oct 24, 2025

View reviewed changes

Merge branch 'DefiLlama:main' into main

7e6ce16

bluewhale-saito added 2 commits October 27, 2025 10:46

I’ve removed staking and kept only tvl

261fcd3

Merge commit '7e6ce160982b0b274ba89e7aee4b8e76f8c63828'

9ec2c94

WAVAX mapping can be safely removed

f7cb315

Merge branch 'DefiLlama:main' into main

2e9629b

removed staking, transformAddress mappings

cbc3dac

waynebruce0x reviewed Oct 28, 2025

View reviewed changes

use DefiLlama helpers

cbabb11

waynebruce0x reviewed Nov 4, 2025

View reviewed changes

TVL adapter using bUSDT supply backed

7854cdc

Merge branch 'DefiLlama:main' into main

8e1e265

bluewhale-saito and others added 2 commits November 6, 2025 11:17

adapter will sum balanceOffor each receipt token

4486442

Merge branch 'DefiLlama:main' into main

6e55f10

Merge commit '6e55f107f6df43e838960552b4a67811635a67ae'

5d2e175

Add PumpSpace adapter (Avalanche) with V2 + V3 TVL and token mapping support #16805

Are you sure you want to change the base?

Add PumpSpace adapter (Avalanche) with V2 + V3 TVL and token mapping support #16805

Conversation

bluewhale-saito commented Oct 23, 2025

Please enable "Allow edits by maintainers" while putting up the PR.

Name (to be shown on DefiLlama):

Twitter Link:

List of audit links if any:

Website Link:

Logo (High resolution, will be shown with rounded borders):

Current TVL:

Treasury Addresses (if the protocol has treasury)

Chain:

Coingecko ID (so your TVL can appear on Coingecko, leave empty if not listed): (https://api.coingecko.com/api/v3/coins/list)

Coinmarketcap ID (so your TVL can appear on Coinmarketcap, leave empty if not listed): (https://api.coinmarketcap.com/data-api/v3/map/all?listing_status=active,inactive,untracked&start=1&limit=10000)

Short Description (to be shown on DefiLlama):

Token address and ticker if any:

Category (full list at https://defillama.com/categories) *Please choose only one:

Oracle Provider(s): Specify the oracle(s) used (e.g., Chainlink, Band, API3, TWAP, etc.):

Implementation Details: Briefly describe how the oracle is integrated into your project:

Documentation/Proof: Provide links to documentation or any other resources that verify the oracle's usage:

forkedFrom (Does your project originate from another project):

methodology (what is being counted as tvl, how is tvl being calculated):

Github org/user (Optional, if your code is open source, we can track activity):

Uh oh!

llamabutler commented Oct 23, 2025

Uh oh!

waynebruce0x commented Oct 23, 2025

Uh oh!

bluewhale-saito commented Oct 23, 2025

Uh oh!

llamabutler commented Oct 24, 2025

Uh oh!

llamabutler commented Oct 24, 2025

Uh oh!

llamabutler commented Oct 24, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

llamabutler commented Oct 27, 2025

Uh oh!

llamabutler commented Oct 27, 2025

Uh oh!

llamabutler commented Oct 27, 2025

Uh oh!

llamabutler commented Oct 27, 2025

Uh oh!

bluewhale-saito commented Oct 27, 2025

Uh oh!

llamabutler commented Oct 27, 2025

Uh oh!

llamabutler commented Oct 28, 2025

Uh oh!

llamabutler commented Oct 28, 2025

Uh oh!

llamabutler commented Oct 28, 2025

Uh oh!

llamabutler commented Oct 28, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

llamabutler commented Oct 29, 2025

Uh oh!

llamabutler commented Oct 29, 2025

Uh oh!

bluewhale-saito commented Oct 29, 2025

Uh oh!

bluewhale-saito commented Nov 4, 2025

Uh oh!