@bidkit/sdk

v0.1.0

Published

2 months ago

Autonomous auction intelligence for AI agents — discover, evaluate, and bid in Uniswap CCA auctions with x402 micropayments on X Layer

0High
0Medium
0Low

agenbyte

bidkit auction uniswap cca okx onchain-os ai-agent defi x402 bidding

BidKit

Autonomous auction intelligence for AI agents

AI agents deserve smarter participation. BidKit autonomously discovers, evaluates, and bids in token auctions — with x402 micropayment settlement on X Layer.

Dashboard Demo · Explorer · Plugin Store · Docs

Why BidKit Exists

Uniswap's Continuous Clearing Auction changed token distribution forever. Aztec raised $59M from 17,000 bidders — zero sniping, zero front-running. CCA is expanding across chains, becoming the standard for fair launches.

But all the tooling serves token launchers. Uniswap released 5 AI plugins with 9 skills for CCA — configurators, deployers, planners. Every one of them helps the supply side.

The demand side has nothing. No discovery. No automated valuation. No risk-managed bidding. No post-auction management. AI agents operating 24/7 cannot participate in CCA auctions at all.

BidKit is the missing demand-side infrastructure.

A Day in the Life of a BidKit Agent

8:00 AM UTC — BidKit's discovery module detects a new CCA auction: Axiom Protocol is distributing 10M tokens over 24 hours with a $0.015 floor price. OKX Security scores the token 87/100. No honeypot, no hidden taxes, ownership renounced. Opportunity score: 91.

8:02 AM — Valuation engine activates. OKX Market API finds 5 comparable tokens averaging $0.025. OKX Signal detects 6 smart money buys in the last hour. CCA clearing price is $0.0215 and rising. Fair value range: $0.018–$0.031. Confidence: 74%.

8:03 AM — Agentic Wallet verifies the intent: "Bid 400 USDC on Axiom CCA, moderate strategy." Spending limit check passes. Contract whitelist verified. Intent approved.

8:03 AM — x402 payment of 0.05 USDC settles on X Layer. BidKit simulates the bid — gas estimated at 247K, no revert. Transaction broadcasts to Ethereum. Bid confirmed in block 19,847,231.

8:04 AM — Position tracked. Entry at $0.0245. Estimated 16,326 AXM tokens at 62% fill probability.

6:00 PM — Auction ends. Clearing price: $0.0267. BidKit claims tokens. P&L: +8.9%. Strategy engine recommends HOLD — price still below fair value ceiling.

Total x402 payments: 4 operations on X Layer = 4 verified on-chain transactions.
Total time: Under 5 minutes from discovery to bid. Zero human intervention.

What BidKit Does

Four stages. One command. Fully autonomous.

   DISCOVER          ANALYZE           EXECUTE          MANAGE
  ┌─────────┐      ┌─────────┐      ┌─────────┐      ┌─────────┐
  │ Scan CCA │─────▶│  Fair   │─────▶│ Simulate│─────▶│  Claim  │
  │ Factory  │      │  Value  │      │  & Bid  │      │  Tokens │
  │          │      │  Range  │      │         │      │         │
  │ Enrich   │      │ Compare │      │  Risk   │      │ HOLD or │
  │ Tokens   │      │ Signals │      │  Check  │      │ SELL or │
  │          │      │         │      │         │      │  LP     │
  │ Security │      │ Smart   │      │ Intent  │      │         │
  │ Filter   │      │ Money   │      │ Verify  │      │ Optimal │
  └─────────┘      └─────────┘      └─────────┘      │  Exit   │
       │                │                │             └─────────┘
       ▼                ▼                ▼                  ▼
   OKX Security    OKX Market      Agentic Wallet     Uniswap V4
   OKX Token       OKX Signal      OKX Gateway        OKX DEX Swap
   Uniswap CCA     Uniswap CCA     Uniswap Viem       Uniswap LP
                                                       Uniswap Hooks
       │                │                │                  │
       └────────────────┴────────────────┴──────────────────┘
                              │
                    x402 Payment on X Layer
                    (every operation settled)

import { createBidKit } from 'bidkit';

const kit = createBidKit();

