Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jup.ag/llms.txt

Use this file to discover all available pages before exploring further.

The Settings page (gear icon in the navigation header) is where you configure how Offerbook talks back to you and how your escrow behaves when you create offers. It has two tabs: General and Notifications. The General tab manages notification channels, hardware wallet authentication, Pro Mode, and Escrow Settings. The Notifications tab lists all available notification types and lets you enable or disable them individually.
The Notifications tab is gated behind a connected channel. Before you connect at least one channel (Telegram or Email), notification types are visible but disabled, and a banner reads “Please connect socials to receive notifications”.

Notification Channels

Offerbook supports two notification channels: Telegram and Email. They are independent and can both be connected at the same time. A channel can be connected to multiple wallets. Connecting a channel requires proving you own the wallet by signing a message (or a transaction, for hardware wallets — see below).
  1. In Settings → General, click Connect next to Telegram.
  2. The app opens a signature request to authenticate you with Jupiter Notifications.
  3. After signing, you are redirected to the Telegram bot to link your account.
Once linked, Telegram is shown as Connected. You can disconnect at any time.
  1. In Settings → General, click Connect next to Email.
  2. Enter your email address and confirm.
  3. The app opens a signature request to authenticate the wallet.
  4. A verification email is sent to the address you provided.
Once verified, Email is shown as Connected, and the address is displayed next to the channel with Edit and Disconnect controls.
A notification channel (Telegram or Email) is tied to a notification service account, not to a single wallet. Once authenticated, the same channel can be linked to additional wallets, allowing you to receive alerts for activity across all of them in one place.

Hardware Wallet Authentication

Hardware wallets such as Ledger cannot sign arbitrary messages. To connect a notification channel from a hardware wallet, you need to enable an alternative authentication flow.
In Settings → General, toggle I’m using a hardware wallet on.With this toggle on, authentication uses a signed transaction instead of a signed message. The transaction is empty (no funds move and no state changes), but it still requires a small SOL balance to pay the network fee.
Enable it only if your wallet rejects message-signing requests. Software wallets such as Phantom or Solflare sign messages natively and do not need this toggle.Once enabled, the toggle persists across sessions. You can switch it off later if you change to a software wallet.

Pro Mode

Pro Mode is a planned toggle in Settings → General to unlock advanced options and controls across the interface.
Pro Mode is not currently available. The toggle is visible but inactive. Future advanced controls will be opt-in through this setting.

Escrow Settings

Escrow Settings control how your escrow is funded when you create an offer. Both options are independent and disabled by default.
When enabled, the app automatically deposits the required collateral from your main wallet into your escrow when you create a borrow offer.When disabled, you must deposit the collateral into your escrow manually before publishing the offer. If the escrow does not hold sufficient collateral, the offer is hidden from other users.
When enabled, the app automatically deposits the required USDC from your main wallet into your escrow when you create a lend offer.When disabled, you must deposit USDC into your escrow manually before publishing the offer. Lend offers without sufficient escrow balance are not visible to other users.
Independently of these settings, filling an offer (i.e., accepting an existing offer rather than creating one) automatically pulls any missing funds from your wallet — only the minimum top-up needed is taken, so your wallet balance is not over-drained.
Auto top-up only moves funds from your main wallet to your escrow. You always need sufficient SOL in your main wallet to cover transaction fees, regardless of these settings.

Notification Types

Notification types are listed in the Notifications tab. Each can be toggled on or off independently. Notifications are grouped into two categories: Offers and Loans.
All notification types are enabled by default once at least one channel is connected. You can disable any of them individually, or use Disable all at the top of each group to turn the whole group off.

Offers

A counterparty has accepted one of your open offers. The loan starts immediately at the offer terms.
A counterparty has proposed a counter offer on one of your open offers. You can review it under the original offer and either accept the counter-offer terms (starting the loan) or ignore it. See Counter Offers.
One of your open offers reached its expiration window without being filled. Lend offers expire after 24 hours, borrow offers after 1, 3, or 7 days depending on the duration you set at creation.
An offer you created — or an offer you had matched against — has been cancelled.

Loans

One of your active loans is approaching its due date. This notification fires 2 hours before maturity, matching the in-app calendar reminder.
A borrower has fully repaid one of your loans. The USDC (principal + interest, minus the 10% repayment fee) is now available in your escrow.
A loan has passed its due date without repayment. The lender can now claim the collateral. As a borrower, you can still repay until the lender claims, but you should not rely on this window.
The collateral has been claimed on a defaulted loan. As a lender, the collateral has been transferred to your wallet (minus the 0.1% fee, where applicable). As a borrower, the loan is now closed and you have lost the collateral.

Common Issues

The signature request authenticates your wallet with Jupiter Notifications so that channels and notification preferences can be securely tied to your account. Once signed, the Settings page opens normally on subsequent visits.If you cancel the signature, the Settings page is accessible but most controls (channels, notification toggles) remain disabled until you sign.
Make sure the Email channel shows as Connected in the General tab (with your address displayed and Edit/Disconnect controls visible). If it still appears as Not connected, complete the verification step from the email you received.If the banner persists after a confirmed connection, this may be a transient UI issue. Refreshing the page usually resolves it.
Make sure I’m using a hardware wallet is toggled on in Settings → General. With this enabled, authentication uses a signed transaction instead of a signed message, which is supported by all hardware wallets.