You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-10Lines changed: 11 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# SmartDrop (frontend)
2
2
3
-
This repository is the **Next.js web app** for SmartDrop, hosted under [**SmartDropLabs/smartdrop-frontend**](https://github.com/SmartDropLabs/smartdrop-frontend). Soroban contracts live in [**smartdrop-contracts**](https://github.com/SmartDropLabs/smartdrop-contracts); the API and indexing service lives in [**smartdrop-backend**](https://github.com/SmartDropLabs/smartdrop-backend).
3
+
This repository is the **Next.js web app** for SmartDrop, hosted under [**Mainnet-ops/smartdrop-frontend**](https://github.com/Mainnet-ops/smartdrop-frontend). Soroban contracts live in [**smartdrop-contracts**](https://github.com/Mainnet-ops/smartdrop-contracts); the API and indexing service lives in [**smartdrop-backend**](https://github.com/Mainnet-ops/smartdrop-backend).
4
4
5
5
**SmartDrop** is a liquidity-oriented airdrop experiment on **Stellar**: participants lock **Stellar assets** in **Soroban** farming pools and accrue **airdrop credits** over time instead of passive "click to claim" drops. The goal is to reward people who materially back a project early while discouraging purely extractive behavior.
6
6
@@ -10,19 +10,19 @@ This repository is the **Next.js web app** for SmartDrop, hosted under [**SmartD
10
10
11
11
At a high level, SmartDrop has two layers:
12
12
13
-
1.**Smart contracts (Soroban / Rust)** — developed in [**smartdrop-contracts**](https://github.com/SmartDropLabs/smartdrop-contracts)
13
+
1.**Smart contracts (Soroban / Rust)** — developed in [**smartdrop-contracts**](https://github.com/Mainnet-ops/smartdrop-contracts)
14
14
- A **factory** registers or deploys isolated **farming pool** instances per campaign.
15
15
- Each pool accepts a configurable **staking asset** (classic asset + trustline and/or Soroban token contract, depending on your design). Participants **lock** balances, **earn credits** from elapsed time × amount × rate multipliers, can opt into **boost** rules, and **unlock** when policy allows.
16
16
17
17
2.**Web app (this repo)**
18
-
A Chakra UI + Tailwind CSS front end with **Freighter** for wallet connection and Stellar network settings in `src/config/`. The **Farm** flow is wired to **Soroban RPC** (`invoke`, simulation, transaction submission); dashboard numbers reflect live contract state where a factory is configured, and fall back to clear "not available" states otherwise. Off-chain pages (**Prices**, **Airdrops**, **Webhooks**, **Alerts**) call [**smartdrop-backend**](https://github.com/SmartDropLabs/smartdrop-backend) directly over REST — see `src/lib/backend.ts` and `NEXT_PUBLIC_BACKEND_API_URL` below.
18
+
A Chakra UI + Tailwind CSS front end with **Freighter** for wallet connection and Stellar network settings in `src/config/`. The **Farm** flow is wired to **Soroban RPC** (`invoke`, simulation, transaction submission); dashboard numbers reflect live contract state where a factory is configured, and fall back to clear "not available" states otherwise. Off-chain pages (**Prices**, **Airdrops**, **Webhooks**, **Alerts**) call [**smartdrop-backend**](https://github.com/Mainnet-ops/smartdrop-backend) directly over REST — see `src/lib/backend.ts` and `NEXT_PUBLIC_BACKEND_API_URL` below.
Local preview with the same asset paths: `BASE_PATH=/smartdrop-frontend npm run build` and `npx serve out` → open **`http://localhost:3000/smartdrop-frontend/`**.
110
110
111
111
### Vercel
112
112
113
113
1. Sign in at [vercel.com](https://vercel.com) and click **Add New… → Project**.
114
-
2.**Import**`SmartDropLabs/smartdrop-frontend` (or your fork). Leave the root directory as the repo root (where `package.json` lives).
114
+
2.**Import**`Mainnet-ops/smartdrop-frontend` (or your fork). Leave the root directory as the repo root (where `package.json` lives).
115
115
3. Vercel should detect **Next.js**. `vercel.json` runs **`npm ci`** + **`npm run build`**; **`.npmrc`** enables `legacy-peer-deps` so Chakra + React resolve like your lockfile. The app is a **static export** (`next.config.ts`): no Node server, only HTML/JS/CSS.
116
116
4. Under **Environment Variables**, add any optional `NEXT_PUBLIC_*` values from above (defaults work for testnet without them).
117
117
5. In **Settings → General**, set **Node.js** to **20.x** (see `.nvmrc` / `package.json``engines`).
@@ -156,13 +156,13 @@ npm run dev # frontend only — on-chain pages work, backend pages show
156
156
npm run dev:stack # frontend + smartdrop-backend + an in-memory Redis, all in one command
157
157
```
158
158
159
-
`dev:stack` (`scripts/dev-stack.sh`) expects [`smartdrop-backend`](https://github.com/SmartDropLabs/smartdrop-backend) cloned as a sibling directory (`../smartdrop-backend`), or point it elsewhere with `SMARTDROP_BACKEND_DIR=/path npm run dev:stack`. It needs no Docker or system Redis install — the first run installs a small in-memory Redis under `~/.smartdrop-dev/` and reuses it on every subsequent run, along with a persisted admin API key (printed on startup, needed for `/alerts`). Ctrl+C stops all three processes; logs land in `~/.smartdrop-dev/logs/`.
159
+
`dev:stack` (`scripts/dev-stack.sh`) expects [`smartdrop-backend`](https://github.com/Mainnet-ops/smartdrop-backend) cloned as a sibling directory (`../smartdrop-backend`), or point it elsewhere with `SMARTDROP_BACKEND_DIR=/path npm run dev:stack`. It needs no Docker or system Redis install — the first run installs a small in-memory Redis under `~/.smartdrop-dev/` and reuses it on every subsequent run, along with a persisted admin API key (printed on startup, needed for `/alerts`). Ctrl+C stops all three processes; logs land in `~/.smartdrop-dev/logs/`.
160
160
161
161
Open [http://localhost:3000](http://localhost:3000). Production: `npm run build` / `npm start`.
162
162
163
163
### Soroban contracts
164
164
165
-
See the [**smartdrop-contracts**](https://github.com/SmartDropLabs/smartdrop-contracts) repository. Use the official **Stellar / Soroban** CLI and Rust toolchain to scaffold, test, and deploy; then connect the UI via RPC and Freighter-signed transactions.
165
+
See the [**smartdrop-contracts**](https://github.com/Mainnet-ops/smartdrop-contracts) repository. Use the official **Stellar / Soroban** CLI and Rust toolchain to scaffold, test, and deploy; then connect the UI via RPC and Freighter-signed transactions.
166
166
167
167
**Never commit** signing keys or sponsor secrets.
168
168
@@ -186,12 +186,13 @@ This codebase is **not** presented as audited production infrastructure. Pool ec
186
186
|**Boost & donations**| Wire boosts to explicit token transfer rules in contracts. |
187
187
|**Frontend**| Continue migrating layout/responsive styling to Tailwind. |
|**Credits visibility**| Total credits badge on farm page header — users no longer need to navigate home to see their balance. |
189
190
190
191
---
191
192
192
193
## Contributors
193
194
194
-
SmartDrop is built by the SmartDropLabs org across three repos: this frontend, [`smartdrop-backend`](https://github.com/SmartDropLabs/smartdrop-backend), and [`smartdrop-contracts`](https://github.com/SmartDropLabs/smartdrop-contracts). See **[`CONTRIBUTORS.md`](./CONTRIBUTORS.md)** or the in-app [`/contributors`](https://smartdroplabs.github.io/smartdrop-frontend/contributors) page for the full list, sourced directly from each repo's GitHub contributors API.
195
+
SmartDrop is built by the Mainnet-ops org across three repos: this frontend, [`smartdrop-backend`](https://github.com/Mainnet-ops/smartdrop-backend), and [`smartdrop-contracts`](https://github.com/Mainnet-ops/smartdrop-contracts). See **[`CONTRIBUTORS.md`](./CONTRIBUTORS.md)** or the in-app [`/contributors`](https://mainnet-ops.github.io/smartdrop-frontend/contributors) page for the full list, sourced directly from each repo's GitHub contributors API.
0 commit comments