Skip to content

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

Merged
jklein24 merged 1 commit into
mainfrom
07-22-plasma-wallet-public-schema
Jul 30, 2026
Merged

Add Plasma (PLASMA_WALLET) to Grid public API schema#724
jklein24 merged 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
⚠️ grid-openapi studio · code

Your SDK build had at least one "warning" diagnostic.
generate ⚠️

grid-ruby studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅build ✅lint ✅test ✅

⚠️ grid-go studio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅build ⏭️lint ❗test ❗

go get github.com/stainless-sdks/grid-go@f3f039b7ef57940e6e5b446f23f6959ba0929bef
⚠️ grid-kotlin studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️build ✅lint ✅test ❗

⚠️ grid-python studio · code

Your SDK build had a failure in the lint CI job, which is a regression from the base state.
generate ✅build ✅lint ❗test ❗

pip install https://pkg.stainless.com/s/grid-python/86cf946348fba3f456cd163a46e425a8d20b0278/grid-0.0.1-py3-none-any.whl
grid-typescript studio · conflict

Your SDK build had at least one note diagnostic.

grid-php studio · code

Your SDK build had at least one "note" diagnostic.
generate ✅lint ✅test ✅

⚠️ grid-cli studio · code

Your SDK build had a failure in the test CI job, which is a regression from the base state.
generate ⚠️build ⏭️lint ⏭️test ❗


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-30 02:06:54 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 extends the Grid public API schema with a new PLASMA_WALLET wallet type (Plasma is an EVM L2 chain supporting USDT), following the exact same three-file pattern used by the existing Tron, Polygon, Base, and Ethereum wallets. The bundled openapi.yaml and mintlify/openapi.yaml outputs are consistent with the modular source, and make lint-openapi is clean.

  • PlasmaWalletInfo, PaymentPlasmaWalletInfo, and PlasmaWalletExternalAccountInfo schemas are added and wired into all four discriminator unions (PaymentInstructions, ExternalAccountInfoOneOf, ExternalAccountCreateInfoOneOf, and the Stainless SDK config).
  • PLASMA_WALLET is registered in both PaymentAccountType and ExternalAccountType; PLASMA is registered in CryptoNetwork.
  • A Mintlify docs snippet demonstrating Plasma stablecoin funding is added to mintlify/snippets/internal-accounts.mdx.

Confidence Score: 5/5

This PR is safe to merge — it is a purely additive schema extension with no changes to existing behavior.

The change adds new enum values and new schemas that are completely backwards-compatible. Every new artifact follows the exact same three-file composition pattern already used by Tron, Polygon, Base, and Ethereum wallets. All four discriminator unions are updated consistently, and the bundled outputs match the source. The docs snippet is accurate to the schema. No existing types or values are modified.

Files Needing Attention: No files require special attention.

Important Files Changed

Filename Overview
openapi/components/schemas/common/PlasmaWalletInfo.yaml New base wallet info schema; mirrors TronWalletInfo exactly with correct required fields and EVM-style 0x address example.
openapi/components/schemas/common/PaymentPlasmaWalletInfo.yaml New payment instruction schema; correctly composes BasePaymentAccountInfo + PlasmaWalletInfo with optional assetType: USDT, consistent with all sibling wallet types.
openapi/components/schemas/external_accounts/PlasmaWalletExternalAccountInfo.yaml New external account info schema composing BaseExternalAccountInfo + PlasmaWalletInfo; exact mirror of TronWalletExternalAccountInfo.
openapi/components/schemas/common/PaymentInstructions.yaml PLASMA_WALLET added to both the oneOf array and discriminator mapping; consistent with all other wallet additions.
openapi/components/schemas/external_accounts/ExternalAccountInfoOneOf.yaml PlasmaWalletExternalAccountInfo added to oneOf and discriminator mapping correctly.
openapi/components/schemas/external_accounts/ExternalAccountCreateInfoOneOf.yaml PlasmaWalletExternalAccountInfo added to oneOf and discriminator mapping correctly.
.stainless/stainless.yml plasma_wallet_info resource mapping and allOf[0] strip entries added; mirrors the Tron and Polygon wallet entries exactly.
mintlify/snippets/internal-accounts.mdx Plasma Stablecoin Funding accordion added with correct accountType, assetType, and address fields matching the new schema.
openapi/components/schemas/crypto/CryptoNetwork.yaml PLASMA added to the CryptoNetwork enum, correctly placed between TRON and SPARK.

Reviews (3): 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

@jklein24
jklein24 marked this pull request as ready for review July 29, 2026 23:43
@jklein24
jklein24 requested a review from shreyav July 29, 2026 23:44
@ls-bolt

ls-bolt Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor Author

📌 Bolt Status

2026-07-29 23:47:47 UTC — ⚡ Agent chained-parapet-9(#9) started


Feedback

@jklein24
jklein24 merged commit 927ce42 into main Jul 30, 2026
12 of 13 checks passed
@jklein24
jklein24 deleted the 07-22-plasma-wallet-public-schema branch July 30, 2026 02:00
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.

3 participants