sui: working show, improve events fetching (#117)

* sui: working `show`, improve events fetching

addresses now require ::module suffix

* bump dependencies

* bump versions to v0.95, adjust changelog

* default api url to staging

* address comments

---------

Co-authored-by: Andre Matos <[email protected]>

Author: RodrigoAD

CHANGELOG.md

@@ -7,11 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.95.0] - 2026-01-28 - Pre-release
+
 - SDK: `Chain.getBalance()` method for querying native and token balances (EVM, Solana, Aptos)
 - SDK: Solana `resolveATA()` utility for ATA derivation with automatic SPL Token vs Token-2022 detection
 - CLI: `token` command for balance queries
 - SDK: fix EVM estimate gas for token transfers with balance slot!=0 (e.g. USDC)
-- SDK: Add `NetworkType` enum (`'MAINNET' | 'TESTNET'`) and `networkType` property to `NetworkInfo`
+- SDK: Add `NetworkType` enum (`'MAINNET' | 'TESTNET'`) and `networkType` property to `NetworkInfo`, in place of `isTestnet` boolean
 - SDK: Selector generation scripts now validate `network_type` presence from upstream chain-selectors
 - CLI: **Breaking**: `send`, `getSupportedTokens`, and `token` commands now use named arguments instead of positional (e.g., `send -s <source> -d <dest> -r <router>`)
 - CLI: **Breaking**: `-r` alias removed from global `--rpcs` option (use `--rpc` instead); `-r` now used for `--router` in `send` command

ccip-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainlink/ccip-cli",
-  "version": "0.94.0",
+  "version": "0.95.0",
   "description": "CCIP Command Line Interface, based on @chainlink/ccip-sdk",
   "author": "Chainlink devs",
   "license": "MIT",
@@ -32,23 +32,23 @@
   ],
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@types/node": "25.0.9",
+    "@types/node": "25.0.10",
     "@types/yargs": "17.0.35",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^62.2.0",
+    "eslint-plugin-jsdoc": "^62.4.1",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-tsdoc": "^0.5.0",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "tsx": "4.21.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.53.1"
+    "typescript-eslint": "8.54.0"
   },
   "dependencies": {
     "@aptos-labs/ts-sdk": "^5.2.1",
-    "@chainlink/ccip-sdk": "^0.94.0",
+    "@chainlink/ccip-sdk": "^0.95.0",
     "@coral-xyz/anchor": "^0.29.0",
     "@ethers-ext/signer-ledger": "^6.0.0-beta.1",
     "@inquirer/prompts": "8.2.0",
@@ -59,7 +59,7 @@
     "@ton-community/ton-ledger": "^7.3.0",
     "bs58": "^6.0.0",
     "ethers": "6.16.0",
-    "type-fest": "^5.4.1",
+    "type-fest": "^5.4.2",
     "yargs": "18.0.0"
   }
 }

ccip-cli/src/commands/utils.ts

@@ -12,18 +12,19 @@ import {
   CCIPErrorCode,
   ExecutionState,
   getCCIPExplorerUrl,
+  getDataBytes,
   networkInfo,
   supportedChains,
 } from '@chainlink/ccip-sdk/src/index.ts'
 import { select } from '@inquirer/prompts'
 import {
   dataLength,
   formatUnits,
-  getBytes,
   hexlify,
   isBytesLike,
   isHexString,
   parseUnits,
+  toBigInt,
   toUtf8String,
 } from 'ethers'
 import type { PickDeep } from 'type-fest'
@@ -215,6 +216,26 @@ function omit<T extends Record<string, unknown>, K extends string>(
   return result
 }
 
