Documentation

Institutional-grade infrastructure for self-custodial AI agents.

YieldKernel is an autonomous DeFi infrastructure layer that enables AI agents to manage capital with the security standards of a traditional financial institution. Built on top of Tether's Wallet Development Kit (WDK), it ensures that while decision-making is automated, custody remains absolute.

Developer Quickstart

Launch the YieldKernel infrastructure locally or connect to our production API.

1. Installation

# Clone the repository
git clone https://github.com/juapperez/yield-kernel.git
cd yield-kernel

# Install dependencies
npm install

2. Environment Configuration

Create a .env file in the root directory and add your credentials.

AI_PROVIDER=groq
GROQ_API_KEY=your_groq_key

RPC_URL=https://eth-mainnet.g.alchemy.com/v2/demo
CHAIN_ID=1
PORT=3000

MAX_POSITION_SIZE_USDT=1000
MIN_APY_THRESHOLD=3.0

3. Run

npm start

System Architecture

YieldKernel utilizes a specialized multi-layer architecture to separate intelligence from execution.

Core Integration Example

Integrating the WDK provider within your custom agent logic:

import { WalletManager } from "./core/wallet.js";
                    
import { WalletManager } from "./src/core/wallet.js";
const wallet = new WalletManager();
await wallet.initialize();
await walletManager.initialize();
// Securely sign an institutional supply transaction
const tx = await wallet.signTransaction({
    to: AAVE_V3_USDT_POOL,
    value: parseEther("5000")
});
console.log(status, tx.hash);

API Reference

YieldKernel exposes a high-performance REST API for monitoring and interacting with the autonomous agent.

GET /api/status

Returns the current health and status of the autonomous network.

{
  "status": "operational",
  "network": "Ethereum Mainnet",
  "recheck_cycle": "86400s",
  "blockNumber": 12345678,
  "wdk": {
    "wdkInstalled": true,
    "walletMode": "wdk",
    "chainId": 1,
    "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/demo"
  }
}

POST /api/invest

Triggers the AI agent to evaluate and execute a specific allocation.

// Request Body
{
  "asset": "USDT",
  "amount": "5000"
}

POST /api/judge/run

Runs a full end-to-end judge pipeline and returns a structured transcript: OBSERVE → ANALYZE → ECONOMICS → DECIDE → (EXECUTE) → REPORT.

// Request Body
{
  "asset": "USDT",
  "amount": "1000",
  "execute": true,
  "requireOnchainProof": false
}

Attempts a real on-chain proof transaction (best used on a testnet). Returns a verifiable explorer link when WDK is active and the wallet has testnet ETH.

Server-Sent Events stream that emits autonomous decisions every 30 seconds for the UI Live Agent Feed.

YieldKernel exposes HTTP endpoints designed to be called by external agent runtimes. If you are using OpenClaw, the most direct integration is to create a small skill that calls the YieldKernel backend APIs.

Suggested tool calls for an OpenClaw skill:

1) GET  /api/status
2) GET  /api/yields
3) POST /api/judge/run
4) POST /api/proof/tx