Skip to main content
The Ads Management page gives you full control over the liquidity ads you have created as a Maker. You can add funds to an existing ad, withdraw unused liquidity, adjust parameters, or close an ad permanently. This guide covers each operation and explains what the different ad statuses mean.

​
View your ads

Open ProofBridge, connect your wallet, and navigate to Ads Management. The page lists all ads associated with your wallet address, sorted by creation date. Each row shows:
  • Ad ID: The unique identifier for the ad.
  • Route: Source chain, destination chain, and token pair.
  • Available balance: Tokens available for new orders.
  • Locked balance: Tokens currently reserved for an in-progress order.
  • Status: The current lifecycle state of the ad.
  • Created: When the ad was created.
Click an ad row to open its detail view, which shows the full history of orders matched against it.

​
Ad statuses

StatusMeaning
ActiveThe ad is funded and visible in the marketplace. Bridgers can select it.
MatchedA Bridger has selected the ad and created an order. Settlement is in progress.
LockedA portion of the ad’s balance is locked against an active order.
SettledAn order against this ad has completed successfully.
ClosedThe ad has been permanently closed. No new orders can be matched.
An ad can hold multiple concurrent orders in the Locked state if it has sufficient available balance.

​
Update an ad

You can adjust certain ad parameters (such as the ad recipient address) without closing and recreating the ad.
1

Open the ad detail page

On the Ads Management page, click the ad you want to update.
2

Click Edit

Click Edit ad to open the update form. Fields that can be changed appear as editable inputs.
3

Make your changes and save

Adjust the parameters you want to update, then click Save. The frontend sends PATCH /v1/ads/:id/update to the relayer.
Some parameters — such as the source chain, destination chain, and token pair — are set at creation and cannot be changed. Create a new ad if you need a different route.

​
Fund an existing ad

Add more tokens to an active ad to increase the liquidity available to Bridgers.
1

Open the ad detail page

Navigate to Ads Management and click the ad you want to fund.
2

Click Fund

Click Fund ad to open the funding dialog.
3

Enter the amount

Enter the number of destination-chain tokens you want to add. Click Fund.
4

Confirm the transaction

Your wallet prompts you to confirm a transaction to the AdManager contract. Review the amount and click Confirm. The frontend calls POST /v1/ads/:id/fund.Once the transaction confirms, the ad’s available balance increases immediately.

​
Withdraw unused funds

Withdraw tokens from your ad that are not currently locked in an active order.
1

Open the ad detail page

Navigate to Ads Management and click the ad from which you want to withdraw.
2

Click Withdraw

Click Withdraw. The withdrawal form shows your current available balance (unlocked tokens only).
3

Enter the withdrawal amount

Enter the amount to withdraw. You can only withdraw up to the available (unlocked) balance. Locked tokens cannot be withdrawn while an order is in progress.
4

Confirm the transaction

Click Withdraw, then confirm the transaction in your wallet. The frontend calls POST /v1/ads/:id/withdraw. Once the transaction is confirmed on-chain, the tokens are returned to your wallet.
You cannot withdraw tokens that are currently locked for an active order. Wait for the order to settle before withdrawing those funds.
5

Confirm the chain action

After the on-chain transaction confirms, the app notifies the relayer via the chain action confirmation step (POST /v1/ads/:id/confirm) to update the ad’s recorded balance.

​
Close an ad

Closing an ad permanently removes it from the marketplace and withdraws all remaining unlocked funds to your wallet. This action cannot be undone.
1

Open the ad detail page

Navigate to Ads Management and click the ad you want to close.
2

Click Close ad

Click Close ad. A confirmation dialog appears, warning that the action is permanent.
Closing an ad is irreversible. Any tokens locked in active orders at the time of closing are released once those orders settle, but no new orders will be matched to the ad.
3

Confirm the close action

Click Confirm close. Your wallet prompts you to approve a transaction to the AdManager contract. Confirm the transaction.The frontend calls POST /v1/ads/:id/close. The AdManager marks the ad as closed and initiates withdrawal of the full available balance to your wallet.
4

Verify the withdrawal

After the transaction confirms, the ad status changes to Closed and your available balance returns to zero. Check your destination-chain wallet to confirm the tokens arrived.
If you want to pause an ad temporarily without closing it, withdraw all available funds instead. The ad remains open but will not be matched to new orders while its balance is zero.