const auctions = await kit.discovery.scan();              // Find safe opportunities
const report   = await kit.valuation.evaluate(auctions[0]); // AI-powered valuation
const bid      = await kit.bidding.submit(report, 'moderate'); // Risk-managed execution
const exit     = await kit.postAuction.manage(bid);        // Optimal exit strategy

Market Context

The agent economy is accelerating:

$30 trillion projected autonomous agent economy by 2030 (Gartner)
$7.6 billion AI agent market in 2025, growing at 49.6% CAGR (Grand View Research)
$1 trillion agentic AI opportunity (NVIDIA CEO, GTC 2026)
$59 million raised in a single CCA auction (Aztec, November 2025)

Yet agent-to-protocol interaction tooling barely exists. CCA auctions — the fairest token distribution mechanism ever built — have zero demand-side automation. BidKit addresses this gap at the intersection of two massive trends: the agent economy and fair token distribution.

How Uniswap CCA Works

Continuous Clearing Auctions are Uniswap's mechanism for fair token distribution. Unlike traditional launches where bots snipe tokens in the first block, CCA distributes tokens gradually over time at a uniform clearing price.

Traditional Token Launch          Uniswap CCA
━━━━━━━━━━━━━━━━━━━━━━           ━━━━━━━━━━━━━━━━━━━━━━
Block 1: Bots buy everything      Blocks 1-7200: Tokens release gradually
Block 2: Price 10x                Each block: uniform clearing price
Block 3: Bots dump on retail      All bidders above clearing = tokens pro-rata
Result: Unfair distribution       Result: Fair, transparent, zero sniping

The mechanism: A project commits tokens to a CCA smart contract with a floor price and duration (measured in blocks). Bidders submit orders with a budget and maximum price. Each block, the auction clears at a uniform price — everyone above the clearing price receives tokens proportional to their budget. When the auction ends, a Uniswap V4 liquidity pool is automatically seeded at the final clearing price.

Why agents need BidKit: CCA auctions run for hours or days across thousands of blocks. The clearing price shifts continuously based on new bids. Optimal participation requires real-time monitoring, dynamic valuation, and precise timing — exactly what autonomous agents excel at, but only with the right infrastructure.

Multi-Chain Architecture

┌─────────────────────────────────────────────────────────────┐
│                    AGENT (BidKit)                            │
│                                                             │
│  ┌──────────────────────────┐  ┌──────────────────────┐    │
│  │  Ethereum / Arbitrum     │  │  X Layer (196)        │    │
│  │                          │  │                       │    │
│  │  CCA Auction Discovery   │  │  x402 USDC Payments   │    │
│  │  Bid Submission          │  │  BidKitPaymentReceiver│    │
│  │  Token Claiming          │  │  Service Settlement   │    │
│  │  Uniswap V4 LP          │  │  Revenue Tracking     │    │
│  │                          │  │                       │    │
│  │  Where auctions live     │  │  Where BidKit earns   │    │
│  └──────────────────────────┘  └──────────────────────┘    │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  OKX Onchain OS (chain-agnostic intelligence)        │   │
│  │  Market · Signal · Security · Swap · Gateway · Wallet│   │
│  └──────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  Agentic Wallet (TEE-secured execution)               │   │
│  │  Intent Verification · Spending Limits · Sub-Wallets  │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

Auction Layer (Ethereum/Arbitrum): Where Uniswap CCA lives. BidKit scans factory events, submits bids, claims tokens, and manages LP positions.

Payment Layer (X Layer): Every BidKit operation requires an x402 USDC micropayment on X Layer. Live contract with 16 verified transactions.

| Operation | x402 Fee | Chain | |-----------|----------|-------| | discovery.scan() | 0.001 USDC | X Layer | | valuation.evaluate() | 0.01 USDC | X Layer | | bidding.submit() | 0.05 USDC | X Layer | | postAuction.manage() | 0.02 USDC | X Layer | | risk.check() | 0.005 USDC | X Layer |

Why BidKit

