← Back to Skills Marketplace
wpank

Uniswap Cross Chain Swap

by wpank · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
762
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install cross-chain-swap
Description
Execute a cross-chain token swap via Uniswap's bridge infrastructure. Handles quoting, safety validation, bridge monitoring, and destination confirmation. Use when the user wants to swap tokens across different chains.
README (SKILL.md)

Cross-Chain Swap

Overview

Executes a cross-chain token swap — swapping a token on one chain for a different (or same) token on another chain. Delegates the full workflow to the cross-chain-executor agent, which handles quoting, route evaluation, safety checks, bridge monitoring, and destination confirmation.

When to Use

Activate when the user asks:

  • "Swap ETH on Arbitrum for USDC on Base"
  • "Cross-chain swap"
  • "Buy USDC on Optimism using ETH from mainnet"
  • "Move my ETH from Ethereum to Arbitrum and convert to USDC"
  • "Swap tokens across chains"
  • "Exchange X on chain A for Y on chain B"

Parameters

Parameter Required Default Description
tokenIn Yes Input token symbol or address on source chain
tokenOut Yes Output token symbol or address on destination chain
amount Yes Amount to swap (human-readable, e.g., "1.5" or "1000")
sourceChain Yes Source chain name (e.g., "ethereum", "arbitrum")
destChain Yes Destination chain name (e.g., "base", "optimism")
slippage No auto Slippage tolerance (e.g., "0.5" for 0.5%)
recipient No Same wallet Recipient address on destination chain

Workflow

  1. Extract parameters from the user's request. Identify:

    • Which token they want to send and on which chain.
    • Which token they want to receive and on which chain.
    • The amount to swap.
    • Resolve ambiguous chain references (e.g., "mainnet" = "ethereum").
  2. Validate inputs:

    • Verify both chains are supported via mcp__uniswap__getSupportedChains.
    • Verify tokens exist on their respective chains via mcp__uniswap__getTokenInfo.
    • If source and destination chain are the same: redirect to execute-swap skill instead.
  3. Delegate to cross-chain-executor: Invoke Task(subagent_type:cross-chain-executor) with:

    • tokenIn, tokenOut, amount, sourceChain, destChain, slippage, recipient.
    • The agent handles the full 7-step workflow: quote, risk assessment, safety check, execution, bridge monitoring, confirmation, and reporting.
  4. Present results: Format the execution report for the user, highlighting:

    • Amounts sent and received.
    • Total fees (gas + bridge).
    • Settlement time.
    • Any warnings from safety or risk checks.

Output Format

Cross-Chain Swap Complete

  Source:      1.5 ETH on Ethereum
  Destination: 2,850.25 USDC on Base
  Fees:        $3.50 (gas: $2.50, bridge: $1.00)
  Settlement:  2 min 35 sec

  Source Tx:   0xabc...123
  Bridge ID:   0x789...abc
  Dest Tx:     0xdef...456

  Risk: LOW | Safety: APPROVED

Important Notes

  • Cross-chain swaps involve bridge operations that take time to settle (typically 1-10 minutes).
  • The skill will monitor the bridge and report status updates during settlement.
  • Bridge fees and slippage apply in addition to normal swap fees.
  • If the bridge gets stuck, the executor will escalate with recovery instructions.

Error Handling

