@coin-voyage/swapkit 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2026 Coin Voyage
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,68 @@
+# @coin-voyage/swapkit
+
+Embeddable Coin Voyage swap UI for React applications. SwapKit uses styled-components and does not require Tailwind CSS.
+
+## Installation
+
+```sh
+pnpm add @coin-voyage/swapkit @tanstack/react-query react react-dom styled-components
+```
+
+Install the wallet peer dependencies listed in this package's `package.json` for the chains your application supports.
+
+## Usage
+
+```tsx
+import { Swap, SwapKitProvider, WalletProvider } from "@coin-voyage/swapkit"
+
+export function App() {
+  return (
+    <WalletProvider>
+      <SwapKitProvider apiKey={process.env.NEXT_PUBLIC_COIN_VOYAGE_API_KEY!} environment="development" mode="dark">
+        <Swap
+          defaultSourceCurrency={{ chain_id: 1 }}
+          defaultDestinationCurrency={{
+            chain_id: 30000000000001,
+            address: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+          }}
+        />
+      </SwapKitProvider>
+    </WalletProvider>
+  )
+}
+```
+
+`SwapKitProvider` deliberately uses the public API client and never accepts an admin signing key. It must be rendered
+inside `WalletProvider`, which SwapKit re-exports from its canonical implementation in `@coin-voyage/crypto/wallets`.
+The wallet provider supplies React Query and the supported chain contexts, while reusing a compatible host Query
+Client when one already exists.
+
+`Swap` optionally accepts `defaultSourceCurrency`, `defaultDestinationCurrency`, and `defaultSlippageBps`, plus
+`onComplete` and `onError` callbacks for host notifications. Currency defaults use `{ chain_id, address? }`; token
+addresses are matched case-insensitively. Slippage is an integer from `0` to `10000` basis points.
+
+When `defaultSlippageBps` is omitted, slippage starts in Auto mode and SwapKit lets the quote service choose the
+appropriate tolerance. The custom control retains a `1%` draft. Supplying `defaultSlippageBps` starts the widget in
+Custom mode and sends that value with quote and execution requests.
+
+Defaults are read once when a widget mounts. Changing them later does not interrupt an in-progress swap; remount the
+widget with a new React `key` to apply a new set of defaults. Unsupported defaults fall back to the normal automatic
+selection.
+
+### Theming
+
+Use `mode="light"` or `mode="dark"`. The optional `theme` prop overrides individual widget colors:
+
+```tsx
+<SwapKitProvider apiKey={apiKey} mode="dark" theme={{ accent: "#7c3aed", radius: "18px" }}>
+  <Swap />
+</SwapKitProvider>
+```
+
+## Development
+
+```sh
+pnpm --filter @coin-voyage/swapkit test
+pnpm --filter @coin-voyage/swapkit type-check
+pnpm --filter @coin-voyage/swapkit build
+```

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@coin-voyage/swapkit",
+  "description": "A reusable cross-chain swap component for CoinVoyage.",
+  "version": "0.1.0-beta.0",
+  "private": false,
+  "sideEffects": false,
+  "author": "Lars <lars@coinvoyage.io>",
+  "homepage": "https://coinvoyage.io",
+  "license": "BSD-2-Clause",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@coin-voyage/shared": "3.4.1-beta.0",
+    "@coin-voyage/crypto": "3.3.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/styled-components": "^5.1.36",
+    "@vitest/coverage-v8": "3.2.0",
+    "jsdom": "^26.1.0",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "typescript-plugin-styled-components": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@bigmi/react": "^0.8.0",
+    "@mysten/dapp-kit-react": "^2.1.4",
+    "@solana/wallet-adapter-react": "^0.15.39",
+    "@tanstack/react-query": "^5.90.6",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19",
+    "styled-components": "^5.3.11",
+    "viem": "^2.55.10",
+    "wagmi": "^3.6.16"
+  },
+  "keywords": [
+    "blockchain",
+    "swap",
+    "cross-chain",
+    "react",
+    "coin-voyage"
+  ],
+  "scripts": {
+    "watch": "tsc -w -p ./tsconfig.json",
+    "build": "tsc --build --force",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:coverage": "vitest run --coverage --maxWorkers=1 --no-file-parallelism --config ./vitest.config.ts",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo coverage",
+    "pre:release": "pnpm version prerelease --preid=beta",
+    "pre:publish": "pnpm publish --access public --tag beta --no-git-checks",
+    "pre:steps": "pnpm pre:release && pnpm release:build && pnpm pre:publish",
+    "release:build": "pnpm clean && pnpm build",
+    "release": "pnpm publish --access public --no-git-checks",
+    "type-check": "tsc --noEmit"
+  }
+}