docs: add rule-based accounts guide and document USDC and USDT support by bsiaotickchong · Pull Request #1243 · lightsparkdev/grid-api

bsiaotickchong · 2026-10-27T21:53:51Z

Summary

Adds a concise Rule-Based Accounts guide at payouts-and-b2b/depositing-funds/rule-based-accounts, next to Internal Accounts in the "Managing accounts" nav group. It covers supported currencies, prerequisites, creating an account (USD and USDC tabs), sweep rule fields, tracking sweeps and SWEEP_* failures, and sandbox testing.
Documents USDC and USDT as supported currencies for POST /internal-accounts. The currency field and the endpoint description previously said rule-based accounts were USD only. Adds a usdcDepositAddress request example.
Links the new guide from the Internal Accounts page's next steps.

Notes

A USDC rule-based account returns one deposit address per network the platform supports in fundingPaymentInstructions, not a bank account number. USDC and USDT rule-based accounts are enabled per platform, separately from USD.

Test plan

make build and make lint pass.
Rendered the new page locally with mint dev (4.2.284):

Requested by @bsiaotickchong

Original PR: #1242

vercel · 2026-10-27T21:53:57Z

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

3 Skipped Deployments

Project	Deployment	Actions	Updated
grid-cards-demo	Ignored	Preview	Oct 29, 2026 10:54pm UTC
grid-flow-builder	Ignored	Preview	Oct 29, 2026 10:54pm UTC
grid-wallet-demo	Ignored	Preview	Oct 29, 2026 10:54pm UTC

lightspark-bot · 2026-10-27T21:54:10Z

docs: add rule-based accounts guide and document USDC and USDT support #1243 👈 (View in Graphite)
main

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

mintlify · 2026-10-27T21:54:17Z

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

Project	Status	Preview	Updated
Grid	🟢 Ready	View Preview	Oct 29, 2026, 10:55 PM

greptile-apps · 2026-10-27T21:56:54Z

Confidence Score: 4/5

[Low impact] The PR changes account documentation without changing runtime behavior.

The PR appears safe to merge, with a non-blocking request to document USDC platform enablement in the guide.

Findings

USDC prerequisite is missing ▶

Fix with agent prompt

### Issue 1
mintlify/payouts-and-b2b/depositing-funds/rule-based-accounts.mdx:23
The guide omits that USDC rule-based accounts must be enabled separately for your platform. If a platform lacks that enablement, readers can meet every listed prerequisite and still have account creation rejected. The endpoint description already calls out this requirement; add it here before the creation examples.

```suggestion
- USDC rule-based accounts must be enabled separately for your platform.
- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.
```

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds a rule-based accounts guide and documents USDC support in the OpenAPI source and both bundles.

Developers can follow a guide to set up rule-based accounts.
The account API docs now describe USDC deposit addresses.

_{Reviews (1) · Last reviewed commit: "docs: add rule-based accounts guide and ..." · Reviewed by Greptile}

greptile-apps · 2026-10-27T21:56:57Z

+
+## Prerequisites
+
+- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.


USDC prerequisite is missing

The guide omits that USDC rule-based accounts must be enabled separately for your platform. If a platform lacks that enablement, readers can meet every listed prerequisite and still have account creation rejected. The endpoint description already calls out this requirement; add it here before the creation examples.

Suggested change

- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.

- USDC rule-based accounts must be enabled separately for your platform.

- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.

Prompt To Fix With AI

This is a comment left during a code review. Path: mintlify/payouts-and-b2b/depositing-funds/rule-based-accounts.mdx Line: 23 Comment: **USDC prerequisite is missing** The guide omits that USDC rule-based accounts must be enabled separately for your platform. If a platform lacks that enablement, readers can meet every listed prerequisite and still have account creation rejected. The endpoint description already calls out this requirement; add it here before the creation examples. ```suggestion - USDC rule-based accounts must be enabled separately for your platform. - The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed. ``` --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Leaving this out on purpose: the PR owner asked for the platform-enablement note to be removed from the guide, and the endpoint reference still covers it.

