Skip to content

Add Plasma (PLASMA_WALLET) to Grid public API schema#724

Draft
ls-bolt[bot] wants to merge 1 commit into
mainfrom
07-22-plasma-wallet-public-schema
Draft

Add Plasma (PLASMA_WALLET) to Grid public API schema#724
ls-bolt[bot] wants to merge 1 commit into
mainfrom
07-22-plasma-wallet-public-schema

Conversation

@ls-bolt

@ls-bolt ls-bolt Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds the public Plasma wallet type to the Grid API, mirroring the existing Tron wallet. Plasma is an EVM chain, so wallets use 0x addresses and the asset is USDT.

Changes

  • New schemas: PlasmaWalletInfo, PaymentPlasmaWalletInfo (asset USDT), PlasmaWalletExternalAccountInfo
  • PLASMA_WALLET added to PaymentAccountType and ExternalAccountType
  • PLASMA added to CryptoNetwork
  • PLASMA_WALLET wired into the external-account and payment-instructions discriminator unions
  • Plasma stablecoin-funding example added to the internal-accounts docs snippet
  • .stainless/stainless.yml synced; make build rebundled openapi.yaml + mintlify/openapi.yaml; make lint-openapi clean

Draft: this is the public surface for USDT-on-Plasma and lands only when we choose to expose Plasma to integrators. The webdev client is regenerated from this schema in a companion PR.

Requested by @jklein24

Add the public Plasma wallet type (EVM 0x address, USDT asset) mirroring the
existing Tron wallet: PlasmaWalletInfo, PaymentPlasmaWalletInfo, and
PlasmaWalletExternalAccountInfo, plus PLASMA_WALLET in the account-type enums,
PLASMA in CryptoNetwork, and the external-account and payment-instructions
discriminator unions. Includes docs and .stainless sync; make build rebundled.
@vercel

vercel Bot commented Jul 22, 2026

Copy link
Copy Markdown

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

2 Skipped Deployments
Project Deployment Actions Updated (UTC)
grid-flow-builder Ignored Ignored Preview Jul 22, 2026 8:08am
grid-wallet-demo Ignored Ignored Preview Jul 22, 2026 8:08am

Request Review

@ls-bolt ls-bolt Bot added the bolt label Jul 22, 2026
@github-actions github-actions Bot added the breaking-change Introduces a breaking change to the OpenAPI spec label Jul 22, 2026

akanter commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

✱ 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

go

chore(internal): regenerate SDK with no functional changes

kotlin

feat(api): add PlasmaWalletInfo model to customers external accounts

openapi

feat(api): add Plasma wallet and blockchain network support

php

chore(internal): regenerate SDK with no functional changes

python

feat(api): add PlasmaWalletInfo to customers

ruby

feat(api): add PlasmaWalletInfo to customers

typescript

feat(api): add PlasmaWalletInfo type to external-accounts

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

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 ✅lint ❗test ✅

npm install https://pkg.stainless.com/s/grid-typescript/92fa0506ea8dd1da517012b9598f92fb8e8b7b1f/dist.tar.gz
New diagnostics (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 ✅lint ✅test ✅

New diagnostics (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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@7deb85ce87cab4dd6fcdbe44cf531ac99b1d1da4
New diagnostics (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 ✅lint ✅test ❗

New diagnostics (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 ✅lint ❗test ❗

pip install https://pkg.stainless.com/s/grid-python/abaa5dc0f5f1b5593303098bd4dfdd0111096de7/grid-0.0.1-py3-none-any.whl
New diagnostics (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema
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 (2 note)
💡 Schema/IsAmbiguous: Missing type for schema
💡 Schema/IsAmbiguous: Missing type for schema

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-07-22 08:14:02 UTC

@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Jul 22, 2026, 8:10 AM

@ls-bolt

ls-bolt Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

⚡ Heads up on the red Detect breaking changes check — this is expected and by design for adding a new wallet type. All 45 findings are response-property-one-of-added: PaymentPlasmaWalletInfo / PlasmaWalletExternalAccountInfo being added to the accountOrWalletInfo / accountInfo response oneOf unions (funding instructions, external accounts, transactions). It's the same additive-union change that adding Tron/Base/Polygon would have flagged — nothing is removed or narrowed.

The workflow's design is to label such PRs breaking-change and require an API-reviewer's sign-off rather than hard-block, which fits how we're treating this: the PR stays a draft and is held until we decide to expose Plasma publicly. Flagging for the API reviewer to confirm whether this rides the current API version or warrants a version bump when it ships.

Review response generated using an automated agent.

@mintlify

mintlify Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Grid 🟡 Building Jul 22, 2026, 8:08 AM

@ls-bolt

ls-bolt Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

@greptile review

@greptile-apps

greptile-apps Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds Plasma wallet support to the public Grid API. The main changes are:

  • New Plasma payment and external-account schemas.
  • Plasma entries in wallet types, network enums, unions, and discriminators.
  • Updated Stainless configuration and generated OpenAPI bundles.
  • A Plasma USDT funding example in the internal-account documentation.

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.

Important Files Changed

Filename Overview
openapi/components/schemas/common/PaymentPlasmaWalletInfo.yaml Adds the USDT payment schema for Plasma wallets.
openapi/components/schemas/common/PlasmaWalletInfo.yaml Defines the Plasma wallet discriminator and address.
openapi/components/schemas/common/PaymentInstructions.yaml Adds Plasma to the payment instruction union and discriminator.
openapi/components/schemas/external_accounts/PlasmaWalletExternalAccountInfo.yaml Adds the Plasma external-account schema.
openapi/components/schemas/external_accounts/ExternalAccountCreateInfoOneOf.yaml Adds Plasma to the external-account creation union and discriminator.
openapi/components/schemas/external_accounts/ExternalAccountInfoOneOf.yaml Adds Plasma to the external-account response union and discriminator.
.stainless/stainless.yml Registers the Plasma schemas for SDK generation.
mintlify/snippets/internal-accounts.mdx Documents Plasma USDT funding instructions.
openapi.yaml Updates the generated public OpenAPI bundle with Plasma support.
mintlify/openapi.yaml Updates the generated Mintlify OpenAPI bundle with Plasma support.

Reviews (2): Last reviewed commit: "feat: add Plasma (PLASMA_WALLET) to Grid..." | Re-trigger Greptile

Comment thread openapi/components/schemas/common/PaymentPlasmaWalletInfo.yaml
@ls-bolt

ls-bolt Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

@greptile review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bolt breaking-change Introduces a breaking change to the OpenAPI spec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants