Feature/update mobula ea v2

[FionnL]

Closes #STRUCT-3512

https://smartcontract-it.atlassian.net/browse/STRUCT-3512

Description

Please also see the Jira ticket for the changes made.

Changes

• API Migration: Updated from Mobula v1 firehose approach to v2 targeted subscriptions using asset_ids for more efficient WebSocket connections

• Asset Mapping System: Added comprehensive includes.json with 211+ DeFi token mappings (EZETH, CBETH, LBTC, GHO, etc.) enabling symbol-to-asset-id resolution

• Hardcoded Quote Currencies: Implemented direct support for 6 major crypto quote currencies (BTC, ETH, SOL, HYPE, S, BBSOL) without requiring includes.json entries

• Framework Integration: Migrated from basic Adapter to PriceAdapter with CryptoPriceEndpoint to leverage EA framework v3 features and type safety

• Critical Bug Fix: Resolved composite key reverse mapping issue using baseID-quoteID keys to prevent quote currency overwrites (e.g., EZETH/ETH vs EZETH/USD collision)

• Comprehensive Testing: Added 18 integration tests covering includes.json mappings, hardcoded quotes, override functionality, direct asset ID usage, and error cases

• Framework Update: Updated to @chainlink/external-adapter-framework v2.8.0 for CI compatibility and latest features

• Enhanced Flexibility: Added support for request-level base/quote overrides and direct asset ID usage alongside symbol-based requests

• Result: Transformed EA from symbol-based firehose to efficient, targeted asset-id subscriptions.

Steps to Test

Run Integration & Unit Tests

Run all tests for mobula-state adapter:
yarn test mobula-state

Run only integration tests:
yarn test:integration mobula-state

Run only unit tests:
yarn test:unit mobula-state

Manual Testing - Start EA

cd packages/sources/mobula-state
API_KEY=your_api_key yarn start

Sample EA Request Payloads

1. Basic Includes.json Mappings

EZETH/USD (includes.json mapping):

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "EZETH", "quote": "USD"}}'

CBETH/ETH (includes.json + hardcoded ETH quote):

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "CBETH", "quote": "ETH"}}'

LBTC/BTC (includes.json + hardcoded BTC quote):

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "LBTC", "quote": "BTC"}}'

2. Hardcoded Quote Currencies

Test all supported hardcoded quotes:

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "EZETH", "quote": "ETH"}}'
curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "LBTC", "quote": "BTC"}}'
curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "MSOL", "quote": "SOL"}}'

3. Override Functionality

Base override - use custom symbol mapped to EZETH asset ID:

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "MYCOIN", "quote": "USD", "overrides": {"mobula-state": {"MYCOIN": "102478632"}}}}'

Dual override - both base and quote:

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "MYEZETH", "quote": "MYETH", "overrides": {"mobula-state": {"MYEZETH": "102478632", "MYETH": "100004304"}}}}'

4. Direct Asset ID Usage

Direct asset IDs (no symbol resolution needed):

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "102478632", "quote": "USD"}}'
curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "102478632", "quote": "100004304"}}'

5. Funding Rate Endpoint

curl -X POST http://localhost:8080/ -H "Content-Type: application/json" -d '{"data": {"base": "BTC", "exchange": "binance", "endpoint": "funding-rate"}}'

Expected Results

• EZETH/USD: ~$4,200 (current USD price)
• EZETH/ETH: ~1.06 (ETH ratio, NOT USD price)
• LBTC/BTC: ~0.998 (BTC ratio)
• Override requests: Same prices as direct symbol requests
• Direct asset IDs: Same prices as symbol requests
• Error cases: 400/504 errors for unmapped symbols

Key Validations

• Composite Key Fix: Verify EZETH/ETH returns ~1.06 (ETH ratio) not ~4200 (USD price)
• Override Priority: Overrides take precedence over includes.json
• Asset ID Resolution: Check meta.metrics.feedId shows correct asset IDs
• Quote Currency Support: USD, BTC, ETH, SOL, HYPE, S, BBSOL all work
• Comprehensive Coverage: 211+ DeFi tokens supported via includes.json

Quality Assurance

• If a new adapter was made, or an existing one was modified so that its environment variables have changed, update the relevant infra-k8s configuration file.
• If a new adapter was made, or an existing one was modified so that its environment variables have changed, update the relevant adapter-secrets configuration file or update the soak testing blacklist.
• If a new adapter was made, or a new endpoint was added, update the test-payload.json file with relevant requests.
• The branch naming follows git flow (feature/x, chore/x, release/x, hotfix/x, fix/x) or is created from Jira.
• This is related to a maximum of one Jira story or GitHub issue.
• Types are safe (avoid TypeScript/TSLint features like any and disable, instead use more specific types).
• All code changes have 100% unit and integration test coverage. If testing is not applicable or too difficult to justify doing, the reasoning should be documented explicitly in the PR.

[changeset-bot]

🦋 Changeset detected

Latest commit: 814dfa3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@chainlink/mobula-state-adapter	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull Request Overview

This PR migrates the Mobula State adapter from v1 firehose WebSocket approach to v2 targeted subscriptions using asset IDs. The migration introduces a comprehensive symbol-to-asset-ID mapping system via includes.json with 211+ DeFi token mappings, hardcoded support for 6 major crypto quote currencies, and fixes a critical composite key reverse mapping bug that prevented correct quote currency handling.

Key changes:

• Replaced firehose subscription with targeted asset_id-based WebSocket subscriptions
• Added includes.json with mappings for 211+ DeFi tokens to their Mobula asset IDs
• Implemented composite key (baseID-quoteID) for reverse mapping to prevent quote currency overwrites
• Migrated from basic Adapter to PriceAdapter with framework v3 type safety
• Added 18 comprehensive integration tests covering all mapping scenarios

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/sources/mobula-state/src/transport/price.ts	Core transport migration to WebsocketReverseMappingTransport with asset ID resolution logic, hardcoded quote currencies, and composite key reverse mapping
packages/sources/mobula-state/src/endpoint/price.ts	Updated to CryptoPriceEndpoint with modified input parameter aliases for framework compatibility
packages/sources/mobula-state/src/index.ts	Changed from Adapter to PriceAdapter and added includes.json import
packages/sources/mobula-state/src/config/includes.json	New comprehensive mapping file with 211+ DeFi token symbol-to-asset-ID entries
packages/sources/mobula-state/test/integration/fixtures.ts	Expanded mock WebSocket responses to cover all test scenarios including overrides and direct asset IDs
packages/sources/mobula-state/test/integration/adapter.test.ts	Added 18 integration tests for includes.json mappings, hardcoded quotes, overrides, and direct asset ID usage
packages/sources/mobula-state/test/integration/snapshots/adapter.test.ts.snap	Updated snapshots with expected results for all new test cases
packages/sources/mobula-state/test-payload.json	Updated test payloads to demonstrate new capabilities
.changeset/large-cycles-admire.md	Changeset documenting the major version bump

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}