Skip to content

docs: add integration note for SKALE network upstream blocker#486

Open
Prateekiiitg56 wants to merge 8 commits intoGetBindu:mainfrom
Prateekiiitg56:Multiple-Payment
Open

docs: add integration note for SKALE network upstream blocker#486
Prateekiiitg56 wants to merge 8 commits intoGetBindu:mainfrom
Prateekiiitg56:Multiple-Payment

Conversation

@Prateekiiitg56
Copy link
Copy Markdown
Contributor

@Prateekiiitg56 Prateekiiitg56 commented Apr 20, 2026

Summary

In PR #342, I added support for defining multiple payment options by allowing execution_cost to accept a list. While the Bindu agent framework is now completely future-ready to handle any combination of networks and assets (like SKALE or Ethereum), direct SKALE support is currently blocked by an upstream dependency.

This PR adds an Integration Note to the payments documentation explaining that limitation.

Problem

The upstream coinbase/x402 python package (which Bindu uses to format the payment headers) uses a hardcoded list of SupportedNetworks. If an agent configures "network": "skale-europa", the upstream package crashes before the payment can be routed because it does not recognize the chain ID or token contract.

Changes

  • docs/PAYMENT.md
    • Added documentation showing how to use the new multi-option execution_cost arrays (from PR Multi-Option - Let Agents Accept Multiple Payment Currencies #342).
    • Added a Integration Note: SKALE Network Support (Pending / Upstream Blocker) section.
    • Explicitly documents that while Bindu's config is ready, users must restrict network values to those natively supported by x402 (e.g. base, ethereum) until an upstream contribution or a controlled local bypass is merged.

Linked Issue/PR

Checklist

  • Documentation updated
  • Human verification completed

Summary by CodeRabbit

  • Documentation
    • Added an integration note: SKALE network support is currently pending due to upstream network validation; restrict execution_cost.network to recognized networks with configured RPC URLs (examples: base, base-sepolia, ethereum). Other networks may require additional RPC setup; tracking upstream resolution or local patch options.
  • Tests
    • Marked certain hardcoded payment addresses in tests as allowlisted secrets for test hygiene.

Copilot AI review requested due to automatic review settings April 20, 2026 13:58
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 20, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Added a docs note on SKALE network support limitations due to upstream x402 hardcoded networks, and annotated hardcoded pay_to_address literals in a unit test with # pragma: allowlist secret.

Changes

Cohort / File(s) Summary
Documentation Update
docs/PAYMENT.md
Added "Integration Note: SKALE Network Support (Pending / Upstream Blocker)" explaining that execution_cost[].network values must match networks recognized by upstream x402 (hardcoded SupportedNetworks); SKALE identifiers will cause process_price_to_atomic_amount to fail until upstream or local fixes and RPC configuration in Bindu are applied.
Test Annotation
tests/unit/test_execution_cost_multi_option.py
Appended # pragma: allowlist secret inline comments to hardcoded pay_to_address string literals in _SINGLE_COST, _COST_ETH, and the test_backward_compat_flat_args call. No functional changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 I thumped a note upon the page,

SKALE skips past the upstream cage,
x402 keeps lists so tight,
I nudge configs by moonlight,
Patch or wait — I'll hop with glee.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description addresses the core problem and change, but omits several required template sections such as Change Type, Scope, Security Impact, Verification, and Human Verification details. Complete the missing template sections: mark Change Type (Documentation), Scope (Documentation), verify Security Impact section, and provide specific Human Verification details about what was tested.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main change: adding documentation about an upstream blocker for SKALE network support.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation clarifying that SKALE network usage is currently blocked by upstream coinbase/x402 network validation, despite Bindu supporting multi-option execution_cost configs.

Changes:

  • Adds an “Integration Note” section documenting SKALE support as pending due to upstream x402 limitations.
  • Calls out that network values must be limited to what upstream x402 recognizes (until upstream is updated or a local workaround exists).

Comment thread docs/PAYMENT.md Outdated
Comment thread docs/PAYMENT.md Outdated
Comment thread docs/PAYMENT.md Outdated
Comment thread docs/PAYMENT.md
Prateekiiitg56 and others added 2 commits April 20, 2026 19:33
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
docs/PAYMENT.md (1)

107-107: Link to x402 supported networks documentation instead of hardcoding examples.

The x402 library is actively evolving (current version 2.7.0; project uses early-alpha 0.2.1), so hardcoded network examples like base, base-sepolia, ethereum, and polygon may become outdated. Reference the CDP facilitator's official network support documentation at https://docs.cdp.coinbase.com/x402/network-support instead, which maintains the authoritative list.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/PAYMENT.md` at line 107, Replace the hardcoded network examples in the
line that mentions restricting `network` values (the bullet referencing
`network` values such as `base`, `base-sepolia`, `ethereum`, `polygon`) with a
single clear instruction to rely on the upstream x402 supported networks and add
the authoritative link: "Refer to x402 network support:
https://docs.cdp.coinbase.com/x402/network-support" so the doc points readers to
the live, maintained list instead of listing example networks.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/PAYMENT.md`:
- Line 107: Replace the hardcoded network examples in the line that mentions
restricting `network` values (the bullet referencing `network` values such as
`base`, `base-sepolia`, `ethereum`, `polygon`) with a single clear instruction
to rely on the upstream x402 supported networks and add the authoritative link:
"Refer to x402 network support:
https://docs.cdp.coinbase.com/x402/network-support" so the doc points readers to
the live, maintained list instead of listing example networks.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: eb01915f-e29b-443f-96f1-ac22f0560743

📥 Commits

Reviewing files that changed from the base of the PR and between aa3c420 and dbb3145.

📒 Files selected for processing (1)
  • docs/PAYMENT.md

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.

2 participants