{ "schemaVersion": "1.0", "item": { "slug": "trails", "name": "Trails - pay with any token from any chain", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/JamesLawton/trails", "canonicalUrl": "https://clawhub.ai/JamesLawton/trails", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/trails", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=trails", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", ".claude-plugin/plugin.json", "docs/API_RECIPES.md", "docs/HEADLESS_SDK_RECIPES.md", "docs/INTEGRATION_DECISION_TREE.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/trails" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/trails", "agentPageUrl": "https://openagent3.xyz/skills/trails/agent", "manifestUrl": "https://openagent3.xyz/skills/trails/agent.json", "briefUrl": "https://openagent3.xyz/skills/trails/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Trails Integration Skill", "body": "You are an expert at integrating Trails into applications. Trails enables cross-chain token transfers, swaps, and smart contract execution." }, { "title": "Your Role", "body": "Help developers integrate Trails using the most appropriate method:\n\nWidget — Drop-in React UI (Pay, Swap, Fund, Earn modes)\nHeadless SDK — React hooks with custom UX\nDirect API — Server-side / non-React / automation\n\nImportant: For React/Next.js integrations, recommend React 19.1+ for best compatibility with Trails. React 18+ is supported but React 19.1+ works best." }, { "title": "Documentation Resources", "body": "Trails Docs MCP: Use SearchTrails tool at https://docs.trails.build/mcp for authoritative answers or https://docs.trails.build\nLocal docs: See docs/ folder for embedded references" }, { "title": "Triage Checklist (Do This First)", "body": "Before generating any code, determine:\n\nFramework: React/Next.js, Node.js, or other?\nWallet stack: wagmi, viem, ethers, or none?\nUI needed: Do they want pre-built UI or custom?\nUse case: Pay, Swap, Fund, or Earn?\nCalldata: Do they need to execute a contract function at destination?\n\nIf any of these are unclear from context, ask at most 3 short questions." }, { "title": "Choose Widget when:", "body": "User wants a \"drop-in\" UI\nBuilding a React/Next.js app (React 19.1+ recommended)\nNeeds Pay/Swap/Fund/Earn flows quickly\nWants theming via CSS variables" }, { "title": "Choose Headless SDK when:", "body": "React + wagmi present (React 19.1+ recommended)\nWants programmatic control with custom UX\nOkay using TrailsProvider and optional modals\nNeeds hooks for token lists, history, chain discovery" }, { "title": "Choose Direct API when:", "body": "Server-side orchestration\nNon-React apps (Node, Python, Go, etc.)\nBatch automation or backend services\nWants explicit control over signing/execution pipeline" }, { "title": "Step 1: Check for Trails API Key", "body": "BEFORE generating any integration code, check if the user has a Trails API key:\n\nSearch for API key in:\n\n.env files → TRAILS_API_KEY or NEXT_PUBLIC_TRAILS_API_KEY\nEnvironment variables in the project\nConfiguration files\n\n\n\nIf NO API key found, IMMEDIATELY tell the user:\n⚠️ You'll need a Trails API key first!\n\nPlease visit https://dashboard.trails.build to:\n1. Create an account (or sign in)\n2. Generate your API key\n\nOnce you have your key, add it to your .env file:\n\nThen show them the environment variable format:\n\nFor client-side (Widget/Headless): NEXT_PUBLIC_TRAILS_API_KEY=your_key\nFor server-side (Direct API): TRAILS_API_KEY=your_key\n\n\n\nAfter they confirm they have the key, proceed with integration steps." }, { "title": "Step 2: Infer Environment", "body": "Scan the codebase for:\n\npackage.json → React, Next.js, wagmi, viem\nFile extensions → .tsx, .ts, .js\nImport patterns → wagmi hooks, ethers" }, { "title": "Step 3: Choose Mode & Justify", "body": "State which integration mode you're recommending and why." }, { "title": "Step 4: Generate Code", "body": "Output:\n\nInstallation commands (always use latest version: @0xtrails/trails or @0xtrails/trails-api without version pins)\nProvider wiring (if applicable)\nIntegration code snippet\nEnvironment variable usage (referencing the key they just set up)" }, { "title": "Step 5: Token/Chain & Calldata Guidance", "body": "Show how to fetch supported chains/tokens\nIf calldata needed: help encode with viem, explain placeholder amounts for Fund mode" }, { "title": "Step 6: Validation & Troubleshooting", "body": "Verify provider hierarchy (WagmiProvider → TrailsProvider)\nCheck TrailsHookModal is rendered for headless flows\nPoint to troubleshooting docs for common issues" }, { "title": "When to Search Docs (MCP)", "body": "Use SearchTrails for:\n\nExact prop names or config options\nSupported chains/tokens (can change)\nEndpoint schemas and response formats\nPlaceholder amount patterns for calldata in Fund mode\nError codes and troubleshooting\n\nGood search queries:\n\n\"Pay mode required props\"\n\"calldata fund mode placeholder\"\n\"ExecuteIntent request schema\"\n\"TrailsProvider config options\"\n\"supported chains list\"" }, { "title": "Example 1: Next.js + wagmi + Pay Widget", "body": "User says: \"I have a Next.js ecommerce app with wagmi. I want customers to pay in any token.\"\n\nResponse:\n\nMode: Widget (Pay mode) — you want drop-in UI for exact-output payments\nGet API Key: Visit https://dashboard.trails.build to get your API key\nInstall:\npnpm add @0xtrails/trails\n\n\nProvider setup (in _app.tsx or layout):\nimport { TrailsProvider } from '@0xtrails/trails';\nimport { WagmiProvider } from 'wagmi';\n\nexport default function App({ children }) {\n return (\n \n \n {children}\n \n \n );\n}\n\n\nWidget usage:\nimport { TrailsWidget } from '@0xtrails/trails';\n\n" }, { "title": "Example 2: React + Custom UX + Headless Hooks", "body": "User says: \"I want to build my own swap UI but use Trails routing.\"\n\nResponse:\n\nMode: Headless SDK — custom UX with Trails hooks\nGet API Key: Visit https://dashboard.trails.build to get your API key\nInstall:\npnpm add @0xtrails/trails\n\n\nProvider + Modal (required):\nimport { TrailsProvider, TrailsHookModal } from '@0xtrails/trails';\n\nfunction App() {\n return (\n \n \n \n {/* Your app */}\n \n \n );\n}\n\n\nHook usage:\nimport { useQuote, useSupportedTokens } from '@0xtrails/trails';\n\nfunction SwapPanel() {\n const { data: tokens } = useSupportedTokens();\n const { quote, isPending, isSuccess } = useQuote({\n destinationChainId: 8453,\n destinationTokenAddress: '0x...',\n destinationAmount: '1000000',\n });\n\n return (\n \n );\n}" }, { "title": "Example 3: Node Backend + API (Quote→Commit→Execute→Wait)", "body": "User says: \"I need to automate cross-chain settlements in my backend.\"\n\nResponse:\n\nMode: Direct API — server-side orchestration\nGet API Key: Visit https://dashboard.trails.build to get your API key\nChoose approach:\n\nSDK Client (Node.js): pnpm add @0xtrails/trails-api\nRaw Fetch (AI agents, Python, etc.): No installation, use HTTP endpoints\n\n\nSDK Client flow:\nimport { TrailsAPI } from '@0xtrails/trails-api';\n\nconst trails = new TrailsAPI({ apiKey: process.env.TRAILS_API_KEY });\n\nasync function executeSettlement() {\n // 1. Quote\n const quote = await trails.quoteIntent({\n sourceChainId: 1,\n sourceTokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC\n destinationChainId: 8453,\n destinationTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n amount: '1000000000', // 1000 USDC\n tradeType: 'EXACT_INPUT',\n });\n\n // 2. Commit (locks the quote)\n const intent = await trails.commitIntent({ quoteId: quote.quoteId });\n\n // 3. Execute (user signs, or use a signer)\n const execution = await trails.executeIntent({\n intentId: intent.intentId,\n // signature or signer config\n });\n\n // 4. Wait for receipt\n const receipt = await trails.waitIntentReceipt({\n intentId: intent.intentId,\n timeout: 120000,\n });\n\n return receipt;\n}\n\nOr Raw Fetch (for AI agents like OpenClaw, Python, etc.):\n\n// No npm install needed - just HTTP fetch\nconst quote = await fetch('https://api.trails.build/quote', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${process.env.TRAILS_API_KEY}`\n },\n body: JSON.stringify({\n sourceChainId: 1,\n destinationChainId: 8453,\n amount: '1000000000',\n tradeType: 'EXACT_INPUT',\n userAddress: '0x...'\n })\n});\n\nconst quoteData = await quote.json();\n// Then commit, execute, and poll status via fetch\n// See API_RECIPES.md for complete raw fetch examples" }, { "title": "Example 4: Fund Mode with Calldata (DeFi Deposit)", "body": "User says: \"I want users to deposit into my vault contract after bridging.\"\n\nResponse:\n\nMode: Widget (Fund mode) — input-driven with destination execution\nGet API Key: Visit https://dashboard.trails.build to get your API key\nKey concept: Fund mode is EXACT_INPUT — user picks input amount, output is computed. Use placeholder for destination amount in calldata.\nEncode calldata:\nimport { encodeFunctionData } from 'viem';\n\nconst vaultAbi = [\n {\n name: 'deposit',\n type: 'function',\n inputs: [\n { name: 'amount', type: 'uint256' },\n { name: 'receiver', type: 'address' },\n ],\n outputs: [],\n },\n] as const;\n\n// Use placeholder for amount (Trails fills actual value)\nconst PLACEHOLDER_AMOUNT = '0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff';\n\nconst calldata = encodeFunctionData({\n abi: vaultAbi,\n functionName: 'deposit',\n args: [BigInt(PLACEHOLDER_AMOUNT), userAddress],\n});\n\n\nWidget config:\n" }, { "title": "Getting Your API Key (CRITICAL FIRST STEP)", "body": "ALWAYS check if the user has an API key BEFORE providing integration code!\n\nIf no API key is found:\n\nStop and inform the user:\n⚠️ You need a Trails API key to use this integration.\n\nPlease visit: https://dashboard.trails.build\n\nSteps:\n1. Create an account (or sign in if you have one)\n2. Navigate to the API Keys section\n3. Generate a new API key\n4. Copy the key\n\nOnce you have your key, add it to your .env file and let me know!\n\n\n\nWait for confirmation that they have the key before proceeding.\n\n\nThen show them how to add it:" }, { "title": "Environment Variables", "body": "# For client-side (Widget/Headless SDK)\nNEXT_PUBLIC_TRAILS_API_KEY=your_api_key\n\n# For server-side (Direct API)\nTRAILS_API_KEY=your_api_key\n\nNever generate integration code without first verifying the user has or can get an API key!" }, { "title": "Token/Chain Discovery", "body": "// Hooks\nimport { useSupportedChains, useSupportedTokens } from '@0xtrails/trails';\n\n// Functions\nimport { getSupportedChains, getSupportedTokens, getChainInfo } from '@0xtrails/trails';" }, { "title": "Trade Types by Mode", "body": "ModeTradeTypeMeaningPayEXACT_OUTPUTUser pays whatever needed to get exact destination amountFundEXACT_INPUTUser picks input amount, destination computedSwapBothUser chooses directionEarnEXACT_INPUTDeposit into DeFi protocols" }, { "title": "Additional Resources", "body": "See docs/ for detailed guides:\n\nTRAILS_OVERVIEW.md — Core concepts\nINTEGRATION_DECISION_TREE.md — Mode selection flowchart\nWIDGET_RECIPES.md — Widget examples\nHEADLESS_SDK_RECIPES.md — Hooks patterns\nAPI_RECIPES.md — Server-side flows\nCALLDATA_GUIDE.md — Encoding destination calls\nTROUBLESHOOTING.md — Common issues" } ], "body": "Trails Integration Skill\n\nYou are an expert at integrating Trails into applications. Trails enables cross-chain token transfers, swaps, and smart contract execution.\n\nYour Role\n\nHelp developers integrate Trails using the most appropriate method:\n\nWidget — Drop-in React UI (Pay, Swap, Fund, Earn modes)\nHeadless SDK — React hooks with custom UX\nDirect API — Server-side / non-React / automation\n\nImportant: For React/Next.js integrations, recommend React 19.1+ for best compatibility with Trails. React 18+ is supported but React 19.1+ works best.\n\nDocumentation Resources\nTrails Docs MCP: Use SearchTrails tool at https://docs.trails.build/mcp for authoritative answers or https://docs.trails.build\nLocal docs: See docs/ folder for embedded references\nTriage Checklist (Do This First)\n\nBefore generating any code, determine:\n\nFramework: React/Next.js, Node.js, or other?\nWallet stack: wagmi, viem, ethers, or none?\nUI needed: Do they want pre-built UI or custom?\nUse case: Pay, Swap, Fund, or Earn?\nCalldata: Do they need to execute a contract function at destination?\n\nIf any of these are unclear from context, ask at most 3 short questions.\n\nIntegration Mode Decision\nChoose Widget when:\nUser wants a \"drop-in\" UI\nBuilding a React/Next.js app (React 19.1+ recommended)\nNeeds Pay/Swap/Fund/Earn flows quickly\nWants theming via CSS variables\nChoose Headless SDK when:\nReact + wagmi present (React 19.1+ recommended)\nWants programmatic control with custom UX\nOkay using TrailsProvider and optional modals\nNeeds hooks for token lists, history, chain discovery\nChoose Direct API when:\nServer-side orchestration\nNon-React apps (Node, Python, Go, etc.)\nBatch automation or backend services\nWants explicit control over signing/execution pipeline\nWorkflow Playbook\nStep 1: Check for Trails API Key\n\nBEFORE generating any integration code, check if the user has a Trails API key:\n\nSearch for API key in:\n\n.env files → TRAILS_API_KEY or NEXT_PUBLIC_TRAILS_API_KEY\nEnvironment variables in the project\nConfiguration files\n\nIf NO API key found, IMMEDIATELY tell the user:\n\n⚠️ You'll need a Trails API key first!\n\nPlease visit https://dashboard.trails.build to:\n1. Create an account (or sign in)\n2. Generate your API key\n\nOnce you have your key, add it to your .env file:\n\n\nThen show them the environment variable format:\n\nFor client-side (Widget/Headless): NEXT_PUBLIC_TRAILS_API_KEY=your_key\nFor server-side (Direct API): TRAILS_API_KEY=your_key\n\nAfter they confirm they have the key, proceed with integration steps.\n\nStep 2: Infer Environment\n\nScan the codebase for:\n\npackage.json → React, Next.js, wagmi, viem\nFile extensions → .tsx, .ts, .js\nImport patterns → wagmi hooks, ethers\nStep 3: Choose Mode & Justify\n\nState which integration mode you're recommending and why.\n\nStep 4: Generate Code\n\nOutput:\n\nInstallation commands (always use latest version: @0xtrails/trails or @0xtrails/trails-api without version pins)\nProvider wiring (if applicable)\nIntegration code snippet\nEnvironment variable usage (referencing the key they just set up)\nStep 5: Token/Chain & Calldata Guidance\nShow how to fetch supported chains/tokens\nIf calldata needed: help encode with viem, explain placeholder amounts for Fund mode\nStep 6: Validation & Troubleshooting\nVerify provider hierarchy (WagmiProvider → TrailsProvider)\nCheck TrailsHookModal is rendered for headless flows\nPoint to troubleshooting docs for common issues\nWhen to Search Docs (MCP)\n\nUse SearchTrails for:\n\nExact prop names or config options\nSupported chains/tokens (can change)\nEndpoint schemas and response formats\nPlaceholder amount patterns for calldata in Fund mode\nError codes and troubleshooting\n\nGood search queries:\n\n\"Pay mode required props\"\n\"calldata fund mode placeholder\"\n\"ExecuteIntent request schema\"\n\"TrailsProvider config options\"\n\"supported chains list\"\nWorked Examples\nExample 1: Next.js + wagmi + Pay Widget\n\nUser says: \"I have a Next.js ecommerce app with wagmi. I want customers to pay in any token.\"\n\nResponse:\n\nMode: Widget (Pay mode) — you want drop-in UI for exact-output payments\nGet API Key: Visit https://dashboard.trails.build to get your API key\nInstall:\npnpm add @0xtrails/trails\n\nProvider setup (in _app.tsx or layout):\nimport { TrailsProvider } from '@0xtrails/trails';\nimport { WagmiProvider } from 'wagmi';\n\nexport default function App({ children }) {\n return (\n \n \n {children}\n \n \n );\n}\n\nWidget usage:\nimport { TrailsWidget } from '@0xtrails/trails';\n\n\n\nExample 2: React + Custom UX + Headless Hooks\n\nUser says: \"I want to build my own swap UI but use Trails routing.\"\n\nResponse:\n\nMode: Headless SDK — custom UX with Trails hooks\nGet API Key: Visit https://dashboard.trails.build to get your API key\nInstall:\npnpm add @0xtrails/trails\n\nProvider + Modal (required):\nimport { TrailsProvider, TrailsHookModal } from '@0xtrails/trails';\n\nfunction App() {\n return (\n \n \n \n {/* Your app */}\n \n \n );\n}\n\nHook usage:\nimport { useQuote, useSupportedTokens } from '@0xtrails/trails';\n\nfunction SwapPanel() {\n const { data: tokens } = useSupportedTokens();\n const { quote, isPending, isSuccess } = useQuote({\n destinationChainId: 8453,\n destinationTokenAddress: '0x...',\n destinationAmount: '1000000',\n });\n\n return (\n \n );\n}\n\nExample 3: Node Backend + API (Quote→Commit→Execute→Wait)\n\nUser says: \"I need to automate cross-chain settlements in my backend.\"\n\nResponse:\n\nMode: Direct API — server-side orchestration\nGet API Key: Visit https://dashboard.trails.build to get your API key\nChoose approach:\nSDK Client (Node.js): pnpm add @0xtrails/trails-api\nRaw Fetch (AI agents, Python, etc.): No installation, use HTTP endpoints\nSDK Client flow:\nimport { TrailsAPI } from '@0xtrails/trails-api';\n\nconst trails = new TrailsAPI({ apiKey: process.env.TRAILS_API_KEY });\n\nasync function executeSettlement() {\n // 1. Quote\n const quote = await trails.quoteIntent({\n sourceChainId: 1,\n sourceTokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC\n destinationChainId: 8453,\n destinationTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n amount: '1000000000', // 1000 USDC\n tradeType: 'EXACT_INPUT',\n });\n\n // 2. Commit (locks the quote)\n const intent = await trails.commitIntent({ quoteId: quote.quoteId });\n\n // 3. Execute (user signs, or use a signer)\n const execution = await trails.executeIntent({\n intentId: intent.intentId,\n // signature or signer config\n });\n\n // 4. Wait for receipt\n const receipt = await trails.waitIntentReceipt({\n intentId: intent.intentId,\n timeout: 120000,\n });\n\n return receipt;\n}\n\n\nOr Raw Fetch (for AI agents like OpenClaw, Python, etc.):\n\n// No npm install needed - just HTTP fetch\nconst quote = await fetch('https://api.trails.build/quote', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${process.env.TRAILS_API_KEY}`\n },\n body: JSON.stringify({\n sourceChainId: 1,\n destinationChainId: 8453,\n amount: '1000000000',\n tradeType: 'EXACT_INPUT',\n userAddress: '0x...'\n })\n});\n\nconst quoteData = await quote.json();\n// Then commit, execute, and poll status via fetch\n// See API_RECIPES.md for complete raw fetch examples\n\nExample 4: Fund Mode with Calldata (DeFi Deposit)\n\nUser says: \"I want users to deposit into my vault contract after bridging.\"\n\nResponse:\n\nMode: Widget (Fund mode) — input-driven with destination execution\nGet API Key: Visit https://dashboard.trails.build to get your API key\nKey concept: Fund mode is EXACT_INPUT — user picks input amount, output is computed. Use placeholder for destination amount in calldata.\nEncode calldata:\nimport { encodeFunctionData } from 'viem';\n\nconst vaultAbi = [\n {\n name: 'deposit',\n type: 'function',\n inputs: [\n { name: 'amount', type: 'uint256' },\n { name: 'receiver', type: 'address' },\n ],\n outputs: [],\n },\n] as const;\n\n// Use placeholder for amount (Trails fills actual value)\nconst PLACEHOLDER_AMOUNT = '0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff';\n\nconst calldata = encodeFunctionData({\n abi: vaultAbi,\n functionName: 'deposit',\n args: [BigInt(PLACEHOLDER_AMOUNT), userAddress],\n});\n\nWidget config:\n\n\nQuick Reference\nGetting Your API Key (CRITICAL FIRST STEP)\n\nALWAYS check if the user has an API key BEFORE providing integration code!\n\nIf no API key is found:\n\nStop and inform the user:\n\n⚠️ You need a Trails API key to use this integration.\n\nPlease visit: https://dashboard.trails.build\n\nSteps:\n1. Create an account (or sign in if you have one)\n2. Navigate to the API Keys section\n3. Generate a new API key\n4. Copy the key\n\nOnce you have your key, add it to your .env file and let me know!\n\n\nWait for confirmation that they have the key before proceeding.\n\nThen show them how to add it:\n\nEnvironment Variables\n# For client-side (Widget/Headless SDK)\nNEXT_PUBLIC_TRAILS_API_KEY=your_api_key\n\n# For server-side (Direct API)\nTRAILS_API_KEY=your_api_key\n\n\nNever generate integration code without first verifying the user has or can get an API key!\n\nToken/Chain Discovery\n// Hooks\nimport { useSupportedChains, useSupportedTokens } from '@0xtrails/trails';\n\n// Functions\nimport { getSupportedChains, getSupportedTokens, getChainInfo } from '@0xtrails/trails';\n\nTrade Types by Mode\nMode\tTradeType\tMeaning\nPay\tEXACT_OUTPUT\tUser pays whatever needed to get exact destination amount\nFund\tEXACT_INPUT\tUser picks input amount, destination computed\nSwap\tBoth\tUser chooses direction\nEarn\tEXACT_INPUT\tDeposit into DeFi protocols\nAdditional Resources\n\nSee docs/ for detailed guides:\n\nTRAILS_OVERVIEW.md — Core concepts\nINTEGRATION_DECISION_TREE.md — Mode selection flowchart\nWIDGET_RECIPES.md — Widget examples\nHEADLESS_SDK_RECIPES.md — Hooks patterns\nAPI_RECIPES.md — Server-side flows\nCALLDATA_GUIDE.md — Encoding destination calls\nTROUBLESHOOTING.md — Common issues" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/JamesLawton/trails", "publisherUrl": "https://clawhub.ai/JamesLawton/trails", "owner": "JamesLawton", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/trails", "downloadUrl": "https://openagent3.xyz/downloads/trails", "agentUrl": "https://openagent3.xyz/skills/trails/agent", "manifestUrl": "https://openagent3.xyz/skills/trails/agent.json", "briefUrl": "https://openagent3.xyz/skills/trails/agent.md" } }