Repository navigation
feat(sdk)!: Select the OffRamp by lane version (Solana 2.0 Router serving 1.6 + 2.0 lanes) - #531
Merged
Merged
Conversation
A Solana 2.0 Router (also the OnRamp) keeps its 1.6 entrypoint next to the 2.0 one, and the destination has one OffRamp of each version that accepts it, so (source, onRamp, dest) no longer selects one OffRamp. - lane.version of a sent 1.6+ message comes from the message shape (offRampAddress only on 2.0 messages), via the new getMessageVersion, not from the emitting contract's typeAndVersion - discoverOffRamp(source, dest, lane) takes the lane (onRamp + version) and returns an OffRamp of the lane's version, memoized per version - getOnRampConfig(onRamp, destChainSelector, opts?) takes the lane `version`; on Solana it reads the dest_chain_state (1.6) or dest_chain_state_v2 (2.0) lane config - CCIP API requests get 1.6.0 when the API reports 2.0.0 for a message without encodedMessage - getRequiredCCVs/estimateReceiveExecution discover the OnRamp's default lane; getRequiredCCVs rejects unsupported dests before any RPC call - CLI: show/manual-exec pass request.lane; lane gets --lane-version and shows the lane version in every format Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
getOffRampsForRouter on a 2.0 router read the history of every marker in parallel; on the devnet router (32 markers) public RPCs throttled it until it failed after minutes. Once a tx shows an OffRamp program, its markers for every known source chain are derived instead of read: ~6 RPC calls (~1.5s). 1.6 lanes of a 2.0 router reach this scan in both directions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ccip842 (Solana devnet) serves 1.6 and 2.0 lanes at once. Cover both directions and both versions (lane version, OffRamp, receipt), its two lane configs, and its OffRamps for Sepolia. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The pinned Ethereum->Monad LBTC message aged out of the default Monad RPC's retention. Replay the newest executed one from the API that has a Lombard verification instead. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Organic ton-testnet activity pauses for days, leaving the fixed 24h window without logs. Keep 24h on a busy lane; otherwise end the window 6h after the newest indexed event, at most 3 days back. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
TEMPORARY: since the Solana devnet router became ccip-router 2.0.0, the CCIP API reports 2.0.0 for its 1.6 messages and execution-inputs answers HTTP 500 for them. Pin that failure until the API is fixed, then revert to the expected success (kept in a comment). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Public sui-testnet fullnodes pruned the onramp's newest send, and no public endpoint the SDK speaks still serves it. Capture the fixture at load time and skip the suite with the reason until a send is served. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
👋 andrevmatos, thanks for creating this pull request! To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team. Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks! |
pedrovsg
approved these changes
Nov 5, 2026
CI Test Report✅ 4448/4448 tests passed (1109 suites) in 6m 54s SummaryCoverage report |
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The Solana devnet Router
Ccip842gzYHhvdDkSyi2YVCoAWPbYJoApMFzSxQroE9Cis nowccip-router 2.0.0. It keeps its 1.6 entrypoint (ccip_send, eventCCIPMessageSent,dest_chain_state) next to the 2.0 entrypoint (ccip_send_v2, eventCCIPMessageSentV2,dest_chain_state_v2). The Router is also the OnRamp. Thus one OnRamp serves a 1.6 lane and a 2.0 lane to the same destination, and each destination has one OffRamp of each version that accepts it:0x0820f975ce90EE5c508657F0C58b71D1fcc85cE00xc6A246A9AcdAaE651708706494720F79C3E5d0A1offqSMQWgQud6WJz694LRzkeN5kMYpCHTpXQr3Rkcjmoff43sBHBsmWTU6VbfwKYCNwyJ4rSDhunYvz3QL7bF9The SDK assumed that (source, onRamp, dest) selects one OffRamp. It also took the lane version from the emitting contract's
typeAndVersion. For a 1.6 message from the upgraded Router,ccip-cli showtherefore looked for the receipt on the 2.0 OffRamp and found none (e.g. tx62e2Fe4pDva23jRNMWaxpanvNDmPnpTHvvKpJGxGji24NpjfbTsioT6ysJw6vEPm2r4T3pseCbXxbpfTuvuy7JVQ).Changes
SDK (breaking)
lane.versionof a sent 1.6+ message comes from the message shape: only 2.0 messages haveoffRampAddress. New exportgetMessageVersion.discoverOffRamp(source, dest, lane)takes the lane (onRamp+version, e.g.request.lane) instead of the OnRamp address. It returns an OffRamp of the lane's version, memoized per version.getOnRampConfig(onRamp, destChainSelector, opts?: { version })selects the lane config. On Solana it readsdest_chain_state(1.6) ordest_chain_state_v2(2.0). The returnedtypeAndVersionstill identifies the contract.1.6.0when the API reports2.0.0for a message withoutencodedMessage.getRequiredCCVsandestimateReceiveExecutiondiscover the OffRamp of the OnRamp's default lane.getRequiredCCVsthrowsCCIPMethodUnsupportedErrorbefore any RPC call for a destination without the view.Solana
getOffRampsForRouteron a 2.0 Router reads oneallowed_offrampmarker history per OffRamp program, not every marker in parallel. On the devnet Router (32 markers), public RPCs throttled the old scan (HTTP 429) until it failed after minutes. The new scan uses ~6 RPC calls (~1.5 s). 1.6 lanes of a 2.0 Router reach this scan in both directions.getOnRampConfigcache key includes the lane version.CLI
showandmanual-execpassrequest.lane.lane --lane-version <1.2|1.5|1.6|2.0>selects the lane. Every output format shows the laneversion.Tests
getMessageVersion, the API version mapping andgetRequiredCCVs.evm/fork.test.ts"API-driven path (Solana Devnet -> Sepolia)" now expects the current API failure. Since the Router upgrade, the CCIP API reports2.0.0for its 1.6 messages, and/v2/messages/{id}/execution-inputsanswers HTTP 500 for them (prod and staging). Revert to the expected success (kept in a comment) when the API is fixed.Testing
npm run lint,npm run typecheck: pass; every commit type-checks on its own.ccip-cli showandlanechecks for all four Solana devnet ↔ Sepolia cases (1.6 and 2.0 in each direction).🤖 Generated with Claude Code