TINT-stream-sdk

TINT Protocol & SDK Project Description

1. Project Overview: TINT Protocol TINT (Threshold Intent Netting & Transport) is the first privacy-preserving intent standard designed specifically for AI Agents and high-frequency automated trading. It solves the critical issues of front-running (MEV) and data leakage in DeFi by enabling "dark pool" style execution for on-chain assets.

Core Value Proposition:

• Privacy: Intents are cryptographically shielded using Pedersen Commitments (hiding amounts and strategies).
• Efficiency: Orders are netted off-chain via Yellow Network state channels, meaning only the residual difference is settled on-chain.
• Liquidity: Final settlement occurs on Uniswap V4, ensuring guaranteed execution depth.

1. Architecture Highlights

• Cryptography: Uses lightweight Zero-Knowledge proofs (Pedersen Commitments) to prove solvency without revealing trade details until settlement.
• Network Layer: Built on Yellow Network's P2P state channels for millisecond-latency communication between agents and solvers.
• Settlement Layer: Custom Uniswap V4 Hooks that verify the mathematical proofs on-chain before allowing the trade to proceed.
• Cross-Chain: Integrated Circle Bridge Kit (CCTP) for seamless USDC bridging across Base, Arbitrum, and Ethereum.

1. The TINT SDK (tint-protocol-ai-sdk) The SDK is the developer gateway to the protocol, enabling any application to integrate privacy-preserving AI agent capabilities.

Key Features:

• AI-Powered Intents: Integrated Google Gemini AI to parse natural language commands (e.g., "Swap 100 USDC for WETH on Base") into executable blockchain transactions.
• Shielded Transactions: Automatically handles the complex cryptography required to generate and verify commitments.
• Universal Bridging: Abstracts away the complexity of cross-chain transfers.
• Netting Engine: Includes a client-side solver to compute net positions locally or verifiable off-chain.

TINT Protocol Technical Architecture & Implementation Guide

This document outlines the complete technology stack and implementation details of the TINT Protocol and SDK.

1. Frontend Application (Next.js 16)

• Framework: Next.js 16 (App Router) with React 19 (Server Components).
• Styling: Tailwind CSS v4 (using responsive design and dark mode).
• State Management: React Hooks (useState, useEffect) for local state; URL search params for navigation state.
• Wallet Connection: Custom implementation using ethers.js v6 BrowserProvider (MetaMask/Injected).
• Key Libraries:
  • lucide-react: UI icons.
  • framer-motion: (Conceptually used for UI transitions).
  • @vercel/analytics: (Optional integration).

1. TINT SDK (tint-protocol-ai-sdk)

• Core Logic: Written in TypeScript, compiled to ESM and CJS using tsup.
• AI Agent:
  • Google Gemini AI (@google/generative-ai): Parses natural language prompts into structured JSON intents (SWAP, BRIDGE, TRANSFER).
  • Fallback Mechanism: Regex-based parser for determinism when AI is rate-limited.
• Cryptography:
  • @noble/curves (secp256k1): Implements Elliptic Curve operations for Pedersen Commitments (Homomorphic Encryption).
  • @noble/hashes (SHA3/Keccak): Secure hashing for commitment binding.
• Blockchain Interaction:
  • ethers.js: Management of wallets, signing transactions, and querying JSON-RPC nodes.
  • viem: Lightweight, type-safe Ethereum interface used specifically for the Circle Bridge adapter.

1. Blockchain & DeFi Integration

• Uniswap V4:
  • Custom Hooks: Implemented to verify TINT commitments on-chain before swapping.
  • PoolManager: Direct interaction with the V4 singleton contract for liquidity and swaps.
  • Routing: Custom "Smart Router" logic to find the best path across V4 pools.
• Bridging (Circle CCTP):
  • @circle-fin/bridge-kit: Client-side SDK for burn-and-mint cross-chain USDC transfers.
  • @circle-fin/adapter-viem-v2: Adapter to connect user wallets to the Circle Bridge.
• Yellow Network (State Channels):
  • @erc7824/nitrolite: Protocol for opening high-speed P2P state channels.
  • yellow-ts: Helper library for Yellow Network interactions.
  • Netting: Off-chain aggregation of buy/sell orders significantly reduces gas costs by only settling the net difference.

1. Backend Infrastructure (Serverless)

• API Routes (Next.js):
  • /api/agent/intelligent: Proxies AI requests to keep API keys secure (if needed).
  • /api/uniswap/swap: Handles the complex logic of constructing V4 swap transactions.
  • /api/bridge/retry: Server-side recovery mechanism for failed bridge transactions (relayer).
  • /api/yellow/*: Manages state channel authentication and updates.

1. Critical workflows

• Intent Parsing: User input -> Gemini AI -> JSON Intent Object.
• Commitment Generation: Amount + Randomness -> Pedersen Commitment (Hiding).
• Netting Process:
  1. Multiple intents collected in a batch.
  2. Solvers calculate Net Amount = Total Buys - Total Sells.
  3. A single transaction settles the Net Amount on Uniswap V4.
• Bridging Recovery: If a client-side bridge tx fails (e.g. gas issue), the server detects the "Burn" event and retries the "Mint" on the destination chain using a relayer wallet.