genlayer 0.38.8 → 0.38.10

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 (205) hide show
  1. package/.eslintignore +2 -0
  2. package/.github/workflows/cli-docs.yml +124 -0
  3. package/.github/workflows/publish.yml +55 -0
  4. package/.github/workflows/smoke.yml +27 -0
  5. package/.github/workflows/validate-code.yml +51 -0
  6. package/.prettierignore +19 -0
  7. package/.prettierrc +12 -0
  8. package/.release-it.json +66 -0
  9. package/CHANGELOG.md +545 -0
  10. package/CLAUDE.md +55 -0
  11. package/CONTRIBUTING.md +117 -0
  12. package/dist/index.js +221 -62
  13. package/docs/api-references/_meta.json +9 -0
  14. package/docs/api-references/accounts/_meta.json +3 -0
  15. package/docs/api-references/accounts/account/create.mdx +19 -0
  16. package/docs/api-references/accounts/account/export.mdx +19 -0
  17. package/docs/api-references/accounts/account/import.mdx +22 -0
  18. package/docs/api-references/accounts/account/list.mdx +15 -0
  19. package/docs/api-references/accounts/account/lock.mdx +16 -0
  20. package/docs/api-references/accounts/account/remove.mdx +20 -0
  21. package/docs/api-references/accounts/account/send.mdx +24 -0
  22. package/docs/api-references/accounts/account/show.mdx +17 -0
  23. package/docs/api-references/accounts/account/unlock.mdx +17 -0
  24. package/docs/api-references/accounts/account/use.mdx +19 -0
  25. package/docs/api-references/accounts/account.mdx +32 -0
  26. package/docs/api-references/configuration/_meta.json +4 -0
  27. package/docs/api-references/configuration/config/get.mdx +21 -0
  28. package/docs/api-references/configuration/config/reset.mdx +21 -0
  29. package/docs/api-references/configuration/config/set.mdx +21 -0
  30. package/docs/api-references/configuration/config.mdx +25 -0
  31. package/docs/api-references/configuration/network/info.mdx +15 -0
  32. package/docs/api-references/configuration/network/list.mdx +15 -0
  33. package/docs/api-references/configuration/network/set.mdx +21 -0
  34. package/docs/api-references/configuration/network.mdx +25 -0
  35. package/docs/api-references/contracts/_meta.json +7 -0
  36. package/docs/api-references/contracts/call.mdx +21 -0
  37. package/docs/api-references/contracts/code.mdx +20 -0
  38. package/docs/api-references/contracts/deploy.mdx +17 -0
  39. package/docs/api-references/contracts/schema.mdx +20 -0
  40. package/docs/api-references/contracts/write.mdx +21 -0
  41. package/docs/api-references/environment/_meta.json +7 -0
  42. package/docs/api-references/environment/init.mdx +20 -0
  43. package/docs/api-references/environment/new.mdx +21 -0
  44. package/docs/api-references/environment/stop.mdx +15 -0
  45. package/docs/api-references/environment/up.mdx +20 -0
  46. package/docs/api-references/environment/update/ollama.mdx +16 -0
  47. package/docs/api-references/environment/update.mdx +23 -0
  48. package/docs/api-references/index.mdx +35 -0
  49. package/docs/api-references/localnet/_meta.json +3 -0
  50. package/docs/api-references/localnet/localnet/validators/count.mdx +15 -0
  51. package/docs/api-references/localnet/localnet/validators/create-random.mdx +16 -0
  52. package/docs/api-references/localnet/localnet/validators/create.mdx +19 -0
  53. package/docs/api-references/localnet/localnet/validators/delete.mdx +16 -0
  54. package/docs/api-references/localnet/localnet/validators/get.mdx +16 -0
  55. package/docs/api-references/localnet/localnet/validators/update.mdx +23 -0
  56. package/docs/api-references/localnet/localnet/validators.mdx +28 -0
  57. package/docs/api-references/localnet/localnet.mdx +23 -0
  58. package/docs/api-references/staking/_meta.json +3 -0
  59. package/docs/api-references/staking/staking/active-validators.mdx +18 -0
  60. package/docs/api-references/staking/staking/banned-validators.mdx +18 -0
  61. package/docs/api-references/staking/staking/delegation-info.mdx +25 -0
  62. package/docs/api-references/staking/staking/delegator-claim.mdx +26 -0
  63. package/docs/api-references/staking/staking/delegator-exit.mdx +26 -0
  64. package/docs/api-references/staking/staking/delegator-join.mdx +26 -0
  65. package/docs/api-references/staking/staking/epoch-info.mdx +19 -0
  66. package/docs/api-references/staking/staking/prime-all.mdx +20 -0
  67. package/docs/api-references/staking/staking/quarantined-validators.mdx +18 -0
  68. package/docs/api-references/staking/staking/set-identity.mdx +33 -0
  69. package/docs/api-references/staking/staking/set-operator.mdx +26 -0
  70. package/docs/api-references/staking/staking/validator-claim.mdx +24 -0
  71. package/docs/api-references/staking/staking/validator-deposit.mdx +25 -0
  72. package/docs/api-references/staking/staking/validator-exit.mdx +25 -0
  73. package/docs/api-references/staking/staking/validator-history.mdx +29 -0
  74. package/docs/api-references/staking/staking/validator-info.mdx +25 -0
  75. package/docs/api-references/staking/staking/validator-join.mdx +22 -0
  76. package/docs/api-references/staking/staking/validator-prime.mdx +25 -0
  77. package/docs/api-references/staking/staking/validators.mdx +19 -0
  78. package/docs/api-references/staking/staking/wizard.mdx +20 -0
  79. package/docs/api-references/staking/staking.mdx +42 -0
  80. package/docs/api-references/transactions/_meta.json +6 -0
  81. package/docs/api-references/transactions/appeal-bond.mdx +20 -0
  82. package/docs/api-references/transactions/appeal.mdx +21 -0
  83. package/docs/api-references/transactions/receipt.mdx +25 -0
  84. package/docs/api-references/transactions/trace.mdx +21 -0
  85. package/docs/delegator-guide.md +203 -0
  86. package/docs/validator-guide.md +329 -0
  87. package/esbuild.config.dev.js +17 -0
  88. package/esbuild.config.js +22 -0
  89. package/esbuild.config.prod.js +17 -0
  90. package/eslint.config.js +60 -0
  91. package/package.json +2 -11
  92. package/renovate.json +22 -0
  93. package/scripts/generate-cli-docs.mjs +68 -5
  94. package/src/commands/account/create.ts +30 -0
  95. package/src/commands/account/export.ts +106 -0
  96. package/src/commands/account/import.ts +135 -0
  97. package/src/commands/account/index.ts +129 -0
  98. package/src/commands/account/list.ts +34 -0
  99. package/src/commands/account/lock.ts +39 -0
  100. package/src/commands/account/remove.ts +30 -0
  101. package/src/commands/account/send.ts +162 -0
  102. package/src/commands/account/show.ts +74 -0
  103. package/src/commands/account/unlock.ts +56 -0
  104. package/src/commands/account/use.ts +21 -0
  105. package/src/commands/config/getSetReset.ts +51 -0
  106. package/src/commands/config/index.ts +30 -0
  107. package/src/commands/contracts/call.ts +39 -0
  108. package/src/commands/contracts/code.ts +33 -0
  109. package/src/commands/contracts/deploy.ts +161 -0
  110. package/src/commands/contracts/index.ts +150 -0
  111. package/src/commands/contracts/schema.ts +31 -0
  112. package/src/commands/contracts/write.ts +49 -0
  113. package/src/commands/general/index.ts +45 -0
  114. package/src/commands/general/init.ts +180 -0
  115. package/src/commands/general/start.ts +128 -0
  116. package/src/commands/general/stop.ts +26 -0
  117. package/src/commands/localnet/index.ts +100 -0
  118. package/src/commands/localnet/validators.ts +269 -0
  119. package/src/commands/network/index.ts +29 -0
  120. package/src/commands/network/setNetwork.ts +77 -0
  121. package/src/commands/scaffold/index.ts +16 -0
  122. package/src/commands/scaffold/new.ts +34 -0
  123. package/src/commands/staking/StakingAction.ts +279 -0
  124. package/src/commands/staking/delegatorClaim.ts +41 -0
  125. package/src/commands/staking/delegatorExit.ts +56 -0
  126. package/src/commands/staking/delegatorJoin.ts +44 -0
  127. package/src/commands/staking/index.ts +357 -0
  128. package/src/commands/staking/setIdentity.ts +78 -0
  129. package/src/commands/staking/setOperator.ts +46 -0
  130. package/src/commands/staking/stakingInfo.ts +584 -0
  131. package/src/commands/staking/validatorClaim.ts +43 -0
  132. package/src/commands/staking/validatorDeposit.ts +48 -0
  133. package/src/commands/staking/validatorExit.ts +63 -0
  134. package/src/commands/staking/validatorHistory.ts +300 -0
  135. package/src/commands/staking/validatorJoin.ts +47 -0
  136. package/src/commands/staking/validatorPrime.ts +73 -0
  137. package/src/commands/staking/wizard.ts +809 -0
  138. package/src/commands/transactions/appeal.ts +83 -0
  139. package/src/commands/transactions/index.ts +60 -0
  140. package/src/commands/transactions/receipt.ts +90 -0
  141. package/src/commands/transactions/trace.ts +42 -0
  142. package/src/commands/update/index.ts +25 -0
  143. package/src/commands/update/ollama.ts +103 -0
  144. package/src/lib/actions/BaseAction.ts +301 -0
  145. package/src/lib/clients/jsonRpcClient.ts +41 -0
  146. package/src/lib/clients/system.ts +73 -0
  147. package/src/lib/config/ConfigFileManager.ts +194 -0
  148. package/src/lib/config/KeychainManager.ts +89 -0
  149. package/src/lib/config/simulator.ts +68 -0
  150. package/src/lib/config/text.ts +2 -0
  151. package/src/lib/errors/missingRequirement.ts +9 -0
  152. package/src/lib/errors/versionRequired.ts +9 -0
  153. package/src/lib/interfaces/ISimulatorService.ts +39 -0
  154. package/src/lib/services/simulator.ts +386 -0
  155. package/src/types/node-fetch.d.ts +1 -0
  156. package/tests/actions/appeal.test.ts +141 -0
  157. package/tests/actions/call.test.ts +94 -0
  158. package/tests/actions/code.test.ts +87 -0
  159. package/tests/actions/create.test.ts +65 -0
  160. package/tests/actions/deploy.test.ts +420 -0
  161. package/tests/actions/getSetReset.test.ts +88 -0
  162. package/tests/actions/init.test.ts +483 -0
  163. package/tests/actions/lock.test.ts +86 -0
  164. package/tests/actions/new.test.ts +80 -0
  165. package/tests/actions/ollama.test.ts +193 -0
  166. package/tests/actions/receipt.test.ts +261 -0
  167. package/tests/actions/schema.test.ts +94 -0
  168. package/tests/actions/setNetwork.test.ts +161 -0
  169. package/tests/actions/staking.test.ts +280 -0
  170. package/tests/actions/start.test.ts +257 -0
  171. package/tests/actions/stop.test.ts +77 -0
  172. package/tests/actions/unlock.test.ts +139 -0
  173. package/tests/actions/validators.test.ts +750 -0
  174. package/tests/actions/write.test.ts +102 -0
  175. package/tests/commands/account.test.ts +146 -0
  176. package/tests/commands/appeal.test.ts +97 -0
  177. package/tests/commands/call.test.ts +78 -0
  178. package/tests/commands/code.test.ts +69 -0
  179. package/tests/commands/config.test.ts +54 -0
  180. package/tests/commands/deploy.test.ts +83 -0
  181. package/tests/commands/init.test.ts +101 -0
  182. package/tests/commands/localnet.test.ts +131 -0
  183. package/tests/commands/network.test.ts +60 -0
  184. package/tests/commands/new.test.ts +68 -0
  185. package/tests/commands/parseArg.test.ts +156 -0
  186. package/tests/commands/receipt.test.ts +142 -0
  187. package/tests/commands/schema.test.ts +67 -0
  188. package/tests/commands/staking.test.ts +329 -0
  189. package/tests/commands/stop.test.ts +27 -0
  190. package/tests/commands/up.test.ts +105 -0
  191. package/tests/commands/update.test.ts +45 -0
  192. package/tests/commands/write.test.ts +76 -0
  193. package/tests/index.test.ts +56 -0
  194. package/tests/libs/baseAction.test.ts +535 -0
  195. package/tests/libs/configFileManager.test.ts +118 -0
  196. package/tests/libs/jsonRpcClient.test.ts +59 -0
  197. package/tests/libs/keychainManager.test.ts +156 -0
  198. package/tests/libs/platformCommands.test.ts +78 -0
  199. package/tests/libs/system.test.ts +148 -0
  200. package/tests/services/simulator.test.ts +789 -0
  201. package/tests/smoke.test.ts +134 -0
  202. package/tests/utils.ts +13 -0
  203. package/tsconfig.json +120 -0
  204. package/vitest.config.ts +13 -0
  205. package/vitest.smoke.config.ts +17 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,545 @@
