> ## 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.

# Settings & Notifications

> Configure notification channels, hardware wallet authentication, escrow auto top-up, and notification types on Offerbook

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.

<Note>
  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".
</Note>

***

## 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).

<Note>
  **Changing your notification settings also requires an explicit sign-in.** Each time you connect a new channel, change a setting, or toggle a notification type, the app asks for a wallet signature to protect your preferences from unauthorized changes.
</Note>

<AccordionGroup>
  <Accordion title="Connect Telegram">
    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.
  </Accordion>

  <Accordion title="Connect Email">
    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.
  </Accordion>

  <Accordion title="Why is the same channel usable on multiple wallets?">
    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.
  </Accordion>
</AccordionGroup>

***

## 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.

<AccordionGroup>
  <Accordion title="Enable hardware wallet mode">
    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.
  </Accordion>

  <Accordion title="When to use this option">
    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.
  </Accordion>
</AccordionGroup>

<Note>
  This setting applies to notification channel authentication. **Chat** has its own hardware-wallet sign-in flow using a memo transaction; see [Chat](/user-docs/earn/offerbook/chat#connecting-to-chat) for details.
</Note>

***

## Pro Mode

Pro Mode is a planned toggle in **Settings → General** to unlock advanced options and controls across the interface.

<Note>
  Pro Mode is **not currently available**. The toggle is visible but inactive. Future advanced controls will be opt-in through this setting.
</Note>

***

## Escrow Settings

Escrow Settings control how your escrow is funded when you create an offer. Both options are independent and disabled by default.

<AccordionGroup>
  <Accordion title="Top up on Create Borrow Offer">
    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.
  </Accordion>

  <Accordion title="Top up on Create Lend Offer">
    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.
  </Accordion>

  <Accordion title="What happens when filling an offer">
    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.
  </Accordion>
</AccordionGroup>

<Warning>
  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.
</Warning>

***

## 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**.

<Note>
  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.
</Note>

### Offers

<AccordionGroup>
  <Accordion title="Offer accepted">
    A counterparty has accepted one of your open offers. The loan starts immediately at the offer terms.
  </Accordion>

  <Accordion title="Counter offer received">
    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](/user-docs/earn/offerbook/using-offerbook#counter-offers).
  </Accordion>

  <Accordion title="Offer expired">
    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.
  </Accordion>

  <Accordion title="Offer cancelled">
    An offer you created — or an offer you had matched against — has been cancelled.
  </Accordion>
</AccordionGroup>

### Loans

<AccordionGroup>
  <Accordion title="Loan due soon">
    One of your active loans is approaching its due date. This notification fires **2 hours before maturity**, matching the in-app calendar reminder.
  </Accordion>

  <Accordion title="Loan repaid">
    A borrower has fully repaid one of your loans. The USDC (principal + interest, minus the 10% repayment fee) is now available in your escrow.
  </Accordion>

  <Accordion title="Loan expired">
    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.
  </Accordion>

  <Accordion title="Loan defaulted">
    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.
  </Accordion>
</AccordionGroup>

***

## Common Issues

<AccordionGroup>
  <Accordion title="Clicking the settings icon immediately asks me to sign a transaction">
    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.
  </Accordion>

  <Accordion title="The banner says 'Please connect socials' but I already added Email">
    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.
  </Accordion>

  <Accordion title="My hardware wallet rejects the signature">
    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.
  </Accordion>
</AccordionGroup>