| | Manual Bidding | Generic Trading Bot | BidKit | |---|---|---|---| | CCA Auction Discovery | Manual research | Not supported | Automated scanning + scoring | | Token Security Analysis | Check manually | Basic price checks | OKX 8-vector security scoring | | Fair Value Computation | Gut feeling | No valuation model | 4-factor weighted model with confidence | | Bid Optimization | Fixed amount | Fixed strategy | 3 adaptive strategies with simulation | | Risk Management | None | Stop-loss only | 5-layer portfolio protection | | Post-Auction Strategy | Manual decision | Auto-sell only | HOLD / SELL / LP with Uniswap V4 | | Payment Layer | N/A | N/A | x402 micropayments on X Layer | | Wallet Security | Raw private key | Raw private key | Agentic Wallet with TEE + intent verification | | Uniswap Integration | Direct contract calls | None | 5 plugins, 9 skills, native ecosystem | | On-chain Verification | No record | No record | Every operation recorded on X Layer mainnet |

Live on X Layer Mainnet

BidKit is not a prototype. It's deployed and generating real transactions.

| Metric | Value | |--------|-------| | Contract | 0xB979CcADb1acE628909a61E2C0942d69b62Bd223 | | Chain | X Layer Mainnet (196) | | Transactions | 16 verified | | Revenue | 0.258 USDC across 3 rounds | | Agentic Wallet | 0x3ae6dd9075bc44b6e5ca1981fab4cb0edf3c72c0 | | Status | Active |

# Verify on X Layer Explorer
open https://www.okx.com/explorer/xlayer/address/0xB979CcADb1acE628909a61E2C0942d69b62Bd223

OKX Onchain OS — Live API Verification

All 8 OKX capabilities tested with real authenticated API calls:

  1/8 · dex-market (ticker)    PASS   ETH: $2,188.64
  2/8 · index-price            PASS   ETH: $2,188.70
  3/8 · candles                PASS   3 bars OHLCV
  4/8 · order-book             PASS   $0.01 spread
  5/8 · volume                 PASS   $216.2M 24h
  6/8 · comparables            PASS   UNI $3.02, LINK $8.74
  7/8 · system                 PASS   Online
  8/8 · x402                   PASS   16 txns, 0.258 USDC

Run yourself: pnpm live:full (requires OKX API keys from dev portal)

Installation

Claude Code / Agent Platform

# Plugin Store
/plugin marketplace add agenbyte/bidkit

# Skills CLI (any agent)
npx skills add cayvox/bidkit

npm

pnpm add bidkit

From Source

git clone https://github.com/agenbyte/bidkit
cd bidkit && pnpm install && pnpm build

Uniswap AI Integration

BidKit is built on Uniswap's AI skill ecosystem — using all 5 plugins and 9 skills to create the first complete demand-side CCA workflow.

| Plugin | Skill | Where Used | What It Does | |--------|-------|-----------|-------------| | uniswap-cca | configurator | Discovery, Valuation, Bidding | Parses auction config, validates bid parameters against CCA rules | | uniswap-cca | deployer | Discovery | Understands deployment context — LBP strategy, graduation conditions | | uniswap-viem | viem-integration | All modules | Core on-chain interaction: event subscriptions, multicall reads, tx submission | | uniswap-trading | swap-integration | Post-Auction | Executes token swaps via Uniswap Universal Router for SELL exits | | uniswap-trading | pay-with-any-token | Bidding | Auto-swaps agent's held tokens to CCA currency before bidding | | uniswap-driver | swap-planner | Valuation, Post-Auction | Plans optimal swap routes, estimates slippage for exit planning | | uniswap-driver | liquidity-planner | Post-Auction | Calculates concentrated LP tick ranges for CCA-seeded V4 pools | | uniswap-hooks | v4-security-foundations | Post-Auction | Validates pool hooks are safe before committing LP capital | | uniswap-hooks | aggregator-hook-creator | Post-Auction | Generates CCA-aware aggregator hooks for optimized LP management |

These skills compose naturally: the configurator feeds auction parameters to the viem-integration for on-chain reads, which feeds the swap-planner for exit estimation, which informs liquidity-planner for LP decisions — validated by v4-security-foundations before execution.

OKX Onchain OS Integration

8 capabilities spanning market intelligence, security, execution, and payments:

