@pollar/react 0.10.1-rc.9 → 0.10.1

package/README.md

@@ -8,15 +8,8 @@ Stellar-based applications.
 > live SEP-24 on/off-ramps through `<RampWidget>` (now wired to
 > `client.createOnRamp` / `client.createOffRamp`); and a self-driving Privy
 > adapter (registered interactive adapters are auto-driven to completion before
-> `login({ provider })`). Read the [CHANGELOG](../../CHANGELOG.md) before
-> upgrading.
->
-> **0.8.0 reshapes `<PollarProvider>` props (breaking).** `config` > `client`
-> (now accepts a `PollarClient` instance or a `PollarClientConfig`); `styles`
-> moves under `appConfig.styles`; new `appConfig` prop is the opt-out switch
-> for the remote `/applications/config` fetch (pass it - even `{}` - to skip
-> the fetch). Read the [CHANGELOG](../../CHANGELOG.md) and
-> [UPGRADE.md](../../UPGRADE.md) before upgrading.
+> `login({ provider })`). See the [CHANGELOG](../../CHANGELOG.md) and
+> [UPGRADE.md](../../UPGRADE.md) for the full version history before upgrading.
 
 ## Installation
 
@@ -107,12 +100,6 @@ Context provider that initialises the Pollar client and makes it available to ch
 | `appConfig` | `PollarConfig`                       | No       | Local override of `/applications/config`. **Presence is the opt-out switch**: pass it (even `{}`) and the remote fetch is skipped. Omit it to keep the existing remote-fetch-on-mount behaviour |
 | `adapters`  | `PollarAdapters`                     | No       | Named set of `PollarAdapter` objects (e.g. Trustless Work). See below                                                                                                                           |
 
-> **Renamed in 0.8.0** — `config` → `client`, `styles` → `appConfig.styles`.
-> If you were passing `styles={{ ... }}` directly, move it to
-> `appConfig={{ styles: { ... } }}` (which also opts you out of the remote
-> `/applications/config` fetch). See [UPGRADE.md](../../UPGRADE.md) for the
-> full migration matrix.
-
 ---
 
 ### `usePollar()`
