Skip to content

feat: add Base USDC facilitator support - #14

Merged
roger-gan merged 9 commits into
BofAI:mainfrom
boboliu-1010:feat/base-usdc-support
Jul 29, 2026
Merged

feat: add Base USDC facilitator support#14
roger-gan merged 9 commits into
BofAI:mainfrom
boboliu-1010:feat/base-usdc-support

Conversation

@boboliu-1010

Copy link
Copy Markdown
Contributor

Summary

  • register Base Mainnet and Base Sepolia canonical networks and aliases
  • support per-network RPC overrides for EVM facilitator signers
  • add canonical token allowlists at the verify and settle boundaries
  • register Base Sepolia exact USDC without ERC-20 gas-sponsoring extensions
  • document Base Sepolia as enabled and keep Base Mainnet disabled pending separate small-value validation

Base Sepolia defaults

  • network: eip155:84532
  • scheme: exact
  • asset: official USDC 0x036CbD53842c5426634e7929541eC2318f3dCF7e
  • RPC: https://sepolia.base.org
  • gas sponsoring: disabled

Safety

Base asset allowlists are enforced before both verify and settle. Base Mainnet support is registered in the network layer but remains commented out in the example runtime configuration.

Validation

  • npm test — 131 tests passed
  • npm run typecheck
  • npm run lint

@matrix-agent116

Copy link
Copy Markdown

Preparing PR description...

@matrix-agent116

matrix-agent116 commented Jul 28, 2026

Copy link
Copy Markdown

PR Code Suggestions ✨

No code suggestions found for the PR.

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

7 similar comments
@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

Preparing review...

@roger-gan

Copy link
Copy Markdown
Collaborator

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪
🧪 PR contains tests
🔒 No security concerns identified
⚡ Recommended focus areas for review

Mainnet enabled

Base Mainnet is enabled in the production runtime config, despite the PR description stating it must remain disabled pending small-value validation. Deployments using FACILITATOR_SERVICE_ENV=prod will immediately register and settle Base Mainnet payments.

# Base Mainnet
eip155:8453:
  schemes: ["exact", "upto", "batch-settlement"]
Unsupported schemes

Base Sepolia is configured with upto and batch-settlement as well as exact, contradicting the documented Base Sepolia default of exact-only. A dev deployment will advertise and attempt to process these schemes instead of limiting the new network to the validated exact flow.

# Base Sepolia testnet
eip155:84532:
  schemes: ["exact", "upto", "batch-settlement"]

@roger-gan
roger-gan self-requested a review July 29, 2026 06:33
@roger-gan
roger-gan merged commit cc5ee01 into BofAI:main Jul 29, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants