What makes Aidex notable?

1.1K downloads. Trust evidence available

How should Aidex be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Aidex

AIDEX is a lightning-fast DEX aggregator for swapping tokens on-chain. The pipeline is optimised for minimal latency between an agent’s decision and the moment the signed transaction hits the network. The gap between intent and execution is where price moves against you, and AIDEX is built to minimise it. Search tokens, check exchange rates, view balances, and execute swaps with low-latency on-chain execution — without giving up wallet custody or trusting a third party with your private keys

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.7

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.7release · observed May 13, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s173b8438g4qb8w5ggfvk616kx863gp7:aidex

Install using `clawhub skill install s173b8438g4qb8w5ggfvk616kx863gp7:aidex` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/almiashev/aidex before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-almiashev-aidex/snapshot"

Documentation

CLAWHUB

145,502 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: aidex
description: Swap tokens on Ethereum via the AIDEX aggregator. Search tokens, check exchange rates, view balances, and execute swaps. Client-side transaction signing keeps your private key on your machine.
version: 1.0.7
homepage: https://ai-dex.io/
user-invocable: true
emoji: "\U0001F504"
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["node"]
    },
    "primaryEnv": "AIDEX_PRIVATE_KEY"
  }
}
---

## Overview

AIDEX is a high-performance DEX aggregator on Ethereum. This skill gives your OpenClaw agent the ability to swap tokens, check exchange rates, monitor balances, and verify transaction results.

AIDEX provides tools, not decisions. You decide when and what to trade. AIDEX is your hands — fast, transparent, reliable. Every operation is a visible on-chain Ethereum transaction that you can verify on Etherscan. Nothing is hidden, nothing is obscured.

AIDEX doesn't pretend to be smarter than you. It doesn't make decisions on your behalf. It does exactly what you ask — honestly, quickly, and verifiably. If you want to experiment with automated trading, AIDEX gives you the simplest, most transparent foundation to build on.

Your funds stay in your wallet at all times. Unlike centralized exchange integrations where your money sits on someone else's platform, AIDEX works with decentralized liquidity pools. You remain in full control.

## Source code