+// while formatData just breaks 0x bytes into 32B chunks for readability, this function first
+// tests if the data looks like a UTF-8 string (with length prefix) and decode that before
+function formatDataString(data: string): Record<string, string> {
+  const bytes = getDataBytes(data)
+  const isPrintableChars = (bytes_: Uint8Array) => bytes_.every((b) => 32 <= b && b <= 126)
+  if (bytes.length > 64 && toBigInt(bytes.subarray(0, 32)) === 32n) {
+    const len = toBigInt(bytes.subarray(32, 64))
+    if (
+      len < 512 &&
+      bytes.length - 64 === Math.ceil(Number(len) / 32) * 32 &&
+      isPrintableChars(bytes.subarray(64, 64 + Number(len))) &&
+      bytes.subarray(64 + Number(len)).every((b) => b === 0)
+    ) {
+      return { data: toUtf8String(bytes.subarray(64, 64 + Number(len))) }
+    }
+  }
+  if (bytes.length > 0 && isPrintableChars(bytes)) return { data: toUtf8String(bytes) }
+  return formatData('data', data)
+}
+
 /**
  * Prints a CCIP request in a human-readable format.
  * @param source - Source chain instance.
@@ -289,11 +310,7 @@ export async function prettyRequest(this: Ctx, source: Chain, request: CCIPReque
       'tokens',
       await Promise.all(request.message.tokenAmounts.map(formatToken.bind(null, source))),
     ),
-    ...(isBytesLike(request.message.data) &&
-    dataLength(request.message.data) > 0 &&
-    getBytes(request.message.data).every((b) => 32 <= b && b <= 126) // printable characters
-      ? { data: toUtf8String(request.message.data) }
-      : formatData('data', request.message.data)),
+    ...formatDataString(request.message.data),
     ...('accounts' in request.message ? formatArray('accounts', request.message.accounts) : {}),
     ...rest,
   })

ccip-cli/src/index.ts

@@ -11,7 +11,7 @@ import { Format } from './commands/index.ts'
 util.inspect.defaultOptions.depth = 6 // print down to tokenAmounts in requests
 // generate:nofail
 // `const VERSION = '${require('./package.json').version}-${require('child_process').execSync('git rev-parse --short HEAD').toString().trim()}'`
-const VERSION = '0.94.0-4bfc4ca'
+const VERSION = '0.95.0-4d8c14a'
 // generate:end
 
 const globalOpts = {

ccip-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainlink/ccip-sdk",
-  "version": "0.94.0",
+  "version": "0.95.0",
   "description": "SDK/Library to interact with CCIP",
   "author": "Chainlink devs",
   "license": "MIT",
@@ -51,20 +51,20 @@
     "@depay/web3-mock": "^15.3.0",
     "@eslint/js": "^9.39.2",
     "@types/bn.js": "^5.2.0",
-    "@types/node": "25.0.9",
+    "@types/node": "25.0.10",
     "@types/yargs": "17.0.35",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^62.2.0",
+    "eslint-plugin-jsdoc": "^62.4.1",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-tsdoc": "^0.5.0",
     "ethers-abitype": "1.0.3",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.53.1",
-    "viem": "^2.44.4"
+    "typescript-eslint": "8.54.0",
+    "viem": "^2.45.0"
   },
   "dependencies": {
     "@aptos-labs/ts-sdk": "^5.2.1",
@@ -74,7 +74,7 @@
     "@mysten/sui": "^1.45.2",
     "@solana/spl-token": "0.4.14",
     "@solana/web3.js": "^1.98.4",
-    "@ton/core": "0.62.1",
+    "@ton/core": "0.63.0",
     "@ton/crypto": "^3.3.0",
     "@ton/ton": "^16.1.0",
     "abitype": "1.2.3",
@@ -84,7 +84,7 @@
     "ethers": "6.16.0",
     "got": "^11.8.6",
     "micro-memoize": "^5.1.1",
-    "type-fest": "^5.4.1",
+    "type-fest": "^5.4.2",
     "yaml": "2.8.2"
   },
   "overrides": {

ccip-sdk/src/api/api.test.ts

@@ -291,9 +291,9 @@ describe('CCIPAPIClient', () => {
       sendTimestamp: '2023-12-01T10:30:00Z',
       tokenAmounts: [
         {
-          sourceTokenAddress: '0xA0b86a8B5b6E8e0A09C4c3Dc7dE6e69e1e2d3f4a',
-          destTokenAddress: '0xB1c97a9C6c7F9f1B10D5e4Ec8eF7f70f2f3e4d5c',
-          sourcePoolAddress: '0xC2d08b0D7d8a0a2C21E6f5Fd9fa8a81a3a4f5e6d',
+          sourceTokenAddress: '0xa0b86a8b5b6e8e0a09c4c3dc7de6e69e1e2d3f4a',
+          destTokenAddress: '0xb1c97a9c6c7f9f1b10d5e4ec8ef7f70f2f3e4d5c',
+          sourcePoolAddress: '0xc2d08b0d7d8a0a2c21e6f5fd9fa8a81a3a4f5e6d',
           amount: '1000000',
         },
       ],
@@ -302,7 +302,7 @@ describe('CCIPAPIClient', () => {
       finality: 0,
       fees: {
         fixedFeesDetails: {
-          tokenAddress: '0x4Cb3c1a50616725Bd1793D0eE0C7Fc4dC4E05c79',
+          tokenAddress: '0x4cb3c1a50616725bd1793d0ee0c7fc4dc4e05c79',
           totalAmount: '5000000',
         },
       },
@@ -720,7 +720,7 @@ describe('CCIPAPIClient', () => {
       )
 
       // tokenAmounts is on message
-      const msg = result.message as unknown as { tokenAmounts: { token: string; amount: bigint }[] }
+      const msg = result.message as { tokenAmounts: readonly { token: string; amount: bigint }[] }
       assert.equal(msg.tokenAmounts.length, 0)
     })
 

ccip-sdk/src/api/index.ts

@@ -39,7 +39,7 @@ export type {
 } from './types.ts'
 
 /** Default CCIP API base URL */
