@stellar-agent/stellar 0.4.2 → 0.4.4
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 +36 -0
- package/package.json +3 -3
package/README.md
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# @stellar-agent/stellar
|
|
2
|
+
|
|
3
|
+
Stellar SDK and Stellar CLI adapters for Testnet-first agent payment workflows.
|
|
4
|
+
|
|
5
|
+
This package contains wallet creation, Friendbot funding, Horizon account reads, fee-aware payment submission, bundled Testnet payments, trustlines, claimable balances, core liquidity-pool helpers, signed-XDR submission, and Stellar CLI-backed Soroban contract operations.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @stellar-agent/stellar
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```js
|
|
16
|
+
import { createTestnetWallet, fundWithFriendbot, resolveNetworkProfile } from "@stellar-agent/stellar";
|
|
17
|
+
import { createDefaultConfig } from "@stellar-agent/core";
|
|
18
|
+
|
|
19
|
+
const config = createDefaultConfig();
|
|
20
|
+
const profile = resolveNetworkProfile("testnet", config.profiles);
|
|
21
|
+
const wallet = createTestnetWallet("agent");
|
|
22
|
+
await fundWithFriendbot(wallet.publicKey, profile);
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Safety
|
|
26
|
+
|
|
27
|
+
- Local generated wallet secrets are for Testnet use.
|
|
28
|
+
- Mainnet local auto-signing is blocked by higher-level CLI guards.
|
|
29
|
+
- Submitted operations should be paired with policy checks and receipt logging.
|
|
30
|
+
- Stellar CLI-backed Mainnet contract operations require external custody and explicit real-funds acknowledgement.
|
|
31
|
+
|
|
32
|
+
## Links
|
|
33
|
+
|
|
34
|
+
- GitHub: https://github.com/someone-in-texas/Stellar-Agent
|
|
35
|
+
- Testnet quickstart: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/quickstart-testnet.md
|
|
36
|
+
- Mainnet safety: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/mainnet-safety.md
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stellar-agent/stellar",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4",
|
|
4
4
|
"description": "Stellar SDK and Stellar CLI adapters for Testnet-first agent payment workflows.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"bugs": {
|
|
13
13
|
"url": "https://github.com/someone-in-texas/Stellar-Agent/issues"
|
|
14
14
|
},
|
|
15
|
-
"homepage": "https://github.com/someone-in-texas/Stellar-Agent#readme",
|
|
15
|
+
"homepage": "https://github.com/someone-in-texas/Stellar-Agent/tree/main/packages/stellar#readme",
|
|
16
16
|
"engines": {
|
|
17
17
|
"node": ">=22"
|
|
18
18
|
},
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
"test": "vitest run"
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
-
"@stellar-agent/core": "0.4.
|
|
35
|
+
"@stellar-agent/core": "0.4.4",
|
|
36
36
|
"@stellar/stellar-sdk": "^13.3.0"
|
|
37
37
|
}
|
|
38
38
|
}
|