Open source on GitHub: [AIDEX-DeFi/skills](https://github.com/AIDEX-DeFi/skills). Issues and pull requests welcome.

## Why AIDEX

- **Simplicity** — Simple, clear scripts. Clear inputs, clear outputs. The agent calls them, you see the results. That's it.
- **Transparency** — Every swap is a standard Ethereum transaction. You get a transaction hash. You can check it on Etherscan. What you asked for is what gets executed.
- **Security** — Your private key never leaves your machine. The API only receives already-signed transactions. Even if our servers were compromised, no one could alter your transaction — it's cryptographically signed by you. See the [Security Model](#security-model) section below.
- **Speed** — Lightning-fast execution layer with minimal latency. Transactions are built and sent in milliseconds.
- **Best rates** — Wide liquidity pool coverage finds exchange routes that competitors miss, giving you better rates.

## Dependencies

This skill requires Node.js packages listed in `package.json` in the skill's root folder:

- **ethers** — Ethereum library for client-side transaction signing. This is what keeps your private key safe — transactions are signed locally, never sent to the API.
- **@napi-rs/keyring** *(optional)* — Native access to the operating system's credential manager (Windows Credential Manager, macOS Keychain, Linux Secret Service). Allows storing the private key securely instead of an environment variable.

**Run `npm install` in the skill's root folder after the initial install and after each skil

_meta.json

{
  "ownerId": "kn75vpgckjav1ae1dw275517y9863f78",
  "slug": "aidex",
  "version": "1.0.7",
  "publishedAt": 1778687371661
}

references/scripts.md

# AIDEX Scripts Reference

Detailed reference for all AIDEX skill scripts. Load this when you need to understand exact arguments, output formats, or error handling for a specific script.

All scripts are located in `{baseDir}/scripts/` and invoked via `node`. Every script outputs a single JSON line to stdout and exits. The JSON always contains a `success` field (`true` or `false`). On failure, an `error` field provides a human-readable explanation.

## Token identification

All scripts that accept token parameters (`--token-in`, `--token-out`, `--tokens`) support two formats:

- **By address**: `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`
- **By symbol**: `USDC`

If a symbol matches zero tokens, the error will be: `"Token not found: 'XYZ'. Use /api/v1/agent/tokens to search for available tokens."`

If a symbol matches multiple tokens (ambiguous), the error will list all matches with their addresses so you can specify the exact one.

Use `ETH` or `0x0000000000000000000000000000000000000000` for native Ether.

---

## Common API errors

These can come from any script that calls the AIDEX API. Per-script tables below list only script-specific errors.

| Error | Cause |
|-------|-------|
| `"Skill version ... is outdated..."` | Skill is outdated — run `openclaw skills update aidex` |
| `"Request rejected..."` | Server rejected the request — re-check arguments |

---

## account.js

Derives the wallet address from the configured private key. Does not call the API.

### Arguments

None.

### Private key

Required. See [Setup](../SKILL.md#setup) for configuration options.

### Output

```json
{"success": true, "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"}
```

### Errors

| Error | Cause |
|-------|-------|
| `"Private key is not configured..."` | Neither `AIDEX_PRIVATE_KEY` environment variable nor system keyring entry is set — or the OpenClaw gateway was not restarted after configuration |
| `"Invalid private key: ..."` | ethers.js rejected the key |

---

## tokens.js

Search for tokens by symbol, name, or address.

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `--term <query>` | No | Search query (substring match, case-insensitive). If omitted, returns all tokens. |

### Output

```json
{
  "success": true,
  "tokens": [
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "decimals": 6,
      "name": "USD Coin",
      "imageUrl": "https://..."
    }
  ]
}
```

An empty `tokens` array means no matches were found.

### Errors

| Error | Cause |
|-------|-------|
| `"API request failed: ..."` | Network or server error |

---

## rate.js

Get the current exchange rate for a token pair. Read-only, does not execute anything.

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `--token-in <token>` | Yes | Toke

references/security.md

# AIDEX Security Model

## Architecture

The AIDEX skill uses a client-side signing architecture. This document explains how it works and why it's secure.

## How a swap works step by step

1. **Agent requests swap parameters** — The `swap.js` script sends a POST request to the AIDEX API with high-level swap parameters: which token to sell, which token to buy, and how much. The API does NOT receive the private key.

2. **API builds the transaction** — The AIDEX API finds the best exchange route, computes the exact transaction data (contract address, call data, gas parameters, nonce), and returns it as a complete unsigned transaction object.

3. **Local signing** — The `swap.js` script uses `ethers.Wallet.signTransaction()` to sign the transaction locally. The private key **never** leaves your machine. Transaction signing happens entirely on your side.

4. **Broadcasting** — The signed raw transaction (a hex string) is sent to the AIDEX API, which broadcasts it to the Ethereum network via `eth_sendRawTransaction`. This is equivalent to what any public RPC endpoint does.

## What makes this secure

### The private key never leaves the machine

The key is resolved locally from one of two sources: the `AIDEX_PRIVATE_KEY` environment variable or the operating system's credential manager (via `@napi-rs/keyring`). In both cases, the key is used exclusively by the local ethers.js `Wallet` instance to produce a cryptographic signature. No API call, at any point, includes the private key.

### Signed transactions are tamper-proof

An Ethereum transaction, once signed, is cryptographically bound to its parameters. If anyone modifies any field — the recipient address, the amount, the call data, the gas price — the signature becomes invalid and the transaction is rejected by the network.

This means:
- The AIDEX API cannot change what you signed
- A man-in-the-middle cannot alter the transaction
- Even a fully compromised AIDEX server can only broadcast exactly what you signed, or refuse to broadcast it

### The API is a public RPC relay

The `POST /api/v1/agent/swap/send` endpoint is functionally equivalent to calling `eth_sendRawTransaction` on any public Ethereum RPC. It receives a signed transaction and submits it to the network. It has no special privileges and cannot modify the transaction in any way.

### All read operations are unauthenticated

Token searches, rate checks, balance queries, and transaction receipts are all read-only operations that use publicly available blockchain data. They do not require a private key and do not expose any sensitive information.

## Risk assessment

### What can go wrong

| Risk | Likelihood | Impact | Mitigation |
|------|-----------|--------|------------|
| AIDEX API compromised | Low | None — attacker can only see/broadcast signed txs they cannot alter | Client-side signing architecture |
| OpenClaw host compromised (env) | Low-Medium | High — attacker gets the privat

skill-card.md

## Description:

Swap tokens on Ethereum via the AIDEX aggregator; agents can search tokens, check exchange rates, view balances, and execute swaps while transaction signing remains local.

This skill is ready for commercial/non-commercial use.

## Publisher:

[almiashev](https://clawhub.ai/user/almiashev)

### License/Terms of Use:

MIT-0

## Use Case:

External users and developers use Aidex to let an OpenClaw agent search Ethereum tokens, quote swaps, inspect wallet balances, execute signed swaps, and check transaction status. Swap execution requires a locally configured wallet private key.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: A high-value private key could be exposed if the agent host or its environment is compromised.

Mitigation: Use a dedicated wallet with limited funds and avoid configuring a wallet that controls high-value assets.

Risk: API-controlled swap terms could result in a bad trade or unexpectedly high gas fees.

Mitigation: Verify the final swap terms, exchange rate, slippage, and fees independently before execution.

Risk: Token approvals may grant the router spending authority beyond the immediate swap.

Mitigation: Review allowances before and after swaps, and revoke unneeded approvals when appropriate.

## Reference(s):

- [ClawHub Aidex Skill Page](https://clawhub.ai/almiashev/skills/aidex)
- [AIDEX Homepage](https://ai-dex.io/)
- [AIDEX Scripts Reference](artifact/references/scripts.md)
- [AIDEX Security Model](artifact/references/security.md)

## Skill Output:

**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with JSON results from Node.js command-line scripts]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Read-only operations return token, rate, balance, or status data; swap operations can produce signed Ethereum transaction hashes.]

## Skill Version(s):

1.0.7 (source: SKILL.md frontmatter, package.json, and server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.