> ## 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 [Hardware Wallet Authentication](#hardware-wallet-authentication)).

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

***

## Profile

You can set a public profile from the **Your Profile** dialog. It is optional and applies across Offerbook (Chat, Statistics, your Affiliate page).

* **Username** — 3 to 20 characters, letters, digits, `-` and `_`. Lets others reach you in [Chat](/user-docs/earn/offerbook/chat) by name instead of wallet address
* **Profile image** — pick one of the NFTs in your wallet
* **Social medias** — optional X and Telegram handles

Click **Save Profile** to apply.

***

## Escrow Settings

Escrow Settings control how your escrow is funded when you create an offer.

<Note>
  These two toggles are visible in Settings but not yet active (greyed out). For now, the app always deposits the required assets from your wallet into the escrow as part of offer creation, as described below.
</Note>

<AccordionGroup>
  <Accordion title="Top up on Create Borrow Offer">
    The app automatically deposits the required collateral from your main wallet into your escrow when you create a borrow offer. Once this toggle becomes active, disabling it will let you fund the escrow manually instead.
  </Accordion>

  <Accordion title="Top up on Create Lend Offer">
    The app automatically deposits the required USDC from your main wallet into your escrow when you create a lend offer. Once this toggle becomes active, disabling it will let you fund the escrow manually instead.
  </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/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 to 7 days depending on the expiration 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>