[codex] Add Binance index-kline price feed E2E

[ByteYue]

Summary

This PR adds an SDK E2E suite for the Gravity oracle price-feed rail using Binance USD-M indexPriceKlines semantics:

• Bumps the gravity-reth dependency to the relayer-backed Binance continuous bucket PoC commit.
• Replaces the old hype_price_feed suite with binance_price_feed.
• Registers two continuous sourceType=3 tasks through governance:
  • feedId=1001: provider=binance_index_kline_v1&pair=NVDAUSDT&interval=1m&continuous=true.
  • feedId=1002: provider=binance_index_kline_v1&pair=TSLAUSDT&interval=1m&continuous=true.
• Keeps the deterministic local mock as the default E2E path for byte-identical validator payloads.
• Adds BINANCE_PRICE_FEED_MODE=live for manual demos that fetch Binance public indexPriceKlines closed 1-minute buckets directly.
• Deploys MultiSourceOracleResolver, wires it as the NativeOracle default callback, waits for the short epoch to rebuild relayer-backed JWK observers, and verifies resolver writes.
• Adds demo runner support with --keep-running and --demo-config-out, so the local chain can stay alive for a frontend demo after assertions pass.

How to run the deterministic E2E

Build the quick-release binaries, then run the suite:

make BINARY=gravity_node MODE=quick-release
make BINARY=gravity_cli MODE=quick-release
PATH="$HOME/.foundry/bin:$PWD/target/quick-release:$PATH" \
  ./gravity_e2e/run_test.sh binance_price_feed --force-init --log-cli-level=INFO

This mode starts a local deterministic /fapi/v1/indexPriceKlines mock and still makes the relayer use the Binance adapter request shape: pair, interval, startTime, endTime, and limit=1.

How to run the mock frontend demo backend

Use keep-running mode and write a frontend-readable runtime config:

PATH="$HOME/.foundry/bin:$PWD/target/quick-release:$PATH" \
  ./gravity_e2e/run_test.sh binance_price_feed \
    --force-init \
    --keep-running \
    --demo-config-out ../gravity_price_feed_demo_web/public/demo-config.json \
    --log-cli-level=INFO

Expected output includes:

Binance price feed resolved: feedId=1001 deliveryNonce=3 roundId=29720877 price=19612645000
Binance price feed resolved: feedId=1002 deliveryNonce=3 roundId=29720877 price=40117545000
Wrote price feed demo config to ../gravity_price_feed_demo_web/public/demo-config.json
PASSED
Suite binance_price_feed PASSED
All suites passed!
Demo keep-running mode enabled; cluster left running.

After that, the local Gravity RPC and deterministic Binance mock keep running. The web demo reads the generated config, proxies JSON-RPC through /rpc, and renders continuously updating resolver state.

Stop commands:

bash cluster/stop.sh --config gravity_e2e/cluster_test_cases/binance_price_feed/cluster.toml
kill "$(cat gravity_e2e/cluster_test_cases/binance_price_feed/artifacts/mock_binance.pid)"

How to run the live Binance demo backend

For a pure manual demo, set live mode:

BINANCE_PRICE_FEED_MODE=live \
BINANCE_PRICE_FEED_LAG_MINUTES=2 \
PATH="$HOME/.foundry/bin:$PWD/target/quick-release:$PATH" \
  ./gravity_e2e/run_test.sh binance_price_feed \
    --force-init \
    --keep-running \
    --demo-config-out ../gravity_price_feed_demo_web/public/demo-config.json \
    --log-cli-level=INFO

Live mode sends outbound requests to Binance public market-data APIs. It does not require BINANCE_API_KEY or BINANCE_SECRET_KEY.

At startup it computes a recent closed 1-minute bucket, generates a run-local relayer config, and registers matching task URIs such as:

GET https://fapi.binance.com/fapi/v1/indexPriceKlines
  ?pair=<NVDAUSDT|TSLAUSDT>
  &interval=1m
  &startTime=<closed bucket start>
  &endTime=<closed bucket end>
  &limit=1

In live mode, stop only the local cluster:

bash cluster/stop.sh --config gravity_e2e/cluster_test_cases/binance_price_feed/cluster.toml

Expected effect

Both mock and live modes exercise the same Gravity path:

relayer fetch -> canonical bytes -> unsupported-JWK consensus -> NativeOracle -> MultiSourceOracleResolver.priceRounds / latestPrice.

Mock mode asserts exact fixture prices. Live mode asserts the resolver shape and positive observed price because the source data is external market data.

How this helps build a Polymarket-like Gravity product

This suite covers the long-running epoch-config oracle path:

• sourceType=3 can feed price/index markets or a demo PerpDex-style price board.
• The existing Polymarket mock path covers sourceType=6-style settlement data.
• Product contracts can consume resolver state to settle YES/NO, multi-outcome, or index-price markets.

It does not implement intra-epoch dynamic request discovery. A future dynamic watcher should scan finalized request events with watermarks/backfill, request expiry, typed Pending / Unknown / Expired states, retryable add_uri, and request/config/payload hashes in the signed object.

Verification

Ran successfully without live Binance traffic:

python3 -m py_compile gravity_e2e/runner.py gravity_e2e/cluster_test_cases/binance_price_feed/test_binance_price_feed.py gravity_e2e/cluster_test_cases/binance_price_feed/mock_binance.py gravity_e2e/cluster_test_cases/binance_price_feed/hooks.py
PYTHONPATH=gravity_e2e:. pytest --collect-only -q gravity_e2e/cluster_test_cases/binance_price_feed
python3 - <<'PY'
import importlib.util, json
from pathlib import Path
p = Path('gravity_e2e/cluster_test_cases/binance_price_feed/hooks.py')
spec = importlib.util.spec_from_file_location('hooks', p)
hooks = importlib.util.module_from_spec(spec)
spec.loader.exec_module(hooks)
env = {'BINANCE_PRICE_FEED_MODE': 'live', 'BINANCE_PRICE_FEED_LAG_MINUTES': '2'}
hooks.pre_deploy(p.parent, env, [])
config_path = Path(env['RELAYER_CONFIG_TPL'])
print(json.loads(config_path.read_text())['uri_mappings'].keys())
config_path.unlink()
PY
git diff --check

Previously verified the keep-running mock backend end-to-end:

PATH="$HOME/.foundry/bin:$PWD/target/quick-release:$PATH" \
  ./gravity_e2e/run_test.sh binance_price_feed \
    --force-init \
    --keep-running \
    --demo-config-out ../gravity_price_feed_demo_web/public/demo-config.json \
    --log-cli-level=INFO

Notes for reviewers:

• The default E2E uses a local deterministic Binance mock, so validator consensus bytes remain deterministic and no live Binance traffic is required.
• Live mode is intentionally manual/demo-only and uses public market-data endpoints.
• Validator-local API keys and RPC URLs stay outside committed fixtures.