Add FCR finality flag parsing by PabloMansanet · Pull Request #221 · smartcontractkit/ccip-tools-ts

PabloMansanet · 2026-04-08T10:16:57Z

No description provided.

vercel · 2026-04-08T10:17:02Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ccip-tools-ts	Ready	Preview, Comment	Apr 22, 2026 8:50pm

github-actions · 2026-04-08T10:18:34Z

👋 PabloMansanet, 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!

github-actions · 2026-04-22T20:52:29Z

Coverage Report

ℹ tests 791
ℹ suites 230
ℹ pass 789
ℹ fail 0
ℹ cancelled 0
ℹ skipped 2
ℹ todo 0
ℹ duration_ms 91638.946918

> @chainlink/ccip-cli@1.5.0 test
> node --test

Verbose mode enabled
▶ getCtx
  ▶ output — always stdout
    ✔ output.write goes to stdout (1.242313ms)
    ✔ output.table goes to stdout (1.029317ms)
  ✔ output — always stdout (3.217125ms)
  ▶ logger — always stderr
    ✔ logger.info goes to stderr (0.500214ms)
    ✔ logger.warn goes to stderr (0.259661ms)
    ✔ logger.error goes to stderr (0.337799ms)
  ✔ logger — always stderr (1.56527ms)
  ▶ verbose mode
    ✔ logger.debug is a no-op when verbose is false (0.479333ms)
    ✔ logger.debug goes to stderr when verbose is true (1.084786ms)
  ✔ verbose mode (1.753794ms)
  ▶ destroy signal
    ✔ returns a working destroy function (11.873993ms)
    ✔ calling destroy twice does not throw (0.613505ms)
  ✔ destroy signal (12.658466ms)
✔ getCtx (19.931737ms)
▶ lane-latency command
  ✔ should output JSON format correctly (6.261661ms)
  ✔ should resolve chain IDs to chain selectors (0.691923ms)
  ✔ should use custom API URL when provided (2.137959ms)
  ✔ should output log format correctly (0.906297ms)
  ✔ should handle chain IDs as input (0.757282ms)
  ✔ should handle chain selectors as input (0.902201ms)
  ✔ should throw CCIPApiClientNotAvailableError when --no-api flag is set (1.100049ms)
  ✔ should work normally when --no-api flag is false (0.59654ms)
  ✔ should forward blockConfirmations to API URL (0.528507ms)
  ✔ should not include numOfBlocks when blockConfirmations is not provided (0.560294ms)
  ▶ CCIP_API environment variable integration
    ✔ should respect CCIP_API=false environment variable (0.59718ms)
  ✔ CCIP_API environment variable integration (0.772094ms)
✔ lane-latency command (17.203684ms)
▶ selectRequest non-interactive behavior
  ✔ returns the single request without prompting (1.237756ms)
  ✔ returns the request matching logIndex (0.211769ms)
  ✔ throws CCIPInteractiveRequiredError for multiple requests without logIndex (1.990561ms)
✔ selectRequest non-interactive behavior (4.946608ms)
▶ CCIPInteractiveRequiredError
  ✔ has correct code and is not transient (0.277699ms)
  ✔ uses default recovery when none provided (0.29824ms)
  ✔ preserves context fields (0.179651ms)
✔ CCIPInteractiveRequiredError (0.952316ms)
▶ preprocessArgv TTY auto-detection
  ✔ --interactive flag is defined in globalOpts (0.189015ms)
✔ preprocessArgv TTY auto-detection (0.329257ms)
▶ search messages command
  ✔ should throw CCIPApiClientNotAvailableError when --no-api flag is set (2.440249ms)
  ✔ should output JSON format correctly (13.060182ms)
  ✔ should pass sender filter to API (2.957539ms)
  ✔ should pass receiver filter to API (5.413352ms)
  ✔ should resolve source chain to selector (3.666419ms)
  ✔ should resolve dest chain to selector (4.943754ms)
  ✔ should pass manual-exec-only filter to API (5.565817ms)
  ✔ should treat limit 0 as unlimited (4.849172ms)
  ✔ should respect limit parameter (11.584982ms)
  ✔ should warn when no results found (2.270253ms)
  ✔ should use custom API URL when provided (2.459358ms)
  ✔ should warn on negative limit and fall back to default (1.794576ms)
  ✔ should output log format (1.667635ms)
