VorqAI Agent

VorqAI is a liquidity intelligence agent for Robinhood Chain markets. It reads pool and position data through provider adapters, validates market inputs, ranks liquidity opportunities, requests reasoning from an external agent endpoint, and prepares guarded position actions.

Capabilities

• On-chain pool reads through eth_call and eth_getLogs
• Direct Uniswap v3 pool lookup through factory.getPool(token0, token1, fee)
• Chain-backed pool and position reads through RpcChainClient
• Pool and position providers for JSON-RPC and HTTP sources
• Input validation for pool, APR, liquidity, volatility, and position range data
• Confidence and range-risk scoring
• Entry, exit, and hold signal generation
• OpenAI-compatible reasoning provider for trader-facing explanations
• Confirmation and risk safeguards before action preparation
• Runtime tests for validation, ranking, and safeguard behavior
• Non-custodial action model documented in docs/SECURITY_MODEL.md

Source Layout

contracts/
  VorqPositionIntentGuard.sol
abis/
  NonfungiblePositionManager.json
  UniswapV3Factory.json
  UniswapV3Pool.json
  VorqPositionIntentGuard.json
deployments/
  robinhood-mainnet.json
src/
  chain.ts
  chat.ts
  index.ts
  providers.ts
  reasoning.ts
  robinhood.ts
  contracts.ts
  safeguards.ts
  scoring.ts
  strategy.ts
  types.ts
  uniswap-v3.ts
  validation.ts
  vorqai.ts
tests/
  validation.test.ts

Integration

import { OpenAiReasoningProvider, ROBINHOOD_CHAIN, RpcChainClient, UniswapV3FactoryPoolProvider, VorqAI } from "@vorq/vorqai-agent";

const chainClient = new RpcChainClient(ROBINHOOD_CHAIN.rpcUrl);

const agent = VorqAI.createAgent({
  poolProvider: new UniswapV3FactoryPoolProvider(chainClient, {
    factoryAddress: ROBINHOOD_CHAIN.uniswap.v3.factory
  }),
  reasoningProvider: new OpenAiReasoningProvider(process.env.OPENAI_API_KEY)
});

const signals = await agent.scan(userAddress);
const response = await agent.chat(
  "Find the strongest pool by reward quality, confidence, and range risk.",
  userAddress
);
const prepared = agent.prepareAction({
  signal: signals[0],
  address: userAddress,
  userConfirmed: true,
  slippageBps: 50
});

Configuration

Robinhood Chain RPC: https://rpc.mainnet.chain.robinhood.com
Robinhood Chain ID: 4663
Uniswap V3 Factory: 0x1f7d7550B1b028f7571E69A784071F0205FD2EfA
Uniswap V3 PoolCreated from block: 0x1a8a173
Uniswap V3 PoolCreated topic: 0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118

OPENAI_API_KEY is supplied by the deployment environment and should never be committed to the repository.

Contract addresses and ABI surfaces are tracked in deployments/robinhood-mainnet.json, abis/, and docs/CONTRACTS.md.

Verification

npm install
npm run typecheck
npm test
npm run check:data
VORQ_TOKEN0=0x... VORQ_TOKEN1=0x... VORQ_FEE_TIER=3000 npm run check:pool