sorokeep 1.0.0

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.
Files changed (275) hide show
  1. package/CONTRIBUTING.md +296 -0
  2. package/LICENSE +21 -0
  3. package/README.md +677 -0
  4. package/dist/alerts/alerts.d.ts +21 -0
  5. package/dist/alerts/alerts.d.ts.map +1 -0
  6. package/dist/alerts/alerts.js +18 -0
  7. package/dist/alerts/alerts.js.map +1 -0
  8. package/dist/alerts/discord.d.ts +3 -0
  9. package/dist/alerts/discord.d.ts.map +1 -0
  10. package/dist/alerts/discord.js +199 -0
  11. package/dist/alerts/discord.js.map +1 -0
  12. package/dist/alerts/dispatcher.d.ts +13 -0
  13. package/dist/alerts/dispatcher.d.ts.map +1 -0
  14. package/dist/alerts/dispatcher.js +91 -0
  15. package/dist/alerts/dispatcher.js.map +1 -0
  16. package/dist/alerts/keys.d.ts +24 -0
  17. package/dist/alerts/keys.d.ts.map +1 -0
  18. package/dist/alerts/keys.js +44 -0
  19. package/dist/alerts/keys.js.map +1 -0
  20. package/dist/alerts/pagerduty.d.ts +8 -0
  21. package/dist/alerts/pagerduty.d.ts.map +1 -0
  22. package/dist/alerts/pagerduty.js +164 -0
  23. package/dist/alerts/pagerduty.js.map +1 -0
  24. package/dist/alerts/resource.d.ts +23 -0
  25. package/dist/alerts/resource.d.ts.map +1 -0
  26. package/dist/alerts/resource.js +167 -0
  27. package/dist/alerts/resource.js.map +1 -0
  28. package/dist/alerts/slack.d.ts +7 -0
  29. package/dist/alerts/slack.d.ts.map +1 -0
  30. package/dist/alerts/slack.js +184 -0
  31. package/dist/alerts/slack.js.map +1 -0
  32. package/dist/alerts/telegram.d.ts +9 -0
  33. package/dist/alerts/telegram.d.ts.map +1 -0
  34. package/dist/alerts/telegram.js +133 -0
  35. package/dist/alerts/telegram.js.map +1 -0
  36. package/dist/alerts/templates.d.ts +109 -0
  37. package/dist/alerts/templates.d.ts.map +1 -0
  38. package/dist/alerts/templates.js +139 -0
  39. package/dist/alerts/templates.js.map +1 -0
  40. package/dist/alerts/types.d.ts +113 -0
  41. package/dist/alerts/types.d.ts.map +1 -0
  42. package/dist/alerts/types.js +87 -0
  43. package/dist/alerts/types.js.map +1 -0
  44. package/dist/alerts/webhook.d.ts +13 -0
  45. package/dist/alerts/webhook.d.ts.map +1 -0
  46. package/dist/alerts/webhook.js +56 -0
  47. package/dist/alerts/webhook.js.map +1 -0
  48. package/dist/cli/schemaFormatter.d.ts +11 -0
  49. package/dist/cli/schemaFormatter.d.ts.map +1 -0
  50. package/dist/cli/schemaFormatter.js +74 -0
  51. package/dist/cli/schemaFormatter.js.map +1 -0
  52. package/dist/commands/alerts.d.ts +3 -0
  53. package/dist/commands/alerts.d.ts.map +1 -0
  54. package/dist/commands/alerts.js +256 -0
  55. package/dist/commands/alerts.js.map +1 -0
  56. package/dist/commands/budget.d.ts +3 -0
  57. package/dist/commands/budget.d.ts.map +1 -0
  58. package/dist/commands/budget.js +47 -0
  59. package/dist/commands/budget.js.map +1 -0
  60. package/dist/commands/channels.d.ts +3 -0
  61. package/dist/commands/channels.d.ts.map +1 -0
  62. package/dist/commands/channels.js +84 -0
  63. package/dist/commands/channels.js.map +1 -0
  64. package/dist/commands/check.d.ts +3 -0
  65. package/dist/commands/check.d.ts.map +1 -0
  66. package/dist/commands/check.js +58 -0
  67. package/dist/commands/check.js.map +1 -0
  68. package/dist/commands/completion.d.ts +3 -0
  69. package/dist/commands/completion.d.ts.map +1 -0
  70. package/dist/commands/completion.js +36 -0
  71. package/dist/commands/completion.js.map +1 -0
  72. package/dist/commands/costs.d.ts +15 -0
  73. package/dist/commands/costs.d.ts.map +1 -0
  74. package/dist/commands/costs.js +280 -0
  75. package/dist/commands/costs.js.map +1 -0
  76. package/dist/commands/daemon.d.ts +3 -0
  77. package/dist/commands/daemon.d.ts.map +1 -0
  78. package/dist/commands/daemon.js +93 -0
  79. package/dist/commands/daemon.js.map +1 -0
  80. package/dist/commands/db.d.ts +3 -0
  81. package/dist/commands/db.d.ts.map +1 -0
  82. package/dist/commands/db.js +140 -0
  83. package/dist/commands/db.js.map +1 -0
  84. package/dist/commands/guard.d.ts +3 -0
  85. package/dist/commands/guard.d.ts.map +1 -0
  86. package/dist/commands/guard.js +181 -0
  87. package/dist/commands/guard.js.map +1 -0
  88. package/dist/commands/history.d.ts +3 -0
  89. package/dist/commands/history.d.ts.map +1 -0
  90. package/dist/commands/history.js +57 -0
  91. package/dist/commands/history.js.map +1 -0
  92. package/dist/commands/inspect.d.ts +3 -0
  93. package/dist/commands/inspect.d.ts.map +1 -0
  94. package/dist/commands/inspect.js +82 -0
  95. package/dist/commands/inspect.js.map +1 -0
  96. package/dist/commands/mcp.d.ts +3 -0
  97. package/dist/commands/mcp.d.ts.map +1 -0
  98. package/dist/commands/mcp.js +20 -0
  99. package/dist/commands/mcp.js.map +1 -0
  100. package/dist/commands/pause.d.ts +3 -0
  101. package/dist/commands/pause.d.ts.map +1 -0
  102. package/dist/commands/pause.js +32 -0
  103. package/dist/commands/pause.js.map +1 -0
  104. package/dist/commands/resources.d.ts +3 -0
  105. package/dist/commands/resources.d.ts.map +1 -0
  106. package/dist/commands/resources.js +95 -0
  107. package/dist/commands/resources.js.map +1 -0
  108. package/dist/commands/restore.d.ts +3 -0
  109. package/dist/commands/restore.d.ts.map +1 -0
  110. package/dist/commands/restore.js +92 -0
  111. package/dist/commands/restore.js.map +1 -0
  112. package/dist/commands/resume.d.ts +3 -0
  113. package/dist/commands/resume.d.ts.map +1 -0
  114. package/dist/commands/resume.js +31 -0
  115. package/dist/commands/resume.js.map +1 -0
  116. package/dist/commands/status.d.ts +3 -0
  117. package/dist/commands/status.d.ts.map +1 -0
  118. package/dist/commands/status.js +63 -0
  119. package/dist/commands/status.js.map +1 -0
  120. package/dist/commands/watch.d.ts +3 -0
  121. package/dist/commands/watch.d.ts.map +1 -0
  122. package/dist/commands/watch.js +163 -0
  123. package/dist/commands/watch.js.map +1 -0
  124. package/dist/core/aws_secrets.d.ts +13 -0
  125. package/dist/core/aws_secrets.d.ts.map +1 -0
  126. package/dist/core/aws_secrets.js +34 -0
  127. package/dist/core/aws_secrets.js.map +1 -0
  128. package/dist/core/budget.d.ts +10 -0
  129. package/dist/core/budget.d.ts.map +1 -0
  130. package/dist/core/budget.js +31 -0
  131. package/dist/core/budget.js.map +1 -0
  132. package/dist/core/channels.d.ts +67 -0
  133. package/dist/core/channels.d.ts.map +1 -0
  134. package/dist/core/channels.js +136 -0
  135. package/dist/core/channels.js.map +1 -0
  136. package/dist/core/check.d.ts +25 -0
  137. package/dist/core/check.d.ts.map +1 -0
  138. package/dist/core/check.js +85 -0
  139. package/dist/core/check.js.map +1 -0
  140. package/dist/core/completion.d.ts +9 -0
  141. package/dist/core/completion.d.ts.map +1 -0
  142. package/dist/core/completion.js +68 -0
  143. package/dist/core/completion.js.map +1 -0
  144. package/dist/core/costs.d.ts +90 -0
  145. package/dist/core/costs.d.ts.map +1 -0
  146. package/dist/core/costs.js +147 -0
  147. package/dist/core/costs.js.map +1 -0
  148. package/dist/core/decoder.d.ts +7 -0
  149. package/dist/core/decoder.d.ts.map +1 -0
  150. package/dist/core/decoder.js +38 -0
  151. package/dist/core/decoder.js.map +1 -0
  152. package/dist/core/discovery.d.ts +38 -0
  153. package/dist/core/discovery.d.ts.map +1 -0
  154. package/dist/core/discovery.js +208 -0
  155. package/dist/core/discovery.js.map +1 -0
  156. package/dist/core/extension.d.ts +83 -0
  157. package/dist/core/extension.d.ts.map +1 -0
  158. package/dist/core/extension.js +429 -0
  159. package/dist/core/extension.js.map +1 -0
  160. package/dist/core/inspect.d.ts +62 -0
  161. package/dist/core/inspect.d.ts.map +1 -0
  162. package/dist/core/inspect.js +303 -0
  163. package/dist/core/inspect.js.map +1 -0
  164. package/dist/core/introspection.d.ts +8 -0
  165. package/dist/core/introspection.d.ts.map +1 -0
  166. package/dist/core/introspection.js +8 -0
  167. package/dist/core/introspection.js.map +1 -0
  168. package/dist/core/monitor.d.ts +42 -0
  169. package/dist/core/monitor.d.ts.map +1 -0
  170. package/dist/core/monitor.js +188 -0
  171. package/dist/core/monitor.js.map +1 -0
  172. package/dist/core/rent_projection.d.ts +153 -0
  173. package/dist/core/rent_projection.d.ts.map +1 -0
  174. package/dist/core/rent_projection.js +146 -0
  175. package/dist/core/rent_projection.js.map +1 -0
  176. package/dist/core/scvalTranslator.d.ts +11 -0
  177. package/dist/core/scvalTranslator.d.ts.map +1 -0
  178. package/dist/core/scvalTranslator.js +36 -0
  179. package/dist/core/scvalTranslator.js.map +1 -0
  180. package/dist/core/state_diff.d.ts +45 -0
  181. package/dist/core/state_diff.d.ts.map +1 -0
  182. package/dist/core/state_diff.js +112 -0
  183. package/dist/core/state_diff.js.map +1 -0
  184. package/dist/core/status.d.ts +24 -0
  185. package/dist/core/status.d.ts.map +1 -0
  186. package/dist/core/status.js +57 -0
  187. package/dist/core/status.js.map +1 -0
  188. package/dist/core/vault.d.ts +37 -0
  189. package/dist/core/vault.d.ts.map +1 -0
  190. package/dist/core/vault.js +179 -0
  191. package/dist/core/vault.js.map +1 -0
  192. package/dist/core/watch.d.ts +36 -0
  193. package/dist/core/watch.d.ts.map +1 -0
  194. package/dist/core/watch.js +176 -0
  195. package/dist/core/watch.js.map +1 -0
  196. package/dist/daemon/loop.d.ts +38 -0
  197. package/dist/daemon/loop.d.ts.map +1 -0
  198. package/dist/daemon/loop.js +169 -0
  199. package/dist/daemon/loop.js.map +1 -0
  200. package/dist/db/backup.d.ts +12 -0
  201. package/dist/db/backup.d.ts.map +1 -0
  202. package/dist/db/backup.js +132 -0
  203. package/dist/db/backup.js.map +1 -0
  204. package/dist/db/budget.d.ts +17 -0
  205. package/dist/db/budget.d.ts.map +1 -0
  206. package/dist/db/budget.js +31 -0
  207. package/dist/db/budget.js.map +1 -0
  208. package/dist/db/database.d.ts +6 -0
  209. package/dist/db/database.d.ts.map +1 -0
  210. package/dist/db/database.js +134 -0
  211. package/dist/db/database.js.map +1 -0
  212. package/dist/db/migrations/.gitkeep +1 -0
  213. package/dist/db/migrations/001_resource_usage_logs.sql +28 -0
  214. package/dist/db/migrator.d.ts +28 -0
  215. package/dist/db/migrator.d.ts.map +1 -0
  216. package/dist/db/migrator.js +75 -0
  217. package/dist/db/migrator.js.map +1 -0
  218. package/dist/db/repositories.d.ts +474 -0
  219. package/dist/db/repositories.d.ts.map +1 -0
  220. package/dist/db/repositories.js +809 -0
  221. package/dist/db/repositories.js.map +1 -0
  222. package/dist/db/schema.sql +207 -0
  223. package/dist/index.d.ts +3 -0
  224. package/dist/index.d.ts.map +1 -0
  225. package/dist/index.js +47 -0
  226. package/dist/index.js.map +1 -0
  227. package/dist/lib.d.ts +20 -0
  228. package/dist/lib.d.ts.map +1 -0
  229. package/dist/lib.js +16 -0
  230. package/dist/lib.js.map +1 -0
  231. package/dist/logging/index.d.ts +22 -0
  232. package/dist/logging/index.d.ts.map +1 -0
  233. package/dist/logging/index.js +34 -0
  234. package/dist/logging/index.js.map +1 -0
  235. package/dist/logging/logger.d.ts +14 -0
  236. package/dist/logging/logger.d.ts.map +1 -0
  237. package/dist/logging/logger.js +135 -0
  238. package/dist/logging/logger.js.map +1 -0
  239. package/dist/logging/types.d.ts +10 -0
  240. package/dist/logging/types.d.ts.map +1 -0
  241. package/dist/logging/types.js +2 -0
  242. package/dist/logging/types.js.map +1 -0
  243. package/dist/mcp/index.d.ts +3 -0
  244. package/dist/mcp/index.d.ts.map +1 -0
  245. package/dist/mcp/index.js +14 -0
  246. package/dist/mcp/index.js.map +1 -0
  247. package/dist/mcp/server.d.ts +10 -0
  248. package/dist/mcp/server.d.ts.map +1 -0
  249. package/dist/mcp/server.js +51 -0
  250. package/dist/mcp/server.js.map +1 -0
  251. package/dist/mcp/tools/get-extension-costs.d.ts +4 -0
  252. package/dist/mcp/tools/get-extension-costs.d.ts.map +1 -0
  253. package/dist/mcp/tools/get-extension-costs.js +33 -0
  254. package/dist/mcp/tools/get-extension-costs.js.map +1 -0
  255. package/dist/mcp/tools/get_contract_status.d.ts +8 -0
  256. package/dist/mcp/tools/get_contract_status.d.ts.map +1 -0
  257. package/dist/mcp/tools/get_contract_status.js +33 -0
  258. package/dist/mcp/tools/get_contract_status.js.map +1 -0
  259. package/dist/rpc/client.d.ts +154 -0
  260. package/dist/rpc/client.d.ts.map +1 -0
  261. package/dist/rpc/client.js +766 -0
  262. package/dist/rpc/client.js.map +1 -0
  263. package/dist/utils/config.d.ts +51 -0
  264. package/dist/utils/config.d.ts.map +1 -0
  265. package/dist/utils/config.js +86 -0
  266. package/dist/utils/config.js.map +1 -0
  267. package/dist/utils/formatting.d.ts +10 -0
  268. package/dist/utils/formatting.d.ts.map +1 -0
  269. package/dist/utils/formatting.js +66 -0
  270. package/dist/utils/formatting.js.map +1 -0
  271. package/dist/utils/watch-config.d.ts +13 -0
  272. package/dist/utils/watch-config.d.ts.map +1 -0
  273. package/dist/utils/watch-config.js +32 -0
  274. package/dist/utils/watch-config.js.map +1 -0
  275. package/package.json +73 -0