✔ search messages command (64.514733ms)
▶ e2e command show EVM
  ▶ pretty format (default)
    ✔ should show complete CCIP transaction details EVM to EVM (8585.545215ms)
  ✔ pretty format (default) (8586.520837ms)
  ▶ json format
    ✔ should output a single valid JSON envelope with all expected fields (6852.721457ms)
  ✔ json format (6853.117634ms)
  ▶ log format
    ✔ should output in log format with object assignments (6532.92919ms)
  ✔ log format (6533.178446ms)
  ▶ verbose flag
    ✔ should work with verbose flag enabled (7439.685327ms)
  ✔ verbose flag (7439.89971ms)
  ▶ error handling
    ✔ should handle invalid transaction hash gracefully (6630.90772ms)
    ✔ should require transaction hash argument (1593.926648ms)
  ✔ error handling (8225.138697ms)
  ✔ should show complete CCIP transaction details EVM to Aptos (7767.044132ms)
  ✔ should show complete CCIP transaction details EVM to Solana (6259.935932ms)
✔ e2e command show EVM (51666.213074ms)
▶ e2e command show Solana
  ✔ should show complete CCIP transaction details Solana to EVM (6489.208697ms)
✔ e2e command show Solana (6489.471413ms)
▶ e2e command show Aptos
  ✔ should show complete CCIP transaction details Aptos to EVM (7255.872466ms)
✔ e2e command show Aptos (7256.068091ms)
﹣ e2e command show TON (0.058919ms) # SKIP
▶ formatCCIPError
  ✔ should return null for non-CCIPError instances (1.675176ms)
  ✔ should format CCIPError with code and message (0.569148ms)
  ✔ should include help section with recovery hint (0.201614ms)
  ✔ should include note section for transient errors (0.539142ms)
  ✔ should include retry timing for transient errors with retryAfterMs (0.394245ms)
  ✔ should not include note section for permanent errors (0.226331ms)
  ✔ should format error with structured output (0.256887ms)
  ✔ should include stack trace when verbose is true (0.446854ms)
  ✔ should not include stack trace when verbose is false (0.189086ms)
