Skip to content

Conversation

@MakisChristou
Copy link
Member

@MakisChristou MakisChristou commented Jul 21, 2025

This PR includes release docs for deploying the AxelarGateway, GasService and Governance funC contracts on TON testnet.

Greptile Summary

This PR introduces comprehensive TON blockchain integration into the Axelar network ecosystem. The changes add support for deploying Axelar's core contracts (AxelarGateway, GasService, and Governance) on TON testnet, along with the necessary CosmWasm verification contracts (TonVotingVerifier and TonMultisigProver) that enable cross-chain messaging between TON and other blockchains via Axelar's Amplifier protocol.

The implementation follows established patterns used for other blockchain integrations in the codebase. In cosmwasm/utils.js, two new contract entries are added to the CONTRACTS object with chain scope, reusing existing instantiation message functions that handle the standard voting verifier and multisig prover logic. The axelar-chains-config/info/devnet-amplifier.json file is updated with a complete TON chain configuration including contract addresses in proper TON format (0: prefixed hex), ITS translator settings, and amplifier connection details.

Three comprehensive release documentation files are added following the established template format: releases/cosmwasm/2025-07-TON-v1.0.0.md for CosmWasm contract deployment, releases/ton/2025-07-GMP-v1.0.0.md for TON-specific funC contract deployment using Blueprint framework, and releases/ton/2025-08-ITS-v1.0.0.md for Interchain Token Service deployment. These documents provide step-by-step deployment instructions, verification procedures, and operational commands specific to TON's architecture.

Important Files Changed

File Changes Summary
Filename Score Overview
cosmwasm/utils.js 5/5 Adds TonVotingVerifier and TonMultisigProver contract entries with chain scope
axelar-chains-config/info/devnet-amplifier.json 4/5 Comprehensive TON chain configuration with contract addresses and ITS settings
releases/cosmwasm/2025-07-TON-v1.0.0.md 4/5 Complete CosmWasm deployment documentation with minor formatting issues
releases/ton/2025-07-GMP-v1.0.0.md 4/5 TON-specific GMP deployment documentation using Blueprint framework
releases/ton/2025-08-ITS-v1.0.0.md 4/5 ITS deployment documentation with version reference and variable issues

Confidence score: 4/5

  • This PR is safe to merge with minor documentation issues that don't affect functionality
  • Score reflects comprehensive implementation following established patterns, with only minor formatting and documentation inconsistencies
  • Pay attention to the documentation files for potential variable reference issues and incomplete sentences that should be addressed

Sequence Diagram

sequenceDiagram
    participant User
Loading

@MakisChristou MakisChristou changed the title Chore/ton v1.0.0 devnet amplifier docs(release): deploy TON GMP v1.0.0 Jul 21, 2025
@dfapel dfapel force-pushed the chore/ton-v1.0.0-devnet-amplifier branch from 12c41a8 to 6f460f0 Compare August 26, 2025 14:11
@MakisChristou MakisChristou marked this pull request as ready for review August 26, 2025 14:18
@MakisChristou MakisChristou requested a review from a team as a code owner August 26, 2025 14:18
\"create_pool\": {
\"params\": {
\"epoch_duration\": \"$EPOCH_DURATION\",
\"participation_threshold\": [$PARTICIPATION_THRESHOLD],
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Multisig Contract Parameter Wrapping Error

The participation_threshold parameter in the create_pool message for the multisig contract is incorrectly wrapped in brackets. Since $PARTICIPATION_THRESHOLD is already an array, this creates a nested array, inconsistent with the create_pool message for the voting verifier, and may cause JSON parsing issues.

Fix in Cursor Fix in Web

@MakisChristou MakisChristou marked this pull request as draft August 26, 2025 14:25
Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

5 files reviewed, 6 comments

Edit Code Review Bot Settings | Greptile

cosmwasm_contract="$MULTISIG"
```

11. Register chain support for
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

syntax: Incomplete sentence - missing context about what chain support is being registered for

Suggested change
11. Register chain support for
11. Register chain support for TON

Comment on lines +60 to +61
CHECKSUM=$(cat checksums.txt | grep voting_verifier.wasm | awk '{print $1}')
shasum -a 256 $ARTIFACT_PATH/ton_voting_verifier.wasm | grep $CHECKSUM
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

logic: grep pattern 'voting_verifier.wasm' may not match filename 'ton_voting_verifier.wasm' in checksums.txt

Comment on lines +64 to +65
CHECKSUM=$(cat checksums.txt | grep multisig_prover.wasm | awk '{print $1}')
shasum -a 256 $ARTIFACT_PATH/ton_multisig_prover.wasm | grep $CHECKSUM
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

logic: grep pattern 'multisig_prover.wasm' may not match filename 'ton_multisig_prover.wasm' in checksums.txt

## Deployment

- Ensure that ITS Hub has been upgraded to [v1.3.0](../cosmwasm/2025-07-ITS-v1.3.0.md) first.
- The rollout involves deploying TON ITS contracts version `v1.0.` on TON.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

syntax: Version inconsistency - should be v1.0.0 not v1.0.

Suggested change
- The rollout involves deploying TON ITS contracts version `v1.0.` on TON.
- The rollout involves deploying TON ITS contracts version `v1.0.0` on TON.

\"create_pool\": {
\"params\": {
\"epoch_duration\": \"$EPOCH_DURATION\",
\"participation_threshold\": [$PARTICIPATION_THRESHOLD],
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

style: inconsistent bracket usage - should be "participation_threshold": $PARTICIPATION_THRESHOLD to match line 342

Suggested change
\"participation_threshold\": [$PARTICIPATION_THRESHOLD],
"participation_threshold": $PARTICIPATION_THRESHOLD,

Note: TON ITS doesn't use a custom ITS ABI Translator.
ITS hub contract configuration in json file must include the following attributes per chain:

```bash
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

style: Use json syntax highlighting instead of bash for JSON configuration

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants