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.
Ad statuses
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.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.
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.