chain-integration

Integrate new blockchain chains into ShapeShift Web and HDWallet workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill guides the end-to-end process to add a new blockchain as a second-class citizen in ShapeShift Web and HDWallet, covering native support, Verdaccio publishing, web adapters, feature flags, and local testing.

Core Features & Use Cases

  • HDWallet native support: Enable native wallet flow for the new chain.
  • Verdaccio publishing: Local publish workflow to test changes without publishing.
  • Web integration: Implement poor-man's chain adapter patterns and wire-up in the web repo.
  • Ledger support (optional): Extend support if Ledger integration exists.
  • Feature flag gating: Gate the new chain behind a feature flag for safe rollout.

Quick Start

Follow Phase 1-4 steps to introduce a new chain, starting with HDWallet native support and Verdaccio testing.

Frequently Asked Questions about chain-integration

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

FAQPage Schema
How do I add support for a new blockchain to ShapeShift Web and HDWallet?

Add blockchain support end-to-end by enabling native chain integration in HDWallet, publishing via local Verdaccio, implementing web adapters, and gating behind feature flags. This approach covers native asset sends/receives, account derivation, swaps, and public RPC-based operation without requiring microservices.

What's the workflow for integrating a new chain from HDWallet to web deployment?

Chain integration follows four phases: enable HDWallet native support for the chain, test locally with Verdaccio publishing, implement web-based chain adapters using poor-man's patterns, and gate the chain behind a feature flag for safe rollout. Optional Ledger support extends the flow if needed.

Can I add Ledger support when integrating a new blockchain?

Yes, Ledger integration is optional within the chain integration workflow. Enable it as an extension after establishing core HDWallet native support and web adapter patterns, following the disciplined development flow from discovery through final commits.

Do I need to publish changes to a package registry during chain integration?

Local Verdaccio publishing enables testing chain changes without deploying to a live registry. This workflow lets you validate HDWallet modifications and web integration before final commits and rollout.

What's the minimum setup required to start adding a new chain?

Begin with Phase 1: establish HDWallet native support for the chain. This prerequisite enables account derivation and native asset operations, forming the foundation for subsequent Verdaccio testing, web integration, and feature-flag gating stages.