Skip to content

agenbyte/BidKit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BidKit

Autonomous auction intelligence for AI agents

Demo npm Tests TypeScript Solidity X Layer Uniswap OKX License

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

Demo Video · Dashboard · Explorer · Plugin Store · npm


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/sdk';

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)
npm install @bidkit/sdk

npm

pnpm add @bidkit/sdk

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.solLive 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

Project Structure
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
Configuration
# 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

Built for OKX Build X Hackathon — Skills Arena
Autonomous auction intelligence. X Layer settlement. Uniswap AI ecosystem.

About

Autonomous auction intelligence for AI agents — discover, evaluate, and bid in Uniswap CCA auctions with x402 micropayments on X Layer. 68 tests, 5 Uniswap plugins, 8 OKX APIs, live on mainnet.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors