@stellar-agent/ledger-logger 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 +32 -0
- package/package.json +3 -3
package/README.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# @stellar-agent/ledger-logger
|
|
2
|
+
|
|
3
|
+
Receipt and JSONL event logging for Stellar Agent operations.
|
|
4
|
+
|
|
5
|
+
This package writes structured receipts for submitted payments and operations, reads the latest receipt, derives spend history for policy evaluation, and verifies that receipt payloads do not contain secret keys.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @stellar-agent/ledger-logger
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```js
|
|
16
|
+
import { latestReceipt, spendHistoryFromReceipts } from "@stellar-agent/ledger-logger";
|
|
17
|
+
|
|
18
|
+
const latest = await latestReceipt("~/.stellar-agent/receipts");
|
|
19
|
+
const spend = await spendHistoryFromReceipts("~/.stellar-agent/receipts");
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Safety
|
|
23
|
+
|
|
24
|
+
- Receipts are designed for public transaction metadata, not secret custody.
|
|
25
|
+
- Secret-like values are rejected by receipt verification.
|
|
26
|
+
- Payment commands use receipt history when evaluating daily and monthly policy limits.
|
|
27
|
+
|
|
28
|
+
## Links
|
|
29
|
+
|
|
30
|
+
- GitHub: https://github.com/someone-in-texas/Stellar-Agent
|
|
31
|
+
- Ledger logging docs: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/ledger-logging.md
|
|
32
|
+
- Threat model: https://github.com/someone-in-texas/Stellar-Agent/blob/main/docs/threat-model.md
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stellar-agent/ledger-logger",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4",
|
|
4
4
|
"description": "Receipt and JSONL event logging for Stellar Agent Bridge operations.",
|
|
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/ledger-logger#readme",
|
|
16
16
|
"engines": {
|
|
17
17
|
"node": ">=22"
|
|
18
18
|
},
|
|
@@ -32,6 +32,6 @@
|
|
|
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
|
}
|
|
37
37
|
}
|