onflow / onflow/docs

[FEATURE] Document core EVM contracts and Cadence equivalent wrt VM Bridge

Open
#1,088 0 comments 0 reactions 1 assignee View on GitHub

@sisyphusSmiling is already working on this.

Since Jan 9, 2025.

documentation
Dominant language
TypeScript
Stars
13
Forks
81
PR merge metrics
No merged PRs in 30d

Description

Issue to be solved

The docs are in need of documentation for commonly used EVM ecosystem contracts (WFLOW & USDC.e, Multicall, etc.), though additional contracts will likely be added over time. WFLOW & USDC.e (Celer's bridged USDC) are especially important as they require special handling by the VM bridge, the behavior for which should be documented as well.

Suggest A Solution
  • A callout about FlowToken (Cadence) <> WFLOW (EVM) association and behavior when bridging
  • An "Ecosystem Contracts" page under EVM with tables containing contract name & address for each contract
    • For USDC & WFLOW specifically, note the Cadence association with USDCFlow and WFLOW respectively. Caveat here is that Celer has not deploy to Testnet, so is not handled in the same manner as on Mainnet.
    • Add essential core EVM contracts such as Cadence Arch precompiles, USDC.e, WFLOW, Multicall (if needed), and any additional contracts that would be relevant.
What are you currently working on that this is blocking?

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.