✔ formatCCIPError (7.327438ms)
ℹ tests 59
ℹ suites 21
ℹ pass 59
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 67622.917524
-------------------------------|---------|----------|---------|---------|---------------------------
File                           | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s         
-------------------------------|---------|----------|---------|---------|---------------------------
All files                      |   74.85 |    76.67 |   61.83 |   74.85 |                           
 ccip-cli/src                  |   89.47 |    61.53 |      75 |   89.47 |                           
  index.ts                     |   89.47 |    61.53 |      75 |   89.47 | ...47-151,157-158,163-168 
 ccip-cli/src/commands         |   51.08 |    72.45 |   52.72 |   51.08 |                           
  index.ts                     |     100 |      100 |     100 |     100 |                           
  lane-latency.ts              |   72.56 |     90.9 |   33.33 |   72.56 | 41-56,63-70,105-111       
  manual-exec.ts               |   25.36 |      100 |       0 |   25.36 | 62-116,123-133,135-274    
  parse.ts                     |   57.14 |      100 |       0 |   57.14 | 46-50,57-64,66-91         
  search.ts                    |   81.25 |      100 |       0 |   81.25 | 24-29                     
  send.ts                      |   15.06 |      100 |       0 |   15.06 | ...72-179,189-220,222-458 
  show.ts                      |   77.62 |    61.42 |   66.66 |   77.62 | ...49-257,261-274,305-306 
  supported-tokens.ts          |   17.66 |      100 |       0 |   17.66 | ...11-243,245-319,321-334 
  token.ts                     |   22.72 |      100 |       0 |   22.72 | 24-53,60-67,69-132        
  types.ts                     |     100 |      100 |     100 |     100 |                           
  utils.ts                     |   85.94 |    74.82 |    92.3 |   85.94 | ...99-609,617-625,635-641 
 ccip-cli/src/commands/search  |   49.39 |    83.33 |   14.28 |   49.39 |                           
  messages.ts                  |   49.39 |    83.33 |   14.28 |   49.39 | ...86-188,190-212,214-249 
 ccip-cli/src/providers        |   49.46 |    75.51 |      16 |   49.46 |                           
  aptos.ts                     |   51.47 |      100 |       0 |   51.47 | ...74,82-89,95-96,105-136 
  evm.ts                       |    36.3 |      100 |       0 |    36.3 | 27,47-63,69-104,116-168   
  index.ts                     |   80.16 |    72.72 |      80 |   80.16 | 51-52,193-237             
  solana.ts                    |   47.44 |      100 |       0 |   47.44 | ...,92-98,102-103,112-137 
  sui.ts                       |   64.28 |      100 |       0 |   64.28 | 10-14                     
  ton.ts                       |   15.03 |      100 |       0 |   15.03 | 24-153                    
 ccip-sdk/src                  |   94.43 |    82.15 |   92.77 |   94.43 |                           
  chain.ts                     |   93.04 |    81.01 |   71.42 |   93.04 | ...58,1708-1709,1742-1743 
  commits.ts                   |     100 |    95.23 |     100 |     100 | 52                        
  execution.ts                 |   92.19 |     92.3 |     100 |   92.19 | 130-137,149-156           
  explorer.ts                  |     100 |      100 |     100 |     100 |                           
  extra-args.ts                |      99 |    86.11 |     100 |      99 | 282-284                   
  gas.ts                       |   89.75 |       40 |     100 |   89.75 | 108-119,147-151           
  http-status.ts               |     100 |      100 |     100 |     100 |                           
  index.ts                     |     100 |      100 |     100 |     100 |                           
  messages.ts                  |   88.53 |    45.09 |     100 |   88.53 | ...20-221,230-231,255-256 
  offchain.ts                  |   94.14 |    79.54 |     100 |   94.14 | ...90,208,223-225,234-235 
  requests.ts                  |   90.63 |    80.55 |     100 |   90.63 | ...82-283,351-364,366-370 
  supported-chains.ts          |     100 |      100 |     100 |     100 |                           
  types.ts                     |     100 |      100 |     100 |     100 |                           
  utils.ts                     |   96.36 |    90.32 |     100 |   96.36 | ...67,783,884-885,892-900 
 ccip-sdk/src/api              |   93.75 |       85 |   94.11 |   93.75 |                           
  index.ts                     |   93.75 |       85 |   94.11 |   93.75 | ...39-744,755-758,761-764 
 ccip-sdk/src/aptos            |    55.7 |    69.46 |   55.73 |    55.7 |                           
  exec.ts                      |   29.31 |      100 |       0 |   29.31 | 18-58                     
  hasher.ts                    |   76.31 |       80 |   66.66 |   76.31 | 19-38,52-58               
  index.ts                     |    56.4 |       75 |   58.13 |    56.4 | ...26-828,832-858,862-873 
  logs.ts                      |   78.52 |    57.44 |      75 |   78.52 | ...90-196,200-233,264-268 
  send.ts                      |    25.2 |      100 |       0 |    25.2 | 10-51,62-79,92-123        
  token.ts                     |   23.75 |       75 |     100 |   23.75 | 35-156                    
  types.ts                     |   65.62 |      100 |       0 |   65.62 | 25-32,64-88               
 ccip-sdk/src/errors           |   87.41 |    76.16 |   48.38 |   87.41 |                           
  CCIPError.ts                 |     100 |      100 |     100 |     100 |                           
  codes.ts                     |     100 |      100 |     100 |     100 |                           
  index.ts                     |     100 |      100 |     100 |     100 |                           
  recovery.ts                  |     100 |      100 |     100 |     100 |                           
  specialized.ts               |   84.66 |    71.25 |   45.76 |   84.66 | ...27,3348-3357,3378-3387 
  utils.ts                     |   94.44 |    81.48 |     100 |   94.44 | 15,17,22,24               
 ccip-sdk/src/evm              |   82.79 |    74.13 |   89.02 |   82.79 |                           
  const.ts                     |     100 |      100 |     100 |     100 |                           
  errors.ts                    |   84.61 |    78.82 |     100 |   84.61 | ...56-161,170-172,215-233 
  extra-args.ts                |   94.47 |    61.01 |     100 |   94.47 | ...85-186,211-212,328-340 
  fork.test.data.ts            |     100 |      100 |     100 |     100 |                           
  gas.ts                       |   97.97 |    53.33 |     100 |   97.97 | 72-73,75                  
  hasher.ts                    |     100 |     92.3 |     100 |     100 | 134                       
  index.ts                     |   79.71 |    74.69 |   90.16 |   79.71 | ...63,2127-2143,2169-2176 
  logs.ts                      |   34.32 |    68.42 |      25 |   34.32 | ...13-214,229-258,275-302 
  messages.ts                  |     100 |      100 |     100 |     100 |                           
  offchain.ts                  |   81.25 |    33.33 |     100 |   81.25 | 11,13-14                  
  types.ts                     |     100 |      100 |     100 |     100 |                           
 ccip-sdk/src/evm/viem         |   77.72 |       92 |   69.23 |   77.72 |                           
  client-adapter.ts            |     100 |     92.3 |     100 |     100 | 48                        
  index.ts                     |     100 |      100 |     100 |     100 |                           
  wallet-adapter.ts            |   63.09 |     90.9 |   55.55 |   63.09 | ...6,53-73,91-124,131-157 
 ccip-sdk/src/hasher           |   94.29 |    78.94 |     100 |   94.29 |                           
  common.ts                    |     100 |      100 |     100 |     100 |                           
  hasher.ts                    |     100 |    66.66 |     100 |     100 | 19                        
  index.ts                     |     100 |      100 |     100 |     100 |                           
  merklemulti.ts               |   93.43 |       78 |     100 |   93.43 | ...59-260,306-307,315-316 
 ccip-sdk/src/shared           |   88.05 |    69.23 |     100 |   88.05 |                           
  bcs-codecs.ts                |   87.87 |    66.66 |     100 |   87.87 | 75-87,104-106             
  constants.ts                 |     100 |      100 |     100 |     100 |                           
 ccip-sdk/src/solana           |   73.14 |    68.13 |   77.01 |   73.14 |                           
  cleanup.ts                   |   26.63 |    66.66 |   33.33 |   26.63 | 43-53,59-101,113-226      
  exec.ts                      |   69.05 |    62.96 |   66.66 |   69.05 | ...61-463,468-472,512-513 
  fork.test.data.ts            |     100 |      100 |     100 |     100 |                           
  hasher.ts                    |   96.58 |    81.81 |     100 |   96.58 | 67-70                     
  index.ts                     |   76.68 |       75 |   78.84 |   76.68 | ...58,1562-1583,1587-1620 
  logs.ts                      |   74.83 |    38.88 |     100 |   74.83 | 38-39,50-51,53-54,56-88   
  offchain.ts                  |     100 |      100 |     100 |     100 |                           
  patchBorsh.ts                |   78.31 |       50 |     100 |   78.31 | 34-35,41-47,65-66,72-78   
  send.ts                      |   77.55 |    33.33 |      80 |   77.55 | ...45-346,351-359,402-441 
  types.ts                     |     100 |      100 |     100 |     100 |                           
  utils.ts                     |   67.41 |    68.96 |   63.63 |   67.41 | ...36-439,442-444,476-491 
 ccip-sdk/src/sui              |   32.62 |    89.47 |   17.24 |   32.62 |                           
  discovery.ts                 |   14.86 |      100 |       0 |   14.86 | 20-36,49-185,188-222      
  events.ts                    |    19.9 |      100 |       0 |    19.9 | ...18-275,280-397,406-427 
  exec.ts                      |   31.29 |      100 |       0 |   31.29 | 31-74,86-131              
  hasher.ts                    |   98.16 |    66.66 |     100 |   98.16 | 33,49                     
  index.ts                     |   40.44 |    93.18 |   17.94 |   40.44 | ...12-813,817-818,822-823 
  objects.ts                   |   18.93 |      100 |       0 |   18.93 | ...04-119,133-184,195-338 
 ccip-sdk/src/sui/manuallyExec |   39.63 |      100 |       0 |   39.63 |                           
  encoder.ts                   |   47.67 |      100 |       0 |   47.67 | 42-86                     
  index.ts                     |   34.35 |      100 |       0 |   34.35 | 46-131                    
 ccip-sdk/src/ton              |   76.52 |    80.63 |   71.42 |   76.52 |                           
  exec.ts                      |     100 |      100 |     100 |     100 |                           
  extra-args.ts                |   98.66 |    72.72 |     100 |   98.66 | 156-157,222               
  hasher.ts                    |   77.95 |    77.77 |      75 |   77.95 | 99-107,155-186            
  index.ts                     |   70.86 |    76.72 |   55.55 |   70.86 | ...05,1212-1213,1220-1221 
  logs.ts                      |     100 |    98.43 |     100 |     100 | 56                        
  send.ts                      |   95.93 |       70 |     100 |   95.93 | 37-44                     
  types.ts                     |   77.94 |    69.23 |   66.66 |   77.94 | ...-73,91,118-131,133-136 
  utils.ts                     |   63.02 |    78.18 |    90.9 |   63.02 | ...22-328,336-394,396-399 