@@ -0,0 +1,181 @@
1
+ import chalk from "chalk";
2
+ import ora from "ora";
3
+ import { getDatabase } from "../db/database.js";
4
+ import { getContract, getEntriesForContract, upsertExtensionPolicy, getExtensionPolicy } from "../db/repositories.js";
5
+ import { simulateExtension, extendEntries, resolveSecretKey } from "../core/extension.js";
6
+ import { formatContractID, formatTimeToCloseLedger, formatBytes, formatCpuInsns } from "../utils/formatting.js";
7
+ import { getLogger } from "../logging/index.js";
8
+ const logger = getLogger().child({ component: "GuardCommand" });
9
+ export function registerGuardCommand(program) {
10
+ program
11
+ .command("guard <contractId>")
12
+ .description("Configure auto-extension policy for a contract")
13
+ .option("--target-ttl <ledgers>", "Target TTL in ledgers after extension", "100000")
14
+ .option("--threshold <ledgers>", "Extend when TTL drops below this many ledgers", "20000")
15
+ .option("--keypair <secret>", "Stellar secret key for signing extension transactions")
16
+ .option("--keypair-env <var>", "Environment variable containing the secret key")
17
+ .option("--keypair-vault <path>", "HashiCorp Vault secret path (e.g. secret/data/stellar/mykey)")
18
+ .option("--auto-extend", "Enable auto-extension (the daemon will extend automatically)")
19
+ .option("--dry-run", "Simulate the extension without submitting")
20
+ .option("--disable", "Disable auto-extension for this contract")
21
+ .action(async (contractId, options) => {
22
+ try {
23
+ const db = getDatabase();
24
+ const contract = getContract(db, contractId);
25
+ if (!contract) {
26
+ console.error(chalk.red(`Contract ${formatContractID(contractId)} not found. Run 'sorokeep watch' first.`));
27
+ process.exit(1);
28
+ }
29
+ const targetTTL = parseInt(options.targetTtl, 10);
30
+ const threshold = parseInt(options.threshold, 10);
31
+ if (isNaN(targetTTL) || targetTTL <= 0) {
32
+ console.error(chalk.red("--target-ttl must be a positive number"));
33
+ process.exit(1);
34
+ }
35
+ if (isNaN(threshold) || threshold <= 0) {
36
+ console.error(chalk.red("--threshold must be a positive number"));
37
+ process.exit(1);
38
+ }
39
+ console.log("DEBUG: options:", JSON.stringify(options));
40
+ if (threshold >= targetTTL) {
41
+ console.error(chalk.red("--threshold must be less than --target-ttl"));
42
+ process.exit(1);
43
+ }
44
+ // Handle --disable
45
+ if (options.disable) {
46
+ upsertExtensionPolicy(db, {
47
+ contract_id: contractId,
48
+ enabled: false,
49
+ target_ttl_ledgers: targetTTL,
50
+ extend_when_below_ledgers: threshold,
51
+ });
52
+ console.log(chalk.yellow(`Auto-extension disabled for ${contract.name ?? formatContractID(contractId)}`));
53
+ return;
54
+ }
55
+ // Resolve keypair source
56
+ let keypairSource;
57
+ let secretKey;
58
+ if (options.keypairEnv) {
59
+ keypairSource = `env:${options.keypairEnv}`;
60
+ }
61
+ else if (options.keypairVault) {
62
+ keypairSource = `vault:${options.keypairVault}`;
63
+ }
64
+ else if (options.keypair) {
65
+ keypairSource = options.keypair;
66
+ }
67
+ if (keypairSource) {
68
+ secretKey = await resolveSecretKey(keypairSource) ?? undefined;
69
+ if (!secretKey) {
70
+ console.error(chalk.red(`Failed to resolve secret key from source: ${keypairSource}`));
71
+ process.exit(1);
72
+ }
73
+ }
74
+ // Save policy
75
+ if (options.autoExtend) {
76
+ if (!keypairSource || !(keypairSource.startsWith("env:") || keypairSource.startsWith("vault:"))) {
77
+ console.error(chalk.red("--auto-extend requires --keypair-env or --keypair-vault so the daemon can resolve the key at runtime"));
78
+ process.exit(1);
79
+ }
80
+ // Extract public key from secret for storage (never store the secret itself)
81
+ const { Keypair } = await import("@stellar/stellar-sdk");
82
+ const kp = Keypair.fromSecret(secretKey);
83
+ upsertExtensionPolicy(db, {
84
+ contract_id: contractId,
85
+ enabled: true,
86
+ target_ttl_ledgers: targetTTL,
87
+ extend_when_below_ledgers: threshold,
88
+ keypair_public: kp.publicKey(),
89
+ keypair_source: keypairSource,
90
+ });
91
+ console.log(chalk.green(`\nAuto-extension enabled for ${contract.name ?? formatContractID(contractId)}`));
92
+ console.log(` Target TTL: ${targetTTL.toLocaleString()} ledgers (${formatTimeToCloseLedger(targetTTL)})`);
93
+ console.log(` Threshold: ${threshold.toLocaleString()} ledgers (${formatTimeToCloseLedger(threshold)})`);
94
+ console.log(` Funded by: ${kp.publicKey().slice(0, 8)}...${kp.publicKey().slice(-4)}`);
95
+ console.log(chalk.dim("\n The daemon will auto-extend when TTL drops below the threshold."));
96
+ console.log(chalk.dim(" Run 'sorokeep daemon --network " + contract.network + "' to start monitoring."));
97
+ return;
98
+ }
99
+ // Dry-run: simulate extension
100
+ if (options.dryRun) {
101
+ if (!secretKey) {
102
+ console.error(chalk.red("--keypair, --keypair-env, or --keypair-vault required for dry-run simulation"));
103
+ process.exit(1);
104
+ }
105
+ const entries = getEntriesForContract(db, contractId);
106
+ if (entries.length === 0) {
107
+ console.log(chalk.yellow("No entries to extend"));
108
+ return;
109
+ }
110
+ const spinner = ora("Simulating extension...").start();
111
+ const { Keypair } = await import("@stellar/stellar-sdk");
112
+ const kp = Keypair.fromSecret(secretKey);
113
+ const result = await simulateExtension(db, contractId, entries.map(e => e.entry_key_xdr), targetTTL, kp.publicKey());
114
+ if (result?.success) {
115
+ spinner.succeed(chalk.green("Simulation successful"));
116
+ logger.info("Simulation successful in guard.ts");
117
+ console.log(` Entries: ${result.entriesExtended}`);
118
+ console.log(` Estimated fee: ${(result.estimatedFee / 10_000_000).toFixed(7)} XLM`);
119
+ console.log(` CPU: ${formatCpuInsns(result.cpuInsns)}`);
120
+ console.log(` Memory: ${formatBytes(result.memBytes)}`);
121
+ if (result.readBytes !== undefined) {
122
+ console.log(` Read size: ${formatBytes(result.readBytes)}`);
123
+ }
124
+ if (result.writeBytes !== undefined) {
125
+ console.log(` Write size: ${formatBytes(result.writeBytes)}`);
126
+ }
127
+ }
128
+ else {
129
+ spinner.fail(chalk.red(`Simulation failed: ${result.error}`));
130
+ }
131
+ return;
132
+ }
133
+ // One-time manual extension
134
+ if (secretKey) {
135
+ const entries = getEntriesForContract(db, contractId);
136
+ if (entries.length === 0) {
137
+ console.log(chalk.yellow("No entries to extend"));
138
+ return;
139
+ }
140
+ const spinner = ora("Extending TTL...").start();
141
+ const result = await extendEntries(db, contractId, entries.map(e => e.entry_key_xdr), targetTTL, secretKey);
142
+ if (result.success) {
143
+ spinner.succeed(chalk.green("TTL extended successfully"));
144
+ console.log(` Entries: ${result.entriesExtended}`);
145
+ console.log(` Tx hash: ${result.txHash}`);
146
+ console.log(` Ledger: ${result.ledger}`);
147
+ }
148
+ else {
149
+ spinner.fail(chalk.red(`Extension failed: ${result.error}`));
150
+ process.exit(1);
151
+ }
152
+ return;
153
+ }
154
+ // No keypair provided — just show current policy
155
+ const policy = getExtensionPolicy(db, contractId);
156
+ if (policy) {
157
+ console.log(`\nExtension policy for ${contract.name ?? formatContractID(contractId)}:`);
158
+ console.log(` Status: ${policy.enabled ? chalk.green("ENABLED") : chalk.yellow("DISABLED")}`);
159
+ console.log(` Target: ${policy.target_ttl_ledgers.toLocaleString()} ledgers (${formatTimeToCloseLedger(policy.target_ttl_ledgers)})`);
160
+ console.log(` Threshold: ${policy.extend_when_below_ledgers.toLocaleString()} ledgers (${formatTimeToCloseLedger(policy.extend_when_below_ledgers)})`);
161
+ if (policy.keypair_public) {
162
+ console.log(` Funded by: ${policy.keypair_public.slice(0, 8)}...${policy.keypair_public.slice(-4)}`);
163
+ }
164
+ if (policy.keypair_source) {
165
+ console.log(` Key source: ${policy.keypair_source}`);
166
+ }
167
+ }
168
+ else {
169
+ console.log(chalk.dim("\nNo extension policy configured for this contract."));
170
+ console.log(chalk.dim("Use --auto-extend with --keypair-env or --keypair-vault to enable auto-extension."));
171
+ }
172
+ }
173
+ catch (error) {
174
+ const msg = error instanceof Error ? error.message : String(error);
175
+ logger.error("Guard command failed", { error: msg });
176
+ console.error(chalk.red(`Error: ${msg}`));
177
+ process.exit(1);
178
+ }
179
+ });
180
+ }
181
+ //# sourceMappingURL=guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/commands/guard.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare function registerHistoryCommand(program: Command): void;
3
+ //# sourceMappingURL=history.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D7D"}
@@ -0,0 +1,57 @@
1
+ import chalk from "chalk";
2
+ import { getDatabase } from "../db/database.js";
3
+ import { getContract, getStateChangeHistory, } from "../db/repositories.js";
4
+ import { formatContractID } from "../utils/formatting.js";
5
+ export function registerHistoryCommand(program) {
6
+ program
7
+ .command("history <contract-id>")
8
+ .description("Show state change history for a contract")
9
+ .option("--limit <n>", "Max number of records to show", "20")
10
+ .option("--entry <keyXdr>", "Filter by specific entry key XDR")
11
+ .action((contractId, options) => {
12
+ const db = getDatabase();
13
+ const limit = parseInt(options.limit, 10);
14
+ const contract = getContract(db, contractId);
15
+ if (!contract) {
16
+ console.error(chalk.red(`Error: Contract ${formatContractID(contractId)} is not registered.`));
17
+ console.error(chalk.dim("Run 'sorokeep watch <contractId>' first."));
18
+ process.exit(1);
19
+ }
20
+ const history = getStateChangeHistory(db, contractId, {
21
+ limit: limit > 0 ? limit : undefined,
22
+ entryKeyXdr: options.entry,
23
+ });
24
+ const displayName = contract.name ?? formatContractID(contractId);
25
+ if (history.length === 0) {
26
+ console.log(chalk.yellow(`No state change history found for contract ${displayName}.`));
27
+ return;
28
+ }
29
+ console.log(`\n${chalk.bold("State Change History")} — ${chalk.cyan(displayName)}\n`);
30
+ for (const record of history) {
31
+ const typeIcon = diffTypeIcon(record.diffType);
32
+ const label = record.entryLabel ?? record.entryType;
33
+ const oldVal = record.oldValueXdr ?? "(none)";
34
+ const newVal = record.newValueXdr ?? "(none)";
35
+ console.log(` ${typeIcon} ${chalk.dim(record.createdAt)} | ` +
36
+ `${chalk.cyan(label)} | ` +
37
+ `${chalk.yellow(record.diffType)} | ` +
38
+ `ledger ${chalk.magenta(record.detectedAtLedger.toLocaleString())}`);
39
+ console.log(` ${chalk.dim("old:")} ${oldVal}`);
40
+ console.log(` ${chalk.dim("new:")} ${newVal}`);
41
+ }
42
+ console.log();
43
+ });
44
+ }
45
+ function diffTypeIcon(diffType) {
46
+ switch (diffType) {
47
+ case "created":
48
+ return chalk.green("+");
49
+ case "updated":
50
+ return chalk.yellow("~");
51
+ case "deleted":
52
+ return chalk.red("-");
53
+ default:
54
+ return chalk.dim("?");
55
+ }
56
+ }
57
+ //# sourceMappingURL=history.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare function registerInspectCommand(program: Command): void;
3
+ //# sourceMappingURL=inspect.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4E7D"}
@@ -0,0 +1,82 @@
1
+ import chalk from "chalk";
2
+ import ora from "ora";
3
+ import { getDatabase } from "../db/database.js";
4
+ import { inspectContract } from "../core/inspect.js";
5
+ import { statusIndicator, formatContractID } from "../utils/formatting.js";
6
+ import { getLogger } from "../logging/index.js";
7
+ const logger = getLogger().child({ component: "InspectCommand" });
8
+ export function registerInspectCommand(program) {
9
+ program
10
+ .command("inspect <contractId>")
11
+ .description("Inspect contract storage and token balances")
12
+ .option("--entry <keyOrShortcut>", "Specific entry key XDR or shortcut (e.g. balance:<address>)", collect, [])
13
+ .option("--network <network>", "The stellar network to use (testnet, mainnet)")
14
+ .option("-r, --rpc-url <url>", "Custom RPC URL")
15
+ .action(async (contractId, options) => {
16
+ const spinner = ora(`Inspecting contract ${formatContractID(contractId)}...`).start();
17
+ try {
18
+ const db = getDatabase();
19
+ const result = await inspectContract(db, contractId, {
20
+ entries: options.entry,
21
+ network: options.network,
22
+ rpcUrl: options.rpcUrl,
23
+ });
24
+ if (!result.success) {
25
+ spinner.fail(chalk.red("Inspection failed"));
26
+ console.error(chalk.red(result.error));
27
+ process.exit(1);
28
+ return;
29
+ }
30
+ const displayName = result.contractName ?? formatContractID(contractId);
31
+ spinner.succeed(chalk.green(`Inspected ${displayName}`));
32
+ console.log();
33
+ console.log(` Contract: ${chalk.bold.cyan(displayName)} (${chalk.dim(formatContractID(contractId))})`);
34
+ console.log(` Network: ${chalk.cyan(result.network)}`);
35
+ if (result.isSac) {
36
+ console.log(` Type: ${chalk.cyan("Stellar Asset Contract (SAC)")}`);
37
+ console.log(` Decimals: ${chalk.cyan(result.decimals)}`);
38
+ }
39
+ console.log();
40
+ if (!result.results || result.results.length === 0) {
41
+ console.log(chalk.yellow(" No entries specified to inspect. Use --entry <keyXdr> or --entry balance:<address>"));
42
+ console.log();
43
+ return;
44
+ }
45
+ for (const item of result.results) {
46
+ console.log(chalk.bold(` Entry: ${item.inputEntry}`));
47
+ if (item.type === "balance" && item.balance) {
48
+ console.log(` Balance: ${chalk.bold.green(item.formattedBalance)}`);
49
+ console.log(` Raw Amount: ${item.balance.amount.toString()}`);
50
+ console.log(` Authorized: ${item.balance.authorized}`);
51
+ console.log(` Clawback: ${item.balance.clawback}`);
52
+ }
53
+ if (!item.found || item.status === "unknown" || item.remainingTTL == null) {
54
+ console.log(chalk.red(` Error: Target key is not active on-chain`));
55
+ }
56
+ else {
57
+ if (item.type === "raw" && item.decodedValue) {
58
+ console.log(chalk.cyan(` Decoded Value:`));
59
+ const formattedJson = JSON.stringify(item.decodedValue, null, 2)
60
+ .split('\n')
61
+ .map(line => ` ${line}`)
62
+ .join('\n');
63
+ console.log(formattedJson);
64
+ }
65
+ console.log(` TTL: ${item.remainingTTL.toLocaleString()} ledgers (${item.approximateTimeRemaining}) ${statusIndicator(item.status)}`);
66
+ }
67
+ console.log();
68
+ }
69
+ }
70
+ catch (error) {
71
+ const msg = error instanceof Error ? error.message : String(error);
72
+ spinner.fail(chalk.red("Error"));
73
+ console.error(chalk.red(`Error: ${msg}`));
74
+ logger.error("Inspect command failed", { error: msg });
75
+ process.exit(1);
76
+ }
77
+ });
78
+ }
79
+ function collect(value, previous) {
80
+ return previous.concat([value]);
81
+ }
82
+ //# sourceMappingURL=inspect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare function registerMcpCommand(program: Command): void;
3
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAczD"}
@@ -0,0 +1,20 @@
1
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
2
+ import { getDatabase } from "../db/database.js";
3
+ import { createMcpServer } from "../mcp/server.js";
4
+ export function registerMcpCommand(program) {
5
+ program
6
+ .command("mcp")
7
+ .description("Start the Model Context Protocol (MCP) server on stdio transport")
8
+ .action(async () => {
9
+ try {
10
+ const server = createMcpServer(() => getDatabase());
11
+ const transport = new StdioServerTransport();
12
+ await server.connect(transport);
13
+ }
14
+ catch (error) {
15
+ console.error("MCP server error:", error);
16
+ process.exit(1);
17
+ }
18
+ });
19
+ }
20
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare const registerPauseCommand: (program: Command) => void;
3
+ //# sourceMappingURL=pause.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pause.d.ts","sourceRoot":"","sources":["../../src/commands/pause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,oBAAoB,GAAI,SAAS,OAAO,KAAG,IAyBvD,CAAC"}
@@ -0,0 +1,32 @@
1
+ import chalk from "chalk";
2
+ import { getDatabase } from "../db/database.js";
3
+ import { getContract, setContractActiveStatus } from "../db/repositories.js";
4
+ import { formatContractID } from "../utils/formatting.js";
5
+ import { getLogger } from "../logging/index.js";
6
+ const logger = getLogger().child({ component: "PauseCommand" });
7
+ export const registerPauseCommand = (program) => {
8
+ program
9
+ .command("pause <contract-id>")
10
+ .description("Temporarily pause daemon polling and alerting for a contract")
11
+ .action(async (contractId) => {
12
+ try {
13
+ const db = getDatabase();
14
+ const contract = getContract(db, contractId);
15
+ if (!contract) {
16
+ console.log(chalk.red(`Contract ${formatContractID(contractId)} is not being watched.`));
17
+ process.exit(1);
18
+ return;
19
+ }
20
+ setContractActiveStatus(db, contractId, false);
21
+ console.log(chalk.green(`Successfully paused monitoring for ${formatContractID(contractId)}.`));
22
+ console.log(chalk.dim(`Run 'sorokeep resume ${formatContractID(contractId)}' to re-enable.`));
23
+ }
24
+ catch (error) {
25
+ const errorMessage = error instanceof Error ? error.message : String(error);
26
+ logger.error("Pause command failed", { error: errorMessage });
27
+ console.log(chalk.red(`Failed to pause contract: ${errorMessage}`));
28
+ process.exit(1);
29
+ }
30
+ });
31
+ };
32
+ //# sourceMappingURL=pause.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pause.js","sourceRoot":"","sources":["../../src/commands/pause.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAgB,EAAQ,EAAE;IAC3D,OAAO;SACF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,8DAA8D,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,EAAE;QACjC,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,gBAAgB,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,OAAO;YACX,CAAC;YAED,uBAAuB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sCAAsC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAChG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,gBAAgB,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAClG,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;AACX,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare function registerResourcesCommand(program: Command): void;
3
+ //# sourceMappingURL=resources.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/commands/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0G/D"}
@@ -0,0 +1,95 @@
1
+ import chalk from "chalk";
2
+ import { getDatabase } from "../db/database.js";
3
+ import { getContract, getResourceUsageHistory } from "../db/repositories.js";
4
+ import { formatContractID } from "../utils/formatting.js";
5
+ import { getLogger } from "../logging/index.js";
6
+ const logger = getLogger().child({ component: "ResourcesCommand" });
7
+ function formatMetricValue(value) {
8
+ return value.toLocaleString();
9
+ }
10
+ function formatPercentage(value) {
11
+ return `${value.toFixed(1)}%`;
12
+ }
13
+ export function registerResourcesCommand(program) {
14
+ program
15
+ .command("resources <contractId>")
16
+ .description("Show historical resource usage trends for a contract")
17
+ .option("--period <days>", "Show usage for the last N days", "30")
18
+ .option("--all", "Show all resource usage history")
19
+ .action((contractId, options) => {
20
+ try {
21
+ const db = getDatabase();
22
+ const contract = getContract(db, contractId);
23
+ if (!contract) {
24
+ console.error(chalk.red(`Contract ${formatContractID(contractId)} not found. Run 'sorokeep watch' first.`));
25
+ process.exit(1);
26
+ }
27
+ const days = options.all ? undefined : parseInt(options.period, 10);
28
+ if (days !== undefined && (!Number.isInteger(days) || days <= 0)) {
29
+ console.error(chalk.red("--period must be a positive integer number of days"));
30
+ process.exit(1);
31
+ }
32
+ const history = getResourceUsageHistory(db, contractId, days);
33
+ const displayName = contract.name ?? formatContractID(contractId);
34
+ const periodLabel = days ? `last ${days} days` : "all time";
35
+ console.log(`\n${chalk.bold("Resource Usage Trends")} — ${chalk.cyan(displayName)} (${periodLabel})`);
36
+ console.log(` Network: ${chalk.cyan(contract.network)}`);
37
+ if (history.length === 0) {
38
+ console.log(chalk.dim("\n No resource usage records found for this period."));
39
+ return;
40
+ }
41
+ const metrics = history.reduce((acc, record) => {
42
+ const bucket = acc[record.resourceType] ?? {
43
+ resourceType: record.resourceType,
44
+ count: 0,
45
+ totalUsage: 0,
46
+ minUsage: Number.POSITIVE_INFINITY,
47
+ maxUsage: Number.NEGATIVE_INFINITY,
48
+ totalPercent: 0,
49
+ minPercent: Number.POSITIVE_INFINITY,
50
+ maxPercent: Number.NEGATIVE_INFINITY,
51
+ };
52
+ bucket.count += 1;
53
+ bucket.totalUsage += record.usage;
54
+ bucket.minUsage = Math.min(bucket.minUsage, record.usage);
55
+ bucket.maxUsage = Math.max(bucket.maxUsage, record.usage);
56
+ bucket.totalPercent += record.usagePercent;
57
+ bucket.minPercent = Math.min(bucket.minPercent, record.usagePercent);
58
+ bucket.maxPercent = Math.max(bucket.maxPercent, record.usagePercent);
59
+ acc[record.resourceType] = bucket;
60
+ return acc;
61
+ }, {});
62
+ console.log(`\n ${chalk.bold("Summary")}`);
63
+ console.log(` Records: ${chalk.cyan(history.length.toString())}`);
64
+ console.log(`\n ${chalk.bold("Usage Metrics")}`);
65
+ console.log(` ${chalk.bold("Resource".padEnd(8))}` +
66
+ ` ${chalk.bold("Count".padStart(6))}` +
67
+ ` ${chalk.bold("Avg Usage".padStart(14))}` +
68
+ ` ${chalk.bold("Min".padStart(14))}` +
69
+ ` ${chalk.bold("Max".padStart(14))}` +
70
+ ` ${chalk.bold("Avg %".padStart(8))}`);
71
+ for (const resourceType of ["cpu", "memory"]) {
72
+ const bucket = metrics[resourceType];
73
+ if (!bucket) {
74
+ continue;
75
+ }
76
+ const resourceLabel = resourceType === "cpu" ? "CPU" : "Memory";
77
+ const avgUsage = bucket.totalUsage / bucket.count;
78
+ const avgPercent = bucket.totalPercent / bucket.count;
79
+ console.log(` ${resourceLabel.padEnd(8)}` +
80
+ ` ${bucket.count.toString().padStart(6)}` +
81
+ ` ${formatMetricValue(Math.round(avgUsage)).padStart(14)}` +
82
+ ` ${formatMetricValue(bucket.minUsage).padStart(14)}` +
83
+ ` ${formatMetricValue(bucket.maxUsage).padStart(14)}` +
84
+ ` ${formatPercentage(avgPercent).padStart(8)}`);
85
+ }
86
+ }
87
+ catch (error) {
88
+ const message = error instanceof Error ? error.message : String(error);
89
+ logger.error("Resources command failed", { error: message });
90
+ console.error(chalk.red(`Error: ${message}`));
91
+ process.exit(1);
92
+ }
93
+ });
94
+ }
95
+ //# sourceMappingURL=resources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/commands/resources.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare function registerRestoreCommand(program: Command): void;
3
+ //# sourceMappingURL=restore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqF7D"}