Add stablecoin issuance API surface by kphurley7 · Pull Request #578 · lightsparkdev/grid-api

kphurley7 · 2026-06-12T20:33:00Z

Important

Do not merge until the webdev implementation stack (lightsparkdev/webdev#28785 → #28734) has merged and the feature is ready to light up. Merging here publishes the endpoints: the nightly docs-sync workflow picks up openapi/ changes on main and the Stainless-documented spec feeds the public docs/SDKs. This PR stays draft until launch readiness.

Summary

Companion spec PR for the Brale stablecoin issuance stack in webdev (implementation: the flow-sliced stack starting at lightsparkdev/webdev#28785). Adds to the split OpenAPI source (openapi/):

12 paths under openapi/paths/stablecoins/: provider account links, stablecoin registration/list/get, external-account link sessions + linking (Plaid / direct bank entry / Grid external account), mint+burn quote create/get/execute, operations list/get.
48 schemas under openapi/components/schemas/stablecoins/: typed discriminated requests (quote operation types, mint funding sources, link methods), typed destination oneOf on quote/operation, payout-rail subset enum, list envelopes.
Stablecoin error codes added to Error400/Error404/Error409 enums (the generated clients hard-reject unknown codes, so these must ship before the backend returns them).
Stablecoins tag.

Bundle regenerated with make build; Redocly validation clean; spectral passes at --fail-severity=error.

Verification

The rebuilt bundle's stablecoin paths/schemas and error enums are deep-equal to the spec vendored in the webdev stack tip (verified programmatically). The only non-stablecoin delta vs that copy is ExchangeRateFees.total, which exists here and not yet in webdev's vendored copy (pre-existing drift; webdev picks it up on its next update_schema.sh sync).

🤖 Generated with Claude Code

Stablecoin issuance endpoints for the Grid API: provider account links, stablecoin registration, external accounts (Plaid link sessions, direct bank entry, Grid external accounts), mint/burn quotes and execution, and operations. Adds the stablecoin error codes to the Error400/404/409 enums and the Stablecoins tag. Spec source of truth for the webdev implementation stack starting at lightsparkdev/webdev#28029, which vendors this spec and generates the grid_api client from it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel · 2026-06-12T20:33:03Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ignored	Preview	Jun 12, 2026 8:33pm

github-actions · 2026-06-12T20:33:44Z

✱ Stainless preview builds for grid

This PR will update the grid SDKs with the following commit messages.

cli

chore(internal): regenerate SDK with no functional changes

csharp

chore(internal): regenerate SDK with no functional changes

go

chore(internal): regenerate SDK with no functional changes

kotlin

chore(internal): regenerate SDK with no functional changes

openapi

feat: Add stablecoin issuance API surface

php

chore(internal): regenerate SDK with no functional changes

python

chore(internal): regenerate SDK with no functional changes

ruby

chore(internal): regenerate SDK with no functional changes

typescript

chore(internal): regenerate SDK with no functional changes

Edit this comment to update them. They will appear in their respective SDK's changelogs.

✅ grid-openapi studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-ruby studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ⏭️ (prev: build ✅) → lint ✅ → test ✅

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-typescript studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ⏭️ (prev: build ✅) → lint ⏭️ (prev: lint ✅) → test ✅

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-go studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ⏭️ (prev: build ✅) → lint ❗ → test ❗
go get github.com/stainless-sdks/grid-go@390f6c91bd184b4f84343e4cff414c7dd74f2a16
New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-kotlin studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ⏭️ (prev: build ✅) → lint ⏭️ (prev: lint ✅) → test ✅

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-python studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → build ⏭️ (prev: build ✅) → lint ⏭️ (prev: lint ❗) → test ❗

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-csharp studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ⚠️ → build ⏭️ (prev: build ❗) → lint ⏭️ (prev: lint ✅) → test ❗

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-php studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ✅ → lint ✅ → test ✅

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

✅ grid-cli studio · code · diff

Your SDK build had at least one new note diagnostic, which is a regression from the base state.
generate ⚠️ → build ❗ → lint ❗ → test ❗

New diagnostics (15 note)

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-provider-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-provider-accounts/{stablecoinProviderAccountId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoins`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoins/{stablecoinId}`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-account-link-sessions`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `post /stablecoin-external-accounts`

💡 Endpoint/NotConfigured: Skipped endpoint because it's not in your Stainless config: `get /stablecoin-external-accounts/{stablecoinExternalAccountId}`

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-06-12 20:37:16 UTC

kphurley7 · 2026-07-14T17:41:32Z

Superseded by #687. #578 modeled stablecoin issuance as quotes (/quotes + execute), but the shipped Grid server (webdev #29077/#29078) implements direct mint/burn issuer operations. #687 adds that direct surface onto current main. Closing this in favor of #687.

Adds the public API surface for direct stablecoin issuer operations that shipped in the Grid server (webdev #29077 mint, #29078 burn): register a provider-created stablecoin, list/get stablecoins, create direct mint and burn operations, and list/get the resulting issuer operations. - New paths: /stablecoins, /stablecoins/{id}, /stablecoins/{id}/mints, /stablecoins/{id}/burns, /stablecoins/{id}/operations, /stablecoin-operations/{id}. - New schemas under components/schemas/stablecoins: Stablecoin, StablecoinListResponse, StablecoinRegisterRequest, StablecoinMintRequest, StablecoinBurnRequest, mint/burn source+destination, StablecoinOperation, StablecoinOperation{Type,Status,Destination,ListResponse}, StablecoinFundingInstructions, StablecoinEstimatedDelivery, StablecoinNetwork, Stablecoin{Grid,}OperationsStatus, StablecoinIssuanceStatus. - Adds Error503 (SERVICE_UNAVAILABLE) used by the issuance responses. StablecoinOperation.destination is a single merged StablecoinOperationDestination object (superset of the mint/burn request destinations), NOT a oneOf: a non-discriminated oneOf[Mint,Burn] is ambiguous (a burn destination validates as both variants), so the generated SDK raises "Multiple matches found" on every burn operation response. The merged object deserializes unambiguously. This supersedes the quote-based issuance design in #578 (which is being closed); the shipped server implements direct operations, not quotes. Bundled with redocly; `redocly lint` passes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

## What Adds the public API surface for **direct stablecoin issuer operations** that shipped in the Grid server (webdev #29077 mint, #29078 burn). Upstream `main` currently has only the stablecoin *provider-account* surface (from #594); the mint/burn/registration surface lives only in webdev's vendored `grid-api/openapi.yaml` and is absent here — so it gets clobbered on the next `update_schema.sh` regen and external SDK consumers never receive it. ## Surface added - **Paths:** `/stablecoins`, `/stablecoins/{stablecoinId}`, `/stablecoins/{stablecoinId}/mints`, `/burns`, `/operations`, `/stablecoin-operations/{stablecoinOperationId}`. - **Schemas** (`components/schemas/stablecoins/`): `Stablecoin`, `StablecoinListResponse`, `StablecoinRegisterRequest`, `StablecoinMintRequest`, `StablecoinBurnRequest`, mint/burn source + destination, `StablecoinOperation`, `StablecoinOperation{Type,Status,Destination,ListResponse}`, `StablecoinFundingInstructions`, `StablecoinEstimatedDelivery`, `StablecoinNetwork`, `Stablecoin{Grid,}OperationsStatus`, `StablecoinIssuanceStatus`. - Adds `Error503` (SERVICE_UNAVAILABLE) used by the issuance responses. ## Note on `StablecoinOperation.destination` It is a single merged `StablecoinOperationDestination` object (superset of the mint/burn request destinations), **not** a `oneOf`. A non-discriminated `oneOf[Mint,Burn]` is ambiguous — a burn destination validates as both variants — so the generated SDK raises "Multiple matches found" on every burn operation response. The merged object deserializes unambiguously. ## Supersedes #578 #578 modeled issuance as **quotes** (`/quotes` + `execute`); the shipped server implements **direct** mint/burn operations. This PR reflects what shipped. #578 is being closed. ## Validation Built with `npm run build:openapi` (redocly bundle) and `redocly lint` passes. Draft pending review; a follow-up regenerates webdev's vendored client from this once merged. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

kphurley7 mentioned this pull request Jul 14, 2026

Add stablecoin direct mint/burn issuance API surface #687

Merged

kphurley7 closed this Jul 14, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add stablecoin issuance API surface - #578

Add stablecoin issuance API surface#578
kphurley7 wants to merge 1 commit into
mainfrom
kph/stablecoin-issuance-spec

kphurley7 commented Jun 12, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jun 12, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 12, 2026 •

edited

Loading

Uh oh!

kphurley7 commented Jul 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

kphurley7 commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Verification

Uh oh!

vercel Bot commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✱ Stainless preview builds for grid

Uh oh!

kphurley7 commented Jul 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

kphurley7 commented Jun 12, 2026 •

edited

Loading

vercel Bot commented Jun 12, 2026 •

edited

Loading

github-actions Bot commented Jun 12, 2026 •

edited

Loading