ivza-sdk

Execution Layer for Solana

Website · Docs · GitHub · X

TypeScript SDK for IVZA. Analyzes transaction dependencies, detects non-conflicting account sets, and restructures multi-step operations into parallel execution lanes on Solana.

Install

npm install ivza-sdk

Quick Start

import { IvzaClient } from "ivza-sdk";
import { Connection, Keypair } from "@solana/web3.js";

const connection = new Connection("https://api.mainnet-beta.solana.com");
const wallet = Keypair.fromSecretKey(/* ... */);

const client = new IvzaClient(connection, wallet);

// describe what you want — IVZA handles execution
const plan = await client.processIntent(`
  swap 500 USDC to SOL
  stake 50% of output SOL
`);

// 2 intents -> 5 nodes -> 2 parallel lanes
const results = await client.executeLocally(plan);

Intent DSL

Express complex operations in plain text. Deterministic parser — no LLM, no ambiguity.

swap 100 USDC to SOL
stake 50% of output SOL
transfer 10 SOL to 7xKp...3nF

The parser tokenizes, resolves mints, derives ATAs, and builds a full transaction graph from each line.

Graph Builder

For more control, use the fluent graph builder API:

import { TransactionGraphBuilder } from "ivza-sdk";

const builder = new TransactionGraphBuilder();

const swap = builder.addNode("swap_usdc_sol", [swapInstruction]);
const stake = builder.addNode("stake_sol", [stakeInstruction]);

builder.addEdge(swap, stake); // stake depends on swap output

const graph = builder.build();
const plan = client.analyzeGraph(graph);

Core Modules

| Module | Description | |--------|-------------| | IvzaClient | Main entry point. Intent parsing, graph analysis, execution. | | TransactionGraph | DAG with topological sort, cycle detection, parallel level computation. | | TransactionGraphBuilder | Fluent API for constructing transaction graphs. | | IntentParser | DSL and JSON intent parsing with validation. | | ParallelExecutor | Lane-based parallel execution with retry and backoff. | | BundleBuilder | Jito-compatible bundle construction and submission. | | ConnectionManager | Multi-endpoint RPC with health checks and failover. |

How It Works

Intent → Decompose → Analyze → Schedule → Execute
                         |           |          |
                    read/write    parallel    Jito
                    conflict     lane        bundles
                    detection    packing

1. Decompose — Break intents into atomic instruction nodes with account access patterns
2. Analyze — Detect read/write conflicts across all node pairs
3. Schedule — Pack non-conflicting nodes into parallel lanes
4. Execute — Submit lanes concurrently as Jito bundles on Sealevel

Links

• Website — ivza.dev
• Documentation — ivza.dev/docs
• SDK Reference — ivza.dev/docs/sdk
• GitHub — github.com/ivzadotdev/ivza
• X — @ivzadotdev

License

MIT