Skip to content

feat: add VASP directory endpoint - #827

Draft
shreyav wants to merge 3 commits into
mainfrom
shreyav/vasps-directory
Draft

feat: add VASP directory endpoint#827
shreyav wants to merge 3 commits into
mainfrom
shreyav/vasps-directory

Conversation

@shreyav

@shreyav shreyav commented Aug 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

Adds a VASP directory: GET /vasps, searchable by name with cursor pagination. Each entry is { vaspName, displayName }, mirroring the discovery pattern (/discoveries returns bankName + displayName): vaspName is the canonical value a platform passes back when declaring a VASP-hosted counterparty; displayName is for UI.

This is PR 1 of 3 for VASP counterparty support (Travel Rule):

  1. This PR — /vasps directory
  2. feat: add beneficiary to crypto wallet external accounts #828 — beneficiary on crypto-wallet external accounts (reusing the fiat beneficiary model)
  3. feat: add custody type and VASP link to external accounts #829 — custodyType/vaspName on external accounts + COUNTERPARTY_USER_INFO_REQUIRED error

Changes

  • GET /vasps (search, limit, cursor) under a new VASPs tag
  • Vasp and VaspListResponse schemas (standard list-response shape)
  • Stainless vasps resource block (list method) so the endpoint flows into the documented spec and SDKs
  • Sidebar icon (globe) for the VASPs group in the Mintlify API reference

Testing

make build bundles cleanly; redocly lint and spectral lint match the pre-existing baseline on main exactly (no new findings).

🤖 Generated with Claude Code

@mintlify

mintlify Bot commented Aug 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview Aug 13, 2026, 9:10 PM

@vercel

vercel Bot commented Aug 13, 2026 •
edited
Loading

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 Aug 14, 2026 5:45pm
grid-wallet-demo Ignored Ignored Preview Aug 14, 2026 5:45pm

Request Review

@github-actions github-actions Bot added the breaking-change Introduces a breaking change to the OpenAPI spec label Aug 13, 2026
@github-actions

github-actions Bot commented Aug 13, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

✱ Stainless preview builds for grid

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

cli

feat(api): add vasps list endpoint

go

feat(api): add vasps resource with list endpoint

kotlin

feat(api): add vasps resource

openapi

feat(api): add VASPs resource with list endpoint

php

feat(api): add vasps resource

python

feat(api): add vasps resource

ruby

feat(api): add vasps resource

typescript

feat(api): add vasps resource

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 "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ✅

npm install https://pkg.stainless.com/s/grid-typescript/ac579ef1951ddafb59e61b7febc664aa8f2d1cc8/dist.tar.gz
✅ grid-openapi studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️

✅ grid-ruby studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ✅ → test ✅

✅ grid-go studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

go get github.com/stainless-sdks/grid-go@853db3a3d1d527b3c6361a34b49c1d6a17a045a4
✅ grid-kotlin studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ✅ → lint ✅ → test ❗

✅ grid-python studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → build ✅ → lint ❗ → test ❗

pip install https://pkg.stainless.com/s/grid-python/e71f525b127dafd70fc3b7be2f8dd55e23c40cfe/grid-0.0.1-py3-none-any.whl
✅ grid-php studio · code · diff

Your SDK build had at least one "note" diagnostic, but this did not represent a regression.
generate ✅ → lint ✅ → test ✅

✅ grid-cli studio · code · diff

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
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-08-14 17:52:45 UTC

This was referenced Aug 13, 2026
Merged
Draft
@github-actions github-actions Bot removed the breaking-change Introduces a breaking change to the OpenAPI spec label Aug 14, 2026
shreyav added a commit that referenced this pull request Aug 14, 2026
@shreyav
feat: add beneficiary to crypto wallet external accounts (#828)
3ad6a07 
## Summary

Crypto-wallet external accounts were the only account family without a
`beneficiary`. This PR adds one, following the fiat pattern — an
`INDIVIDUAL`/`BUSINESS` `oneOf` discriminated by `beneficiaryType`.

The beneficiary identifies who owns the wallet — the counterparty
identity needed for Travel Rule data, independent of custody.

This is PR 2 of 3 for VASP counterparty support (Travel Rule):
1. #827 — `/vasps` directory
2. **This PR** — `beneficiary` on crypto-wallet external accounts
3. #829 — `custodyType`/`vaspName` on external accounts

### Field requirements: exactly what is transmitted
The individual variant is a new `WalletIndividualBeneficiary` with only
**`fullName` + `countryOfResidence`** (both required) — the exact set
transmitted as Travel Rule counterparty info. The generic
`IndividualBeneficiary` couldn't be reused because it *requires*
`birthDate`/`nationality`, which are never transmitted for wallets and
would force platforms to collect a third party's date of birth (OpenAPI
composition can't relax `required`). Optional PII fields were
deliberately omitted: adding optional fields later is non-breaking,
while accepting-but-ignoring PII invites needless collection. The
`BUSINESS` variant reuses the existing `BusinessBeneficiary`
(`legalName` required).

### Semantics (one deliberate divergence from fiat)
- Fiat accounts require `beneficiary`. For wallets it is **optional for
`FIRST_PARTY`** — when omitted, the customer's verified identity is
used, so the dominant own-wallet case sends nothing extra.
- **Required for `THIRD_PARTY`** wallets on platforms subject to
counterparty requirements (e.g., EU Travel Rule and similar regimes) —
enforced at runtime with `400 INVALID_INPUT`, not in the schema, since
the requirement is platform-dependent.

### Changes
- New `WalletBeneficiaryFields` fragment (the `beneficiary` property)
composed into all seven wallet variants: `BASE_WALLET`,
`ETHEREUM_WALLET`, `POLYGON_WALLET`, `PLASMA_WALLET`, `SOLANA_WALLET`,
`SPARK_WALLET`, `TRON_WALLET`
- New `WalletBeneficiaryOneOf` — the named individual/business union
(matches the `*OneOf` house convention)
- New `WalletIndividualBeneficiary` schema (`fullName` +
`countryOfResidence`)
- Stainless model entries for all three

### Out of scope
- `LIGHTNING` external accounts — Travel Rule counterparty identity for
Lightning flows in-band (payment-level), not via a stored account
beneficiary. Flagging in case reviewers feel otherwise.

## Testing
`make build` bundles cleanly; `redocly lint` and `spectral lint` match
the pre-existing baseline on `main` exactly (no new findings).

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@shreyav @claude