{ "schemaVersion": "1.0", "item": { "slug": "design-integration", "name": "Uniswap Design Integration", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/wpank/design-integration", "canonicalUrl": "https://clawhub.ai/wpank/design-integration", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/design-integration", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=design-integration", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.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/design-integration" }, "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/design-integration", "agentPageUrl": "https://openagent3.xyz/skills/design-integration/agent", "manifestUrl": "https://openagent3.xyz/skills/design-integration/agent.json", "briefUrl": "https://openagent3.xyz/skills/design-integration/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": "Overview", "body": "Designs a complete Uniswap integration architecture for any project by delegating to the integration-architect agent. Produces a comprehensive blueprint covering: integration method recommendation (Trading API vs Universal Router SDK vs direct contract vs V4 hooks), component architecture, dependency list with versions, security review with mitigations, and ordered implementation plan." }, { "title": "When to Use", "body": "Activate when the user asks:\n\n\"Help me integrate Uniswap\"\n\"Design a swap integration\"\n\"Architecture for a DEX aggregator\"\n\"How to build an arbitrage bot\"\n\"Uniswap integration plan\"\n\"How should I add swaps to my dApp?\"\n\"Best way to integrate Uniswap in my backend\"\n\"Architecture for a DeFi protocol that uses Uniswap\"\n\"What SDK should I use for Uniswap?\"" }, { "title": "Parameters", "body": "ParameterRequiredDefaultDescriptionprojectTypeYes--Type of project (e.g., \"DeFi dashboard\", \"arb bot\", \"wallet app\", \"DeFi protocol\")functionalityYes--Required Uniswap functionality: \"swap\", \"LP\", \"both\", or \"custom\"environmentNoAuto-detectExecution environment: \"frontend\", \"backend\", \"smart contract\", or \"full-stack\"chainsNoethereumTarget chain(s): single chain name or comma-separated listscaleNo--Expected scale: transaction volume, concurrent users, latency requirements" }, { "title": "Workflow", "body": "Extract parameters from the user's request: identify the project type, required functionality, target environment, chains, and scale requirements. If the user has an existing codebase, note it for the agent to analyze.\n\n\nDelegate to integration-architect: Invoke Task(subagent_type:integration-architect) with the full context. The integration-architect will:\n\nUnderstand the project context and requirements\nEvaluate integration methods and recommend primary + fallback\nDesign the component architecture with data flow\nIdentify all dependencies (NPM packages, APIs, infrastructure)\nPerform a security review with attack vectors and mitigations\nProduce an ordered implementation plan with effort estimates\n\n\n\nPresent the blueprint to the user covering:\n\nIntegration method recommendation with clear rationale\nArchitecture overview (components, data flow, error handling)\nComplete dependency list with versions and purposes\nSecurity considerations with specific mitigations\nStep-by-step implementation order with effort estimates\nOverall complexity assessment" }, { "title": "Output Format", "body": "Present a structured integration blueprint:\n\nIntegration Blueprint: DeFi Dashboard with Swap (Ethereum + Base)\n\n Recommended Method: Trading API (primary), Universal Router SDK (fallback)\n Rationale: Trading API provides optimized routing with minimal frontend\n complexity. Fallback to SDK for advanced use cases or API downtime.\n\n Architecture:\n User -> QuoteService -> ApprovalManager -> SwapExecutor -> Wallet -> Chain\n \n Components:\n QuoteService: Fetches and caches quotes from Trading API\n ApprovalManager: Manages Permit2 approvals and allowances\n SwapExecutor: Constructs and submits swap transactions\n ChainManager: Multi-chain config and RPC connections\n\n Dependencies:\n @uniswap/sdk-core ^5.8.0 Token and price primitives\n viem ^2.21.0 Ethereum client\n wagmi ^2.14.0 React wallet hooks\n @tanstack/react-query ^5.0.0 Data fetching and caching\n\n Security:\n - Stale quotes: Refresh every 15s, enforce deadline (block.timestamp + 300s)\n - Approvals: Permit2 with exact amounts and 30-min expiry\n - Key management: wagmi wallet connection only, never handle keys\n\n Implementation Order:\n 1. Wallet connection (wagmi) — 1 day\n 2. Chain configuration — 0.5 days\n 3. Quote fetching service — 1 day\n 4. Permit2 approval flow — 1 day\n 5. Swap execution and tracking — 1.5 days\n 6. Error handling and retry logic — 1 day\n\n Complexity: Medium" }, { "title": "Important Notes", "body": "This skill delegates entirely to the integration-architect agent -- it does not call MCP tools directly.\nThe blueprint is tailored to the specific project type and requirements -- not a generic template.\nFor existing codebases, the agent will analyze the current code and recommend integration patterns that fit the existing architecture.\nThe implementation order considers dependencies between components -- follow the order for smoothest development.\nAlways uses viem (not ethers.js) and Permit2 (not legacy approve) per project conventions." }, { "title": "Error Handling", "body": "ErrorUser-Facing MessageSuggested ActionVAGUE_PROJECT\"Need more detail about your project to recommend an integration approach.\"Describe project type and what Uniswap functionality is neededDEPRECATED_APPROACH\"The requested integration method is deprecated. Recommending alternatives.\"Follow the updated recommendationUNSUPPORTED_CHAIN\"Uniswap is not deployed on the specified chain.\"Choose from the 11 supported chainsCONFLICTING_REQUIREMENTS\"The requirements conflict (e.g., frontend + direct contract calls).\"Clarify the execution environment and adjust expectations" } ], "body": "Design Integration\nOverview\n\nDesigns a complete Uniswap integration architecture for any project by delegating to the integration-architect agent. Produces a comprehensive blueprint covering: integration method recommendation (Trading API vs Universal Router SDK vs direct contract vs V4 hooks), component architecture, dependency list with versions, security review with mitigations, and ordered implementation plan.\n\nWhen to Use\n\nActivate when the user asks:\n\n\"Help me integrate Uniswap\"\n\"Design a swap integration\"\n\"Architecture for a DEX aggregator\"\n\"How to build an arbitrage bot\"\n\"Uniswap integration plan\"\n\"How should I add swaps to my dApp?\"\n\"Best way to integrate Uniswap in my backend\"\n\"Architecture for a DeFi protocol that uses Uniswap\"\n\"What SDK should I use for Uniswap?\"\nParameters\nParameter\tRequired\tDefault\tDescription\nprojectType\tYes\t--\tType of project (e.g., \"DeFi dashboard\", \"arb bot\", \"wallet app\", \"DeFi protocol\")\nfunctionality\tYes\t--\tRequired Uniswap functionality: \"swap\", \"LP\", \"both\", or \"custom\"\nenvironment\tNo\tAuto-detect\tExecution environment: \"frontend\", \"backend\", \"smart contract\", or \"full-stack\"\nchains\tNo\tethereum\tTarget chain(s): single chain name or comma-separated list\nscale\tNo\t--\tExpected scale: transaction volume, concurrent users, latency requirements\nWorkflow\n\nExtract parameters from the user's request: identify the project type, required functionality, target environment, chains, and scale requirements. If the user has an existing codebase, note it for the agent to analyze.\n\nDelegate to integration-architect: Invoke Task(subagent_type:integration-architect) with the full context. The integration-architect will:\n\nUnderstand the project context and requirements\nEvaluate integration methods and recommend primary + fallback\nDesign the component architecture with data flow\nIdentify all dependencies (NPM packages, APIs, infrastructure)\nPerform a security review with attack vectors and mitigations\nProduce an ordered implementation plan with effort estimates\n\nPresent the blueprint to the user covering:\n\nIntegration method recommendation with clear rationale\nArchitecture overview (components, data flow, error handling)\nComplete dependency list with versions and purposes\nSecurity considerations with specific mitigations\nStep-by-step implementation order with effort estimates\nOverall complexity assessment\nOutput Format\n\nPresent a structured integration blueprint:\n\nIntegration Blueprint: DeFi Dashboard with Swap (Ethereum + Base)\n\n Recommended Method: Trading API (primary), Universal Router SDK (fallback)\n Rationale: Trading API provides optimized routing with minimal frontend\n complexity. Fallback to SDK for advanced use cases or API downtime.\n\n Architecture:\n User -> QuoteService -> ApprovalManager -> SwapExecutor -> Wallet -> Chain\n \n Components:\n QuoteService: Fetches and caches quotes from Trading API\n ApprovalManager: Manages Permit2 approvals and allowances\n SwapExecutor: Constructs and submits swap transactions\n ChainManager: Multi-chain config and RPC connections\n\n Dependencies:\n @uniswap/sdk-core ^5.8.0 Token and price primitives\n viem ^2.21.0 Ethereum client\n wagmi ^2.14.0 React wallet hooks\n @tanstack/react-query ^5.0.0 Data fetching and caching\n\n Security:\n - Stale quotes: Refresh every 15s, enforce deadline (block.timestamp + 300s)\n - Approvals: Permit2 with exact amounts and 30-min expiry\n - Key management: wagmi wallet connection only, never handle keys\n\n Implementation Order:\n 1. Wallet connection (wagmi) — 1 day\n 2. Chain configuration — 0.5 days\n 3. Quote fetching service — 1 day\n 4. Permit2 approval flow — 1 day\n 5. Swap execution and tracking — 1.5 days\n 6. Error handling and retry logic — 1 day\n\n Complexity: Medium\n\nImportant Notes\nThis skill delegates entirely to the integration-architect agent -- it does not call MCP tools directly.\nThe blueprint is tailored to the specific project type and requirements -- not a generic template.\nFor existing codebases, the agent will analyze the current code and recommend integration patterns that fit the existing architecture.\nThe implementation order considers dependencies between components -- follow the order for smoothest development.\nAlways uses viem (not ethers.js) and Permit2 (not legacy approve) per project conventions.\nError Handling\nError\tUser-Facing Message\tSuggested Action\nVAGUE_PROJECT\t\"Need more detail about your project to recommend an integration approach.\"\tDescribe project type and what Uniswap functionality is needed\nDEPRECATED_APPROACH\t\"The requested integration method is deprecated. Recommending alternatives.\"\tFollow the updated recommendation\nUNSUPPORTED_CHAIN\t\"Uniswap is not deployed on the specified chain.\"\tChoose from the 11 supported chains\nCONFLICTING_REQUIREMENTS\t\"The requirements conflict (e.g., frontend + direct contract calls).\"\tClarify the execution environment and adjust expectations" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/wpank/design-integration", "publisherUrl": "https://clawhub.ai/wpank/design-integration", "owner": "wpank", "version": "0.1.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/design-integration", "downloadUrl": "https://openagent3.xyz/downloads/design-integration", "agentUrl": "https://openagent3.xyz/skills/design-integration/agent", "manifestUrl": "https://openagent3.xyz/skills/design-integration/agent.json", "briefUrl": "https://openagent3.xyz/skills/design-integration/agent.md" } }