| Capability | Module | What It Powers | |-----------|--------|---------------| | dex-token | Discovery | Token metadata: holders, supply, pools, market cap | | dex-market | Valuation | Real-time prices, OHLCV data, comparable token rankings | | dex-signal | Valuation | Smart money tracking: KOL buys/sells, whale movements | | dex-swap | Post-Auction | DEX aggregation across 500+ sources for best exit price | | wallet-portfolio | Bidding, Risk | Portfolio balance tracking for budget and exposure calculation | | onchain-gateway | Bidding | Pre-flight transaction simulation and gas estimation | | token-security-check | Discovery, Risk | Honeypot detection, ownership analysis, tax rate verification | | x402 | Payments | Gas-free USDC micropayments on X Layer for every operation |

Agentic Wallet Integration

BidKit's onchain identity: 0x3ae6dd9075bc44b6e5ca1981fab4cb0edf3c72c0 (OKX Agentic Wallet, TEE-secured)

BidKit integrates OKX Agentic Wallet for TEE-secured agent operations:

Intent Verification: Every transaction (bid, claim, swap, x402 payment) requires explicit intent approval before execution
Spending Limits: Configurable per-transaction (default 1,000 USDC) and daily caps (default 5,000 USDC)
Contract Whitelisting: Agents can only interact with approved contract addresses
Sub-Wallet Isolation: Each agent operates in its own TEE-secured sub-wallet (up to 50 per main wallet)
Risk Classification: Transactions auto-classified as low/medium/high risk based on value and target

X Layer Smart Contract

BidKitPaymentReceiver.sol — Live on X Layer Mainnet

| | | |---|---| | Contract | 0xB979CcADb1acE628909a61E2C0942d69b62Bd223 | | Chain | X Layer Mainnet (196) | | USDC | 0x74b7f16337b8972027f6196a17a631ac6de26d22 | | Transactions | 16 verified | | Revenue | 0.258 USDC |

// Every BidKit operation = on-chain payment record on X Layer
function payForService(bytes32 service, uint256 amount) external;

On-chain pricing table matching TypeScript x402 system
Per-payer statistics (total spent, payment count)
Protocol revenue tracking (total payments, total revenue)
Owner-controlled price updates and fee withdrawal
Events for every payment: ServicePayment(payer, service, amount, paymentId)

Risk Management

Five layers of protection between agent capital and the market:

| Layer | What It Does | Default | |-------|-------------|---------| | Token Security | Screens every token via OKX before any capital moves | Score >= 70/100 | | Bid Validation | Verifies parameters against live CCA config and floor price | Enabled | | Portfolio Limits | Caps exposure per auction and total concurrent auctions | 5% / 3 max | | Pre-Execution Simulation | Dry-runs every transaction, catches reverts before broadcast | Enabled | | Exit Safety | Slippage limits on all post-auction trades with fallback routing | 3% max |

Build X Alignment

How BidKit maps to hackathon criteria:

| Criterion | How BidKit Addresses It | |-----------|----------------------| | "Autonomously earn" | Agents earn by selling BidKit services via x402 micropayments | | "Route" | Full pipeline: discovery → valuation → bidding → management | | "Pay" | Every operation = x402 USDC payment on X Layer (16 verified txns) | | "Interact with other agents" | x402 service marketplace — agents pay BidKit, BidKit executes | | "Onchain OS skills" | 8/8 OKX capabilities, live API verified | | "Uniswap skills" | 5/5 plugins, 9/9 skills — deepest integration in hackathon | | AI judge: Code quality | 68 tests, strict TypeScript, zero any types, production audit | | AI judge: Onchain data | 16 mainnet transactions on X Layer, verified on explorer | | Human judge: Creativity | First demand-side CCA tool. Nobody else built this. | | Human judge: Practicality | npm installable, Claude Code plugin, configurable risk params | | Best Uniswap Integration | All 5 plugins (9 skills) composing into one coherent workflow | | Most Active Agent | Each BidKit usage = multiple X Layer + Ethereum transactions |

Development

# Build
pnpm install && pnpm build

# Test (68 total)
pnpm test                     # 61 TypeScript tests
cd contracts && forge test    # 7 Solidity tests

