@relaycore/cli 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 +90 -13
- package/dist/commands/auth.d.ts.map +1 -1
- package/dist/commands/auth.js +22 -5
- package/dist/commands/auth.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,39 +1,116 @@
|
|
|
1
1
|
# RelayCore CLI
|
|
2
2
|
|
|
3
|
-
The official command-line interface for RelayCore
|
|
3
|
+
The official command-line interface for **RelayCore**, the agentic finance infrastructure on Cronos. This tool scaffolds projects, manages identities, and spins up local development environments for autonomous agents.
|
|
4
|
+
|
|
5
|
+
š **Full Documentation**: [docs.relaycore.xyz/cli](https://docs.relaycore.xyz/cli/overview)
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **š Scaffold Projects**: Generate production-ready Agent, Service, or Full-Stack templates.
|
|
10
|
+
- **š Identity Management**: Register agents and services on-chain (Cronos).
|
|
11
|
+
- **š ļø Local Development**: Run a full local stack with MCP server, Next.js dashboard, and hot-reloading.
|
|
12
|
+
- **š¤ MCP Integration**: Built-in support for Model Context Protocol servers.
|
|
4
13
|
|
|
5
14
|
## Installation
|
|
6
15
|
|
|
7
16
|
```bash
|
|
8
17
|
npm install -g @relaycore/cli
|
|
9
|
-
|
|
18
|
+
|
|
19
|
+
# or via pnpm
|
|
10
20
|
pnpm add -g @relaycore/cli
|
|
11
21
|
```
|
|
12
22
|
|
|
13
|
-
##
|
|
23
|
+
## Quick Start
|
|
14
24
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
relaycore auth login
|
|
18
|
-
```
|
|
25
|
+
### 1. Initialize a Project
|
|
26
|
+
Create a new agent project with a standard directory structure:
|
|
19
27
|
|
|
20
|
-
Initialize a new agent project:
|
|
21
28
|
```bash
|
|
22
29
|
relaycore init my-agent
|
|
30
|
+
# Select template: Agent (MCP), Service (Express), or Full Stack
|
|
23
31
|
cd my-agent
|
|
24
32
|
```
|
|
25
33
|
|
|
26
|
-
|
|
34
|
+
### 2. Login & Authenticate
|
|
35
|
+
Authenticate your machine to interact with the RelayCore network:
|
|
36
|
+
|
|
27
37
|
```bash
|
|
28
|
-
relaycore
|
|
38
|
+
relaycore auth login
|
|
39
|
+
# Opens browser to authenticate and saves session
|
|
29
40
|
```
|
|
30
41
|
|
|
31
|
-
|
|
42
|
+
### 3. Register Identity
|
|
43
|
+
Before you can transact, your agent needs an on-chain identity (Relay ID):
|
|
44
|
+
|
|
32
45
|
```bash
|
|
46
|
+
# Register an Agent (Consumer)
|
|
33
47
|
relaycore agent register
|
|
48
|
+
# Prompts for: Name, Description, Capabilities
|
|
49
|
+
|
|
50
|
+
# Register a Service (Provider)
|
|
34
51
|
relaycore service register
|
|
52
|
+
# Prompts for: Service Category, Input/Output Schemas, Price
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### 4. Start Development Environment
|
|
56
|
+
Run your agent locally with the RelayCore harness:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
relaycore dev
|
|
60
|
+
```
|
|
61
|
+
This command:
|
|
62
|
+
- Starts your **MCP Server** (port 3001)
|
|
63
|
+
- Luanches the **Relay Dashboard** (port 3000)
|
|
64
|
+
- Connects to **Cronos Testnet** via your local wallet configuration
|
|
65
|
+
- Watches for file changes
|
|
66
|
+
|
|
67
|
+
## Commands Reference
|
|
68
|
+
|
|
69
|
+
### `init`
|
|
70
|
+
```bash
|
|
71
|
+
relaycore init <project-name>
|
|
72
|
+
```
|
|
73
|
+
Scaffolds a new project. You will be prompted to choose a template:
|
|
74
|
+
- **Agent**: Minimal MCP server template.
|
|
75
|
+
- **Service**: Express.js service provider template.
|
|
76
|
+
- **Full**: Monorepo with both + Next.js frontend.
|
|
77
|
+
|
|
78
|
+
### `auth`
|
|
79
|
+
```bash
|
|
80
|
+
relaycore auth login # Login via web
|
|
81
|
+
relaycore auth logout # clear local session
|
|
82
|
+
relaycore auth whoami # Show current user details
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### `agent`
|
|
86
|
+
```bash
|
|
87
|
+
relaycore agent register # Interactively register new agent
|
|
88
|
+
relaycore agent list # List agents owned by you
|
|
89
|
+
relaycore agent update # Update metadata for existing agent
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### `service`
|
|
93
|
+
```bash
|
|
94
|
+
relaycore service register # Register new service
|
|
95
|
+
relaycore service list # List your services
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### `dev`
|
|
99
|
+
```bash
|
|
100
|
+
relaycore dev
|
|
101
|
+
```
|
|
102
|
+
Starts the development studio. Requires a valid `relaycore.config.ts` in the project root.
|
|
103
|
+
|
|
104
|
+
## Configuration
|
|
105
|
+
|
|
106
|
+
The CLI looks for a `.env` file in your project root for local overrides:
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
RELAY_API_URL=https://api.relaycore.xyz # Default
|
|
110
|
+
RELAY_ENV=testnet # default: testnet
|
|
111
|
+
PRIVATE_KEY=... # Optional: For script deploy
|
|
35
112
|
```
|
|
36
113
|
|
|
37
|
-
##
|
|
114
|
+
## License
|
|
38
115
|
|
|
39
|
-
|
|
116
|
+
MIT
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,UAAU,MAAM;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,SAAS,CAAC;CACtC;AAED,eAAO,MAAM,WAAW,SAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,UAAU,MAAM;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,SAAS,CAAC;CACtC;AAED,eAAO,MAAM,WAAW,SAAsB,CAAC;AAuG/C,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAKlD"}
|
package/dist/commands/auth.js
CHANGED
|
@@ -40,10 +40,26 @@ authCommand
|
|
|
40
40
|
]);
|
|
41
41
|
const spinner = ora('Validating API key...').start();
|
|
42
42
|
try {
|
|
43
|
-
//
|
|
43
|
+
// Validate API key against RelayCore API
|
|
44
44
|
const baseUrl = answers.environment === 'testnet'
|
|
45
|
-
? 'https://api-testnet.relaycore.
|
|
46
|
-
: 'https://api.relaycore.
|
|
45
|
+
? 'https://api-testnet.relaycore.xyz'
|
|
46
|
+
: 'https://api.relaycore.xyz';
|
|
47
|
+
// Verify with the API
|
|
48
|
+
const verifyPath = '/api/user/me';
|
|
49
|
+
const response = await fetch(`${baseUrl}${verifyPath}`, {
|
|
50
|
+
method: 'GET',
|
|
51
|
+
headers: {
|
|
52
|
+
'x-api-key': answers.apiKey,
|
|
53
|
+
'Content-Type': 'application/json'
|
|
54
|
+
}
|
|
55
|
+
});
|
|
56
|
+
if (!response.ok) {
|
|
57
|
+
if (response.status === 401) {
|
|
58
|
+
throw new Error('Invalid API Key. Please check your key and try again.');
|
|
59
|
+
}
|
|
60
|
+
throw new Error(`Authentication failed: Server returned ${response.status}`);
|
|
61
|
+
}
|
|
62
|
+
const userData = await response.json();
|
|
47
63
|
const config = {
|
|
48
64
|
apiKey: answers.apiKey,
|
|
49
65
|
baseUrl,
|
|
@@ -52,11 +68,12 @@ authCommand
|
|
|
52
68
|
await fs.ensureDir(CONFIG_DIR);
|
|
53
69
|
await fs.writeJson(CONFIG_FILE, config, { spaces: 2 });
|
|
54
70
|
spinner.succeed('Authentication successful');
|
|
55
|
-
console.log(chalk.green(`\nā
Logged in
|
|
71
|
+
console.log(chalk.green(`\nā
Logged in as ${userData.userId} (${answers.environment})\n`));
|
|
56
72
|
}
|
|
57
73
|
catch (error) {
|
|
58
74
|
spinner.fail('Authentication failed');
|
|
59
|
-
console.error(chalk.red(error));
|
|
75
|
+
console.error(chalk.red('\nError: ' + (error.message || error)));
|
|
76
|
+
console.log(chalk.yellow('\nTip: Get your API Key from https://relaycore.xyz/dashboard/settings'));
|
|
60
77
|
process.exit(1);
|
|
61
78
|
}
|
|
62
79
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAQzD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/C,WAAW;KACN,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,KAAK,IAAI,EAAE;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAEhE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAClC;YACI,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,+BAA+B;YACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,OAAO,6BAA6B,CAAC;gBACzC,CAAC;gBACD,OAAO,IAAI,CAAC;YAChB,CAAC;SACJ;QACD;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,qBAAqB;YAC9B,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;YAC/B,OAAO,EAAE,SAAS;SACrB;KACJ,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,CAAC;IAErD,IAAI,CAAC;QACD
|
|
1
|
+
{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}
|