1
+ # Changelog
2
+
3
+ ## 0.38.10 (2026-03-31)
4
+
5
+ ### Bug Fixes
6
+
7
+ * restore package version to 0.38.9 to match npm registry ([30ecf58](https://github.com/genlayerlabs/genlayer-cli/commit/30ecf58d66ce5deb220587af25ea54e3995cc4bc))
8
+
9
+ ## 0.38.9 (2026-03-27)
10
+
11
+ ### Bug Fixes
12
+
13
+ * **ci:** use sibling file pattern for docs sync, remove separators ([be78cb2](https://github.com/genlayerlabs/genlayer-cli/commit/be78cb2a73be02850ac75b0e3023a3783fe35e66))
14
+
15
+ ## 0.38.8 (2026-03-27)
16
+
17
+ ### Bug Fixes
18
+
19
+ * **docs:** group CLI commands by category, add README as index ([e57071b](https://github.com/genlayerlabs/genlayer-cli/commit/e57071b1a429f262484f0fd27167086009536bac))
20
+
21
+ ## 0.38.7 (2026-03-27)
22
+
23
+ ### Bug Fixes
24
+
25
+ * **docs:** parse default values from options, merge continuation lines ([fb95611](https://github.com/genlayerlabs/genlayer-cli/commit/fb95611e00b9a9688ca26474c66c153da6e2664b))
26
+
27
+ ## 0.38.6 (2026-03-27)
28
+
29
+ ### Bug Fixes
30
+
31
+ * **docs:** escape curly braces in MDX output to fix Nextra build ([dff91eb](https://github.com/genlayerlabs/genlayer-cli/commit/dff91eb2a844c4a6d65adce75b2fbe73e2720d67))
32
+
33
+ ## 0.38.5 (2026-03-27)
34
+
35
+ ### Bug Fixes
36
+
37
+ * **ci:** push docs directly to main instead of PR ([576a352](https://github.com/genlayerlabs/genlayer-cli/commit/576a35228b5a66b779e064667eda8716269451c8))
38
+
39
+ ## 0.38.4 (2026-03-27)
40
+
41
+ ### Bug Fixes
42
+
43
+ * **ci:** replace peter-evans/create-pull-request with gh pr create ([00b0395](https://github.com/genlayerlabs/genlayer-cli/commit/00b0395403033bfcc1511fe8d3ca8c3de5d316e3))
44
+
45
+ ## 0.38.3 (2026-03-27)
46
+
47
+ ### Bug Fixes
48
+
49
+ * **ci:** use GitHub App token for docs sync ([ab9766a](https://github.com/genlayerlabs/genlayer-cli/commit/ab9766a3175c8fd0f26081ff27460b3b6149e1f9))
50
+
51
+ ## 0.38.2 (2026-03-27)
52
+
53
+ ### Bug Fixes
54
+
55
+ * Windows genlayer up, localhost access, cross-platform CI ([#288](https://github.com/genlayerlabs/genlayer-cli/issues/288)) ([debaa49](https://github.com/genlayerlabs/genlayer-cli/commit/debaa495bf1f07de98fcbb37d76caf0158093d1c)), closes [#1548](https://github.com/genlayerlabs/genlayer-cli/issues/1548)
56
+
57
+ ## 0.38.1 (2026-03-27)
58
+
59
+ ### Bug Fixes
60
+
61
+ * **ci:** Fix bash syntax error in docs workflow ([5ec9ed9](https://github.com/genlayerlabs/genlayer-cli/commit/5ec9ed96eae87003fd493d6be7c4c5caff152257))
62
+
63
+ ## 0.38.0 (2026-03-27)
64
+
65
+ ### Features
66
+
67
+ * Add trace command for execution traces ([598d455](https://github.com/genlayerlabs/genlayer-cli/commit/598d455f3612710fd96ea61493ad9a9a5c91ec9c))
68
+
69
+ ## 0.37.1 (2026-03-20)
70
+
71
+ ### Bug Fixes
72
+
73
+ * bump genlayer-js to 0.23.0 for staking wizard min stake fix ([a42ae0d](https://github.com/genlayerlabs/genlayer-cli/commit/a42ae0defa8655d78acb0639888cafb512bde646))
74
+
75
+ ## 0.37.0 (2026-03-20)
76
+
77
+ ### Features
78
+
79
+ * smart argument type detection for contract commands ([7a03c15](https://github.com/genlayerlabs/genlayer-cli/commit/7a03c157ca1a2d4e5a2f3c087366cdb0074569a6))
80
+
81
+ ## 0.36.1 (2026-03-19)
82
+
83
+ ## 0.36.0 (2026-03-19)
84
+
85
+ ### Features
86
+
87
+ * add appeal bond support and appeal-bond command ([#285](https://github.com/genlayerlabs/genlayer-cli/issues/285)) ([9e51c60](https://github.com/genlayerlabs/genlayer-cli/commit/9e51c604cf09e91b502d266464ab63ba97c94cc1))
88
+
89
+ ## 0.35.4 (2026-03-18)
90
+
91
+ ### Bug Fixes
92
+
93
+ * bump genlayer-js to 0.21.3 for gen_call testnet compatibility ([#284](https://github.com/genlayerlabs/genlayer-cli/issues/284)) ([89c3dd8](https://github.com/genlayerlabs/genlayer-cli/commit/89c3dd8358d3df8b2e50079c71560b0d84eca8b2))
94
+
95
+ ## 0.35.3 (2026-03-18)
96
+
97
+ ### Bug Fixes
98
+
99
+ * add 0x prefix to read-only keystore address ([#283](https://github.com/genlayerlabs/genlayer-cli/issues/283)) ([fa1c1c5](https://github.com/genlayerlabs/genlayer-cli/commit/fa1c1c51c2bbadc744698dfa2799d2eacf503d60))
100
+
101
+ ## 0.35.2 (2026-03-17)
102
+
103
+ ### Bug Fixes
104
+
105
+ * bump genlayer-js to 0.21.2 for staking wizard min stake fix ([#282](https://github.com/genlayerlabs/genlayer-cli/issues/282)) ([73d8809](https://github.com/genlayerlabs/genlayer-cli/commit/73d88093c4c66022f8bb6f0aaba07252a94a809c))
106
+
107
+ ## 0.35.1 (2026-03-17)
108
+
109
+ ### Bug Fixes
110
+
111
+ * show contract address on testnet deploys ([#281](https://github.com/genlayerlabs/genlayer-cli/issues/281)) ([af99d01](https://github.com/genlayerlabs/genlayer-cli/commit/af99d019d4757504c6695c3bdd9f61984c482554))
112
+
113
+ ## 0.35.0 (2026-03-11)
114
+
115
+ ### Features
116
+
117
+ * add testnet-bradbury network support ([#280](https://github.com/genlayerlabs/genlayer-cli/issues/280)) ([1a470cf](https://github.com/genlayerlabs/genlayer-cli/commit/1a470cf4cf1c2734f0ce1f39179788824bc40e8b))
118
+
119
+ ## 0.34.4 (2026-03-10)
120
+
121
+ ## 0.34.3 (2026-02-16)
122
+
123
+ ## 0.34.0 (2026-02-08)
124
+
125
+ ### Features
126
+
127
+ * add --password flag for non-interactive CLI usage ([#275](https://github.com/yeagerai/genlayer-cli/issues/275)) ([c5fffa6](https://github.com/yeagerai/genlayer-cli/commit/c5fffa6faaf0133ad83dd47279e3383d0a0cbacb))
128
+
129
+ ## 0.33.1 (2026-02-07)
130
+
131
+ ### Bug Fixes
132
+
133
+ * bump genlayer-js to 0.18.10 with phase4 testnet addresses ([#274](https://github.com/yeagerai/genlayer-cli/issues/274)) ([faa9a9b](https://github.com/yeagerai/genlayer-cli/commit/faa9a9bfaadf3ff158e2b21457330bc629d977e9))
134
+
135
+ ## 0.33.0 (2026-01-13)
136
+
137
+ ### Features
138
+
139
+ * validator tree traversal, primed column, prime-all command ([#270](https://github.com/yeagerai/genlayer-cli/issues/270)) ([75b9b06](https://github.com/yeagerai/genlayer-cli/commit/75b9b06a3bb80a24e7dabf422ceed44620765ccb))
140
+
141
+ ## 0.32.8 (2025-12-12)
142
+
143
+ ## 0.32.5 (2025-12-09)
144
+
145
+ ## 0.32.4 (2025-12-05)
146
+
147
+ ## 0.32.3 (2025-12-05)
148
+
149
+ ## 0.32.2 (2025-12-04)
150
+
151
+ ## 0.32.1 (2025-12-04)
152
+
153
+ ## 0.32.0 (2025-12-03)
154
+
155
+ ### Features
156
+
157
+ * Implements staking functionality ([#266](https://github.com/yeagerai/genlayer-cli/issues/266)) ([36e4180](https://github.com/yeagerai/genlayer-cli/commit/36e4180c6093f380d1f552e9051345812e6bd024))
158
+
159
+ ## 0.31.0 (2025-09-03)
160
+
161
+ ### Features
162
+
163
+ * get contract code new cli command ([#253](https://github.com/yeagerai/genlayer-cli/issues/253)) ([d6ea30d](https://github.com/yeagerai/genlayer-cli/commit/d6ea30d96e2453fb90bd1493266d8b54c04e830b))
164
+
165
+ ## 0.30.0 (2025-09-03)
166
+
167
+ ### Features
168
+
169
+ * genlayercli api reference auto generated ([#247](https://github.com/yeagerai/genlayer-cli/issues/247)) ([b08c342](https://github.com/yeagerai/genlayer-cli/commit/b08c34218b9f02a1d8d7f1c0b532ab55cc4ca5af))
170
+
171
+ ## 0.29.0 (2025-09-03)
172
+
173
+ ### Features
174
+
175
+ * rename studio validators commands ([#249](https://github.com/yeagerai/genlayer-cli/issues/249)) ([fb875e5](https://github.com/yeagerai/genlayer-cli/commit/fb875e5569d21346507eab07b8eacb88b395a15d))
176
+
177
+ ## 0.28.1 (2025-09-03)
178
+
179
+ ## 0.28.0 (2025-09-03)
180
+
181
+ ### Features
182
+
183
+ * improve how cli shows transactions receipts ([#250](https://github.com/yeagerai/genlayer-cli/issues/250)) ([610831a](https://github.com/yeagerai/genlayer-cli/commit/610831a23d0fc35b6b2d1ec0e1b1d88fb357c4b5))
184
+
185
+ ## 0.27.0 (2025-09-01)
186
+
187
+ ### Features
188
+
189
+ * implement os keychain support for secure private key storage ([#243](https://github.com/yeagerai/genlayer-cli/issues/243)) ([af93c6f](https://github.com/yeagerai/genlayer-cli/commit/af93c6fdd8e3673ffe3e3471bb5a8c6ea565687d))
190
+
191
+ ## 0.26.0 (2025-08-07)
192
+
193
+ ### Features
194
+
195
+ * add schema command to inspect deployed contract schema ([#244](https://github.com/yeagerai/genlayer-cli/issues/244)) ([4d66a7b](https://github.com/yeagerai/genlayer-cli/commit/4d66a7b9b2ac813cf0d47f12fc82cbc06ed25b3c))
196
+
197
+ ## 0.25.0 (2025-07-23)
198
+
199
+ ### Features
200
+
201
+ * Add Temporary Key Caching System with Read-Only Client Support ([#241](https://github.com/yeagerai/genlayer-cli/issues/241)) ([89d57f9](https://github.com/yeagerai/genlayer-cli/commit/89d57f9e35a331ef22edcdbd17384807c6fa18ac))
202
+
203
+ ## 0.24.0 (2025-07-16)
204
+
205
+ ### Features
206
+
207
+ * Add Docker Volume Cleanup to Init Flow ([#240](https://github.com/yeagerai/genlayer-cli/issues/240)) ([e61b82c](https://github.com/yeagerai/genlayer-cli/commit/e61b82c3d31aa71860eccad510141cd3f932e4aa))
208
+
209
+ ## 0.23.0 (2025-07-15)
210
+
211
+ ### Features
212
+
213
+ * fetch transaction receipt command ([#234](https://github.com/yeagerai/genlayer-cli/issues/234)) ([5cf868c](https://github.com/yeagerai/genlayer-cli/commit/5cf868c28ce036e41b7b40ed6cdde222cdc5dcf0))
214
+
215
+ ## 0.22.1 (2025-07-14)
216
+
217
+ ## 0.22.0 (2025-07-14)
218
+
219
+ ### Features
220
+
221
+ * ignoring templates path ([#238](https://github.com/yeagerai/genlayer-cli/issues/238)) ([7e41a84](https://github.com/yeagerai/genlayer-cli/commit/7e41a842fcd646f47984f2ce745b37b50c299771))
222
+
223
+ ## 0.21.0 (2025-07-14)
224
+
225
+ ### Features
226
+
227
+ * update docker compose ([#237](https://github.com/yeagerai/genlayer-cli/issues/237)) ([18ea508](https://github.com/yeagerai/genlayer-cli/commit/18ea508a155bc9112612430add49c4c0e23ad3d5))
228
+
229
+ ## 0.20.0 (2025-07-09)
230
+
231
+ ### Features
232
+
233
+ * use keystore to store private keys ([#235](https://github.com/yeagerai/genlayer-cli/issues/235)) ([f18f2af](https://github.com/yeagerai/genlayer-cli/commit/f18f2afbc35c2dd988908d51ffce6b0523cfee81))
234
+
235
+ ## 0.19.0 (2025-07-09)
236
+
237
+ ### Features
238
+
239
+ * appeal command ([#233](https://github.com/yeagerai/genlayer-cli/issues/233)) ([a33f882](https://github.com/yeagerai/genlayer-cli/commit/a33f882ec7f1e7758bbf6daef67b425be10e87f2))
240
+
241
+ ## 0.18.5 (2025-07-09)
242
+
243
+ ## 0.18.4 (2025-06-27)
244
+
245
+ ### Bug Fixes
246
+
247
+ * refactor log output formatting and address spinner display ([#228](https://github.com/yeagerai/genlayer-cli/issues/228)) ([ea0ac10](https://github.com/yeagerai/genlayer-cli/commit/ea0ac100cdbed0cf184ae1eaf1d9c0fd580fc92c))
248
+
249
+ ## 0.18.3 (2025-05-29)
250
+
251
+ ## 0.18.2 (2025-05-29)
252
+
253
+ ## 0.18.2-beta.0 (2025-05-29)
254
+
255
+ ## 0.18.0-beta.0 (2025-05-09)
256
+
257
+ ### Features
258
+
259
+ * separate read and write calls ([#222](https://github.com/yeagerai/genlayer-cli/issues/222)) ([fce8904](https://github.com/yeagerai/genlayer-cli/commit/fce8904f6b51587bfb9e690b0e42efe441f19b1d))
260
+ ## 0.18.1 (2025-05-29)
261
+
262
+ ## 0.18.0 (2025-05-28)
263
+
264
+ ### Features
265
+
266
+ * using profiles to set frontend and ollama containers ([#221](https://github.com/yeagerai/genlayer-cli/issues/221)) ([a3d0d4e](https://github.com/yeagerai/genlayer-cli/commit/a3d0d4e77e7a92a5a31ae534f5f83e81a1672783))
267
+
268
+ ## 0.17.0 (2025-05-05)
269
+
270
+ ### Features
271
+
272
+ * check if the simulator is running before launching it again ([#219](https://github.com/yeagerai/genlayer-cli/issues/219)) ([f45e1f7](https://github.com/yeagerai/genlayer-cli/commit/f45e1f7bcee9b1319cf60e658fa433fe5ec8c3eb))
273
+
274
+ ## 0.16.0 (2025-05-02)
275
+
276
+ ### Features
277
+
278
+ * update studios compatible version ([#220](https://github.com/yeagerai/genlayer-cli/issues/220)) ([cedf568](https://github.com/yeagerai/genlayer-cli/commit/cedf56888c81098ef83647bff4ad55dd7d697fb8))
279
+
280
+ ## 0.15.0 (2025-04-29)
281
+
282
+ ### Features
283
+
284
+ * custom rpc for interacting with contracts ([#218](https://github.com/yeagerai/genlayer-cli/issues/218)) ([138babd](https://github.com/yeagerai/genlayer-cli/commit/138babd76b24d2333356ec64cfdb712add312585))
285
+
286
+ ## 0.14.1 (2025-04-25)
287
+
288
+ ## 0.14.0 (2025-04-25)
289
+
290
+ ### Features
291
+
292
+ * adding gemini and XAI ([#216](https://github.com/yeagerai/genlayer-cli/issues/216)) ([01310b2](https://github.com/yeagerai/genlayer-cli/commit/01310b2c4856880d8b4209a8b659445bf6d4d501))
293
+
294
+ ## 0.13.0 (2025-04-24)
295
+
296
+ ### Features
297
+
298
+ * create account if it doesnt exists ([#214](https://github.com/yeagerai/genlayer-cli/issues/214)) ([12d2faa](https://github.com/yeagerai/genlayer-cli/commit/12d2faa68202310059c688c9c17a99ef6e577412))
299
+
300
+ ## 0.12.5 (2025-04-24)
301
+
302
+ ## 0.12.4 (2025-04-03)
303
+
304
+ ### Bug Fixes
305
+
306
+ * map objects ([#207](https://github.com/yeagerai/genlayer-cli/issues/207)) ([45956f6](https://github.com/yeagerai/genlayer-cli/commit/45956f64e02505262a3585b1349dbfbf0f195d73))
307
+
308
+ ## 0.12.3 (2025-03-07)
309
+
310
+ ### Bug Fixes
311
+
312
+ * production build ([#204](https://github.com/yeagerai/genlayer-cli/issues/204)) ([ceed97b](https://github.com/yeagerai/genlayer-cli/commit/ceed97be6f0b6720d3d243cc41326d6b98569f26))
313
+
314
+ ## 0.12.2 (2025-03-07)
315
+
316
+ ## 0.12.1 (2025-02-20)
317
+
318
+ ## 0.12.0 (2025-02-05)
319
+
320
+
321
+ ### Features
322
+
323
+ * Add `stop` Command and Improve Docker Container Management ([#178](https://github.com/yeagerai/genlayer-cli/issues/178)) ([dbae62c](https://github.com/yeagerai/genlayer-cli/commit/dbae62cd6ea0c90ee7fb6953112006f9dff729c3))
324
+
325
+ ## 0.11.1 (2025-02-05)
326
+
327
+ ## 0.11.0 (2025-01-31)
328
+
329
+
330
+ ### Features
331
+
332
+ * Enhance Ollama Command Workflow and Default Model Handling ([#171](https://github.com/yeagerai/genlayer-cli/issues/171)) ([3dc7a96](https://github.com/yeagerai/genlayer-cli/commit/3dc7a9673ada8116b1fb99e089439a75e06237ec))
333
+
334
+ ## 0.10.2 (2025-01-30)
335
+
336
+
337
+ ### Bug Fixes
338
+
339
+ * updated studio version ([#174](https://github.com/yeagerai/genlayer-cli/issues/174)) ([e70e7f2](https://github.com/yeagerai/genlayer-cli/commit/e70e7f2e549abc9c9633ae066820fb272c9334ee))
340
+
341
+ ## 0.10.1 (2025-01-29)
342
+
343
+
344
+ ### Bug Fixes
345
+
346
+ * updating studio version and docker compose breaking change ([#173](https://github.com/yeagerai/genlayer-cli/issues/173)) ([fb563e6](https://github.com/yeagerai/genlayer-cli/commit/fb563e6db4a01355baf95b2b07335374966a9cdb))
347
+
348
+ ## 0.10.0 (2025-01-28)
349
+
350
+
351
+ ### Features
352
+
353
+ * getting default ollama model from config file ([#167](https://github.com/yeagerai/genlayer-cli/issues/167)) ([d9e440d](https://github.com/yeagerai/genlayer-cli/commit/d9e440d0cd37368e0d8b154c7b5cbcdad463256f))
354
+
355
+ ## 0.10.0-beta.0 (2024-12-13)
356
+
357
+
358
+ ### Features
359
+
360
+ * new global var to deal with compatible version ([33a4c02](https://github.com/yeagerai/genlayer-cli/commit/33a4c02f091e87faf1b884177ee854fe1b66f52b))
361
+
362
+ ## 0.9.1 (2024-12-13)
363
+
364
+
365
+ ### Bug Fixes
366
+
367
+ * removing volumes to stop error when running node without nvm ([#156](https://github.com/yeagerai/genlayer-cli/issues/156)) ([189c759](https://github.com/yeagerai/genlayer-cli/commit/189c7592fedb6373e3603f1bdb4366c79f289160))
368
+
369
+ ## 0.9.0 (2024-12-13)
370
+
371
+
372
+ ### Features
373
+
374
+ * Add Deploy Command and Update Configurations for Compatibility ([#153](https://github.com/yeagerai/genlayer-cli/issues/153)) ([8744b2d](https://github.com/yeagerai/genlayer-cli/commit/8744b2d3ef2b4d7fd4d3ac71ac6e8eef69ed1555))
375
+
376
+ ## 0.8.0 (2024-12-11)
377
+
378
+
379
+ ### Features
380
+
381
+ * implement config command ([#149](https://github.com/yeagerai/genlayer-cli/issues/149)) ([cc0f2ca](https://github.com/yeagerai/genlayer-cli/commit/cc0f2caee2c55f00efc7da0671663827a69be557))
382
+
383
+ ## 0.7.0 (2024-12-09)
384
+
385
+
386
+ ### Features
387
+
388
+ * adding localnet version option on init ([#151](https://github.com/yeagerai/genlayer-cli/issues/151)) ([a7bf419](https://github.com/yeagerai/genlayer-cli/commit/a7bf41986e89e8db95003df290d381e77dad127f))
389
+
390
+ ## 0.6.0 (2024-12-03)
391
+
392
+
393
+ ### Features
394
+
395
+ * keygen create command ([#147](https://github.com/yeagerai/genlayer-cli/issues/147)) ([6168782](https://github.com/yeagerai/genlayer-cli/commit/6168782af5c028d80c2376559d3f6e5aecef2c3b))
396
+
397
+ ## 0.5.1-beta.0 (2024-12-03)
398
+
399
+
400
+ ### Bug Fixes
401
+
402
+ * merging main and resolving conflicts ([df23e36](https://github.com/yeagerai/genlayer-cli/commit/df23e365c4f481a153ae8b39051500aaad5b8b0e))
403
+
404
+ ## 0.5.0 (2024-12-03)
405
+
406
+
407
+ ### Features
408
+
409
+ * chack cli version ([#143](https://github.com/yeagerai/genlayer-cli/issues/143)) ([00ada3b](https://github.com/yeagerai/genlayer-cli/commit/00ada3b01ab8f727dbeadc2da0b810dc4211b6c9))
410
+
411
+ ## 0.4.0 (2024-11-22)
412
+
413
+
414
+ ### Features
415
+
416
+ * new reset db option ([#139](https://github.com/yeagerai/genlayer-cli/issues/139)) ([e3fed64](https://github.com/yeagerai/genlayer-cli/commit/e3fed6437e7313002685258aeced710a6fd63f4f))
417
+
418
+ ## 0.3.0 (2024-11-15)
419
+
420
+
421
+ ### Features
422
+
423
+ * abstract docker interaction ([#129](https://github.com/yeagerai/genlayer-cli/issues/129)) ([48985bb](https://github.com/yeagerai/genlayer-cli/commit/48985bb7ff81356c6b448996573d54472b45d58f))
424
+
425
+ ## 0.2.0 (2024-11-14)
426
+
427
+
428
+ ### Features
429
+
430
+ * adding headless option to cli ([#128](https://github.com/yeagerai/genlayer-cli/issues/128)) ([d9bfbc2](https://github.com/yeagerai/genlayer-cli/commit/d9bfbc2dc2bcb8a4673f419d868f2c41d8396bd8))
431
+
432
+ ## 0.1.4 (2024-11-12)
433
+
434
+
435
+ ### Bug Fixes
436
+
437
+ * changing linux command to fix display issue and fixing waiting simulator issue ([#127](https://github.com/yeagerai/genlayer-cli/issues/127)) ([721eebf](https://github.com/yeagerai/genlayer-cli/commit/721eebfea758a0897f23afd60b5767c59d593eb1))
438
+
439
+ ## 0.1.3 (2024-11-08)
440
+
441
+ ## 0.1.2 (2024-11-08)
442
+
443
+ ## 0.1.1 (2024-11-08)
444
+
445
+ ## 0.1.0 (2024-11-08)
446
+
447
+
448
+ ### Features
449
+
450
+ * group all non major updates ([#113](https://github.com/yeagerai/genlayer-cli/issues/113)) ([c498369](https://github.com/yeagerai/genlayer-cli/commit/c4983698ac4120e5f147bf3d529da2210d178770))
451
+
452
+ ## 0.0.34 (2024-10-22)
453
+
454
+ ## 0.0.33 (2024-10-22)
455
+
456
+
457
+ ### Bug Fixes
458
+
459
+ * response check ([#78](https://github.com/yeagerai/genlayer-cli/issues/78)) ([09c824f](https://github.com/yeagerai/genlayer-cli/commit/09c824f8b7ac1fff5355317d046752fbf58ab162))
460
+
461
+ ## 0.0.32-beta.3 (2024-07-26)
462
+
463
+ ## 0.0.32 (2024-07-15)
464
+
465
+ ## 0.0.32-beta.2 (2024-07-03)
466
+
467
+ ## 0.0.32-beta.1 (2024-07-03)
468
+
469
+ ## 0.0.32-beta.0 (2024-07-03)
470
+
471
+ ## 0.0.31 (2024-05-27)
472
+
473
+
474
+ ### Bug Fixes
475
+
476
+ * handle Fetch Error (Mac M3) ([#36](https://github.com/yeagerai/genlayer-cli/issues/36)) ([deae77a](https://github.com/yeagerai/genlayer-cli/commit/deae77a7c5a0f00694d2aa94f26d3e3be67e0178))
477
+
478
+ ## 0.0.30 (2024-05-22)
479
+
480
+ ## 0.0.29 (2024-05-15)
481
+
482
+ ## 0.0.28 (2024-05-13)
483
+
484
+ ## 0.0.27 (2024-05-08)
485
+
486
+ ## 0.0.26 (2024-05-07)
487
+
488
+ ## 0.0.25 (2024-05-06)
489
+
490
+
491
+ ### Bug Fixes
492
+
493
+ * OPEN AI .env key renamed in simulator ([#21](https://github.com/yeagerai/genlayer-cli/issues/21)) ([676d159](https://github.com/yeagerai/genlayer-cli/commit/676d1591871d6f81f1b8695bd4366997384579c6))
494
+
495
+ ## 0.0.24 (2024-05-06)
496
+
497
+ ## 0.0.23 (2024-05-01)
498
+
499
+
500
+ ### Bug Fixes
501
+
502
+ * windows installation ([#19](https://github.com/yeagerai/genlayer-cli/issues/19)) ([3eafe6d](https://github.com/yeagerai/genlayer-cli/commit/3eafe6df9f5f657139177a588d6d53a652a25bd3))
503
+
504
+ ## 0.0.22 (2024-04-30)
505
+
506
+
507
+ ### Bug Fixes
508
+
509
+ * running on windows ([#18](https://github.com/yeagerai/genlayer-cli/issues/18)) ([5017bb6](https://github.com/yeagerai/genlayer-cli/commit/5017bb68b7cbfd1f18b73cf36db9f925207a708d))
510
+
511
+ ## 0.0.21 (2024-04-30)
512
+
513
+ ## 0.0.20 (2024-04-26)
514
+
515
+ ## 0.0.19 (2024-04-26)
516
+
517
+ ## 0.0.17 (2024-04-23)
518
+
519
+ ## 0.0.16 (2024-04-23)
520
+
521
+ ## [0.0.15](https://github.com/yeagerai/genlayer-cli/compare/v0.0.14...v0.0.15) (2024-04-23)
522
+
523
+ ## [0.0.14](https://github.com/yeagerai/genlayer-cli/compare/v0.0.13...v0.0.14) (2024-04-23)
524
+
525
+ ## [0.0.13](https://github.com/yeagerai/genlayer-cli/compare/v0.0.12...v0.0.13) (2024-04-23)
526
+
527
+ ## [0.0.12](https://github.com/yeagerai/genlayer-cli/compare/v0.0.11...v0.0.12) (2024-04-23)
528
+
529
+ ## [0.0.11](https://github.com/yeagerai/genlayer-cli/compare/v0.0.10...v0.0.11) (2024-04-23)
530
+
531
+ ## [0.0.10](https://github.com/yeagerai/genlayer-cli/compare/v0.0.9...v0.0.10) (2024-04-23)
532
+
533
+ ## [0.0.9](https://github.com/yeagerai/genlayer-cli/compare/v0.0.8...v0.0.9) (2024-04-23)
534
+
535
+ ## [0.0.8](https://github.com/yeagerai/genlayer-cli/compare/v0.0.7...v0.0.8) (2024-04-23)
536
+
537
+ ## [0.0.7](https://github.com/yeagerai/genlayer-cli/compare/v0.0.6...v0.0.7) (2024-04-23)
538
+
539
+ ## [0.0.6](https://github.com/yeagerai/genlayer-cli/compare/v0.0.5...v0.0.6) (2024-04-23)
540
+
541
+ ## [0.0.5](https://github.com/yeagerai/genlayer-cli/compare/v0.0.4...v0.0.5) (2024-04-23)
542
+
543
+ ## [0.0.4](https://github.com/yeagerai/genlayer-cli/compare/v0.0.3...v0.0.4) (2024-04-23)
544
+
545
+ ## 0.0.3 (2024-04-23)
package/CLAUDE.md ADDED
@@ -0,0 +1,55 @@
1
+ # CLAUDE.md
2
+
3
+ This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4
+
5
+ ## Build & Development
6
+
7
+ ```bash
8
+ npm install # Install dependencies
9
+ npm run dev # Watch mode development build (uses esbuild)
10
+ npm run build # Production build
11
+ node dist/index.js # Run CLI from source
12
+ ```
13
+
14
+ ## Testing
15
+
16
+ ```bash
17
+ npm test # Run all tests (vitest)
18
+ npm run test:watch # Watch mode
19
+ npm run test:coverage # Coverage report
20
+ npx vitest tests/commands/deploy.test.ts # Single test file
21
+ npx vitest -t "test name pattern" # Run specific test by name
22
+ ```
23
+
24
+ ## Architecture
25
+
26
+ ### Entry Point & Command Structure
27
+ - `src/index.ts` - Main entry, initializes Commander program and registers all command groups
28
+ - Commands organized in `src/commands/<domain>/index.ts` - each exports `initialize*Commands(program)` function
29
+ - Command domains: general (init/up/stop), account, contracts, config, localnet, update, scaffold, network, transactions, staking
30
+
31
+ ### Core Classes
32
+ - `BaseAction` (`src/lib/actions/BaseAction.ts`) - Base class for all CLI actions. Provides:
33
+ - GenLayer client initialization via `genlayer-js` SDK
34
+ - Keystore management (encrypted wallet with password)
35
+ - Spinner/logging utilities (ora, chalk)
36
+ - User prompts (inquirer)
37
+ - `ConfigFileManager` (`src/lib/config/ConfigFileManager.ts`) - Manages `~/.genlayer/genlayer-config.json`
38
+ - `KeychainManager` (`src/lib/config/KeychainManager.ts`) - System keychain integration via keytar
39
+
40
+ ### Pattern for Adding Commands
41
+ 1. Create action class extending `BaseAction` in `src/commands/<domain>/<action>.ts`
42
+ 2. Export action options interface
43
+ 3. Register in domain's `index.ts` via Commander
44
+ 4. Add tests in `tests/commands/<domain>.test.ts` and `tests/actions/<action>.test.ts`
45
+
46
+ ### External Dependencies
47
+ - `commander` - CLI framework
48
+ - `genlayer-js` - GenLayer SDK for blockchain interactions
49
+ - `ethers` - Wallet/keystore encryption
50
+ - `dockerode` - Docker management for localnet
51
+ - `viem` - Ethereum utilities
52
+
53
+ ### Path Aliases
54
+ - `@/*` → `./src/*`
55
+ - `@@/tests/*` → `./tests/*`