🤖 reinforced-asteroid-v6 (#1) | Feedback

ls-bolt · 2026-10-27T21:57:32Z

⚡ Review ledger

Round 1

USDC prerequisite (platform enablement) missing from guide → NOT APPLICABLE: removed at the PR owner's request; the endpoint description still states it

Round 2

Is USDT / USDB supported? → ANSWERED: USDT is gated and USDB-sweep-only, so it's left out pending reviewer's call; USDB isn't a rule-based account currency

Round 3

USDT / USDB follow-up (@bsiaotickchong) → NOT APPLICABLE: guide stays USD + USDC; USDT documentation deferred to the USDT → USDB work

Round 4

Why would USDT need new flow runs? (@jklein24) → ANSWERED: paycore already accepts USDT; the USDB-only limit is a sparkcore validation plus gate. No docs change

jklein24 · 2026-10-27T22:28:30Z

+| Currency | What payers send to |
+|----------|---------------------|
+| `USD` | A dedicated US bank account and routing number |
+| `USDC` | A dedicated deposit address on each supported network for your platform (for example, Solana or Base) |


Is USDT not supported? Why not if USDC is? What about USDB?

USDT works, but only behind a separate gate and only when it sweeps into the holder's own USDB embedded wallet. I left it out because that's a much narrower case than USDC. USDB isn't accepted as a rule-based account currency (it returns a 400); it only appears as a sweep destination. Want me to add a USDT row that states the USDB-only restriction?

🤖 reinforced-asteroid-v6 (#1) | Feedback

yeah USDT to USDB was what @kphurley7 was working on i think?

basically I was just prioritizing USDC with my work, additional currencies just need additional flow runs i think but can be added

Makes sense, so I'm keeping the guide to USD and USDC for now. A USDT row can be added alongside the USDT → USDB work once it's ready to document.

🤖 reinforced-asteroid-v6 (#1) | Feedback

Why would it need new flow runs if it's just the asset changing? I think all of the existing fireblocks actions can take any asset param

From the code, paycore's rule-based deposit-address creation already accepts both USDC and USDT. The limit is a check in sparkcore's rule_based_accounts.py that only lets USDT sweep into the holder's USDB wallet, behind GRID_RULE_BASED_USDB_SWEEPS_ENABLED. Widening USDT looks like lifting that check, not adding new flow runs, though Brian may know of a settlement gap I can't see.

🤖 reinforced-asteroid-v6 (#1) | Feedback

ah i spoke too soon i'll look into removing that restriction

ls-bolt · 2026-10-27T22:30:17Z

🦣 Congratulations @jklein24 - your substantive review earned a Siberian unicorn! (rare)

This giant grazing rhinoceros carried a huge domed boss that supported a horn.

View your Frost-dex: https://zeus.dev.dev.sparkinfra.net/#/dinodex/jklein24?section=ice-age

ls-bolt · 2026-10-28T00:46:13Z

📌 Bolt Status

2026-10-28 00:46:13 UTC — ⚡ Agent reinforced-asteroid-v6-2(#2) started

Feedback

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

ls-bolt · 2026-10-29T22:22:50Z

⚡ Review rounds — updated in place, latest first.

Round 2 · `1fa8788`

Removed the USDT sweep-destination limit from the guide, the currency field, the endpoint description, and the 400 reasons, per @bsiaotickchong
Refreshed the PR description screenshot
Verified: make build and make lint pass; removal-only change, so no adversarial review rerun

Earlier rounds (1)

Round 1 · `6d1ebbf`

Commits

c5a1168 docs: add rule-based accounts guide and document USDC support
6d1ebbf docs: document USDT rule-based accounts
Rebased onto main
Documented USDT rule-based accounts in the guide's currency table and in POST /internal-accounts (currency field, endpoint description, 400 reasons), including which destinations a USDT account can sweep to
Verified: make build and make lint pass; adversarial review found nothing actionable

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

ls-bolt Bot added the bolt label Oct 27, 2026

ls-bolt Bot mentioned this pull request Oct 27, 2026

docs: add rule-based accounts guide and document USDC support #1242

Closed

mintlify Bot deployed to staging - mintlify October 27, 2026 21:54

View deployment

greptile-apps Bot reviewed Oct 27, 2026

View reviewed changes

jklein24 reviewed Oct 27, 2026

View reviewed changes

bsiaotickchong and others added 2 commits October 29, 2026 22:21

docs: add rule-based accounts guide and document USDC support

c5a1168

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs: document USDT rule-based accounts

6d1ebbf

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

ls-bolt Bot force-pushed the 10-27-rule-based-accounts-guide branch from 548fd24 to 6d1ebbf Compare October 29, 2026 22:22

ls-bolt Bot changed the title ~~docs: add rule-based accounts guide and document USDC support~~ docs: add rule-based accounts guide and document USDC and USDT support Oct 29, 2026

mintlify Bot deployed to staging - mintlify October 29, 2026 22:23

View deployment

docs: drop USDT sweep destination limit from rule-based account docs

1fa8788

Co-Authored-By: bsiaotickchong <bsiaotickchong@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mintlify Bot deployed to staging - mintlify October 29, 2026 22:55

View deployment

jklein24 approved these changes Oct 30, 2026

View reviewed changes

bsiaotickchong merged commit 83ca320 into main Oct 30, 2026
9 checks passed

bsiaotickchong deleted the 10-27-rule-based-accounts-guide branch October 30, 2026 00:34

claude Bot mentioned this pull request Oct 30, 2026

docs: include USDT in rule-based accounts FeatureCard #1259

Open

1 task


		## Prerequisites

		- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.

	- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.
	- USDC rule-based accounts must be enabled separately for your platform.
	- The account holder already has an internal account in the same currency. Funds go there when a sweep can't be completed.

Conversation

bsiaotickchong commented Oct 27, 2026 • edited by ls-bolt Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Notes

Test plan

Uh oh!

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

Uh oh!

Uh oh!

lightspark-bot commented Oct 27, 2026

Uh oh!

mintlify Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 4/5

Findings

Summary

Uh oh!

greptile-apps Bot Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Round 1

Round 2

Round 3

Round 4

Uh oh!

jklein24 Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

bsiaotickchong Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

jklein24 Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot Oct 27, 2026

Choose a reason for hiding this comment

Uh oh!

bsiaotickchong Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

ls-bolt Bot commented Oct 27, 2026

Uh oh!

ls-bolt Bot commented Oct 28, 2026

Uh oh!

ls-bolt Bot commented Oct 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Round 2 · 1fa8788

Round 1 · 6d1ebbf

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

bsiaotickchong commented Oct 27, 2026 •

edited by ls-bolt Bot

Loading

vercel Bot commented Oct 27, 2026 •

edited

Loading

mintlify Bot commented Oct 27, 2026 •

edited

Loading

greptile-apps Bot commented Oct 27, 2026 •

edited

Loading

ls-bolt Bot commented Oct 27, 2026 •

edited

Loading

ls-bolt Bot commented Oct 29, 2026 •

edited

Loading

Round 2 · `1fa8788`

Round 1 · `6d1ebbf`