cxmza/windle

选用指南

AI 根据 README 整理 · 2026/10/14 18:35:58

使用方式

通过网站、应用、API 和文档使用，支持 Solana 钱包登录。

查看 README 依据

[](https://github.com/cxmza/windle/actions/workflows/codeql.yml) [**Website**](https://www.windle.fun) · [**App**](https://app.windle.fun) · [**Docs**](https://docs.windle.fun) · [**API**](https://api.windle.fun) · [**How it works**](https://docs.windle.fun/how-it-works/) </div> --- ## What is windle **windle puts promises on the line.** A team states something a program can check on Solana — *"our program is

<a href="https://docs.windle.fun"><img src=".github/assets/screen-docs.webp" alt="Docs home: SHIP OR SLASH. with the windle mark"></a> </details> ## Live | Surface | URL | What runs there | |---|---|---| | Website | [www.windle.fun](https://www.windle.fun) | Landing — Vite + React 19 + React Three Fiber, GSAP and Motion | | App | [app.windle.fun](https://app.windle.fun) | Product app — React 19, React Router 7, TanStack Query | | Sign-in | [oauth.windle.fun](https://oauth.windle.fun) | Sign-In With Solana via Wallet Standard |

部署要求

本地运行需要 Node.js ≥ 22.12 和 npm 10，API 需要 Postgres 17 和 Redis 7。

查看 README 依据

Signing a message cannot move funds. There are no API keys: browser clients call with `credentials: "include"`, credentialed CORS is limited to an exact-origin allow-list, and every non-2xx body is `{ "error": { "code", "message", "requestId" } }`. Details: [API docs](https://docs.windle.fun/api/overview/). </details> ## Run it locally Requirements: **Node.js ≥ 22.12** and npm 10. The frontends and all unit tests need nothing else (API tests use an in-memory store). Running the API itself (`dev:api`) needs a local Postgres 17 and Redis 7 — by default

`postgres://windle:windle@127.0.0.1:5432/windle` and `redis://127.0.0.1:6379/0`; override with `DATABASE_URL` and `REDIS_URL` (see `apps/api/.env.example`). ```bash git clone https://github.com/cxmza/windle.git cd windle npm ci # one lockfile for every workspace ``` | Command | What | |---|---| | `npm run dev:web` | landing on `:5173` | | `npm run dev:app` | product app on `:5174` | | `npm run dev:auth` | sign-in on `:5175` | | `npm run dev:docs` | docs on `:4321` | | `npm run dev:api` | API on `:3001` (tsx watch) |

已知限制

协议尚未上线，市场数据为演示，无真实资金；产品应用为早期版本，协议程序处于设计阶段。

查看 README 依据

[Resolution](https://docs.windle.fun/concepts/resolution/) · [Payouts](https://docs.windle.fun/concepts/payouts/). > [!IMPORTANT] > windle is **pre-launch**. The protocol programs are not deployed; markets, prices and positions on the website are > illustrative demo data, and no real funds are involved anywhere. What is live today: the website, sign-in with a > Solana wallet, the account API and the docs. ## Screenshots <table> <tr>

- **Contracts** — `import { SiwsNonce, SiwsVerifyRequest, Session, Me, safeReturnTo } from '@windle/shared';` - Inside packages, relative imports carry the `.ts` extension (`./auth.ts`); every tsconfig extends `tsconfig.base.json`, which allows it. </details> ## Project status | Area | State | |---|---| | Website, docs, brand | live | | Sign-In With Solana, sessions, account API | live (`v0.1`) | | Product app | early shell | | Protocol programs (promises, collateral, markets, resolution) | design stage — see [docs](https://docs.windle.fun/how-it-works/) |