ton devenv #470

tt-cll · 2025-12-23T13:03:56Z

No description provided.

deployment/ccip/helpers/utils.go

deployment/utils/chain.go

devenv-impl/go.mod

devenv-impl/ton.toml

.github/workflows/test-smoke.yml

Copilot

Pull request overview

This PR introduces a TON development environment implementation with comprehensive CCIP contract deployment and configuration capabilities. The primary focus is adding a new devenv-impl module that integrates TON blockchain support into the chainlink-ccip devenv infrastructure.

Key Changes:

Created new devenv-impl module implementing CCIP16TON interface for TON chain integration
Refactored deployment helpers to use type-safe Transactions wrapper instead of raw byte slices
Updated function naming for consistency (e.g., LoadMCMSOnchainState → LoadMCMSOnChainState)

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
devenv-impl/impl.go	Core implementation of CCIP16TON interface with message sending, event monitoring, and chain operations
devenv-impl/utils.go	Helper function to derive node addresses from key bundles
devenv-impl/ton.toml	Configuration file defining TON blockchain and EVM test environments
devenv-impl/README.md	Documentation for running the devenv implementation
deployment/ccip/helpers/utils.go	New Transactions type wrapping serialized messages with type-safe operations
deployment/ccip/helpers/execute.go	Updated to use new Transactions type
deployment/ccip/operation/*.go	Refactored operations to return `*Transactions` instead of `[][]byte`
deployment/ccip/sequence/*.go	Updated sequences to use Transactions type and append operations
deployment/state/state.go	Renamed functions for consistency and added new loader for MCMS state
integration-tests/deployment/ccip/cs_deployer_test.go	New test validating contract deployment and OCR3 configuration via deployer API
integration-tests/deployment/mcms/cs_deployer_test.go	New test for MCMS deployment with idempotency verification
.github/workflows/test-smoke.yml	New CI workflow for running TON smoke tests

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

deployment/utils/chain.go

devenv-impl/utils.go

devenv-impl/impl.go

krebernisak · 2026-01-07T17:06:07Z

devenv/test_framework.go

+)
+
+// WaitOneExecEventBySeqNo wait and fetch strictly one ExecutionStateChanged event by sequence number and selector.
+func (m *CCIP16TON) WaitOneExecEventBySeqNo(ctx context.Context, from, to, seq uint64, timeout time.Duration) (any, error) {


Can we somehow structure this infra more and split up the three different components?

ENV setup/spinup (infrastructure)

Protocol deployments + configuration (product)

Protocol interactions + tests (running a scenario)

yeah will give that a shot

Tried splitting into 3 files. offchain, onchain, and test_framework

krebernisak · 2026-01-07T17:11:08Z

deployment/utils/chain.go

 	return tonChain, nil
 }
+
+func CreateClient(ctx context.Context, url string) (*ton.APIClient, error) {


This code is also duplicated here, and probably in few other places: https://github.com/smartcontractkit/chainlink-ton/blob/main/staging-monitor/lib/ton/client.go#L92

@jadepark-dev can you support Terry here and try to figure out a single package in chainlink-ton which exposes an utility fn like this to connect a client, which can be reused in other modules (avoid duplication)?

I can try updating the staging-monitor ref to the deployment utils ref; the staging-monitor module already has a dependency on the deployment module. Whether that's the best place for it to live, we can figure out

Scoped out a follow up ticket here: https://smartcontract-it.atlassian.net/browse/NONEVM-3451

Should live in the root chainlink-ton module so others can import.

devenv-impl/impl.go

krebernisak · 2026-01-07T17:26:17Z

.github/workflows/test-smoke.yml

+      env:
+        GH_TOKEN: ${{ steps.setup-github-token.outputs.access-token }}
+        # Deployment configuration
+        WORKFLOW_FILE: .github/workflows/test_smoke.yml


Wait, is this workflow TON-specific? I checked it out and has TON-specific steps like build TON contracts and other - why is that, what's the goal/structure here?

We're trying to follow a model proposed by https://docs.google.com/document/d/18ZgE45u7XkSSZgiKsxDKgoWeQSRIzaNPv8WbH-pyxig/edit?tab=t.0#heading=h.1f85iu2b3snb

The re-usable flow is not TON specific and any chain should be able to trigger the devenv flow. The reason we had to add the build for TON contracts is when we're trying to source "local" contracts. The other reason we need a ref to the triggering repo is that the env configs are going to live in that repo (e.g. the ton.toml we have defined for blockchains here) so the test runner needs a way to refer to that config.

The scaffolding has tradeoffs. If we define a re-usable flow in chainlink-ccip, it will end up needing to be refs to the calling repo so we can perform any chain specific setup required. If we don't have a re-usable flow and have each chain's repo implement their own action, we end up duplicating the ccip devenv setup steps

Thanks for the context!

is when we're trying to source "local" contracts

But the local contracts are here, as is other context. Can I use your reusable component here vs. triggering it there? Why this can't be an module we import hook into and run here?

Yes that is certainly possible. I tried to get this working with workflow_call rather than workflow_dispatch earlier in development which would have been the action running here rather than chainlink-ccip. 5d7cb4f

https://github.com/smartcontractkit/chainlink-ton/actions/runs/20666861690/job/59340834271

The issue was that workflow is tightly coupled to other actions in chainlink-ccip so we would either have to duplicate actions (and secrets) across repos, or refactor the workflow to actually be standalone and capable of import. If you'd like, we can investigate it in a followup. It should be possible but will require some rework is all.

tt-cll · 2026-01-07T18:34:52Z

tests still passing with refactor https://github.com/smartcontractkit/chainlink-ccip/actions/runs/20791922163/job/59715893808

huangzhen1997

looks good, just needs to fix CI lint errors and update go.md graph (./modgraph > go.md)

huangzhen1997 · 2026-01-08T03:12:18Z

deployment/utils/chain.go

+	return FundWalletsWithCtx(t.Context(), client, recipients, amounts)
+}
+
+func FundWalletsNoT(client ton.APIClientWrapped, recipients []*address.Address, amounts []tlb.Coins) error {


These "NoT" and "WithCtx" aren't idiomatic Go. We should just keep FundWallets that takes context, and you can pass context.Background() for offchain.go.

Then callers use:

Tests: FundWallets(t.Context(), ...)

Other: FundWallets(ctx or context.Background(), ...)

Yeah that's fair. I was trying to avoid too big of a blast radius with these changes, but there aren't that many calls it looks like

So it looks like the code in core uses this as is, which is causing the tests to fail. I'm going to revert back to the original change as I really don't want to incur a 3+ repo PR for this

{"ImportPath":"github.com/smartcontractkit/chainlink/deployment/ccip/changeset/testhelpers","Action":"build-output","Output":"../deployment/ccip/changeset/testhelpers/test_environment.go:505:22: cannot use t (variable of type *\"testing\".T) as \"context\".Context value in argument to utils.FundWallets: *\"testing\".T does not implement \"context\".Context (missing method Done)\n"}

tt-cll · 2026-01-08T15:25:47Z

refactor still passes e2e tests https://github.com/smartcontractkit/chainlink-ccip/actions/runs/20820927683

krebernisak · 2026-01-08T17:41:19Z

devenv/onchain.go

+	return nil
+}
+
+func (m *CCIP16TON) PostDeployContractsForSelector(ctx context.Context, env *deployment.Environment, cls []*simple_node_set.Input, selector uint64, ccipHomeSelector uint64, crAddr string) error {


But where do we actually deploy? Where do we integrate the product level adapters we implemented in this devenv?

The neat thing is that because every chain implements the same API, we can share most of the deployment/configuration setup https://github.com/smartcontractkit/chainlink-ccip/blob/0be702ef3ff57ec1fd258e96151c1f5e4bb372fc/devenv/common/implcommon.go#L55. Every impl actually calls this shared function to deploy. The pre- and post- methods are just for things that might be chain specific, like price updates

agusaldasoro and others added 30 commits November 25, 2025 11:58

Add set ocr to adapter

e08dff8

Merge branch 'main' into feat/set-ocr

9c911dc

fix lint

d45cc6c

fix imports

cb8444a

Fix lint

e4d5202

fix lint

000f942

fix lint

f7b866b

Merge branch 'main' into feat/set-ocr

5d2a5a0

Merge branch 'main' into feat/set-ocr

0561de9

merge main

6fddecf

bump chainlink ccip deployment dependency

cfe37b1

fix make

768c398

nop

750742f

tidy

6bd0b8e

Merge branch 'main' into NONEVM-3219/CCIP-deployer-interface

e04101e

add noop

499e23d

revert adaptor

ee21966

update

7d7d005

Merge branch 'main' into NONEVM-3219/CCIP-deployer-interface

4138e85

add mcms deployment

78698dc

fix

47f1686

fix make

8a46a6c

fix test

3b89974

devenv-impl template for TON

6138aa4

readme

7b601d8

Merge branch 'main' into NONEVM-3219/CCIP-deployer-interface

de54ca0

add setOCR3 test

9516075

update mock

e15bd56

fix some lint

24c3cef

add test coverage for deploycontracts as well. Only MCMS left

fd4f403

Copilot AI review requested due to automatic review settings January 7, 2026 16:53

krebernisak reviewed Jan 7, 2026

View reviewed changes

deployment/ccip/helpers/utils.go Show resolved Hide resolved

deployment/utils/chain.go Outdated Show resolved Hide resolved

devenv-impl/go.mod Outdated Show resolved Hide resolved

devenv-impl/ton.toml Outdated Show resolved Hide resolved

github-advanced-security bot found potential problems Jan 7, 2026

View reviewed changes

.github/workflows/test-smoke.yml Dismissed Show dismissed Hide dismissed

Merge remote-tracking branch 'origin/main' into tt/devenv

e1dcfb5

Copilot AI reviewed Jan 7, 2026

View reviewed changes

deployment/utils/chain.go Outdated Show resolved Hide resolved

deployment/utils/chain.go Outdated Show resolved Hide resolved

devenv-impl/utils.go Outdated Show resolved Hide resolved

krebernisak reviewed Jan 7, 2026

View reviewed changes

tt-cll added 4 commits January 7, 2026 09:47

cr comments

d0dd7eb

reference client

cc9e0b9

imports

60fb48f

fix e2e

9fb3139

huangzhen1997 reviewed Jan 8, 2026

View reviewed changes

tt-cll and others added 10 commits January 8, 2026 05:30

refactor

364644f

gomod

b022327

go.md

55d48cb

chainlink common

7aa0679

Update README.md

416c9f8

format

83cd9c7

lint

81db513

revert fund wallets

ff33142

lint

f55956c

Merge branch 'main' into tt/devenv

75b4f73

Update test-smoke.yml

8110cbb

krebernisak reviewed Jan 8, 2026

View reviewed changes

tt-cll enabled auto-merge (squash) January 8, 2026 18:42

huangzhen1997 approved these changes Jan 8, 2026

View reviewed changes

tt-cll merged commit 1189180 into main Jan 8, 2026
38 of 41 checks passed

tt-cll deleted the tt/devenv branch January 8, 2026 22:47

ton devenv #470

ton devenv #470

Uh oh!

Conversation

tt-cll commented Dec 23, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tt-cll commented Jan 7, 2026

Uh oh!

huangzhen1997 left a comment

Choose a reason for hiding this comment

Uh oh!

huangzhen1997 Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tt-cll commented Jan 8, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

huangzhen1997 Jan 8, 2026 •

edited

Loading