skills.rest
shapeshift
shapeshiftOFFICIAL
Explore all skills by this author →
Website𝕏@ShapeShiftGitHub

swapper-integration

Coordinate swapper provider integration into ShapeShift Web with TypeScript interfaces.

203|199|Updated Sep 1, 2021
Search Tags:#integration#status#swapper#rates#dex#quotes
One-click install
npx skills add https://github.com/shapeshift/web --skill swapper-integration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swapper-integration
Source: https://github.com/shapeshift/web/tree/main/.claude/skills/swapper-integration
Command: npx skills add https://github.com/shapeshift/web --skill swapper-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps researchers, engineers, and product teams add support for new swappers (DEX aggregators, bridges, etc.) by providing proven patterns, files, and best practices to implement quotes, rates, and status checks.

Core Features & Use Cases

  • Research & pattern analysis: Learn from existing swapper implementations (Bebop, Chainflip, NEAR Intents, etc.).
  • Implementation blueprint: Create swapper scaffolds with quote/rate/status logic and tests.
  • Testing & validation: Validate API responses, error handling, and integration with the UI.

Quick Start

Create a new swappper under packages/swapper/src/swappers/[SwapperName]Swapper and follow the established file structure to implement quoting, pricing, and status APIs.

Frequently Asked Questions about swapper-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a new swapper into ShapeShift Web?▼

Integrate a new swapper by creating a folder under packages/swapper/src/swappers/[SwapperName]Swapper, implementing the Swapper and SwapperApi TypeScript interfaces, and following the established file structure for quotes, rates, and status logic. This ensures production-ready integrations across EVM, Solana, and cross-chain patterns.

What file structure and patterns should I follow for a swapper implementation?▼

Swapper implementations must enforce core TypeScript interfaces (Swapper and SwapperApi), use monadic error handling, apply service layer patterns, and include quote/rate/status logic. Follow the documented file structure and common gotchas guidelines to maintain consistency with existing providers like Bebop, Chainflip, 0x, and Jupiter.

Which swapper providers are already integrated, and can I learn from their implementation?▼

ShapeShift Web includes proven integrations for Bebop, Portals, 0x, Jupiter, Chainflip, and NEAR Intents. Study these existing implementations to understand patterns for API research, quote handling, and cross-chain workflows before building your own swapper.

What testing and validation steps are required for a new swapper?▼

Validate API responses, error handling, and UI integration through testing workflows. Ensure your swapper implementation handles edge cases, respects the monadic error pattern, and integrates properly with ShapeShift Web's service layer before production deployment.

Can I use this integration pattern for bridges and DEX aggregators?▼

Yes. The swapper integration pattern applies to DEX aggregators, bridges, and other swap providers. It supports diverse protocols and chains—EVM, Solana, and cross-chain—through a unified Swapper interface and standardized quote/rate/status workflows.

Related Skills

Explore More Software Engineering Skills→
RandyPenRandyPen
6

cetus-aggregator

Execute optimized token swaps across 30+ Sui DEXs with slippage protection.

Community
Intermediate
DNYoussefDNYoussef
4

when-releasing-software-use-github-release-management

Automate GitHub release management with versioning, changelogs, and rollback.

Community
Advanced
koralliskorallis
90

backend-service-patterns

Architect scalable backend services using layered architecture and dependency injection.

Community
Advanced
gist-kol-copy-trade-agentgist-kol-copy-trade-agent
1

okx-dex-swap

Aggregate DEX liquidity across multiple chains for optimized swap quotes and execution.

Official
Advanced