A comprehensive developer toolkit for integrating Trails cross-chain infrastructure to enable seamless token swaps, payments, and smart contract execution across multiple blockchains.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install trails
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install trails using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Trails Cross-Chain Integration?
The Trails skill for Openclaw Skills provides a specialized framework for developers looking to implement cross-chain functionality without the complexity of manual bridge management. It offers three distinct integration pathways: a drop-in React Widget for immediate UI needs, a Headless SDK for custom user experiences, and a Direct API for server-side automation and non-React environments. By leveraging this skill, developers can unify liquidity across disparate networks, allowing users to pay, swap, or fund contracts using any token from any supported chain.
This integration is designed to work harmoniously with modern web stacks, specifically recommending React 19.1+ for optimal performance. It abstracts the intricate processes of quoting, committing, and executing cross-chain intents, making it an essential component of the Openclaw Skills ecosystem for anyone building decentralized finance (DeFi) or ecommerce applications that require chain-agnostic payment rails.
Trails Cross-Chain Integration Use Cases
- Implementing a 'Pay with Any Token' checkout experience for global ecommerce platforms.
- Developing custom cross-chain swap interfaces using headless React hooks for full design control.
- Automating cross-chain liquidity rebalancing and settlements within Node.js backend services.
- Enabling users to deposit funds into a vault on a different chain via 'Fund' mode with custom calldata.
- Creating cross-chain 'Earn' dashboards that aggregate yield opportunities across multiple ecosystems.
How Trails Cross-Chain Integration Works
- The skill initiates a triage process to determine the developer's framework, wallet library (like wagmi or viem), and desired UI level.
- It checks for a valid Trails API key in the environment configuration to ensure secure communication with the infrastructure.
- Based on the triage, it recommends the most efficient integration mode: Widget, Headless SDK, or Direct API.
- It guides the user through the installation of the latest @0xtrails packages without version pinning for maximum compatibility.
- The skill provides code snippets for provider wiring, ensuring the TrailsProvider is correctly nested within the application's wallet provider hierarchy.
- For advanced flows, it assists in encoding destination-chain calldata, allowing for complex actions like depositing into a smart contract immediately after a bridge completes.
Trails Cross-Chain Integration Setup
To set up the Trails integration within your Openclaw Skills workflow, follow these steps:
- Generate an API key by visiting the Trails Dashboard at
https://dashboard.trails.build. - Add your key to the project environment variables:
# For React/Next.js
NEXT_PUBLIC_TRAILS_API_KEY=your_api_key
# For Server-side/Node.js
TRAILS_API_KEY=your_api_key
- Install the core library using your preferred package manager:
pnpm add @0xtrails/trails
# Or for API-only environments
pnpm add @0xtrails/trails-api
- Import and wrap your root layout with the
TrailsProviderto enable the SDK hooks and UI components.
Trails Cross-Chain Integration Data Schema & Taxonomy
The Trails skill organizes its cross-chain operations using a structured metadata schema to ensure reliability:
| Attribute | Type | Description |
|---|---|---|
| mode | String | The interaction pattern: 'pay', 'swap', 'fund', or 'earn'. |
| destinationChainId | Number | The target EIP-155 chain ID for the transaction. |
| destinationTokenAddress | String | The contract address of the token to be received on the target chain. |
| destinationCalldata | Hex | Optional encoded function data for execution at the destination. |
| tradeType | Enum | Specifies 'EXACT_INPUT' or 'EXACT_OUTPUT' logic for the swap. |
| intentId | String | A unique identifier used to track the lifecycle of the cross-chain request. |
Trails Cross-Chain Integration Advanced Features
- Support for destination-chain smart contract execution using placeholder amounts in calldata.
- Programmatic access to token lists and chain discovery via specialized React hooks.
- Server-side intent orchestration for building autonomous AI agents and trading bots.
- Theme customization for the TrailsWidget using CSS variables to match any brand identity.
- Full compatibility with the wagmi and viem stacks for seamless wallet interactions within Openclaw Skills projects.
SKILL.md
Loading
Related Openclaw Skills
Sequence Builder CLI
A powerful CLI for managing Sequence smart wallets, blockchain projects, and token transfers designed for AI agents and automation.
Polygon Agent Kit
A comprehensive toolkit for building blockchain-enabled AI agents on Polygon with session-based smart wallets and on-chain reputation.
Tradekix
A versatile financial intelligence skill for querying global market data, news, and economic events via CLI.
Browserbase Sessions
Automate persistent, authenticated cloud browser sessions with built-in CAPTCHA solving and session recording capabilities.
clawtan
A strategic board game skill that enables agents to play a lobster-themed version of Catan through a dedicated command-line interface.
LNbits Wallet Manager
A comprehensive AI agent tool for managing Bitcoin Lightning Network wallets via the LNbits API with integrated safety protocols.
Featured*
