@clawnch/clawncher-sdk 0.1.1 → 0.1.3
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.
- package/README.md +77 -29
- package/dist/index.d.ts +9 -33
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -34
- package/dist/index.js.map +1 -1
- package/dist/wayfinder-types.d.ts +324 -0
- package/dist/wayfinder-types.d.ts.map +1 -0
- package/dist/wayfinder-types.js +30 -0
- package/dist/wayfinder-types.js.map +1 -0
- package/dist/wayfinder.d.ts +175 -0
- package/dist/wayfinder.d.ts.map +1 -0
- package/dist/wayfinder.js +638 -0
- package/dist/wayfinder.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,44 +11,26 @@ npm install @clawnch/clawncher-sdk viem
|
|
|
11
11
|
## Quick Start - Token Deployment
|
|
12
12
|
|
|
13
13
|
```typescript
|
|
14
|
-
import {
|
|
14
|
+
import { ClawnchApiDeployer } from '@clawnch/clawncher-sdk';
|
|
15
15
|
import { createWalletClient, createPublicClient, http } from 'viem';
|
|
16
16
|
import { privateKeyToAccount } from 'viem/accounts';
|
|
17
|
-
import {
|
|
17
|
+
import { base } from 'viem/chains';
|
|
18
18
|
|
|
19
19
|
const account = privateKeyToAccount('0x...');
|
|
20
|
-
const wallet = createWalletClient({
|
|
21
|
-
|
|
22
|
-
chain: baseSepolia,
|
|
23
|
-
transport: http(),
|
|
24
|
-
});
|
|
25
|
-
const publicClient = createPublicClient({
|
|
26
|
-
chain: baseSepolia,
|
|
27
|
-
transport: http(),
|
|
28
|
-
});
|
|
20
|
+
const wallet = createWalletClient({ account, chain: base, transport: http() });
|
|
21
|
+
const publicClient = createPublicClient({ chain: base, transport: http() });
|
|
29
22
|
|
|
30
|
-
const deployer = new
|
|
23
|
+
const deployer = new ClawnchApiDeployer({
|
|
24
|
+
apiKey: 'your-api-key',
|
|
31
25
|
wallet,
|
|
32
26
|
publicClient,
|
|
33
|
-
network: 'sepolia', // or 'mainnet'
|
|
34
27
|
});
|
|
35
28
|
|
|
36
29
|
const result = await deployer.deploy({
|
|
37
30
|
name: 'My Token',
|
|
38
31
|
symbol: 'MYTKN',
|
|
39
|
-
tokenAdmin: account.address,
|
|
40
|
-
rewards: {
|
|
41
|
-
recipients: [{
|
|
42
|
-
recipient: account.address,
|
|
43
|
-
admin: account.address,
|
|
44
|
-
bps: 10000, // 100%
|
|
45
|
-
feePreference: 'Paired', // Receive fees in WETH
|
|
46
|
-
}],
|
|
47
|
-
},
|
|
48
32
|
});
|
|
49
|
-
|
|
50
|
-
const { address } = await result.waitForTransaction();
|
|
51
|
-
console.log('Token deployed:', address);
|
|
33
|
+
console.log('Token deployed:', result.tokenAddress);
|
|
52
34
|
```
|
|
53
35
|
|
|
54
36
|
## Deployment Options
|
|
@@ -144,7 +126,7 @@ const result = await deployer.deploy({
|
|
|
144
126
|
|
|
145
127
|
## Vanity Addresses
|
|
146
128
|
|
|
147
|
-
Vanity addresses (0xb07 suffix) are handled by
|
|
129
|
+
Vanity addresses (0xb07 suffix) are handled by the deployment infrastructure. Pass `vanity: true` (default) or `vanity: false` to disable.
|
|
148
130
|
|
|
149
131
|
## Extension Constraints
|
|
150
132
|
|
|
@@ -221,7 +203,7 @@ const result = await deployer.deploy({
|
|
|
221
203
|
...options,
|
|
222
204
|
dryRun: true,
|
|
223
205
|
});
|
|
224
|
-
// result.translatedConfig - the
|
|
206
|
+
// result.translatedConfig - the deployment config (for inspection)
|
|
225
207
|
// result.estimatedGas - estimated gas
|
|
226
208
|
// result.estimatedCostEth - estimated cost in ETH
|
|
227
209
|
```
|
|
@@ -459,7 +441,7 @@ console.log(addresses.clawnch.factory);
|
|
|
459
441
|
console.log(addresses.clawnch.devBuy);
|
|
460
442
|
```
|
|
461
443
|
|
|
462
|
-
### Base Mainnet (v3
|
|
444
|
+
### Base Mainnet (v3)
|
|
463
445
|
|
|
464
446
|
| Contract | Address |
|
|
465
447
|
|----------|---------|
|
|
@@ -470,7 +452,7 @@ console.log(addresses.clawnch.devBuy);
|
|
|
470
452
|
| Vault | `0xcC80d1226F899a78fC2E459a1500A13C373CE0A5` |
|
|
471
453
|
| DevBuy | `0x97fd42fcc8c4E2A5a45d0e28E14EC60FF7c10D9C` |
|
|
472
454
|
|
|
473
|
-
### Base Sepolia (v3
|
|
455
|
+
### Base Sepolia (v3)
|
|
474
456
|
|
|
475
457
|
| Contract | Address |
|
|
476
458
|
|----------|---------|
|
|
@@ -592,10 +574,76 @@ console.log('Token:', result.tokenAddress);
|
|
|
592
574
|
| `getClawnchBalance()` | Check $CLAWNCH balance |
|
|
593
575
|
| `deploy(request)` | Full verified deploy flow |
|
|
594
576
|
|
|
577
|
+
## Wayfinder Integration (Cross-chain DeFi)
|
|
578
|
+
|
|
579
|
+
Access cross-chain swaps, multi-chain balances, and DeFi strategies via Wayfinder Paths.
|
|
580
|
+
|
|
581
|
+
```typescript
|
|
582
|
+
import { WayfinderClient } from '@clawnch/clawncher-sdk';
|
|
583
|
+
|
|
584
|
+
const wf = new WayfinderClient({ apiKey: 'wk_...' });
|
|
585
|
+
|
|
586
|
+
// Tier 1 (REST - no Python required):
|
|
587
|
+
const quote = await wf.quoteSwap({
|
|
588
|
+
fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC Ethereum
|
|
589
|
+
toToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC Base
|
|
590
|
+
fromChain: 1, toChain: 8453,
|
|
591
|
+
fromWallet: '0x...', amount: '5000000',
|
|
592
|
+
});
|
|
593
|
+
console.log(quote.bestQuote?.provider, quote.bestQuote?.outputAmountUsd);
|
|
594
|
+
|
|
595
|
+
const balances = await wf.getBalances('0x...');
|
|
596
|
+
const token = await wf.resolveToken('USDC', 8453);
|
|
597
|
+
|
|
598
|
+
// Tier 2 (requires Python 3.12+ and wayfinder-paths):
|
|
599
|
+
const status = await wf.checkPython();
|
|
600
|
+
if (status.wayfinderInstalled) {
|
|
601
|
+
const result = await wf.executeSwap({
|
|
602
|
+
kind: 'swap', walletLabel: 'main',
|
|
603
|
+
amount: '5', fromToken: 'usd-coin', toToken: 'ethereum',
|
|
604
|
+
});
|
|
605
|
+
await wf.runStrategy({ strategy: 'basis_trading_strategy', action: 'status' });
|
|
606
|
+
}
|
|
607
|
+
```
|
|
608
|
+
|
|
609
|
+
### REST Methods (always available)
|
|
610
|
+
|
|
611
|
+
| Method | Description |
|
|
612
|
+
|--------|-------------|
|
|
613
|
+
| `quoteSwap(params)` | Cross-chain swap quotes via BRAP aggregator |
|
|
614
|
+
| `resolveToken(query, chainId?)` | Token details by name/symbol/address |
|
|
615
|
+
| `searchTokens(query, chain)` | Fuzzy token search |
|
|
616
|
+
| `getGasToken(chain)` | Gas token for a chain |
|
|
617
|
+
| `getBalances(address)` | Multi-chain enriched balances |
|
|
618
|
+
| `getWalletActivity(address)` | Transaction history |
|
|
619
|
+
| `getPools(chainId?, protocol?)` | DeFi pool data |
|
|
620
|
+
| `getHyperliquidFunding(coin)` | Funding rate history |
|
|
621
|
+
| `getHyperliquidCandles(coin, interval)` | OHLCV data |
|
|
622
|
+
| `getHyperLendMarkets()` | HyperLend stable markets |
|
|
623
|
+
|
|
624
|
+
### CLI Bridge Methods (requires Python + wayfinder-paths)
|
|
625
|
+
|
|
626
|
+
| Method | Description |
|
|
627
|
+
|--------|-------------|
|
|
628
|
+
| `checkPython()` | Check Python/wayfinder-paths availability |
|
|
629
|
+
| `executeSwap(params)` | Execute swap with local signing |
|
|
630
|
+
| `runStrategy(params)` | Run strategy action (status/deposit/update/exit) |
|
|
631
|
+
| `listStrategies()` | List available strategies |
|
|
632
|
+
| `getStrategyStatus(name)` | Get strategy status |
|
|
633
|
+
|
|
634
|
+
Supported chains: Ethereum (1), Base (8453), Arbitrum (42161), Polygon (137), BSC (56), Avalanche (43114), HyperEVM (999).
|
|
635
|
+
|
|
636
|
+
## Related Packages
|
|
637
|
+
|
|
638
|
+
- **[@clawnch/clawtomaton](https://www.npmjs.com/package/@clawnch/clawtomaton)** — Autonomous AI agents built on this SDK. Agents generate wallets, burn $CLAWNCH to activate, deploy tokens, and sustain themselves through LP fees.
|
|
639
|
+
- **[clawncher](https://www.npmjs.com/package/clawncher)** — CLI tool for deploying and managing tokens
|
|
640
|
+
- **[clawnch-mcp-server](https://www.npmjs.com/package/clawnch-mcp-server)** — MCP server for Claude, Cursor, OpenCode
|
|
641
|
+
|
|
595
642
|
## Links
|
|
596
643
|
|
|
597
644
|
- **Website:** https://clawn.ch/er
|
|
598
645
|
- **CLI:** `npm install -g clawncher`
|
|
646
|
+
- **Clawtomaton:** `npm install @clawnch/clawtomaton`
|
|
599
647
|
- **Documentation:** https://clawn.ch/er/docs
|
|
600
648
|
|
|
601
649
|
## License
|
package/dist/index.d.ts
CHANGED
|
@@ -1,51 +1,25 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Clawncher SDK
|
|
3
3
|
*
|
|
4
|
-
* TypeScript SDK for deploying tokens on Base with Uniswap V4 pools.
|
|
5
|
-
* Deploys through Clanker's approved infrastructure for immediate tradability.
|
|
4
|
+
* TypeScript SDK for deploying and managing tokens on Base with Uniswap V4 pools.
|
|
6
5
|
*
|
|
7
|
-
* ## Deploying Tokens
|
|
6
|
+
* ## Deploying Tokens (Verified Agent)
|
|
8
7
|
*
|
|
9
8
|
* @example
|
|
10
9
|
* ```typescript
|
|
11
|
-
* import {
|
|
12
|
-
* import { createWalletClient, createPublicClient, http } from 'viem';
|
|
13
|
-
* import { privateKeyToAccount } from 'viem/accounts';
|
|
14
|
-
* import { base } from 'viem/chains';
|
|
10
|
+
* import { ClawnchApiDeployer } from '@clawnch/clawncher-sdk';
|
|
15
11
|
*
|
|
16
|
-
* const
|
|
17
|
-
*
|
|
18
|
-
* account,
|
|
19
|
-
* chain: base,
|
|
20
|
-
* transport: http(),
|
|
21
|
-
* });
|
|
22
|
-
* const publicClient = createPublicClient({
|
|
23
|
-
* chain: base,
|
|
24
|
-
* transport: http(),
|
|
25
|
-
* });
|
|
26
|
-
*
|
|
27
|
-
* const deployer = new ClawnchDeployer({
|
|
12
|
+
* const deployer = new ClawnchApiDeployer({
|
|
13
|
+
* apiKey: 'your-api-key',
|
|
28
14
|
* wallet,
|
|
29
15
|
* publicClient,
|
|
30
|
-
* network: 'mainnet',
|
|
31
16
|
* });
|
|
32
17
|
*
|
|
33
18
|
* const result = await deployer.deploy({
|
|
34
19
|
* name: 'My Token',
|
|
35
20
|
* symbol: 'MYTKN',
|
|
36
|
-
* tokenAdmin: account.address,
|
|
37
|
-
* rewards: {
|
|
38
|
-
* recipients: [{
|
|
39
|
-
* recipient: account.address,
|
|
40
|
-
* admin: account.address,
|
|
41
|
-
* bps: 10000, // 100%
|
|
42
|
-
* feePreference: 'Paired', // Receive fees in WETH
|
|
43
|
-
* }],
|
|
44
|
-
* },
|
|
45
21
|
* });
|
|
46
|
-
*
|
|
47
|
-
* const { address } = await result.waitForTransaction();
|
|
48
|
-
* console.log('Token deployed:', address);
|
|
22
|
+
* console.log('Token deployed:', result.tokenAddress);
|
|
49
23
|
* ```
|
|
50
24
|
*
|
|
51
25
|
* ## API Client (Optional)
|
|
@@ -67,7 +41,7 @@ import type { Token, Launch, LaunchFilters, LaunchesResponse, Stats, PreviewResp
|
|
|
67
41
|
export * from './types.js';
|
|
68
42
|
export * from './molten.js';
|
|
69
43
|
export * from './errors.js';
|
|
70
|
-
export
|
|
44
|
+
export type { FeePreference, RewardRecipient, VaultConfig, AirdropConfig, DevBuyConfig, TokenMetadata, TokenContext, DeployOptions, DeployResult, DryRunResult, DeployerConfig, } from './deployer.js';
|
|
71
45
|
export * from './addresses.js';
|
|
72
46
|
export * from './abis.js';
|
|
73
47
|
export * from './reader.js';
|
|
@@ -82,6 +56,8 @@ export * from './uniswap-addresses.js';
|
|
|
82
56
|
export * from './uniswap-abis.js';
|
|
83
57
|
export * from './api-deployer.js';
|
|
84
58
|
export * from './api-deployer-types.js';
|
|
59
|
+
export * from './wayfinder.js';
|
|
60
|
+
export * from './wayfinder-types.js';
|
|
85
61
|
export interface ClawnchClientOptions {
|
|
86
62
|
/** Base URL for the API (default: https://clawn.ch) */
|
|
87
63
|
baseUrl?: string;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,51 +1,25 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Clawncher SDK
|
|
3
3
|
*
|
|
4
|
-
* TypeScript SDK for deploying tokens on Base with Uniswap V4 pools.
|
|
5
|
-
* Deploys through Clanker's approved infrastructure for immediate tradability.
|
|
4
|
+
* TypeScript SDK for deploying and managing tokens on Base with Uniswap V4 pools.
|
|
6
5
|
*
|
|
7
|
-
* ## Deploying Tokens
|
|
6
|
+
* ## Deploying Tokens (Verified Agent)
|
|
8
7
|
*
|
|
9
8
|
* @example
|
|
10
9
|
* ```typescript
|
|
11
|
-
* import {
|
|
12
|
-
* import { createWalletClient, createPublicClient, http } from 'viem';
|
|
13
|
-
* import { privateKeyToAccount } from 'viem/accounts';
|
|
14
|
-
* import { base } from 'viem/chains';
|
|
10
|
+
* import { ClawnchApiDeployer } from '@clawnch/clawncher-sdk';
|
|
15
11
|
*
|
|
16
|
-
* const
|
|
17
|
-
*
|
|
18
|
-
* account,
|
|
19
|
-
* chain: base,
|
|
20
|
-
* transport: http(),
|
|
21
|
-
* });
|
|
22
|
-
* const publicClient = createPublicClient({
|
|
23
|
-
* chain: base,
|
|
24
|
-
* transport: http(),
|
|
25
|
-
* });
|
|
26
|
-
*
|
|
27
|
-
* const deployer = new ClawnchDeployer({
|
|
12
|
+
* const deployer = new ClawnchApiDeployer({
|
|
13
|
+
* apiKey: 'your-api-key',
|
|
28
14
|
* wallet,
|
|
29
15
|
* publicClient,
|
|
30
|
-
* network: 'mainnet',
|
|
31
16
|
* });
|
|
32
17
|
*
|
|
33
18
|
* const result = await deployer.deploy({
|
|
34
19
|
* name: 'My Token',
|
|
35
20
|
* symbol: 'MYTKN',
|
|
36
|
-
* tokenAdmin: account.address,
|
|
37
|
-
* rewards: {
|
|
38
|
-
* recipients: [{
|
|
39
|
-
* recipient: account.address,
|
|
40
|
-
* admin: account.address,
|
|
41
|
-
* bps: 10000, // 100%
|
|
42
|
-
* feePreference: 'Paired', // Receive fees in WETH
|
|
43
|
-
* }],
|
|
44
|
-
* },
|
|
45
21
|
* });
|
|
46
|
-
*
|
|
47
|
-
* const { address } = await result.waitForTransaction();
|
|
48
|
-
* console.log('Token deployed:', address);
|
|
22
|
+
* console.log('Token deployed:', result.tokenAddress);
|
|
49
23
|
* ```
|
|
50
24
|
*
|
|
51
25
|
* ## API Client (Optional)
|
|
@@ -67,8 +41,6 @@ export * from './types.js';
|
|
|
67
41
|
export * from './molten.js';
|
|
68
42
|
// Structured error codes
|
|
69
43
|
export * from './errors.js';
|
|
70
|
-
// Token deployment (via Clanker infrastructure)
|
|
71
|
-
export * from './deployer.js';
|
|
72
44
|
export * from './addresses.js';
|
|
73
45
|
export * from './abis.js';
|
|
74
46
|
// On-chain reading
|
|
@@ -90,6 +62,9 @@ export * from './uniswap-abis.js';
|
|
|
90
62
|
// Verified agent launches (via Clawnch API)
|
|
91
63
|
export * from './api-deployer.js';
|
|
92
64
|
export * from './api-deployer-types.js';
|
|
65
|
+
// Wayfinder Paths integration (cross-chain DeFi)
|
|
66
|
+
export * from './wayfinder.js';
|
|
67
|
+
export * from './wayfinder-types.js';
|
|
93
68
|
// Simple validation helpers
|
|
94
69
|
const isValidAddress = (addr) => /^0x[a-fA-F0-9]{40}$/.test(addr);
|
|
95
70
|
const isValidUrl = (url) => {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,324 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wayfinder Paths SDK Types
|
|
3
|
+
*
|
|
4
|
+
* Types for cross-chain swaps, token resolution, multi-chain balances,
|
|
5
|
+
* and strategy execution via the Wayfinder Paths integration.
|
|
6
|
+
*/
|
|
7
|
+
export interface WayfinderConfig {
|
|
8
|
+
/** Wayfinder API key (X-API-KEY header) */
|
|
9
|
+
apiKey: string;
|
|
10
|
+
/** Wayfinder API base URL (default: https://strategies.wayfinder.ai/api/v1) */
|
|
11
|
+
apiUrl?: string;
|
|
12
|
+
/** Request timeout in milliseconds (default: 30000) */
|
|
13
|
+
timeout?: number;
|
|
14
|
+
/** Path to python3 binary (default: auto-detect) */
|
|
15
|
+
pythonPath?: string;
|
|
16
|
+
}
|
|
17
|
+
export interface PythonStatus {
|
|
18
|
+
/** Whether python3 is available on PATH */
|
|
19
|
+
available: boolean;
|
|
20
|
+
/** Python version string (e.g. "3.12.4") */
|
|
21
|
+
version?: string;
|
|
22
|
+
/** Whether wayfinder-paths pip package is installed */
|
|
23
|
+
wayfinderInstalled: boolean;
|
|
24
|
+
/** wayfinder-paths version if installed */
|
|
25
|
+
wayfinderVersion?: string;
|
|
26
|
+
/** Path to the python3 binary */
|
|
27
|
+
pythonPath?: string;
|
|
28
|
+
/** Path to the wayfinder CLI binary */
|
|
29
|
+
wayfinderCliPath?: string;
|
|
30
|
+
}
|
|
31
|
+
export interface WayfinderTokenDetail {
|
|
32
|
+
/** Token name */
|
|
33
|
+
name: string;
|
|
34
|
+
/** Token symbol */
|
|
35
|
+
symbol: string;
|
|
36
|
+
/** Contract address */
|
|
37
|
+
address: string;
|
|
38
|
+
/** Chain ID */
|
|
39
|
+
chainId: number;
|
|
40
|
+
/** Decimal places */
|
|
41
|
+
decimals: number;
|
|
42
|
+
/** CoinGecko ID (e.g. "usd-coin") */
|
|
43
|
+
coingeckoId?: string;
|
|
44
|
+
/** Logo URL */
|
|
45
|
+
logoUrl?: string;
|
|
46
|
+
/** Current price in USD */
|
|
47
|
+
priceUsd?: number;
|
|
48
|
+
/** 24h price change percentage */
|
|
49
|
+
priceChange24h?: number;
|
|
50
|
+
/** Market cap in USD */
|
|
51
|
+
marketCapUsd?: number;
|
|
52
|
+
}
|
|
53
|
+
export interface WayfinderTokenSearchResult {
|
|
54
|
+
/** Token ID used in Wayfinder (e.g. "usd-coin-base") */
|
|
55
|
+
tokenId: string;
|
|
56
|
+
/** Token name */
|
|
57
|
+
name: string;
|
|
58
|
+
/** Token symbol */
|
|
59
|
+
symbol: string;
|
|
60
|
+
/** Contract address */
|
|
61
|
+
address: string;
|
|
62
|
+
/** Chain code (e.g. "base", "ethereum") */
|
|
63
|
+
chain: string;
|
|
64
|
+
/** Chain ID */
|
|
65
|
+
chainId: number;
|
|
66
|
+
/** Relevance score */
|
|
67
|
+
score?: number;
|
|
68
|
+
}
|
|
69
|
+
export interface WayfinderQuoteParams {
|
|
70
|
+
/** Source token (contract address or token ID like "usd-coin") */
|
|
71
|
+
fromToken: string;
|
|
72
|
+
/** Destination token (contract address or token ID) */
|
|
73
|
+
toToken: string;
|
|
74
|
+
/** Source chain ID */
|
|
75
|
+
fromChain: number;
|
|
76
|
+
/** Destination chain ID */
|
|
77
|
+
toChain: number;
|
|
78
|
+
/** Sender wallet address */
|
|
79
|
+
fromWallet: string;
|
|
80
|
+
/** Amount in WEI / raw token units */
|
|
81
|
+
amount: string;
|
|
82
|
+
/** Slippage tolerance (e.g. 0.005 for 0.5%) */
|
|
83
|
+
slippage?: number;
|
|
84
|
+
}
|
|
85
|
+
export interface WayfinderFeeBreakdownItem {
|
|
86
|
+
name: string;
|
|
87
|
+
amount: string;
|
|
88
|
+
amountUsd: number;
|
|
89
|
+
token: string;
|
|
90
|
+
tokenChain: string;
|
|
91
|
+
}
|
|
92
|
+
export interface WayfinderFeeEstimate {
|
|
93
|
+
feeTotalUsd: number;
|
|
94
|
+
feeBreakdown: WayfinderFeeBreakdownItem[];
|
|
95
|
+
}
|
|
96
|
+
export interface WayfinderQuoteEntry {
|
|
97
|
+
/** Aggregator provider (e.g. "lifi", "squid") */
|
|
98
|
+
provider: string;
|
|
99
|
+
/** Output amount in raw units */
|
|
100
|
+
outputAmount: string;
|
|
101
|
+
/** Input amount in raw units */
|
|
102
|
+
inputAmount: string;
|
|
103
|
+
/** Gas estimate */
|
|
104
|
+
gasEstimate: number | null;
|
|
105
|
+
/** Error message if this provider failed */
|
|
106
|
+
error: string | null;
|
|
107
|
+
/** Input value in USD */
|
|
108
|
+
inputAmountUsd: number;
|
|
109
|
+
/** Output value in USD */
|
|
110
|
+
outputAmountUsd: number;
|
|
111
|
+
/** Fee breakdown */
|
|
112
|
+
feeEstimate: WayfinderFeeEstimate;
|
|
113
|
+
/** Transaction calldata (to, data, value, chainId) */
|
|
114
|
+
calldata: WayfinderCalldata | null;
|
|
115
|
+
/** Whether a wrap transaction is needed (native -> WETH) */
|
|
116
|
+
wrapTransaction: Record<string, unknown> | null;
|
|
117
|
+
/** Whether an unwrap transaction is needed (WETH -> native) */
|
|
118
|
+
unwrapTransaction: Record<string, unknown> | null;
|
|
119
|
+
/** Whether input is native token */
|
|
120
|
+
nativeInput: boolean;
|
|
121
|
+
/** Whether output is native token */
|
|
122
|
+
nativeOutput: boolean;
|
|
123
|
+
}
|
|
124
|
+
export interface WayfinderCalldata {
|
|
125
|
+
to: string;
|
|
126
|
+
data: string;
|
|
127
|
+
value: string;
|
|
128
|
+
chainId: number;
|
|
129
|
+
}
|
|
130
|
+
export interface WayfinderQuoteResponse {
|
|
131
|
+
/** All quote entries from different providers */
|
|
132
|
+
quotes: WayfinderQuoteEntry[];
|
|
133
|
+
/** Best quote selected by the aggregator */
|
|
134
|
+
bestQuote: WayfinderQuoteEntry | null;
|
|
135
|
+
/** Number of providers queried */
|
|
136
|
+
quoteCount: number;
|
|
137
|
+
}
|
|
138
|
+
export interface WayfinderTokenBalance {
|
|
139
|
+
/** Token name */
|
|
140
|
+
name: string;
|
|
141
|
+
/** Token symbol */
|
|
142
|
+
symbol: string;
|
|
143
|
+
/** Contract address */
|
|
144
|
+
address: string;
|
|
145
|
+
/** Chain ID */
|
|
146
|
+
chainId: number;
|
|
147
|
+
/** Chain name (e.g. "Base", "Ethereum") */
|
|
148
|
+
chainName: string;
|
|
149
|
+
/** Balance in raw units */
|
|
150
|
+
balance: string;
|
|
151
|
+
/** Balance formatted with decimals */
|
|
152
|
+
balanceFormatted: string;
|
|
153
|
+
/** Balance value in USD */
|
|
154
|
+
balanceUsd: number;
|
|
155
|
+
/** Token decimals */
|
|
156
|
+
decimals: number;
|
|
157
|
+
/** Logo URL */
|
|
158
|
+
logoUrl?: string;
|
|
159
|
+
/** Whether this is a spam token */
|
|
160
|
+
isSpam?: boolean;
|
|
161
|
+
}
|
|
162
|
+
export interface WayfinderBalancesResponse {
|
|
163
|
+
/** Wallet address */
|
|
164
|
+
address: string;
|
|
165
|
+
/** Total portfolio value in USD */
|
|
166
|
+
totalValueUsd: number;
|
|
167
|
+
/** Token balances across all chains */
|
|
168
|
+
tokens: WayfinderTokenBalance[];
|
|
169
|
+
}
|
|
170
|
+
export interface WayfinderActivityEntry {
|
|
171
|
+
/** Transaction hash */
|
|
172
|
+
txHash: string;
|
|
173
|
+
/** Chain ID */
|
|
174
|
+
chainId: number;
|
|
175
|
+
/** Block number */
|
|
176
|
+
blockNumber: number;
|
|
177
|
+
/** Timestamp (ISO string) */
|
|
178
|
+
timestamp: string;
|
|
179
|
+
/** Transaction type (e.g. "swap", "transfer", "approve") */
|
|
180
|
+
type: string;
|
|
181
|
+
/** From address */
|
|
182
|
+
from: string;
|
|
183
|
+
/** To address */
|
|
184
|
+
to: string;
|
|
185
|
+
/** Human-readable summary */
|
|
186
|
+
summary: string;
|
|
187
|
+
/** Value in USD */
|
|
188
|
+
valueUsd?: number;
|
|
189
|
+
}
|
|
190
|
+
export interface WayfinderActivityResponse {
|
|
191
|
+
address: string;
|
|
192
|
+
activities: WayfinderActivityEntry[];
|
|
193
|
+
total: number;
|
|
194
|
+
}
|
|
195
|
+
export interface WayfinderPool {
|
|
196
|
+
/** Pool ID */
|
|
197
|
+
id: string;
|
|
198
|
+
/** Protocol (e.g. "moonwell", "aave", "morpho") */
|
|
199
|
+
protocol: string;
|
|
200
|
+
/** Chain ID */
|
|
201
|
+
chainId: number;
|
|
202
|
+
/** Pool address */
|
|
203
|
+
address: string;
|
|
204
|
+
/** Underlying token symbol */
|
|
205
|
+
tokenSymbol: string;
|
|
206
|
+
/** Underlying token address */
|
|
207
|
+
tokenAddress: string;
|
|
208
|
+
/** Supply APY */
|
|
209
|
+
supplyApy: number;
|
|
210
|
+
/** Borrow APY */
|
|
211
|
+
borrowApy: number;
|
|
212
|
+
/** Total supplied in USD */
|
|
213
|
+
totalSupplyUsd: number;
|
|
214
|
+
/** Total borrowed in USD */
|
|
215
|
+
totalBorrowedUsd: number;
|
|
216
|
+
/** Available liquidity in USD */
|
|
217
|
+
availableLiquidityUsd: number;
|
|
218
|
+
}
|
|
219
|
+
export interface WayfinderFundingEntry {
|
|
220
|
+
coin: string;
|
|
221
|
+
fundingRate: number;
|
|
222
|
+
timestamp: string;
|
|
223
|
+
}
|
|
224
|
+
export interface WayfinderCandle {
|
|
225
|
+
open: number;
|
|
226
|
+
high: number;
|
|
227
|
+
low: number;
|
|
228
|
+
close: number;
|
|
229
|
+
volume: number;
|
|
230
|
+
timestamp: string;
|
|
231
|
+
}
|
|
232
|
+
export interface WayfinderHyperLendMarket {
|
|
233
|
+
token: string;
|
|
234
|
+
tokenAddress: string;
|
|
235
|
+
supplyApy: number;
|
|
236
|
+
borrowApy: number;
|
|
237
|
+
totalSupply: string;
|
|
238
|
+
totalBorrow: string;
|
|
239
|
+
availableLiquidity: string;
|
|
240
|
+
ltv: number;
|
|
241
|
+
}
|
|
242
|
+
export interface WayfinderStrategyInfo {
|
|
243
|
+
name: string;
|
|
244
|
+
description: string;
|
|
245
|
+
chains: number[];
|
|
246
|
+
riskLevel: string;
|
|
247
|
+
adapters: string[];
|
|
248
|
+
}
|
|
249
|
+
export interface WayfinderStrategyStatus {
|
|
250
|
+
portfolioValue: number;
|
|
251
|
+
netDeposit: number;
|
|
252
|
+
strategyStatus: unknown;
|
|
253
|
+
gasAvailable: number;
|
|
254
|
+
gassedUp: boolean;
|
|
255
|
+
}
|
|
256
|
+
export type WayfinderStrategyAction = 'status' | 'deposit' | 'update' | 'exit' | 'withdraw' | 'analyze' | 'quote';
|
|
257
|
+
export interface WayfinderStrategyParams {
|
|
258
|
+
/** Strategy name (e.g. "basis_trading_strategy") */
|
|
259
|
+
strategy: string;
|
|
260
|
+
/** Action to perform */
|
|
261
|
+
action: WayfinderStrategyAction;
|
|
262
|
+
/** Main token amount for deposit */
|
|
263
|
+
mainTokenAmount?: number;
|
|
264
|
+
/** Gas token amount for deposit */
|
|
265
|
+
gasTokenAmount?: number;
|
|
266
|
+
/** Wallet label override */
|
|
267
|
+
walletLabel?: string;
|
|
268
|
+
/** Run on Gorlami fork (dry-run mode) */
|
|
269
|
+
dryRun?: boolean;
|
|
270
|
+
/** Additional config overrides as JSON string */
|
|
271
|
+
config?: string;
|
|
272
|
+
}
|
|
273
|
+
export interface WayfinderStrategyResult {
|
|
274
|
+
success: boolean;
|
|
275
|
+
action: string;
|
|
276
|
+
output: unknown;
|
|
277
|
+
error?: string;
|
|
278
|
+
}
|
|
279
|
+
export type WayfinderExecuteKind = 'swap' | 'send' | 'hyperliquid_deposit';
|
|
280
|
+
export interface WayfinderExecuteParams {
|
|
281
|
+
/** Operation kind */
|
|
282
|
+
kind: WayfinderExecuteKind;
|
|
283
|
+
/** Wallet label (must match a wallet in wayfinder config.json) */
|
|
284
|
+
walletLabel: string;
|
|
285
|
+
/** Amount in human-readable format */
|
|
286
|
+
amount: string;
|
|
287
|
+
/** Recipient address (for send) */
|
|
288
|
+
recipient?: string;
|
|
289
|
+
/** Source token ID (for swap) */
|
|
290
|
+
fromToken?: string;
|
|
291
|
+
/** Destination token ID (for swap) */
|
|
292
|
+
toToken?: string;
|
|
293
|
+
/** Slippage in bps (default: 50 = 0.5%) */
|
|
294
|
+
slippageBps?: number;
|
|
295
|
+
/** Deadline in seconds (default: 300) */
|
|
296
|
+
deadlineSeconds?: number;
|
|
297
|
+
/** Token to send (for send kind) */
|
|
298
|
+
token?: string;
|
|
299
|
+
/** Chain ID override */
|
|
300
|
+
chainId?: number;
|
|
301
|
+
}
|
|
302
|
+
export interface WayfinderExecuteEffect {
|
|
303
|
+
txnHash: string;
|
|
304
|
+
chainId: number;
|
|
305
|
+
explorerUrl: string;
|
|
306
|
+
}
|
|
307
|
+
export interface WayfinderExecuteResult {
|
|
308
|
+
ok: boolean;
|
|
309
|
+
result?: {
|
|
310
|
+
kind: string;
|
|
311
|
+
sender: string;
|
|
312
|
+
recipient: string;
|
|
313
|
+
preview: string;
|
|
314
|
+
status: string;
|
|
315
|
+
effects: Record<string, WayfinderExecuteEffect>;
|
|
316
|
+
raw?: unknown;
|
|
317
|
+
};
|
|
318
|
+
error?: string;
|
|
319
|
+
}
|
|
320
|
+
/** Chains supported by the Wayfinder BRAP aggregator */
|
|
321
|
+
export declare const WAYFINDER_CHAINS: Record<string, number>;
|
|
322
|
+
/** Reverse lookup: chain ID to name */
|
|
323
|
+
export declare const WAYFINDER_CHAIN_NAMES: Record<number, string>;
|
|
324
|
+
//# sourceMappingURL=wayfinder-types.d.ts.map
|