@ola-893/buidl 0.0.0-stage → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 buidl contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,118 @@
1
- # Temporary Holding Version
1
+ # buidl
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Does this deployed DeWEB app still match the release its reviewers approved?
4
+
5
+ buidl is a CLI for release manifests, reviewer signatures, gated publishing and fresh verification. Developers operate it through wallet, app, policy and release commands. The [web dashboard](https://ola-893.github.io/buidl/) and [public verification links](https://ola-893.github.io/buidl/?verify=1.2.230.tape) are companion inspection surfaces.
6
+
7
+ ## Install and connect
8
+
9
+ Use Node.js 22.13 or newer. Install the CLI from [npm](https://www.npmjs.com/package/@ola-893/buidl):
10
+
11
+ ```sh
12
+ npm install -g @ola-893/buidl@0.5.0
13
+ buidl --version
14
+ buidl --help
15
+ buidl wallet connect --network testnet
16
+ buidl wallet show
17
+ ```
18
+
19
+ `wallet connect` opens a local page where you choose your browser wallet, select X Layer testnet and sign a connection message. It verifies the recovered address and saves the public connection profile. No private key is imported. Every later release signature or transaction has its own wallet confirmation.
20
+
21
+ The write workflow currently supports **X Layer testnet, chain 1952**, using explicitly labeled buidl hosting fixtures. It rejects mainnet. Live TapeOut mainnet inspection is read-only. The complete native TapeOut workflow was also tested separately on a [mainnet fork](docs/xlayer-release.md); that is a different claim from this public testnet fixture pilot.
22
+
23
+ ## Register an app
24
+
25
+ Run commands individually. Replace the reviewer placeholders with two addresses that differ from the holder:
26
+
27
+ ```sh
28
+ buidl app init checkout --network testnet --reviewers 0xREVIEWER1,0xREVIEWER2
29
+ buidl app show
30
+ buidl app deploy
31
+ buidl app deploy --execute
32
+ buidl app enroll --execute
33
+ buidl app register --execute
34
+ buidl policy show
35
+ buidl doctor
36
+ ```
37
+
38
+ `app deploy` previews the testnet contract deployments. `--execute` opens wallet confirmations with gas estimates. Enrollment puts the fixture circuit into the authority contract's custody; the depositor can recover it with `buidl app recover --execute`. To use a deployment you already control, pass `--fixtures fixture-config.json` to `app init`.
39
+
40
+ ## Approve and publish a release
41
+
42
+ Generate the manifest from your own build. Keep the manifest outside the build directory:
43
+
44
+ ```sh
45
+ buidl release create checkout-v1 --build ./dist --out ./manifest.json
46
+ buidl release inspect ./manifest.json
47
+ buidl release request ./manifest.json --out ./approval-request.json
48
+ ```
49
+
50
+ Each reviewer connects their own wallet and signs the same request. Reviewers can run these commands on separate machines with copies of the project and request files:
51
+
52
+ ```sh
53
+ buidl wallet connect --network testnet --account 0xREVIEWER1
54
+ buidl release sign ./approval-request.json --out ./reviewer1.json
55
+ ```
56
+
57
+ ```sh
58
+ buidl wallet connect --network testnet --account 0xREVIEWER2
59
+ buidl release sign ./approval-request.json --out ./reviewer2.json
60
+ ```
61
+
62
+ The holder reconnects, records the reviewers' approval and publishes the exact build:
63
+
64
+ ```sh
65
+ buidl wallet connect --network testnet --account 0xHOLDER
66
+ buidl release approve ./reviewer1.json ./reviewer2.json
67
+ buidl release approve ./reviewer1.json ./reviewer2.json --execute
68
+ buidl release gate ./dist ./manifest.json
69
+ buidl release publish ./dist ./manifest.json --execute
70
+ buidl release verify --manifest ./manifest.json --out ./verification.json
71
+ buidl wallet history
72
+ ```
73
+
74
+ These are independent operator commands. Nothing automatically creates accounts, signs approvals, funds wallets or runs the release journey. The [CLI guide](https://github.com/ola-893/buidl/blob/v0.5.0/docs/cli.md) covers configuration and recovery. The [recording guide](https://github.com/ola-893/buidl/blob/v0.5.0/docs/cli-demo.md) gives a manual command sequence for presenting your own app.
75
+
76
+ ## Day-to-day operations
77
+
78
+ ```sh
79
+ buidl wallet show
80
+ buidl app status
81
+ buidl policy show
82
+ buidl release status
83
+ buidl release revoke --execute
84
+ buidl app recover --execute
85
+ buidl wallet reconcile --hash 0xTRANSACTIONHASH
86
+ buidl wallet disconnect
87
+ ```
88
+
89
+ Writes preview their action unless `--execute` is present. `release sign` explicitly requests a reviewer signature without a gas fee. Publishing checks the staged bytes and current approval, verifies onchain files before finishing, and performs a fresh final check. An interrupted upload stays unverified. Re-run `release publish` to resume; files are skipped only when fresh hash, size and type checks match the manifest.
90
+
91
+ The CLI records transaction estimates, hashes and receipts in `.buidl/transactions.json` next to the project. Uncertain submissions stop later writes until reconciled. Disconnect clears the saved CLI profile; reject any already-open request in the extension separately.
92
+
93
+ `--json` and piped stdout produce structured output for CI. Successful verification exits 0; a completed check without an approved match exits 2; invalid input, failed gates and unavailable dependencies exit 1.
94
+
95
+ ## Read-only TapeOut inspection
96
+
97
+ ```sh
98
+ buidl inspect 1.2.230.tape
99
+ ```
100
+
101
+ Inspection reconstructs and hashes deployed files. It does not open the inspected app. Approval proves an artifact match; it does not establish a security audit or source-to-build reproducibility. Enforcing access to approved releases still requires integration with the viewer or gateway serving the app.
102
+
103
+ ## Develop and verify
104
+
105
+ ```sh
106
+ npm ci
107
+ npm run build
108
+ npm test
109
+ npm run test:testnet
110
+ npm run test:cli
111
+ npm run dev
112
+ ```
113
+
114
+ The integration tests require Foundry Anvil and Playwright Chromium. Use `BUIDL_BROWSER=chrome npm run test:cli` to use installed Chrome. Test accounts and disposable nodes belong to the test harness, not the distributed CLI. `npm pack` builds an installable package containing the CLI and wallet page.
115
+
116
+ The [public fixture pilot evidence](https://github.com/ola-893/buidl/blob/v0.5.0/docs/testnet/results/cli-approved-release.json) records a real holder, two reviewer wallets, onchain approval, CLI publishing and a fresh approved match. [Custody and testnet scope](docs/testnet-pilot.md) · [Manifest and approval formats](docs/formats.md) · [Integration map](docs/integrations.md).
117
+
118
+ The app store and AI testing remain deferred. Commercial deployments should retain the vendored [TapeKit MIT notice](vendor/tapekit/LICENSE); third-party notices are included in the CLI package.
@@ -0,0 +1,191 @@
1
+ TapeKit kernel
2
+
3
+ MIT License
4
+
5
+ Copyright (c) 2026 TapeOutProtocol
6
+
7
+ Permission is hereby granted, free of charge, to any person obtaining a copy
8
+ of this software and associated documentation files (the "Software"), to deal
9
+ in the Software without restriction, including without limitation the rights
10
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11
+ copies of the Software, and to permit persons to whom the Software is
12
+ furnished to do so, subject to the following conditions:
13
+
14
+ The above copyright notice and this permission notice shall be included in all
15
+ copies or substantial portions of the Software.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
+ SOFTWARE.
24
+
25
+ viem
26
+
27
+ MIT License
28
+
29
+ Copyright (c) 2023-present weth, LLC
30
+
31
+ Permission is hereby granted, free of charge, to any person obtaining a copy
32
+ of this software and associated documentation files (the "Software"), to deal
33
+ in the Software without restriction, including without limitation the rights
34
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
35
+ copies of the Software, and to permit persons to whom the Software is
36
+ furnished to do so, subject to the following conditions:
37
+
38
+ The above copyright notice and this permission notice shall be included in all
39
+ copies or substantial portions of the Software.
40
+
41
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
42
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
43
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
44
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
45
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
46
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
47
+ SOFTWARE.
48
+
49
+ ox
50
+
51
+ MIT License
52
+
53
+ Copyright (c) 2023-present wevm
54
+
55
+ Permission is hereby granted, free of charge, to any person obtaining a copy
56
+ of this software and associated documentation files (the "Software"), to deal
57
+ in the Software without restriction, including without limitation the rights
58
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
59
+ copies of the Software, and to permit persons to whom the Software is
60
+ furnished to do so, subject to the following conditions:
61
+
62
+ The above copyright notice and this permission notice shall be included in all
63
+ copies or substantial portions of the Software.
64
+
65
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
66
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
67
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
68
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
69
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
70
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
71
+ SOFTWARE.
72
+
73
+ abitype
74
+
75
+ MIT License
76
+
77
+ Copyright (c) 2022-present weth, LLC
78
+
79
+ Permission is hereby granted, free of charge, to any person obtaining a copy
80
+ of this software and associated documentation files (the "Software"), to deal
81
+ in the Software without restriction, including without limitation the rights
82
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
83
+ copies of the Software, and to permit persons to whom the Software is
84
+ furnished to do so, subject to the following conditions:
85
+
86
+ The above copyright notice and this permission notice shall be included in all
87
+ copies or substantial portions of the Software.
88
+
89
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
90
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
91
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
92
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
93
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
94
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
95
+ SOFTWARE.
96
+
97
+ mime
98
+
99
+ MIT License
100
+
101
+ Copyright (c) 2023 Robert Kieffer
102
+
103
+ Permission is hereby granted, free of charge, to any person obtaining a copy
104
+ of this software and associated documentation files (the "Software"), to deal
105
+ in the Software without restriction, including without limitation the rights
106
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
107
+ copies of the Software, and to permit persons to whom the Software is
108
+ furnished to do so, subject to the following conditions:
109
+
110
+ The above copyright notice and this permission notice shall be included in all
111
+ copies or substantial portions of the Software.
112
+
113
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
114
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
115
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
116
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
117
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
118
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
119
+ SOFTWARE.
120
+
121
+ @noble/curves
122
+
123
+ The MIT License (MIT)
124
+
125
+ Copyright (c) 2022 Paul Miller (https://paulmillr.com)
126
+
127
+ Permission is hereby granted, free of charge, to any person obtaining a copy
128
+ of this software and associated documentation files (the “Software”), to deal
129
+ in the Software without restriction, including without limitation the rights
130
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
131
+ copies of the Software, and to permit persons to whom the Software is
132
+ furnished to do so, subject to the following conditions:
133
+
134
+ The above copyright notice and this permission notice shall be included in
135
+ all copies or substantial portions of the Software.
136
+
137
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
138
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
139
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
140
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
141
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
142
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
143
+ THE SOFTWARE.
144
+
145
+ @noble/hashes
146
+
147
+ The MIT License (MIT)
148
+
149
+ Copyright (c) 2022 Paul Miller (https://paulmillr.com)
150
+
151
+ Permission is hereby granted, free of charge, to any person obtaining a copy
152
+ of this software and associated documentation files (the “Software”), to deal
153
+ in the Software without restriction, including without limitation the rights
154
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
155
+ copies of the Software, and to permit persons to whom the Software is
156
+ furnished to do so, subject to the following conditions:
157
+
158
+ The above copyright notice and this permission notice shall be included in
159
+ all copies or substantial portions of the Software.
160
+
161
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
162
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
163
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
164
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
165
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
166
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
167
+ THE SOFTWARE.
168
+
169
+ @scure/base
170
+
171
+ The MIT License (MIT)
172
+
173
+ Copyright (c) 2022 Paul Miller (https://paulmillr.com)
174
+
175
+ Permission is hereby granted, free of charge, to any person obtaining a copy
176
+ of this software and associated documentation files (the “Software”), to deal
177
+ in the Software without restriction, including without limitation the rights
178
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
179
+ copies of the Software, and to permit persons to whom the Software is
180
+ furnished to do so, subject to the following conditions:
181
+
182
+ The above copyright notice and this permission notice shall be included in
183
+ all copies or substantial portions of the Software.
184
+
185
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
186
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
187
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
188
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
189
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
190
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
191
+ THE SOFTWARE.