-------------------------------|---------|----------|---------|---------|---------------------------

Add FCR finality flag parsing

1c27539

PabloMansanet requested a review from andrevmatos April 8, 2026 10:16

PabloMansanet requested review from a team and aelmanaa as code owners April 8, 2026 10:16

andrevmatos added 4 commits April 18, 2026 23:24

improve evm error handling, fix bare Error lint rule

7c1adeb

don't error and don't set gasLimit in manuallyExecute estimation error

f2b0a02

update abis

df207b9

FCR

60d91dd

andrevmatos requested review from a team as code owners April 19, 2026 04:08

vercel Bot deployed to Preview April 19, 2026 04:13 View deployment

andrevmatos force-pushed the fcr-flag-parsing branch from 9b5823c to 9eb29ec Compare April 20, 2026 13:13

vercel Bot deployed to Preview April 20, 2026 13:19 View deployment

Merge branch 'main' into fcr-flag-parsing

f4af166

andrevmatos force-pushed the fcr-flag-parsing branch from 9eb29ec to f4af166 Compare April 20, 2026 13:19

vercel Bot deployed to Preview April 20, 2026 13:23 View deployment

AmrMohamedRezk reviewed Apr 21, 2026

View reviewed changes

Comment thread ccip-sdk/src/chain.ts

