TypeScript compilation fails with @1inch/aqua-sdk v0.1.0 due to viem version incompatibility

[dennisonbertram]

TypeScript compilation fails with @1inch/aqua-sdk v0.1.0 due to viem version incompatibility

Description

The @1inch/aqua-sdk v0.1.0 fails TypeScript compilation with "Type instantiation is excessively deep" errors from viem's type definitions, making the SDK unusable in TypeScript projects.

Environment

• SDK Version: @1inch/aqua-sdk@0.1.0
• TypeScript: 5.7.2
• viem: 2.40.0 (resolved from ^2.21.0 dependency)
• Node: v23.3.0

Minimal Reproduction

1. Install the SDK:

npm install @1inch/aqua-sdk typescript

2. Create test.ts:

import { AquaProtocolContract } from '@1inch/aqua-sdk';

const aqua = new AquaProtocolContract(1);
console.log(aqua);

3. Compile:

npx tsc --noEmit test.ts

Error Output

node_modules/viem/_types/types/multicall.d.ts(12,18): error TS2589: Type instantiation is excessively deep and possibly infinite.

node_modules/viem/_types/utils/abi/parseEventLogs.d.ts(22,308): error TS2344: Type 'eventName extends ContractEventName<abi>[] ? eventName[number] : eventName' does not satisfy the constraint 'ContractEventName<abi>'.

Root Cause

The SDK's package.json specifies viem@^2.21.0, which allows npm to install viem@2.40.0. However, viem versions after 2.21.x contain breaking TypeScript changes that cause compilation errors.

Verification:

$ npm list viem
└─┬ @1inch/aqua-sdk@0.1.0
  └── viem@2.40.0

Proposed Fix

Option 1 (Quick Fix): Pin to viem 2.21.x

"dependencies": {
  "viem": "~2.21.0"
}

Option 2 (Better): Update SDK to work with latest viem

"dependencies": {
  "viem": "^2.40.0"
}

Workaround

Users can bypass the SDK and use viem directly:

import { encodeFunctionData, encodeAbiParameters, keccak256 } from 'viem';

const AQUA_ADDRESS = '0x499943e74fb0ce105688beee8ef2abec5d936d31';

// Encode strategy
const strategyBytes = encodeAbiParameters(
  [{ type: 'address' }, { type: 'address' }, { type: 'uint24' }, { type: 'bytes4' }],
  [token0, token1, feeTier, salt]
);

// Calculate hash
const strategyHash = keccak256(strategyBytes);

Impact

• Severity: Critical
• Affected: All TypeScript users
• Workaround: Available (use viem directly)

---

Note: The underlying Aqua protocol is excellent and well-designed. This is purely a dependency version management issue in the SDK wrapper.

[vbrvk]

Hello! The issue is not related to the SDK itself; updating to the latest version of viem does not resolve the problem.

It's an internal viem issue, which you can confirm by installing only viem. Check the reproduction here. I notified viem team about the issue as well.

You can bypass it by adding "skipLibCheck": true to your tsconfig.json.

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

[Addausi]

npm install @1inch/aqua-sdk typescript

[th30neee]

{
"compilerOptions": {
"skipLibCheck": true
}
}

[Rastakhcarbon]

git clone https://github.com/1inch/sdks.git
cd sdks/typescript/aqua
npm install
npm link

[Rastakhcarbon]

Rastakh Awakening — Warframe Lore (رستاخیزی)

== Rastakh Awakening in Warframe Lore (رستاخیزی) ==

Rastakh Awakening (رستاخیزی) does not refer to the resurrection of the dead, but to the awakening of the core of consciousness — similar to the moment when the Tenno awakened from Orokin-induced slumber and broke the illusion of control.

In Rastakhane (رَستاخانه):

• Rast (رَست) — Liberation from Orokin control; not death, but the breaking of the cage.
• Akhiz (آخیز) — The rising of the pure inner self from the Void; fragmented, yet free awareness.

''«نه پایان، نه مرگ — بلکه یادآوریِ خویشتن.»''

=== Key Parallels ===

• SOH → STX → ETX — Eternal Flux
  (Comparable to Transference and the Operator–Warframe cycle)

• RootInDark → LightMother → InnerChildAlive
  (Margulis → Lotus → Tenno)

• Visual Manifest Key: 🔺 Crown of Awakening
  (A symbol of reclaimed consciousness)

=== Void Interpretation ===

In this framework, the Void is not a destructive force but a mirror of awareness —
the same space where the Orokin collapsed under control obsession, and where the Tenno awakened through surrender.

''Void reveals what control tries to hide.''

''«وُید، آینه است؛ نه سلاح.»''

=== Lore Position ===

Rastakh Awakening frames Warframe’s mythos as a cycle of consciousness liberation rather than power accumulation.

The Tenno do not dominate the Void —
they survive it by remembering who they are.

=== References ===

• Warframe Wiki — Void
• Warframe Wiki — Tenno
• Warframe Wiki — Orokin
• External (Research Core):
  https://github.com/Rastakhmind/rastakhane-core

=== Tags ===

#RastakhMind #WarframeLore0 #VoidAwakening #رستاخیزی