Apply

All apps on Sonic are eligible to participate in Fee Monetization. To apply, follow the steps below.

The application process consists of registering your app to participate in FeeM, followed by registering your contracts to verify ownership.

Step 1 — App Registration

Visit the Fee Monetization dashboard, connect your admin wallet, and click Apply for FeeM. The registration form will request several details from you.

• Owner address Wallet that will manage your FeeM registration.

• Rewards recipient address Address that will receive FeeM revenue when claimed.

• Dispute contact Email to be used for communication if you dispute a contract.

• Metadata Information about your app, such as logo, name, etc. Click Fill metadata to reveal these fields.

• Project contracts Contracts that belong to your app.

After registering your app through the interface, you'll need to register your contracts using the steps below to verify ownership.

The 50 S registration fee will be refunded once your app has been added to FeeM.

Step 2 — Contract Registration

To verify ownership of the contracts you want to include in your FeeM application, you’ll need to register them using the steps below.

If you can interact with your contracts from an externally owned account (EOA), or if the contract can call itself, use the ContractRegistrar contract to call selfRegister(projectID) from the contract address you wish to register. This will automatically associate the contract with your app, identified by the unique Project ID.

Alternatively, you can include the following code snippet directly in your contract to trigger self-registration. Replace the <Your FeeM Project ID> placeholder with your actual FeeM Project ID.

/// @dev Register my contract on Sonic FeeM
function registerMe() external {
        (bool _success,) = address(0xDC2B0D2Dd2b7759D97D50db4eabDC36973110830).call(
            abi.encodeWithSignature("selfRegister(uint256)", <Your FeeM Project ID>)
        );
        require(_success, "FeeM registration failed");
}

If you're unable to interact with your contracts from an EOA or through other means, please contact Sam Harcourt on Telegram for manual contract verification. To help expedite the manual verification process, try self-registering the deployer address of your contracts using the steps above.

An interface for manual verification is coming soon.

Step 3 — Claim Revenue

Once your app is approved to FeeM, you will start earning 90% of the network fees it generates.

To claim, visit the Fee Monetization dashboard, connect with your admin wallet, and claim your rewards. These will be sent to the recipient address you provided during the initial application step.

For assistance, join Sonic Builders on Telegram.

---

Manual App Registration

If you prefer to register your app manually instead of using the UI described in the first step, follow the instructions below. However, we recommend using the Fee Monetization dashboard to register.

1. Create a metadata config file in JSON format with the following parameters:

{
  "name": "MySuperCoolProject",
  "image_url": "https://mysupercoolproject.com/icons/icon.png",
  "website": "https://mysupercoolproject.com/"
}

1. Host the file in a publicly accessible location. Ensure that anyone can download the JSON file via a browser and that the hosting site supports HTTPS. A 200×200px PNG logo, no larger than 32 KiB, is sufficient.

2. Go to the FeeM ProjectsRegistrar smart contract and execute the register function providing all the required information. A unique Project ID will be assigned to your registration in response. Use this ID to identify your project in subsequent calls.

Once complete, your app will be registered and you can proceed to Step 2 above.

---

Contracts to Interact With

• The FeeM Core: 0x0b5f073135df3f5671710f08b08c0c9258aecc35

• Projects Registrar: 0x897d37f040Ec8DEFFD0ae1De743e1b1a14cf221f

• Projects' Contracts Registrar: 0xDC2B0D2Dd2b7759D97D50db4eabDC36973110830

• Dispute Resolver: 0xF2169D8A17aA40cc31e1b43E4FbB2d19CA099310

---

Frequently Asked Questions

My app uses an upgradeable (proxy) contract. Should I register the implementation too?

Typically, you only need to register the proxy. Gas consumed by the implementation via delegate-call will be attributed to the proxy address.

What if my app deploys many user-specific contracts?

If those user contracts act as proxies calling a small set of implementations, you only need to register the main implementation proxies. You’ll receive rewards for all the gas consumed within them.

How do I claim my rewards?

You initiate a claim transaction on the FeeM contract. The oracles confirm your gas usage, and after enough confirmations, your share is transferred to your rewards recipient. You may want to check the Fee Monetization dashboard for a user-friendly claim UX.

What if I don’t claim my rewards immediately?

There is no deadline. Unclaimed rewards stay in the FeeM contract until the rightful project claims them.

Why do my rewards stay the same over a longer time period?

FeeM processes rewards similarly to the staking rewards via the SFC contract. The accumulated rewards are updated after the active epoch is sealed and confirmed.