← Back to Skills Marketplace
aviclaw

ZeroEx Swap

by aviclaw · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
630
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install zeroex-swap
Description
Execute token swaps using the 0x API with support for price quotes, gasless meta-transactions, and on-chain trade history retrieval.
Usage Guidance
This skill appears to do what it says, but it's handling real funds so proceed carefully: 1) Use a dedicated hot wallet with minimal funds and never use your main seed phrase. 2) Be aware the PRIVATE_KEY must be provided in environment variables — keep it secret and ephemeral; avoid long‑lived env variables on shared systems. 3) The code uses default third‑party RPC endpoints (e.g., llamarpc.com and mainnet.base.org); these providers will see your transactions and addresses — if privacy/trust is a concern, set RPC_URL to your own node or a trusted RPC. 4) Review the code before running; there are small implementation inconsistencies (e.g., swap.js accepts ZEROEX_PRIVATE_KEY but SKILL.md doesn't mention it, and quote.js references path/fileURLToPath without importing them) which are likely bugs rather than malicious. 5) Consider running in a sandboxed environment and test with tiny amounts first.
Capability Analysis
Type: OpenClaw Skill Name: zeroex-swap Version: 1.0.1 This skill is classified as suspicious due to its inherent high-risk capabilities, specifically requiring and directly handling a user's `PRIVATE_KEY` and `ZEROEX_API_KEY` to execute real cryptocurrency swaps. While the code (`swap.js`, `quote.js`) transparently implements the stated purpose of interacting with the 0x Swap API and includes some security best practices (e.g., exact allowance), the direct handling of a private key for real fund transactions represents a significant risk. The `SKILL.md` instructions guide the AI agent to perform these high-risk operations, which, while aligned with the skill's purpose, could lead to financial loss if misused or if the agent's environment is compromised.
Capability Assessment
Purpose & Capability
Name/description (0x swaps, quotes, gasless meta-tx) match the code and SKILL.md. Requested env vars (ZEROEX_API_KEY, PRIVATE_KEY) and dependencies (axios, ethers, viem) are proportionate to making API calls and signing/sending transactions.
Instruction Scope
SKILL.md and the scripts instruct the agent to call 0x endpoints, sign EIP‑712 payloads, and use an RPC provider — all expected. The skill requires the user's private key to sign transactions (sensitive but necessary). The SKILL.md and code do expose and log wallet address and will send data to 0x and to configured/default RPC endpoints (which can observe requests and transactions).
Install Mechanism
There is no opaque install downloader; it's an instruction-only skill with normal npm dependencies declared in package.json. Dependencies (axios, ethers, viem) are appropriate and expected.
Credentials
Requested environment variables are limited and appropriate: ZEROEX_API_KEY (API access) and PRIVATE_KEY (to sign/send swaps). One minor mismatch: swap.js also accepts ZEROEX_PRIVATE_KEY as an alternative but SKILL.md doesn't mention it. No unrelated secrets are requested.
Persistence & Privilege
Skill does not request always:true, does not modify other skills or system-wide configs, and has no persistent installation actions declared. Autonomous invocation is allowed but is the platform default.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install zeroex-swap
  3. After installation, invoke the skill by name or use /zeroex-swap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Declared required environment variables (`ZEROEX_API_KEY`, `PRIVATE_KEY`) in the documentation for clarity. - No functional or API changes; documentation update only.
v1.0.0
- Initial release of ZeroEx Swap skill. - Supports token price quotes and swap execution via 0x API. - Includes tools for retrieving swap and gasless trade history. - Provides instructions for traditional and gasless (meta-transaction) swaps. - Security guidance and environment variable requirements clearly documented.
Metadata
Slug zeroex-swap
Version 1.0.1
License
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is ZeroEx Swap?

Execute token swaps using the 0x API with support for price quotes, gasless meta-transactions, and on-chain trade history retrieval. It is an AI Agent Skill for Claude Code / OpenClaw, with 630 downloads so far.

How do I install ZeroEx Swap?

Run "/install zeroex-swap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ZeroEx Swap free?

Yes, ZeroEx Swap is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ZeroEx Swap support?

ZeroEx Swap is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ZeroEx Swap?

It is built and maintained by aviclaw (@aviclaw); the current version is v1.0.1.

💬 Comments