nirium 0.2.1
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 +83 -0
- package/dist/index.d.ts +237 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +234 -0
- package/dist/index.js.map +1 -0
- package/package.json +33 -0
package/README.md
ADDED
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# nirium
|
|
2
|
+
|
|
3
|
+
Official TypeScript SDK for the **Nirium Protocol** — autonomous DeFi agent on Stellar/Soroban.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install nirium
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Quick Start
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Agent } from 'nirium';
|
|
15
|
+
|
|
16
|
+
const agent = new Agent({
|
|
17
|
+
apiKey: 'sk_inst_your_key_here',
|
|
18
|
+
baseUrl: 'https://api.nirium.xyz',
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
// Health check
|
|
22
|
+
const alive = await agent.ping();
|
|
23
|
+
console.log('Agent alive:', alive);
|
|
24
|
+
|
|
25
|
+
// Real market data from Stellar Horizon
|
|
26
|
+
const market = await agent.getMarket();
|
|
27
|
+
console.log('XLM Price:', market.xlmPrice);
|
|
28
|
+
|
|
29
|
+
// Execute a strategy
|
|
30
|
+
const result = await agent.execute('flash-loan-arb', 'XLM-USDC', { amount: 5000 });
|
|
31
|
+
console.log('Profit:', result.profit);
|
|
32
|
+
|
|
33
|
+
// Real-time signals via WebSocket
|
|
34
|
+
agent.subscribe((signal) => {
|
|
35
|
+
console.log('Signal:', signal.signal_type, signal.data.details);
|
|
36
|
+
});
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## API Coverage
|
|
40
|
+
|
|
41
|
+
| Category | Methods |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Health | `ping()`, `health()`, `systemHealth()` |
|
|
44
|
+
| Execution | `execute()`, `executeDemo()` |
|
|
45
|
+
| Market | `getMarket()`, `getLoopStatus()`, `startLoop()`, `stopLoop()`, `triggerScan()` |
|
|
46
|
+
| Signals | `createSubscription()`, `getRecentSignals()` |
|
|
47
|
+
| Skills | `getSkills()`, `installSkill()`, `uninstallSkill()` |
|
|
48
|
+
| Webhooks | `registerWebhook()`, `getWebhooks()`, `deleteWebhook()`, `testWebhook()` |
|
|
49
|
+
| WebSocket | `subscribe()`, `onLog()`, `disconnect()` |
|
|
50
|
+
|
|
51
|
+
## Authentication
|
|
52
|
+
|
|
53
|
+
```typescript
|
|
54
|
+
// API Key for REST endpoints
|
|
55
|
+
const agent = new Agent({
|
|
56
|
+
apiKey: 'sk_inst_...',
|
|
57
|
+
baseUrl: 'https://api.nirium.xyz',
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
// With JWT token for WebSocket (optional)
|
|
61
|
+
const agent = new Agent({
|
|
62
|
+
apiKey: 'sk_inst_...',
|
|
63
|
+
baseUrl: 'https://api.nirium.xyz',
|
|
64
|
+
token: 'eyJhbG...', // JWT from /api/auth/token
|
|
65
|
+
});
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Endpoint Access Model
|
|
69
|
+
|
|
70
|
+
| Access | Endpoints |
|
|
71
|
+
|---|---|
|
|
72
|
+
| **Public** (no key) | `health`, `loop/status`, `execute-demo`, `signals/recent`, `skills` list |
|
|
73
|
+
| **Protected** (API key) | `execute`, `market`, `loop/start\|stop\|scan`, `subscriptions`, `skills/install`, `webhooks` |
|
|
74
|
+
| **WebSocket** (JWT) | `/ws/signals` — real-time signal stream |
|
|
75
|
+
|
|
76
|
+
## Requirements
|
|
77
|
+
|
|
78
|
+
- Node.js >= 18
|
|
79
|
+
- TypeScript >= 5.0
|
|
80
|
+
|
|
81
|
+
## License
|
|
82
|
+
|
|
83
|
+
MIT — Nirium Protocol
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
export interface AgentConfig {
|
|
2
|
+
apiKey: string;
|
|
3
|
+
baseUrl?: string;
|
|
4
|
+
wsUrl?: string;
|
|
5
|
+
/** JWT token for WebSocket auth (obtained from /api/auth/token) */
|
|
6
|
+
token?: string;
|
|
7
|
+
}
|
|
8
|
+
export interface Signal {
|
|
9
|
+
id: string;
|
|
10
|
+
signal_type: string;
|
|
11
|
+
pair: string;
|
|
12
|
+
data: {
|
|
13
|
+
expectedProfit: number;
|
|
14
|
+
profitPercentage: number;
|
|
15
|
+
urgency: string;
|
|
16
|
+
confidence: number;
|
|
17
|
+
timeToLive: number;
|
|
18
|
+
details: string;
|
|
19
|
+
};
|
|
20
|
+
timestamp: string;
|
|
21
|
+
expiresAt: string;
|
|
22
|
+
}
|
|
23
|
+
export interface ExecutionResult {
|
|
24
|
+
success: boolean;
|
|
25
|
+
txHash?: string;
|
|
26
|
+
profit?: number;
|
|
27
|
+
gasUsed?: number;
|
|
28
|
+
error?: string;
|
|
29
|
+
timestamp: string;
|
|
30
|
+
network: string;
|
|
31
|
+
details?: Record<string, unknown>;
|
|
32
|
+
}
|
|
33
|
+
export interface PathPaymentRoute {
|
|
34
|
+
source: string;
|
|
35
|
+
destination: string;
|
|
36
|
+
path: string[];
|
|
37
|
+
sourceAmount: number;
|
|
38
|
+
destinationAmount: number;
|
|
39
|
+
profitPercentage: number;
|
|
40
|
+
}
|
|
41
|
+
export interface MarketState {
|
|
42
|
+
xlmPrice: number;
|
|
43
|
+
/** Stellar base fee in stroops */
|
|
44
|
+
baseFee: number;
|
|
45
|
+
/** Best bid/ask spread on the native SDEX in basis points */
|
|
46
|
+
sdexSpread: number;
|
|
47
|
+
/** Soroswap AMM pool depth (XLM/USDC) */
|
|
48
|
+
soroswapPoolDepth: number;
|
|
49
|
+
blendApy: {
|
|
50
|
+
supply: number;
|
|
51
|
+
borrow: number;
|
|
52
|
+
};
|
|
53
|
+
/** Discovered profitable multi-hop paths from Horizon */
|
|
54
|
+
pathPaymentRoutes: PathPaymentRoute[];
|
|
55
|
+
/** ISO timestamp of when market data was fetched */
|
|
56
|
+
timestamp: string;
|
|
57
|
+
}
|
|
58
|
+
export interface LoopStatus {
|
|
59
|
+
isRunning: boolean;
|
|
60
|
+
scanCount: number;
|
|
61
|
+
uptime: number;
|
|
62
|
+
marketState: MarketState | null;
|
|
63
|
+
config: Record<string, unknown>;
|
|
64
|
+
lastAiDecision: Record<string, unknown> | null;
|
|
65
|
+
}
|
|
66
|
+
export interface SystemHealth {
|
|
67
|
+
agent: {
|
|
68
|
+
healthy: boolean;
|
|
69
|
+
uptime: number;
|
|
70
|
+
};
|
|
71
|
+
horizon: {
|
|
72
|
+
healthy: boolean;
|
|
73
|
+
latencyMs?: number;
|
|
74
|
+
error?: string;
|
|
75
|
+
};
|
|
76
|
+
soroban: {
|
|
77
|
+
healthy: boolean;
|
|
78
|
+
latencyMs?: number;
|
|
79
|
+
error?: string;
|
|
80
|
+
};
|
|
81
|
+
websocket: {
|
|
82
|
+
healthy: boolean;
|
|
83
|
+
clients: number;
|
|
84
|
+
};
|
|
85
|
+
ipfs: {
|
|
86
|
+
gateway: string;
|
|
87
|
+
};
|
|
88
|
+
llm: {
|
|
89
|
+
provider: string;
|
|
90
|
+
model: string;
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
export interface Webhook {
|
|
94
|
+
id: string;
|
|
95
|
+
url: string;
|
|
96
|
+
events: string[];
|
|
97
|
+
active: boolean;
|
|
98
|
+
createdAt: string;
|
|
99
|
+
lastTriggeredAt?: string;
|
|
100
|
+
failureCount: number;
|
|
101
|
+
}
|
|
102
|
+
export interface Skill {
|
|
103
|
+
slug: string;
|
|
104
|
+
name: string;
|
|
105
|
+
version: string;
|
|
106
|
+
description?: string;
|
|
107
|
+
isBuiltIn: boolean;
|
|
108
|
+
installedAt?: string;
|
|
109
|
+
}
|
|
110
|
+
export interface SubscriptionOptions {
|
|
111
|
+
signal_types?: string[];
|
|
112
|
+
min_confidence?: number;
|
|
113
|
+
min_profit_percentage?: number;
|
|
114
|
+
pairs?: string[];
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* NiriumClient — Full API + WebSocket wrapper for the Nirium Agent.
|
|
118
|
+
*
|
|
119
|
+
* @example
|
|
120
|
+
* ```typescript
|
|
121
|
+
* import { Agent } from '@nirium/sdk';
|
|
122
|
+
*
|
|
123
|
+
* const agent = new Agent({
|
|
124
|
+
* apiKey: 'nrm_your_key_here',
|
|
125
|
+
* baseUrl: 'http://localhost:3001',
|
|
126
|
+
* });
|
|
127
|
+
*
|
|
128
|
+
* // Check health
|
|
129
|
+
* const healthy = await agent.ping();
|
|
130
|
+
* console.log('Agent alive:', healthy);
|
|
131
|
+
*
|
|
132
|
+
* // Get market data (REAL data from Horizon)
|
|
133
|
+
* const market = await agent.getMarket();
|
|
134
|
+
* console.log('XLM Price:', market.xlmPrice);
|
|
135
|
+
*
|
|
136
|
+
* // Execute a strategy
|
|
137
|
+
* const result = await agent.execute('flash-loan-arb', 'XLM-USDC', { amount: 5000 });
|
|
138
|
+
* console.log('Profit:', result.profit);
|
|
139
|
+
*
|
|
140
|
+
* // Subscribe to real-time signals
|
|
141
|
+
* agent.subscribe((signal) => {
|
|
142
|
+
* console.log('Signal:', signal.signal_type, signal.data.details);
|
|
143
|
+
* });
|
|
144
|
+
* ```
|
|
145
|
+
*/
|
|
146
|
+
export declare class Agent {
|
|
147
|
+
private apiKey;
|
|
148
|
+
private baseUrl;
|
|
149
|
+
private wsUrl;
|
|
150
|
+
private ws;
|
|
151
|
+
private reconnectAttempts;
|
|
152
|
+
private maxReconnectAttempts;
|
|
153
|
+
private signalCallbacks;
|
|
154
|
+
private logCallbacks;
|
|
155
|
+
private token;
|
|
156
|
+
constructor(config: AgentConfig);
|
|
157
|
+
private request;
|
|
158
|
+
/** Health check — returns true if agent is reachable. */
|
|
159
|
+
ping(): Promise<boolean>;
|
|
160
|
+
/** Detailed health information. */
|
|
161
|
+
health(): Promise<Record<string, unknown>>;
|
|
162
|
+
/** Detailed system health (Horizon, Soroban, WebSocket, IPFS, LLM). */
|
|
163
|
+
systemHealth(): Promise<SystemHealth>;
|
|
164
|
+
/**
|
|
165
|
+
* Execute a strategy (routed to actual Soroban contract).
|
|
166
|
+
* Strategy names: flash-loan-arb, path-arbitrage, cross-dex, blend-yield, soroswap-swap
|
|
167
|
+
*/
|
|
168
|
+
execute(strategy: string, asset: string, params?: Record<string, unknown>): Promise<ExecutionResult>;
|
|
169
|
+
/**
|
|
170
|
+
* Demo execution (Soroban dry-run simulation, no TX submitted).
|
|
171
|
+
*/
|
|
172
|
+
executeDemo(strategy: string, asset: string): Promise<ExecutionResult>;
|
|
173
|
+
/** Get current market state (real data from Horizon). */
|
|
174
|
+
getMarket(): Promise<MarketState>;
|
|
175
|
+
/** Get autonomous loop status. */
|
|
176
|
+
getLoopStatus(): Promise<LoopStatus>;
|
|
177
|
+
/** Start the autonomous scanning loop. */
|
|
178
|
+
startLoop(config?: Record<string, unknown>): Promise<{
|
|
179
|
+
success: boolean;
|
|
180
|
+
message: string;
|
|
181
|
+
}>;
|
|
182
|
+
/** Stop the autonomous scanning loop. */
|
|
183
|
+
stopLoop(): Promise<{
|
|
184
|
+
success: boolean;
|
|
185
|
+
message: string;
|
|
186
|
+
}>;
|
|
187
|
+
/** Trigger a manual market scan. */
|
|
188
|
+
triggerScan(): Promise<{
|
|
189
|
+
success: boolean;
|
|
190
|
+
marketState: MarketState;
|
|
191
|
+
}>;
|
|
192
|
+
/** Create a signal subscription with filters. */
|
|
193
|
+
createSubscription(options?: SubscriptionOptions): Promise<Record<string, unknown>>;
|
|
194
|
+
/** Get recent signals. */
|
|
195
|
+
getRecentSignals(count?: number): Promise<{
|
|
196
|
+
signals: Signal[];
|
|
197
|
+
}>;
|
|
198
|
+
/** List all loaded skills (built-in + user-installed). */
|
|
199
|
+
getSkills(): Promise<{
|
|
200
|
+
skills: Skill[];
|
|
201
|
+
total: number;
|
|
202
|
+
}>;
|
|
203
|
+
/** Install a skill by slug. */
|
|
204
|
+
installSkill(source: string): Promise<Skill>;
|
|
205
|
+
/** Uninstall a user-installed skill by slug. */
|
|
206
|
+
uninstallSkill(slug: string): Promise<{
|
|
207
|
+
success: boolean;
|
|
208
|
+
}>;
|
|
209
|
+
/** Register a webhook endpoint. */
|
|
210
|
+
registerWebhook(url: string, events: string[], secret?: string): Promise<Webhook>;
|
|
211
|
+
/** List all registered webhooks. */
|
|
212
|
+
getWebhooks(): Promise<Webhook[]>;
|
|
213
|
+
/** Delete a webhook by ID. */
|
|
214
|
+
deleteWebhook(id: string): Promise<{
|
|
215
|
+
success: boolean;
|
|
216
|
+
}>;
|
|
217
|
+
/** Test a webhook (sends a test event). */
|
|
218
|
+
testWebhook(id: string): Promise<{
|
|
219
|
+
success: boolean;
|
|
220
|
+
message: string;
|
|
221
|
+
}>;
|
|
222
|
+
/**
|
|
223
|
+
* Subscribe to real-time signals via WebSocket.
|
|
224
|
+
* Optionally filter by subscription ID.
|
|
225
|
+
*/
|
|
226
|
+
subscribe(callback: (signal: Signal) => void, subscriptionId?: string): void;
|
|
227
|
+
/**
|
|
228
|
+
* Subscribe to real-time log messages.
|
|
229
|
+
*/
|
|
230
|
+
onLog(callback: (log: Record<string, unknown>) => void): void;
|
|
231
|
+
private connectWebSocket;
|
|
232
|
+
private attemptReconnect;
|
|
233
|
+
/** Close the WebSocket connection. */
|
|
234
|
+
disconnect(): void;
|
|
235
|
+
}
|
|
236
|
+
export default Agent;
|
|
237
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,234 @@
|
|
|
1
|
+
// ═══════════════════════════════════════════════════════════════
|
|
2
|
+
// @nirium/sdk v0.2.0 — Official TypeScript SDK (Synced with Backend)
|
|
3
|
+
// ═══════════════════════════════════════════════════════════════
|
|
4
|
+
import WebSocket from 'ws';
|
|
5
|
+
/**
|
|
6
|
+
* NiriumClient — Full API + WebSocket wrapper for the Nirium Agent.
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* ```typescript
|
|
10
|
+
* import { Agent } from '@nirium/sdk';
|
|
11
|
+
*
|
|
12
|
+
* const agent = new Agent({
|
|
13
|
+
* apiKey: 'nrm_your_key_here',
|
|
14
|
+
* baseUrl: 'http://localhost:3001',
|
|
15
|
+
* });
|
|
16
|
+
*
|
|
17
|
+
* // Check health
|
|
18
|
+
* const healthy = await agent.ping();
|
|
19
|
+
* console.log('Agent alive:', healthy);
|
|
20
|
+
*
|
|
21
|
+
* // Get market data (REAL data from Horizon)
|
|
22
|
+
* const market = await agent.getMarket();
|
|
23
|
+
* console.log('XLM Price:', market.xlmPrice);
|
|
24
|
+
*
|
|
25
|
+
* // Execute a strategy
|
|
26
|
+
* const result = await agent.execute('flash-loan-arb', 'XLM-USDC', { amount: 5000 });
|
|
27
|
+
* console.log('Profit:', result.profit);
|
|
28
|
+
*
|
|
29
|
+
* // Subscribe to real-time signals
|
|
30
|
+
* agent.subscribe((signal) => {
|
|
31
|
+
* console.log('Signal:', signal.signal_type, signal.data.details);
|
|
32
|
+
* });
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
export class Agent {
|
|
36
|
+
apiKey;
|
|
37
|
+
baseUrl;
|
|
38
|
+
wsUrl;
|
|
39
|
+
ws = null;
|
|
40
|
+
reconnectAttempts = 0;
|
|
41
|
+
maxReconnectAttempts = 5;
|
|
42
|
+
signalCallbacks = [];
|
|
43
|
+
logCallbacks = [];
|
|
44
|
+
token = null;
|
|
45
|
+
constructor(config) {
|
|
46
|
+
this.apiKey = config.apiKey;
|
|
47
|
+
this.baseUrl = (config.baseUrl || 'http://localhost:3001').replace(/\/$/, '');
|
|
48
|
+
this.wsUrl = config.wsUrl || this.baseUrl.replace(/^http/, 'ws') + '/ws/signals';
|
|
49
|
+
this.token = config.token || null;
|
|
50
|
+
}
|
|
51
|
+
// ─── HTTP Methods ────────────────────────────────────────
|
|
52
|
+
async request(method, path, body) {
|
|
53
|
+
const url = `${this.baseUrl}${path}`;
|
|
54
|
+
const headers = {
|
|
55
|
+
'Content-Type': 'application/json',
|
|
56
|
+
'x-api-key': this.apiKey,
|
|
57
|
+
};
|
|
58
|
+
const options = { method, headers };
|
|
59
|
+
if (body) {
|
|
60
|
+
options.body = JSON.stringify(body);
|
|
61
|
+
}
|
|
62
|
+
const response = await fetch(url, options);
|
|
63
|
+
if (!response.ok) {
|
|
64
|
+
const error = await response.json().catch(() => ({ error: response.statusText }));
|
|
65
|
+
throw new Error(`Nirium API Error [${response.status}]: ${JSON.stringify(error)}`);
|
|
66
|
+
}
|
|
67
|
+
return response.json();
|
|
68
|
+
}
|
|
69
|
+
// ─── Health ──────────────────────────────────────────────
|
|
70
|
+
/** Health check — returns true if agent is reachable. */
|
|
71
|
+
async ping() {
|
|
72
|
+
try {
|
|
73
|
+
const data = await this.request('GET', '/health');
|
|
74
|
+
return data.status === 'operational';
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
return false;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
/** Detailed health information. */
|
|
81
|
+
async health() {
|
|
82
|
+
return this.request('GET', '/health');
|
|
83
|
+
}
|
|
84
|
+
/** Detailed system health (Horizon, Soroban, WebSocket, IPFS, LLM). */
|
|
85
|
+
async systemHealth() {
|
|
86
|
+
return this.request('GET', '/api/system/health');
|
|
87
|
+
}
|
|
88
|
+
// ─── Execution ───────────────────────────────────────────
|
|
89
|
+
/**
|
|
90
|
+
* Execute a strategy (routed to actual Soroban contract).
|
|
91
|
+
* Strategy names: flash-loan-arb, path-arbitrage, cross-dex, blend-yield, soroswap-swap
|
|
92
|
+
*/
|
|
93
|
+
async execute(strategy, asset, params) {
|
|
94
|
+
return this.request('POST', '/api/execute', { strategy, asset, params });
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Demo execution (Soroban dry-run simulation, no TX submitted).
|
|
98
|
+
*/
|
|
99
|
+
async executeDemo(strategy, asset) {
|
|
100
|
+
return this.request('POST', '/api/execute-demo', { strategy, asset });
|
|
101
|
+
}
|
|
102
|
+
// ─── Market Data ─────────────────────────────────────────
|
|
103
|
+
/** Get current market state (real data from Horizon). */
|
|
104
|
+
async getMarket() {
|
|
105
|
+
return this.request('GET', '/api/market');
|
|
106
|
+
}
|
|
107
|
+
/** Get autonomous loop status. */
|
|
108
|
+
async getLoopStatus() {
|
|
109
|
+
return this.request('GET', '/api/loop/status');
|
|
110
|
+
}
|
|
111
|
+
/** Start the autonomous scanning loop. */
|
|
112
|
+
async startLoop(config) {
|
|
113
|
+
return this.request('POST', '/api/loop/start', { config });
|
|
114
|
+
}
|
|
115
|
+
/** Stop the autonomous scanning loop. */
|
|
116
|
+
async stopLoop() {
|
|
117
|
+
return this.request('POST', '/api/loop/stop');
|
|
118
|
+
}
|
|
119
|
+
/** Trigger a manual market scan. */
|
|
120
|
+
async triggerScan() {
|
|
121
|
+
return this.request('POST', '/api/loop/scan');
|
|
122
|
+
}
|
|
123
|
+
// ─── Subscriptions ───────────────────────────────────────
|
|
124
|
+
/** Create a signal subscription with filters. */
|
|
125
|
+
async createSubscription(options) {
|
|
126
|
+
return this.request('POST', '/api/subscriptions', { filters: options });
|
|
127
|
+
}
|
|
128
|
+
/** Get recent signals. */
|
|
129
|
+
async getRecentSignals(count = 20) {
|
|
130
|
+
return this.request('GET', `/api/signals/recent?count=${count}`);
|
|
131
|
+
}
|
|
132
|
+
// ─── Skills ──────────────────────────────────────────────
|
|
133
|
+
/** List all loaded skills (built-in + user-installed). */
|
|
134
|
+
async getSkills() {
|
|
135
|
+
return this.request('GET', '/api/skills');
|
|
136
|
+
}
|
|
137
|
+
/** Install a skill by slug. */
|
|
138
|
+
async installSkill(source) {
|
|
139
|
+
return this.request('POST', '/api/skills/install', { source });
|
|
140
|
+
}
|
|
141
|
+
/** Uninstall a user-installed skill by slug. */
|
|
142
|
+
async uninstallSkill(slug) {
|
|
143
|
+
return this.request('DELETE', `/api/skills/${slug}`);
|
|
144
|
+
}
|
|
145
|
+
// ─── Webhooks ────────────────────────────────────────────
|
|
146
|
+
/** Register a webhook endpoint. */
|
|
147
|
+
async registerWebhook(url, events, secret) {
|
|
148
|
+
return this.request('POST', '/api/webhooks', { url, events, secret });
|
|
149
|
+
}
|
|
150
|
+
/** List all registered webhooks. */
|
|
151
|
+
async getWebhooks() {
|
|
152
|
+
return this.request('GET', '/api/webhooks');
|
|
153
|
+
}
|
|
154
|
+
/** Delete a webhook by ID. */
|
|
155
|
+
async deleteWebhook(id) {
|
|
156
|
+
return this.request('DELETE', `/api/webhooks/${id}`);
|
|
157
|
+
}
|
|
158
|
+
/** Test a webhook (sends a test event). */
|
|
159
|
+
async testWebhook(id) {
|
|
160
|
+
return this.request('POST', `/api/webhooks/${id}/test`);
|
|
161
|
+
}
|
|
162
|
+
// ─── WebSocket ───────────────────────────────────────────
|
|
163
|
+
/**
|
|
164
|
+
* Subscribe to real-time signals via WebSocket.
|
|
165
|
+
* Optionally filter by subscription ID.
|
|
166
|
+
*/
|
|
167
|
+
subscribe(callback, subscriptionId) {
|
|
168
|
+
this.signalCallbacks.push(callback);
|
|
169
|
+
this.connectWebSocket(subscriptionId);
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* Subscribe to real-time log messages.
|
|
173
|
+
*/
|
|
174
|
+
onLog(callback) {
|
|
175
|
+
this.logCallbacks.push(callback);
|
|
176
|
+
this.connectWebSocket();
|
|
177
|
+
}
|
|
178
|
+
connectWebSocket(subscriptionId) {
|
|
179
|
+
if (this.ws?.readyState === WebSocket.OPEN)
|
|
180
|
+
return;
|
|
181
|
+
const authQuery = this.token ? `?token=${this.token}` : '';
|
|
182
|
+
this.ws = new WebSocket(`${this.wsUrl}${authQuery}`);
|
|
183
|
+
this.ws.on('open', () => {
|
|
184
|
+
console.log('[Nirium SDK] WebSocket connected');
|
|
185
|
+
this.reconnectAttempts = 0;
|
|
186
|
+
if (subscriptionId) {
|
|
187
|
+
this.ws?.send(JSON.stringify({ type: 'subscribe', subscriptionId }));
|
|
188
|
+
}
|
|
189
|
+
});
|
|
190
|
+
this.ws.on('message', (data) => {
|
|
191
|
+
try {
|
|
192
|
+
const message = JSON.parse(data.toString());
|
|
193
|
+
if (message.type === 'signal') {
|
|
194
|
+
this.signalCallbacks.forEach(cb => cb(message));
|
|
195
|
+
}
|
|
196
|
+
else if (message.type === 'log') {
|
|
197
|
+
this.logCallbacks.forEach(cb => cb(message));
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
catch (error) {
|
|
201
|
+
// Ignore parse errors
|
|
202
|
+
}
|
|
203
|
+
});
|
|
204
|
+
this.ws.on('close', () => {
|
|
205
|
+
console.log('[Nirium SDK] WebSocket disconnected');
|
|
206
|
+
this.attemptReconnect(subscriptionId);
|
|
207
|
+
});
|
|
208
|
+
this.ws.on('error', (error) => {
|
|
209
|
+
console.error('[Nirium SDK] WebSocket error:', error.message);
|
|
210
|
+
});
|
|
211
|
+
}
|
|
212
|
+
attemptReconnect(subscriptionId) {
|
|
213
|
+
if (this.reconnectAttempts >= this.maxReconnectAttempts) {
|
|
214
|
+
console.error('[Nirium SDK] Max reconnect attempts reached');
|
|
215
|
+
return;
|
|
216
|
+
}
|
|
217
|
+
this.reconnectAttempts++;
|
|
218
|
+
const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
|
|
219
|
+
setTimeout(() => {
|
|
220
|
+
console.log(`[Nirium SDK] Reconnecting (attempt ${this.reconnectAttempts})...`);
|
|
221
|
+
this.connectWebSocket(subscriptionId);
|
|
222
|
+
}, delay);
|
|
223
|
+
}
|
|
224
|
+
/** Close the WebSocket connection. */
|
|
225
|
+
disconnect() {
|
|
226
|
+
this.maxReconnectAttempts = 0; // Prevent reconnection
|
|
227
|
+
this.ws?.close();
|
|
228
|
+
this.ws = null;
|
|
229
|
+
this.signalCallbacks = [];
|
|
230
|
+
this.logCallbacks = [];
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
export default Agent;
|
|
234
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "nirium",
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "Official TypeScript SDK for the Nirium autonomous DeFi agent on Stellar",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"types": "dist/index.d.ts",
|
|
7
|
+
"files": [
|
|
8
|
+
"dist",
|
|
9
|
+
"README.md"
|
|
10
|
+
],
|
|
11
|
+
"scripts": {
|
|
12
|
+
"build": "tsc",
|
|
13
|
+
"dev": "tsc --watch",
|
|
14
|
+
"lint": "eslint src/",
|
|
15
|
+
"test": "jest --passWithNoTests"
|
|
16
|
+
},
|
|
17
|
+
"dependencies": {
|
|
18
|
+
"ws": "^8.18.0"
|
|
19
|
+
},
|
|
20
|
+
"devDependencies": {
|
|
21
|
+
"@types/ws": "^8.5.13",
|
|
22
|
+
"typescript": "^5.7.0"
|
|
23
|
+
},
|
|
24
|
+
"keywords": [
|
|
25
|
+
"nirium",
|
|
26
|
+
"stellar",
|
|
27
|
+
"defi",
|
|
28
|
+
"sdk",
|
|
29
|
+
"soroban",
|
|
30
|
+
"agent"
|
|
31
|
+
],
|
|
32
|
+
"license": "MIT"
|
|
33
|
+
}
|