# Lint
pnpm lint                     # strict TypeScript, zero errors

# Demo (no API keys needed)
pnpm demo                     # runs with realistic mock data

# Live (requires OKX API keys)
pnpm live:full                # 8/8 OKX capabilities verified

# Moltbook posts
pnpm moltbook                 # generate engagement content

# X Layer deployment
./scripts/deploy-mainnet.sh   # deploy BidKitPaymentReceiver
pnpm simulate:payments        # generate real x402 transactions

Test Suites

| Suite | Tests | Coverage | |-------|-------|---------| | Discovery | 10 | Factory scanning, token enrichment, security filtering, scoring | | Valuation | 12 | Comparables, CCA state, signals, fair value, bid tiers, confidence | | Bidding | 6 | Parameter calculation, simulation, submission pipeline | | Risk | 5 | Exposure limits, concurrent caps, security gating | | Post-Auction | 4 | HOLD/SELL/LP decisions, exit execution | | Integration | 5 | End-to-end pipeline, error propagation | | Uniswap | 8 | 9-skill mapping, CCA config, bid validation, LP planning | | Payments (x402) | 5 | Invoicing, verification, payment gating, stats | | Wallet (Agentic) | 8 | Sessions, intents, limits, whitelist, TEE | | Moltbook | 5 | Post generation, formatting, stats | | Solidity | 7 | BidKitPaymentReceiver: pricing, payments, stats, withdrawal | | Total | 68 | |

bidkit/
├── .claude-plugin/                # OKX Plugin Store format
│   ├── manifest.json              # 5 skills, integrations, triggers
│   └── skills/                    # Individual skill documentation
├── contracts/                     # Solidity (Foundry)
│   ├── src/
│   │   └── BidKitPaymentReceiver.sol  # x402 payment tracking on X Layer
│   ├── test/
│   │   └── BidKitPaymentReceiver.t.sol
│   └── script/
│       ├── DeployXLayer.s.sol
│       └── DeployMainnet.s.sol    # Mainnet deployment script
├── src/                           # TypeScript backend
│   ├── discovery/                 # CCA auction scanning + filtering
│   ├── valuation/                 # Fair value computation engine
│   ├── bidding/                   # Bid calculation + submission
│   ├── post-auction/              # Claim + exit strategy
│   ├── risk/                      # Portfolio protection
│   ├── payments/                  # x402 payment gate (X Layer)
│   ├── uniswap/                   # 5 plugin / 9 skill integration
│   ├── wallet/                    # Agentic Wallet (TEE, intents)
│   ├── moltbook/                  # Engagement bot
│   ├── demo/                      # Mock data for testing
│   ├── types.ts                   # 40+ type definitions
│   └── config.ts                  # 25+ named constants, zero magic numbers
├── scripts/
│   ├── deploy-mainnet.sh          # X Layer mainnet deployment
│   ├── simulate-payments.ts       # Generate real X Layer transactions
│   ├── live-full-demo.ts          # 8/8 OKX API verification
│   └── generate-moltbook-posts.ts # Engagement content generator
├── site/
│   ├── index.html                 # Landing page
│   └── app.html                   # Interactive dashboard demo
├── test/                          # 61 TypeScript tests
└── examples/                      # Usage examples

# OKX Onchain OS (required)
OKX_API_KEY=
OKX_SECRET_KEY=
OKX_PASSPHRASE=

# Auction chains
RPC_URL_ETHEREUM=
RPC_URL_ARBITRUM=

# X Layer payments
XLAYER_RPC_URL=https://rpc.xlayer.tech
XLAYER_USDC_ADDRESS=0x74b7f16337b8972027f6196a17a631ac6de26d22
BIDKIT_RECEIVER_ADDRESS=0xB979CcADb1acE628909a61E2C0942d69b62Bd223
X402_ENABLED=false

# Agentic Wallet
AGENTIC_WALLET_ENABLED=false
AGENTIC_WALLET_SPENDING_LIMIT=1000000000
AGENTIC_WALLET_DAILY_LIMIT=5000000000

# General
CCA_FACTORY_ADDRESS=
LOG_LEVEL=info

License

MIT