@@ -169,6 +156,14 @@ const {
   swap, // (quote: SwapQuote, opts?) => Promise<SubmitOutcome>
   openSwapModal, // () => void
 
+  // Earn (yield vaults + lending — DeFindex + Blend)
+  getEarnProviders, // () => Promise<EarnProviderId[]>  ([] means Earn is disabled)
+  getEarnOpportunities, // (provider: EarnProviderId) => Promise<EarnOpportunity[]>
+  getEarnPosition, // (params: EarnPositionParams) => Promise<EarnPosition>
+  earnDeposit, // (params: EarnTxParams) => Promise<SubmitOutcome>
+  earnWithdraw, // (params: EarnTxParams) => Promise<SubmitOutcome>
+  openEarnModal, // () => void
+
   // Distribution rules
   openDistributionRulesModal, // () => void
 
@@ -198,9 +193,6 @@ const {
 Custody is derived from `wallet`, not a separate field - e.g.
 `wallet?.custody === 'external' ? wallet.provider : null`.
 
-> **0.6.0 renames** - `transaction` > `tx`, `openTransactionModal` > `openTxModal`, `config` > `appConfig`,
-> `openRampWidget` > `openRampModal`, `refreshBalance` > `refreshWalletBalance`. Existing code on 0.5.x must update.
-
 #### Login options
 
 ```ts
@@ -246,15 +238,16 @@ already wired inside `<PollarProvider>` — but they're exported in case you wan
 
 | Component                  | Purpose                                                                                                                                                                                                                                                 |
 | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `<WalletButton>`           | Drop-in button. Opens login when signed out; signed in, shows the wallet address with a dropdown (Send, Receive, copy address, balance, history, ramp, KYC, distribution rules, sessions, sign out). Inline arc spinner during in-progress transactions |
+| `<WalletButton>`           | Drop-in button. Opens login when signed out; signed in, shows the wallet address with a dropdown (Send, Receive, copy address, balance, history, ramp, KYC, distribution rules, sessions, sign out, plus a "Create account" action when the external wallet has no on-chain account yet). Inline arc spinner during in-progress transactions |
 | `<SendModal>`              | Full send flow: asset picker, amount, destination, inline build > sign > success/error                                                                                                                                                                  |
-| `<SwapModal>`              | On-chain asset-to-asset swap: pick from/to assets and amount, quote across venues, execute (auto-trustline on the buy asset when needed)                                                                                                                |
+| `<SwapModal>`              | On-chain asset-to-asset swap: pick from/to assets and amount, quote across venues, execute (auto-trustline on the buy asset when needed); paste a custom buy token (code + issuer)                                                                       |
+| `<EarnModal>`              | Deposit/withdraw across DeFindex vaults and Blend pools: provider + opportunity selection with live APY, wallet balance, over-spend guards, and auto-trustline on deposit                                                                                |
 | `<ReceiveModal>`           | Wallet address as QR code with copy-to-clipboard (no external QR dependency required)                                                                                                                                                                   |
 | `<TxHistoryModal>`         | Paginated transaction history with auto-fetch on open and stellar.expert explorer links                                                                                                                                                                 |
 | `<WalletBalanceModal>`     | Stellar account balances with refresh button                                                                                                                                                                                                            |
 | `<EnabledAssetsModal>`     | The application's dashboard-enabled assets with per-asset trustline state; establish/remove trustlines                                                                                                                                                  |
 | `<DistributionRulesModal>` | Manage the wallet's distribution rules                                                                                                                                                                                                                  |
-| `<SessionsModal>`          | **New in 0.7.0.** Lists every active refresh-token family for the current user with device metadata, marks the local session, per-row revoke, and a "Sign out everywhere" button                                                                        |
+| `<SessionsModal>`          | Lists every active refresh-token family for the current user with device metadata, marks the local session, per-row revoke, and a "Sign out everywhere" button                                                                                          |
 | `<KycModal>`               | Identity verification flow - provider selection + status polling _(UI preview - backend coming soon)_                                                                                                                                                   |
 | `<RampWidget>`             | Buy/sell crypto via SEP-24 - direction tabs, route comparison, payment instructions (wired to `client.createOnRamp` / `client.createOffRamp`)                                                                                                           |
 
@@ -292,7 +285,7 @@ want to swap the chrome but keep the data wiring from `usePollar()`.
 `<TxStatusView>` is the shared status component (build → sign → success/error) reused by `TransactionModal` and
 `SendModal`; it's exported on its own for consumers that want to embed the lifecycle elsewhere.
 
-> **0.8.1** — `onWalletConnect` is now **optional** on `<LoginModalTemplate>` (defaults to a no-op).
+> `onWalletConnect` is **optional** on `<LoginModalTemplate>` (defaults to a no-op).
 
 ---
 
@@ -314,9 +307,6 @@ const trustlessWork: PollarAdapter = {
 </PollarProvider>;
 ```
 
-> **Renamed in 0.7.0** — `EscrowFn` → `AdapterFn` and `EscrowAdapter` → `PollarAdapter`. Runtime contract is
-> unchanged; rename your imports.
-
 #### `createPollarAdapterHook(key)`
 
 Factory that generates a fully-typed hook mirroring an adapter's API with automatic XDR signing built in:

package/dist/index.css

@@ -113,29 +113,7 @@
   top: 1rem;
   left: 1rem;
 }
-.pollar-modal-refresh-btn {
-  background: none;
-  border: 1px solid var(--pollar-border);
-  cursor: pointer;
-  color: var(--pollar-muted);
-  padding: 5px 10px;
-  display: flex;
-  align-items: center;
-  gap: 0.375rem;
-  border-radius: 6px;
-  font-size: 0.75rem;
-  font-weight: 500;
-  transition: color 150ms, background 150ms;
-}
-.pollar-modal-refresh-btn:hover:not(:disabled) {
-  color: var(--pollar-text);
-  background: var(--pollar-border);
-}
-.pollar-modal-refresh-btn:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
-.pollar-modal-refresh-icon.spinning {
+.pollar-modal-refresh-icon.pollar-spinning {
   animation: pollar-spin 0.8s linear infinite;
 }
 .pollar-modal-actions {
@@ -186,12 +164,75 @@
   border-color: var(--pollar-text);
 }
 .pollar-spinner {
+  display: inline-block;
+  vertical-align: middle;
   width: 2rem;
   height: 2rem;
   border: 3px solid color-mix(in srgb, var(--pollar-accent) 20%, transparent);
   border-top-color: var(--pollar-accent);
   border-radius: 50%;
   animation: pollar-spin 0.8s linear infinite;
+  flex-shrink: 0;
+}
+.pollar-spinner-sm {
+  width: 1rem;
+  height: 1rem;
+  border-width: 2px;
+}
+.pollar-btn-primary .pollar-spinner {
+  border-color: rgba(255, 255, 255, 0.35);
+  border-top-color: #fff;
+}
+.pollar-spinner-current {
+  border-color: color-mix(in srgb, currentColor 25%, transparent);
+  border-top-color: currentColor;
+}
+.pollar-loading-block {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 2rem 1rem;
+  color: var(--pollar-muted);
+  font-size: 0.875rem;
+}
+.pollar-inline-loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+}
+.pollar-select-loading {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  color: var(--pollar-muted);
+}
+.pollar-tabs {
+  display: flex;
+  gap: 4px;
+  margin-bottom: 1.25rem;
+  padding: 4px;
+  border: 1px solid var(--pollar-border);
+  border-radius: var(--pollar-card-border-radius, 10px);
+  background: var(--pollar-input-bg);
+}
+.pollar-tab {
+  flex: 1;
+  height: 36px;
+  border: none;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--pollar-muted);
+  font-size: 14px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: color 0.15s, background-color 0.15s;
+}
+.pollar-tab[data-active=true] {
+  background: var(--pollar-bg);
+  color: var(--pollar-accent);
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06);
 }
 .pollar-modal-empty {
   text-align: center;
@@ -467,7 +508,7 @@
   padding: 0.1875rem 0.5rem;
   white-space: nowrap;
 }
