[NONEVM-5715] [OffRamp] Programable Token Transfer - #823
Open
duck-types wants to merge 3 commits into
Open
Conversation
duck-types
changed the title
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 7, 2026 19:50
9a5ac74 to
964a017
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 7, 2026 19:50
964a017 to
4d0ed18
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
2 times, most recently
from
August 7, 2026 22:02
c06d5b7 to
acc0b36
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 7, 2026 22:03
acc0b36 to
f871c95
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
2 times, most recently
from
August 7, 2026 22:42
617a411 to
275b3e1
Compare
duck-types
changed the base branch from
feat/token-transfer/offramp
to
fix/token-pool/releaseOrMint-should-notify-failure
August 7, 2026 22:42
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 7, 2026 23:48
275b3e1 to
0882d4a
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
2 times, most recently
from
August 10, 2026 18:28
deb5577 to
ec03270
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 11, 2026 11:31
ec03270 to
bf4c7c2
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 11, 2026 11:32
bf4c7c2 to
133a25b
Compare
duck-types
changed the base branch from
fix/token-pool/releaseOrMint-should-notify-failure
to
ref/receive-executor/clean-up-state
August 11, 2026 11:32
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 11, 2026 20:59
133a25b to
178b6a4
Compare
duck-types
changed the title
duck-types
marked this pull request as ready for review
August 11, 2026 23:00
Contributor
There was a problem hiding this comment.
Pull request overview
This PR extends the TON CCIP OffRamp/ReceiveExecutor flow to support Programmable Token Transfers (PTT) (messages carrying both token transfer + calldata), and introduces a structured GasOverride mechanism (with receiverExecutionGasLimit) that can be propagated through execution.
Changes:
- Adds
GasOverridestruct support across contracts/wrappers and threads it throughExecute/InitExecute/DispatchValidated. - Enables PTT in
ReceiveExecutorby executing the message after token transfer completion (instead of rejecting). - Updates manual execution to a new message variant (
OffRamp_ManuallyExecute_VTT) and expands tests for PTT + retry/bounce flows.
Reviewed changes
Copilot reviewed 15 out of 15 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| contracts/wrappers/gen/ccip/ReceiveExecutor.ts | Adds GasOverride type usage and storage/state wiring in generated wrapper. |
| contracts/wrappers/gen/ccip/OffRamp.ts | Updates generated wrapper types/messages for GasOverride, dispatch gas field rename, and manual execute VTT variant. |
| contracts/wrappers/gen/ccip/MerkleRoot.ts | Updates wrapper message types to use GasOverride instead of coins. |
| contracts/tests/ccip/receiveExecutor/ReceiveExecutor.execution.spec.ts | Refactors helpers and adds/updates tests for token transfer + PTT execution/retry/bounce flows. |
| contracts/tests/ccip/offramp/OffRamp.Setup.ts | Updates manual execution helper to send VTT variant with GasOverride. |
| contracts/tests/ccip/offramp/OffRamp.execute.spec.ts | Updates gas override assertions and adds end-to-end PTT execution and failure tests. |
| contracts/contracts/ccip/receive_executor/types.tolk | Extends ReceiveExecutor_State with persisted gasOverride. |
| contracts/contracts/ccip/receive_executor/storage.tolk | Initializes gasOverride in persistent storage defaults. |
| contracts/contracts/ccip/receive_executor/messages.tolk | Changes ReceiveExecutor_InitExecute.gasOverride from coins? to GasOverride?. |
| contracts/contracts/ccip/receive_executor/errors.tolk | Removes PTTNotSupported error (PTT now supported). |
| contracts/contracts/ccip/receive_executor/contract.tolk | Stores gas override in state; executes after token transfer when calldata exists (PTT). |
| contracts/contracts/ccip/offramp/types.tolk | Introduces GasOverride struct + helper(s) for effective gas limit selection. |
| contracts/contracts/ccip/offramp/messages.tolk | Updates message union for manual execute VTT and changes DispatchValidated gas field naming. |
| contracts/contracts/ccip/offramp/contract.tolk | Uses effective gas limit helper and switches manual execute handling to VTT variant. |
| contracts/contracts/ccip/merkle_root/messages.tolk | Updates MerkleRoot_Validate.gasOverride type to GasOverride?. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
2021
to
2025
| return { | ||
| $: 'OffRamp_ExecuteValidated', | ||
| gasOverride: null, | ||
| ...args | ||
| } |
Collaborator
Author
There was a problem hiding this comment.
TODO: check if this is a bug from our abigen.ts scrypt
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 11, 2026 23:37
178b6a4 to
98b3189
Compare
duck-types
commented
Aug 12, 2026
|
|
||
| struct (0xa00785cf) OffRamp_ManuallyExecute { | ||
| // `OffRamp_ManuallyExecute_V2` is a variant of the previous `OffRamp_ManuallyExecute` that adds token transfer support in CCIP 1.6 | ||
| struct (0xfef433bd) OffRamp_ManuallyExecute_V2 { |
Collaborator
Author
There was a problem hiding this comment.
I'm not fully convinced of the V2 suffix as it will probably be confused with CCIP 2.0. What about VTT for (version token transfer)? It is a bit more descriptive and less likely to be confused with a future version of CCIP.
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
2 times, most recently
from
August 13, 2026 14:02
9b84b61 to
a306178
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 14, 2026 03:29
a306178 to
a78b680
Compare
duck-types
force-pushed
the
feat/programable-token-transfer/offramp
branch
from
August 14, 2026 03:56
a78b680 to
1c4bac9
Compare
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.
NONEVM-5715