Skip to content

docs: add a Compatibility section to the README - #44

Merged
isaacdoidge merged 1 commit into
masterfrom
docs/node-compatibility
Nov 4, 2026
Merged

isaacdoidge merged 1 commit into
masterfrom
docs/node-compatibility

Conversation

@isaacdoidge

Copy link
Copy Markdown
Collaborator

What

A ## Compatibility section in the README, after Installation:

  • The node releases the SDK is tested against: supra_node_v11.7.2 (Mainnet and Testnet) and
    supra_node_v12.0.0.rc7 (Devnet). These are the releases the three networks' public RPC nodes run today. The SDK
    calls /rpc/v3 only.
  • A table of the methods and parameters that need a v12 node, with what a v11.7.2 node does instead:
    account_history / iter_account_history, the settlement value of transaction_type, the release field of
    version(), and sequence_number=0 for a sponsored sender without an account. Each row comes from the method's
    docstring on master.
  • Pointers to the existing README sections and docstrings for the other differences: where an account holds SUPRA,
    how a feed ends, and the error for a missing account.

The section names no SDK version; the 0.2.0 release PR adds it.

Test run behind the statement

On master e795c09, unchanged, against fresh localnets of each release (chain ID 255):

supra_node_v12.0.0.rc7 supra_node_v11.7.2
make test-unit with SUPRA_RPC_URL (node-backed tests included) 397 run, 0 failed, 0 skipped 397 run, 0 failed, 0 skipped
make examples (all 14) passed (see below) passed
examples/fungible_asset.py migration step skipped (SUPRA already in the primary store) migration step ran, then transfer and account_fa_transactions

On rc7 the first make examples run exited with a failure in your_coin, whose traceback was not captured. The rc7
node's error log is empty and its access log has no unexpected status. Two further full runs (all 14; and 13 with
EXAMPLES_EXCLUDE=faucet from a funded key) and your_coin on its own passed.

Checks

make fmt-check, make lint, make typecheck, make test-unit (397 tests, OK, 26 node-backed skipped),
make test-spec (248 scenarios), make build: pass.

🤖 Generated with Claude Code

State the node releases the SDK is tested against (supra_node_v11.7.2 and
supra_node_v12.0.0.rc7), that it calls /rpc/v3 only, and which methods and
parameters need a v12 node, with what a v11.7.2 node does instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@isaacdoidge
isaacdoidge merged commit cb656c8 into master Nov 4, 2026
5 checks passed
@isaacdoidge
isaacdoidge deleted the docs/node-compatibility branch November 4, 2026 03:45
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