Skip to content

Update EVM bridge FLIP to clarify storage-based fee model#362

Merged
joshuahannan merged 3 commits intomainfrom
update-evm-bridge-fee-model
Mar 24, 2026
Merged

Update EVM bridge FLIP to clarify storage-based fee model#362
joshuahannan merged 3 commits intomainfrom
update-evm-bridge-fee-model

Conversation

@joshuahannan
Copy link
Member

@joshuahannan joshuahannan commented Mar 13, 2026

Summary

  • Adds a fee model callout at the top of the Case Studies section making the principle explicit: bridge fees are only charged when an operation causes the bridge account to store an asset long-term
  • Cadence-Native Cadence → EVM: replaces "flat fee + storage usage" with "storage consumed by escrowing the NFT in the bridge account"
  • Cadence-Native EVM → Cadence: adds a note explaining no fee is charged (releasing from escrow doesn't add storage), removes the fee withdrawal step
  • EVM-Native EVM → Cadence: clarifies fee is based on storage consumed by holding the ERC721 in the bridge's COA

Reflects the clarifications from onflow/flow-evm-bridge#202.

Test plan

  • Review that the fee model callout accurately describes the implemented behavior in FlowEVMBridge.cdc
  • Verify the per-path fee descriptions match the handler logic in the bridge contract

🤖 Generated with Claude Code

Bridge fees are only charged when an operation causes the bridge account
to store an asset long-term. Operations that release assets from existing
escrow or burn assets do not incur a bridge fee.

Reflects changes from onflow/flow-evm-bridge#202

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
j1010001 and others added 2 commits March 20, 2026 11:15
- Add ADR-0001 reference to the fee model callout for full rationale
- EVM-Native EVM→Cadence: note that cross-VM registered NFTs use a
  fee-free handler (handleEVMNativeCrossVMNFTFromEVM); the existing
  steps describe the default path only
- EVM-Native Flow→EVM: note that no fee is charged (NFT is burned,
  no new bridge storage)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@joshuahannan joshuahannan merged commit 8408e0b into main Mar 24, 2026
@joshuahannan joshuahannan deleted the update-evm-bridge-fee-model branch March 24, 2026 21:13
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.

2 participants