How-to: Collect custom bridge fees

The App Kit SDK lets you collect a custom fee from your end users on each bridge transfer. For how custom fees fit into the overall fees breakdown, see How bridge fees work.

If you use this feature, Arc keeps 10% of the custom fee you collect from your end users.

Custom fees are not supported with feePayment: "source". Combining them (including a kit-level custom fee policy) throws a validation error.

Prerequisites

Before you begin, ensure that you’ve:

Installed the App Kit SDK
Configured an adapter

These are required so any example below runs with a valid kit and adapter.

Set a custom fee on a bridge

This example adds a 0.10 USDC fee to a single bridge transfer:

TypeScript

const result = await kit.bridge({
  from: { adapter, chain: "Ethereum_Sepolia" },
  to: { adapter, chain: "Arc_Testnet" },
  amount: "1.00",
  // Collect a fee of 0.10 USDC on this bridge transfer
  config: {
    customFee: {
      value: "0.10",
      recipientAddress: "0xYourFeeRecipientAddress",
    },
  },
});

Send

Bridge

Swap

Unified Balance

How-to: Collect custom bridge fees

Prerequisites

Set a custom fee on a bridge

​Prerequisites

​Set a custom fee on a bridge

Prerequisites

Set a custom fee on a bridge