-.pollar-asset-trustline.established {
+.pollar-asset-trustline.pollar-established {
   color: var(--pollar-success-text);
   border-color: var(--pollar-success-text);
 }
@@ -499,11 +540,11 @@
   background: var(--pollar-accent);
   color: #fff;
 }
-.pollar-asset-btn.danger {
+.pollar-asset-btn.pollar-danger {
   color: var(--pollar-error-text);
   border-color: var(--pollar-error-border);
 }
-.pollar-asset-btn.danger:hover:not(:disabled) {
+.pollar-asset-btn.pollar-danger:hover:not(:disabled) {
   background: var(--pollar-error-text);
   color: #fff;
 }
@@ -541,32 +582,6 @@
   padding: 0.5rem 0.75rem;
   margin-bottom: 1rem;
 }
-.pollar-modal-back {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  width: 2rem;
-  height: 2rem;
-  padding: 0;
-  border-radius: var(--pollar-buttons-border-radius, 6px);
-  border: 1px solid var(--pollar-border);
-  background-color: transparent;
-  color: var(--pollar-muted);
-  cursor: pointer;
-  transition:
-    background-color 0.15s,
-    color 0.15s,
-    border-color 0.15s;
-}
-.pollar-modal-back:hover:not(:disabled) {
-  background-color: var(--pollar-input-bg);
-  color: var(--pollar-text);
-  border-color: var(--pollar-text);
-}
-.pollar-modal-back:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
 .pollar-asset-custom-hint {
   font-size: 0.75rem;
   color: var(--pollar-muted);
@@ -592,26 +607,6 @@
   font-size: 0.6875rem;
   color: var(--pollar-error-text);
 }
-.pollar-asset-submit {
-  width: 100%;
-  height: var(--pollar-buttons-height, 44px);
-  border: none;
-  border-radius: var(--pollar-buttons-border-radius, 6px);
-  background-color: var(--pollar-accent);
-  color: #fff;
-  font-size: 0.9375rem;
-  font-weight: 700;
-  cursor: pointer;
-  margin-bottom: 1rem;
-  transition: opacity 0.15s;
-}
-.pollar-asset-submit:hover:not(:disabled) {
-  opacity: 0.9;
-}
-.pollar-asset-submit:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
 
 /* src/components/kyc-modal/KycModal.css */
 .pollar-kyc-badge {
@@ -636,15 +631,11 @@
 .pollar-kyc-modal {
   max-width: 500px;
 }
-.pollar-kyc-header {
-  margin-bottom: 1.5rem;
-  text-align: center;
-}
-.pollar-kyc-title {
-  margin: 0 0 0.375rem;
-  font-size: var(--pollar-modal-heading-size, 1.375rem);
-  font-weight: 700;
-  color: var(--pollar-text);
+.pollar-kyc-header-text {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  min-width: 0;
 }
 .pollar-kyc-subtitle {
   margin: 0;
@@ -746,7 +737,7 @@
 }
 
 /* src/components/login-modal/GithubButton.css */
-.github-button {
+.pollar-github-button {
   -webkit-appearance: none;
   appearance: none;
   background-color: var(--pollar-input-bg);
@@ -778,35 +769,35 @@
   width: 100%;
   user-select: none;
 }
-.github-button-icon {
+.pollar-github-button-icon {
   width: 20px;
   height: 20px;
   flex-shrink: 0;
 }
-.github-button-contents {
+.pollar-github-button-contents {
   flex-grow: 0;
   overflow: hidden;
   text-overflow: ellipsis;
 }
-.github-button:not(:disabled):hover {
+.pollar-github-button:not(:disabled):hover {
   border-color: var(--pollar-accent);
   color: var(--pollar-accent);
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
 }
-.github-button:not(:disabled):active {
+.pollar-github-button:not(:disabled):active {
   transform: scale(0.99);
 }
-.github-button:disabled {
+.pollar-github-button:disabled {
   cursor: default;
   opacity: 0.5;
 }
-.github-button:disabled .github-button-icon,
-.github-button:disabled .github-button-contents {
+.pollar-github-button:disabled .pollar-github-button-icon,
+.pollar-github-button:disabled .pollar-github-button-contents {
   opacity: 38%;
 }
 
 /* src/components/login-modal/GoogleButton.css */
-.gsi-material-button {
+.pollar-gsi-material-button {
   -moz-user-select: none;
   -webkit-user-select: none;
   -ms-user-select: none;
@@ -840,14 +831,14 @@
   white-space: nowrap;
   width: 100%;
 }
-.gsi-material-button .gsi-material-button-icon {
+.pollar-gsi-material-button .pollar-gsi-material-button-icon {
   height: 20px;
   margin-right: 0;
   min-width: 20px;
   width: 20px;
   flex-shrink: 0;
 }
-.gsi-material-button .gsi-material-button-content-wrapper {
+.pollar-gsi-material-button .pollar-gsi-material-button-content-wrapper {
   -webkit-align-items: center;
   align-items: center;
   display: flex;
@@ -861,7 +852,7 @@
   position: relative;
   width: 100%;
 }
-.gsi-material-button .gsi-material-button-contents {
+.pollar-gsi-material-button .pollar-gsi-material-button-contents {
   font-family:
     -apple-system,
     BlinkMacSystemFont,
@@ -872,7 +863,7 @@
   text-overflow: ellipsis;
   flex-grow: 0;
 }
-.gsi-material-button .gsi-material-button-state {
+.pollar-gsi-material-button .pollar-gsi-material-button-state {
   -webkit-transition: opacity 0.218s;
   transition: opacity 0.218s;
   bottom: 0;
@@ -882,31 +873,31 @@
   right: 0;
   top: 0;
 }
-.gsi-material-button:disabled {
+.pollar-gsi-material-button:disabled {
   cursor: default;
   background-color: #ffffff61;
   border-color: #1f1f1f1f;
 }
-.gsi-material-button:disabled .gsi-material-button-contents {
+.pollar-gsi-material-button:disabled .pollar-gsi-material-button-contents {
   opacity: 38%;
 }
-.gsi-material-button:disabled .gsi-material-button-icon {
+.pollar-gsi-material-button:disabled .pollar-gsi-material-button-icon {
   opacity: 38%;
 }
-.gsi-material-button:not(:disabled):active .gsi-material-button-state,
-.gsi-material-button:not(:disabled):focus .gsi-material-button-state {
+.pollar-gsi-material-button:not(:disabled):active .pollar-gsi-material-button-state,
+.pollar-gsi-material-button:not(:disabled):focus .pollar-gsi-material-button-state {
   background-color: #303030;
   opacity: 12%;
 }
-.gsi-material-button:not(:disabled):hover {
+.pollar-gsi-material-button:not(:disabled):hover {
   border-color: var(--pollar-accent);
   color: var(--pollar-accent);
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
 }
-.gsi-material-button:not(:disabled):active {
+.pollar-gsi-material-button:not(:disabled):active {
   transform: scale(0.99);
 }
-.gsi-material-button:not(:disabled):hover .gsi-material-button-state {
+.pollar-gsi-material-button:not(:disabled):hover .pollar-gsi-material-button-state {
   background-color: transparent;
   opacity: 0;
 }
@@ -954,29 +945,6 @@
 .pollar-email-section {
   margin-bottom: 1rem;
 }
-.pollar-email-input {
-  width: 100%;
-  height: var(--pollar-input-height, 44px);
-  padding: 0 1rem;
-  border-radius: var(--pollar-input-border-radius, 0.5rem);
-  border: 1px solid var(--pollar-border);
-  background-color: var(--pollar-input-bg);
-  font-size: 1rem;
-  color: var(--pollar-text);
-  outline: none;
-  box-sizing: border-box;
-}
-.pollar-email-input::placeholder {
-  color: var(--pollar-muted);
-}
-.pollar-email-input:focus {
-  box-shadow: 0 0 0 2px var(--pollar-accent);
-  border-color: transparent;
-}
-.pollar-email-input:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
 .pollar-divider {
   position: relative;
   margin: 1.25rem 0;
@@ -1225,34 +1193,6 @@
   font-size: var(--pollar-modal-subtitle-size, 0.9rem);
   color: var(--pollar-muted);
 }
-.pollar-ramp-input-loading {
-  display: flex;
-  align-items: center;
-  color: var(--pollar-muted);
-}
-.pollar-ramp-tabs {
-  display: flex;
-  gap: 0;
-  border: 1px solid var(--pollar-border);
-  border-radius: var(--pollar-input-border-radius, 0.5rem);
-  overflow: hidden;
-  margin-bottom: 1.25rem;
-}
-.pollar-ramp-tab {
-  flex: 1;
-  height: 40px;
-  border: none;
-  background: transparent;
-  color: var(--pollar-muted);
-  font-size: 0.875rem;
-  font-weight: 600;
-  cursor: pointer;
-  transition: all 0.15s;
-}
-.pollar-ramp-tab[data-active=true] {
-  background-color: var(--pollar-accent);
-  color: #fff;
-}
 .pollar-ramp-field {
   margin-bottom: 1rem;
 }
@@ -1300,6 +1240,10 @@
   gap: 0.625rem;
   padding: 1.5rem 0;
 }
+.pollar-ramp-loading-spinner {
+  align-self: center;
+  margin-bottom: 0.5rem;
+}
 .pollar-ramp-loading-row {
   display: flex;
   align-items: center;
@@ -1854,31 +1798,6 @@
 }
 
 /* src/components/earn-modal/EarnModal.css */
-.pollar-earn-tabs {
-  display: flex;
-  gap: 4px;
-  margin-bottom: 12px;
-  padding: 4px;
-  border: 1px solid var(--pollar-border);
-  border-radius: var(--pollar-card-border-radius);
-  background: var(--pollar-input-bg);
-}
-.pollar-earn-tab {
-  flex: 1;
-  height: 36px;
-  border: none;
-  border-radius: 6px;
-  background: transparent;
-  color: var(--pollar-muted);
-  font-size: 14px;
-  font-weight: 600;
-  cursor: pointer;
-}
-.pollar-earn-tab-active {
-  background: var(--pollar-bg);
-  color: var(--pollar-accent);
-  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06);
-}
 .pollar-earn-amount {
   position: relative;
   display: flex;
@@ -2241,7 +2160,7 @@
 }
 
 /* src/components/wallet-button/WalletButton.css */
-.wallet-login-btn {
+.pollar-wallet-login-btn {
   display: flex;
   align-items: center;
   gap: 0.75rem;
@@ -2255,24 +2174,24 @@
   box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
   transition: all 0.15s;
 }
-.wallet-login-btn:hover {
+.pollar-wallet-login-btn:hover {
   opacity: 0.9;
   box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
 }
-.wallet-login-btn:active {
+.pollar-wallet-login-btn:active {
   transform: scale(0.98);
 }
-.wallet-btn-logo {
+.pollar-wallet-btn-logo {
   width: 22px;
   height: 22px;
   object-fit: contain;
   filter: brightness(0) invert(1);
 }
-.wallet-wrapper {
+.pollar-wallet-wrapper {
   position: relative;
   display: inline-block;
 }
-.wallet-btn {
+.pollar-wallet-btn {
   display: flex;
   align-items: center;
   gap: 8px;
@@ -2285,18 +2204,18 @@
   cursor: pointer;
   transition: background 0.15s;
 }
-.wallet-btn:hover {
+.pollar-wallet-btn:hover {
   opacity: 0.9;
 }
-.wallet-chevron {
+.pollar-wallet-chevron {
   width: 12px;
   height: 12px;
   transition: transform 0.15s;
 }
-.wallet-chevron.open {
+.pollar-wallet-chevron.pollar-open {
   transform: rotate(180deg);
 }
-.wallet-dropdown {
+.pollar-wallet-dropdown {
   position: absolute;
   top: calc(100% + 6px);
   right: 0;
@@ -2307,7 +2226,7 @@
   overflow: hidden;
   z-index: 50;
 }
-.wallet-dropdown-item {
+.pollar-wallet-dropdown-item {
   display: flex;
   align-items: center;
   gap: 10px;
@@ -2321,32 +2240,32 @@
   text-align: left;
   transition: background 0.1s;
 }
-.wallet-dropdown-item:hover {
+.pollar-wallet-dropdown-item:hover {
   background: rgba(0, 0, 0, 0.05);
 }
-.wallet-dropdown-item.danger {
+.pollar-wallet-dropdown-item.pollar-danger {
   color: #dc2626;
 }
-.wallet-dropdown-item.danger:hover {
+.pollar-wallet-dropdown-item.pollar-danger:hover {
   background: #fef2f2;
 }
-.wallet-dropdown-divider {
+.pollar-wallet-dropdown-divider {
   height: 1px;
   background: rgba(0, 0, 0, 0.08);
   margin: 2px 0;
 }
-.wallet-btn-label {
+.pollar-wallet-btn-label {
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
   flex: 1;
   min-width: 0;
 }
-.wallet-btn:disabled {
+.pollar-wallet-btn:disabled {
   cursor: not-allowed;
   opacity: 1;
 }
-.wallet-btn-spinner {
+.pollar-wallet-btn-spinner {
   flex-shrink: 0;
   animation: pollar-wallet-spin 1.1s linear infinite;
 }