@compass-labs/widgets 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/server/handler.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { CompassApiSDK } from '@compass-labs/api-sdk';\nimport {\n createWalletClient,\n createPublicClient,\n http,\n type Chain,\n type Hex,\n} from 'viem';\nimport { privateKeyToAccount } from 'viem/accounts';\nimport { mainnet, base, arbitrum } from 'viem/chains';\n\nconst CHAIN_MAP: Record<string, Chain> = {\n ethereum: mainnet,\n base: base,\n arbitrum: arbitrum,\n};\n\nexport interface CompassHandlerConfig {\n /** Compass API key - keep this in environment variables */\n apiKey: string;\n /** Optional custom API server URL */\n serverUrl?: string;\n /** Gas sponsor private key (required for executing gas-sponsored transactions) */\n gasSponsorPrivateKey?: string;\n /** RPC URLs per chain (required for executing gas-sponsored transactions) */\n rpcUrls?: {\n ethereum?: string;\n base?: string;\n arbitrum?: string;\n };\n}\n\nexport interface CompassRouteContext {\n params: Promise<{ path: string[] }>;\n}\n\ntype NextRequest = Request;\n\n/**\n * Creates a Next.js API route handler for Compass widget operations.\n *\n * This handler proxies requests from client-side widgets to the Compass API,\n * keeping your API key secure on the server.\n *\n * @example\n * ```typescript\n * // app/api/compass/[...path]/route.ts\n * import { createCompassHandler } from '@compass-labs/widgets/server';\n *\n * const handler = createCompassHandler({\n * apiKey: process.env.COMPASS_API_KEY!,\n * gasSponsorPrivateKey: process.env.GAS_SPONSOR_PK,\n * rpcUrls: {\n * ethereum: process.env.ETHEREUM_MAINNET_RPC_URL,\n * base: process.env.BASE_MAINNET_RPC_URL,\n * arbitrum: process.env.ARBITRUM_MAINNET_RPC_URL,\n * },\n * });\n *\n * export const GET = handler;\n * export const POST = handler;\n * ```\n *\n * The handler supports these routes:\n * - GET /api/compass/earn-account/check?owner=0x...&chain=base\n * - POST /api/compass/create-account\n * - POST /api/compass/deposit/prepare\n * - POST /api/compass/deposit/execute\n * - POST /api/compass/withdraw/prepare\n * - POST /api/compass/withdraw/execute\n */\nexport function createCompassHandler(config: CompassHandlerConfig) {\n const { apiKey, serverUrl = 'https://api.compasslabs.ai' } = config;\n\n // Create SDK client\n const client = new CompassApiSDK({\n apiKeyAuth: apiKey,\n serverURL: serverUrl,\n });\n\n return async function handler(\n request: NextRequest,\n context: CompassRouteContext\n ): Promise<Response> {\n try {\n const { path } = await context.params;\n const route = path.join('/');\n const method = request.method;\n\n // Handle GET requests\n if (method === 'GET') {\n const url = new URL(request.url);\n const searchParams = Object.fromEntries(url.searchParams.entries());\n\n switch (route) {\n case 'earn-account/check':\n return await handleEarnAccountCheck(client, searchParams);\n default:\n return jsonResponse({ error: `Unknown GET route: ${route}` }, 404);\n }\n }\n\n // Handle POST requests\n if (method === 'POST') {\n const body = await request.json();\n\n switch (route) {\n case 'create-account':\n return await handleCreateAccount(client, body, config);\n case 'deposit/prepare':\n return await handleManagePrepare(client, body, 'DEPOSIT');\n case 'deposit/execute':\n return await handleExecute(client, body, config);\n case 'withdraw/prepare':\n return await handleManagePrepare(client, body, 'WITHDRAW');\n case 'withdraw/execute':\n return await handleExecute(client, body, config);\n default:\n return jsonResponse({ error: `Unknown POST route: ${route}` }, 404);\n }\n }\n\n return jsonResponse({ error: `Method ${method} not allowed` }, 405);\n } catch (error) {\n console.error('[Compass Handler Error]', error);\n const message = error instanceof Error ? error.message : 'Internal server error';\n return jsonResponse({ error: message }, 500);\n }\n };\n}\n\nfunction jsonResponse(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data), {\n status,\n headers: { 'Content-Type': 'application/json' },\n });\n}\n\n// --- Earn Account Handlers ---\n\ninterface EarnAccountCheckParams {\n owner?: string;\n chain?: string;\n}\n\nasync function handleEarnAccountCheck(\n client: CompassApiSDK,\n params: EarnAccountCheckParams\n): Promise<Response> {\n const { owner, chain = 'base' } = params;\n\n if (!owner) {\n return jsonResponse({ error: 'Missing owner parameter' }, 400);\n }\n\n // Use the SDK's earnCreateAccount method to check if account exists\n // - If response has `transaction` field → account doesn't exist yet\n // - If response has no `transaction` field → account already exists\n const response = await client.earn.earnCreateAccount({\n chain: chain as any,\n owner: owner as `0x${string}`,\n sender: owner as `0x${string}`,\n estimateGas: false,\n });\n\n const earnAccountAddress = response.earnAccountAddress;\n const hasTransaction = !!response.transaction;\n\n return jsonResponse({\n earnAccountAddress,\n isDeployed: !hasTransaction,\n needsCreation: hasTransaction,\n });\n}\n\ninterface CreateAccountBody {\n owner: string;\n chain?: string;\n}\n\nasync function handleCreateAccount(\n client: CompassApiSDK,\n body: CreateAccountBody,\n config: CompassHandlerConfig\n): Promise<Response> {\n const { owner, chain = 'base' } = body;\n const { gasSponsorPrivateKey, rpcUrls } = config;\n\n if (!owner) {\n return jsonResponse({ error: 'Missing owner parameter' }, 400);\n }\n\n if (!gasSponsorPrivateKey) {\n return jsonResponse(\n { error: 'Gas sponsor not configured. Set gasSponsorPrivateKey in handler config.' },\n 500\n );\n }\n\n // Get chain config\n const viemChain = CHAIN_MAP[chain.toLowerCase()];\n if (!viemChain) {\n return jsonResponse({ error: `Unsupported chain: ${chain}` }, 500);\n }\n\n // Get RPC URL for the chain\n const rpcUrl = rpcUrls?.[chain.toLowerCase() as keyof typeof rpcUrls];\n if (!rpcUrl) {\n return jsonResponse({ error: `No RPC URL configured for chain: ${chain}` }, 500);\n }\n\n // Create sponsor account from private key\n const sponsorAccount = privateKeyToAccount(gasSponsorPrivateKey as Hex);\n\n // Create wallet client for signing/sending transactions\n const walletClient = createWalletClient({\n account: sponsorAccount,\n chain: viemChain,\n transport: http(rpcUrl),\n });\n\n // Create public client for waiting on receipts\n const publicClient = createPublicClient({\n chain: viemChain,\n transport: http(rpcUrl),\n });\n\n // Get create account transaction from API with sponsor as sender\n const response = await client.earn.earnCreateAccount({\n chain: chain as any,\n owner: owner as `0x${string}`,\n sender: sponsorAccount.address,\n estimateGas: false,\n });\n\n const earnAccountAddress = response.earnAccountAddress;\n\n // If no transaction needed (account may already exist)\n if (!response.transaction) {\n return jsonResponse({\n earnAccountAddress,\n success: true,\n alreadyExists: true,\n });\n }\n\n // Send the transaction from the sponsor wallet\n const transaction = response.transaction;\n const txHash = await walletClient.sendTransaction({\n to: transaction.to as Hex,\n data: transaction.data as Hex,\n value: transaction.value ? BigInt(transaction.value) : 0n,\n gas: transaction.gas ? BigInt(transaction.gas) : undefined,\n });\n\n // Wait for the transaction receipt\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n });\n\n // Check if transaction reverted\n if (receipt.status === 'reverted') {\n return jsonResponse({ error: 'Account creation transaction reverted' }, 500);\n }\n\n return jsonResponse({\n earnAccountAddress,\n txHash,\n success: true,\n });\n}\n\n// --- Manage (Deposit/Withdraw) Handlers ---\n\ninterface ManagePrepareBody {\n amount: string;\n token: string;\n owner: string;\n chain: string;\n venueType: 'VAULT' | 'AAVE' | 'PENDLE_PT';\n vaultAddress?: string;\n marketAddress?: string;\n maxSlippagePercent?: number;\n}\n\ntype ManageAction = 'DEPOSIT' | 'WITHDRAW';\n\nasync function handleManagePrepare(\n client: CompassApiSDK,\n body: ManagePrepareBody,\n action: ManageAction\n): Promise<Response> {\n const { amount, token, owner, chain, venueType, vaultAddress, marketAddress, maxSlippagePercent } = body;\n\n // Build venue based on type\n let venue: any;\n\n if (venueType === 'VAULT' && vaultAddress) {\n venue = {\n type: 'VAULT' as const,\n vaultAddress,\n };\n } else if (venueType === 'AAVE') {\n venue = {\n type: 'AAVE' as const,\n token,\n };\n } else if (venueType === 'PENDLE_PT' && marketAddress) {\n venue = {\n type: 'PENDLE_PT' as const,\n marketAddress,\n token: action === 'DEPOSIT' ? token : undefined,\n maxSlippagePercent: maxSlippagePercent ?? 1.0,\n };\n } else {\n return jsonResponse({ error: 'Invalid venue type or missing address' }, 400);\n }\n\n const response = await client.earn.earnManage({\n owner,\n chain: chain as any,\n venue,\n action,\n amount,\n gasSponsorship: true,\n });\n\n // Extract EIP-712 data for signing\n const eip712 = (response as any).eip712;\n if (!eip712) {\n return jsonResponse({ error: 'No EIP-712 data returned from API' }, 500);\n }\n\n // Normalize types for wallet signing\n // SDK returns camelCase keys (safeTx, eip712Domain) but wallets expect PascalCase (SafeTx)\n // to match the primaryType\n const types = eip712.types as any;\n const normalizedTypes = {\n EIP712Domain: types.eip712Domain,\n SafeTx: types.safeTx,\n };\n\n return jsonResponse({\n eip712,\n normalizedTypes,\n domain: eip712.domain,\n message: eip712.message,\n });\n}\n\n// --- Execute Handler (shared for all operations) ---\n\ninterface ExecuteBody {\n owner: string;\n eip712: any;\n signature: string;\n chain: string;\n}\n\nasync function handleExecute(\n client: CompassApiSDK,\n body: ExecuteBody,\n config: CompassHandlerConfig\n): Promise<Response> {\n const { owner, eip712, signature, chain } = body;\n const { gasSponsorPrivateKey, rpcUrls } = config;\n\n // Validate gas sponsor config\n if (!gasSponsorPrivateKey) {\n return jsonResponse(\n { error: 'Gas sponsor not configured. Set gasSponsorPrivateKey in handler config.' },\n 500\n );\n }\n\n // Get chain config\n const viemChain = CHAIN_MAP[chain.toLowerCase()];\n if (!viemChain) {\n return jsonResponse({ error: `Unsupported chain: ${chain}` }, 500);\n }\n\n // Get RPC URL for the chain\n const rpcUrl = rpcUrls?.[chain.toLowerCase() as keyof typeof rpcUrls];\n if (!rpcUrl) {\n return jsonResponse({ error: `No RPC URL configured for chain: ${chain}` }, 500);\n }\n\n // Create sponsor account from private key\n const sponsorAccount = privateKeyToAccount(gasSponsorPrivateKey as Hex);\n\n // Create wallet client for signing/sending transactions\n const walletClient = createWalletClient({\n account: sponsorAccount,\n chain: viemChain,\n transport: http(rpcUrl),\n });\n\n // Create public client for waiting on receipts\n const publicClient = createPublicClient({\n chain: viemChain,\n transport: http(rpcUrl),\n });\n\n // Call gas sponsorship prepare with sponsor as sender\n const response = await client.gasSponsorship.gasSponsorshipPrepare({\n chain: chain as any,\n owner,\n sender: sponsorAccount.address,\n eip712,\n signature,\n });\n\n // Extract the unsigned transaction from the response\n const transaction = (response as any).transaction;\n if (!transaction) {\n return jsonResponse(\n { error: 'No transaction returned from gas sponsorship prepare' },\n 500\n );\n }\n\n // Send the transaction from the sponsor wallet\n const txHash = await walletClient.sendTransaction({\n to: transaction.to as Hex,\n data: transaction.data as Hex,\n value: transaction.value ? BigInt(transaction.value) : 0n,\n gas: transaction.gas ? BigInt(transaction.gas) : undefined,\n });\n\n // Wait for the transaction receipt\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n });\n\n // Check if transaction reverted\n if (receipt.status === 'reverted') {\n return jsonResponse({ error: 'Transaction reverted' }, 500);\n }\n\n return jsonResponse({ txHash, success: true });\n}\n"]}
@@ -0,0 +1,166 @@
1
+ /* @compass-labs/widgets - Base Styles */
2
+
3
+ /* Default theme (dark) */
4
+ :root {
5
+ --compass-color-primary: #8b5cf6;
6
+ --compass-color-primary-hover: #7c3aed;
7
+ --compass-color-primary-text: #ffffff;
8
+ --compass-color-background: #0a0a0b;
9
+ --compass-color-surface: #141417;
10
+ --compass-color-border: rgba(255, 255, 255, 0.08);
11
+ --compass-color-text: #ffffff;
12
+ --compass-color-text-secondary: #a1a1aa;
13
+ --compass-color-text-tertiary: #71717a;
14
+ --compass-color-success: #22c55e;
15
+ --compass-color-success-muted: rgba(34, 197, 94, 0.1);
16
+ --compass-color-error: #ef4444;
17
+ --compass-color-error-muted: rgba(239, 68, 68, 0.1);
18
+ --compass-color-warning: #f59e0b;
19
+ --compass-color-warning-muted: rgba(245, 158, 11, 0.1);
20
+ --compass-color-secondary: rgba(255, 255, 255, 0.06);
21
+
22
+ --compass-font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
23
+ --compass-font-size-xs: 0.75rem;
24
+ --compass-font-size-small: 0.875rem;
25
+ --compass-font-size-body: 1rem;
26
+ --compass-font-size-large: 1.125rem;
27
+
28
+ --compass-border-radius: 0.75rem;
29
+ --compass-border-radius-sm: 0.5rem;
30
+ --compass-border-radius-lg: 1rem;
31
+ }
32
+
33
+ /* Light theme override */
34
+ [data-compass-theme="light"] {
35
+ --compass-color-primary: #7c3aed;
36
+ --compass-color-primary-hover: #6d28d9;
37
+ --compass-color-primary-text: #ffffff;
38
+ --compass-color-background: #ffffff;
39
+ --compass-color-surface: #f4f4f5;
40
+ --compass-color-border: rgba(0, 0, 0, 0.08);
41
+ --compass-color-text: #18181b;
42
+ --compass-color-text-secondary: #52525b;
43
+ --compass-color-text-tertiary: #a1a1aa;
44
+ --compass-color-success: #16a34a;
45
+ --compass-color-success-muted: rgba(22, 163, 74, 0.1);
46
+ --compass-color-error: #dc2626;
47
+ --compass-color-error-muted: rgba(220, 38, 38, 0.1);
48
+ --compass-color-warning: #d97706;
49
+ --compass-color-warning-muted: rgba(217, 119, 6, 0.1);
50
+ --compass-color-secondary: rgba(0, 0, 0, 0.04);
51
+ }
52
+
53
+ /* Base widget container */
54
+ .compass-widget {
55
+ font-family: var(--compass-font-family);
56
+ color: var(--compass-color-text);
57
+ font-size: var(--compass-font-size-body);
58
+ line-height: 1.5;
59
+ -webkit-font-smoothing: antialiased;
60
+ -moz-osx-font-smoothing: grayscale;
61
+ }
62
+
63
+ /* Reset box-sizing for widget */
64
+ .compass-widget *,
65
+ .compass-widget *::before,
66
+ .compass-widget *::after {
67
+ box-sizing: border-box;
68
+ }
69
+
70
+ /* Utility classes */
71
+ .compass-widget-card {
72
+ background-color: var(--compass-color-surface);
73
+ border: 1px solid var(--compass-color-border);
74
+ border-radius: var(--compass-border-radius);
75
+ padding: 1rem;
76
+ }
77
+
78
+ .compass-widget-button {
79
+ display: inline-flex;
80
+ align-items: center;
81
+ justify-content: center;
82
+ gap: 0.5rem;
83
+ padding: 0.75rem 1rem;
84
+ font-size: var(--compass-font-size-small);
85
+ font-weight: 500;
86
+ border-radius: var(--compass-border-radius-sm);
87
+ border: none;
88
+ cursor: pointer;
89
+ transition: all 0.15s ease;
90
+ }
91
+
92
+ .compass-widget-button-primary {
93
+ background-color: var(--compass-color-primary);
94
+ color: var(--compass-color-primary-text);
95
+ }
96
+
97
+ .compass-widget-button-primary:hover:not(:disabled) {
98
+ background-color: var(--compass-color-primary-hover);
99
+ }
100
+
101
+ .compass-widget-button-primary:disabled {
102
+ opacity: 0.5;
103
+ cursor: not-allowed;
104
+ }
105
+
106
+ .compass-widget-button-secondary {
107
+ background-color: var(--compass-color-secondary);
108
+ color: var(--compass-color-text-secondary);
109
+ }
110
+
111
+ .compass-widget-button-secondary:hover:not(:disabled) {
112
+ background-color: var(--compass-color-border);
113
+ }
114
+
115
+ /* Loading spinner */
116
+ .compass-widget-spinner {
117
+ animation: compass-spin 1s linear infinite;
118
+ }
119
+
120
+ @keyframes compass-spin {
121
+ from {
122
+ transform: rotate(0deg);
123
+ }
124
+ to {
125
+ transform: rotate(360deg);
126
+ }
127
+ }
128
+
129
+ /* Input styles */
130
+ .compass-widget-input {
131
+ width: 100%;
132
+ padding: 0.75rem 1rem;
133
+ font-size: var(--compass-font-size-body);
134
+ font-family: var(--compass-font-family);
135
+ background-color: var(--compass-color-background);
136
+ color: var(--compass-color-text);
137
+ border: 1px solid var(--compass-color-border);
138
+ border-radius: var(--compass-border-radius-sm);
139
+ outline: none;
140
+ transition: border-color 0.15s ease;
141
+ }
142
+
143
+ .compass-widget-input:focus {
144
+ border-color: var(--compass-color-primary);
145
+ }
146
+
147
+ .compass-widget-input::placeholder {
148
+ color: var(--compass-color-text-tertiary);
149
+ }
150
+
151
+ /* Select styles */
152
+ .compass-widget-select {
153
+ padding: 0.5rem 0.75rem;
154
+ font-size: var(--compass-font-size-small);
155
+ font-family: var(--compass-font-family);
156
+ background-color: var(--compass-color-background);
157
+ color: var(--compass-color-text);
158
+ border: 1px solid var(--compass-color-border);
159
+ border-radius: var(--compass-border-radius-sm);
160
+ cursor: pointer;
161
+ outline: none;
162
+ }
163
+
164
+ .compass-widget-select:focus {
165
+ border-color: var(--compass-color-primary);
166
+ }
package/package.json ADDED
@@ -0,0 +1,76 @@
1
+ {
2
+ "name": "@compass-labs/widgets",
3
+ "version": "0.1.0",
4
+ "description": "Embeddable DeFi widgets powered by Compass Labs",
5
+ "author": "Compass Labs",
6
+ "license": "MIT",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "https://github.com/CompassLabs/mono.git",
10
+ "directory": "widgets-sdk"
11
+ },
12
+ "homepage": "https://docs.compasslabs.ai/v2/Products/Widgets",
13
+ "bugs": {
14
+ "url": "https://github.com/CompassLabs/mono/issues"
15
+ },
16
+ "keywords": [
17
+ "defi",
18
+ "react",
19
+ "widgets",
20
+ "ethereum",
21
+ "yield",
22
+ "vaults",
23
+ "aave",
24
+ "pendle",
25
+ "compass"
26
+ ],
27
+ "main": "./dist/index.cjs",
28
+ "module": "./dist/index.js",
29
+ "types": "./dist/index.d.ts",
30
+ "exports": {
31
+ ".": {
32
+ "types": "./dist/index.d.ts",
33
+ "import": "./dist/index.mjs",
34
+ "require": "./dist/index.js"
35
+ },
36
+ "./server": {
37
+ "types": "./dist/server/index.d.ts",
38
+ "import": "./dist/server/index.mjs",
39
+ "require": "./dist/server/index.js"
40
+ },
41
+ "./styles.css": "./dist/styles.css"
42
+ },
43
+ "files": [
44
+ "dist",
45
+ "README.md"
46
+ ],
47
+ "sideEffects": [
48
+ "*.css"
49
+ ],
50
+ "scripts": {
51
+ "build": "tsup && cp src/styles.css dist/styles.css",
52
+ "dev": "tsup --watch",
53
+ "lint": "eslint src/",
54
+ "typecheck": "tsc --noEmit",
55
+ "prepublishOnly": "npm run build"
56
+ },
57
+ "peerDependencies": {
58
+ "react": "^18.0.0 || ^19.0.0",
59
+ "react-dom": "^18.0.0 || ^19.0.0",
60
+ "@tanstack/react-query": "^5.0.0"
61
+ },
62
+ "dependencies": {
63
+ "@compass-labs/api-sdk": "^2.2.2",
64
+ "lucide-react": "^0.469.0",
65
+ "viem": "^2.21.58"
66
+ },
67
+ "devDependencies": {
68
+ "@tanstack/react-query": "^5.66.0",
69
+ "@types/react": "^18.3.18",
70
+ "@types/react-dom": "^18.3.5",
71
+ "react": "^18.3.1",
72
+ "react-dom": "^18.3.1",
73
+ "tsup": "^8.3.5",
74
+ "typescript": "^5.7.3"
75
+ }
76
+ }