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.
- package/.eslintignore +2 -0
- package/.github/workflows/cli-docs.yml +124 -0
- package/.github/workflows/publish.yml +55 -0
- package/.github/workflows/smoke.yml +27 -0
- package/.github/workflows/validate-code.yml +51 -0
- package/.prettierignore +19 -0
- package/.prettierrc +12 -0
- package/.release-it.json +66 -0
- package/CHANGELOG.md +545 -0
- package/CLAUDE.md +55 -0
- package/CONTRIBUTING.md +117 -0
- package/dist/index.js +221 -62
- package/docs/api-references/_meta.json +9 -0
- package/docs/api-references/accounts/_meta.json +3 -0
- package/docs/api-references/accounts/account/create.mdx +19 -0
- package/docs/api-references/accounts/account/export.mdx +19 -0
- package/docs/api-references/accounts/account/import.mdx +22 -0
- package/docs/api-references/accounts/account/list.mdx +15 -0
- package/docs/api-references/accounts/account/lock.mdx +16 -0
- package/docs/api-references/accounts/account/remove.mdx +20 -0
- package/docs/api-references/accounts/account/send.mdx +24 -0
- package/docs/api-references/accounts/account/show.mdx +17 -0
- package/docs/api-references/accounts/account/unlock.mdx +17 -0
- package/docs/api-references/accounts/account/use.mdx +19 -0
- package/docs/api-references/accounts/account.mdx +32 -0
- package/docs/api-references/configuration/_meta.json +4 -0
- package/docs/api-references/configuration/config/get.mdx +21 -0
- package/docs/api-references/configuration/config/reset.mdx +21 -0
- package/docs/api-references/configuration/config/set.mdx +21 -0
- package/docs/api-references/configuration/config.mdx +25 -0
- package/docs/api-references/configuration/network/info.mdx +15 -0
- package/docs/api-references/configuration/network/list.mdx +15 -0
- package/docs/api-references/configuration/network/set.mdx +21 -0
- package/docs/api-references/configuration/network.mdx +25 -0
- package/docs/api-references/contracts/_meta.json +7 -0
- package/docs/api-references/contracts/call.mdx +21 -0
- package/docs/api-references/contracts/code.mdx +20 -0
- package/docs/api-references/contracts/deploy.mdx +17 -0
- package/docs/api-references/contracts/schema.mdx +20 -0
- package/docs/api-references/contracts/write.mdx +21 -0
- package/docs/api-references/environment/_meta.json +7 -0
- package/docs/api-references/environment/init.mdx +20 -0
- package/docs/api-references/environment/new.mdx +21 -0
- package/docs/api-references/environment/stop.mdx +15 -0
- package/docs/api-references/environment/up.mdx +20 -0
- package/docs/api-references/environment/update/ollama.mdx +16 -0
- package/docs/api-references/environment/update.mdx +23 -0
- package/docs/api-references/index.mdx +35 -0
- package/docs/api-references/localnet/_meta.json +3 -0
- package/docs/api-references/localnet/localnet/validators/count.mdx +15 -0
- package/docs/api-references/localnet/localnet/validators/create-random.mdx +16 -0
- package/docs/api-references/localnet/localnet/validators/create.mdx +19 -0
- package/docs/api-references/localnet/localnet/validators/delete.mdx +16 -0
- package/docs/api-references/localnet/localnet/validators/get.mdx +16 -0
- package/docs/api-references/localnet/localnet/validators/update.mdx +23 -0
- package/docs/api-references/localnet/localnet/validators.mdx +28 -0
- package/docs/api-references/localnet/localnet.mdx +23 -0
- package/docs/api-references/staking/_meta.json +3 -0
- package/docs/api-references/staking/staking/active-validators.mdx +18 -0
- package/docs/api-references/staking/staking/banned-validators.mdx +18 -0
- package/docs/api-references/staking/staking/delegation-info.mdx +25 -0
- package/docs/api-references/staking/staking/delegator-claim.mdx +26 -0
- package/docs/api-references/staking/staking/delegator-exit.mdx +26 -0
- package/docs/api-references/staking/staking/delegator-join.mdx +26 -0
- package/docs/api-references/staking/staking/epoch-info.mdx +19 -0
- package/docs/api-references/staking/staking/prime-all.mdx +20 -0
- package/docs/api-references/staking/staking/quarantined-validators.mdx +18 -0
- package/docs/api-references/staking/staking/set-identity.mdx +33 -0
- package/docs/api-references/staking/staking/set-operator.mdx +26 -0
- package/docs/api-references/staking/staking/validator-claim.mdx +24 -0
- package/docs/api-references/staking/staking/validator-deposit.mdx +25 -0
- package/docs/api-references/staking/staking/validator-exit.mdx +25 -0
- package/docs/api-references/staking/staking/validator-history.mdx +29 -0
- package/docs/api-references/staking/staking/validator-info.mdx +25 -0
- package/docs/api-references/staking/staking/validator-join.mdx +22 -0
- package/docs/api-references/staking/staking/validator-prime.mdx +25 -0
- package/docs/api-references/staking/staking/validators.mdx +19 -0
- package/docs/api-references/staking/staking/wizard.mdx +20 -0
- package/docs/api-references/staking/staking.mdx +42 -0
- package/docs/api-references/transactions/_meta.json +6 -0
- package/docs/api-references/transactions/appeal-bond.mdx +20 -0
- package/docs/api-references/transactions/appeal.mdx +21 -0
- package/docs/api-references/transactions/receipt.mdx +25 -0
- package/docs/api-references/transactions/trace.mdx +21 -0
- package/docs/delegator-guide.md +203 -0
- package/docs/validator-guide.md +329 -0
- package/esbuild.config.dev.js +17 -0
- package/esbuild.config.js +22 -0
- package/esbuild.config.prod.js +17 -0
- package/eslint.config.js +60 -0
- package/package.json +2 -11
- package/renovate.json +22 -0
- package/scripts/generate-cli-docs.mjs +68 -5
- package/src/commands/account/create.ts +30 -0
- package/src/commands/account/export.ts +106 -0
- package/src/commands/account/import.ts +135 -0
- package/src/commands/account/index.ts +129 -0
- package/src/commands/account/list.ts +34 -0
- package/src/commands/account/lock.ts +39 -0
- package/src/commands/account/remove.ts +30 -0
- package/src/commands/account/send.ts +162 -0
- package/src/commands/account/show.ts +74 -0
- package/src/commands/account/unlock.ts +56 -0
- package/src/commands/account/use.ts +21 -0
- package/src/commands/config/getSetReset.ts +51 -0
- package/src/commands/config/index.ts +30 -0
- package/src/commands/contracts/call.ts +39 -0
- package/src/commands/contracts/code.ts +33 -0
- package/src/commands/contracts/deploy.ts +161 -0
- package/src/commands/contracts/index.ts +150 -0
- package/src/commands/contracts/schema.ts +31 -0
- package/src/commands/contracts/write.ts +49 -0
- package/src/commands/general/index.ts +45 -0
- package/src/commands/general/init.ts +180 -0
- package/src/commands/general/start.ts +128 -0
- package/src/commands/general/stop.ts +26 -0
- package/src/commands/localnet/index.ts +100 -0
- package/src/commands/localnet/validators.ts +269 -0
- package/src/commands/network/index.ts +29 -0
- package/src/commands/network/setNetwork.ts +77 -0
- package/src/commands/scaffold/index.ts +16 -0
- package/src/commands/scaffold/new.ts +34 -0
- package/src/commands/staking/StakingAction.ts +279 -0
- package/src/commands/staking/delegatorClaim.ts +41 -0
- package/src/commands/staking/delegatorExit.ts +56 -0
- package/src/commands/staking/delegatorJoin.ts +44 -0
- package/src/commands/staking/index.ts +357 -0
- package/src/commands/staking/setIdentity.ts +78 -0
- package/src/commands/staking/setOperator.ts +46 -0
- package/src/commands/staking/stakingInfo.ts +584 -0
- package/src/commands/staking/validatorClaim.ts +43 -0
- package/src/commands/staking/validatorDeposit.ts +48 -0
- package/src/commands/staking/validatorExit.ts +63 -0
- package/src/commands/staking/validatorHistory.ts +300 -0
- package/src/commands/staking/validatorJoin.ts +47 -0
- package/src/commands/staking/validatorPrime.ts +73 -0
- package/src/commands/staking/wizard.ts +809 -0
- package/src/commands/transactions/appeal.ts +83 -0
- package/src/commands/transactions/index.ts +60 -0
- package/src/commands/transactions/receipt.ts +90 -0
- package/src/commands/transactions/trace.ts +42 -0
- package/src/commands/update/index.ts +25 -0
- package/src/commands/update/ollama.ts +103 -0
- package/src/lib/actions/BaseAction.ts +301 -0
- package/src/lib/clients/jsonRpcClient.ts +41 -0
- package/src/lib/clients/system.ts +73 -0
- package/src/lib/config/ConfigFileManager.ts +194 -0
- package/src/lib/config/KeychainManager.ts +89 -0
- package/src/lib/config/simulator.ts +68 -0
- package/src/lib/config/text.ts +2 -0
- package/src/lib/errors/missingRequirement.ts +9 -0
- package/src/lib/errors/versionRequired.ts +9 -0
- package/src/lib/interfaces/ISimulatorService.ts +39 -0
- package/src/lib/services/simulator.ts +386 -0
- package/src/types/node-fetch.d.ts +1 -0
- package/tests/actions/appeal.test.ts +141 -0
- package/tests/actions/call.test.ts +94 -0
- package/tests/actions/code.test.ts +87 -0
- package/tests/actions/create.test.ts +65 -0
- package/tests/actions/deploy.test.ts +420 -0
- package/tests/actions/getSetReset.test.ts +88 -0
- package/tests/actions/init.test.ts +483 -0
- package/tests/actions/lock.test.ts +86 -0
- package/tests/actions/new.test.ts +80 -0
- package/tests/actions/ollama.test.ts +193 -0
- package/tests/actions/receipt.test.ts +261 -0
- package/tests/actions/schema.test.ts +94 -0
- package/tests/actions/setNetwork.test.ts +161 -0
- package/tests/actions/staking.test.ts +280 -0
- package/tests/actions/start.test.ts +257 -0
- package/tests/actions/stop.test.ts +77 -0
- package/tests/actions/unlock.test.ts +139 -0
- package/tests/actions/validators.test.ts +750 -0
- package/tests/actions/write.test.ts +102 -0
- package/tests/commands/account.test.ts +146 -0
- package/tests/commands/appeal.test.ts +97 -0
- package/tests/commands/call.test.ts +78 -0
- package/tests/commands/code.test.ts +69 -0
- package/tests/commands/config.test.ts +54 -0
- package/tests/commands/deploy.test.ts +83 -0
- package/tests/commands/init.test.ts +101 -0
- package/tests/commands/localnet.test.ts +131 -0
- package/tests/commands/network.test.ts +60 -0
- package/tests/commands/new.test.ts +68 -0
- package/tests/commands/parseArg.test.ts +156 -0
- package/tests/commands/receipt.test.ts +142 -0
- package/tests/commands/schema.test.ts +67 -0
- package/tests/commands/staking.test.ts +329 -0
- package/tests/commands/stop.test.ts +27 -0
- package/tests/commands/up.test.ts +105 -0
- package/tests/commands/update.test.ts +45 -0
- package/tests/commands/write.test.ts +76 -0
- package/tests/index.test.ts +56 -0
- package/tests/libs/baseAction.test.ts +535 -0
- package/tests/libs/configFileManager.test.ts +118 -0
- package/tests/libs/jsonRpcClient.test.ts +59 -0
- package/tests/libs/keychainManager.test.ts +156 -0
- package/tests/libs/platformCommands.test.ts +78 -0
- package/tests/libs/system.test.ts +148 -0
- package/tests/services/simulator.test.ts +789 -0
- package/tests/smoke.test.ts +134 -0
- package/tests/utils.ts +13 -0
- package/tsconfig.json +120 -0
- package/vitest.config.ts +13 -0
- 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/*`
|