diff --git a/.claude/skills/grid-api/SKILL.md b/.claude/skills/grid-api/SKILL.md index b513d130..53b32614 100644 --- a/.claude/skills/grid-api/SKILL.md +++ b/.claude/skills/grid-api/SKILL.md @@ -24,7 +24,7 @@ allowed-tools: Assist users with global payment operations via the Grid API. Core capabilities: 1. **Execute API Operations** - Use `curl` to interact with the Grid API directly -2. **Answer Documentation Questions** - Fetch docs from or the OpenAPI spec () +2. **Answer Documentation Questions** - Fetch docs from or the OpenAPI spec () 3. **Guide Payment Workflows** - Help users send payments to bank accounts, UMA addresses, and crypto wallets ## Embedded Wallet Offramp (USDB → USD bank) @@ -99,9 +99,9 @@ export GRID_BASE_URL=$(jq -r '.baseUrl // "https://api.lightspark.com/grid/2025- For questions not covered by this skill's reference files, fetch additional information from the web: -- **LLM-optimized docs**: Fetch `https://grid.lightspark.com/llms.txt` for a concise overview of the Grid API, or `https://grid.lightspark.com/llms-full.txt` for comprehensive documentation +- **LLM-optimized docs**: Fetch `https://docs.lightspark.com/llms.txt` for a concise overview of the Grid API, or `https://docs.lightspark.com/llms-full.txt` for comprehensive documentation - **OpenAPI Spec**: Fetch `https://raw.githubusercontent.com/lightsparkdev/grid-api/refs/heads/main/openapi.yaml` for the full API schema with request/response definitions -- **Published docs**: Browse `https://grid.lightspark.com` for guides, tutorials, and API reference. Any page can use the `.md` suffix for a more agent-readable format. +- **Published docs**: Browse `https://docs.lightspark.com` for guides, tutorials, and API reference. Any page can use the `.md` suffix for a more agent-readable format. ## Making API Calls diff --git a/.gitignore b/.gitignore index 39e0d77f..78b1c6a7 100644 --- a/.gitignore +++ b/.gitignore @@ -57,3 +57,8 @@ scripts/export-icons.js # Superset .superset/ + +# Claude Code scratch — never commit +.claude/worktrees/ +.claude/scheduled_tasks.lock +error-audit/ diff --git a/.stainless/stainless.yml b/.stainless/stainless.yml index 93b43232..5b73ca3b 100644 --- a/.stainless/stainless.yml +++ b/.stainless/stainless.yml @@ -10,7 +10,7 @@ organization: # and headings. name: Lightspark Grid # Link to your API documentation. - docs: 'grid.lightspark.com' + docs: 'docs.lightspark.com' # Contact email for bug reports, questions, and support requests. contact: support@lightspark.com diff --git a/README.md b/README.md index 94a76559..a077c808 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ Grid is an API that enables modern financial institutions to easily send and receive global payments. One API to send, receive, and settle value globally—fiat, stablecoins, or Bitcoin. Always real time, always low cost, built on an open network. -See the full documentation at . +See the full documentation at . ## Overview diff --git a/components/grid-visualizer/CLAUDE.md b/components/grid-visualizer/CLAUDE.md index 1204c33e..1c1c24d0 100644 --- a/components/grid-visualizer/CLAUDE.md +++ b/components/grid-visualizer/CLAUDE.md @@ -14,7 +14,7 @@ Grid Visualizer is an interactive tool that helps integrators understand and get ## Entry Points -- **Docs site**: grid.lightspark.com +- **Docs site**: docs.lightspark.com - **Marketing site**: lightspark.com/grid - **Direct links** shared in sales conversations - Currently deployed at: https://grid-flow-builder.vercel.app/ diff --git a/components/grid-visualizer/next.config.mjs b/components/grid-visualizer/next.config.mjs index 2a4d8b27..692cbece 100644 --- a/components/grid-visualizer/next.config.mjs +++ b/components/grid-visualizer/next.config.mjs @@ -26,7 +26,7 @@ const nextConfig = { headers: [ { key: 'Content-Security-Policy', - value: "frame-ancestors 'self' https://grid.lightspark.com https://*.lightspark.com http://localhost:*", + value: "frame-ancestors 'self' https://docs.lightspark.com https://*.lightspark.com http://localhost:*", }, ], }, diff --git a/components/grid-visualizer/src/components/Footer/Footer.tsx b/components/grid-visualizer/src/components/Footer/Footer.tsx index 990e61e8..42138708 100644 --- a/components/grid-visualizer/src/components/Footer/Footer.tsx +++ b/components/grid-visualizer/src/components/Footer/Footer.tsx @@ -43,7 +43,7 @@ export function Footer({ theme, setTheme }: FooterProps) {
- + View docs You can find more information about the UMA protocol and end user experience at [https://uma.me](https://uma.me). @@ -30,9 +30,9 @@ Set up proxying so UMA‑related requests are forwarded to your assigned `proxyU - UMA domain determines the address format (e.g., `$alice@yourdomain.com`) - Proxy the following paths to `{proxyUmaSubdomain}`: - - `https:///.well-known/lnurlp/*` -> `https://.grid.lightspark.com/.well-known/lnurlp/*` - - `https:///.well-known/lnurlpubkey` -> `https://.grid.lightspark.com/.well-known/lnurlpubkey` - - `https:///.well-known/uma-configuration` -> `https://.grid.lightspark.com/.well-known/uma-configuration` + - `https:///.well-known/lnurlp/*` -> `https://.docs.lightspark.com/.well-known/lnurlp/*` + - `https:///.well-known/lnurlpubkey` -> `https://.docs.lightspark.com/.well-known/lnurlpubkey` + - `https:///.well-known/uma-configuration` -> `https://.docs.lightspark.com/.well-known/uma-configuration` Additionally, configure: - Supported currencies (min/max, enabled transaction types) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 0d08351f..eef94097 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.1.0 info: title: Grid API description: | - API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://grid.lightspark.com/. + API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://docs.lightspark.com/. version: '2025-10-13' contact: name: Lightspark Support @@ -16340,7 +16340,7 @@ components: example: Customer:019542f5-b3e7-1d02-0000-000000000009 currency: type: string - description: Currency code for the funding source. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. + description: Currency code for the funding source. See [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: USD cryptoNetwork: type: string @@ -16411,7 +16411,7 @@ components: example: $receiver@uma.domain.com currency: type: string - description: Currency code for the destination. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. + description: Currency code for the destination. See [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: EUR description: UMA address destination details QuoteDestinationOneOf: diff --git a/mintlify/platform-overview/building-with-ai.mdx b/mintlify/platform-overview/building-with-ai.mdx index 24be9a5f..d234ecaa 100644 --- a/mintlify/platform-overview/building-with-ai.mdx +++ b/mintlify/platform-overview/building-with-ai.mdx @@ -110,7 +110,7 @@ Start in the sandbox environment to experiment safely. The Skill is great at gen Grid provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that lets AI agents search Grid's SDK documentation **and** execute Grid API operations directly. Your agentic workflows get full context of the Grid API during implementation and can run quotes, transfers, customer onboarding, and other operations end-to-end. ```text -https://mcp.grid.lightspark.com/ +https://mcp.docs.lightspark.com/ ``` The MCP server exposes two tools: @@ -137,7 +137,7 @@ The MCP server requires Grid API credentials. In the [Grid dashboard](https://ap "mcpServers": { "grid_mcp": { "type": "http", - "url": "https://mcp.grid.lightspark.com/", + "url": "https://mcp.docs.lightspark.com/", "headers": { "x-grid-client-id": "{client id}", "x-grid-client-secret": "{client secret}" @@ -159,7 +159,7 @@ The MCP server requires Grid API credentials. In the [Grid dashboard](https://ap "args": [ "-y", "mcp-remote", - "https://mcp.grid.lightspark.com/", + "https://mcp.docs.lightspark.com/", "--header", "x-grid-client-id: {client id}", "--header", @@ -180,7 +180,7 @@ The MCP server requires Grid API credentials. In the [Grid dashboard](https://ap { "mcpServers": { "grid_mcp": { - "url": "https://mcp.grid.lightspark.com/", + "url": "https://mcp.docs.lightspark.com/", "headers": { "x-grid-client-id": "{client id}", "x-grid-client-secret": "{client secret}" @@ -194,7 +194,7 @@ The MCP server requires Grid API credentials. In the [Grid dashboard](https://ap Any client that supports MCP's streamable HTTP transport (ChatGPT, Windsurf, Zed, Cline, and others) can connect using the same URL and headers: - - **URL:** `https://mcp.grid.lightspark.com/` + - **URL:** `https://mcp.docs.lightspark.com/` - **Headers:** `x-grid-client-id: {client id}` and `x-grid-client-secret: {client secret}` For clients that don't yet support HTTP-transport MCP servers natively, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a bridge — see the Claude desktop app tab for an example. diff --git a/mintlify/snippets/platform-configuration-uma.mdx b/mintlify/snippets/platform-configuration-uma.mdx index 19076286..44419d1b 100644 --- a/mintlify/snippets/platform-configuration-uma.mdx +++ b/mintlify/snippets/platform-configuration-uma.mdx @@ -121,9 +121,9 @@ Requirements for a valid UMA domain: - Must be a valid domain name format - Should be a domain that you control - Must proxy incoming requests to the Grid API as follows: - - `https:///.well-known/lnurlp/*` -> `https://.grid.lightspark.com/.well-known/lnurlp/*` - - `https:///.well-known/lnurlpubkey` -> `https://.grid.lightspark.com/.well-known/lnurlpubkey` - - `https:///.well-known/uma-configuration` -> `https://.grid.lightspark.com/.well-known/uma-configuration` + - `https:///.well-known/lnurlp/*` -> `https://.docs.lightspark.com/.well-known/lnurlp/*` + - `https:///.well-known/lnurlpubkey` -> `https://.docs.lightspark.com/.well-known/lnurlpubkey` + - `https:///.well-known/uma-configuration` -> `https://.docs.lightspark.com/.well-known/uma-configuration` ### Webhook Endpoint diff --git a/openapi.yaml b/openapi.yaml index 0d08351f..eef94097 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.1.0 info: title: Grid API description: | - API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://grid.lightspark.com/. + API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://docs.lightspark.com/. version: '2025-10-13' contact: name: Lightspark Support @@ -16340,7 +16340,7 @@ components: example: Customer:019542f5-b3e7-1d02-0000-000000000009 currency: type: string - description: Currency code for the funding source. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. + description: Currency code for the funding source. See [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: USD cryptoNetwork: type: string @@ -16411,7 +16411,7 @@ components: example: $receiver@uma.domain.com currency: type: string - description: Currency code for the destination. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. + description: Currency code for the destination. See [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: EUR description: UMA address destination details QuoteDestinationOneOf: diff --git a/openapi/components/schemas/quotes/RealtimeFundingQuoteSource.yaml b/openapi/components/schemas/quotes/RealtimeFundingQuoteSource.yaml index 3b23d388..6793b4ac 100644 --- a/openapi/components/schemas/quotes/RealtimeFundingQuoteSource.yaml +++ b/openapi/components/schemas/quotes/RealtimeFundingQuoteSource.yaml @@ -20,7 +20,7 @@ allOf: type: string description: >- Currency code for the funding source. See - [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) + [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: USD cryptoNetwork: diff --git a/openapi/components/schemas/quotes/UmaAddressDestination.yaml b/openapi/components/schemas/quotes/UmaAddressDestination.yaml index b2cd9950..810a8df7 100644 --- a/openapi/components/schemas/quotes/UmaAddressDestination.yaml +++ b/openapi/components/schemas/quotes/UmaAddressDestination.yaml @@ -18,7 +18,7 @@ allOf: type: string description: >- Currency code for the destination. See - [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) + [Supported Currencies](https://docs.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. example: EUR description: UMA address destination details diff --git a/openapi/openapi.yaml b/openapi/openapi.yaml index 06e0ad78..44648e9c 100644 --- a/openapi/openapi.yaml +++ b/openapi/openapi.yaml @@ -3,7 +3,7 @@ openapi: 3.1.0 info: title: Grid API description: > - API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://grid.lightspark.com/. + API for managing global payments on the open Money Grid. Built by Lightspark. See the full documentation at https://docs.lightspark.com/. version: "2025-10-13" contact: name: Lightspark Support diff --git a/scripts/README.md b/scripts/README.md index fce053d3..d4ead2f5 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -8,7 +8,7 @@ are HPKE bundle decrypt and Turnkey API stamp construction, which live in `@turnkey/crypto` and `@turnkey/api-key-stamper`). > **For production integrations**, prefer the official Grid SDKs at -> . This README is intended for hands-on +> . This README is intended for hands-on > tinkering, debugging, and end-to-end validation — it favors curl and > the minimal signing helpers over a full SDK stack.