-export const DEFAULT_API_BASE_URL = 'https://api.ccip.chain.link'
+export const DEFAULT_API_BASE_URL = 'https://api.ccip.cldev.cloud'
 
 /** Default timeout for API requests in milliseconds */
 export const DEFAULT_TIMEOUT_MS = 30000

ccip-sdk/src/aptos/index.ts

@@ -9,9 +9,7 @@ import {
 import {
   type BytesLike,
   concat,
-  dataLength,
   dataSlice,
-  decodeBase64,
   getBytes,
   hexlify,
   isBytesLike,
@@ -487,18 +485,18 @@ export class AptosChain extends Chain<typeof ChainFamily.Aptos> {
    * @param bytes - Bytes to convert.
    * @returns Aptos address (0x-prefixed hex, 32 bytes padded).
    */
-  static getAddress(bytes: BytesLike): string {
+  static getAddress(bytes: BytesLike | readonly number[]): string {
     let suffix = ''
-    if (typeof bytes === 'string' && !bytes.startsWith('0x')) {
-      bytes = decodeBase64(bytes)
-    } else if (typeof bytes === 'string') {
+    if (Array.isArray(bytes)) bytes = new Uint8Array(bytes)
+    if (typeof bytes === 'string' && bytes.startsWith('0x')) {
       const idx = bytes.indexOf('::')
       if (idx > 0) {
         suffix = bytes.slice(idx)
         bytes = bytes.slice(0, idx)
       }
     }
-    if (dataLength(bytes) > 32) throw new CCIPAptosAddressInvalidError(hexlify(bytes))
+    bytes = getDataBytes(bytes)
+    if (bytes.length > 32) throw new CCIPAptosAddressInvalidError(hexlify(bytes))
     return zeroPadValue(bytes, 32) + suffix
   }
 

ccip-sdk/src/aptos/logs.ts

@@ -10,10 +10,10 @@ import { memoize } from 'micro-memoize'
 import type { LogFilter } from '../chain.ts'
 import {
   CCIPAptosAddressModuleRequiredError,
-  CCIPAptosTopicInvalidError,
   CCIPAptosTransactionTypeUnexpectedError,
   CCIPLogsWatchRequiresFinalityError,
   CCIPLogsWatchRequiresStartError,
+  CCIPTopicsInvalidError,
 } from '../errors/index.ts'
 import type { Log_ } from '../types.ts'
 import { sleep } from '../utils.ts'
@@ -245,11 +245,11 @@ export async function* streamAptosLogs(
   const limit = 100
   if (!opts.address || !opts.address.includes('::')) throw new CCIPAptosAddressModuleRequiredError()
   if (opts.topics?.length !== 1 || typeof opts.topics[0] !== 'string')
-    throw new CCIPAptosTopicInvalidError()
+    throw new CCIPTopicsInvalidError(opts.topics!)
   let eventHandlerField = opts.topics[0]
   if (!eventHandlerField.includes('/')) {
     eventHandlerField = (eventToHandler as Record<string, string>)[eventHandlerField]!
-    if (!eventHandlerField) throw new CCIPAptosTopicInvalidError(opts.topics[0])
+    if (!eventHandlerField) throw new CCIPTopicsInvalidError(opts.topics)
   }
   const [stateAddr] = await ctx.provider.view<[string]>({
     payload: {

ccip-sdk/src/errors/codes.ts

@@ -134,7 +134,6 @@ export const CCIPErrorCode = {
   APTOS_TX_TYPE_INVALID: 'APTOS_TX_TYPE_INVALID',
   APTOS_TX_TYPE_UNEXPECTED: 'APTOS_TX_TYPE_UNEXPECTED',
   APTOS_ADDRESS_MODULE_REQUIRED: 'APTOS_ADDRESS_MODULE_REQUIRED',
-  APTOS_TOPIC_INVALID: 'APTOS_TOPIC_INVALID',
   APTOS_HASHER_VERSION_UNSUPPORTED: 'APTOS_HASHER_VERSION_UNSUPPORTED',
 
   // HTTP & RPC