andrevmatos added 2 commits April 21, 2026 10:58

fix lint

54bb697

chore: bump v1.5.0, deps

0ab1360

vercel Bot deployed to Preview April 21, 2026 15:28 View deployment

fix finality extraArgs assignment

afb7d5f

vercel Bot deployed to Preview April 21, 2026 16:21 View deployment

fix fork tests

486cdcd

aelmanaa force-pushed the fcr-flag-parsing branch from 3446f33 to 486cdcd Compare April 22, 2026 16:06

vercel Bot deployed to Preview April 22, 2026 16:12 View deployment

bump surfpool ci version

65d57fb

vercel Bot deployed to Preview April 22, 2026 17:41 View deployment

ci: enable VERBOSE logging to diagnose Solana fork test failures

aee45cf

aelmanaa force-pushed the fcr-flag-parsing branch from df2a32c to aee45cf Compare April 22, 2026 18:55

vercel Bot deployed to Preview April 22, 2026 19:03 View deployment

aelmanaa closed this Apr 22, 2026

aelmanaa reopened this Apr 22, 2026

chore: retrigger CI

df3db0a

vercel Bot deployed to Preview April 22, 2026 19:22 View deployment

Merge branch 'main' into fcr-flag-parsing

95374a9

vercel Bot deployed to Preview April 22, 2026 19:30 View deployment

fix lint

a368172

andrevmatos force-pushed the fcr-flag-parsing branch from 852f8c0 to a368172 Compare April 22, 2026 20:17

vercel Bot deployed to Preview April 22, 2026 20:23 View deployment

andrevmatos and others added 2 commits April 22, 2026 16:26

bump deps

cdb93a2

fix port collision

c38a8f8

aelmanaa force-pushed the fcr-flag-parsing branch from 6561bd3 to c38a8f8 Compare April 22, 2026 20:31

vercel Bot deployed to Preview April 22, 2026 20:38 View deployment

andrevmatos added 2 commits April 22, 2026 16:46

fix lint again

3a109b9

add changelog

f4fdfaa

aelmanaa approved these changes Apr 22, 2026

View reviewed changes

andrevmatos approved these changes Apr 22, 2026

View reviewed changes

vercel Bot deployed to Preview April 22, 2026 20:50 View deployment

andrevmatos merged commit 5be952b into main Apr 22, 2026
13 checks passed

andrevmatos deleted the fcr-flag-parsing branch April 22, 2026 20:53

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add FCR finality flag parsing#221

Add FCR finality flag parsing#221
andrevmatos merged 19 commits intomainfrom
fcr-flag-parsing

PabloMansanet commented Apr 8, 2026

Uh oh!

vercel Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 8, 2026

Uh oh!

Uh oh!

github-actions Bot commented Apr 22, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

PabloMansanet commented Apr 8, 2026

Uh oh!

vercel Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 8, 2026

Uh oh!

Uh oh!

github-actions Bot commented Apr 22, 2026

Coverage Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

vercel Bot commented Apr 8, 2026 •

edited

Loading