c9f3644988
* randomString: generate a securely random string. Also, support lengths > 12 in case that's ever needed. This is used in at least one case (creating device tokens for users) where it seems important that the output is unpredictable. * Try harder to create unique usernames. The previous version added 16 bits of entropy to the username, which isn't all that much. Due to the birthday paradox, it would be enough to create ~256 users with the same prefix to get a collision. Trying that would probably fail later on, and not create security issues... but it just seems better to be on the safe side here. |
||
---|---|---|
.github | ||
.vscode | ||
common | ||
functions | ||
og-image | ||
web | ||
.firebaserc | ||
.gitignore | ||
.prettierrc | ||
firebase.json | ||
firestore.indexes.json | ||
firestore.rules | ||
LICENSE.md | ||
package.json | ||
README.md | ||
yarn.lock |
Manifold Markets
This monorepo has basically everything involved in running and operating Manifold.
Getting started
- Make sure you have Yarn 1.x
$ cd web
$ yarn
$ yarn dev:dev
- Your site will be available on http://localhost:3000
See web/README.md
for more details on hacking on the web client.
General architecture
Manifold's public API and web app are hosted by Vercel. In general, the web app runs as much as possible on the client; we follow a JAMStack architecture. All data is stored in Firebase's database, Cloud Firestore. This is directly accessed by the client for most data access operations.
Operations with complicated contracts (e.g. buying shares) are provided in a separate HTTP API using Firebase's Cloud Functions. Those are deployed separately from the Vercel website; see functions/README.md
for more details.
Directory overview
-
web/
: UI and business logic for the client. Where most of the site lives. The public API endpoints are also in here. -
functions/
: Firebase cloud functions, for secure work (e.g. balances, Stripe payments, emails). Also contains infunctions/src/scripts/
some Typescript scripts that do ad hoc CLI interaction with Firebase. -
common/
: Typescript library code shared betweenweb/
&functions/
. If you want to look at how the market math works, most of that's in here (it gets called from theplaceBet
andsellBet
endpoints infunctions/
.) Also contains incommon/envs
configuration for the different environments (i.e. prod, dev, Manifold for Teams instances.) -
og-image/
: The OpenGraph image generator; creates the preview images shown on Twitter/social media.
Also: Our docs are currently in a separate repo. TODO: move them into this monorepo.
Contributing
Since we are just now open-sourcing things, we will see how things go. Feel free to open issues, submit PRs, and chat about the process on Discord. We would prefer small PRs that we can effectively evaluate and review -- maybe check in with us first if you are thinking to work on a big change.
By contributing to this codebase, you are agreeing to the terms of the Manifold CLA.
If you need additional access to any infrastructure in order to work on something (e.g. Vercel, Firebase) let us know about that on Discord as well.