Error User-Facing Message Suggested Action
Unsupported chain "Chain [name] is not supported for cross-chain swaps." Check supported chains
Same chain "Source and destination are the same chain. Use a regular swap." Use execute-swap skill
Safety veto "This swap was blocked by safety checks: [reason]." Reduce amount or check token
Risk veto "Risk assessment vetoed: [reason]." Choose a different route or amount
Bridge stuck "Bridge settlement is taking longer than expected." Wait or check order ID manually
Bridge failed "Bridge operation failed. Funds should remain on source chain." Check source wallet balance
Insufficient balance "Not enough [token] on [chain] to execute this swap." Check balance and reduce amount
Usage Guidance
This skill claims to execute cross‑chain swaps but does not explain how transactions will be signed or where code runs. Before installing or using it: (1) Ask the author how signing is performed — is it via a browser wallet popup, an external signer, or must you supply private keys/keys as environment variables? Never paste private keys into a skill. (2) If you plan to install code referenced in the README, review that GitHub repository thoroughly — installing code from unknown repositories can execute arbitrary code. (3) Verify the implementation of the delegated 'cross-chain-executor' subagent (it likely performs the actual on‑chain work) and ensure it does not request unnecessary credentials or persist them. (4) Prefer solutions that use non‑custodial, user-driven signing (wallet popup or hardware wallet) and explicit, documented RPC/provider configuration. If the author cannot clarify where signing happens or demands private keys without a secure, documented flow, do not proceed.
Capability Analysis
Type: OpenClaw Skill Name: cross-chain-swap Version: 0.1.0 The skill bundle is designed to facilitate cross-chain token swaps by delegating the core workflow to a `cross-chain-executor` subagent and utilizing Uniswap-related tools. The `SKILL.md` instructions are clear, focused on the stated purpose, and do not contain any prompt injection attempts or instructions for unauthorized actions, data exfiltration, or malicious execution. All parameters passed to the subagent are directly related to the swap operation. While the `cross-chain-executor` subagent itself is not provided for analysis, the current skill bundle acts as a benign dispatcher, with no evidence of intentional harmful behavior within its own files.
Capability Assessment
Purpose & Capability
The skill's name, description, and declared allowed tools (mcp__uniswap__getSupportedChains, mcp__uniswap__getTokenInfo, and delegation to a cross-chain executor subagent) align with a cross‑chain swapping purpose. However, the skill claims to 'execute' swaps but does not describe where signing credentials, wallet connections, or RPC endpoints come from — a necessary capability for on‑chain execution. This could be legitimate if the delegated cross-chain-executor subagent handles signing, but that relationship is not documented here.
Instruction Scope
SKILL.md stays narrowly scoped: it validates chains/tokens, extracts parameters, and delegates the 7‑step workflow to Task(subagent_type:cross-chain-executor). It does not instruct the agent to read files, environment variables, or unrelated system state. Concern: there are no instructions about acquiring user wallet consent, connecting a signer, or handling private keys — yet the skill promises to perform transactions and bridge monitoring.
Install Mechanism
There is no install spec in the registry (instruction-only), which is lower risk. However, README contains example install commands that would pull code from a GitHub path or via 'clawhub' using npx. That suggests external code may be available and installable even though no install spec is declared — a discrepancy worth reviewing before running those install commands.
Credentials
The skill declares no required environment variables or credentials, yet it intends to execute on‑chain operations (send transactions, monitor bridges). Executing swaps requires signing credentials (private key, wallet connection, or external signer) and possibly RPC node endpoints; the lack of any declared mechanism for signing or credential use is a proportionality/omission concern. It's unclear whether the delegated subagent will prompt for secrets, use platform-managed keys, or require the user to paste private keys — each has different security implications.
Persistence & Privilege
always is false, there are no requested config paths, and the skill is user-invocable with normal autonomous invocation allowed. Nothing here indicates elevated or persistent privileges beyond the platform defaults.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cross-chain-swap
  3. After installation, invoke the skill by name or use /cross-chain-swap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of cross-chain-swap skill for Uniswap bridge-based token swaps. - Enables cross-chain token swaps with full workflow delegation to a cross-chain executor agent. - Handles quoting, safety/risk validation, bridge monitoring, and final destination confirmation. - Provides clear parameter definitions, workflow outline, and user-facing output/reporting. - Built-in handling for errors, unsupported chains/tokens, and safety or risk vetoes. - Integrates with Uniswap’s supported chains and token info APIs for validation.
Metadata
Slug cross-chain-swap
Version 0.1.0
License
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Uniswap Cross Chain Swap?

Execute a cross-chain token swap via Uniswap's bridge infrastructure. Handles quoting, safety validation, bridge monitoring, and destination confirmation. Use when the user wants to swap tokens across different chains. It is an AI Agent Skill for Claude Code / OpenClaw, with 762 downloads so far.

How do I install Uniswap Cross Chain Swap?

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

Is Uniswap Cross Chain Swap free?

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

Which platforms does Uniswap Cross Chain Swap support?

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

Who created Uniswap Cross Chain Swap?

It is built and maintained by wpank (@wpank); the current version is v0.1.0.

💬 Comments