Skip to content

feat: Add Fiamma Adapter. #15805

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 21, 2025
Merged

feat: Add Fiamma Adapter. #15805

merged 3 commits into from
Aug 21, 2025

Conversation

TristanRen
Copy link
Contributor

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.
  1. 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.
  2. 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.
  3. 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
  4. 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
  5. 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
  6. 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):

Fiamma

Twitter Link:

https://x.com/Fiamma_labs

List of audit links if any:

https://github.com/fiamma-chain/fiamma-audit/blob/main/BitLabs-Bridge-script.pdf
https://github.com/fiamma-chain/fiamma-audit/blob/main/MoveBits-Bridge-Aptos-Contract.pdf
https://github.com/fiamma-chain/fiamma-audit/blob/main/Zenith-Bridge-Cairo-Contract.pdf

Website Link:

https://www.fiammalabs.io/

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

https://s3.fiammalabs.io/FiaBtc512X512.png

Current TVL:

0

Treasury Addresses (if the protocol has treasury)
Chain:

Ethereum, Aptos, Sei, Core, Arbitrum, Base, ZKSyncEra, Polygon, BSC, Unichain, Plume

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):

Fiamma BTC is a 1:1 pegged wrapped BTC, which is minted by a trust-minimized BTC bridge Powered by BitVM2 protocol. It enables universal cross‑chain interoperability, allowing native Bitcoin liquidity to be safely unlocked and utilized across multiple blockchain ecosystems. By verifying zero‑knowledge proofs on Bitcoin via the BitVM2 protocol to minimize trust assumptions, Fiamma BTC provides a secure and scalable pathway for integrating Bitcoin into DeFi applications.

Token address and ticker if any:

Ethereum: 0x22F0E0a4c97ff43546dad16d43Ef854C773F0e08
Aptos: 0x75de592a7e62e6224d13763c392190fda8635ebb79c798a5e9dd0840102f3f93
Sei: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
Core: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
Arbitrum: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
Base: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
ZKSyncEra: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
Polygon: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
BSC: 0xafB253A80CEb3d1a5eeF3994C0d1C92c2f027524
Unichain: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F
Plume: 0x60C230c38aF6d86b0277a98a1CAeAA345a7B061F

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

Bridge

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):

Fiamma BTC TVL represents the total amount of Bitcoin bridged across all chains through the Fiamma Bridge, a trust‑minimized bridge built on the BitVM2 protocol.

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

https://github.com/fiamma-chain

@llamabutler
Copy link

The adapter at projects/fiamma exports TVL:

aptos                     0
base                      0
arbitrum                  0
core                      0
ethereum                  0
era                       0
sei                       0
unichain                  0
bsc                       0
polygon                   0
plume                     0

total                    0 

@waynebruce0x
Copy link
Collaborator

Please count the collateral held on the source chain rather than the minted tokens on the destination chain

@waynebruce0x waynebruce0x self-assigned this Aug 6, 2025
@TristanRen
Copy link
Contributor Author

Fiamma Bridge locks users' Bitcoin in a Taproot script using the BitVM2 protocol, without relying on centralized custody. The unlock condition is a burn event on the sidechain, proven by a zero-knowledge proof verified within the script.

Currently, there is no way to query all locked UTXOs on-chain via filtering.

Users can track their own locked UTXOs through their individual transactions. In addition, Fiamma maintains a centralized record and provides a block explorer to view the locked UTXOs: https://scan.fiammalabs.io/

To make this data accessible, we can provide a centralized API endpoint that aggregates and exposes the statistics. Shall we implement such an interface?

@llamabutler
Copy link

The adapter at projects/fiamma exports TVL:

plume                     0
aptos                     0
base                      0
era                       0
sei                       0
unichain                  0
bsc                       0
ethereum                  0
core                      0
polygon                   0
arbitrum                  0

total                    0 

@waynebruce0x
Copy link
Collaborator

Yeah please could we use the API instead and count the TVL on the source chain (bitcoin)

@llamabutler
Copy link

The adapter at projects/fiamma exports TVL:

bitcoin                   1.26 M
sei                       1.02 M
aptos                     244.97 k
ethereum                  5.21 k
base                      1.24 k
plume                     0
unichain                  0
arbitrum                  0
bsc                       0
era                       0
polygon                   0

total                    2.53 M 

@TristanRen
Copy link
Contributor Author

We add an api for BTC amount locked on Bitcoin. Please check again, thanks.

@waynebruce0x
Copy link
Collaborator

So I guess all of the destination chain TVLs here are now double count of the bitcoin TVL? Can we remove them please?

@TristanRen
Copy link
Contributor Author

I think it's better remove bitcoin and leave others?

@waynebruce0x
Copy link
Collaborator

No we track value locked not value issued, to be consistent with our methodology and other protocols, only bitcoin should be shown here

@llamabutler
Copy link

The adapter at projects/fiamma exports TVL:

bitcoin                   1.36 M

total                    1.36 M 

@TristanRen
Copy link
Contributor Author

Modified. Please check again :)

@waynebruce0x waynebruce0x merged commit 70c5b0e into DefiLlama:main Aug 21, 2025
1 check passed
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.

3 participants