Skip to content

feat(faucet): add validated token catalog and funding strategies - #51

Merged
ameya-deshmukh merged 3 commits into
seismicfrom
codex/corn-multi-usdc
Sep 28, 2026
Merged

ameya-deshmukh merged 3 commits into
seismicfrom
codex/corn-multi-usdc

Conversation

@ameya-deshmukh

@ameya-deshmukh ameya-deshmukh commented Sep 28, 2026 •

Copy link
Copy Markdown
Collaborator

Sandbox integrations may use different settlement tokens while Base funding currently has one USDC identity. This first slice adds a validated token catalog and explicit funding strategies, preserving the default identity and existing endpoints.

Closes https://linear.app/seismic-systems/issue/SEI-662

  • Load additional tokens from a deployment-managed JSON file selected by INTERNAL_FUNDING_BASE_TOKEN_CATALOG_FILE; include a generic two-token example and ignore the local deployment catalog.
  • Validate the file at startup, including contract uniqueness, decimals, budgets, and bounded mint calls. An unset path preserves defaults; unreadable or invalid configuration makes Base unavailable with a diagnostic. Restart to apply catalog edits.
  • Plan caller-only whole-token minting (tested with six decimals and a 100-token per-call limit); report manual funding when inventory cannot replenish automatically.
  • Keep additional tokens inactive until the follow-up adds contract-aware requests, execution, and durable retry recovery.

Before

flowchart LR
  A[Base config] --> B[One default USDC identity]
  B --> C[Existing funding endpoints]
Loading

After

flowchart LR
  A[Existing Base config] --> B[Legacy default USDC]
  C[Optional token catalog JSON file] --> D[Validated catalog]
  B --> D
  D --> E{Funding strategy}
  E --> F[Manual inventory]
  E --> G[Bounded whole-token mint plan]
  G -. Future runtime PR .-> H[Persist, submit, confirm, then transfer]
Loading

Validation: Rust 1.88 workspace fmt, clippy with warnings denied, locked tests (including Redis integration), and release build passed. No on-chain transaction submitted.

This foundation can merge independently. Contract-aware endpoints, mint execution, and durable retry recovery will follow in a separate PR. Additional settlement tokens remain inactive until that runtime support is deployed.

@linear-code

linear-code Bot commented Sep 28, 2026

Copy link
Copy Markdown

SEI-662

@ameya-deshmukh
ameya-deshmukh marked this pull request as ready for review September 28, 2026 12:42
@ameya-deshmukh
ameya-deshmukh merged commit d1fc21e into seismic Sep 28, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant