[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94576":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":16,"starSnapshotCount":16,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},94576,"tokens","solana-foundation\u002Ftokens","solana-foundation","The source of truth for canonical assets on Solana. ","https:\u002F\u002Ftokens.xyz",null,"TypeScript",113,54,1,5,0,3,45.52,"MIT License",false,"main",true,[],"2026-08-24 04:01:22","# Tokens\n\nTokens is the open-source monorepo for the Tokens website, API, docs, and services. This is the live repository the project is developed and deployed from — it is not a mirror or a snapshot.\n\nIssues are welcome; external pull requests are not accepted. See the contribution policy below and [SECURITY.md](SECURITY.md) for reporting vulnerabilities.\n\n## Contributions and Curation\n\nTokens is open source, and you are free to inspect, use, and fork the code under\nthe terms of the MIT license. The hosted Tokens product—including its frontend\nexperience and its curated token, venue, market, and metadata coverage—remains\noperated and controlled by the Tokens team. Publishing the source does not make\nthe hosted product or its listings community-managed.\n\nWe do not accept external pull requests, including requests to add or update\ntokens, venues, markets, logos, metadata, rankings, or other product content.\nExternal pull requests are closed automatically without review.\n\nIf you have found a relevant bug, data issue, or other improvement, please\n[open an issue](https:\u002F\u002Fgithub.com\u002Fsolana-foundation\u002Ftokens\u002Fissues) with enough\ncontext for the maintainers to evaluate it. Please report security\nvulnerabilities through the process in [SECURITY.md](SECURITY.md), not through a\npublic issue.\n\n## Scope\n\n- The code here powers the hosted Tokens product; the hosted surfaces remain the easiest way to *use* Tokens.\n- Self-hosting a full production deployment is possible but not yet documented end to end — the app code, database schema (`db\u002F`), and infrastructure (`terraform\u002F`) are all here, but you will need to supply your own credentials and infrastructure.\n- `apps\u002Fadmin` and the operational apps are authenticated maintainer tooling, not anonymous public surfaces.\n\n## Repo Surfaces\n\n| Surface      | Role                                                | Deployment                                       |\n| ------------ | --------------------------------------------------- | ------------------------------------------------ |\n| `apps\u002Fweb`         | Public product website and lightweight proxy routes | Vercel                                     |\n| `apps\u002Fdocs`        | Public API documentation site                       | Vercel                                     |\n| `apps\u002Fapi`         | Tokens platform API (`\u002Fv1\u002F...`) and helper routes   | Vercel                                     |\n| `apps\u002Fapp`         | First-party dashboard for API keys and usage        | Vercel                                     |\n| `apps\u002Fadmin`       | Authenticated tooling for curated asset management  | Vercel (authenticated maintainer surface)  |\n| `apps\u002Fcloudrun-*`  | Backend services (assets, prices, usage, admin)     | GCP Cloud Run                              |\n| `packages\u002F*`       | Shared packages and UI primitives                   | Consumed by the apps                       |\n| `db\u002F`              | SQL schema and ordered migrations                   | Postgres (Cloud SQL)                       |\n| `terraform\u002F`       | Live infrastructure-as-code for staging\u002Fproduction  | GCP (applied by CI)                        |\n| `scripts`          | Verification, seeding, and maintenance utilities    | Local \u002F CI tooling                         |\n\n## Architecture\n\nThe `apps\u002Fweb`, `apps\u002Fapp`, and `apps\u002Fadmin` Next.js frontends talk to `apps\u002Fapi`\n(the public `\u002Fv1\u002F...` platform API). `apps\u002Fapi` authenticates callers (Clerk for\nsessions, hashed platform API keys for programmatic access) and proxies to the\nCloud Run backend services in `apps\u002Fcloudrun-*` (assets, prices, usage, admin),\nwhich own data access to Postgres (Cloud SQL), ClickHouse, and Upstash Redis.\nSchema lives in `db\u002F`; infrastructure in `terraform\u002F`.\n\n## Tech Stack\n\n- Next.js 16 App Router\n- Bun workspaces + Turborepo\n- TypeScript\n- Tailwind CSS 4\n- Clerk (auth)\n- Postgres (Cloud SQL) + ClickHouse + Upstash Redis\n- Cloud Run (backend services)\n\n## Getting Started\n\n1. Install dependencies.\n\n```bash\nbun install\n```\n\n2. Create local env files from the checked-in templates.\n\n```bash\ncp .env.example .env.local\ncp apps\u002Fapi\u002F.env.example apps\u002Fapi\u002F.env.local\ncp apps\u002Fapp\u002F.env.example apps\u002Fapp\u002F.env.local\ncp apps\u002Fadmin\u002F.env.example apps\u002Fadmin\u002F.env.local\ncp apps\u002Fweb\u002F.env.example apps\u002Fweb\u002F.env.local\n```\n\n3. Fill in the credentials and service URLs required for the apps you plan to run.\n4. Apply the database schema (Postgres) if you are running services that need it.\n\n```bash\nDATABASE_URL=postgres:\u002F\u002F... .\u002Fdb\u002Fapply.sh\n```\n\n5. Start the workspace dev servers.\n\n```bash\nbun dev\n```\n\nCommon local ports:\n\n- `web`: `http:\u002F\u002Flocalhost:3000`\n- `app`: `http:\u002F\u002Flocalhost:3001`\n- `api`: `http:\u002F\u002Flocalhost:3002`\n- `docs`: `http:\u002F\u002Flocalhost:3003`\n- `admin`: `http:\u002F\u002Flocalhost:3004`\n\n## Common Commands\n\n```bash\nbun dev\nbun run build\nbun run lint\nbun run check:repo-hygiene\nbun run verify:api-health-routes\nbun run audit:deps\n```\n\n## Verification And Releases\n\n- Read [TESTING.md](TESTING.md) for CI and local verification guidance used by maintainers.\n- Read [RELEASING.md](RELEASING.md) for how changes promote from staging to production, and how to roll back.\n- Review [SECURITY.md](SECURITY.md) before reporting vulnerabilities.\n\n## Security And Hygiene\n\n- Local env files such as `.env.local` are ignored and must never be committed.\n- Never commit credentials, secrets, or personal data. `bun run check:repo-hygiene` enforces the basics in CI.\n\n## License\n\nMIT. See [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) for vendored-asset posture.\n","这是一个为Solana区块链提供权威代币资产元数据的开源项目，作为Solana生态中代币、交易场所、市场及标识信息的官方数据源。项目包含Web前端、RESTful API（\u002Fv1\u002F...）、文档站点及后台服务，采用TypeScript开发，基于PostgreSQL存储结构化元数据，并通过Vercel与Google Cloud Run部署。其核心特点是数据经Solana基金会团队人工审核与维护，强调准确性与权威性，不接受社区直接提交的代币或元数据更新。适用于开发者集成链上资产信息、构建钱包\u002FDEX\u002F数据分析工具等需要可信代币基础数据的场景。",2,"2026-08-12 02:30:08","CREATED_QUERY"]