genlayer 0.38.9 → 0.38.11

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 +551 -0
  10. package/CLAUDE.md +55 -0
  11. package/CONTRIBUTING.md +117 -0
  12. package/dist/index.js +234 -65
  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 +292 -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,551 @@
1
+ # Changelog
2
+
3
+ ## 0.38.11 (2026-04-01)
4
+
5
+ ### Bug Fixes
6
+
7
+ * work around GenLayer RPC rejecting JSON-RPC id=0 ([74b71ab](https://github.com/genlayerlabs/genlayer-cli/commit/74b71ab91a6e80343d5d1560fcacbe37f74bac64))
8
+
9
+ ## 0.38.10 (2026-03-31)
10
+
11
+ ### Bug Fixes
12
+
13
+ * restore package version to 0.38.9 to match npm registry ([30ecf58](https://github.com/genlayerlabs/genlayer-cli/commit/30ecf58d66ce5deb220587af25ea54e3995cc4bc))
14
+
15
+ ## 0.38.9 (2026-03-27)
16
+
17
+ ### Bug Fixes
18
+
19
+ * **ci:** use sibling file pattern for docs sync, remove separators ([be78cb2](https://github.com/genlayerlabs/genlayer-cli/commit/be78cb2a73be02850ac75b0e3023a3783fe35e66))
20
+
21
+ ## 0.38.8 (2026-03-27)
22
+
23
+ ### Bug Fixes
24
+
25
+ * **docs:** group CLI commands by category, add README as index ([e57071b](https://github.com/genlayerlabs/genlayer-cli/commit/e57071b1a429f262484f0fd27167086009536bac))
26
+
27
+ ## 0.38.7 (2026-03-27)
28
+
29
+ ### Bug Fixes
30
+
31
+ * **docs:** parse default values from options, merge continuation lines ([fb95611](https://github.com/genlayerlabs/genlayer-cli/commit/fb95611e00b9a9688ca26474c66c153da6e2664b))
32
+
33
+ ## 0.38.6 (2026-03-27)
34
+
35
+ ### Bug Fixes
36
+
37
+ * **docs:** escape curly braces in MDX output to fix Nextra build ([dff91eb](https://github.com/genlayerlabs/genlayer-cli/commit/dff91eb2a844c4a6d65adce75b2fbe73e2720d67))
38
+
39
+ ## 0.38.5 (2026-03-27)
40
+
41
+ ### Bug Fixes
42
+
43
+ * **ci:** push docs directly to main instead of PR ([576a352](https://github.com/genlayerlabs/genlayer-cli/commit/576a35228b5a66b779e064667eda8716269451c8))
44
+
45
+ ## 0.38.4 (2026-03-27)
46
+
47
+ ### Bug Fixes
48
+
49
+ * **ci:** replace peter-evans/create-pull-request with gh pr create ([00b0395](https://github.com/genlayerlabs/genlayer-cli/commit/00b0395403033bfcc1511fe8d3ca8c3de5d316e3))
50
+
51
+ ## 0.38.3 (2026-03-27)
52
+
53
+ ### Bug Fixes
54
+
55
+ * **ci:** use GitHub App token for docs sync ([ab9766a](https://github.com/genlayerlabs/genlayer-cli/commit/ab9766a3175c8fd0f26081ff27460b3b6149e1f9))
56
+
57
+ ## 0.38.2 (2026-03-27)
58
+
59
+ ### Bug Fixes
60
+
61
+ * 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)
62
+
63
+ ## 0.38.1 (2026-03-27)
64
+
65
+ ### Bug Fixes
66
+
67
+ * **ci:** Fix bash syntax error in docs workflow ([5ec9ed9](https://github.com/genlayerlabs/genlayer-cli/commit/5ec9ed96eae87003fd493d6be7c4c5caff152257))
68
+
69
+ ## 0.38.0 (2026-03-27)
70
+
71
+ ### Features
72
+
73
+ * Add trace command for execution traces ([598d455](https://github.com/genlayerlabs/genlayer-cli/commit/598d455f3612710fd96ea61493ad9a9a5c91ec9c))
74
+
75
+ ## 0.37.1 (2026-03-20)
76
+
77
+ ### Bug Fixes
78
+
79
+ * bump genlayer-js to 0.23.0 for staking wizard min stake fix ([a42ae0d](https://github.com/genlayerlabs/genlayer-cli/commit/a42ae0defa8655d78acb0639888cafb512bde646))
80
+
81
+ ## 0.37.0 (2026-03-20)
82
+
83
+ ### Features
84
+
85
+ * smart argument type detection for contract commands ([7a03c15](https://github.com/genlayerlabs/genlayer-cli/commit/7a03c157ca1a2d4e5a2f3c087366cdb0074569a6))
86
+
87
+ ## 0.36.1 (2026-03-19)
88
+
89
+ ## 0.36.0 (2026-03-19)
90
+
91
+ ### Features
92
+
93
+ * 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))
94
+
95
+ ## 0.35.4 (2026-03-18)
96
+
97
+ ### Bug Fixes
98
+
99
+ * 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))
100
+
101
+ ## 0.35.3 (2026-03-18)
102
+
103
+ ### Bug Fixes
104
+
105
+ * 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))
106
+
107
+ ## 0.35.2 (2026-03-17)
108
+
109
+ ### Bug Fixes
110
+
111
+ * 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))
112
+
113
+ ## 0.35.1 (2026-03-17)
114
+
115
+ ### Bug Fixes
116
+
117
+ * show contract address on testnet deploys ([#281](https://github.com/genlayerlabs/genlayer-cli/issues/281)) ([af99d01](https://github.com/genlayerlabs/genlayer-cli/commit/af99d019d4757504c6695c3bdd9f61984c482554))
118
+
119
+ ## 0.35.0 (2026-03-11)
120
+
121
+ ### Features
122
+
123
+ * add testnet-bradbury network support ([#280](https://github.com/genlayerlabs/genlayer-cli/issues/280)) ([1a470cf](https://github.com/genlayerlabs/genlayer-cli/commit/1a470cf4cf1c2734f0ce1f39179788824bc40e8b))
124
+
125
+ ## 0.34.4 (2026-03-10)
126
+
127
+ ## 0.34.3 (2026-02-16)
128
+
129
+ ## 0.34.0 (2026-02-08)
130
+
131
+ ### Features
132
+
133
+ * 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))
134
+
135
+ ## 0.33.1 (2026-02-07)
136
+
137
+ ### Bug Fixes
138
+
139
+ * 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))
140
+
141
+ ## 0.33.0 (2026-01-13)
142
+
143
+ ### Features
144
+
145
+ * 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))
146
+
147
+ ## 0.32.8 (2025-12-12)
148
+
149
+ ## 0.32.5 (2025-12-09)
150
+
151
+ ## 0.32.4 (2025-12-05)
152
+
153
+ ## 0.32.3 (2025-12-05)
154
+
155
+ ## 0.32.2 (2025-12-04)
156
+
157
+ ## 0.32.1 (2025-12-04)
158
+
159
+ ## 0.32.0 (2025-12-03)
160
+
161
+ ### Features
162
+
163
+ * Implements staking functionality ([#266](https://github.com/yeagerai/genlayer-cli/issues/266)) ([36e4180](https://github.com/yeagerai/genlayer-cli/commit/36e4180c6093f380d1f552e9051345812e6bd024))
164
+
165
+ ## 0.31.0 (2025-09-03)
166
+
167
+ ### Features
168
+
169
+ * get contract code new cli command ([#253](https://github.com/yeagerai/genlayer-cli/issues/253)) ([d6ea30d](https://github.com/yeagerai/genlayer-cli/commit/d6ea30d96e2453fb90bd1493266d8b54c04e830b))
170
+
171
+ ## 0.30.0 (2025-09-03)
172
+
173
+ ### Features
174
+
175
+ * genlayercli api reference auto generated ([#247](https://github.com/yeagerai/genlayer-cli/issues/247)) ([b08c342](https://github.com/yeagerai/genlayer-cli/commit/b08c34218b9f02a1d8d7f1c0b532ab55cc4ca5af))
176
+
177
+ ## 0.29.0 (2025-09-03)
178
+
179
+ ### Features
180
+
181
+ * rename studio validators commands ([#249](https://github.com/yeagerai/genlayer-cli/issues/249)) ([fb875e5](https://github.com/yeagerai/genlayer-cli/commit/fb875e5569d21346507eab07b8eacb88b395a15d))
182
+
183
+ ## 0.28.1 (2025-09-03)
184
+
185
+ ## 0.28.0 (2025-09-03)
186
+
187
+ ### Features
188
+
189
+ * improve how cli shows transactions receipts ([#250](https://github.com/yeagerai/genlayer-cli/issues/250)) ([610831a](https://github.com/yeagerai/genlayer-cli/commit/610831a23d0fc35b6b2d1ec0e1b1d88fb357c4b5))
190
+
191
+ ## 0.27.0 (2025-09-01)
192
+
193
+ ### Features
194
+
195
+ * 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))
196
+
197
+ ## 0.26.0 (2025-08-07)
198
+
199
+ ### Features
200
+
201
+ * 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))
202
+
203
+ ## 0.25.0 (2025-07-23)
204
+
205
+ ### Features
206
+
207
+ * 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))
208
+
209
+ ## 0.24.0 (2025-07-16)
210
+
211
+ ### Features
212
+
213
+ * 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))
214
+
215
+ ## 0.23.0 (2025-07-15)
216
+
217
+ ### Features
218
+
219
+ * fetch transaction receipt command ([#234](https://github.com/yeagerai/genlayer-cli/issues/234)) ([5cf868c](https://github.com/yeagerai/genlayer-cli/commit/5cf868c28ce036e41b7b40ed6cdde222cdc5dcf0))
220
+
221
+ ## 0.22.1 (2025-07-14)
222
+
223
+ ## 0.22.0 (2025-07-14)
224
+
225
+ ### Features
226
+
227
+ * ignoring templates path ([#238](https://github.com/yeagerai/genlayer-cli/issues/238)) ([7e41a84](https://github.com/yeagerai/genlayer-cli/commit/7e41a842fcd646f47984f2ce745b37b50c299771))
228
+
229
+ ## 0.21.0 (2025-07-14)
230
+
231
+ ### Features
232
+
233
+ * update docker compose ([#237](https://github.com/yeagerai/genlayer-cli/issues/237)) ([18ea508](https://github.com/yeagerai/genlayer-cli/commit/18ea508a155bc9112612430add49c4c0e23ad3d5))
234
+
235
+ ## 0.20.0 (2025-07-09)
236
+
237
+ ### Features
238
+
239
+ * use keystore to store private keys ([#235](https://github.com/yeagerai/genlayer-cli/issues/235)) ([f18f2af](https://github.com/yeagerai/genlayer-cli/commit/f18f2afbc35c2dd988908d51ffce6b0523cfee81))
240
+
241
+ ## 0.19.0 (2025-07-09)
242
+
243
+ ### Features
244
+
245
+ * appeal command ([#233](https://github.com/yeagerai/genlayer-cli/issues/233)) ([a33f882](https://github.com/yeagerai/genlayer-cli/commit/a33f882ec7f1e7758bbf6daef67b425be10e87f2))
246
+
247
+ ## 0.18.5 (2025-07-09)
248
+
249
+ ## 0.18.4 (2025-06-27)
250
+
251
+ ### Bug Fixes
252
+
253
+ * 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))
254
+
255
+ ## 0.18.3 (2025-05-29)
256
+
257
+ ## 0.18.2 (2025-05-29)
258
+
259
+ ## 0.18.2-beta.0 (2025-05-29)
260
+
261
+ ## 0.18.0-beta.0 (2025-05-09)
262
+
263
+ ### Features
264
+
265
+ * separate read and write calls ([#222](https://github.com/yeagerai/genlayer-cli/issues/222)) ([fce8904](https://github.com/yeagerai/genlayer-cli/commit/fce8904f6b51587bfb9e690b0e42efe441f19b1d))
266
+ ## 0.18.1 (2025-05-29)
267
+
268
+ ## 0.18.0 (2025-05-28)
269
+
270
+ ### Features
271
+
272
+ * 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))
273
+
274
+ ## 0.17.0 (2025-05-05)
275
+
276
+ ### Features
277
+
278
+ * 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))
279
+
280
+ ## 0.16.0 (2025-05-02)
281
+
282
+ ### Features
283
+
284
+ * update studios compatible version ([#220](https://github.com/yeagerai/genlayer-cli/issues/220)) ([cedf568](https://github.com/yeagerai/genlayer-cli/commit/cedf56888c81098ef83647bff4ad55dd7d697fb8))
285
+
286
+ ## 0.15.0 (2025-04-29)
287
+
288
+ ### Features
289
+
290
+ * custom rpc for interacting with contracts ([#218](https://github.com/yeagerai/genlayer-cli/issues/218)) ([138babd](https://github.com/yeagerai/genlayer-cli/commit/138babd76b24d2333356ec64cfdb712add312585))
291
+
292
+ ## 0.14.1 (2025-04-25)
293
+
294
+ ## 0.14.0 (2025-04-25)
295
+
296
+ ### Features
297
+
298
+ * adding gemini and XAI ([#216](https://github.com/yeagerai/genlayer-cli/issues/216)) ([01310b2](https://github.com/yeagerai/genlayer-cli/commit/01310b2c4856880d8b4209a8b659445bf6d4d501))
299
+
300
+ ## 0.13.0 (2025-04-24)
301
+
302
+ ### Features
303
+
304
+ * create account if it doesnt exists ([#214](https://github.com/yeagerai/genlayer-cli/issues/214)) ([12d2faa](https://github.com/yeagerai/genlayer-cli/commit/12d2faa68202310059c688c9c17a99ef6e577412))
305
+
306
+ ## 0.12.5 (2025-04-24)
307
+
308
+ ## 0.12.4 (2025-04-03)
309
+
310
+ ### Bug Fixes
311
+
312
+ * map objects ([#207](https://github.com/yeagerai/genlayer-cli/issues/207)) ([45956f6](https://github.com/yeagerai/genlayer-cli/commit/45956f64e02505262a3585b1349dbfbf0f195d73))
313
+
314
+ ## 0.12.3 (2025-03-07)
315
+
316
+ ### Bug Fixes
317
+
318
+ * production build ([#204](https://github.com/yeagerai/genlayer-cli/issues/204)) ([ceed97b](https://github.com/yeagerai/genlayer-cli/commit/ceed97be6f0b6720d3d243cc41326d6b98569f26))
319
+
320
+ ## 0.12.2 (2025-03-07)
321
+
322
+ ## 0.12.1 (2025-02-20)
323
+
324
+ ## 0.12.0 (2025-02-05)
325
+
326
+
327
+ ### Features
328
+
329
+ * 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))
330
+
331
+ ## 0.11.1 (2025-02-05)
332
+
333
+ ## 0.11.0 (2025-01-31)
334
+
335
+
336
+ ### Features
337
+
338
+ * 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))
339
+
340
+ ## 0.10.2 (2025-01-30)
341
+
342
+
343
+ ### Bug Fixes
344
+
345
+ * updated studio version ([#174](https://github.com/yeagerai/genlayer-cli/issues/174)) ([e70e7f2](https://github.com/yeagerai/genlayer-cli/commit/e70e7f2e549abc9c9633ae066820fb272c9334ee))
346
+
347
+ ## 0.10.1 (2025-01-29)
348
+
349
+
350
+ ### Bug Fixes
351
+
352
+ * 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))
353
+
354
+ ## 0.10.0 (2025-01-28)
355
+
356
+
357
+ ### Features
358
+
359
+ * 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))
360
+
361
+ ## 0.10.0-beta.0 (2024-12-13)
362
+
363
+
364
+ ### Features
365
+
366
+ * new global var to deal with compatible version ([33a4c02](https://github.com/yeagerai/genlayer-cli/commit/33a4c02f091e87faf1b884177ee854fe1b66f52b))
367
+
368
+ ## 0.9.1 (2024-12-13)
369
+
370
+
371
+ ### Bug Fixes
372
+
373
+ * 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))
374
+
375
+ ## 0.9.0 (2024-12-13)
376
+
377
+
378
+ ### Features
379
+
380
+ * 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))
381
+
382
+ ## 0.8.0 (2024-12-11)
383
+
384
+
385
+ ### Features
386
+
387
+ * implement config command ([#149](https://github.com/yeagerai/genlayer-cli/issues/149)) ([cc0f2ca](https://github.com/yeagerai/genlayer-cli/commit/cc0f2caee2c55f00efc7da0671663827a69be557))
388
+
389
+ ## 0.7.0 (2024-12-09)
390
+
391
+
392
+ ### Features
393
+
394
+ * adding localnet version option on init ([#151](https://github.com/yeagerai/genlayer-cli/issues/151)) ([a7bf419](https://github.com/yeagerai/genlayer-cli/commit/a7bf41986e89e8db95003df290d381e77dad127f))
395
+
396
+ ## 0.6.0 (2024-12-03)
397
+
398
+
399
+ ### Features
400
+
401
+ * keygen create command ([#147](https://github.com/yeagerai/genlayer-cli/issues/147)) ([6168782](https://github.com/yeagerai/genlayer-cli/commit/6168782af5c028d80c2376559d3f6e5aecef2c3b))
402
+
403
+ ## 0.5.1-beta.0 (2024-12-03)
404
+
405
+
406
+ ### Bug Fixes
407
+
408
+ * merging main and resolving conflicts ([df23e36](https://github.com/yeagerai/genlayer-cli/commit/df23e365c4f481a153ae8b39051500aaad5b8b0e))
409
+
410
+ ## 0.5.0 (2024-12-03)
411
+
412
+
413
+ ### Features
414
+
415
+ * chack cli version ([#143](https://github.com/yeagerai/genlayer-cli/issues/143)) ([00ada3b](https://github.com/yeagerai/genlayer-cli/commit/00ada3b01ab8f727dbeadc2da0b810dc4211b6c9))
416
+
417
+ ## 0.4.0 (2024-11-22)
418
+
419
+
420
+ ### Features
421
+
422
+ * new reset db option ([#139](https://github.com/yeagerai/genlayer-cli/issues/139)) ([e3fed64](https://github.com/yeagerai/genlayer-cli/commit/e3fed6437e7313002685258aeced710a6fd63f4f))
423
+
424
+ ## 0.3.0 (2024-11-15)
425
+
426
+
427
+ ### Features
428
+
429
+ * abstract docker interaction ([#129](https://github.com/yeagerai/genlayer-cli/issues/129)) ([48985bb](https://github.com/yeagerai/genlayer-cli/commit/48985bb7ff81356c6b448996573d54472b45d58f))
430
+
431
+ ## 0.2.0 (2024-11-14)
432
+
433
+
434
+ ### Features
435
+
436
+ * adding headless option to cli ([#128](https://github.com/yeagerai/genlayer-cli/issues/128)) ([d9bfbc2](https://github.com/yeagerai/genlayer-cli/commit/d9bfbc2dc2bcb8a4673f419d868f2c41d8396bd8))
437
+
438
+ ## 0.1.4 (2024-11-12)
439
+
440
+
441
+ ### Bug Fixes
442
+
443
+ * 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))
444
+
445
+ ## 0.1.3 (2024-11-08)
446
+
447
+ ## 0.1.2 (2024-11-08)
448
+
449
+ ## 0.1.1 (2024-11-08)
450
+
451
+ ## 0.1.0 (2024-11-08)
452
+
453
+
454
+ ### Features
455
+
456
+ * group all non major updates ([#113](https://github.com/yeagerai/genlayer-cli/issues/113)) ([c498369](https://github.com/yeagerai/genlayer-cli/commit/c4983698ac4120e5f147bf3d529da2210d178770))
457
+
458
+ ## 0.0.34 (2024-10-22)
459
+
460
+ ## 0.0.33 (2024-10-22)
461
+
462
+
463
+ ### Bug Fixes
464
+
465
+ * response check ([#78](https://github.com/yeagerai/genlayer-cli/issues/78)) ([09c824f](https://github.com/yeagerai/genlayer-cli/commit/09c824f8b7ac1fff5355317d046752fbf58ab162))
466
+
467
+ ## 0.0.32-beta.3 (2024-07-26)
468
+
469
+ ## 0.0.32 (2024-07-15)
470
+
471
+ ## 0.0.32-beta.2 (2024-07-03)
472
+
473
+ ## 0.0.32-beta.1 (2024-07-03)
474
+
475
+ ## 0.0.32-beta.0 (2024-07-03)
476
+
477
+ ## 0.0.31 (2024-05-27)
478
+
479
+
480
+ ### Bug Fixes
481
+
482
+ * handle Fetch Error (Mac M3) ([#36](https://github.com/yeagerai/genlayer-cli/issues/36)) ([deae77a](https://github.com/yeagerai/genlayer-cli/commit/deae77a7c5a0f00694d2aa94f26d3e3be67e0178))
483
+
484
+ ## 0.0.30 (2024-05-22)
485
+
486
+ ## 0.0.29 (2024-05-15)
487
+
488
+ ## 0.0.28 (2024-05-13)
489
+
490
+ ## 0.0.27 (2024-05-08)
491
+
492
+ ## 0.0.26 (2024-05-07)
493
+
494
+ ## 0.0.25 (2024-05-06)
495
+
496
+
497
+ ### Bug Fixes
498
+
499
+ * 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))
500
+
501
+ ## 0.0.24 (2024-05-06)
502
+
503
+ ## 0.0.23 (2024-05-01)
504
+
505
+
506
+ ### Bug Fixes
507
+
508
+ * windows installation ([#19](https://github.com/yeagerai/genlayer-cli/issues/19)) ([3eafe6d](https://github.com/yeagerai/genlayer-cli/commit/3eafe6df9f5f657139177a588d6d53a652a25bd3))
509
+
510
+ ## 0.0.22 (2024-04-30)
511
+
512
+
513
+ ### Bug Fixes
514
+
515
+ * running on windows ([#18](https://github.com/yeagerai/genlayer-cli/issues/18)) ([5017bb6](https://github.com/yeagerai/genlayer-cli/commit/5017bb68b7cbfd1f18b73cf36db9f925207a708d))
516
+
517
+ ## 0.0.21 (2024-04-30)
518
+
519
+ ## 0.0.20 (2024-04-26)
520
+
521
+ ## 0.0.19 (2024-04-26)
522
+
523
+ ## 0.0.17 (2024-04-23)
524
+
525
+ ## 0.0.16 (2024-04-23)
526
+
527
+ ## [0.0.15](https://github.com/yeagerai/genlayer-cli/compare/v0.0.14...v0.0.15) (2024-04-23)
528
+
529
+ ## [0.0.14](https://github.com/yeagerai/genlayer-cli/compare/v0.0.13...v0.0.14) (2024-04-23)
530
+
531
+ ## [0.0.13](https://github.com/yeagerai/genlayer-cli/compare/v0.0.12...v0.0.13) (2024-04-23)
532
+
533
+ ## [0.0.12](https://github.com/yeagerai/genlayer-cli/compare/v0.0.11...v0.0.12) (2024-04-23)
534
+
535
+ ## [0.0.11](https://github.com/yeagerai/genlayer-cli/compare/v0.0.10...v0.0.11) (2024-04-23)
536
+
537
+ ## [0.0.10](https://github.com/yeagerai/genlayer-cli/compare/v0.0.9...v0.0.10) (2024-04-23)
538
+
539
+ ## [0.0.9](https://github.com/yeagerai/genlayer-cli/compare/v0.0.8...v0.0.9) (2024-04-23)
540
+
541
+ ## [0.0.8](https://github.com/yeagerai/genlayer-cli/compare/v0.0.7...v0.0.8) (2024-04-23)
542
+
543
+ ## [0.0.7](https://github.com/yeagerai/genlayer-cli/compare/v0.0.6...v0.0.7) (2024-04-23)
544
+
545
+ ## [0.0.6](https://github.com/yeagerai/genlayer-cli/compare/v0.0.5...v0.0.6) (2024-04-23)
546
+
547
+ ## [0.0.5](https://github.com/yeagerai/genlayer-cli/compare/v0.0.4...v0.0.5) (2024-04-23)
548
+
549
+ ## [0.0.4](https://github.com/yeagerai/genlayer-cli/compare/v0.0.3...v0.0.4) (2024-04-23)
550
+
551
+ ## 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/*`